Differences
This shows you the differences between the selected revisions of the page.
| ui_synchronize 2007-04-11 | ui_synchronize 2024-02-15 (current) | ||
| Line 1: | Line 1: | ||
| ====== Synchronize Dialog ====== | ====== Synchronize Dialog ====== | ||
| - | 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_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/Target directory ===== | ===== Direction/Target directory ===== | ||
| - | Use options //Both//, //Remote// or //Local// to select your preferred [[task_synchronize_full#synchronization_direction|synchronization direction]]. | + | Use options //Both//, //Remote// or //Local// to select your preferred [[task_synchronize_full#direction|synchronization direction]]. |
| ===== Mode ===== | ===== Mode ===== | ||
| - | Use options //Synchronize files//, //Mirror files// or //Synchronize timestamps// to select your preferred [[task_synchronize_full#synchronization_mode|synchronization mode]]. | + | Use options //Synchronize files//, //Mirror files// or //Synchronize timestamps// to select your preferred [[task_synchronize_full#mode|synchronization mode]]. |
| - | ===== Synchronize Options ===== | + | ===== [[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 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. | + | 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 22: | 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 with //Both// direction selected. 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. |
| - | With //Both// direction selected, //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// 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 direction 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 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. | + | 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. | ||