Differences
This shows you the differences between the selected revisions of the page.
| 2008-03-06 | 2008-04-08 | ||
| elaborate of ftp (martin) | 4.1 Server does not use UTF-8 changed to UTF-8 encoding for filenames and moved to Environment tab, as it is used also by FTP protocol (martin) | ||
| Line 4: | Line 4: | ||
| [[protocols#sftp|SFTP protocol]] specification requires that client and server uses UTF-8 encoding (Unicode) for file names. | [[protocols#sftp|SFTP protocol]] specification requires that client and server uses UTF-8 encoding (Unicode) for file names. | ||
| - | WinSCP can operate in two modes, either it expects that the local machine and the server uses the same encoding (no conversion is done) or treats remote filenames as UTF-8 (Unicode) encoded. By default, the first mode is used for [[protocols#sftp|SFTP-3]] and lower ((SFTP specification before version 4 has not required UTF-8 explicitly.)), the latter mode is used for newer versions. You can force non-default behaviour using session option //[[ui_login_sftp#protocol_options|Server does not use UTF-8]]//. This is useful especially for servers that use UTF-8 naively, thus even for older versions of SFTP. | + | WinSCP can operate in two modes, either it expects that the local machine and the server uses the same encoding (no conversion is done) or treats remote filenames as UTF-8 (Unicode) encoded. By default, the first mode is used for [[protocols#sftp|SFTP-3]] and lower ((SFTP specification before version 4 has not required UTF-8 explicitly.)), the latter mode is used for newer versions. You can force non-default behaviour using session option //[[ui_login_environment#utf|UTF-8 encoding for filenames ]]//. This is useful especially for servers that use UTF-8 natively, thus even for older versions of SFTP. |
| - | Please be aware that if your server does not support UTF-8 encoding, but uses its local legacy encoding instead, it is its fault. The problem is not on WinSCP-side. You should push your server provider to add support for UTF-8, and not ask for support of legacy encoding in WinSCP. | + | Please be aware that if your server does not support UTF-8 encoding, but uses its local legacy encoding instead, it is its fault. The problem is not on WinSCPside. You should push your server provider to add support for UTF-8, and not ask for support of legacy encoding in WinSCP. |
| ===== FTP ===== | ===== FTP ===== | ||
| - | For [[protocols#ftp|FTP]] protocol, usage of UTF-8 is temporarily controlled by SFTP-specific option //[[ui_login_sftp#protocol_options|Server does not use UTF-8]]// (this will be fixed in 4.1.0). | + | For [[protocols#ftp|FTP]] protocol, usage of UTF-8 is also controlled session option //[[ui_login_environment#utf|UTF-8 encoding for filenames ]]//. |
| ===== SCP ===== | ===== SCP ===== | ||
| Line 15: | Line 15: | ||
| ===== Remark ===== | ===== Remark ===== | ||
| - | Also note that WinSCP is not an Unicode application. Hence it can display only characters that are present in default language code page of your workstation. For example, even if your server supports UTF-8 (Unicode), its filenames contains Chinese characters, but your workstation default language is German, WinSCP will not be able to display the characters correctly. To find out what is your default language, go to //Start > Settings > Control Panel > Regional and Language Options > Advanced > Language for non-Unicode programs// (on Windows XP). Unfortunately turning WinSCP to Unicode application is an immense task, that will hardly be done. | + | Also note that WinSCP is not an Unicode application. Hence it can display only characters that are present in default language code page of your workstation. For example, even if your server supports UTF-8 (Unicode), its filenames contains Chinese characters, but your workstation default language is German, WinSCP will not be able to display the Chinese characters correctly. However it should be able to manage the files correctly. To find out what is your default language, go to //Start > Settings > Control Panel > Regional and Language Options > Advanced > Language for non-Unicode programs// (on Windows XP). Unfortunately turning WinSCP to Unicode application is an immense task, that will hardly be done. |