XLOAD(1)                        X11 R4.11MU05                       XLOAD(1)


NAME
       xload - system load average display for X

SYNOPSIS
       xload [-toolkitoption ...] [-scale integer]
             [-update seconds] [-hl color] [-highlight color]
             [-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(1)).  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.

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/lib/X11/app-defaults/XLoad - specifies required resources

SEE ALSO
       X(1), 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 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), Tony Della Fera (MIT-Athena), and Chris Peterson (MIT-LCS).


Licensed material--property of copyright holder(s)