Guidelines and HOWTOs/Debugging/Debugging IOSlaves/Debugging kio sftp
This page is a starting point for debugging kio_sftp. Please also read how to debug IO slaves generically.
Overview
When you point file manager to sftp://user@target, the sftp kioslave uses libssh to open a connection to the sftp server.
Reporting Bugs
If this is your first bug report please read the following document:
How to Report Bugs Effectively
Then got to http://bugs.kde.org/ and create a bug report. Tell us:
- The KDE you're running
- The libssh version installed
- The sftp server version (e.g. the openssh version on the server)
- If you use ~/.ssh/config show us your special host config
- Provide log files if possible (see below)
Logging
You may want to switch on logging for kio_sftp.
In this example, we want to log the output to /tmp/kio_sftp.log. Open a konsole or run the command 'kdebugdialog --fullmode'.
In the "Debug Area" select "7120 kio_sftp". In the Information box select 'Information' as the "Output" and use '/tmp/kio_sftp.log' a the "File".
To enable logging you have to reload the slave system. You can do this by calling:
'kdeinit4'
Logging with libssh debug output
To enable libssh debug messages in addition you have to set an environment variable before calling kdeinit.
KIO_SFTP_LOG_VERBOSITY=1 kdeinit4
Enable logging in openssh
(Both of the instructions below refer to sshd, the server--these should not affect client operations, e.g. running ssh or sftp. I don't think these instructions are correct.)
SSH Logging
Edit /etc/ssh/sshd_config
Look for LogLevel and set it to:
LogLevel DEBUG
SFTP Logging
Edit /etc/ssh/sshd_config
Look for the sftp subsystem and change it to:
Subsystem sftp /usr/lib64/ssh/sftp-server -l DEBUG