File: README

package info (click to toggle)
wmavgload 0.7.0-2
  • links: PTS
  • area: main
  • in suites: potato, woody
  • size: 92 kB
  • ctags: 89
  • sloc: ansic: 598; makefile: 30
file content (257 lines) | stat: -rw-r--r-- 7,067 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
/* ---------------------------------------- */
wmavgload - Another WindowMaker load gauge
/* ---------------------------------------- */

VERSION 0.7.0
RELEASE DATE: September 28, 1998
AUTHOR : Anthony MALLET, mallet@laas.fr, adapted from 
	 wmload by Rian Land (see original README below)
	 ...

	- Well, it's finally there. Did you still expect some new release ?

	- Buffer owerflow fix from Chris Radek.

	- More efficient polling loop that does no longer affect Larry
	  'Daffy' Daffner's load ;) (patch from himself).

	- Multiple platform support from Geir Inge Jesen (NetBSD), Branko
	  Cibej (HPUX), Nagai Takayuki (DigitalUnix 4.0), Kenji Aoyama and
          Chris Radek (same patch for FreeBSD :). No one sent me an OpenBSD 
	  patch, hopefully I'm there with my brand new OpenBSD box :).

VERSION 0.6.1
RELEASE DATE: December 10, 1997

	- Removed a stupid compile-time bug.

	- Added -DMANY_COLORS to compile with the full_color xpm

	- Thanks to John Kennis and Jeff Meininger for feedback !

VERSION 0.6.0
RELEASE DATE: December  2, 1997

	- Added support for Sun/Solaris. It uses rstat and
	  I'd like to know if other platforms support it as
	  well.

	- The load average is really integrated over 5 secs.
	  The two other bars display the load integrated over 
	  30 and 60 secs respectively.

TODO:
	Learn how to speak good english ;)

VERSION 0.5.0
RELEASE DATE: November 25, 1997

	- Changes in the load algorithms and graphx
	  according to the TODO list of wmload :)

	  The load is read from /proc/loadavg
	  The main part shows the standard avg load
	  (integrated over 5 secs ??)
	  Two bars on the left show the two other values 
	  found in /proc/loadavg (integrated over ... ??)

	- Still to be seriously tested while no major
	  problems should arise !

TODO :
	?? well, tell me !


****************************************************
	ORIGINAL README FILE
****************************************************

>================================================<
wmload - WindowMaker load gauge
Updated, cleaned up and "fixed"
==================================================
VERSION: 0.9.2
RELEASE DATE: 17 July 1997

	-Minor cosmetic changes.
	 The graph zone is now perfectly square, 54x54.
	 <I didn't like it's odd width! (;-)>
	
	-All values dealing with pixmap size have been
	 adjusted to accomodate the new `look'.

VERSION: 0.9.1
RELEASE DATE: 8 July 1997

	-Uses correct ordering of PROC data.

	-Increases the differentiation between tones,
	 just a smidgion.

	-Catches a "Once In A Blue Moon" condition.
	   Under various circumstances rounding error
	   results in a pixel count of 55 or 53.
	   To prevent the 55 count from writing one
	   pixel into the edge of the frame, wmload
	   now catches these occurrences and corrects
	   for them.

VERSION: 0.9.0
RELEASE DATE: 6 July 1997

	-Fixed the grayscale problem that occurred
	 whenever the "-shape" argument was used.

	-Implemented the "-led" argument...
	 ...the last release had the argument,
	 however it wasn't implemented...
	 ...ie: it did nothing.
	 Called without the "-led" argument, wmload
	 uses it's default color "LightSeaGreen"
	 [which is the same as the asclock readout].
	 Called with the argument, it uses the
	 named color. If the default color is
	 unavailable, or the named color is invalid,
	 wmload simply uses the 3 green tones
	 found in the "back.xpm" pixmap.

	-Added a "-ver" argument...
	 When used, it prints the current version
	 on stdout. If it is called alone with no
	 other arguments, wmload exits after
	 printing its' version. Called with other
	 arguments... wmload prints its' version
	 and continues as normal.

	-Trapped bad arguments that don't start
	 with "-".

	-Cleaned up the code a bit.

	-Removed unnecessary files from the
	 distribution. <kept README's though>

NOTE:
	This is a load monitor which is designed
	to work with the PROC filesystem. Generally
	all Linux systems come with the PROC fs.
	If you're using a different Unix and it
	doesn't have the PROC fs, first see if
	there is one available... otherwise this
	monitor won't work!
	Work is currently underway to produce a
	more `portable'	wmload that Solaris/Sun/HP etc.
	users can also enjoy.

INSTALL:
	1. Check the Imakefile to see if all the
	   LIBS are ok for your system.
	   ALSO, check DESTDIR and BINDIR; as they
	   are now, a `make install' will put the
	   wmload binary in /usr/local/bin.
	2. `xmkmf'
	3. `make'
	4. `make install'
	5. Enjoy!!!! (;-)

SUGGESTED INVOCATION (for WindowMaker!):
	`wmload -shape -withdrawn &'

	OR for a different graph color:
	`wmload -led ??? -shape -withdrawn &'
	...replace "???" with a color name
	eg. green, red, orange, yellow, orchid, purple....
	any of your systems standard X color symbols.

SUGGESTED INVOCATION (for AfterStep):
	To load wmload in Wharf, add a line in .steprc:
*Wharf wmload nil MaxSwallow "wmload" wmload -led green -shape &
	...or to run it as a normal app: wmload -led "???" &
	NOTE: AfterStep doesn't require the "-withdrawn" option.

AVAILABILITY:
	The latest release should be available from:
		ftp://afterstep.foo.net/pub/apps/wmload/
		http://www.bc1.com/users/rland/

TODO LIST:
	-Implement alternative `load' algorithms?

LIABILITY & USABILITY:
	As usual, this software is bound by the
	GNU public license. You can use it however
	you see fit, as long as all the README's
	accompany any copy/version of it.
	THE KIND SOLES WHO HAVE WRITTEN/CONTRIBUTED
	TO THIS SOFTWARE, IN NO WAY ACCEPT LIABILITY
	OR ANY RESPONSIBILITY FOR THE USE OF, OR FOR
	ANY CONSEQUENCES RESULTING FROM THE USE OF
	THIS SOFTWARE.
	...that having been said, I think you'll
	like this new version and shouldn't have
	problems with it. Happy load monitoring!

FEEDBACK etc:
	Maintainer of the current version...
	Ryan Land, rland@bc1.com



                     ---<o>---



the contents of the initial WM patch and original
asload README's now follow...

>================================================<
wmload - WindowMaker performance monitor
adapted from asload by Nic Bernstein
==================================================
	added withdrawn option, added WM hints.
	changed trace color


original README contents follow...

>================================================<
asload - afterstep performance monitor
the best perfmonitor for the best X-windowmanager!
==================================================

RELEASE 1
      30th November 1996
      by Beat Christen, bchriste@iiic.ethz.ch 


VERSION 0.1


AVAILABILITY
     the latest release should be available from

     ftp://sunsite.unc.edu/pub/Linux/X11/xutils/asload.tgz
     http://rif3.ethz.ch:1313/spiff/asload/asload.tgz

INSTALL
     1. Check in the Imakefile if all LIBS are ok for your system.
     2. `make` (Send me the output if this fails)


TODO 
    write a todo list.

FEEDBACK
    I prefer uuencoded mail.
    You can register this software at
      http://rif3.ethz.ch:1313/spiff/asload/register.html

AUTHOR
    Beat Christen

CONTRIBUTORS

CHANGES
    28Nov96  First Version for Linux /proc

END OF FILE