.TH xload "" "" "X Client"
.PC "Display your system's load average"
\fBxload [\-\fItoolkitoption ...\^\fB] [\-scale \fIinteger\^\fB] [\-update \fIseconds\^\fB] [\-hl \fIcolor\^\fB] [\-highlight \fIcolor\^\fB]\fR
	\fB[\-jumpscroll \fIpixels\^\fB] [\-label \fIstring\^\fB] [\-nolabel] [\-lights]\fR
.PP
.HS
.SH Options:
.IC "\fB\-bd \fIcolor\fR"
Set the color of the border to \fIcolor\fR
.IC "\fB\-bg \fIcolor\fR"
Set the color of the background to \fIcolor\fR
.IC "\fB\-bw \fIpixels\fR"
Set the width of the border to \fIpixels\fR
.IC "\fB\-display \fIhost\^\fB[:\fIserver\^\fB][.\fIscreen\^\fB]\fR"
Display the client's window on screen number \fIscreen\fR
of \fIserver\fR on host system \fIhost\fR
.IC "\fB\-fg \fIcolor\fR"
Set the color of the foreground to \fIcolor\fR
.IC "\fB\-fn \fIfont\fR"
Use \fIfont\fR in the display
.IC "\fB\-geometry \fIgeometry\fR"
Set the geometry of the program's window to \fIgeometry\fR
.IC "\fB\-highlight \fIcolor\fR"
Specify the color of the scale lines
.IC "\fB\-jumpscroll \fIpixels\fR"
Jump the histogram by \fIpixels\fR
when it reaches the edge of the window
.IC "\fB\-label \fIstring\fR"
Display \fIstring\fR
as a label above the histogram
.IC "\fB\-nolabel\fR"
Display no label above the histogram
.IC \fB\-rv\fR
Simulate reverse video by exchanging the foreground and background colors
.IC "\fB\-scale \fIticks\fR"
Specify the minimum number of tick-marks in the histogram, where
one tick-mark represents one load-average point
.IC "\fB\-update \fIseconds\fR"
Update the histogram after an interval of \fIseconds\fR
.IC "\fB\-xrm \fIresourcestring\fR"
Use \fIresourcestring\fR to define a resource
.HE
.B xload
opens a window and displays a histogram of your system's load average.
The histogram is a bar graph that grows from left to right.
.PP
.B xload
recognizes the following command-line options:
.IP "\fB\-bd \fIcolor\fR" 0.75i
Set the color of the border to
.IR color .
The default is black
.IP "\fB\-bg \fIcolor\fR"
Set the color of the background to
.IR color .
The default is white.
.IP "\fB\-bw \fIpixels\fR"
Set the width of the border to
.IR pixels .
The default is two.
.IP "\fB\-display \fIhost\^\fB[:\fIserver\^\fB][.\fIscreen\^\fB]\fR"
Display the client's window on screen number
.I screen
of
.I server
on host system
.IR host .
.IP "\fB\-fg \fIcolor\fR"
Set the color of the foreground to
.IR color .
The default is black.
.IP "\fB\-fn \fIfont\fR"
Use
.I font
in the display.
The default is
.BR fixed ,
a 6\(mu10, fixed-width font.
.IP "\fB\-geometry \fIgeometry\fR"
Set the geometry of the program's window to
.IR geometry .
The term ``geometry'' means the dimensions of the window and its location
on the screen.
.I geometry
has the form \fIwidth\(muheight\(+-xoffset\(+-yoffset\fR.
.IP "\fB\-highlight \fIcolor\fR"
Specify the color of the scale lines.
.IP "\fB\-jumpscroll \fIpixels\fR"
Jump the histogram by
.I pixels
when it reaches the edge of the window.
The default is half the width of the current window.
To obtain smooth scrolling, set
.I pixels
to one.
.IP "\fB\-label \fIstring\fR"
Display
.I string
as a label above the histogram.
.IP "\fB\-nolabel\fR"
Display no label above the histogram.
.IP \fB\-rv\fR
Simulate reverse video by exchanging the foreground and background colors.
.IP "\fB\-scale \fIticks\fR"
Specify the minimum number of tick-marks in the histogram, where
one tick-mark represents one load-average point.
If the load goes above this number,
.B xload
creates more divisions, but it will never use fewer than
.IR ticks .
The default is one.
.IP "\fB\-update \fIseconds\fR"
Update the histogram after an interval of
.IR seconds .
The default is five.
If the histogram is iconified and then de-iconified,
.B xload
updates it immediately.
.IP "\fB\-xrm \fIresourcestring\fR"
Use
.I resourcestring
to define a resource.
.SH Resources
.B xload
uses the resource \fBshowLabel(\fRclass \fBBoolean)\fR.
If false,
.B xload
displays no label.
.\".SH Widgets
.\"The following gives the hierarchy of the widgets that
.\".B xload
.\"uses:
.\".DM
.\"	XLoad	xload
.\"		Paned	paned
.\"			Label	label
.\"			StripChart	load
.\".DE
.SH Environment
.B xload
reads the following environmental variables:
.IP \fBDISPLAY\fR
The default host and display.
.IP \fBXENVIRONMENT\fR
The name of a resource file that overrides the global resources
stored in the manager
.BR RESOURCE_MANAGER .
.SH "See Also"
.B
X clients
.R
.br
\*(CO Lexicon:
.B
ls
.R
.SH Notes
Copyright \(co 1988, Massachusetts Institute of Technology.
.PP
.II /dev/kmem
.II kmem
.B xload
must be able to open and read file
.BR /dev/kmem .
Sites that do not allow general access to this file should have
.B xload
belong to the same group as
.BR /dev/kmem ,
and turn on the
.B "set group id"
flag.
For details on file permissions, see the entry for the command
.B ls
in the \*(CO Lexicon.
.PP
.II "Hartmann, K. Shane"
.II "Malone, Stuart A."
.II "Gettys, Jim"
.II "Scheifler, Jim"
.II "Della Fera, Tony"
.II "Peterson, Chris"
.B xload
was written by K. Shane Hartmann and Stuart A. Malone.
Jim Gettys, Bob Scheifler, Tony Della Fera, and Chris Peterson added features.
