Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
rancid-cvs(1)		     General Commands Manual		   rancid-cvs(1)

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.

				18 December 2014		   rancid-cvs(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=rancid-cvs&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help