![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to xload.1 CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [CSRG BSD Unix] / 43BSD / contrib / X / man|
Return to xload.1 CVS log | Up to [CSRG BSD Unix] / 43BSD / contrib / X / man |
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. On monochrome displays, should be ``white'', ``black'',
23: or ``gray''; gray is the default.
24: .PP
25: .TP 8
26: .B \-bg \fIcolor\fP
27: Specify the background color. On monochrome displays, should be ``white'' or
28: ``black''; black is the default.
29: .PP
30: .TP 8
31: .B \-bw \fIpixels\fP
32: Specify the width in pixels of the border around the
33: .I xload
34: window. The default value is 3 pixels.
35: .PP
36: .TP 8
37: .B \-fg \fIcolor\fP
38: Specify the graph color. On monochrome displays, should be ``white'' or ``black'';
39: white is the default.
40: .PP
41: .TP 8
42: .B \-fn \fIfontname\fP
43: The hostname will be displayed in the specified font (if none
44: is specified, this defaults to 6x10).
45: .PP
46: .TP 8
47: .B \-hl \fIcolor\fP
48: Specify the hostname and scale line color; the default is to make it the same
49: as the graph color.
50: .PP
51: .TP 8
52: .B \-rv
53: Cause
54: .I xload
55: to produce all output in black-on-white instead of white-on-black.
56: .PP
57: .TP 8
58: .B \-fw
59: Cause
60: .I xload
61: to produce all output in white-on-black instead of black-on-white.
62: .PP
63: .TP 8
64: .B \-scale \fIinteger\fP
65: Specify the minimum number of divisions on the graph (default 1).
66: .I Xload
67: is free to use more divisions if the load gets too high to display,
68: but it will never use fewer divisions than this.
69: .PP
70: .TP 8
71: .B \-update \fIseconds\fP
72: Specify the frequency in seconds with which
73: .I xload
74: updates its display (except if the
75: .I xload
76: window is obscured and then exposed, immediate redisplay occurs). The default
77: update frequency is 5 seconds. Specification of a frequency
78: less than 5 seconds is ignored and the default frequency is used instead.
79: .PP
80: .TP 8
81: .B =\fIgeometry\fP
82: The load graph window is created with the specified
83: size and location
84: determined
85: by the supplied geometry specification.
86: See \fIX(1)\fP for a full explanation.
87: .PP
88: .TP 8
89: .B \[\fIhost\fP]:\[\fIdisplay\fP]
90: Normally,
91: .I xload
92: gets the host and display number to use from the environment
93: variable ``DISPLAY''. Either or both can be specified with this option.
94: .I host
95: specifies which machine to create the
96: .I xload
97: window on, and
98: .I display
99: specifies the display number.
100: For example,
101: ``mit-grape-nehi:0'' creates an
102: .I xload
103: on display 0 on machine mit-grape-nehi. Either value can be defaulted
104: by omission but ``:'' is necessary to specify one or both.
105: .SH X DEFAULTS
106: .PP
107: .TP 8
108: .B Foreground
109: Set the graph color.
110: .PP
111: .TP 8
112: .B Background
113: Set the background color.
114: .PP
115: .TP 8
116: .B BodyFont
117: Set the hostname font.
118: .PP
119: .TP 8
120: .B Border
121: Set the internal border padding.
122: .PP
123: .TP 8
124: .B BorderColor
125: Set the border color.
126: .PP
127: .TP 8
128: .B BorderWidth
129: Set the border width of the window.
130: .PP
131: .TP 8
132: .B Highlight
133: Set the hostname and scale line color.
134: .PP
135: .TP 8
136: .B ReverseVideo
137: If ``on'', reverse the definition of foreground and background color.
138: .PP
139: .TP 8
140: .B Scale
141: Set the minimum scale.
142: .PP
143: .TP 8
144: .B Update
145: Set the update interval.
146: .SH ENVIRONMENT
147: DISPLAY - to get the default host and display number.
148: .SH SEE ALSO
149: X(10, xwm(1), X(8C), mem(4), select(2)
150: .SH DIAGNOSTICS
151: Unable to open display or create window. Unable to open /dev/kmem.
152: Unable to query window for dimensions. Various X errors.
153: .SH BUGS
154: .I xload
155: requires the ability to open and read /dev/kmem. On most systems, this requires
156: the suid bit set with root ownership or the sgid bit set and membership in
157: the same group as /dev/kmem.
158: .SH AUTHORS
159: K. Shane Hartman (MIT-LCS), Stuart A. Malone (MIT-LCS)
160: .br
161: Host name feature added by Jim Gettys (MIT-Athena).
162: Scale feature added by Bob Scheifler (MIT-LCS).
163: Automatic rescaling feature added by Stuart A. Malone (MIT-LCS).
164: .br
165: Copyright (c) 1985, Massachusetts Institute of Technology.
166: .br
167: 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.