WMMemMon - A dockapp to monitor memory/swap usages

General Information
===================
WMMemMon is a program to monitor memory/swap usages. It is a dockapp that is
supported by X window managers such as Window Maker, AfterStep, BlackBox, and
Enlightenment.

The current memory usage is displaied as the outside pie-slices.  The swap usage
is represented by the inside slices. It has an LCD look-alike user interface.
The back-light may be turned on/off by clicking the mouse button over the
appliacation. If the usage hits a certain threshold, an alarm-mode will alert
you by turning back-light on.

It runs under GNU/Linux / FreeBSD / OpenBSD / Solaris


Installation
============
See the file 'INSTALL' for instructions.


Copyright
=========
GPL applies all portions of the code I wrote. Please see COPYING file.


Usage
=====
$ wmmemmon [OPTIONS]
 -d,  --display <string>       display to use
 -bl, --backlight              turns on back-light
 -lc, --light-color <color>    back-light color (rgb:6E/C6/3B is default)
 -i,  --interval <number>      number of secs between updates (1 is default)
 -b,  --ignore-buffers         ignore buffers
 -c,  --ignore-cached          ignore cached pages
 -wr, --ignore-wired           ignore wired pages
 -h,  --help                   show this help text and exit
 -v,  --version                show program version and exit
 -w,  --windowed               runs the application in windowed mode
 -bw, --broken-wm              activate broken window manager fix
 -am, --alarm-mem <percentage> activate alarm mode. <percentage> is threshold
                               of percentage from 0 to 100.(90 is default)
 -as, --alarm-swap<percentage> activate alarm mode. <percentage> is threshold
                               of percentage from 0 to 100.(50 is default)

NOTES:
- '-b,  --ignore-buffers' option is activated under GNU/Linux
- '-c,  --ignore-cached'  option is activated under GNU/Linux / FreeBSD
- '-wr, --ignore-wired'   option is activated under FreeBSD

GNU/Linux(/proc/meminfo):
|<------------------------ used --------------------------->|<---- free ---->|
|                  |<----- buffers ----->|<----- cache ---->|                |
|                  |                     |                  |                |
|<============================== T O T A L =================================>|

FreeBSD(kvm):
|<------------------------ used --------------------------->|<---- free ---->|
|<-- active -->|<-- inactive -->|<-- wired -->|<-- cache -->|                |
|              |                |             |             |                |
|<============================== T O T A L =================================>|

 -> More Information: FreeBSD Developers' Handbook
 http://www.freebsd.org/doc/en_US.ISO8859-1/books/developers-handbook/index.html
 http://www.freebsd.org/doc/en_US.ISO8859-1/books/developers-handbook/vm.html

OpenBSD(sysctl):
|<------------------------ used --------------------------->|<---- free ---->|
|                                                           |                |
|                                                           |                |
|<============================== T O T A L =================================>|

Solaris:
< not written yet >


For Afterstep Users
===================
Add below entry to your Wharf

 *Wharf wmmemmon - Swallow "wmmemmon" wmmemmon -w &


For Enlightenment users
=======================
Use '-bw, --broken-wm' option.


Frequently Asked Questions
==========================

Q) What window managers support the dockapp?
A) - Window Maker  http://www.windowmaker.org/
   - AfterStep     http://www.afterstep.org/
   - Blackbox      http://blackbox.alug.org/
   - Enlightenment http://www.enlightenment.org/
   - Fluxbox       http://fluxbox.sourceforge.net/
   - PWM           http://www.students.tut.fi/~tuomov/pwm/

Q) Can I set the initial size?
A) No. As far as I know, there is no dockapp which can be set the size.


Bug reports
===========
Please send e-mail to ssato@sh.rim.or.jp.


URL
===
http://www.sh.rim.or.jp/~ssato/dockapp/index.shtml#wmmemmon
