ui_transfer » Revisions »
Differences
This shows you the differences between the selected revisions of the page.
| ui_transfer 2008-11-27 | ui_transfer (current) | ||
| Line 1: | Line 1: | ||
| - | ====== Transfer Settings ====== | ||
| - | On several occasions you need or have chance to configure [[transfer_settings|transfer settings]]. This includes: | ||
| - | * Setting [[ui_pref_transfer|default transfer settings]]. | ||
| - | * Setting [[ui_transfer_preset|transfer settings presets]]. | ||
| - | * [[ui_copy|Uploading/downloading]] files. | ||
| - | * Configuring custom settings for functions //[[ui_synchronize|Synchronize]]// and //[[ui_keepuptodate|Keep remote directory up to date]]//. | ||
| - | |||
| - | Dialogs associated with the above operations will include box similar to the one below. Note that the picture shows all possible options that may not be always available. | ||
| - | |||
| - | &screenshotpict(transfer) | ||
| - | |||
| - | ===== Transfer Mode ===== | ||
| - | Use box //Transfer mode// to select preferred [[transfer_mode|transfer mode]]. If you select //Automatic// mode, you should update the text [[file_mask|file mask]] in //Transfer following files in text mode//. | ||
| - | |||
| - | ===== Filename Modification ===== | ||
| - | 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. | ||
| - | |||
| - | On download, WinSCP: | ||
| - | * Replaces characters that are not allowed in Windows filenames (''/\:*?\"<>|'') with ''%XX'', where ''XX'' is hexadecimal representation of character ASCII code. | ||
| - | * Replaces trailing space with ''%20''. | ||
| - | On upload, WinSCP reverses the modifications to restore original filename. | ||
| - | |||
| - | As percent sign (''%'') has special meaning when the replacing is enabled, the sign itself has to be replaced, although it is allowed in Windows filenames. If you want to prevent that you need to turn the replacing off. | ||
| - | |||
| - | ===== Attributes ===== | ||
| - | ==== 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. | ||
| - | |||
| - | 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. | ||
| - | |||
| - | |||
| - | ==== Download Options ==== | ||
| - | The //Preserve read-only// checkbox makes WinSCP to set "read-only" attribute to [[task_download|downloaded]] files that do not have user-write permission set. The option is not available if the server does not support UNIX-style permissions. | ||
| - | |||
| - | ==== Common Options ==== | ||
| - | 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. With FTP protocol, preserving timestamp of uploaded files is not supported. | ||
| - | |||
| - | Note that while you may have rights to overwrite the remote file, you may not have rights to change its timestamp. See //[[ui_transfer#upload_options|Ignore permissions errors]]//. | ||
| - | |||
| - | The //Calculate total size// checkbox make WinSCP calculate total size of all files 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 files the calculation can take significant time. | ||
| - | |||
| - | ===== Other Options ===== | ||
| - | In the //Exclude/Include mask// you can specify [[file_mask|file mask]] to exclude certain files/directories (or file types) from the transfer. When //Exclude// option is selected, the files/directories matching mask will be excluded from transfer. When //Include// option is selected, only the files/directories matching mask will be transferred. | ||
| - | Leave mask empty to transfer all files/directories. The option also excludes files from [[task_synchronize_full|synchronization]] and makes them be ignored by function //[[task_keep_up_to_date|Keep remote directory up to date]]//. | ||
| - | |||
| - | The //Clear source file 'Archive' attribute// checkbox makes WinSCP unset the "archive" attribute of source files once the [[task_upload|upload]] finishes. The option is not available for [[task_download|downloads]]. | ||