1XLOAD(1)                    General Commands Manual                   XLOAD(1)
2
3
4

NAME

6       xload - system load average display for X
7

SYNOPSIS

9       xload     [-toolkitoption ...] [-scale integer] [-update seconds]
10               [-hl color] [-highlight color]  [-remote host]
11               [-jumpscroll pixels] [-label string] [-nolabel] [-lights]
12

DESCRIPTION

14       The  xload  program  displays  a periodically updating histogram of the
15       system load average.
16

OPTIONS

18       Xload accepts all of the standard X Toolkit command line  options  (see
19       X(7)).   The  order  of the options is unimportant.  xload also accepts
20       the following additional options:
21
22       -hl color or -highlight color
23               This option specifies the color of the scale lines.
24
25       -jumpscroll pixels
26               The number of pixels to shift the graph to the  left  when  the
27               graph  reaches the right edge of the window.  The default value
28               is 1/2 the width of the current window.  Smooth  scrolling  can
29               be achieved by setting it to 1.
30
31       -label string
32               The string to put into the label above the load average.
33
34       -nolabel
35               If  this command line option is specified then no label will be
36               displayed above the load graph.
37
38       -lights When specified, this option causes xload to display the current
39               load  average by using the keyboard leds; for a load average of
40               n, xload lights the first n keyboard leds.  This  option  turns
41               off the usual screen display.
42
43       -scale integer
44               This  option  specifies the minimum number of tick marks in the
45               histogram, where  one  division  represents  one  load  average
46               point.   If  the load goes above this number, xload will create
47               more divisions, but it will never use fewer than  this  number.
48               The default is 1.
49
50       -update seconds
51               This  option  specifies  the interval in seconds at which xload
52               updates its display.  The minimum amount of  time  allowed  be‐
53               tween updates is 1 second.  The default is 10.
54
55       -remote host
56               This  option tells xload to display the load of host instead of
57               localhost. Xload gets the information from the  rwhod  database
58               and  consequently requires rwhod to be executing both on local‐
59               host and host.
60

RESOURCES

62       In addition to the resources available to each of the widgets  used  by
63       xload there is one resource defined by the application itself.
64
65       showLabel (class Boolean)
66               If False then no label will be displayed.
67

WIDGETS

69       In  order  to  specify resources, it is useful to know the hierarchy of
70       the widgets which compose xload.  In the  notation  below,  indentation
71       indicates  hierarchical  structure.   The  widget  class  name is given
72       first, followed by the widget instance name.
73
74       XLoad  xload
75               Paned  paned
76                       Label  label
77                       StripChart  load
78
79

ENVIRONMENT

81       DISPLAY to get the default host and display number.
82
83       XENVIRONMENT
84               to get the name of a resource file that  overrides  the  global
85               resources stored in the RESOURCE_MANAGER property.
86

FILES

88       /usr/share/X11/app-defaults/XLoad
89              specifies required resources
90

SEE ALSO

92       X(7), xrdb(1), mem(4), Athena StripChart Widget.
93

BUGS

95       On  older  platforms,  this program may require the ability to open and
96       read the special system file /dev/kmem.  Sites that do not  allow  gen‐
97       eral  access  to  this  file  may need to make xload belong to the same
98       group as /dev/kmem and turn on the set group id permission flag.
99
100       Reading the load average is inherently  non-portable.   Therefore,  the
101       routine used to read it (get_load.c) must be ported to each new operat‐
102       ing system.
103

AUTHORS

105       K. Shane Hartman (MIT-LCS) and Stuart A. Malone (MIT-LCS);
106       with features added by Jim Gettys  (MIT-Athena),  Bob  Scheifler  (MIT-
107       LCS), Tony Della Fera (MIT-Athena), and Chris Peterson (MIT-LCS).
108
109
110
111X Version 11                      xload 1.1.4                         XLOAD(1)
Impressum