NAME

xload - load average display for X

SYNOPSIS

xload [-toolkitoption ...] [-scale integer] [-update seconds]

DESCRIPTION

The xload program displays a periodically updating histogram of the system load average.  This program is nothing more than a wrapper around the Athena Load widget. 

OPTIONS

Xload accepts all of the standard X Toolkit command line options along with the additional options listed below:

−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 frequency in seconds at which xload updates its display.  Expose events will cause automatic updating.  The minimum as well as default time is 5 seconds. 

The following standard X Toolkit arguments are commonly used with xload. 

−bd color
This option specifies the border color. The default color is “black”.

−bg color
This option specifies the background color. The default color is “white”.

−bw pixels
This option specifies the width in pixels of the border around the window. The default value is 2.

−fg color
This option specifies the graph color. The default color is “black”.

−fn fontname
This option specifies the font to be used in displaying the name of the host whose load is being monitored.  The default is “6x10.”

−rv This option indicates that reverse video should be simulated by swapping the foreground and background colors. 

−geometry geometry
This option specifies the prefered size and postion of the window; see X(1). 

−display display
This option specifies the X server to contact; see X(1). 

−xrm resourcestring
This option specifies a resource string to be used.  This 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:

width (class Width)
Specifies the width of the load average graph.

height (class Height)
Specifies the height of the load average graph.

update (class Interval)
Specifies the frequency in seconds at which the load should be redisplayed.

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 that will be displayed.  The default is 1.

foreground (class Foreground)
Specifies the color for the graph.  Using the class specifies the color for all things that normally would appear in the foreground color. The default is “black” since the core default for background is “white.”

label (class Label)
Specifies the label to use on the graph.  The default is the hostname.

font (class Font)
Specifies the font to be used for the label.  The default is “fixed.”

reverseVideo (class ReverseVideo)
Specifies that the foreground and background should be reversed.

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.

SEE ALSO

X(1), xrdb(1), mem(4), Athena Load widget

DIAGNOSTICS

Unable to open display or create window. Unable to open /dev/kmem.  Unable to query window for dimensions. Various X errors. 

BUGS

This program requires the ability to open and read /dev/kmem. On most systems, this requires the suid bit set with root ownership or the sgid bit set and membership in the same group as /dev/kmem. 

Reading /dev/kmem is inherently non-portable. 

Border color has to be explicitly specified when reverse video is used. 

COPYRIGHT

Copyright 1988, Massachusetts Institute of Technology. 
See X(1) 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), and Tony Della Fera (MIT-Athena)

X Version 11  —  1 March 1988