Guidelines and HOWTOs/Debugging/Debugging IOSlaves/Debugging kio sftp

From KDE Community Wiki

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