Provided by: rancid_3.11-1_amd64 bug

NAME

       rancid - rancid Perl and Python modules

INTRODUCTION

       The  rancid  library  provides  functions  for  handling rancid.types configuration files,
       loading modules, and the basic  global  variables,  variables  from  parsing  rancid.types
       files,  and output handling functions that are common to all rancid device modules, all of
       which are exported (in Perl terms) for use by those that import the module.  Specifically,
       the  library  is  used  by  rancid(1),  but it could be used by any Perl program for site-
       specific handling or additional automata.

       RunCommand(*INPUT, *OUTPUT, command)
              Parse a single command that returns no required info; the output is dropped.   This
              could  be used as the processing function in a command definition in a rancid.types
              file.

       Output handling functions:

       ProcessHistory([tag], [sort_function], [sort_function_argument], string)
              If the optional tag string and sort_function arguments are omitted, the  string  is
              output  immediately.  Otherwise, the strings are accumulated in a hash, by the hash
              key sort_function_argument, each time ProcessHistory() is called until the  tag  or
              sort_function  changes,  at  which  time the queue is flushed and the new string is
              handled.  If sort_function had been supplied, it is called with  the  hash  as  its
              argument.

              Note  that  if  the  hash  key  sort_function_argument  exists,  the new strings is
              appended to the existing hash value.

       keysort(%hash)
              A sort routine that will sort on the keys of a hash as if it were a  normal  array.
              For example:

              ProcessHistory("TAG","keysort","B0","!\n");
              ProcessHistory("TAG","keysort","D0","!\n");

              B0 and D0 are the sort keys.

       valsort(%hash)
              A sort routine that will sort on the values of a hash as if it were a normal array.

              ProcessHistory("TAG","valsort","","!B0\n");
              ProcessHistory("TAG","valsort","","!D0\n");

       numsort(%hash)
              A numerical sort routine (ascending).

       ipsort(IPv4 dotted-quad/v6 address)
              A  sort routine that will sort on the ip address when the IP address is anywhere in
              the strings.

              ProcessHistory("TAG","ipsort","192.168.0.0","!B0\n");
              ProcessHistory("TAG","ipsort","192.168.1.0","!D0\n");

       sortbyipaddr(XXX)
              A sort routine that will sort based upon IPv4/v6 addresses.

       Please see the library code for exported variables.

       Please see the pydoc(1) for documentation on the rancid Python module.  It  is  equivalent
       to the Perl module, but in a Pythonic manner.

SEE ALSO

       rancid(1), rancid.types.conf(5)

                                          15 April 2019                                 rancid(3)