NAME

       lg.conf - looking glass configuration file

DESCRIPTION

       lg.conf contains configuration for the looking glass scripts.

       The  syntax is that of perl(1).  It is used to set variables that affect run-time behavior
       and/or to locate resources.

VARIABLES

       The following variables are used (alphabetically):

       LG_AS_REG
              *** not implemented.

       LG_BGP_RT
              Allows show ip bgp neighbor commands that can produce heavy output, such as  sh  ip
              bgp  neighbor  <ip>  advertised-routes  for  a  transit  customer when the neighbor
              address is followed by 'advertised-routes' for the sh ip bgp neighbor query.

       LG_CACHE_DIR
              Sets the location of the cache directory.  The looking glass uses this to hold lock
              files, log files, and output from cached commands.

              Default: ./tmp

              Note  that  the  default  is  relative  to  the  directory where lg.cgi runs in the
              server's document root (e.g.: /usr/local/www/data/lg/tmp).

       LG_CACHE_TIME
              Sets the number of seconds that the looking glass should cache output from commands
              that tend to produce a lot of output, such as 'show ip bgp dampened-paths'.

              Default: 600

       LG_CLOGINRC
              Defines  the  location  of  the cloginrc(5) that the looking glass should use.  The
              path may be relative to the directory where the CGI scripts  run  in  the  server's
              document root.

              Default: $HOME/.cloginrc

              Note  that the .cloginrc must be readable by the user or group that will be running
              the CGI and that clogin(1) will not allow a world readable .cloginrc.  The user  is
              normally that of the http server (httpd).

       LG_IMAGE
              Defines  a html image tag (<img>) which, if defined, will be included at the top of
              the looking glass pages.  It may contain any html as it is  simply  handed  off  to
              print().

              Example:      $LG_IMAGE="<img      src=/icons/rancid.gif      hspace=0>\n     <font
              size=+2>FOO</font>";

       LG_INFO
              Defines information in html format which, if  defined,  will  be  included  at  the
              bottom  of  the  looking  glass form page.  It may contain any html as it is simply
              handed off to print().

              Example:           $LG_INFO="For           Support            contact            <a
              href=mailto:webmaster@localhost>webmaster</a>";

       LG_LOG Defines  the  fully qualified path name (i.e.: begins with '/') for the log file or
              the syslog(3) facility to use  for  logging.   For  syslog,  the  argument  is  the
              lowercase name of a syslog facility (see syslog.h) without the 'LOG_' prefix.

              Example: local0

              Default: $LG_CACHE_DIR/lg.log

       LG_ROUTERDB
              Sets the location for the router.db file in rancid's router.db(5) format.  It lists
              the devices that should be available  to  the  looking  glass  users.   Only  those
              devices  of supported types and with state 'up' are made available.  If not defined
              and the default file does not exist, the looking glass will compile a list from the
              router.db  files  of  all the groups present in rancid, that is, the list will be a
              concatenation of the available router.db(5) files.

              Note that if the concatenation method is used, it may be  necessary  to  alter  the
              mode of the router.db files in the rancid group directories, since rancid's default
              umask is 027 (see rancid.conf(5)).

       LG_STRIP
              Causes the LG to strip login information from the  looking  glass  results.   Since
              Expect  often  munges disabling echo when passwords are entered, this is a SECURITY
              CONCERN!  However, this output can be very useful for debugging clogin problems.

       LG_STYLE
              Defines the URL of a style sheet to be used for HTML formatting.

       PATH   Is a colon separated list of directory pathnames in the file system where  rancid's
              login  scripts,  clogin(1)  etc.)   and  programs  needed  within  these,  such  as
              telnet(1), are located.  Its value is set by configure.  Should it be necessary  to
              modify PATH, note that it must include $BASEDIR/bin (see above).

       Queries        ...................................

ENVIRONMENT

       LG_CONF
              Location of lg.conf file.  See the FILES section for more information.

ERRORS

       lg.conf  is  interpreted  directly by perl(1), so its syntax follows that of perl.  Syntax
       errors may produce quite unexpected results.

FILES

       /etc/rancid/lg.conf
              Configuration file described here.

              lg.conf is located by the value of the environment variable  LG_CONF,  in  the  CWD
              (current  working  directory), or the sysconfdir defined when rancid was installed,
              in that order.

SEE ALSO

       cloginrc(5), lg_intro(1), router.db(5)

HISTORY

       In RANCID releases prior to 2.3, lg.conf was located in the util/lg sub-directory  of  the
       install path.  This was changed to be more consistent with common file location practices.

                                            7 Jan 2004                                 lg.conf(5)