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] [-hl
10       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 in 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 number of 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
53               between 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       This program requires the ability to open and read the  special  system
96       file  /dev/kmem.   Sites  that do not allow general access to this file
97       should make xload belong to the same group as /dev/kmem and turn on the
98       set group id permission flag.
99
100       Reading  /dev/kmem  is inherently non-portable.  Therefore, the routine
101       used to read it (get_load.c) must be ported to each new operating  sys‐
102       tem.
103
105       Copyright © X Consortium
106       See X(7) for a full statement of rights and permissions.
107

AUTHORS

109       K. Shane Hartman (MIT-LCS) and Stuart A. Malone (MIT-LCS);
110       with  features  added  by  Jim Gettys (MIT-Athena), Bob Scheifler (MIT-
111       LCS), Tony Della  Fera  (MIT-Athena),  and  Chris  Peterson  (MIT-LCS).
112       DG/UX support by Takis Psarogiannakopoulos (XFree86 Project).
113
114
115
116X Version 11                      xload 1.0.2                         XLOAD(1)
Impressum