XLOAD(1) 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.
OPTIONS
xload accepts all the standard X Toolkit command line
options in addition to the following:
-scale integer
specifies the minimum number of regions in the
histogram, where one region represents one load
average point. Multiple regions are separated by
horizontal lines. If the load goes above this
number, xload will create more regions, but it will
never use fewer than this number. The default is
1.
-update seconds
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 is also
updated. The default amount of time between
updates is 5 seconds.
-hl color
specifies the color of the label and scale lines.
The following standard X Toolkit arguments are commonly
used with xload:
-bd color
specifies the border color. The default is black.
-bg color
specifies the background color. The default is
white.
-bw pixels
specifies the width in pixels of the border around
the window. The default value is 2.
-fg color
specifies the graph color. The default is black.
- 1 -
XLOAD(1) XLOAD(1)
-fn fontname
specifies the font to be used in displaying the
name of the host whose load is being monitored.
The default is 6x10.
-rv
indicates that reverse video should be simulated by
swapping the foreground and background colors.
-geometry geometry
specifies the preferred size and position of the
window.
-display display
specifies the X server to contact.
-xrm resource_string
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 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 is 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 are
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
- 2 -
XLOAD(1) XLOAD(1)
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 are
reversed.
SEE ALSO
xrdb(1), sar(1m)
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.
To ensure a contrasting border color when reverse video
is used, the border color should be explicitly
specified.
AUTHORS
K. Shane Hartman, MIT-LCS and Stuart A. Malone, MIT-LCS
Features added by Jim Gettys, MIT Project Athena, Bob
Scheifler, MIT-LCS, and Tony Della Fera, MIT Project
Athena
- 3 -