XLOAD(1)                             BSD                              XLOAD(1)



NAME
     xload - load average display for X

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

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
     Xload accepts all of the 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 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 prefered size and postion 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:

     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.

     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.

SEE ALSO
     X(1), xrdb(1), mem(4), Athena Load widget

DIAGNOSTICS
     Unable to open display or create window. Unable to open /dev/kmem.
     Unable to query window for dimensions. Various X errors.

BUGS
     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.

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

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)