1rancid(1)                   General Commands Manual                  rancid(1)
2
3
4

NAME

6       rancid - Cisco configuration filter
7

SYNOPSIS

9       rancid [-dlV] (-f filename | hostname)
10

DESCRIPTION

12       rancid is a perl(1) script which uses the login scripts (see clogin(1))
13       to login to a device, execute commands to  display  the  configuration,
14       etc,  then  filters  the  output  for  formatting, security, and so on.
15       rancid's product is a file with the name of it's last argument plus the
16       suffix .new.  For example, hostname.new.
17
18       There   are   complementary   scripts   for   other   platforms  and/or
19       manufacturers that are supported by rancid(1).  Briefly, these are:
20
21
22       agmrancid      Cisco Anomaly Guard Module (AGM)
23
24       arancid        Alteon WebOS switches
25
26       arrancid       Arista Networks devices
27
28       brancid        Bay Networks (nortel)
29
30       cat5rancid     Cisco catalyst switches
31
32       cssrancid      Cisco content services switches
33
34       erancid        ADC-kentrox EZ-T3 mux
35
36       f10rancid      Force10
37
38       f5rancid       F5 BigIPs
39
40       fnrancid       Fortinet Firewalls
41
42       francid        Foundry and HP procurve OEMs of Foundry
43
44       hrancid        HP Procurve Switches
45
46       htranicd       Hitachi Routers
47
48       jerancid       Juniper Networks E-series
49
50       jrancid        Juniper Networks
51
52       mrancid        MRTd
53
54       mrvrancid      MRV optical switches
55
56       nrancid        Netscreen firewalls
57
58       nsrancid       Netscaler
59
60       nxrancid       Cisco Nexus boxes
61
62       prancid        Procket Networks
63
64       rivrancid      Riverstone
65
66       rrancid        Redback
67
68       srancid        SMC switch (some Dell OEMs)
69
70       trancid        Netopia sDSL/T1 routers
71
72       tntrancid      Lucent TNT
73
74       xrancid        Extreme switches
75
76       xrrancid       Cisco IOS-XR boxes
77
78       zrancid        Zebra routing software
79
80       The command-line options are as follows:
81
82       -V     Prints package name and version strings.
83
84       -d     Display debugging information.
85
86       -l     Display somewhat less debugging information.
87
88       -f     rancid should interpret the next argument as  a  filename  which
89              contains  the output it would normally collect from the device (
90              hostname) with clogin(1).
91

SEE ALSO

93       control_rancid(1), clogin(1), rancid.conf(5)
94

CAVEATS

96       Cisco IOS offers a DHCP server that maintains a text database which can
97       be  stored  remotely  or on local storage.  If stored locally, the file
98       changes constantly and causes constant  diffs  from  rancid.   If  this
99       file's    name    ('ip    dhcp    database')    matches    the    regex
100       dhcp_[^[:space:].].txt, it will be  filtered.   For  Catalyst  switches
101       running  CatOS,  type  cat5,  the  prompt must end with '>'.  clogin(1)
102       looks for '>' to determine when a login is successful.  For example:
103
104                 cat5k>
105                 cat5k> enable
106                 Password:
107                 cat5k> (enable)
108
109       rancid works on Cisco Catalyst 1900 series switches  that  are  running
110       Enterprise   Edition  software.   This  software  provides  a  menu  at
111       connection time that allows a command line  interface  to  be  used  by
112       entering 'K' at the prompt.
113
114
115
116                                 8 April 2010                        rancid(1)
Impressum