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().
	      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

       /usr/local/etc/lg.conf
	      Configuration file described here.

				  7 Jan	2004			    lg.conf(5)

Man(1) output converted with man2html