Man Linux: Main Page and Category List

NAME

       rancid - Cisco configuration filter

SYNOPSIS

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

DESCRIPTION

       rancid is a perl(1) script which uses the login scripts (see clogin(1))
       to login to a device, execute commands to  display  the  configuration,
       etc,  then  filters  the  output  for  formatting, security, and so on.
       rancids product is a file with the name of it’s last argument plus the
       suffix .new.  For example, hostname.new.

       There   are   complementary   scripts   for   other   platforms  and/or
       manufacturers that are supported by rancid(1).  Briefly, these are:

       agmrancid      Cisco Anomaly Guard Module (AGM)

       arancid        Alteon WebOS switches

       arrancid       Arista Networks devices

       brancid        Bay Networks (nortel)

       cat5rancid     Cisco catalyst switches

       cssrancid      Cisco content services switches

       erancid        ADC-kentrox EZ-T3 mux

       f10rancid      Force10

       f5rancid       F5 BigIPs

       fnrancid       Fortinet Firewalls

       francid        Foundry and HP procurve OEMs of Foundry

       hrancid        HP Procurve Switches

       htranicd       Hitachi Routers

       jerancid       Juniper Networks E-series

       jrancid        Juniper Networks

       mrancid        MRTd

       mrvrancid      MRV optical switches

       nrancid        Netscreen firewalls

       nsrancid       Netscaler

       nxrancid       Cisco Nexus boxes

       prancid        Procket Networks

       rivrancid      Riverstone

       rrancid        Redback

       srancid        SMC switch (some Dell OEMs)

       trancid        Netopia sDSL/T1 routers

       tntrancid      Lucent TNT

       xrancid        Extreme switches

       xrrancid       Cisco IOS-XR devices

       zrancid        Zebra routing software

       The command-line options are as follows:

       -V     Prints package name and version strings.

       -d     Display debugging information.

       -l     Display somewhat less debugging information.

       -f     rancid should interpret the next argument as  a  filename  which
              contains  the output it would normally collect from the device (
              hostname) with clogin(1).

SEE ALSO

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

CAVEATS

       Cisco IOS offers a DHCP server that maintains a text database which can
       be  stored  remotely  or on local storage.  If stored locally, the file
       changes constantly and causes constant  diffs  from  rancid.   If  this
       file’s    name    (’ip    dhcp    database’)    matches    the    regex
       dhcp_[^[:space:].].txt, it will be filtered.

       For Catalyst switches running CatOS, type cat5,  the  prompt  must  end
       with  ’>’.   clogin(1)  looks  for  ’>’  to  determine  when a login is
       successful.  For example:

                 cat5k>
                 cat5k> enable
                 Password:
                 cat5k> (enable)

       rancid works on Cisco Catalyst 1900 series switches  that  are  running
       Enterprise   Edition  software.   This  software  provides  a  menu  at
       connection time that allows a command line  interface  to  be  used  by
       entering ’K’ at the prompt.

                                 5 March 2010                        rancid(1)