Differences
This shows you the differences between the selected revisions of the page.
| ui_pref_resume 2011-11-02 | 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 |
| - | WinSCP is able to store file being transferred to temporary filename first, renaming it to the target name only once the transfer successfully finishes. | + | |
| - | Reasons to do that: | + | ===== [[temporary]] Transfer Resume / Transfer to Temporary Filename ===== |
| - | * If the transfer is interrupted, on the next attempt (either manual or automatic), WinSCP is able to detect the partial/temporary file and suggest you transfer resuming automatically (or even resume automatically). | + | 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). |
| - | * While updating an existing file, the original version of the file exists during whole transfer. This is particularly useful when updating frequently accessed file on web sites. | + | |
| - | Reasons not to do that: | + | 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. |
| - | * As the file is uploaded to a temporary name, it is technically a new file, even though the file with target name already exists. So after the original file is deleted and temporary file is renamed to the original file name, you loose all attributes of the original file (such as owner and group) except for permissions. | + | |
| - | For performance reasons transfer to temporary file name is enabled by default for files larger than a given threshold. The threshold is initially 100 KiB. You can change the threshold. You can also enable the feature for all files, particularly when looking to achieve the second impact. You may also need to disable the feature altogether, particularly if you do not have permissions required (e.g. permissions to create a new file in target directory). | + | In [[scripting]], use ''-resumesupport'' switch of [[scripting#commands|file transfer commands]]. In .NET assembly, use ''[[library_transferoptions#resumesupport|TransferOptions.ResumeSupport]]'' property. |
| - | + | ||
| - | 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]]. | + | |
| ===== [[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 25: | 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]]//. &beta_feature | + | 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]]. | ||