138 lines
4.9 KiB
Plaintext
138 lines
4.9 KiB
Plaintext
$Id: README,v 1.6 2003-06-29 14:34:32 sch Exp $
|
|
|
|
WMCPULoad - A dockapp to monitor CPU usage
|
|
|
|
General Information
|
|
===================
|
|
WMCPULoad is a program to monitor CPU usage. It is a dockapp that is supported
|
|
by X window managers such as Window Maker, AfterStep, BlackBox, and
|
|
Enlightenment.
|
|
|
|
It displays the current usage, expressed as a percentile and a chart, and has an
|
|
LCD look-alike user interface. The back-light may be turned on/off by clicking
|
|
the mouse button over the application. If the CPU usage hits a certain
|
|
threshold, an alarm-mode will alert you by turning back-light on.
|
|
|
|
It runs on GNU/Linux / FreeBSD / OpenBSD / NetBSD / BSDi / Solaris / Cygwin /
|
|
IRIX / Darwin .
|
|
|
|
Installation
|
|
============
|
|
See the file 'INSTALL' for instructions.
|
|
|
|
|
|
Copyright
|
|
=========
|
|
- GPL applies all portions of the code I wrote. Please see COPYING file.
|
|
|
|
|
|
Usage
|
|
=====
|
|
$ wmcpuload [OPTIONS]
|
|
-d, --display <string> display to use
|
|
-t, --title <string> application title name
|
|
-bl, --backlight turn 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)
|
|
-c, --cpu <number> which CPU is monitored (0, 1, ...)
|
|
-n, --ignore-nice ignore a nice value
|
|
-p, --ignore-proc <name><...> ignore all processes specified by command name
|
|
-h, --help show this help text and exit
|
|
-v, --version show program version and exit
|
|
-w, --windowed run the application in windowed mode
|
|
-wp, --windowed-withpanel run the application in windowed mode
|
|
with background panel
|
|
-bw, --broken-wm activate broken window manager fix
|
|
-a, --alarm <percentage> activate alarm mode. <percentage> is threshold
|
|
of percentage from 0 to 100 (90 is default)
|
|
|
|
NOTES:
|
|
- '-n, --ignore-nice' option is activated under GNU/Linux / {Free,Open,Net}BSD.
|
|
- '-p, --ignore-proc' option is activated under GNU/Linux.
|
|
- '-c, --cpu' option is activated under GNU/Linux / IRIX.
|
|
|
|
|
|
For AfterStep users
|
|
===================
|
|
Add this line to your ~/GNUstep/Library/AfterStep/wharf:
|
|
|
|
*Wharf wmcpuload - Swallow "wmcpuload" wmcpuload -w &
|
|
|
|
|
|
For GNOME users
|
|
===============
|
|
If you want to run wmcpuload as swallowed application inside the GNOME panel,
|
|
open 'Create swallow Applet' dialog and enter the values as below.
|
|
|
|
1. Title application to swallow: <title name> - specified with '-t' option
|
|
2. Command (optional): wmcpuload -w -t <title name>
|
|
3. width: 62
|
|
4. height: 62
|
|
|
|
NOTE: GNOME2 does not support the swallowed application.
|
|
|
|
|
|
For Enlightenment users
|
|
=======================
|
|
Use '-bw, --broken-wm' option.
|
|
|
|
|
|
For Golem users
|
|
===============
|
|
Add following entry to your ~/.golem/plugins/pier/rc
|
|
|
|
param "item" "dock" {
|
|
param "cmd" "exec wmcpuload";
|
|
param "class" "wmcpuload.DockApp";
|
|
}
|
|
|
|
|
|
Frequently Asked Questions
|
|
==========================
|
|
|
|
Q) Which window managers do support dockapps?
|
|
A) - Window Maker http://www.windowmaker.org/
|
|
- AfterStep http://www.afterstep.org/
|
|
- Blackbox http://blackboxwm.sourceforge.net/
|
|
- Enlightenment http://www.enlightenment.org/
|
|
- Fluxbox http://fluxbox.sourceforge.net/
|
|
- Waimea http://waimea.sourceforge.net/
|
|
- PWM http://www.students.tut.fi/~tuomov/pwm/
|
|
- Golem http://golem.sourceforge.net/
|
|
|
|
Q) Can I set the initial size?
|
|
A) No. As far as I know, there is no dockapp which can be set the size.
|
|
|
|
Q) (How) Does WMCPULoad support SMP system?
|
|
A) WMCPULoad will probably work fine on an SMP system. However, it only displays
|
|
the usage statistics for the all CPUs. I may add the new command line option
|
|
(e.g. '--cpu <number>') to specify the CPU number. but this feature is the
|
|
bottom of my TODO list, since I do not have an SMP system.
|
|
-----------------------------------------------------------------------------
|
|
NOTE: WMCPULoad has '-c, --cpu' option since version 0.8.0. but it only works
|
|
on GNU/Linux. (Thanks to Laurent Raufaste for beta test)
|
|
-----------------------------------------------------------------------------
|
|
|
|
Q) Why is kamp-idled spending many CPU time on my GNU/Linux box?
|
|
A) kapm-idled executes HLT instructions to save power.
|
|
|
|
Stephen Rothwell (GNU/Linux APM maintainer) said:
|
|
"kapm-idled may do quite a lot more than just execute HLT instructions
|
|
depending on how smart the BIOS is about saving power. Unfortunately, some
|
|
BIOSs are pretty dumb and in some cases more power is consumed by having
|
|
CONFIG_APM_CPU_IDLE defined in your kernel build than by not."
|
|
-- from debian-devel mailing lists
|
|
|
|
'-p, --ignore-proc' option will help you. (e.g., wmcpuload -p kapm-idled)
|
|
|
|
|
|
Bug reports
|
|
===========
|
|
Please send e-mail to ssato@sh.rim.or.jp.
|
|
|
|
|
|
URL
|
|
===
|
|
http://www.sh.rim.or.jp/~ssato/dockapp/#wmcpuload
|
|
|