Differences
This shows you the differences between the selected revisions of the page.
| ui_synchronize 2007-03-22 | ui_synchronize 2024-02-15 (current) | ||
| Line 1: | Line 1: | ||
| ====== Synchronize Dialog ====== | ====== Synchronize Dialog ====== | ||
| - | In Synchronize Dialog you select mode and options for [[task_synchronize_full|synchronization]]. To display the dialog go to //Commands > Synchronize// or click respective [[ui_toolbar|toolbar]] button. | + | In Synchronize Dialog you select direction, mode and options for [[task_synchronize_full|synchronization]]. To display the dialog go to //Commands > Synchronize// or click respective [[ui_toolbars|toolbar]] button. |
| &screenshotpict(synchronize) | &screenshotpict(synchronize) | ||
| ===== Directories ===== | ===== Directories ===== | ||
| - | Enter root directories for the synchronization into //Local directory// and //Remote directory// boxes. By default the current working directories will be used. In the [[ui_explorer|Explorer-like interface]], where there is no local working directory, it will be the last local directory used. | + | Enter root directories for the synchronization into //Local directory// and //Remote directory// boxes. By default the current working directories will be used. In the [[ui_explorer|Explorer interface]], where there is no local working directory, it will be the last local directory used. |
| - | ===== Direction (Modes) ===== | + | ===== Direction/Target directory ===== |
| - | Use options //Both//, //Remote// or //Local// to select your preferred [[task_synchronize_full#synchronization_modes|synchronization mode]]. | + | Use options //Both//, //Remote// or //Local// to select your preferred [[task_synchronize_full#direction|synchronization direction]]. |
| - | ===== Synchronize Options ===== | + | ===== Mode ===== |
| - | The //Synchronize timestamps only, not files// checkbox makes WinSCP just update timestamps of existing files. It will not do any transfers, nor delete anything. Simply, whenever it finds the same file in both directories it updates the timestamp of target file to match the one of source file. In //Both// mode it always updates the older timestamp. With the option set, the most other options cannot be configured. The option is available with [[protocols#sftp|SFTP protocol]] only. | + | Use options //Synchronize files//, //Mirror files// or //Synchronize timestamps// to select your preferred [[task_synchronize_full#mode|synchronization mode]]. |
| - | The //Delete files// checkbox makes WinSCP delete files and subdirectories in target directory that are not present in a source directory. The option is not available for //Both// mode, because in the mode such files and subdirectories are always considered as new and transfered into the opposite directory (unless //Existing files only// is checked). Deleted local files are moved to recycle bin if preference option //[[ui_pref_panels#common_options|Delete local files to recycle bin]]// is enabled only. | + | ===== [[options]] Synchronize Options ===== |
| + | The //Delete files// checkbox makes WinSCP delete files and subdirectories in target directory that are not present in a source directory. The option is not available for //Both// direction, because then such files and subdirectories are always considered as new and transferred into the opposite directory (unless //Existing files only// is checked).((If you want to synchronize file removals, install an extension [[library_example_two_way_synchronize_delete|*]].)) Deleted local files are moved to recycle bin if preference option //[[ui_pref_panels#common|Delete local files to recycle bin]]// is enabled only. | ||
| The //Existing files only// checkbox makes WinSCP not to consider files and subdirectories not existing in an opposite directory as new. Such files and subdirectories will be ignored. | The //Existing files only// checkbox makes WinSCP not to consider files and subdirectories not existing in an opposite directory as new. Such files and subdirectories will be ignored. | ||
| Line 21: | Line 22: | ||
| The //Selected files only// checkbox makes WinSCP synchronize only files and directories [[ui_file_panel#selecting_files|selected in any file panel]]. The option is not available, if no file or directory is selected. | The //Selected files only// checkbox makes WinSCP synchronize only files and directories [[ui_file_panel#selecting_files|selected in any file panel]]. The option is not available, if no file or directory is selected. | ||
| - | ===== Comparison Criteria ===== | + | ===== [[criteria]] Comparison Criteria ===== |
| The section defines criteria for determining whether two files (local and remote) are the same or not. | The section defines criteria for determining whether two files (local and remote) are the same or not. | ||
| With //Modification time// checked (default) two files are considered different when they have different timestamps. | With //Modification time// checked (default) two files are considered different when they have different timestamps. | ||
| - | With //File size// checked two files are considered different when they have different sizes. The option is not available for //Both// mode. When using the option, you should avoid [[transfer mode|text transfer mode]] as it may change the file size. | + | With //File size// checked two files are considered different when they have different sizes. The option is not available with //Both// direction selected. When using the option, you should avoid [[transfer_mode|text transfer mode]] as it may change the file size. |
| - | Note that while you can check both options, you cannot uncheck both. When both options are checked, //Modification time// has higher priority. As a consequence, file is not considered updated, despite having different size, if it is older. | + | With //Checksum// checked two files are considered different when they have different checksums. The option is not available with //Both// direction selected. Requires [[protocols#checksum|support for calculating checksum]]. SHA-256 checksum is used by default, with automatic fallback to SHA-1, when not supported. |
| - | In //Both// mode, //Modification time// is always checked and //File size// unchecked.· | + | When //Modification time// is checked along with any other the other two, it has higher priority. As a consequence, in the default //Synchronize files// [[task_synchronize_full#mode|synchronization mode]], a file is not considered updated, despite having different size or checksum, if the source file is older than the destination file. |
| - | For //Synchronize timestamps only, not files// mode checkbox //Same size only// is available. It makes WinSCP update timestamp of the files, that have same size in both directories, only. | + | When no option is checked, existing files are considered the same always. So only new files are synchronized. |
| - | ===== Transfer Settings ===== | + | With //Both// direction selected, //Modification time// is always checked and the other criteria are unchecked.· |
| - | //Transfer settings// box shows current [[transfer_settings|transfer settings]]. | + | |
| - | To change the settings, use //Transfer settings// button. It will reveal drop down menu with list of configured [[transfer_settings#transfer_settings_presets|presets]]. Use special command //Custom// to configure [[ui_transfer_custom|ad hoc transfer settings]] (alternatively you may double-click //Transfer settings// box). Command //Configure// opens Preferences dialog on //[[ui_pref_presets|Presets tab]]//. | + | For //Synchronize timestamps// mode checkbox //Same size only// is available. It makes WinSCP update timestamp of the files, that have same size in both directories, only. The mode is available with [[sftp|SFTP protocol]] only. |
| - | You may want to change transfer settings particularly to [[ui_transfer#other_options|exclude certain files and subdirectories]] from synchronization. | + | Use the //Case sensitive// checkbox to make WinSCP consider files with the same name but a different letter case to be different. |
| - | ===== Saving Options ===== | + | ===== [[saving_options]] Saving Options ===== |
| - | Check //Use same options next time// if you want to make your options be default next time you use function //[[task_synchronize_full|Synchronize]]//. Note that this will affect function //[[task_keep_up_to_date|Keep remote directory up to date]]// as well. | + | Check //Use same options next time// if you want to make your options be default next time you use function //[[task_synchronize_full|Synchronize]]//. This will not save transfer settings. You can change default transfer settings in [[ui_pref_transfer|preferences]]. Note that defaults affect function //[[task_keep_up_to_date|Keep remote directory up to date]]// as well. |
| + | |||
| + | In [[ui_explorer|Explorer interface]] synchronization direction is saved too. | ||
| + | |||
| + | In [[ui_commander|Commander interface]] the direction is initially autoselected based on the currently active [[ui_file_panel|file panel]]. To disable autoselection you need to select different direction than autoselected, check //Use same options next time// and then confirm that you really want to make the new direction default. Note that there is no way to revert back to autoselection. | ||
| + | |||
| + | ===== Transfer Settings ===== | ||
| + | //Transfer settings// box shows current [[transfer_settings|transfer settings]]. | ||
| - | In [[ui_explorer|Explorer-like interface]] synchronization mode is saved too. | + | To change the settings, use //Transfer settings// button to show [[ui_transfer_custom|Transfer Settings dialog]] (alternatively you may click //Transfer settings// box). Clicking drop-down icon on the button reveals menu with list of configured [[transfer_settings#presets|presets]]. Command //Configure// opens Preferences dialog on //[[ui_pref_transfer|Transfer page]]//. |
| - | In [[ui_commander|Norton Commander interface]] the mode is initially autoselected based on the currently active [[ui_file_panel|file panel]]. To disable autoselection you need to select different mode than autoselected, check //Use same options next time// and then confirm that you really want to make the new mode default. Note that there is no way to revert back to autoselection. | + | You may want to change transfer settings particularly to [[ui_transfer_custom#other|exclude certain files and subdirectories]] from synchronization. Although the [[file_mask|file mask]] is part of transfer settings, in context of synchronization it affects also file deletion. |
| + | ===== [[new_window]] Starting in New Window ===== | ||
| + | In the drop-down menu of the //OK// button, you can also start synchronization in a separate window, to avoid blocking the current window. | ||