rwhod(1M)                       TCP/IP 5.4.2                       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 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_pad[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[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.




Licensed material--property of copyright holder(s)                         1

rwhod(1M)                       TCP/IP 5.4.2                       rwhod(1M)


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).








































Licensed material--property of copyright holder(s)                         2