1rancid-cvs(1)               General Commands Manual              rancid-cvs(1)
2
3
4
5rancid-cvs(1)               General Commands Manual              rancid-cvs(1)
6
7
8

NAME

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

SYNOPSIS

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

DESCRIPTION

17       rancid-cvs creates the directories and  router.db(5)  for  each  rancid
18       group  and handles the revision control system (CVS, Subversion or git)
19       set-up in the location defined by the CVSROOT  in  rancid.conf(5).   It
20       must  be run after the initial installation and whenever a rancid group
21       is added.  If CVSROOT is a URL,  rancid-cvs  will  not  initialize  the
22       repository, the user must do this themselves.
23
24       rancid-cvs reads rancid.conf(5) to configure itself, then proceeds with
25       the initialization.  First of the CVS, Subversion or git repository, if
26       necessary,  and  then  for  each  of  the  rancid  groups listed on the
27       command-line   or   those   in   the   variable   LIST_OF_GROUPS   from
28       rancid.conf(5), if the argument is omitted.
29
30       Running  rancid-cvs  for  groups  which  already  exist  will not cause
31       problems.  If the group's directory already exists, the import into the
32       revision  control  system  will  be  skipped,  and if it's router.db(5)
33       already exists, it will not be altered.
34
35       The command-line options are as follows:
36
37       -V     Prints package name and version strings.
38
39       -f group_config_file
40              Specify an alternative rancid.conf.  The global rancid.conf file
41              is read by rancid-run.
42
43       The  best  method  for  adding  groups  is  by adding the group name to
44       LIST_OF_GROUPS in rancid.conf(5), then run rancid-cvs.  Do  not  create
45       the directories manually, allow rancid-cvs to do it.
46

SEE ALSO

48       cvs(1), git(1), rancid.conf(5), router.db(5), svn(1)
49

CAVEATS

51       In  the  case  of  git,  the  groups  are not exactly imported into the
52       repository, rather a new repository is created for it, due to  the  way
53       that git handles, what it calls, sparse checkouts.  Instead, each group
54       is a separate repository under the CVSROOT directory.
55
56
57
58                               17 December 2014                  rancid-cvs(1)
Impressum