xload(1) X Version 11 (25 October 1988) xload(1)
NAME
xload - displays load average
SYNOPSIS
xload [-options ...]
DESCRIPTION
The xload program displays a periodically updating histogram
of the system load average.
OPTIONS
The xload program accepts all of the standard X Toolkit
command-line options along with the additional options
listed below:
-decay number
Specifies a number between 1 and 0 that determines how
quickly xload responds to changes in the system load.
Low values cause xload to respond quickly. Values near
1 provide a smoother curve. The default is 0.85.
-scale integer
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 creates more divisions, but it never uses fewer
than this number. The default is 1.
-update seconds
Specifies how frequently (in seconds) xload updates its
display. If you uncover the load average window (by
moving windows with a window manager or by using the
xrefresh program), the graph is also updated. The
minimum amount of time allowed between updates is 5
seconds, which is also the default.
-hl color
Specifies the color for the label and scale lines.
The following standard X Toolkit options 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 of the window border in pixels.
The default is 2.
Page 1 (printed 10/4/89)
xload(1) X Version 11 (25 October 1988) xload(1)
-fg color
Specifies the graph color. The default is "black."
-fn fontname
Specifies the font for displaying the name of the host
whose load is being monitored. The default is "6x10."
-rv Simulates reverse video 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 resourcestring
Specifies a resource string. This option 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 following:
width (class Width)
Specifies the width of the load average graph.
height (class Height)
Specifies the height of the load average graph.
decay (class Decay)
Specifies how quickly xload responds to changes in the
system load.
update (class Interval)
Specifies how frequently (in seconds) the load should
redisplay.
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 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
Page 2 (printed 10/4/89)
xload(1) X Version 11 (25 October 1988) xload(1)
"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 host name.
font (class Font)
Specifies the font 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.
LIMITATIONS
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.
You have to explicitly specify the border color when you use
reverse video.
SEE ALSO
X(1)
xrdb(1)
COPYRIGHT
Copyright 1988, Massachusetts Institute of Technology.
See X(1) for a full statement of rights and permissions.
AUTHORS
K. Shane Hartman and Stuart A. Malone, MIT-LCS; with
features added by Jim Gettys, MIT-Athena; Bob Scheifler,
MIT-LCS; and Tony Della Fera, MIT-Athena.
Page 3 (printed 10/4/89)