XNETLOAD(l)                X Version 11(April 1989)                 XNETLOAD(l)


NAME
      xnetload - display load averages from local network machines

SYNOPSIS
      xnetload
      [ -configuration (<column>x<row>|horizontal|vertical) ]
      [ -nolocal ]
      [ machine ] ...

DESCRIPTION
      xnetload uses the Athena Load widget and rwhod statistics to display the
      load average of a number of machines on a local network.

OPTIONS
      xnetload accepts all of the standard X Toolkit command line options along
      with the following additional options:

      -configuration <column>x<row>
              xnetload can be configured to show the machine loads
              horizontally, vertically, or in multiple columns and rows:

              -configuration horizontal - display machine loads in one row

              -configuration vertical - display machine loads in one column

              -configuration 4x3 - display machine loads in four columns, three
              columns (maximum of 12 machines).

              -configuration 2x* - display machine loads in two columns, no
              maximum number of machines, but an odd number will result in one
              blank entry.

              -configuration *x3 - display machine loads in three rows, no
              maximum number of machines, but a number not divisible by three
              will result in blank entries.


      -nolocal
              By default, the load for the local machine is displayed and the
              load calculated using the Load widget's standard LoadProc.  With
              this option, xnetload will NOT display the local machine's load
              unless the hostname is listed on the command line.  When -nolocal
              is used, xnetload will not try to read kmem.

      -local  If xnetload is compiled with -DNOLOCAL, then no local load will
              be displayed by default.  -local will turn the local load back
              on, and make xnetload read kmem.

      [machine] ...
              The load for each machine listed will be displayed.




10/89                                                                    Page 1

XNETLOAD(l)                X Version 11(April 1989)                 XNETLOAD(l)


RESOURCES
      xnetload uses the standard toolkit resources and some private resources.
      These are some of the standard resources that I find useful:

      !**** XLOAD ****
      *Load*font:                          6x10
      *Load*height:                        35
      *Load*width:                         90
      !**** XMULTIMETER ****
      xnetload.geometry:                   -0+0
      ! number of seconds between updates for local machine
      xnetload*local*update:               15
      ! number of seconds between updates for remote machines
      xnetload*remote*update:              60


      Note - if you define "*Load*update", but not "xnetload*remote*update",
      then xnetload will set both the remote and local update times to the
      "*Load*update" value.  If this time is much less than the rwhod update
      period, (eg. 5 seconds instead of 60 seconds) then the remote load
      displays will look like bar graphs.

      The private xnetload resources are as follows:


      configuration (string) ``horizontal''
            Gives the configuration of the load widgets - use the same syntax
            as with the command line argument: horizontal for one row vertical
            for one column, mxn or mXn for m columns and n rows, mx* for m
            columns and the rows necessary, and *xn for n rows with the
            necessary number of columns.

      localload (boolean) ``on''
            If localload is true, then xnetload will use the standard Load
            widget load function to get the load average for the local machine.
            There is a compile time switch to make this default "off."

SEE ALSO
      X(1), xload(1), Athena Load widget

BUGS
      xnetload uses the Load widget's normal load function for the local
      system, therefore xnetload should be setgid kmem.  If xnetload cannot be
      setgid kmem, then either compile with -DNOLOCAL or use the -nolocal
      option.

      xnetload will also take a width and height on the application geometry
      specification, but sometimes the Form widget will leave small gaps
      between the loads.





Page 2                                                                    10/89

XNETLOAD(l)                X Version 11(April 1989)                 XNETLOAD(l)


      A very wide xnetload will often have wide margins.  I think the Form
      widget is doing this.

AUTHOR
      J. Michael Berkley (jmberkley@watnext.waterloo.edu)

















































10/89                                                                    Page 3