This manual page is for Mac OS X version 10.6.3

Reading manual pages

XLOAD(1)                                                                                            XLOAD(1)



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

SEE ALSO
       X(7), 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 (C) 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), (MITAthena),
       Athena), and Chris Peterson (MIT-LCS).  DG/UX support by Takis Psarogiannakopoulos (XFree86 Project).



X Version 11                                     xload 1.0.2                                        XLOAD(1)