Differences
This shows you the differences between the selected revisions of the page.
2025-09-17 | 2025-09-17 (current) | ||
Restored revision 1757967850. Undoing revision 1758057666. (martin) (hidden) | the (martin) | ||
Line 14: | Line 14: | ||
===== [[options]] 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 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 //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 the 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 the opposite directory as new. Such files and subdirectories will be ignored. |
- | The //**Preview changes**// checkbox makes WinSCP display [[ui_synchronize_checklist|synchronization checklist]] to allow you to further refine what changes you want to actually make. | + | The //Preview changes// checkbox makes WinSCP display [[ui_synchronize_checklist|synchronization checklist]] to allow you to further refine what changes you want to actually make. |
- | 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. |
===== [[criteria]] 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. |
- | 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 //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. |
- | 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. | + | 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. |
When no option is checked, existing files are considered the same always. So only new files are synchronized. | When no option is checked, existing files are considered the same always. So only new files are synchronized. | ||
- | With //**Both**// direction selected, //Modification time// is always checked and the other criteria are unchecked. | + | With //Both// direction selected, //Modification time// is always checked and the other criteria are unchecked. |
- | 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. | + | 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. |
- | Use the //**Case sensitive**// checkbox to make WinSCP consider files with the same name but a different letter case to be different. | + | 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]] Saving Options ===== |