.\"
.hys 50
.TH "rancid" "1" "13 Jan 2001"
.SH NAME
rancid \- Cisco configuration filter
.SH SYNOPSIS
.B rancid
[\fB\-dl\fP]
([\c
.BI \-f\ \c
filename]\ \c
| hostname)
.SH DESCRIPTION
.B rancid
is a
.BR perl (1)
script which uses
.BR clogin (1)
to login to a Cisco router, execute commands to display
the configuration, etc, then filters the output for formatting, security,
and so on.
.B rancid's
product is a file with the name of it's last argument plus the suffix .new.
For example, hostname.new.
.PP
There are complementary scripts for Alteon WebOS switches, Cisco catalyst
switch, Bay Networks (nortel), Juniper, Foundry, Extreme, and ADC-kentrox EZ-T3
mux named 
.B arancid,
.B brancid,
.B cat5rancid,
.B jrancid,
.B francid,
.B xrancid,
and
.B erancid,
respectively.
.PP
The command-line options are as follows:
.TP
.B \-d
Display debugging information.
.\"
.TP
.B \-l
Display somewhat less debugging information.
.\"
.TP
.B \-f
.B rancid
should interpret the next argument as a filename which contains the
output it would normally collect from the device (
.I hostname\c
) with
.IR clogin (1).
.SH "SEE ALSO"
.BR control_rancid (1),
.BR clogin (1),
.BR env (5)