Ubuntu Manpage: xload - system load average display for X

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 is 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

       /etc/X11/app-defaults/XLoad
              specifies required resources

BUGS

       On  older  platforms,  this  program  may require the ability to open and read the special
       system file /dev/kmem.  Sites that do not allow general access to this file  may  need  to
       make  xload  belong to the same group as /dev/kmem and turn on the set group id permission
       flag.

       Reading the load average 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 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).