SIMPLE SOLUTIONS

CONTROL_RANCID(1) - Linux man page online | User commands

Run rancid for devices of a group.

Chapter
22 December 2016
control_rancid(1) General Commands Manual control_rancid(1)

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 mech‐ anism 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)
22 December 2016 control_rancid(1)
This manual Reference Other manuals
control_rancid(1) referred by rancid(1) | rancid-run(1) | rancid.conf(5) | rancid.types.conf(5) | rancid_intro(1) | router.db(5)
refer to dash(1) | rancid-run(1) | rancid.conf(5) | router.db(5)
Download raw manual
Main page General Commands Manual (+12866) № 1 (+39907)
Go top