Differences
This shows you the differences between the selected revisions of the page.
| ui_pref_transfer 2005-03-04 | ui_pref_transfer 2022-06-15 (current) | ||
| Line 1: | Line 1: | ||
| - | ====== Transfer Tab ====== | + | ====== The Transfer Page (Preferences Dialog) ====== |
| - | The Transfer tab allows you to configure default transfer options. These can be changed for particular transfer on [[ui_copy|Upload/Download dialog]], unless it is disabled. | + | The //Transfer page// on the [[ui_preferences|Preferences dialog]] allows you to configure default [[transfer_settings|transfer settings]] and [[transfer_settings#presets|transfer settings presets]] (including autoselection rules). |
| &screenshotpict(pref_transfer) | &screenshotpict(pref_transfer) | ||
| - | ===== Transfer Mode ===== | + | More transfer options are available on subpages: |
| - | 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//. | + | * [[ui_pref_dragdrop|Drag&Drop]] |
| + | · * [[ui_pref_background|Background]] | ||
| + | * [[ui_pref_resume|Endurance]] | ||
| - | ===== Filename Modification ===== | + | &toc_title_page_sections |
| - | Use selector to choose a way how to convert filename case when transferring files. This is particularly useful when transferring file 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 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 affects downloads only. It makes WinSCP automatically replace characters that are not allowed in Windows filenames (''/\:*?\"<>|'') with underscore (''_''). | + | ===== Default Transfer Settings ===== |
| + | To view default [[transfer_settings|transfer settings]], select the first //Default// item in a list in the upper part of the page. Your configured settings appear below the list. | ||
| - | ===== Attributes ===== | + | To change the settings, use //Edit// button to show [[ui_transfer_custom|Transfer Settings dialog]] (alternatively you may click //Transfer settings// box). |
| - | ==== Upload Options ==== | + | |
| - | The //Set permissions// checkbox enables you to specify [[ui_permissions|permissions]] to be set for the uploaded files. The unchecked the newly uploaded files will have default permissions, which is platform-dependant, and the overwritten files usually preserve their previous permissions, but this can also vary with the platform. | + | |
| - | Note that while you may have rights to overwrite the remote file, you may not have rights to change its permissions. You need then to uncheck the //Set permissions// to be able to upload the files without being prompted with an error message. | + | You cannot delete nor reorder the default transfer settings. |
| - | ==== Download Options ==== | + | ===== Transfer Settings Presets ===== |
| - | The //Preserve read-only// checkbox makes WinSCP to set "read-only" attribute to downloaded files that do not have user-write permission set. | + | The list in the upper part of the page shows configured [[transfer_settings#presets|transfer settings presets]] in the same order as they will appear in menus (for example on //[[ui_toolbars#transfer|Transfer Settings Toolbar]]//). The order is also important when evaluating autoselection rules (the first matching preset wins). |
| - | ==== Common Options ==== | + | Initially the list will contain set of example presets. |
| - | The //Preserve timestamp// checkbox makes WinSCP preserve the last modification timestamp of the transferred file. To allow timestamp recalculation between local and remote filesystem work correctly you need to set appropriately option //[[ui_login_environment#daylight_saving_time|Daylight saving time]]//. With [[protocols|SCP protocol]] you need to set correctly also option //[[ui_login_scp#other_options|Server timezone offset]]//. | + | |
| - | Note that while you may have rights to overwrite the remote file, you may not have rights to change its timestamp. You need then to uncheck the //Preserve timestamp// to be able to upload the files without being prompted with an error message. | + | Column //Preset description// shows name of the preset as will appear in menus. Column //Auto// indicates if there is autoselection rule associated with the preset. |
| - | The //Calculate total size// checkbox make WinSCP calculate total size of all files to be transfered 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. | + | Use button //Add// to add new preset. //[[ui_transfer_preset|Transfer settings preset editor dialog]]// will appear. The newly added preset will be inserted before a preset selected in the list or at the end, if no preset is selected. |
| - | ===== Other Options ===== | + | Use button //Edit// to edit selected preset. //[[ui_transfer_preset|Transfer settings preset editor dialog]]// will appear. |
| - | In the //Exclude mask// you can specify [[file_mask|file mask]] to exclude certain files/directories (or file types) from the transfer. Leave empty to transfer all files. | + | |
| - | The //Clear source file 'Archive' attribute// checkbox makes WinSCP unset the "archive" attribute of source files once the upload finishes. The option is not available for downloads. | + | Use button //Remove// to remove selected preset. If you remove preset by mistake, you can always cancel whole Preferences dialog to undo all changes. |
| + | |||
| + | Use button //Duplicate// to duplicate selected preset. //[[ui_transfer_preset|Transfer settings preset editor dialog]]// will appear, where you need to give new name to the duplicated preset (and change the settings as desired). | ||
| + | |||
| + | Use buttons //Up// and //Down// to change order of the presets. The other is important when evaluating autoselection rules (the first matching preset wins). | ||
| + | |||
| + | The //Announce when transfer settings preset is autoselected// checkbox makes announcement box pop up whenever transfer settings is automatically changed due to autoselection rule. If the options if turned off, you can still see announcement message on the status bar of the main window. The checkbox is disabled, when there is no preset with autoselection rule. | ||
| + | |||
| + | ===== Further Reading ===== | ||
| + | Read more about [[ui_preferences|Preferences dialog]] and its other [[ui_preferences#pages|pages]]. | ||