1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
|
.\"
.hys 50
.TH "lg.conf" "5" "22 Jan 2001"
.SH NAME
lg.conf \- looking glass configuration file
.SH DESCRIPTION
.B lg.conf
contains configuration for the looking glass scripts.
.PP
The syntax is that of
.IR perl (1).
It is used to set variables to affect run-time behavior or to locate resources.
.\"
.SH VARIABLES
The following variables are used (alphabetically):
.Bl -tag -width flag
.\"
.TP
.B LG_AS_REG
*** not implemented.
.\"
.TP
.B 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.
.\"
.TP
.B 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.
.sp
Default: ./tmp
.sp
Note that the default is relative to the directory where
.IR lg.cgi
runs in the server's document root (eg: /usr/local/www/data/lg/tmp).
.\"
.TP
.B 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'.
.sp
Default: 600
.\"
.TP
.B LG_CLOGINRC
Defines the location of the
.BR 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.
.sp
Default: @prefix@/.cloginrc
.sp
Note that the .cloginrc must be readable by the user or group that will be
running the CGI and that
.BR clogin (1)
will not allow a world readable
.IR .cloginrc .
The user is normally that of the http server (httpd).
.\"
.TP
.B 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().
.sp
Example: $LG_IMAGE="<img src=/icons/rancid.gif hspace=0>\n <font size=+2>FOO</font>";
.\"
.TP
.B LG_LOG
Defines the fully qualified path name for the log file or the
.BR 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.
.sp
Example: local0
.sp
Default: $LG_CACHE_DIR/lg.log
.\"
.TP
.B LG_ROUTERDB
Sets the location for the
.IR router.db
file in rancid's
.BR 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 status '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 a concatenation of $BASEDIR/*/router.db.
.sp
Default: @prefix@/util/lg/router.db
.sp
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 the
default umask is 027 (see
.BR env (5)).
.\"
.TP
.B 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.
.\"
.TP
.B PATH
Is a colon separated list of directory pathnames in the the file system
where rancid's login scripts,
.IR clogin (1)
etc. )
and programs needed within these, such as
.IR 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).
.\"
.El
.\"
.SH ERRORS
.B lg.conf
is interpreted directly by
.IR perl (1),
so its syntax follows that of perl. Errors may produce quite unexpected
results.
.SH FILES
.Bl -tag -width .BASEDIR/bin/ENV -compact
.TP
.B $BASEDIR/util/lg/lg.conf
Configuration file described here, where $BASEDIR is set at the time that
the rancid package was configured. In this case, $BASEDIR is
.IR @prefix@ .
.El
.SH SEE ALSO
.BR cloginrc (5),
.BR lg_intro (1)
|
