Differences
This shows you the differences between the selected revisions of the page.
| incompatible_changes 2017-01-17 | incompatible_changes 2024-11-22 12:26 (current) | ||
| Line 7: | Line 7: | ||
| The changes that most commonly causes issues are **highlighted**. | The changes that most commonly causes issues are **highlighted**. | ||
| - | ===== In the Future Major Release 5.10 ===== | + | ===== [[beta]] In the Last Major Beta Release 6.4 (after September 2024) ===== |
| ==== General ==== | ==== General ==== | ||
| - | * 5.10: Invalid [[file_mask#size_time|size constraints in file mask]] will now fail the operation. Previously, invalid size constraints were ignored. | + | * 6.4: Limiting SFTP version to 3 with non-well-known SFTP servers as a workaround for interoperability issues. [[bug>2247]] |
| + | * 6.4.1: Dropped support for Windows XP and Windows Vista. Minimal supported version is Windows 7. | ||
| - | ==== Scripting and .NET Assembly ==== | + | ===== In the Last Major Release 6.2/6.3 (after October 2023) ===== |
| - | + | ||
| - | * 5.10: When executing script file or script commands provided on command-line, default reconnect time is set to 120 seconds, if not limited yet by configuration. Previously, WinSCP tried to reconnect indefinitely by default. To revert to the previous behavior, in scripting use ''option reconnecttime 0'', in .NET assembly use ''Session.ReconnectTime = TimeSpan.MaxValue''. | + | |
| - | * 5.10: Change: Deprecating ''Session.DisableVersionCheck''. Always use the same version of WinSCP and WinSCP .NET assembly. | + | |
| - | + | ||
| - | ===== In the Last Major Release 5.9 (after December 2015) ===== | + | |
| ==== General ==== | ==== General ==== | ||
| - | * 5.9.3: Not updating last access time of uploaded files with SFTP protocol to avoid problems with servers that do not support it. Previously last access time was updated. [[bug>1485]] | + | * 6.2: SSL (3.0) is no longer supported. TLS 1.0 and 1.1 are disabled by default, to match the OpenSSL 3 defaults. |
| - | * 5.8.3: By default, warning is issued when using Diffie-Hellman group 1 [[ui_login_kex|key exchange algorithm]]. If you need this key exchange algorithm, in scripting use ''open ... -rawsetting KEX=ecdh,dh-gex-sha1,dh-group14-sha1,rsa,dh-group1-sha1,WARN'', in .NET assembly use ''%%SessionOptions.AddRawSettings("KEX", "ecdh,dh-gex-sha1,dh-group14-sha1,rsa,dh-group1-sha1,WARN")%%''. See [[rawsettings|raw site settings]]. | + | |
| - | * 5.8.3: Fallback between [[ui_login_ssh#protocol_options|SSH versions]] is not supported anymore. This should not have any impact, as SSH-1 is not used anymore. | + | |
| - | * 5.8.3: Port number is considered for site-specific caches and bookmarks. You will lose bookmarks for sites that use a non-standard port number. [[bug>1411]] | + | |
| - | * **5.8:** Using UTF-8 for strings (such as password) with SSH protocol. If your %%SSH%% password contains non-ASCII characters, and you were able to connect with previous versions of WinSCP, it means that your server does not comply with SSH specification (as older versions of WinSCP did not). You will not be able to login with the new version of WinSCP. Change your password to %%ASCII%% characters only as a workaround. [[bug>1014]] | + | |
| ==== GUI ==== | ==== GUI ==== | ||
| - | * 5.8.2: Remote custom commands cannot be executed with focus on local panel. Make sure you have the remote panel focused, when executing a remote custom command. | + | * 6.2: Drives hidden by Explorer's ''NoDrives'' policy can now be browsed (the same way it is possible in Explorer). Since 6.4, it is be possible to counter that by optionally following ''NoViewOnDrive'' policy. [[bug>2216]] [[bug>2310]] |
| - | * 5.8: Interface theme is not configurable anymore. Only single theme is supported. | + | |
| - | * 5.8: Change of language on run-time is not supported anymore. | + | |
| - | · * 5.8: Shortcut of command //Clear Selection// changed to ''Shift+Ctrl+L''. | + | |
| - | ==== Scripting and .NET Assembly ==== | + | ==== .NET Assembly ==== |
| - | * 5.9.1: ''[[library_session_enumerateremotefiles|Session.EnumerateRemoteFiles]]'' does not throw when reading subdirectory fails. To capture errors, use the ''[[library_session_failed|Session.Failed]]'' event. | + | * 6.2.2: .NET assembly collections are tagged with ''ClassInterfaceType.None'' to avoid warnings from ''regasm''. |
| - | * 5.8.3: A complete remote error message is stored into a single instance of ''SessionRemoteException'', instead of separating error details into an inner exception. This should have any impact only, if your code checks for specific error message in inner exception. This is not recommended though. | + | |
| - | * 5.8.1: Deprecating ''Session.IniFilePath'' in favor of ''[[library_session_addrawconfiguration|Session.AddRawConfiguration]]''. You can [[ui_generateurl#code|generate a code template]] with the ''AddRawConfiguration'' calls. | + | |
| - | * **5.8:** [[scripting#using_scripting|Script file]] has to be in UTF-8 encoding. This matter only if you use non-ASCII characters in filenames and/or credentials. | + | |
| - | * 5.8. The ''[[library_remotefileinfo#name|RemoteFileInfo.Name]]'' now contains a name only, even for a ''RemoteFileInfo'' instance returned by the ''[[library_session_getfileinfo|Session.GetFileInfo]]''. | + | |
| - | * 5.8: Deprecating ''Session.DefaultConfiguration in'' favor of ''[[library_session_addrawconfiguration|Session.AddRawConfiguration]]''. You can [[ui_generateurl#code|generate a code template]] with the ''AddRawConfiguration'' calls. | + | |
| - | * **5.8:** ''SessionOptions.SshPrivateKeyPassphrase'' renamed to ''[[library_sessionoptions#privatekeypassphrase|SessionOptions.PrivateKeyPassphrase]]''. | + | |
| - | ===== In Older Releases (August 2011 - December 2015) ===== | + | ===== In Older Releases (August 2011 -- October 2023) ===== |
| - | ==== General ==== | + | ==== [[older_general]] General ==== |
| + | * 6.0: Keyboard shortcut for //Command Line// command changed to ''Shift+Ctrl+M'' (''Shift+Ctrl+N'' previously). | ||
| + | * 5.20: Removed support for SSH-1. This should not have any impact, as SSH-1 is not used anymore. | ||
| + | * 5.20: SHA-256 fingerprints are not padded with ''='' anymore. That includes result of .NET assembly ''Session.ScanFingerprint''. WinSCP can still accept padded fingerprints. But new unpadded fingerprints cannot be used with old versions of WinSCP. | ||
| + | * 5.18: Installer needs Windows 7 SP1/2008 R2 SP1. WinSCP application itself still runs on Microsoft Windows XP SP2/Windows Server 2003 SP1 and newer. Use //Portable executables// download. | ||
| + | * 5.16: Consider size of linked file when transferring/synchronizing symbolic link. [[bug>1747]] | ||
| + | * 5.12: When uploading files, ''GetFileAttributes'' is newly used to retrieve file attributes, instead of previous ''FindFirstFile''. With some rare networked drives with broken API, this may cause problems. [[bug>1918]] | ||
| + | * 5.12: Last access time of downloaded files is no longer preserved. Note that //modification// time is still preserved. | ||
| + | * 5.10: Invalid [[file_mask#size_time|size constraints in file mask]] will now fail the operation. Previously, invalid size constraints were ignored. | ||
| + | * 5.10: All ''5.1*'' versions of WinSCP are incorrectly identified as buggy by OpenSSH 6.9 through 7.4, what may cause connection problems. See [[https://bugzilla.mindrot.org/show_bug.cgi?id=2748|OpenSSH Bug #2748]]. | ||
| + | * 5.9.3: Not updating last access time of uploaded files with SFTP protocol to avoid problems with servers that do not support it. Previously last access time was updated. [[bug>1485]] | ||
| + | * 5.8.3: By default, warning is issued when using Diffie-Hellman group 1 [[ui_login_kex|key exchange algorithm]]. If you need this key exchange algorithm, in scripting use ''open ... -rawsetting KEX=ecdh,dh-gex-sha1,dh-group14-sha1,rsa,dh-group1-sha1,WARN'', in .NET assembly use ''%%SessionOptions.AddRawSettings("KEX", "ecdh,dh-gex-sha1,dh-group14-sha1,rsa,dh-group1-sha1,WARN")%%''. See [[rawsettings|raw site settings]]. | ||
| + | * 5.8.3: Fallback between [[ui_login_ssh#protocol_options|SSH versions]] is not supported anymore. This should not have any impact, as SSH-1 is not used anymore. | ||
| + | * 5.8.3: Port number is considered for site-specific caches and bookmarks. You will lose bookmarks for sites that use a non-standard port number. [[bug>1411]] | ||
| + | * **5.8:** Using UTF-8 for strings (such as password) with SSH protocol. If your %%SSH%% password contains non-ASCII characters, and you were able to connect with previous versions of WinSCP, it means that your server does not comply with SSH specification (as older versions of WinSCP did not). You will not be able to login with the new version of WinSCP. Change your password to %%ASCII%% characters only as a workaround. [[bug>1014]] | ||
| * 5.6.4: Considering directories to have zero size, when matching [[file_mask#size_time|file masks]] or sorting by size, even when the server reports size for the directory, to achieve consistent behavior. | * 5.6.4: Considering directories to have zero size, when matching [[file_mask#size_time|file masks]] or sorting by size, even when the server reports size for the directory, to achieve consistent behavior. | ||
| * **5.2.5:** Using UTF-8 for strings (such as file names) with SFTP protocol by default even for version 3 and lower. If your server does not use %%UTF-8%%, you can revert to the previous behavior by setting the //[[ui_login_environment#utf|UTF-8 encoding for filenames]]// to //Off//. [[bug>1072]] | * **5.2.5:** Using UTF-8 for strings (such as file names) with SFTP protocol by default even for version 3 and lower. If your server does not use %%UTF-8%%, you can revert to the previous behavior by setting the //[[ui_login_environment#utf|UTF-8 encoding for filenames]]// to //Off//. [[bug>1072]] | ||
| + | * 5.2: Dropped support for Windows 2000. Minimal supported version is Windows XP. | ||
| + | * 5.0.7: Dropped support for Windows 95/98/ME. | ||
| * 5.0.7: Blowfish is preferred [[ui_login_ssh|SSH encryption cipher]]. [[bug>1]] | * 5.0.7: Blowfish is preferred [[ui_login_ssh|SSH encryption cipher]]. [[bug>1]] | ||
| * 5.0.6: File mask that does not end with slash matches only files, not directories anymore. | * 5.0.6: File mask that does not end with slash matches only files, not directories anymore. | ||
| Line 61: | Line 60: | ||
| ==== GUI ==== | ==== GUI ==== | ||
| + | * 5.20: Keyboard shortcut for //Restore Selection// command changed to ''Shift+Ctrl+S'' (''Shift+Ctrl+R'' previously). | ||
| + | * 5.20: Monitoring ''A:'' and ''B:'' drives. | ||
| + | * 5.16: Removed option to create //Quick Launch// icons (Windows Vista and older only). | ||
| + | * 5.14: Keyboard shortcut for //Download// command in Explorer interface changed to ''Ctrl+T'' (''Ctrl+C'' previously). | ||
| + | * 5.14: Keyboard shortcut for //Open Terminal// command changed to ''Shift+Ctrl+T'' (''Ctrl+T'' previously). | ||
| + | * 5.8.2: Remote custom commands cannot be executed with focus on local panel. Make sure you have the remote panel focused, when executing a remote custom command. | ||
| + | * 5.8: Interface theme is not configurable anymore. Only single theme is supported. | ||
| + | * 5.8: Change of language on run-time is not supported anymore. | ||
| + | * 5.8: Shortcut of command //Clear Selection// changed to ''Shift+Ctrl+L''. | ||
| * 5.2: Session from command-line and/or from jump list is opened by default using existing WinSCP instance. To revert to the previous behavior, use the //[[ui_pref_window|Open new externally initiated sessions in existing window]]//. [[bug>769]] | * 5.2: Session from command-line and/or from jump list is opened by default using existing WinSCP instance. To revert to the previous behavior, use the //[[ui_pref_window|Open new externally initiated sessions in existing window]]//. [[bug>769]] | ||
| * 5.0.6: //Include/Exclude mask// in transfer settings replaced with //File mask//, what is equivalent of //Include mask// (as supported already previously, it can contain exclude mask after ''|''). | * 5.0.6: //Include/Exclude mask// in transfer settings replaced with //File mask//, what is equivalent of //Include mask// (as supported already previously, it can contain exclude mask after ''|''). | ||
| Line 67: | Line 75: | ||
| * 5.0.3: In mouse-only [[ui_pref_commander|Explorer-style selection mode]], single-file implicit mouse-selection is not preserved, when focus/selection is subsequently changed using keyboard. | * 5.0.3: In mouse-only [[ui_pref_commander|Explorer-style selection mode]], single-file implicit mouse-selection is not preserved, when focus/selection is subsequently changed using keyboard. | ||
| - | ==== Scripting and .NET Assembly ==== | + | ==== Installer ==== |
| + | * 5.16: Silent installation needs additional ''/ALLUSERS'' or ''/CURRENTUSER'' switches. | ||
| + | * 5.16: Installer does not support Windows XP/2003 anymore. WinSCP application itself still runs on Windows XP/2003. Use //Portable executables// download. | ||
| + | * 5.17.6: Installer does not support Windows Vista/2008 anymore. WinSCP application itself still runs on Windows Vista/2008. Use //Portable executables// download. | ||
| + | |||
| + | ==== [[older_automation]] Scripting and .NET Assembly ==== | ||
| + | |||
| + | * 6.0.1: ''SessionOptions.WebdavSecure'' renamed to ''SessionOptions.Secure'' (and applies to S3 protocol too). | ||
| + | * 5.18: Deprecated [[library_sessionoptions#giveupsecurityandacceptanysshhostkey|''SessionOptions.GiveUpSecurityAndAcceptAnySshHostKey'']] in favour of [[library_sessionoptions#sshhostkeypolicy|''SshHostKeyPolicy.GiveUpSecurityAndAcceptAny'']]. | ||
| + | * 5.16: TLS/SSL certificate fingerprints in generated URL use dashes (''-'') instead of colons ('':''), while colons are still accepted. Consequently URLs with TLS/SSL certificate fingerprints generated by 5.16 and newer cannot be used for older versions. | ||
| + | * 5.16: SHA-256 fingerprints in generated URL use dashes (''-'') and underscores (''_'') instead of pluses (''+'') and slashes (''/''), while pluses and slashes are still accepted. Consequently URLs with SHA-256 fingerprints generated by 5.16 and newer cannot be used for older versions. | ||
| + | * 5.16: ''RemoteFileInfo.FileType'' now consistently returns ''L'' for symlinks as was always documented. ''RemoteFileInfo.FileType'' now consistently returns uppercase value as was always documented. | ||
| + | * 5.17.3: ''SHA-1'' fingerprint of TLS/SSL certificate was incorrectly presented as ''MD5'' by ''Session.ScanFingerprint''. | ||
| + | * 5.14: URLs in ''open'' command are not matched against stored site name after stripping a protocol. Historically a command like ''%%open sftp://site/%%'' still made WinSCP use stored site ''site'', instead of connecting to host ''site'' using SFTP protocol. Now WinSCP uses stored site only with ''open site''. [[bug>1647]] | ||
| + | * 5.14: .NET Assembly now targets .NET Framework 4.0. | ||
| + | * 5.12: XML log tags ''<modification>'' and ''<permisssions>'' are absent, if their values are not known. Previously they would have value of ''1899-12-30T01:00:00.000Z'' and ''---------'' respectively. Consequently the .NET assembly ''RemoteFileInfo.LastWriteTime'' and ''RemoteFileInfo.FilePermissions'' have values ''DateTime.MinValue'' and ''null'', respectively. | ||
| + | * 5.12: Scripting command ''mv'' and .NET assembly function ''Session.MoveFile'' tests, if a source file exists, before trying to rename. Consequently, an error message reported has changed significantly, if the source file does not exist. | ||
| + | * 5.12.1: .NET assembly instance methods ''Session.EscapeFileMask'', ''Session.CombinePaths'', ''Session.TranslateLocalPathToRemote'' and ''Session.TranslateRemotePathToLocal'' replaced by static methods of the same name in class ''RemotePath''. | ||
| + | * 5.12.1: ''Session.ScanFingerprint'' has a new mandatory ''algorithm'' parameter. To keep the previous behavior use ''%%MD5%%'' as a parameter value (though for new development, use ''%%SHA-256%%''). | ||
| + | * 5.10: When executing script file or script commands provided on command-line, default reconnect time is set to 120 seconds, if not limited yet by configuration. Previously, WinSCP tried to reconnect indefinitely by default. To revert to the previous behavior, in scripting use ''option reconnecttime 0'', in .NET assembly use ''Session.ReconnectTime = TimeSpan.MaxValue''. | ||
| + | * 5.10: XML log EOL has changed from LF to CRLF. | ||
| + | * 5.9.1: ''[[library_session_enumerateremotefiles|Session.EnumerateRemoteFiles]]'' does not throw when reading subdirectory fails. To capture errors, use the ''[[library_session_failed|Session.Failed]]'' event. | ||
| + | * 5.8.3: A complete remote error message is stored into a single instance of ''SessionRemoteException'', instead of separating error details into an inner exception. This should have any impact only, if your code checks for specific error message in inner exception. This is not recommended though. | ||
| + | * 5.8.1: Deprecating ''Session.IniFilePath'' in favor of ''[[library_session_addrawconfiguration|Session.AddRawConfiguration]]''. You can [[ui_generateurl#code|generate a code template]] with the ''AddRawConfiguration'' calls. | ||
| + | * **5.8:** [[scripting#using_scripting|Script file]] has to be in UTF-8 encoding. This matter only if you use non-ASCII characters in filenames and/or credentials. If you are you will get error message [[message_no_mapping_for_unicode|No mapping for the Unicode character exists in the target multi-byte code page -- The file must be in UTF-8 or UTF-16 encoding]]. | ||
| + | * 5.8. The ''[[library_remotefileinfo#name|RemoteFileInfo.Name]]'' now contains a name only, even for a ''RemoteFileInfo'' instance returned by the ''[[library_session_getfileinfo|Session.GetFileInfo]]''. | ||
| + | * 5.8: Deprecating ''Session.DefaultConfiguration in'' favor of ''[[library_session_addrawconfiguration|Session.AddRawConfiguration]]''. You can [[ui_generateurl#code|generate a code template]] with the ''AddRawConfiguration'' calls. | ||
| + | * **5.8:** ''SessionOptions.SshPrivateKeyPassphrase'' renamed to ''[[library_sessionoptions#privatekeypassphrase|SessionOptions.PrivateKeyPassphrase]]''. | ||
| * 5.6.5: ''[[library_session_calculatefilechecksum|Session.CalculateFileChecksum]]'' method returns a byte array instead of a string to match .NET framework cryptography functions. | * 5.6.5: ''[[library_session_calculatefilechecksum|Session.CalculateFileChecksum]]'' method returns a byte array instead of a string to match .NET framework cryptography functions. | ||
| * 5.6.3: ''[[scriptcommand_lls|lls]]'' by default only displays a notification that no matching file is found, instead of failing. | * 5.6.3: ''[[scriptcommand_lls|lls]]'' by default only displays a notification that no matching file is found, instead of failing. | ||
| Line 75: | Line 110: | ||
| * 5.6: Enabling batch mode in scripting automatically limits reconnect time to 120 seconds, if it is not limited yet. To revert to the previous behavior, in scripting use ''option reconnecttime 0'', in .NET assembly use ''Session.ReconnectTime = TimeSpan.MaxValue''. [[bug>1173]] | * 5.6: Enabling batch mode in scripting automatically limits reconnect time to 120 seconds, if it is not limited yet. To revert to the previous behavior, in scripting use ''option reconnecttime 0'', in .NET assembly use ''Session.ReconnectTime = TimeSpan.MaxValue''. [[bug>1173]] | ||
| * 5.6: When host key does not match fingerprint specified on command line or in script, user is not prompted to verify the host key and connection is abandoned with meaningful error message. [[bug>1186]] | * 5.6: When host key does not match fingerprint specified on command line or in script, user is not prompted to verify the host key and connection is abandoned with meaningful error message. [[bug>1186]] | ||
| - | * 5.2.5: Symbol '';'' has special meaning in [[session_url|session URL]] and has to be [[session_url#special|URL-encoded]] to ''%3B'', when used as a literal. | + | * 5.2.5: ==Semicolon== symbol '';'' has special meaning in [[session_url|session URL]] and has to be [[session_url#special|URL-encoded]] to ''%3B'', when used as a literal. |
| * 5.2.5: UTF-8 encoded characters in [[session_url|session URL]] are supported. If you were using non-ASCII URL-encoded characters in the session URL, you need to [[session_url#special|re-code them to UTF-8]]. [[bug>1062]] | * 5.2.5: UTF-8 encoded characters in [[session_url|session URL]] are supported. If you were using non-ASCII URL-encoded characters in the session URL, you need to [[session_url#special|re-code them to UTF-8]]. [[bug>1062]] | ||
| * **5.2.3:** In .NET assembly, ''[[library_sessionoptions|SessionOptions]]'' class properties ''SslHostCertificateFingerprint'' and ''GiveUpSecurityAndAcceptAnySslHostCertificate'' renamed to ''[[library_sessionoptions#tlshostcertificatefingerprint|TlsHostCertificateFingerprint]]'' and ''[[library_sessionoptions#giveupsecurityandacceptanytlshostcertificate|GiveUpSecurityAndAcceptAnyTlsHostCertificate]]'', respectively. | * **5.2.3:** In .NET assembly, ''[[library_sessionoptions|SessionOptions]]'' class properties ''SslHostCertificateFingerprint'' and ''GiveUpSecurityAndAcceptAnySslHostCertificate'' renamed to ''[[library_sessionoptions#tlshostcertificatefingerprint|TlsHostCertificateFingerprint]]'' and ''[[library_sessionoptions#giveupsecurityandacceptanytlshostcertificate|GiveUpSecurityAndAcceptAnyTlsHostCertificate]]'', respectively. | ||