XLOAD(1X11)             COMMAND REFERENCE             XLOAD(1X11)



NAME
     xload - load average display for X

SYNOPSIS
     xload [-toolkitoption ...] [-scale integer] [-update
     seconds]

     This is a user-contributed client.

DESCRIPTION
     The xload program displays a periodically updating histogram
     of the system load average.  This program is nothing more
     than a wrapper around the Athena Load widget.

OPTIONS
     The xload program accepts all standard X Toolkit command
     line options along with the following additional options:

     -scale integer           This option specifies the minimum
                              number of tick marks in the
                              histogram, where one division
                              represents one load average point.
                              If the load goes above this number,
                              xload will create more divisions,
                              but it will never use fewer than
                              this number.  The default is 1.

     -update seconds          This option specifies the frequency
                              in seconds at which xload updates
                              its display.  If the load average
                              window is uncovered (by moving
                              windows with a window manager or by
                              the xrefresh program), the graph
                              will be also be updated.  The
                              minimum amount of time allowed
                              between updates is 5 seconds (which
                              is also the default).

     -hl color                This option specifies the color of
                              the label and scale lines.

     The following standard X Toolkit arguments are commonly used
     with xload:

     -bd color                This option specifies the border
                              color.  The default is black.

     -bg color                This option specifies the
                              background color.  The default is
                              white.

     -bw pixels               This option specifies the width in



Printed 3/22/89                                                 1

XLOAD(1X11)             COMMAND REFERENCE             XLOAD(1X11)



                              pixels of the border around the
                              window.  The default value is 2.

     -fg color                This option specifies the graph
                              color.  The default color is black.

     -fn fontname             This option specifies the font to
                              be used in displaying the name of
                              the host whose load is being
                              monitored.  The default is 6x10.

     -rv                      This option indicates that reverse
                              video should be simulated by
                              swapping the foreground and
                              background colors.

     -geometry geometry       This option specifies the preferred
                              size and position of the window.

     -display display         This option specifies the X server
                              to contact.

     -xrm resourcestring      This option specifies a resource
                              string to be used.  This is
                              especially useful for setting
                              resources that do not have separate
                              command line options.

X DEFAULTS
     This program uses the Load widget in the X Toolkit.  It
     understands all of the core resource names and classes as
     well as the commands listed here.

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

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

     update (class Interval)            Specifies the frequency
                                        in seconds at which the
                                        load should be
                                        redisplayed.

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

     minScale (class Scale)             Specifies the minimum
                                        number of ticks that will
                                        be displayed.  The
                                        default is 1.



Printed 3/22/89                                                 2

XLOAD(1X11)             COMMAND REFERENCE             XLOAD(1X11)



     foreground (class Foreground)      Specifies the color for
                                        the graph. The default is
                                        black since the core
                                        default for background is
                                        white.

     highlight (class Foreground)       Specifies the color for
                                        the text and scale lines.
                                        The default is the same
                                        as for the foreground
                                        resource.

     label (class Label)                Specifies the label to
                                        use on the graph.  The
                                        default is the hostname.

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

     reverseVideo (class ReverseVideo)  Specifies that the
                                        foreground and background
                                        should be reversed.

DIAGNOSTICS
     Unable to open display or create window. Unable to open
     /dev/kmem.

     Unable to query window for dimensions. Various X errors.

CAVEATS
     This program requires the ability to open and read the
     special system file /dev/kmem.  Sites that do not allow
     general access to this file should make xload belong to the
     same group as /dev/kmem and turn on the set group id
     permission flag.

     Reading /dev/kmem is inherently non-portable.  Therefore,
     the widget upon which this application is based must be
     ported to each new operating system.

     Border color has to be explicitly specified when reverse
     video is used.  See X(1x11) for a full statement of rights
     and permissions.

SEE ALSO
     X(1x11), xrdb(1x11), and mem(4).

AUTHORS
     K. Shane Hartman (MIT-LCS) and Stuart A. Malone (MIT-LCS);
     with features added by Jim Gettys (MIT-Athena), Bob
     Scheifler (MIT-LCS), and Tony Della Fera (MIT-Athena)



Printed 3/22/89                                                 3

%%index%%
na:336,86;
sy:422,307;
de:729,353;
op:1082,2401;3891,3568;7867,2219;
di:10086,277;
ca:10363,783;
se:11146,410;
%%index%%000000000144