Man page - control_rancid(1)
Packages contains this manual
- agmrancid(1)
- xirancid(1)
- trancid(1)
- a10login(1)
- rblogin(1)
- htrancid(1)
- htlogin(1)
- blogin(1)
- brlogin(1)
- avologin(1)
- xlogin(1)
- cloginrc(5)
- f5rancid(1)
- rancid-run(1)
- elogin(1)
- nlogin(1)
- csblogin(1)
- control_rancid(1)
- mrvlogin(1)
- fxlogin(1)
- hrancid(1)
- alogin(1)
- dllogin(1)
- fnlogin(1)
- erancid(1)
- cssrancid(1)
- xilogin(1)
- clogin(1)
- rancid_intro(7)
- rancid.types.conf(5)
- wlogin(1)
- anlogin(1)
- noklogin(1)
- brancid(1)
- rancid-cvs(1)
- arancid(1)
- hlogin(1)
- nrancid(1)
- tlogin(1)
- jlogin(1)
- rancid.types.base(5)
- rancidcontrib(3)
- jerancid(1)
- rrancid(1)
- mrancid(1)
- rivlogin(1)
- rancid(3)
- mtlogin(1)
- nsrancid(1)
- rancid(1)
- nslogin(1)
- panlogin(1)
- router.db(5)
- rancid_par(1)
- flogin(1)
- rancid.conf(5)
- ulogin(1)
- cat5rancid(1)
- plogin(1)
- rivrancid(1)
apt-get install rancid
Manual
control_rancid
NAMESYNOPSIS
DESCRIPTION
SEE ALSO
NAME
control_rancid - run rancid for devices of a group
SYNOPSIS
control_rancid [ -V ] [ -c commit_msg] [ -f config_file] [ -m mail_rcpt] [ -r device_name] group
DESCRIPTION
control_rancid is a sh (1) script to parse a group’s router.db (5), run rancid for each of the devices, possibly re-run rancid for devices that failed collection, e-mail diffs, and e-mail error reports.
control_rancid also creates and/or re-creates the .cvsignore/.gitignore files for each group. For the configs sub-directory, it includes ".old", where a user may keep files they would like to be ignored.
The command-line options are as follows:
|
-V |
Prints package name and version strings. |
-c commit_msg
Specify an alternative SCM commit message.
-f group_config_file
Specify an alternative rancid.conf. The global rancid.conf file is read by rancid-run, which calls control_rancid for each group, and control_rancid reads the group-specific rancid.conf, thereby overriding the global file.
The group-specific rancid.conf may not exist.
Default: <BASEDIR>/<group>/rancid.conf
-m mail_rcpt
Specify the recipient of diff mail, which is normally rancid-<group>. The argument may be a single address, multiple comma separated addresses, or -m may be specified multiple times.
-r device_name
Specify the name, as it appears in the router.db, of a particular device to collect and generate diffs for. The device must be marked "up".
The -r option alters the subject line of the diff mail. It will begin with <group name>/<device name> rather than just the group name alone.
control_rancid is normally (and best) run via rancid-run (1) which provides a locking mechanism on a group basis and saves output in a log file for each group.
SEE ALSO
rancid-run (1), rancid.conf (5), router.db (5)