summaryrefslogtreecommitdiffstats
path: root/usr.sbin/rwhod/rwhod.8
diff options
context:
space:
mode:
authorjamie <jamie@FreeBSD.org>2010-10-19 21:32:13 +0000
committerjamie <jamie@FreeBSD.org>2010-10-19 21:32:13 +0000
commit09f9c897d33c41618ada06fbbcf1a9b3812dee53 (patch)
treeaf2ff90c73b266b86d086d66705c8cc92cce3b7b /usr.sbin/rwhod/rwhod.8
parent831bbfaf753dc145ab80d1807336d4fb9ef8dffe (diff)
downloadFreeBSD-src-09f9c897d33c41618ada06fbbcf1a9b3812dee53.zip
FreeBSD-src-09f9c897d33c41618ada06fbbcf1a9b3812dee53.tar.gz
A new jail(8) with a configuration file, to replace the work currently done
by /etc/rc.d/jail.
Diffstat (limited to 'usr.sbin/rwhod/rwhod.8')
-rw-r--r--usr.sbin/rwhod/rwhod.8239
1 files changed, 0 insertions, 239 deletions
diff --git a/usr.sbin/rwhod/rwhod.8 b/usr.sbin/rwhod/rwhod.8
deleted file mode 100644
index 59fb4ad..0000000
--- a/usr.sbin/rwhod/rwhod.8
+++ /dev/null
@@ -1,239 +0,0 @@
-.\" Copyright (c) 1983, 1991, 1993
-.\" The Regents of the University of California. All rights reserved.
-.\"
-.\" Redistribution and use in source and binary forms, with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\" 1. Redistributions of source code must retain the above copyright
-.\" notice, this list of conditions and the following disclaimer.
-.\" 2. Redistributions in binary form must reproduce the above copyright
-.\" notice, this list of conditions and the following disclaimer in the
-.\" documentation and/or other materials provided with the distribution.
-.\" 4. Neither the name of the University nor the names of its contributors
-.\" may be used to endorse or promote products derived from this software
-.\" without specific prior written permission.
-.\"
-.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
-.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
-.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
-.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
-.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
-.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
-.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
-.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
-.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\" @(#)rwhod.8 8.2 (Berkeley) 12/11/93
-.\" $FreeBSD$
-.\"
-.Dd December 11, 1993
-.Dt RWHOD 8
-.Os
-.Sh NAME
-.Nm rwhod
-.Nd system status server
-.Sh SYNOPSIS
-.Nm
-.Op Fl i
-.Op Fl p
-.Op Fl l
-.Op Fl m Op Ar ttl
-.Sh DESCRIPTION
-The
-.Nm
-utility is the server which maintains the database used by the
-.Xr rwho 1
-and
-.Xr ruptime 1
-programs.
-Its operation is predicated on the ability to
-.Em broadcast
-or
-.Em multicast
-messages on a network.
-.Pp
-The
-.Nm
-utility operates as both a producer and consumer of status information,
-unless the
-.Fl l
-(listen mode) option is specified, in which case
-it acts as a consumer only.
-As a producer of information it periodically
-queries the state of the system and constructs
-status messages which are broadcasted or multicasted on a network.
-As a consumer of information, it listens for other
-.Nm
-servers' status messages, validating them, then recording
-them in a collection of files located in the directory
-.Pa /var/rwho .
-.Pp
-The following options are available:
-.Bl -tag -width indent
-.It Fl i
-Enable insecure mode, which causes
-.Nm
-to ignore the source port on incoming packets.
-.It Fl p
-Ignore all
-.Dv POINTOPOINT
-interfaces.
-This is useful if you do not wish to keep dial on demand
-interfaces permanently active.
-.It Fl l
-Enable listen mode, which causes
-.Nm
-to not broadcast any information.
-This allows you to monitor other machines'
-.Nm
-information, without broadcasting your own.
-.It Fl m Op Ar ttl
-Cause
-.Nm
-to use IP multicast (instead of
-broadcast) on all interfaces that have
-the IFF_MULTICAST flag set in their "ifnet" structs
-(excluding the loopback interface).
-The multicast
-reports are sent with a time-to-live of 1, to prevent
-forwarding beyond the directly-connected subnet(s).
-.Pp
-If the optional
-.Ar ttl
-argument is supplied with the
-.Fl m
-flag,
-.Nm
-will send IP multicast datagrams with a
-time-to-live of
-.Ar ttl ,
-via a SINGLE interface rather
-than all interfaces.
-.Ar ttl
-must be between 0 and
-32 (or MAX_MULTICAST_SCOPE).
-Note that
-.Fl m Ar 1
-is different from
-.Fl m ,
-in that
-.Fl m Ar 1
-specifies transmission on one interface only.
-.Pp
-When
-.Fl m
-is used without a
-.Ar ttl
-argument, the program accepts multicast
-.Nm
-reports from all multicast-capable interfaces.
-If a
-.Ar ttl
-argument is given, it accepts multicast reports from only one interface, the
-one on which reports are sent (which may be controlled via the host's routing
-table).
-Regardless of the
-.Fl m
-option, the program accepts broadcast or
-unicast reports from all interfaces.
-Thus, this program will hear the
-reports of old, non-multicasting
-.Nm Ns s ,
-but, if multicasting is used,
-those old
-.Nm Ns s
-will not hear the reports generated by this program.
-.El
-.Pp
-The server transmits and receives messages at the port indicated
-in the ``who'' service specification; see
-.Xr services 5 .
-The messages sent and received, are of the form:
-.Bd -literal -offset indent
-struct outmp {
- char out_line[8]; /* tty name */
- char out_name[8]; /* user id */
- long out_time; /* time on */
-};
-
-struct whod {
- char wd_vers;
- char wd_type;
- char wd_fill[2];
- int wd_sendtime;
- int wd_recvtime;
- char wd_hostname[32];
- int wd_loadav[3];
- int wd_boottime;
- struct whoent {
- struct outmp we_utmp;
- int we_idle;
- } wd_we[1024 / sizeof (struct whoent)];
-};
-.Ed
-.Pp
-All fields are converted to network byte order prior to
-transmission.
-The load averages are as calculated by the
-.Xr w 1
-program, and represent load averages over the 5, 10, and 15 minute
-intervals prior to a server's transmission; they are multiplied by 100
-for representation in an integer.
-The host name
-included is that returned by the
-.Xr gethostname 3
-system call, with any trailing domain name omitted.
-The array at the end of the message contains information about
-the users logged in to the sending machine.
-This information
-includes the contents of the entry from the user accounting database
-for each non-idle terminal line and a value indicating the
-time in seconds since a character was last received on the terminal line.
-.Pp
-Messages received by the
-.Nm rwho
-server are discarded unless they originated at an
-.Nm rwho
-server's port or the
-.Fl i
-option was specified.
-In addition, if the host's name, as specified
-in the message, contains any unprintable
-.Tn ASCII
-characters, the
-message is discarded.
-Valid messages received by
-.Nm
-are placed in files named
-.Pa whod.hostname
-in the directory
-.Pa /var/rwho .
-These files contain only the most recent message, in the
-format described above.
-.Pp
-Status messages are generated approximately once every
-3 minutes.
-The
-.Nm
-utility performs an
-.Xr nlist 3
-on
-.Pa /boot/kernel/kernel
-every 30 minutes to guard against
-the possibility that this file is not the system
-image currently operating.
-.Sh SEE ALSO
-.Xr ruptime 1 ,
-.Xr rwho 1
-.Sh HISTORY
-The
-.Nm
-utility appeared in
-.Bx 4.2 .
-.Sh BUGS
-Status information should be sent only upon request rather than continuously.
-People often interpret the server dying
-or network communication failures
-as a machine going down.
OpenPOWER on IntegriCloud