Difference between revisions of "Development/Tutorials/Debugging/Debugging IOSlaves/Debugging kio sftp"

(Added a page for kio_sftp)
 
(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=2 kdeinit4
+
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

Content is available under Creative Commons License SA 4.0 unless otherwise noted.