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 KIO slave 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 Frameworks and Dolphin version 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

KDE_FORK_SLAVES=1 QT_LOGGING_RULES="*=false;log_kio_sftp=true;" dolphin --new-window YOUR_SFTP_URL

Logging with libssh debug output

To enable libssh debug messages in addition you have to set an additional environment variable:

KIO_SFTP_LOG_VERBOSITY=1 KDE_FORK_SLAVES=1 QT_LOGGING_RULES="*=false;log_kio_sftp=true;" dolphin --new-window YOUR_SFTP_URL

Enable logging in openssh (server-side)

Sometimes it may be useful to enable logging on the server to get a more complete picture of what's going on.

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 appned -l DEBUG it to:

  Subsystem sftp /usr/lib64/ssh/sftp-server -l DEBUG