Differences
This shows you the differences between the selected revisions of the page.
2014-10-30 | 2015-02-18 | ||
5.6.2 Bug 325 UTF-8 support for SCP (martin) | releasing 5.7 stable, removing &beta tags (or replacing with &recent) (martin) | ||
Line 27: | Line 27: | ||
Use //%%UTF-8%% encoding for filenames// to configure if WinSCP should use UTF-8 (Unicode) encoding for filenames in communication with the server. | Use //%%UTF-8%% encoding for filenames// to configure if WinSCP should use UTF-8 (Unicode) encoding for filenames in communication with the server. | ||
- | With default //Auto// value, WinSCP will try to autodetect if the server supports %%UTF-8%%. With [[sftp|SFTP protocol]] this means that %%UTF-8%% is used, unless the server is known not to support %%UTF-8%%((Foxit software WAC Server)) //(latest release&recent)// or it sends strings not encoded with %%UTF-8%% //(latest beta release&beta)//, or for protocol version 4 and newer //(previous versions&recent)//. With [[ftp|FTP protocol]] this means that %%UTF-8%% will be used when the server announces support for it. With [[scp|SCP protocol]] this means that %%UTF-8%% will be used when a ''LANG'' environment variable is set to "%%UTF-8%%" encoding. //(latest beta release&beta)// | + | With default //Auto// value, WinSCP will try to autodetect if the server supports %%UTF-8%%. With [[sftp|SFTP protocol]] this means that %%UTF-8%% is used for protocol version 4 and newer; for older versions, &&UTF-8%% is used unless the server is known not to support %%UTF-8%%((Foxit software WAC Server)) or it sends strings not encoded with %%UTF-8%%. With [[ftp|FTP protocol]] this means that %%UTF-8%% will be used when the server announces support for it. With [[scp|SCP protocol]] this means that %%UTF-8%% will be used when a ''LANG'' environment variable is set to "%%UTF-8%%" encoding. |
Set the option to //On// to force usage of %%UTF-8%% (useful for servers using %%UTF-8%% natively). Set the option to //Off// to unconditionally disable usage of %%UTF-8%% (for SFTP servers that does not use %%UTF-8%%). | Set the option to //On// to force usage of %%UTF-8%% (useful for servers using %%UTF-8%% natively). Set the option to //Off// to unconditionally disable usage of %%UTF-8%% (for SFTP servers that does not use %%UTF-8%%). | ||
Line 38: | Line 38: | ||
With [[scp|SCP protocol]] the option is used to counterweight time difference between [[timestamp|timestamp]] of remote file shown in directory listing and timestamp set on downloaded file, and vice versa. The difference is caused by fact that during transfer ''scp'' command usually uses UTC time format, while ''ls'' command may display time in local (for server) time format. The time difference can be negative. For example if the timestamps of remote files are two hours ahead of local files, set the option to -2 hours. Read about other issues with [[timestamp|timestamps]]. | With [[scp|SCP protocol]] the option is used to counterweight time difference between [[timestamp|timestamp]] of remote file shown in directory listing and timestamp set on downloaded file, and vice versa. The difference is caused by fact that during transfer ''scp'' command usually uses UTC time format, while ''ls'' command may display time in local (for server) time format. The time difference can be negative. For example if the timestamps of remote files are two hours ahead of local files, set the option to -2 hours. Read about other issues with [[timestamp|timestamps]]. | ||
- | With [[ftp|FTP protocol]] the option is used to actually set the difference between local and remote timezone. Though it is used, when deprecated ''LIST'' command is used for directory listing, only. When using ''MLSD'', the server must report all timestamps in UTC. To enable the option with FTP protocol, you need to opt to use ''LIST'' command explicitly by setting //[[ui_login_ftp|Use MLSD command for directory listing]]// to //Off//. Though, you should use this only when the server does not support ''MLSD'' command or its implementation is buggy. The difference is automatically detected.((If the server supports ''MDTM'' command.)) &beta_feature If the detections fails, uncheck //Detect automatically// and set the difference manually. | + | With [[ftp|FTP protocol]] the option is used to actually set the difference between local and remote timezone. Though it is used, when deprecated ''LIST'' command is used for directory listing, only. When using ''MLSD'', the server must report all timestamps in UTC. To enable the option with FTP protocol, you need to opt to use ''LIST'' command explicitly by setting //[[ui_login_ftp|Use MLSD command for directory listing]]// to //Off//. Though, you should use this only when the server does not support ''MLSD'' command or its implementation is buggy. The difference is automatically detected.((If the server supports ''MDTM'' command.)) If the detections fails, uncheck //Detect automatically// and set the difference manually. |
The option is not available with [[SFTP]] and [[WebDAV]] protocols, as with them, the server must report all timestamps in UTC. | The option is not available with [[SFTP]] and [[WebDAV]] protocols, as with them, the server must report all timestamps in UTC. |