Differences
This shows you the differences between the selected revisions of the page.
2007-04-04 | 2007-06-06 | ||
4.0 ftp (martin) | no summary (67.163.93.71) | ||
Line 7: | Line 7: | ||
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 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. | ||
- | 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 your transfer is interrupted, a partial file (with ''.filepart'' extensions) remains in the target folder. After you try to transfer the file a second time, WinSCP looks for the partial file. If it finds a partial file, it offers you chance to resume the transfer ([[ui_pref_environment#confirmations|the confirmation can be disabled]]). |
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]]. | ||
- | 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. | + | For performance reasons, WinSCP only supports automatic file transfer resumption 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. |
===== [[manual]] Manual Resume ===== | ===== [[manual]] Manual Resume ===== | ||
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. | ||
- | 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 attempt to transfer a file already in the target directory and the target file is smaller then the source file, the 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 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. | + | 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. |
Note that you must have [[ui_pref_environment#confirmations|overwrite confirmations]] enabled to use the method. | Note that you must have [[ui_pref_environment#confirmations|overwrite confirmations]] enabled to use the method. | ||
Line 25: | Line 25: | ||
===== 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. 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. |
- | 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. | + | If the target file 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. |