Differences
This shows you the differences between the selected revisions of the page.
| 2006-11-11 | 2007-04-04 | ||
| old revision restored (martin) (hidden) | 4.0 ftp (martin) | ||
| Line 2: | Line 2: | ||
| ===== Basic Usage ===== | ===== Basic Usage ===== | ||
| - | WinSCP supports resuming file transfers with [[protocols|SFTP protocol]] only. SCP protocol does not allow it at all. | + | WinSCP supports resuming file transfers with [[protocols#sftp|SFTP]] and [[protocols#ftp|FTP]] protocols. [[protocols#scp|SCP]] protocol does not allow it. |
| - | For performance reasons resuming file transfer is supported only for files larger then a given threshold. By default the threshold is 100 kB. This can be configured on //[[ui_pref_resume|Resume tab]]// of Preferences dialog. Also resuming [[transfer_mode|text mode transfers]] is not supported. | + | ===== [[automatic]] Automatic Resume ===== |
| - | + | When transferring file with SFTP protocol((Supported for SFTP-2 and newer only (most of the current SFTP servers) )), it is first transferred into a temporary file with ''.filepart'' extension. Only after the transfer is completed the extension is removed. | |
| - | When transferring file, it is first transferred into a temporary file with ''.filepart'' extension. Only after the transfer is completed the extension is removed. | + | |
| If the transfer is interrupted, by user or because of dropped connection, partial file (with ''.filepart'' extensions) remains in the target folder. Once you attempt to transfer the same file again, WinSCP looks for the partial file. If it finds any, it offers you chance to resume the transfer ([[ui_pref_environment#confirmations|the confirmation can be disabled]]). | If the transfer is interrupted, by user or because of dropped connection, partial file (with ''.filepart'' extensions) remains in the target folder. Once you attempt to transfer the same file again, WinSCP looks for the partial file. If it finds any, it offers you chance to resume the transfer ([[ui_pref_environment#confirmations|the confirmation can be disabled]]). | ||
| Line 12: | Line 11: | ||
| 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]]. | ||
| - | ===== Alternate Usage ===== | + | For performance reasons, automatic resuming of file transfer is supported only for files larger then a given threshold. By default the threshold is 100 kB. This can be configured on //[[ui_pref_resume|Resume tab]]// of Preferences dialog. Also automatic resuming of [[transfer_mode|text mode transfers]] is not supported. |
| - | The above method of resuming file transfers is supported only for [[protocols|SFTP version 2]] and newer (most of the current SFTP servers). There is another method supported even for the older servers (but not for SFTP version 4 and newer for ASCII/text transfers). Even if your server supports SFTP version 2 and never, you may find the method useful. Note that you must have [[ui_pref_environment#confirmations|overwrite confirmations]] enabled to use the method. | + | |
| + | ===== [[manual]] Manual Resume ===== | ||
| + | There's an alternative manual method to resume transfer, which can be used with FTP protocol. | ||
| + | |||
| + | When you attempt to transfer file that already exists in target directory and target file is smaller then source file, the overwrite confirmation dialog offers either //Resume// button directly or //Append// button (when appending is supported). After pressing an //Append// button another prompt will be displayed offering you either to append source file or to resume transfer. | ||
| + | |||
| + | If you select to resume transfer, the part of source file equal to size of the target file will be skipped and only the remaining part will be transferred. | ||
| - | When you attempt to transfer file that already exists in target directory, the overwrite confirmation dialog is displayed. It offers //Append// button. By default it appends source file to the end of the target file. But if the target file is smaller then the source file, another prompt will be displayed offering you either to append source file or to resume transfer. If you select to resume transfer, the part of source file equal to size of the target file will be skipped and only the remaining part will be transferred. | + | Note that you must have [[ui_pref_environment#confirmations|overwrite confirmations]] enabled to use the method. |
| - | The method is particularly useful for resuming transfers initiated by other clients and also to update log files. | + | 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 ===== | ||
| - | It is on user responsibility that he/she resumes transfer with the same version of source file as the transfer was interrupted. Otherwise you will end with target file consisting partly of previous version and partly of current version of the source file. If the partial file is bigger than the source file, WinSCP will display error and disallow resume. | + | It is on user responsibility that he/she resumes transfer with the same version of source file as the transfer was interrupted. Otherwise you will end with target file consisting partly of previous version and partly of current version of the source file. For automatic resume, if the partial file is bigger than the source file, WinSCP will display error and disallow resume. |
| - | If the target file already exists and it is not write-able, but the target directory is, the file will may be transferred anyway. The error overwriting the file will occur only after the transfer finishes. It is because the file is first transferred into temporary file. | + | If the target file already exists and it is not write-able, but the target directory is, the file will may be transferred anyway with automatic resume. The error overwriting the file will occur only after the transfer finishes. It is because the file is first transferred into temporary file. |
| ===== Resuming from Broken Connections ===== | ===== Resuming from Broken Connections ===== | ||
| With [[protocols|SFTP protocol]], when connection is broken, WinSCP can automatically reconnect and resume the transfer((If transfer resuming is disabled, file transfer will start from the beginning.)). This can be configured on //[[ui_pref_resume|Resume tab]]// of Preferences dialog. | With [[protocols|SFTP protocol]], when connection is broken, WinSCP can automatically reconnect and resume the transfer((If transfer resuming is disabled, file transfer will start from the beginning.)). This can be configured on //[[ui_pref_resume|Resume tab]]// of Preferences dialog. | ||