4.3BSD-UWisc/man/catn/xload.n
XLOAD(1) UNIX Programmer's Manual XLOAD(1)
NAME
xload - X window system load average display
SYNOPSIS
xload [ option ] ...
DESCRIPTION
_x_l_o_a_d continuously displays the system load average under
the _X window system. _x_l_o_a_d creates a window in which the
load average is represented as a bar graph with n divisions.
Each division represents one unit of load average. The name
of the host is displayed in the upper left corner.
_x_l_o_a_d understands the following options:
-bd _c_o_l_o_r
Specify the border color. On monochrome displays,
should be ``white'', ``black'', or ``gray''; gray is
the default.
-bg _c_o_l_o_r
Specify the background color. On monochrome
displays, should be ``white'' or ``black''; black is
the default.
-bw _p_i_x_e_l_s
Specify the width in pixels of the border around the
_x_l_o_a_d window. The default value is 3 pixels.
-fg _c_o_l_o_r
Specify the graph color. On monochrome displays,
should be ``white'' or ``black''; white is the
default.
-fn _f_o_n_t_n_a_m_e
The hostname will be displayed in the specified font
(if none is specified, this defaults to 6x10).
-hl _c_o_l_o_r
Specify the hostname and scale line color; the
default is to make it the same as the graph color.
-rv Cause _x_l_o_a_d to produce all output in black-on-white
instead of white-on-black.
-fw Cause _x_l_o_a_d to produce all output in white-on-black
instead of black-on-white.
-scale _i_n_t_e_g_e_r
Specify the minimum number of divisions on the graph
(default 1). _X_l_o_a_d is free to use more divisions if
the load gets too high to display, but it will never
Printed 12/6/86 18 August 1985 1
XLOAD(1) UNIX Programmer's Manual XLOAD(1)
use fewer divisions than this.
-update _s_e_c_o_n_d_s
Specify the frequency in seconds with which _x_l_o_a_d
updates its display (except if the _x_l_o_a_d window is
obscured and then exposed, immediate redisplay
occurs). The default update frequency is 5 seconds.
Specification of a frequency less than 5 seconds is
ignored and the default frequency is used instead.
=_g_e_o_m_e_t_r_y
The load graph window is created with the specified
size and location determined by the supplied
geometry specification. See _X(_1) for a full expla-
nation.
[_h_o_s_t]:[_d_i_s_p_l_a_y]
Normally, _x_l_o_a_d gets the host and display number to
use from the environment variable ``DISPLAY''.
Either or both can be specified with this option.
_h_o_s_t specifies which machine to create the _x_l_o_a_d
window on, and _d_i_s_p_l_a_y specifies the display number.
For example, ``mit-grape-nehi:0'' creates an _x_l_o_a_d
on display 0 on machine mit-grape-nehi. Either value
can be defaulted by omission but ``:'' is necessary
to specify one or both.
X DEFAULTS
Foreground
Set the graph color.
Background
Set the background color.
BodyFont
Set the hostname font.
Border Set the internal border padding.
BorderColor
Set the border color.
BorderWidth
Set the border width of the window.
Highlight
Set the hostname and scale line color.
ReverseVideo
If ``on'', reverse the definition of foreground and
background color.
Printed 12/6/86 18 August 1985 2
XLOAD(1) UNIX Programmer's Manual XLOAD(1)
Scale Set the minimum scale.
Update Set the update interval.
ENVIRONMENT
DISPLAY - to get the default host and display number.
SEE ALSO
X(10, xwm(1), X(8C), mem(4), select(2)
DIAGNOSTICS
Unable to open display or create window. Unable to open
/dev/kmem. Unable to query window for dimensions. Various X
errors.
BUGS
_x_l_o_a_d requires the ability to open and read /dev/kmem. On
most systems, this requires the suid bit set with root own-
ership or the sgid bit set and membership in the same group
as /dev/kmem.
AUTHORS
K. Shane Hartman (MIT-LCS), Stuart A. Malone (MIT-LCS)
Host name feature added by Jim Gettys (MIT-Athena). Scale
feature added by Bob Scheifler (MIT-LCS). Automatic rescal-
ing feature added by Stuart A. Malone (MIT-LCS).
Copyright (c) 1985, Massachusetts Institute of Technology.
See X(1) for a complete copyright notice.
Printed 12/6/86 18 August 1985 3