XLOAD(1) UNIX Programmer's Manual XLOAD(1)
NAME
xload - system load average display for X
SYNOPSIS
xload [-toolkitoption ...] [-scale integer] [-update
seconds] [-hl color] [-highlight color] [-remote host]
[-jumpscroll pixels] [-label string] [-nolabel] [-
lights]
DESCRIPTION
The xload program displays a periodically updating histogram
of the system load average.
OPTIONS
Xload accepts all of the standard X Toolkit command line
options (see X(7)). The order of the options in unimportant.
xload also accepts the following additional options:
-hl color or -highlight color
This option specifies the color of the scale lines.
-jumpscroll number of pixels
The number of pixels to shift the graph to the left
when the graph reaches the right edge of the window.
The default value is 1/2 the width of the current
window. Smooth scrolling can be achieved by setting
it to 1.
-label string
The string to put into the label above the load
average.
-nolabel
If this command line option is specified then no
label will be displayed above the load graph.
-lights When specified, this option causes xload to display
the current load average by using the keyboard leds;
for a load average of n, xload lights the first n
keyboard leds. This option turns off the usual
screen display.
-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 interval in seconds at
XFree86 Version 4.5.0 1
XLOAD(1) UNIX Programmer's Manual XLOAD(1)
which xload updates its display. The minimum amount
of time allowed between updates is 1 second. The
default is 10.
-remote host
This option tells xload to display the load of host
instead of localhost. Xload gets the information
from the rwhod database and consequently requires
rwhod to be executing both on localhost and host.
RESOURCES
In addition to the resources available to each of the widg-
ets used by xload there is one resource defined by the
application itself.
showLabel (class Boolean)
If False then no label will be displayed.
WIDGETS
In order to specify resources, it is useful to know the
hierarchy of the widgets which compose xload. In the nota-
tion below, indentation indicates hierarchical structure.
The widget class name is given first, followed by the widget
instance name.
XLoad xload
Paned paned
Label label
StripChart load
ENVIRONMENT
DISPLAY to get the default host and display number.
XENVIRONMENT
to get the name of a resource file that overrides
the global resources stored in the RESOURCE_MANAGER
property.
FILES
/usr/X11R6/lib/X11/app-defaults/XLoad
specifies required resources
SEE ALSO
X(7), xrdb(1), mem(4), Athena StripChart Widget.
BUGS
This program requires the ability to open and read the spe-
cial 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.
XFree86 Version 4.5.0 2
XLOAD(1) UNIX Programmer's Manual XLOAD(1)
Reading /dev/kmem is inherently non-portable. Therefore,
the routine used to read it (get_load.c) must be ported to
each new operating system.
COPYRIGHT
Copyright (C) X Consortium
See X(7) 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), Tony Della Fera (MIT-Athena), and Chris
Peterson (MIT-LCS). DG/UX support by Takis Psarogiannako-
poulos (XFree86 Project).
XFree86 Version 4.5.0 3