synctool.exe [-cfgxml <cfgpath>] [-n] <source> <target>
||The command will be executed, and
|<target>||Target folder to sync to the source folder.|
||Print what will be performed but do not perform the action.|
synctool synchronizes directories that are needed to allow Multi-Devkit (CAT-DEV or CAT-R) sessions to operate independently.
synctool's operation is similar to that of Windows'
xcopy command: it makes the "target" folder look just like the "source" folder.
The difference from
xcopy is that
synctool attempts to save disk space, by creating hard links to files (instead of full copies) for some of the files in the "target" folder based on a "rules" file.
In regular SDK operation, no direct interaction with
synctool is necessary as it is called by the cafe
cafex as needed from a Multi-Devkit enabled window.
However, if you need to use it directly for other purposes, its command line is explained below.
synctool creates any directories (including the target folder itself) that it finds in the source folder. During the sync, it
will output its rules, a detailed log of the actions it is performing and a summary at the end with the elapsed time.
synctoolrelies upon the Microsoft .NET Framework 3.5 Client Profile. The standard edition of Windows 7 already includes .NET Framework 3.5.
synctool is a rules based folder synchronization utility. The default rules attempt to link
as many files as possible to reduce the time needed to synchronize the folders and will remove any
files in the target folder that are not in the source.
||Controls how the session
||Controls how the
If the default rules are not adequate for a source folder, a user-defined file
can be placed there to override the default one. It is best to start by copying one of the default files (code or data) and then edit it to meet your
See XML File Directives for a list and usage of the
synctool XML tags to control the sync process.
The XML file contains directives on what and how to synchronize the directories.
Each directive contains a regex pattern for matching any part of the source path. The path that the regex is matching on is relative to the source folder as given on the command line.
synctool will never delete any files from the source directory.
|XML Tag||Applied To||Description|
|Both||Link the target file to the source file.|
|Both||Copy the source file to the target file.|
|Source||Ignore the source file. will not be copied or linked.|
|Target||Delete the file in target even if it in the source folder.|
|Target||Pres eve the target file even if it is not in the source folder.|
|Target||Copy the file from source to target only if the date/time stamps are newer than the target.|
synctool.exe -cfgxml C:\SDK_ROOT\system\bin\tool\synctool.data.xml C:\SDK_ROOT\data C:\SDK_ROOT\10x1x1x1_data
Linking any file ending in "aml".
Preserve devkit settings (already in the default rules file).
synctool rules file in the source directory.
2013/07/29 Updated overview.
2013/05/08 Automated cleanup pass.
2013/04/05 Initial version.