.\"
.hys 50
.TH "rancid" "1" "6 Jan 2004"
.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,
Bay Networks (nortel),
Cisco catalyst switches,
Cisco content services switches,
ADC-kentrox EZ-T3 mux,
Force10,
Foundry,
HP Procurve Switches,
Hitachi Routers,
Juniper Networks E-series,
Juniper Networks,
MRTd,
Procket Networks,
Riverstone,
Redback,
Lucent TNT,
Netscreen firewalls,
Netscaler,
Extreme,
and Zebra routing software
named 
.B arancid,
.B brancid,
.B cat5rancid,
.B cssrancid,
.B erancid,
.B f10rancid,
.B fnrancid,
.B francid,
.B hrancid,
.B htrancid,
.B jerancid,
.B jrancid,
.B mrancid,
.B nrancid,
.B nsrancid,
.B prancid,
.B rivrancid,
.B rrancid,
.B tntrancid,
.B nrancid,
.B xrancid,
and
.B zrancid,
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 rancid.conf (5)
.\"
.SH "CAVEATS"
For Catalyst switches running CatOS, type
.B cat5,
the prompt must end with '>'.
.BR clogin (1)
looks for '>' to determine when a login is successful.  For example:
.sp
.in +1i
.nf
cat5k>
cat5k> enable
Password: 
cat5k> (enable) 
.fi
.in -1i