Differences
This shows you the differences between the selected revisions of the page.
| ui_transfer_custom 2019-10-18 | ui_transfer_custom 2024-10-31 (current) | ||
| Line 13: | Line 13: | ||
| Use selector to choose a way how to convert filename case when transferring files. This is particularly useful when transferring files between platform with case-sensitive file-system (like Unix) and platform with case-insensitive file-system (like Windows or Mac). Special option //Lower case 8.3// is useful for [[task_upload|uploads]] only. With it only files whose filename follows legacy MS-DOS format (8-letter name and 3-letter extension, all letters uppercase) are converted to lower case. | Use selector to choose a way how to convert filename case when transferring files. This is particularly useful when transferring files between platform with case-sensitive file-system (like Unix) and platform with case-insensitive file-system (like Windows or Mac). Special option //Lower case 8.3// is useful for [[task_upload|uploads]] only. With it only files whose filename follows legacy MS-DOS format (8-letter name and 3-letter extension, all letters uppercase) are converted to lower case. | ||
| - | The //Replace '\:*?'// checkbox enables automatic modification of filenames to match Windows requirements. | + | The //==Replace== '\:*?'// checkbox enables automatic modification of filenames to match Windows requirements. |
| On download, WinSCP: | On download, WinSCP: | ||
| Line 28: | Line 28: | ||
| ===== Attributes ===== | ===== Attributes ===== | ||
| + | |||
| ==== [[upload]] Upload Options ==== | ==== [[upload]] Upload Options ==== | ||
| The //Set permissions// checkbox enables you to specify [[ui_permissions|permissions]] to be set for the [[task_upload|uploaded]] files. When unchecked the newly uploaded files will have default permissions,((Note that ''umask'' is not interpreted by some (if not all) SFTP servers.)) which is platform-dependent, and the overwritten files usually preserve their previous permissions, but this can also vary with the platform. Setting permissions is not available if the server does not support UNIX-style permissions. | The //Set permissions// checkbox enables you to specify [[ui_permissions|permissions]] to be set for the [[task_upload|uploaded]] files. When unchecked the newly uploaded files will have default permissions,((Note that ''umask'' is not interpreted by some (if not all) SFTP servers.)) which is platform-dependent, and the overwritten files usually preserve their previous permissions, but this can also vary with the platform. Setting permissions is not available if the server does not support UNIX-style permissions. | ||
| Line 33: | Line 34: | ||
| To specify the permissions, you can type them directly into the box below. Use either octal format or ''rwxrwxrwx'' form. To enable feature //Add X to directories// add ''+x'' at the end. If you do not want to type permissions directly, use ellipsis button (//...//) to reveal [[ui_permissions|permissions popup box]], or use context menu to choose from typical permissions. | To specify the permissions, you can type them directly into the box below. Use either octal format or ''rwxrwxrwx'' form. To enable feature //Add X to directories// add ''+x'' at the end. If you do not want to type permissions directly, use ellipsis button (//...//) to reveal [[ui_permissions|permissions popup box]], or use context menu to choose from typical permissions. | ||
| - | Note that while you may have rights to overwrite the remote file, you may not have rights to change its attributes (permissions and timestamps). If you upload set of files, where for some you do not have the rights, you may want to check //Ignore permission errors// to avoid being prompted with error message for each of them. This option is supported with SFTP protocol only. | + | Note that while you may have rights to overwrite the remote file, you may not have rights to change its attributes (permissions and timestamps). If you upload set of files, where for some you do not have the rights, you may want to check //==Ignore== permission errors// to avoid being prompted with error message for each of them. This option is supported with SFTP protocol only. |
| With FTP protocol, setting permissions during upload is not supported. You can [[task_properties|change permissions explicitly]] after upload. With WebDAV and S3 protocols, setting permissions is not supported at all. | With FTP protocol, setting permissions during upload is not supported. You can [[task_properties|change permissions explicitly]] after upload. With WebDAV and S3 protocols, setting permissions is not supported at all. | ||
| Line 41: | Line 42: | ||
| Enable //Remove BOM and EOF marks// to make WinSCP remove UTF-8 byte order marks and eof-of-file marks from files uploaded using [[transfer_mode|text mode transfers]]. Enable the option, if your remote system cannot handle these marks. The option is not available, when binary transfer mode is selected. Removing EOF mark is supported with SFTP and SCP protocols only. | Enable //Remove BOM and EOF marks// to make WinSCP remove UTF-8 byte order marks and eof-of-file marks from files uploaded using [[transfer_mode|text mode transfers]]. Enable the option, if your remote system cannot handle these marks. The option is not available, when binary transfer mode is selected. Removing EOF mark is supported with SFTP and SCP protocols only. | ||
| - | With [[file_encryption|file encryption]] enabled, use //Encrypt new files// checkbox to control, if [[file_encryption#files|newly uploaded files should be encrypted or not]]. Value of the option in the current transfer settings also controls encryption of newly created folders. | + | With [[file_encryption|file encryption]] enabled, use //==Encrypt new files==// checkbox to control, if [[file_encryption#files|newly uploaded files should be encrypted or not]]. Value of the option in the current transfer settings also controls encryption of newly created folders. |
| ==== [[download]] Download Options ==== | ==== [[download]] Download Options ==== | ||
| Line 49: | Line 50: | ||
| The //Preserve timestamp// checkbox makes WinSCP preserve the last modification timestamp of the transferred file. Note that there are several [[timestamp|factors that can affect timestamp recalculation]] between local and remote filesystem. Check the suboption //Including directories// to preserve the last modification timestamp of the transferred directories too (This option is supported with [[SFTP]] protocol only.) | The //Preserve timestamp// checkbox makes WinSCP preserve the last modification timestamp of the transferred file. Note that there are several [[timestamp|factors that can affect timestamp recalculation]] between local and remote filesystem. Check the suboption //Including directories// to preserve the last modification timestamp of the transferred directories too (This option is supported with [[SFTP]] protocol only.) | ||
| - | Note that while you may have rights to overwrite the remote file, you may not have rights to change its timestamp. See //[[#upload|Ignore permissions errors]]//. With FTP protocol, preserving timestamp of uploaded files may not be supported with old FTP servers.((Server needs to support ''MFMT'' command.)) The option is also disabled when configuring transfer settings for [[task_synchronize_full|synchronization]], as preserving timestamps is mandatory then.((Unless comparison criteria //[[ui_synchronize#criteria|Modification time]]// is turned off.)) Most WebDAV servers do not support preserving timestamps, but as the capability is not detectable, the option is available always and when enabled, WinSCP tries to preserve the timestamp and silently continues when the server fails. S3 protocol does support preserving timestamps either. | + | Note that while you may have rights to overwrite the remote file, you may not have rights to change its timestamp. See //[[#upload|Ignore permissions errors]]//. The option is disabled when configuring transfer settings for [[task_synchronize_full|synchronization]], as preserving timestamps is mandatory then.((Unless comparison criteria //[[ui_synchronize#criteria|Modification time]]// is turned off.)) With FTP protocol, preserving timestamp of uploaded files may not be supported with old FTP servers.((Server needs to support ''MFMT'' command.)) Most WebDAV servers do not support preserving timestamps, but as the capability is not detectable, the option is available always and when enabled, WinSCP tries to preserve the timestamp and silently continues when the server fails. S3 protocol does not support preserving timestamps either. |
| - | The //Calculate total size// checkbox make WinSCP calculate total size of all files in all selected directories to be transferred before the actual transfer. It allows it then to estimate time necessary to complete the transfer. Note that if you are going to transfer large number of directories the calculation can take significant time. If the option is disabled, [[ui_pref_background|multiple connections]] cannot be used for background transfers. Though for background transfers with multiple connections, the calculation does not add time to a transfer, as directories are not listed again for the transfer itself. | + | The //==Calculate== total size// checkbox makes WinSCP calculate total size of all files in all selected directories to be transferred before the actual transfer. It allows it then to estimate time necessary to complete the transfer. Note that if you are going to transfer large number of directories the calculation can take significant time. The option cannot be disabled for background transfers, when using [[ui_pref_background|multiple connections]]. Note that when using multiple connections, the calculation does not add time to a transfer, as directories are not listed again for the transfer itself. |
| Use //Speed// to limit transfer speed. The limit is in KB/s. You can also change the speed on [[ui_progress|progress windows]] while files are being transferred. To remove speed limit, set it to "Unlimited". | Use //Speed// to limit transfer speed. The limit is in KB/s. You can also change the speed on [[ui_progress|progress windows]] while files are being transferred. To remove speed limit, set it to "Unlimited". | ||