Man Linux: Main Page and Category List

NAME

       control_rancid - run rancid for devices of a group

SYNOPSIS

       control_rancid [-V] [-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.

       The command-line options are as follows:

       -V     Prints package name and version strings.

       -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)

                                5 October 2006               control_rancid(1)