xload(1X)                                               xload(1X)



NAME
     xload - displays the system load average

SYNOPSIS
     xload [toolkit-option]...  [-scale ticks] [-update seconds]
     [-hl color] [-highlight color] [-jumpscroll pixels]
     [-label string] [-nolabel]

DESCRIPTION
     xload displays a periodically updated graph of the system
     load average.

   Options
     The xload client application accepts all the standard X
     Toolkit command-line options, as described in X(1X), as well
     as these options:

     -hl color

     -highlight color

             Specifies the color of the tick marks.


     -jumpscroll pixels

             Specifies the number of pixels to shift the graph to

             the left when it reaches the right edge of the win-

             dow. The default value is one half of the width of

             the current window. You can get smooth scrolling by

             specifying 1.


     -label string

             Specifies the string that is placed in the label

             above the graph.


     -nolabel

             Specifies that no label is to be displayed above the

             graph.


     -scale ticks

             Specifies the minimum number of tick marks in the

             graph, where one division represents one load aver-

             age point.  If the load goes above this number,

             xload creates more divisions, but it never uses

             fewer than this number.  The default is 1.


     -update seconds

             Specifies the frequency in seconds at which xload

             updates its display.  Expose events cause automatic

             updating.  The minimum time allowed between updates

             is 1 second; the default is 5.


     The following standard X Toolkit options are commonly used

     with xload:




November, 1990                                                  1

xload(1X)                                               xload(1X)



     -bd color
             Specifies the border color of the window.  The de-
             fault is black.

     -bg color
             Specifies the background color of the window.  The
             default is white.

     -bw width
             Specifies in pixels the width of the border around
             the window.  The default is 2.

     -display display
             Specifies the X server to contact.  See X(1X) for
             details.

     -fg color
             Specifies the color of the graph.  The default is
             black.

     -fn font
             Specifies the font to be used in displaying the name
             of the host whose load is being monitored.  The de-
             fault font is 6 x 10.

     -geometry geometry
             Specifies the preferred size and position of the
             window.  See X(1X) for details.

     -rv     Simulates reverse video by swapping the foreground
             and background colors.

     -xrm resource-string
             Specifies a resource string to be used.  This is
             particularly useful for setting resources that do
             not have separate command line options.

   X defaults
     The xload client application uses the Load widget in the X
     Toolkit.  It understands all of the core resource names and
     classes as well as the following:

     font (class Font)
             Specifies the font to be used for the label.  The
             default is fixed.

     foreground (class Foreground)
             Specifies the color of the graph.  Using the class
             specifies the color for all things that normally
             would appear in the foreground color.  The default
             is black because the core default for background is
             white.



2                                                  November, 1990

xload(1X)                                               xload(1X)



     height (class Height)
             Specifies the height of the graph.

     label (class Label)
             Specifies the label to use on the graph.  The de-
             fault is the host name.

     minScale (class Scale)
             Specifies the minimum number of tick marks to be
             displayed.  The default is 1.

     reverseVideo (class ReverseVideo)
             Specifies that the foreground and background colors
             are reversed.

     update (class Interval)
             Specifies the frequency in seconds at which the
             graph is updated and redisplayed.

     scale (class Scale)
             Specifies the initial number of tick marks on the
             graph.  The default is 1.

     width (class Width)
             Specifies the width of the load average graph.

   Resources
     In addition to the resources available to each of the widg-
     ets used by xload, one resource is defined by the applica-
     tion itself:

     showLabel (class Boolean)
             If FALSE, no label is displayed.

   Widget hierarchy
     To specify resources, it is useful to know the hierarchy of
     the widgets that compose xload. In the following notation,
     indentation indicates hierarchical structure. The widget
     class name is given first, followed by the widget instance
     name.

     XLoad xload
          Paned paned
               Label label
               StripChart load

   Environment variables
     The xload command uses the following environment variables:

     DISPLAY Specifies the default host, display number, and
             screen.




November, 1990                                                  3

xload(1X)                                               xload(1X)



     XENVIRONMENT
             Specifies the name of a resource file to override
             the global resources stored in the RESOURCE_MANAGER
             property.

LIMITATIONS
     The xload command requires the ability to open and read
     /dev/kmem.  This requires the suid bit set with root owner-
     ship or the sgid bit set and membership in the same group as
     /dev/kmem.

     Reading /dev/kmem is inherently nonportable.

NOTES
     Copyright 1988, Massachusetts Institute of Technology.
     See X(1X) for a full statement of rights and permissions.

     Authors: K. Shane Hartman and Stuart A. Malone, MIT Labora-
     tory for Computer Science.  Jim Gettys, MIT Project Athena;
     Bob Scheifler, MIT Laboratory for Computer Science; Tony
     Della Fera, MIT Project Athena; and Chris Peterson, MIT La-
     boratory for Computer Science provided additional features.

SEE ALSO
     X(1X), xrdb(1X)

     mem(7) in A/UX System Administrator's Reference




























4                                                  November, 1990