rwhod(1M)                       TCP/IP R4.11                       rwhod(1M)


NAME
       rwhod - local area network status agent

SYNOPSIS
       /usr/bin/rwhod

DESCRIPTION
       At the discretion of the host or LAN coordinators, hosts in a LAN may
       each run the rwhod agent, which exchanges network status information
       at 3-minute intervals with other network hosts. The users of hosts in
       the network can then retrieve network status information with
       rwho(1C) and ruptime(1C).

       The rwhod agent collects information about the local host, broadcasts
       the information to rwhod agents running on other network hosts,
       receives information from them, and records the information in files
       located in the directory /var/spool/rwho.

       The rwhod agent transmits and receives messages at the port indicated
       in the rwho service specification in /etc/services.  The messages
       sent and received are of the form:

           struct    outmp {
                char outline[8];/* tty name */
                char outname[8];/* user id */
                long outtime;/* time on */
           };

           struct    whod {
                char wdvers;
                char wdtype;
                char wdpad[2];
                int  wdsendtime;
                int  wdrecvtime;
                char wdhostname[32];
                int  wdloadav[3];
                int  wdboottime;
                struct    whoent {
                     struct outmp weutmp;
                     int  weidle;
                } wdwe[58];
           };


All fields are converted to network byte order prior to transmission.  The
load averages represent system loads over 1-, 5-, and 15-minute intervals
prior to a server's transmission.  The hostname included is that returned by
the gethostname(2) system call.

The array at the end of the message contains information about the users
logged in to the sending machine, up to a maximum of 58 users.  This
information includes the contents of the utmp(4) entry for each terminal
line in use, and a value indicating the time since a character was last
received on the terminal line.

rwhod discards any messages it receives that did not originate at the port
designated in /etc/services, and also any message that includes a host whose
name contains unprintable ASCII characters. rwhod records valid messages in
files named whod.hostname located in the directory /var/spool/rwho.  These
files contain only the most recent message, in the format described above.

On DG/UX and 4.3 BSD-compatible hosts, messages are collected and broadcast
approximately once every three minutes. On 4.2 BSD-compatible hosts,
messages are broadcast once a minute.  A system is considered down if no
messages are received from it for 11 minutes.

FILES
       /var/spool/rwho/whod.*   Contain the LAN host information collected
                                by rwhod and displayed by rwho and ruptime.

SEE ALSO
       ruptime(1C), rwho(1C), appropriateprivilege(5).
       capdefaults(5).

NOTE
       You must have appropriate privilege to execute this command.  For
       systems supporting the DG/UX Capability Option, appropriate privilege
       is defined as having one or more specific capabilities enabled in the
       effective capability set of the user.  See capdefaults(5) for the
       default capabilities for this command.

       On systems without the DG/UX Capability Option, appropriate privilege
       means that your process has an effective UID of root. See the
       appropriateprivilege(5) man page for more information.



Licensed material--property of copyright holder(s)