rancid-cvs - initialize CVS, Subversion or git and rancid group files and
directories
rancid-cvs [
-V] [
-f config_file] [group
[group ...]]
rancid-cvs creates the directories and
router.db(5) for each
rancid group and handles the revision control system (CVS, Subversion or git)
set-up in the location defined by the
CVSROOT in
rancid.conf(5).
It must be run after the initial installation and whenever a rancid group is
added. If
CVSROOT is a URL,
rancid-cvs will not initialize the
repository, the user must do this themselves.
rancid-cvs reads
rancid.conf(5) to configure itself, then proceeds
with the initialization. First of the CVS, Subversion or git repository, if
necessary, and then for each of the rancid groups listed on the command-line
or those in the variable
LIST_OF_GROUPS from
rancid.conf(5), if
the argument is omitted.
Running
rancid-cvs for groups which already exist will not cause
problems. If the group's directory already exists, the import into the
revision control system will be skipped, and if it's
router.db(5)
already exists, it will not be altered.
The command-line options are as follows:
- -V
- Prints package name and version strings.
- -f group_config_file
- Specify an alternative rancid.conf. The global rancid.conf
file is read by rancid-run.
The best method for adding groups is by adding the group name to
LIST_OF_GROUPS in
rancid.conf(5), then run
rancid-cvs.
Do not create the directories manually, allow rancid-cvs to do it.
cvs(1),
git(1),
rancid.conf(5),
router.db(5),
svn(1)
In the case of git, the groups are not exactly imported into the repository,
rather a new repository is created for it, due to the way that git handles,
what it calls, sparse checkouts. Instead, each group is a separate repository
under the
CVSROOT directory.