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 following additional options:

−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.  If the load average window is uncovered (by moving windows with a window manager or by the xrefresh program), the graph will be also be updated.  The minimum amount of time allowed between updates is 5 seconds (which is also the default). 

−hl color
This option specifies the color of the label and scale lines.

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

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

−bg color
This option specifies the background color. The default 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 preferred size and position of the ­window.

−display display
This option specifies the X server to contact.

−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. The default is black since the core default for background is white. 

highlight (class Foreground)
Specifies the color for the text and scale lines.  The default is the same as for the foreground resource. 

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.

SEE ALSO

X(1), xrdb(1),
mem(4) in the UNIX Programmer’s Reference Manual for BSD 4.3,
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 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 widget upon which this application is based must be ported to each new operating system. 

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)

\*U  —  Version 1.0