XLOAD(1)                 USER COMMANDS                   XLOAD(1)



NAME
     xload - load average display for X

SYNOPSIS
     xload [-toolkitoption   ...]   [-scale   integer]   [-update
     seconds] [-hl color] [-highlight color]
           [-jumpscroll pixels] [-label string] [-nolabel]

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 unimpor-
     tant.  xload also accepts the following additional options:

     -hl color or -highlight color
             This option specifies the color of the scale lines.

     -jumpscroll FPnumber 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.

     -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.  The minimum amount
             of time allowed between updates  is  1  second  (the
             default is 5 seconds).

RESOURCES
     In addition to the resources available to each of the  widg-
     ets  used  by  xload  there  is  one resource defined by the



X Version 11         Last change: Release 4                     1

XLOAD(1)                 USER COMMANDS                   XLOAD(1)



     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 nota-
     tion 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  spe-
     cial 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



X Version 11         Last change: Release 4                     2

XLOAD(1)                 USER COMMANDS                   XLOAD(1)



     Peterson (MIT-LCS).






















































X Version 11         Last change: Release 4                     3