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