Differences
This shows you the differences between the selected revisions of the page.
| 2013-04-15 | 2013-04-15 | ||
| resume#automatic (martin) | moved documentation of transfer resume and transfer to tempoerary file name to resume#automatic (martin) | ||
| Line 5: | Line 5: | ||
| ===== [[temporary]] Transfer Resume/Transfer to Temporary Filename ===== | ===== [[temporary]] Transfer Resume/Transfer to Temporary Filename ===== | ||
| - | WinSCP is able to store file being transferred to temporary filename first, renaming it to the target name only once the transfer successfully finishes. | + | 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). |
| - | + | ||
| - | Reasons to do that: | + | |
| - | * 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 [[resume#automatic|transfer resuming automatically]] (or even resume automatically). | + | |
| - | * 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: | + | |
| - | * 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). | + | |
| 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]]. | ||