Differences
This shows you the differences between the selected revisions of the page.
| ui_pref_resume 2005-03-16 | ui_pref_resume 2021-03-01 (current) | ||
| Line 1: | Line 1: | ||
| - | ====== Resume Tab ====== | + | ====== The Endurance Page (Preferences Dialog) ====== |
| - | The Resume tab allows you to configure support for [[resume|transfer resuming]]. | + | 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) | ||
| - | For performance reasons resuming file transfer is supported only for files larger then a given threshold. By default the threshold is 100 kB. You can change it, enable resume for all files (not recommended) or disable it altogether. | + | &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). | ||
| + | |||
| + | 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 ===== | ||
| + | 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. | ||
| + | |||
| + | 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]]//. 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. | ||
| + | |||
| + | ===== Further Reading ===== | ||
| + | Read more about [[ui_preferences|Preferences dialog]] and its other [[ui_preferences#pages|pages]]. | ||