control_rancid(1)					      General Commands Manual						 control_rancid(1)

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)