Guidelines and HOWTOs/Debugging/Debugging IOSlaves/Debugging kio sftp: Difference between revisions
*>Asn Added a page for kio_sftp |
*>Asn Added reporting bugs section |
||
Line 4: | Line 4: | ||
When you point file manager to sftp://''user''@''target'', [http://websvn.kde.org/trunk/KDE/kdebase/runtime/kioslave/sftp/kio_sftp.cpp?view=log the sftp kioslave] uses [http://www.libssh.org libssh] to open a connection to the sftp server. | When you point file manager to sftp://''user''@''target'', [http://websvn.kde.org/trunk/KDE/kdebase/runtime/kioslave/sftp/kio_sftp.cpp?view=log the sftp kioslave] uses [http://www.libssh.org libssh] to open a connection to the sftp server. | ||
= Reporting Bugs = | |||
If this is your first bug report please read the following document: | |||
[http://www.chiark.greenend.org.uk/~sgtatham/bugs.html 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 = | = Logging = | ||
Line 21: | Line 35: | ||
To enable libssh debug messages in addition you have to set an environment variable before calling kdeinit. | To enable libssh debug messages in addition you have to set an environment variable before calling kdeinit. | ||
KIO_SFTP_LOG_VERBOSITY= | KIO_SFTP_LOG_VERBOSITY=1 kdeinit4 | ||
= Enable logging in openssh = | |||
== 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 |
Revision as of 16:51, 19 May 2010
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 debut 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
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