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 ). 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 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 widgets 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
notation 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/share/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
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
routine used to read it (get_load.c) must be ported to each new
operating system.
COPYRIGHT
Copyright © X Consortium
See 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 Psarogiannakopoulos (XFree86
Project).