Differences
This shows you the differences between the selected revisions of the page.
| ui_pref_resume 2008-05-30 | 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) | ||
| - | ===== 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. | + | |
| - | There are two 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 partinal/temporary file and suggest you transfer resuming automatically (or even resume automatically). This is supported with [[protocols#sftp|SFTP protocol]] only. However you can resume transfers also [[resume#manually]]. | + | 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. | + | |
| - | 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). | + | 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. |
| - | ===== Automatic Reconnect ===== | + | In [[scripting]], use ''-resumesupport'' switch of [[scripting#commands|file transfer commands]]. In .NET assembly, use ''[[library_transferoptions#resumesupport|TransferOptions.ResumeSupport]]'' property. |
| - | 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. | + | |
| + | ===== [[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]]. | ||