Differences
This shows you the differences between the selected revisions of the page.
| resume 2017-01-18 | resume 2023-12-07 (current) | ||
| Line 2: | Line 2: | ||
| ===== Basic Usage ===== | ===== Basic Usage ===== | ||
| - | WinSCP supports resuming file transfers with [[SFTP]] and [[FTP]] protocols. [[SCP]] and [[WebDAV]] protocols do not allow it. | + | WinSCP supports resuming file transfers with [[SFTP]] and [[FTP]] protocols. [[SCP]] and [[WebDAV]] protocols do not allow it. With [[S3]] protocol, transfer can be resumed only immediately by reconnecting a lost session, not later. |
| ===== [[automatic]] Automatic Resume / Transfer to Temporary Filename ===== | ===== [[automatic]] Automatic Resume / Transfer to Temporary Filename ===== | ||
| Line 23: | Line 23: | ||
| Note that partial files can be distinguished in file panel by special [[ui_file_panel#special_files|"torn sheet" overlay icon]]. | Note that partial files can be distinguished in file panel by special [[ui_file_panel#special_files|"torn sheet" overlay icon]]. | ||
| - | To configure transfer to temporary file name in [[scripting]], use ''-resumesupport'' switch of file transfer commands. In .NET assembly use ''[[library_transferoptions#resumesupport|TransferOptions.ResumeSupport]]''. | + | To configure transfer to temporary file name in [[scripting]], use ''-resumesupport'' ==switch== of file transfer commands (such as [[scriptcommand_put|''put'']], [[scriptcommand_get|''get'']], etc). In .NET assembly use ''[[library_transferoptions#resumesupport|TransferOptions.ResumeSupport]]''. |
| Transfer to temporary filename is supported with [[sftp|SFTP protocol]] only and only for [[transfer_mode|binary transfers]]. | Transfer to temporary filename is supported with [[sftp|SFTP protocol]] only and only for [[transfer_mode|binary transfers]]. | ||
| Line 30: | Line 30: | ||
| There's an alternative manual method to resume transfer, which can be used with FTP protocol. | There's an alternative manual method to resume transfer, which can be used with FTP protocol. | ||
| - | If you attempt to transfer a file already in the target directory and the target file is smaller then the source file, the [[ui_overwrite|overwrite confirmation dialog]] displays a //Resume// button or an //Append// button (when appending is supported). After you click //Append//, WinSCP opens another prompt that lets you append source file or resume your transfer. | + | If you attempt to transfer a file already in the target directory and the target file is smaller then the source file, the [[ui_overwrite|overwrite confirmation dialog]] displays a //Resume// command or an //Append// command (when appending is supported), in the drop-down menu of the //No// button. After you click //Append//, WinSCP opens another prompt that lets you append source file or resume your transfer. |
| If you resume the transfer, WinSCP will skip a part of the source file equal to the target file's size. The program will only transfer the remainder. | If you resume the transfer, WinSCP will skip a part of the source file equal to the target file's size. The program will only transfer the remainder. | ||
| Line 38: | Line 38: | ||
| The method is also useful for resuming transfers initiated by other clients and also to update log files. Manual resuming of [[transfer_mode|text mode transfers]] with SFTP-4 and newer is not supported. | The method is also useful for resuming transfers initiated by other clients and also to update log files. Manual resuming of [[transfer_mode|text mode transfers]] with SFTP-4 and newer is not supported. | ||
| - | ===== Common Problems ===== | + | ===== [[common_problems]] Common Problems ===== |
| If you want to resume your transfer, you must use the same source file version as the interrupted transfer. If you do not, your target file will include the source file's previous version and its current version. For automatic resume, if the partial file is bigger than the source file, WinSCP will display error and disallow resume. | If you want to resume your transfer, you must use the same source file version as the interrupted transfer. If you do not, your target file will include the source file's previous version and its current version. For automatic resume, if the partial file is bigger than the source file, WinSCP will display error and disallow resume. | ||
| Line 44: | Line 44: | ||
| ===== [[broken_connection]] Resuming from Broken Connections ===== | ===== [[broken_connection]] Resuming from Broken Connections ===== | ||
| - | With [[sftp|SFTP]] and [[ftp|FTP]] protocols, when connection is broken, WinSCP can automatically reconnect and resume the transfer((If transfer resuming/transfer to temporary files name is disabled, file transfer will start from the beginning, with [[sftp|SFTP protocol]].)). This can be configured on //[[ui_pref_resume|Endurance page]]// of Preferences dialog. | + | With [[sftp|SFTP]] and [[ftp|FTP]] protocols, when connection is broken, WinSCP can automatically reconnect and resume the transfer.((If transfer resuming/transfer to temporary files name is disabled, file transfer will start from the beginning, with [[sftp|SFTP protocol]].)) This can be configured on //[[ui_pref_resume|Endurance page]]// of Preferences dialog. |