


      RWHOD(1)                    (bsd 4.2)                    RWHOD(1)



      NAME
           rwhod - system status server

      SYNTAX
           /etc/rwhod

      DESCRIPTION
           Rwhod is the server which maintains the database used by the
           rwho(1) and ruptime(1) programs.  Its operation is
           predicated on the ability to broadcast messages on a
           network.

           Rwhod operates as both a producer and consumer of status
           information.  As a producer of information, it periodically
           queries the state of the system and constructs status
           messages which are broadcast on a network.  As a consumer of
           information, it listens for other rwhod servers' status
           messages, validating them, then recording them in a
           collection of files located in the directory
           /usr/spool/rwho.

           The rwho server transmits and receives messages at the port
           indicated in the ``rwho'' service specification, see
           services(4).  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_fill[2];
                int  wd_sendtime;
                int  wd_recvtime;
                char wd_hostname[32];
                int  wd_loadav[3];
                int  wd_boottime;
                struct    whoent {
                     structoutmp we_utmp;
                     int  we_idle;
                } wd_we[1024 / sizeof (struct whoent)];
           };

           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 utmp(4) entry for
           each non-idle terminal line and a value indicating the time
           since a character was last received on the terminal line.



      Page 1                                          (73 A2 02MT REV1)






      RWHOD(1)                    (bsd 4.2)                    RWHOD(1)



           Messages received by the rwho server are discarded unless
           they originated at a rwho server's port.  In addition, if
           the host's name in the message contains any unprintable
           ASCII characters, the message is discarded.  Valid messages
           received by rwhod are placed in files named whod.hostname in
           the directory /usr/spool/rwho.  These files contain only the
           most recent message, in the format described above.

           Status messages are generated approximately once every 60
           seconds.

      SEE ALSO
           rwho(1), ruptime(1)










































      Page 2                                          (73 A2 02MT REV1)






      RWHOD(1)                    (bsd 4.2)                    RWHOD(1)



      BUGS
           Should relay status information between networks. People
           often interpret the server dying as a machine going down.




















































      Page 3                                          (73 A2 02MT REV1)



