1XLOAD(1) General Commands Manual XLOAD(1)
2
3
4
6 xload - system load average display for X
7
9 xload [-toolkitoption ...] [-scale integer] [-update seconds] [-hl
10 color] [-highlight color] [-remote host]
11 [-jumpscroll pixels] [-label string] [-nolabel] [-lights]
12
14 The xload program displays a periodically updating histogram of the
15 system load average.
16
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 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
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
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
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
88 /usr/share/X11/app-defaults/XLoad
89 specifies required resources
90
92 X(7), xrdb(1), mem(4), Athena StripChart Widget.
93
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
105 Copyright © X Consortium
106 See X(7) for a full statement of rights and permissions.
107
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
113
114
115X Version 11 xload 1.1.2 XLOAD(1)