This is an old revision of the document!
Logging Tab (Preferences Dialog)
Logging tab allows user to configure session logging. For easier access before opening a session, the tab is duplicated on Login dialog.
To enable logging tick Enabled logging checkbox.
Advertisement
Once the logging is enabled, you can configure the Logging options.
To enable logging to file tick Log to file checkbox and specify log file. If you select Append option, and the logging file already exists, session log will be appended to the end of the file. Otherwise the existring file will be overwritten. If you enable logging to file in mid-session the past events will not be written to the log retrospectively. Note that simultaneous logging of several sessions to file is not supported.
When you tick Show log window checkbox, session log window will appear. For peformance reasons it is recommended to limit number of displayed lines. Note that if you tick Show log window checkbox on Login dialog, the log window will appear only after you open the session. Once the session is already opened you can show/hide log window also from Options menu and from toolbar. If you display log window in mid-session the past events will be displayed only if the Enable logging was already ticked before.
Protocol (Low-Level) Logging
For debugging reasons WinSCP allows low-level protocol logging (SFTP only). To enable it you have to edit configuration manually.
First make sure that WinSCP is not running.
If you are using Window Registry (the default) as configuration storage import following REG file (store the following lines to logging.reg file and double-click it):
REGEDIT4 [HKEY_CURRENT_USER\Software\Martin Prikryl\WinSCP 2\Configuration\Logging] "LogProtocol"=dword:00000001
If you are using INI file as configuration storage modify the INI file as follows:
... [Configuration\Logging] ... LogProtocol=1 ...
Advertisement
Then run WinSCP and enable logging to file. The log file will contain more verbose information.