rancid-cvs(1)rancid-cvs(1)rancid-cvs(1)rancid-cvs(1)NAMErancid-cvs - initialize CVS, Subversion or git and rancid group files
and directories
SYNOPSISrancid-cvs [-V] [-f config_file] [group [group ...]]
DESCRIPTIONrancid-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.
SEE ALSOcvs(1), git(1), rancid.conf(5), router.db(5), svn(1)CAVEATS
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.
17 December 2014 rancid-cvs(1)
