Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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]
	   [-help|-version]

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 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 dis-
	     played 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 his-
	     togram, 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  up-
	     dates  its display.  The minimum amount of time allowed between up-
	     dates is 1 second.  The default is 10.

     -remote host
	     This option tells xload to display the load of host instead of  lo-
	     calhost.  Xload  gets  the  information from the rwhod database and
	     consequently requires rwhod to be executing both on  localhost  and
	     host.

     -help   This  option  specifies that xload should print a usage message and
	     exit.

     -version
	     This option specifies that xload  should  print  version  info  and
	     exit.

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  re-
	     sources stored in the RESOURCE_MANAGER property.

FILES
     /usr/local/share/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  rou-
     tine used to read it (get_load.c) must be ported to each new operating sys-
     tem.

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.2.0				XLOAD(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=xload&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help