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

SEE ALSO

       X(7), xrdb(1), mem(4), Athena StripChart Widget.

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).