XLOAD(1)                    X Version 11(Release 5)                    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.





10/89                                                                    Page 1

XLOAD(1)                    X Version 11(Release 5)                    XLOAD(1)


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





Page 2                                                                    10/89