/usr/share/doc/slmon/slmon.html is in slmon 0.5.13-2.2build1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 | <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>
|