Differences

This shows you the differences between the selected revisions of the page.

ui_pref_resume 2017-12-04 ui_pref_resume 2026-02-06 (current)
Line 1: Line 1:
-====== Endurance Page (Preferences Dialog) ======+====== The Endurance Page (Preferences Dialog) ======
The //Endurance page// on the [[ui_preferences|Preferences dialog]] allows you to configure support for automatic [[resume|transfer resuming]] and reconnecting. The //Endurance page// on the [[ui_preferences|Preferences dialog]] allows you to configure support for automatic [[resume|transfer resuming]] and reconnecting.
Line 9: Line 9:
WinSCP is able to [[resume#automatic|transfer files to temporary filename]] first, renaming it to the target name only once the transfer successfully finishes. This allows for [[resume#automatic|automatic transfer resume]]; as well as preserving the existing target file for duration of the transfer (what is particularly useful when updating frequently accessed files on web sites). WinSCP is able to [[resume#automatic|transfer files to temporary filename]] first, renaming it to the target name only once the transfer successfully finishes. This allows for [[resume#automatic|automatic transfer resume]]; as well as preserving the existing target file for duration of the transfer (what is particularly useful when updating frequently accessed files on web sites).
-Transfer to temporary filename is supported with [[sftp|SFTP protocol]] only and only for [[transfer_mode|binary transfers]]. However with other protocols you can resume transfers also [[resume#manual|manually]].+Transfer to temporary filename is supported with [[sftp|SFTP protocol]] only and only for [[transfer_mode|binary transfers]]. However with other protocols you can resume transfers also [[resume#manual|manually]]. Though the option still has some effect with the FTP protocol, it controls whether a file transfer is automatically resumed, after a connection is restored, when it breaks in a middle of a file transfer, or if the transfer restarts from the beginning.
In [[scripting]],  use ''-resumesupport'' switch of [[scripting#commands|file transfer commands]]. In .NET assembly, use ''[[library_transferoptions#resumesupport|TransferOptions.ResumeSupport]]'' property. In [[scripting]],  use ''-resumesupport'' switch of [[scripting#commands|file transfer commands]]. In .NET assembly, use ''[[library_transferoptions#resumesupport|TransferOptions.ResumeSupport]]'' property.
Line 16: Line 16:
Use the //Automatically reconnect session, if it breaks during transfer// checkbox to enable reconnection of the session (and resuming transfer) when it breaks while transferring files. This is supported with [[sftp|SFTP]] and [[ftp|FTP]] protocols. Use the //Automatically reconnect session, if it breaks during transfer// checkbox to enable reconnection of the session (and resuming transfer) when it breaks while transferring files. This is supported with [[sftp|SFTP]] and [[ftp|FTP]] protocols.
-Use the //Automatically reconnect session, if it breaks while idle// checkbox to enable automatic reconnection of sessions, while WinSCP is idle.+Use the //Automatically reconnect session, if it breaks while idle// checkbox to enable automatic reconnection of the active session, while WinSCP is idle. 
 + 
 +Use the //Automatically reconnect session, if it breaks while inactive// checkbox to enable automatic reconnection of inactive sessions, while WinSCP is idle. If the reconnection needs any interactive with the user, it's postponed until the session is activated. &beta_feature
In //Reconnect after// configure how long will WinSCP wait before reconnection attempt. Note that you can always force earlier attempt manually. The setting applies for foreground sessions only. For [[transfer_queue|background transfers]] the interval is always 2 seconds. In //Reconnect after// configure how long will WinSCP wait before reconnection attempt. Note that you can always force earlier attempt manually. The setting applies for foreground sessions only. For [[transfer_queue|background transfers]] the interval is always 2 seconds.

Last modified: by martin