| 1 | .\" $Id: larvnetd.8,v 1.1 1998-09-01 20:57:44 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 | .TH LARVNETD 8 "23 Aug 1998" |
|---|
| 17 | .SH NAME |
|---|
| 18 | larvnetd \- Monitor cluster workstations and printers |
|---|
| 19 | .SH SYNOPSIS |
|---|
| 20 | .B larvnetd [-n] [-f \fIconfigfile\fR] |
|---|
| 21 | .SH DESCRIPTION |
|---|
| 22 | .B larvnetd |
|---|
| 23 | monitors a set of cluster machines and printers given by the file |
|---|
| 24 | .B /etc/athena/larvnet.conf |
|---|
| 25 | (see |
|---|
| 26 | .BR larvnet.conf (5)) |
|---|
| 27 | or a file specified on the command line with the \-f option. |
|---|
| 28 | Normally, it backgrounds itself and dissociates itself from the |
|---|
| 29 | controlling tty after binding to the larvnet port, but this behavior |
|---|
| 30 | can be suppressed with the \-n command-line option. |
|---|
| 31 | .PP |
|---|
| 32 | .B larvnetd |
|---|
| 33 | processes status notifications received from cluster workstations on |
|---|
| 34 | the larvnet port. It will periodically poll those workstations it has |
|---|
| 35 | not heard from recently, using the busypoll service (see |
|---|
| 36 | .BR busyd (8)). |
|---|
| 37 | Once a minute, |
|---|
| 38 | .B larvnetd |
|---|
| 39 | requests a queue status for each of the printers it is configured to |
|---|
| 40 | monitor. Also once a minute, |
|---|
| 41 | .B larvnetd |
|---|
| 42 | generates three report files: |
|---|
| 43 | .RS |
|---|
| 44 | .B /var/athena/larvnet.cgroups |
|---|
| 45 | .br |
|---|
| 46 | .B /var/athena/larvnet.clusters |
|---|
| 47 | .br |
|---|
| 48 | .B /var/athena/larvnet.printers |
|---|
| 49 | .RE |
|---|
| 50 | which give the current known status of cluster workstations and |
|---|
| 51 | printers. |
|---|
| 52 | .PP |
|---|
| 53 | .B larvnetd |
|---|
| 54 | will reread its configuration file upon receiving a SIGHUP. |
|---|
| 55 | .PP |
|---|
| 56 | .B larvnetd |
|---|
| 57 | syslogs errors and debugging messages using the local5 facility name. |
|---|
| 58 | .SH NOTES |
|---|
| 59 | Larvnet is monitoring you. |
|---|
| 60 | .SH FILES |
|---|
| 61 | .B /etc/athena/larvnet.conf |
|---|
| 62 | .br |
|---|
| 63 | .B /var/athena/larvnet.cgroups |
|---|
| 64 | .br |
|---|
| 65 | .B /var/athena/larvnet.clusters |
|---|
| 66 | .br |
|---|
| 67 | .B /var/athena/larvnet.printers |
|---|
| 68 | .SH "SEE ALSO" |
|---|
| 69 | .BR larvnet.conf (5), |
|---|
| 70 | .BR larvnet.cgroups (5), |
|---|
| 71 | .BR larvnet.clusters (5), |
|---|
| 72 | .BR larvnet.printers (5), |
|---|
| 73 | .BR busyd (8) |
|---|
| 74 | .SH AUTHOR |
|---|
| 75 | Greg Hudson, MIT Information Systems |
|---|
| 76 | .br |
|---|
| 77 | Copyright 1998 by the Massachusetts Institute of Technology. |
|---|
