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
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
|
<html><head><title>S-Lang system monitor</title>
</head>
<body>
<hr>
<h1>S-Lang system monitor</h1>
<h2>Krzysztof Luks</h2>
<h2>02 Septembet 2001</h2>
<h1>Table of Contents </h1><p></p>
<dl><p>
<dt><h2><a href="slmon.html#l1">1: Overview</a></h2>
<dt><h2><a href="slmon.html#l2">2: Technical info</a></h2>
<dt><h2><a href="slmon.html#l3">3: Invoking</a></h2>
<dt><h2><a href="slmon.html#l4">4: Usage</a></h2>
<dt><h2><a href="slmon.html#l5">5: Configuration files</a></h2>
<dt><h2><a href="slmon.html#l6">6: Problems</a></h2>
<dt><h2><a href="slmon.html#l7">7: Thanks</a></h2>
<dt><h2><a href="slmon.html#l8">8: Download</a></h2>
<dt><h2><a href="slmon.html#l9">9: Changes</a></h2>
<dt><h2><a href="slmon.html#l10">10: Copying</a></h2>
<p><hr><p><br>
<p><a name="l1"></a>
<h2>1: Overview</h2>
<a name="description.yo"></a>
<strong>SLmon</strong> is a tool for monitoring system's performance. It displays results
using nice and (hopefully) readable text-based UI. Currently monitored
are:
<p><ul>
<li > CPU load (SMP is supported)
<li > network interfaces
<li > memory (including swap)
<li > uptime, date and time
<li > number of logged in users
<li > mounted filesystems
<li > processes
</ul>
<p>
<p><a name="l2"></a>
<h2>2: Technical info</h2>
<a name="techinfo.yo"></a>
<strong>SLmon</strong> uses <em>glibtop</em> version >= 2 and <em>libslang</em> version >= 1.2.2
(this version however has a bug that makes it impossible to write a
character in lower right corner, but otherwise it works okay).
<p>Starting with 0.5.13 <em>Glib</em> library is needed.
<p>
<p><a name="l3"></a>
<h2>3: Invoking</h2>
<a name="options.yo"></a>
<dl>
<p></p><dt><strong>-v, --version</strong><dd> Display version and copying and exit
<p></p><dt><strong>-h, --help</strong><dd> Display brief usage information
<p></p><dt><strong>-f, --fs-unit=[kmg]</strong><dd> Specify filesystem usage unit, where: b=bytes,
k=kbytes, m=mbytes, g=gbytes
<p></p><dt><strong>-m, --mem-unit=[bkmg]</strong><dd> Specify memory usage unit, where: b=bytes,
k=kbytes, m=mbytes, g=gbytes
<p></p><dt><strong>-n, --net-unit=[bkmg]</strong><dd> Specify network traffic unit, where: b=bytes,
k=kbytes, m=mbytes, g=gbytes
<p></p><dt><strong>-d, --mode=[mpnh]</strong><dd> Start in mode 'M' where: m=main, p=process, n=network, h=histogram
<p></p><dt><strong>-u, --update=<seconds></strong><dd> Specify update interval in seconds
</dl>
<p><a name="l4"></a>
<h2>4: Usage</h2>
<a name="keys.yo"></a>
All modes:
<dl>
<p></p><dt><strong>q</strong><dd> Quit
<p></p><dt><strong>m</strong><dd> Main mode.
<p></p><dt><strong>p</strong><dd> Processes mode.
<p></p><dt><strong>n</strong><dd> Network mode.
<p></p><dt><strong>h</strong><dd> Histogram mode.
<p></p><dt><strong>?</strong><dd> Help screen.
</dl>
<p>Main mode:
<dl>
<p></p><dt><strong>u</strong><dd> Change memory usage unit.
<p></p><dt><strong>U</strong><dd> Change filesystems usage unit.
<p></p><dt><strong>-</strong><dd> Increace gauge length.
<p></p><dt><strong>=</strong><dd> Decreace gauge length.
<p></p><dt><strong>up</strong><dd> Scroll fileststems up.
<p></p><dt><strong>down</strong><dd> Scroll fileststems down.
</dl>
<p>Histogram mode:
<dl>
<p></p><dt><strong>h</strong><dd> Cycle through histogram modes.
<p></p><dt><strong>-</strong><dd> Decrease horizontal size of the graph.
<p></p><dt><strong>=</strong><dd> Increase horizontal size of the graph.
<p></p><dt><strong>_</strong><dd> Decrease vertical size of the graph.
<p></p><dt><strong>+</strong><dd> Increase vertical size of the graph.
</dl>
<p>Network mode:
<dl>
<p></p><dt><strong>u</strong><dd> Change network traffic unit.
<p></p><dt><strong>n</strong><dd> Add new interface.
<p></p><dt><strong>d</strong><dd> Delete existing interface.
<p></p><dt><strong>up</strong><dd> Scroll list up.
<p></p><dt><strong>down</strong><dd> Scroll list down.
</dl>
<p>Processes mode:
<dl>
<p></p><dt><strong>k</strong><dd> Send SIGTERM (15) to highlighted process. USE WITH CARE!
<p></p><dt><strong>K</strong><dd> Send specified signal to highlighted process. USE WITH CARE!
<p></p><dt><strong>a</strong><dd> Sort processes by pid descending.
<p></p><dt><strong>A</strong><dd> Sort processes by pid ascending.
<p></p><dt><strong>s</strong><dd> Sort processes by cpu percentage descending.
<p></p><dt><strong>S</strong><dd> Sort processes by cpu percentage ascending.
<p></p><dt><strong>d</strong><dd> Sort processes by memory percentage descending.
<p></p><dt><strong>D</strong><dd> Sort processes by memory percentage ascending.
<p></p><dt><strong>f</strong><dd> Sort processes by user name descending.
<p></p><dt><strong>F</strong><dd> Sort processes by user name ascending.
<p></p><dt><strong>up</strong><dd> Scroll list up.
<p></p><dt><strong>down</strong><dd> Scroll list down.
<p></p><dt><strong>page up</strong><dd> Scroll list up by 10.
<p></p><dt><strong>page down</strong><dd> Scroll list down by 10.
</dl>
<p>
<p><a name="l5"></a>
<h2>5: Configuration files</h2>
<a name="dotfile.yo"></a>
SLmon looks for the configuration file in the following locations:
<dl>
<p></p><dt><strong>/etc/slmonrc</strong><dd>
<p></p><dt><strong>/usr/local/etc/slmonrc</strong><dd> if the previous one fails
<p></p><dt><strong>$HOME/.slmonrc</strong><dd>
</dl>
<p>Options can be specified in the form of pairs: <em><key> = <value></em>. Lines
beginning with '#' are treated as comments (note: all leading whitespaces are
stripped). All subsequent definitions of a certain option overwrite previous
declarations except for the <em>net_dev</em> option.
<p>Available options (more to come :)):
<p><dl>
<p></p><dt><strong>mode</strong><dd> Start certain mode: m=main, p=process, n=network, h=histogram.
<p></p><dt><strong>mem_unit</strong><dd> Specify memory usage unit [bkm].
<p></p><dt><strong>fs_unit</strong><dd> Specify filesystem usage unit [kmg].
<p></p><dt><strong>net_unit</strong><dd> Specify network traffic unit [bkmg].
<p></p><dt><strong>net_dev</strong><dd> Add a network interface to list of monitored interfaces.
<p></p><dt><strong>update_time</strong><dd> Specify update interval in seconds.
</dl>
<p>
<p><a name="l6"></a>
<h2>6: Problems</h2>
<a name="bugs.yo"></a>
<ol>
<li> slmon uses too much cpu time in process mode
</ol>
<p>Please send all bugreports to <a href="mailto:m00se@iq.pl"><em>m00se@iq.pl</em></a>.
<p>
<p><a name="l7"></a>
<h2>7: Thanks</h2>
<a name="thanks.yo"></a>
The author wishes to thank following people for help in developing <strong>SLmon</strong>:
<p><dl>
<p></p><dt><strong>Martijn Pieterse and Antoine Nulle</strong><dd> authors of the wmmon.app.
<p></p><dt><strong>Piotr 'xlizee' Kazmierczak</strong><dd> betatesting, suggestions and screenshot.
<p></p><dt><strong>Marcin 'dombal' Dabrowski</strong><dd> betatesting.
<p></p><dt><strong>Dan Bilik</strong><dd> patch fixing incorrect count of AMD K6 CPUs and some suggestions.
<p></p><dt><strong>Kacper Pleszkun</strong><dd> betatesting, bugreports.
<p></p><dt><strong>Alexander Reelsen</strong><dd> Debian Potato packages.
<p></p><dt><strong>Alan Ford</strong><dd> Debian Woody packages.
<p></p><dt><strong>Edward Betts</strong><dd> bugreports.
<p></p><dt><strong>Gabor Z. Papp</strong><dd> bugreports.
<p></p><dt><strong>Mario Vanoni</strong><dd> suggestions and lots of bugreports.
<p></p><dt><strong>Tim Powers</strong><dd> RPM packages.
</dl>
<p><a name="l8"></a>
<h2>8: Download</h2>
<a name="download.yo"></a>
SLmon home page <a href="http://slmon.sourceforge.net">http://slmon.sourceforge.net</a>
<p>Download:
<dl>
<p></p><dt><strong>Libgtop</strong><dd> <a href="ftp://ftp.gnome.org/pub/GNOME/stable/sources/libgtop/">ftp://ftp.gnome.org/pub/GNOME/stable/sources/libgtop/</a>
<p></p><dt><strong>S-Lang</strong><dd> <a href="ftp://space.mit.edu/pub/davis/slang/">ftp://space.mit.edu/pub/davis/slang/</a>
</dl>
<p><a name="l9"></a>
<h2>9: Changes</h2>
<a name="changes"></a>
<dl>
<p></p><dt><strong>0.5.13 - 24 06 2004</strong><dd> Updated to compile with latest libgtop, value
overflows in network mode fixes, other cleanups (patches by Benoit Dejean).
Glib is now required.
<p><p></p><dt><strong>0.5.12 - 01 10 2002</strong><dd> Configure fixes (should compile cleanly on systems
without GNOME). Use inet_ntoa() when inet_ntop() is unavailable. Documentation
updates.
<p><p></p><dt><strong>0.5.11 - 05 07 2002</strong><dd> Fixed detection of LibGTop2, some code cleanups.
<p><p></p><dt><strong>0.5.10 - 03 07 2002</strong><dd> Added (experimental) display of network transmission
speed per second. Fixed small display bug.
<p><p></p><dt><strong>0.5.9 - 01 04 2002</strong><dd> Configurable update time, scrolling in network mode,
fixed gnome-terminal transparency problems, fixes in configure.in.
<p><p></p><dt><strong>0.5.8 - 29 11 2001</strong><dd> Updated help screen. Only interfaces which are
up are displayed, added flags to information about interfaces.
<p><p></p><dt><strong>0.5.7 - 28 11 2001</strong><dd> Bugfixes: incorrect URL in documentation, disapearing
status lines, duplicate network interfaces.
<p><p></p><dt><strong>0.5.6 - 12 11 2001</strong><dd> It is now possible to sort processes by pid, pcpu,
pmem and username both ascending and descending. It's also possible to
send an arbitrary signal to specified process.
<p><p></p><dt><strong>0.5.5 - 05 11 2001</strong><dd> Added online help, fixed a bug where slmon would
crash when there were no network interfaces specified. New keyboard
mapping for changing modes.
<p><p></p><dt><strong>0.5.4 - 25 10 2001</strong><dd> Bugfixes in network traffic display. Added sample
slmonrc to distribution. New format of command line options.
<p><p></p><dt><strong>0.5.3 - 23 10 2001</strong><dd> Updated documentation, new commandline switches.
<p><p></p><dt><strong>0.5.2 - 22 10 2001</strong><dd> Added network interface monitoring mode and support
for configuration files.
<p><p></p><dt><strong>0.5.1 - 09 09 2001</strong><dd> %CPU and %MEM display works now, reintroduced long
options, support for Linux /proc filesystem has been discontinued.
<p><p></p><dt><strong>0.5.0 - 02 09 2001</strong><dd> Added ability to monitor running processes and mounted
filesystems , switched from popt to getopt, keyboard handling was rewritten,
minor bugfixes and code cleanups.
<p><p></p><dt><strong>0.4.1 - 21 02 2001</strong><dd> Fixed several typos, added basic debian package
support.
<p><p></p><dt><strong>0.4.0 - 20 11 2000</strong><dd> One silly spelling mistake has been fixed (thanks to
Tim Powers). There are no longer compilation errors when popt.h is not
present. On gauge display changed %03d%% to %3d%% i.e. 004% will be
displayed as 4%.
<p><p></p><dt><strong>0.3.7 - 04 11 2000</strong><dd> SLmon can now use getopt instead of popt for parsing
command line options. A bug in options parsing has been fixed. Texinfo
documentation is no longer available.
<p><p></p><dt><strong>0.3.6 - 02 11 2000</strong><dd> Bug in cpu counting have been fixed.
<p><p></p><dt><strong>0.3.5 - 29 10 2000</strong><dd> Added posibility to compile slmon on Linux without
libgtop. Documentation updates.
<p><p></p><dt><strong>0.3.4 - 21 10 2000</strong><dd> CPU naming starts now from zero, on machines with one
CPU only 'total cpu usage' is displayed. Fixed display error on machines with
more than 1GB of memory.
<p><p></p><dt><strong>0.3.3 - 12 10 2000</strong><dd> Minor bugfixes and cleanups, option to turn off bold
on monochrome terminals.
<p><p></p><dt><strong>0.3.2 - 08 10 2000</strong><dd> Improvements to configure script, incereased compile
time configureability. Minor code cleanups.
<p><p></p><dt><strong>0.3.1 - 18 09 2000</strong><dd> Major rewrite. Due to compatibility problems support
for libproc has been discontiniued. SLmon now uses glibtop for gathering
system specific information and should run on any UN*X system that has glibtop
installed.
<p><p></p><dt><strong>0.3.0 - 11 07 2000</strong><dd> Many changes: SLmon now uses libproc and popt, added
commandline options and customizable colors (from commandline only for now).
Added possibility to make command aliases. Added autoconf and automake
support.
<p><p></p><dt><strong>0.2.5 - 26 04 2000</strong><dd> Bugfix release. Slmon now looks much beter on
monochrome terminals, also Makefile has been optimized.
<p><p></p><dt><strong>0.2.4 - 15 04 2000</strong><dd> SLmon won't crash when it can't access /proc, changed
the histogram mode screen layout a bit. It it now possible to draw histogram
for specified processor or overall usage. Also number of logged in users is
shown on the status line. Fixed a bug in RH patch.
<p><p></p><dt><strong>0.2.3 - 10 04 2000</strong><dd> Added load average, OS and machine information.
<p><p></p><dt><strong>0.2.2 - 06 04 2000</strong><dd> Fixed bug in CPU counting procedure and another one
in free swap display. Added days to uptime display.
<p><p></p><dt><strong>0.2.1 - 01 04 2000</strong><dd> Added memory load, all basic signals should be now
handled properly.
<p><p></p><dt><strong>0.2.0 - 26 03 2000</strong><dd> Gauge color scheme changed. Runtime mode switching
works now.
<p><p></p><dt><strong>0.1.9 - 20 03 2000</strong><dd> Added new graph mode - color gauge.
<p><p></p><dt><strong>0.1.8 - 11 03 2000</strong><dd> Added SIGWINCH handling, hope it'll work :) also
bottom status line has changed a bit.
<p><p></p><dt><strong>0.1.7 - 27 02 2000</strong><dd> The program now correctly recognizes terminal size.
<p><p></p><dt><strong>0.1.6 - 26 02 2000</strong><dd> Added graph, keyboard support, graph parameters
are hardcoded.
<p><p></p><dt><strong>0.1.5 - 25 02 2000</strong><dd> Multiple CPUs, status lines, date, time, uptime,
hostname, processsor name.
<p><p></p><dt><strong>0.1.0 - 24 02 2000</strong><dd> Initial version, one cpu.
</dl>
<p><a name="l10"></a>
<h2>10: Copying</h2>
<a name="copying.yo"></a>
Copyright (C) 2000, 2001, 2002 Krzysztof Luks <m00se@iq.pl>.
<p>This program is free software; you can redistribute it
and/or modify it under the terms of the GNU General Public
License as published by the Free Software Foundation;
either version 2 of the License, or (at your option) any
later version.
<p>This program is distributed in the hope that it will be
useful, but WITHOUT ANY WARRANTY; without even the implied
warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
PURPOSE. See the GNU General Public License for more
details.
<p>You should have received a copy of the GNU General Public
License along with this program; if not, write to the Free
Software Foundation, Inc., 675 Mass Ave, Cambridge, MA
02139, USA.
<p>
<p></body>
</html>
|
