summaryrefslogtreecommitdiffstats
path: root/man/rancid.1
blob: 4d4ba51ad2aaf13362ba87e3f25e75cb8b8de8d4 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
.\"
.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,
Bay Networks (nortel),
Cisco catalyst switch,
ADC-kentrox EZ-T3 mux,
Foundry,
HP Procurve Switches,
Juniper,
MRTd,
Redback,
and Extreme,
named 
.B arancid,
.B brancid,
.B cat5rancid,
.B erancid,
.B francid,
.B hrancid,
.B jrancid,
.B mrancid,
.B rrancid,
and
.B xrancid,
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)