Differences
This shows you the differences between the selected revisions of the page.
| ui_pref_resume 2013-04-29 | ui_pref_resume 2021-03-01 (current) | ||
| Line 1: | Line 1: | ||
| - | ====== Endurance Tab (Preferences Dialog) ====== | + | ====== The Endurance Page (Preferences Dialog) ====== |
| - | The //Endurance tab// 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. |
| &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 ===== | ===== Further Reading ===== | ||
| - | Read more about [[ui_preferences|Preferences dialog]] and its other [[ui_preferences#tabs|tabs]]. | + | Read more about [[ui_preferences|Preferences dialog]] and its other [[ui_preferences#pages|pages]]. |