Differences
This shows you the differences between the selected revisions of the page.
ui_pref_resume 2013-04-15 | ui_pref_resume 2021-03-01 (current) | ||
Line 1: | Line 1: | ||
- | ====== Endurance Tab (Preferences Dialog) ====== | + | ====== The Endurance Page (Preferences Dialog) ====== |
- | The //Endurance tab// 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. |
&screenshotpict(pref_resume) | &screenshotpict(pref_resume) | ||
- | ===== [[temporary]] Transfer Resume/Transfer to Temporary Filename ===== | + | &toc_title_page_sections |
+ | |||
+ | ===== [[temporary]] Transfer Resume·/·Transfer to Temporary Filename ===== | ||
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. | ||
===== [[reconnect]] Automatic Reconnect ===== | ===== [[reconnect]] Automatic Reconnect ===== | ||
- | 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. | + | 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 sessions, while WinSCP is idle. | ||
Line 16: | Line 20: | ||
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. | ||
- | Use the //Automatically reconnect session, if it stalls// checkbox to enable automatic reconnection of session, when the server stopped responding. Use //Reconnect after// to set how long should WinSCP keep waiting for response. Note that this value should be higher than //[[ui_login_connection#timeout|Server response timeout]]//. | + | Use the //Automatically reconnect session, if it stalls// checkbox to enable automatic reconnection of session, when the server stopped responding. Use //Reconnect after// to set how long should WinSCP keep waiting for response. Note that this value should be higher than //[[ui_login_connection#timeout|Server response timeout]]//. This is supported with [[sftp|SFTP]] and [[scp|SCP]] protocols. |
In //Keep reconnecting for// configure maximal time WinSCP should attempt to reconnect. Use //Unlimited// to allow WinSCP reconnect indefinitely. | In //Keep reconnecting for// configure maximal time WinSCP should attempt to reconnect. Use //Unlimited// to allow WinSCP reconnect indefinitely. | ||
+ | |||
+ | ===== Further Reading ===== | ||
+ | Read more about [[ui_preferences|Preferences dialog]] and its other [[ui_preferences#pages|pages]]. |