1control_rancid(1) General Commands Manual control_rancid(1)
2
3
4
6 control_rancid - run rancid for devices of a group
7
9 control_rancid [-V] [-m mail_rcpt] [-r device_name] group
10
12 control_rancid is a sh(1) script to parse a group's router.db(5), run
13 rancid for each of the devices, possibly re-run rancid for devices that
14 failed collection, e-mail diffs, and e-mail error reports.
15
16 The command-line options are as follows:
17
18 -V Prints package name and version strings.
19
20 -m mail_rcpt
21 Specify the recipient of diff mail, which is normally
22 rancid-<group>. The argument may be a single address, multiple
23 comma separated addresses, or -m may be specified multiple
24 times.
25
26 -r device_name
27 Specify the name, as it appears in the router.db, of a
28 particular device to collect and generate diffs for. The device
29 must be marked "up".
30
31 The -r option alters the subject line of the diff mail. It will
32 begin with <group name>/<device name> rather than just the group
33 name alone.
34
35 control_rancid is normally (and best) run via rancid-run(1) which
36 provides a locking mechanism on a group basis and saves output in a log
37 file for each group.
38
40 rancid-run(1), rancid.conf(5), router.db(5)
41
42
43
44 5 October 2006 control_rancid(1)