NAME
synctree - Normalize a tree of files with a tree of ClearCase elements
SYNOPSIS
Run this script with the -help option for usage details. Here are some additional sample usages with explanations:
synctree -ci -sbase /tmp/newcode -dbase /vobs_tps/xxx /tmp/newcode/xxx[Take all files located under /tmp/newcode/xxx, remove the leading "/tmp/newcode", from each of their pathnames, and place the remaining relative paths under "/vobs_tps/xxx". Check in when done.]
synctree -cr -sbase /vobs/hpux/bin -dbase /vobs_rel/hpux/bin[Sync up all files under "/vobs_rel/hpux/bin" with those in "/vobs/hpux/bin", making sure to preserve their CR's.]
DESCRIPTION
Brings a VOB area into alignment with a specified set of files from a source area. This is analogous in some ways to clearexport_* and clearimport but those cannot work incrementally; they do an all-or-nothing import. Synctree is useful if you have a ClearCase tree that must be kept in sync with a CVS tree during a transition period, or for overlaying releases of third-party products upon previous ones, or similar.
The default operation is to mkelem all files which exist in <src> but not in <dest>, modify any files which exist in both but differ, but not to remove files which are present in <dest> and not in <src>. The -subtract flag will cause this removal to happen too.
This script must run in a view context; the branching rules of any checkouts it does will be governed by that config spec. Also, the directory named by the -dbase flag must exist and lie under a mounted VOB tag.
The list of source files to operate on may be provided with the -flist option or it may come from @ARGV. Any directories encountered on @ARGV will be traversed recursively. If no source-file-list is provided at all, the directory specified with -sbase is treated as the default.
File paths may be given as relative or absolute; all filenames are turned into absolute paths, then the path given with the -sbase parameter is removed and replaced with that of -dbase to produce the destination pathname.
Consider using the -preview or -testdrive flags the first time you use this on a valued VOB, even though nothing irreversible is done (e.g. no rmelem, rmbranch, rmver, rmtype, etc.).
AUTHOR
David Boyce <dsb@world.std.com>
COPYRIGHT
Copyright (c) 2000 David Boyce. All rights reserved. This Perl program is free software; you may redistribute and/or modify it under the same terms as Perl itself.
STATUS
This is currently ALPHA code and thus I reserve the right to change the UI incompatibly. At some point I'll bump the version suitably and remove this warning, which will constitute an (almost) ironclad promise to leave the interface alone.
PORTING
The guts of this program are in the ClearCase::SyncTree module, which is known to work on Solaris 2.6-7 and Windows NT 4.0SP3-5, and with perl 5.004_04 and 5.6. The synctree wrapper program per se has had only rudimentary testing on Windows but appears to work fine there.
SEE ALSO
perl(1), "perldoc ClearCase::SyncTree"