|
|
1.1 root 1:
2:
3:
4: XLOAD(1) UNIX Programmer's Manual XLOAD(1)
5:
6:
7:
8: NAME
9: xload - X window system load average display
10:
11: SYNOPSIS
12: xload [ option ] ...
13:
14: DESCRIPTION
15: _x_l_o_a_d continuously displays the system load average under
16: the _X window system. _x_l_o_a_d creates a window in which the
17: load average is represented as a bar graph with n divisions.
18: Each division represents one unit of load average. The name
19: of the host is displayed in the upper left corner.
20:
21: _x_l_o_a_d understands the following options:
22:
23: -bd _c_o_l_o_r
24: Specify the border color. On monochrome displays
25: this option is ignored. The default color is
26: ``black''.
27:
28: -bg _c_o_l_o_r
29: Specify the background color. On monochrome
30: displays this option is ignored. The default color
31: is ``white''.
32:
33: -bw _p_i_x_e_l_s
34: Specify the width in pixels of the border around the
35: _x_l_o_a_d window. The default value is 3 pixels.
36:
37: -fg _c_o_l_o_r
38: Specify the graph color. On monochrome displays
39: this option is ignored. The default color is
40: ``black''.
41:
42: -fn _f_o_n_t_n_a_m_e
43: The hostname will be displayed in the specified font
44: (if none is specified, this defaults to 6x10).
45:
46: -hl _c_o_l_o_r
47: Specify the hostname and scale line color; the
48: default is to make it the same as the graph color.
49:
50: -rv Reverses the default color values (i.e., black
51: becomes white and white becomes black).
52:
53: -fw Forces the default color values to remain at their
54: predetermined settings (i.e., white is white and
55: black is black).
56:
57: -scale _i_n_t_e_g_e_r
58: Specify the minimum number of divisions on the graph
59: (default 1). _X_l_o_a_d is free to use more divisions if
60:
61:
62:
63: Printed 9/15/87 18 August 1985 1
64:
65:
66:
67:
68:
69:
70: XLOAD(1) UNIX Programmer's Manual XLOAD(1)
71:
72:
73:
74: the load gets too high to display, but it will never
75: use fewer divisions than this.
76:
77: -update _s_e_c_o_n_d_s
78: Specify the frequency in seconds with which _x_l_o_a_d
79: updates its display (except if the _x_l_o_a_d window is
80: obscured and then exposed, immediate redisplay
81: occurs). The default update frequency is 5 seconds.
82: Specification of a frequency less than 5 seconds is
83: ignored and the default frequency is used instead.
84:
85: =_g_e_o_m_e_t_r_y
86: The load graph window is created with the specified
87: size and location determined by the supplied
88: geometry specification. See _X(_1) for a full expla-
89: nation.
90:
91: [_h_o_s_t]:[_d_i_s_p_l_a_y]
92: Normally, _x_l_o_a_d gets the host and display number to
93: use from the environment variable ``DISPLAY''.
94: Either or both can be specified with this option.
95: _h_o_s_t specifies which machine to create the _x_l_o_a_d
96: window on, and _d_i_s_p_l_a_y specifies the display number.
97: For example, ``mit-grape-nehi:0'' creates an _x_l_o_a_d
98: on display 0 on machine mit-grape-nehi. Either value
99: can be defaulted by omission but ``:'' is necessary
100: to specify one or both.
101:
102: X DEFAULTS
103: Foreground
104: Set the graph color. Ignored on monochrome
105: displays.
106:
107: Background
108: Set the background color. Ignored on monochrome
109: display.
110:
111: BodyFont
112: Set the hostname font.
113:
114: Border Set the internal border padding.
115:
116: BorderColor
117: Set the border color. Ignored on monochrome
118: displays.
119:
120: BorderWidth
121: Set the border width of the window.
122:
123: Highlight
124: Set the hostname and scale line color. Ignored on
125: monochrome displays.
126:
127:
128:
129: Printed 9/15/87 18 August 1985 2
130:
131:
132:
133:
134:
135:
136: XLOAD(1) UNIX Programmer's Manual XLOAD(1)
137:
138:
139:
140: ReverseVideo
141: If ``on'', reverse the effect of the defaults
142: colors. Ignored on color displays.
143:
144: Scale Set the minimum scale.
145:
146: Update Set the update interval.
147:
148: ENVIRONMENT
149: DISPLAY - to get the default host and display number.
150:
151: SEE ALSO
152: X(10, xwm(1), X(8C), mem(4), select(2)
153:
154: DIAGNOSTICS
155: Unable to open display or create window. Unable to open
156: /dev/kmem. Unable to query window for dimensions. Various X
157: errors.
158:
159: BUGS
160: _x_l_o_a_d requires the ability to open and read /dev/kmem. On
161: most systems, this requires the suid bit set with root own-
162: ership or the sgid bit set and membership in the same group
163: as /dev/kmem.
164:
165: AUTHORS
166: K. Shane Hartman (MIT-LCS), Stuart A. Malone (MIT-LCS)
167: Host name feature added by Jim Gettys (MIT-Athena). Scale
168: feature added by Bob Scheifler (MIT-LCS). Automatic rescal-
169: ing feature added by Stuart A. Malone (MIT-LCS). Color
170: enhancements added by Tony Della Fera (MIT-Athena)
171: Copyright (c) 1985, Massachusetts Institute of Technology.
172: See X(1) for a complete copyright notice.
173:
174:
175:
176:
177:
178:
179:
180:
181:
182:
183:
184:
185:
186:
187:
188:
189:
190:
191:
192:
193:
194:
195: Printed 9/15/87 18 August 1985 3
196:
197:
198:
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.