Manual: xload

XLOAD(1)				   General Commands Manual				    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 op‐
       tions is unimportant.  xload also accepts the following additional options:

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

       -jumpscroll 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 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	 in‐
	       formation from the rwhod database and consequently requires rwhod to be executing both on lo‐
	       calhost and host.

RESOURCES
       In addition to the resources available to each of the widgets used by xload there is one resource de‐
       fined 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	 RE‐
	       SOURCE_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.

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

X Version 11					 xload 1.1.4					    XLOAD(1)