NODESTAT(8)                     Domain/OS BSD                      NODESTAT(8)




NAME
     nodestat - display network statistics

SYNOPSIS
     /etc/nodestat [options]

DESCRIPTION
     writes a summary of network and hard disk activity to standard output.

OPTIONS
     If no options are specified, nodestat returns a brief summary of network
     usage information for the current node.

     -l             Long report-provides more information than the summary.

     -config        Configuration report-displays only node-specific hardware
                    information: CPU type, display type, etc.

     -n node_spec ...
                    Provide information on specified node(s).  Multiple
                    node_spec strings are permitted; separate them with
                    blanks.

     -a             Report on all nodes in the network.

     -r [n]         Repeat the nodestat command every n seconds until halted
                    by CTRL/Q.  Only counts that have changed at each
                    iteration are displayed, and the values represent the
                    amount of change rather than absolute values.  The default
                    value for n is 10 seconds.

     -s [n]         Send n test messages to every node being listed (except
                    the current node) before every repeat of the display.  If
                    this option is specified, -r must also be specified.  This
                    option provides a minimum amount of network activity
                    during the wait time between nodestat repeats.  The
                    default value for n is 100 messages.

     -save pathname Save all statistics in the file named pathname.

     -since pathname
                    Display counts that have changed since statistics were
                    saved in pathname.

EXAMPLES
     $ /etc/nodestat

     The node ID of this node is 1FB.

     **** Node 1FB ****   //diskless_$0001Fb diskless to //anger

     Up since 1988/02/01 at 8:17:06 Up for 1 day 2 hours 58 mins 4 secs
     Net I/O:   total=  94625   rcvs =  66912   xmits =  27713
     Winchester I/O:  total=   0   reads=   0   writes=   0    {NOTE 1}
     System configured with 1.0 mb of memory.

     $ /etc/nodestat -l

     The node ID of this node is 1FB.

     **** Node 1FB ****   //diskless_$0001Fb diskless to //anger

     Up since 1988/02/01 at 8:17:06 Up for 1 day 2 hours 58 mins 52 secs
     Net I/O:   total=  94756   rcvs =  67010   xmits =  27746

       10436 page-in  requests issued.
       6473 page-out requests issued.
       41134 page-in  requests serviced.
       12139 page-out requests serviced.
     Detected concurrency violations -- read: 0    write: 0

      Xmit count     27746         Rcv eor            0
      NACKs            272         Rcv crc          767
      WACKs           1639         Rcv timout         0
      Token inserted    65         Rcv buserr         0
      Xmit overrun       0         Rcv overrun        0

      Xmit Ack par       3         Rcv xmit-err    3042
      Xmit Bus error     0         Rcv Modem err      0
      Xmit timout       90         Rcv Pkt error     45
      Xmit Modem err     0         Rcv hdr chksum     0
      Xmit Pkt error   377         Rcv Ack par       10

         Delay switched OUT.

     Winchester I/O:  total=   0   reads=  0  writes=  0  {NOTE 1}

      Not ready          0         Contrlr busy       0
      Seek error         0         Equip check        0
      Drive time out     0         Overrun            0
      CRC error percentage: 0.00%

      Last ring hardware failure detected by node 241     {NOTE 2}
       on 1988/02/02 at 10:05
     System configured with 1.0 mb of memory.
     A total of 0 ECCC errors were detected.


Notes on Examples
     1.   Node 1FB is running diskless, hence the absence of Winchester disk
          I/O activity.

     2.   At 10:05 A.M. on Feb. 2, 1988, the network cable was disturbed
          immediately upstream of node 241.  This information, coupled with
          the network topology available from lcnode can help you pinpoint a
          hardware malfunction.

SEE ALSO
     rtstat(8)