Differences
This shows you the differences between the selected revisions of the page.
| ui_pref_resume 2006-09-01 | 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]]. It is supported for [[protocols|SFTP protocol]] only. | + | 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) | ||
| - | ===== Transfer Resume ===== | + | &toc_title_page_sections |
| - | 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. | + | |
| - | ===== Automatic Reconnect ===== | + | ===== [[temporary]] Transfer Resume / Transfer to Temporary Filename ===== |
| - | Use the checkbox to enable automatical reconnection of broken transfers. You can also configure how long will WinSCP wait before reconnection attempt. Note that you can always force earlier attempt manually. The setting applies for foreground transfers only. For [[transfer_queue|background transfers]] the interval is always 2 seconds. | + | 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]]. | ||