source: trunk/athena/etc/larvnetd/larvnet.conf.5 @ 12057

Revision 12057, 4.4 KB checked in by ghudson, 26 years ago (diff)
Support specification of explicit printer locations.
Line 
1.\" $Id: larvnet.conf.5,v 1.3 1998-10-21 20:02:05 ghudson Exp $
2.\"
3.\" Copyright 1998 by the Massachusetts Institute of Technology.
4.\"
5.\" Permission to use, copy, modify, and distribute this
6.\" software and its documentation for any purpose and without
7.\" fee is hereby granted, provided that the above copyright
8.\" notice appear in all copies and that both that copyright
9.\" notice and this permission notice appear in supporting
10.\" documentation, and that the name of M.I.T. not be used in
11.\" advertising or publicity pertaining to distribution of the
12.\" software without specific, written prior permission.
13.\" M.I.T. makes no representations about the suitability of
14.\" this software for any purpose.  It is provided "as is"
15.\" without express or implied warranty.
16.\"
17.TH LARVNET.CONF 5 "23 Aug 1998"
18.SH NAME
19/etc/athena/larvnet.conf \- larvnetd configuration file
20.SH DESCRIPTION
21The file
22.B /etc/athena/larvnet.conf
23configures what cluster machines and printers are to be monitored by
24the
25.BR larvnetd (8)
26daemon.
27.PP
28The file is divided into two sections, separated by a line beginning
29with '-'.  The first section gives the architecture names, one per
30line; empty lines or lines beginning with '#' are ignored.  Each line
31consists of a name to be used as a column heading and, optionally, one
32or more corresponding architecture names which may be reported by
33workstations for that column heading.  If only a column heading is
34given, the column heading is also used as the sole architecture name.
35The order of the architecture names gives the order of the output
36columns in the cluster report file (see
37.BR larvnet.clusters (5)),
38and thus the order of columns in the output of
39.BR cviewd (8).
40.PP
41The second section gives the actual cluster machines as well as
42printers.  Leading and trailing whitespace are ignored, as well as any
43text after the first '#' character; empty lines or lines containing
44only whitespace and comments are ignored entirely.  Lines in this
45section may have one of the following formats:
46.TP 8
47\fBcluster\fP \fIname\fP \fIphone\fP
48Introduces a new cluster.  The first field should not exceed seven
49letters in the current cview output format.  The second argument
50should give the cluster phone number or "(none)".
51.TP 8
52\fBws\fP \fIname\fP
53Lists a machine name within a cluster.  This line must appear after a
54.B cluster
55line.  The workstation name may include a numeric range in square
56brackets.  For example, "w20-575-[1-50]" would expand to fifty
57workstations.
58.TP 8
59\fBprinter\fP \fIname\fP [\fIlocation\fP]
60Lists a printer within a cluster.  This line must appear after a
61.B cluster
62line.  The
63.I location
64of the printer defaults to the name of the cluster.
65.TP 8
66\fBcgroup\fP \fIname\fP \fIx\fP \fIy\fP \fIcluster\fP ...
67Specifies a group of public clusters.  The
68.I x
69and
70.I y
71numbers give the position of the cluster group on the cluster map
72(see
73.BR xcluster (1)).
74The
75.I cluster
76parameters must be clusters which have already been specified in the
77configuration file and which have not already been assigned to a
78cluster group.
79.TP 8
80\fBoption report-other\fP \fIcolname\fP In the report file, generate
81statistics for workstations reporting an architecture which does not
82match any line in the first section of the file.  Use the parameter
83.I colname
84as the architecture name.
85.TP 8
86\fBoption report-unknown\fP \fIcolname\fP
87In the report file, generate statistics for workstations which have
88not yet sent a status packet to the server and are thus of unknown
89architecture.  Use the parameter
90.I colname
91as the architecture name.
92.SH EXAMPLE
93The following example tells larvnetd to monitor 126 machines and five
94printers in two clusters, one of which is in a cluster group named
95"W20" and located at X coordinate 30828 and Y coordinate 18254.
96.PP
97.RS
98.nf
99SPARC/4
100SPARC/5
101Ultra-5_10 SUN/ULTRA
102IP32 SGI/O2
103IP22 SGI/INDY
104---
105option report-other OTHER
106cluster SIPB 3-7788
107        ws x15-cruise-basselope.mit.edu
108        ws steve-dallas.mit.edu
109        ws opus.mit.edu
110        ws reaper-man.mit.edu
111        # Don't list printer meadow since there is no support for
112        # private printers currently.
113cluster W20-575 3-0103
114        ws w20-575-[1-120].mit.edu
115        ws test-sgi.mit.edu
116        ws test-sparc4.mit.edu
117        printer ajax
118        printer ceres
119        printer python
120        printer fiber
121        printer pulp
122cgroup W20 30828 18254 W20-575
123.fi
124.RE
125.SH SEE ALSO
126.BR larvnetd (8)
127.SH AUTHOR
128Greg Hudson, MIT Information Systems
129.br
130Copyright 1998 by the Massachusetts Institute of Technology.
Note: See TracBrowser for help on using the repository browser.