~ubuntu-branches/ubuntu/karmic/wmcpuload/karmic

« back to all changes in this revision

Viewing changes to README

  • Committer: Bazaar Package Importer
  • Author(s): Christian Aichinger
  • Date: 2005-02-13 18:42:41 UTC
  • mfrom: (2.1.1 warty)
  • Revision ID: james.westby@ubuntu.com-20050213184241-yk2o743d8rkp23t9
Tags: 1.0.1-2
* New Maintainer
* Added proper Linux 2.6 support, thanks to Peter Colberg for the patch.
  (Closes: #238684)
* debian/control: Standards-Version to 3.6.1.1

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
$Id: README,v 1.4 2003/01/31 17:53:52 sch Exp $
 
2
 
1
3
WMCPULoad - A dockapp to monitor CPU usage
2
4
 
3
5
General Information
11
13
the mouse button over the application. If the CPU usage hits a certain
12
14
threshold, an alarm-mode will alert you by turning back-light on.
13
15
 
14
 
It runs under GNU/Linux / FreeBSD / OpenBSD / Solaris / Cygwin.
 
16
It runs on GNU/Linux / FreeBSD / OpenBSD / NetBSD / BSDi / Solaris / Cygwin /
 
17
IRIX / Darwin .
15
18
 
16
19
Installation
17
20
============
20
23
 
21
24
Copyright
22
25
=========
23
 
GPL applies all portions of the code I wrote. Please see COPYING file.
 
26
- GPL applies all portions of the code I wrote. Please see COPYING file.
24
27
 
25
28
 
26
29
Usage
27
30
=====
28
31
$ wmcpuload [OPTIONS]
29
32
 -d,  --display <string>        display to use
 
33
 -t,  --title <string>          application title name
30
34
 -bl, --backlight               turn on back-light
31
35
 -lc, --light-color <color>     back-light color (rgb:6E/C6/3B is default)
32
36
 -i,  --interval <number>       number of secs between updates (1 is default)
33
 
 -c,  --cpu <number>            CPU number (0, 1, ...)
 
37
 -c,  --cpu <number>            which CPU is monitored (0, 1, ...)
34
38
 -n,  --ignore-nice             ignore a nice value
35
39
 -p,  --ignore-proc <name><...> ignore all processes specified by command name
36
40
 -h,  --help                    show this help text and exit
37
41
 -v,  --version                 show program version and exit
38
 
 -w,  --windowed                runs the application in windowed mode
 
42
 -w,  --windowed                run the application in windowed mode
 
43
 -wp, --windowed-withpanel      run the application in windowed mode
 
44
                                with background panel
39
45
 -bw, --broken-wm               activate broken window manager fix
40
46
 -a,  --alarm <percentage>      activate alarm mode. <percentage> is threshold
41
 
                                of percentage from 0 to 100.(90 is default)
 
47
                                of percentage from 0 to 100 (90 is default)
42
48
 
43
49
NOTES:
44
 
- '-n, --ignore-nice' option is activated under GNU/Linux / FreeBSD / OpenBSD.
 
50
- '-n, --ignore-nice' option is activated under GNU/Linux / {Free,Open,Net}BSD.
45
51
- '-p, --ignore-proc' option is activated under GNU/Linux.
46
 
- '-c,  --cpu'        option is activated under GNU/Linux.
 
52
- '-c,  --cpu'        option is activated under GNU/Linux / IRIX.
47
53
 
48
54
 
49
55
For AfterStep users
50
56
===================
51
 
Add below entry to your Wharf
 
57
Add this line to your ~/GNUstep/Library/AfterStep/wharf:
52
58
 
53
59
  *Wharf wmcpuload - Swallow "wmcpuload" wmcpuload -w &
54
60
 
55
61
 
 
62
For GNOME users
 
63
===============
 
64
If you want to run wmcpuload as swallowed application inside the GNOME panel,
 
65
open 'Create swallow Applet' dialog and enter the values as below.
 
66
 
 
67
  1. Title application to swallow: <title name> - specified with '-t' option
 
68
  2. Command (optional): wmcpuload -w -t <title name>
 
69
  3. width: 62
 
70
  4. height: 62
 
71
 
 
72
NOTE: GNOME2 does not support the swallowed application.
 
73
 
 
74
 
56
75
For Enlightenment users
57
76
=======================
58
77
Use '-bw, --broken-wm' option.
59
78
 
60
79
 
 
80
For Golem users
 
81
===============
 
82
Add following entry to your ~/.golem/plugins/pier/rc
 
83
 
 
84
  param "item" "dock" {
 
85
          param "cmd" "exec wmcpuload";
 
86
          param "class" "wmcpuload.DockApp";
 
87
  }
 
88
 
 
89
 
61
90
Frequently Asked Questions
62
91
==========================
63
92
 
64
 
Q) What window managers support the dockapp?
 
93
Q) Which window managers do support dockapps?
65
94
A) - Window Maker  http://www.windowmaker.org/
66
95
   - AfterStep     http://www.afterstep.org/
67
 
   - Blackbox      http://blackbox.alug.org/
 
96
   - Blackbox      http://blackboxwm.sourceforge.net/
68
97
   - Enlightenment http://www.enlightenment.org/
69
98
   - Fluxbox       http://fluxbox.sourceforge.net/
 
99
   - Waimea        http://waimea.sourceforge.net/
70
100
   - PWM           http://www.students.tut.fi/~tuomov/pwm/
 
101
   - Golem         http://golem.sourceforge.net/
71
102
 
72
103
Q) Can I set the initial size?
73
104
A) No. As far as I know, there is no dockapp which can be set the size.
79
110
   bottom of my TODO list, since I do not have an SMP system.
80
111
   -----------------------------------------------------------------------------
81
112
   NOTE: WMCPULoad has '-c, --cpu' option since version 0.8.0. but it only works
82
 
         under GNU/Linux. (Thanks to Laurent Raufaste for beta test)
 
113
         on GNU/Linux. (Thanks to Laurent Raufaste for beta test)
83
114
   -----------------------------------------------------------------------------
84
115
 
85
116
Q) Why is kamp-idled spending many CPU time on my GNU/Linux box?
92
123
   CONFIG_APM_CPU_IDLE defined in your kernel build than by not."
93
124
                                              -- from debian-devel mailing lists
94
125
 
95
 
   '-p, --ignore-proc' option will help you. (e.g.) wmcpuload -p kapm-idled
 
126
   '-p, --ignore-proc' option will help you. (e.g., wmcpuload -p kapm-idled)
96
127
 
97
128
 
98
129
Bug reports
102
133
 
103
134
URL
104
135
===
105
 
http://www.sh.rim.or.jp/~ssato/dockapp/index.shtml#wmcpuload
 
136
http://www.sh.rim.or.jp/~ssato/dockapp/#wmcpuload
106
137