NAME

       rancid-cvs  -  initialize CVS, Subversion or git	and rancid group files
       and directories


SYNOPSIS

       rancid-cvs [-V] [-f config_file]	[group [group ...]]


DESCRIPTION

       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.


SEE ALSO

       cvs(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)

Man(1) output converted with man2html