File: README

package info (click to toggle)
loadmeter 1.0-6
  • links: PTS
  • area: main
  • in suites: hamm, slink
  • size: 144 kB
  • ctags: 127
  • sloc: ansic: 1,084; makefile: 59; sh: 2
file content (102 lines) | stat: -rw-r--r-- 4,154 bytes parent folder | download
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
Loadmeter v1.0
==============

This is a useful little system monitoring utility I've hacked up to keep
track of various system stats. It monitors:

- Load average
- Uptime
- Disk usage
- Memory usage

In its normal state it displays a window with a coloured bar graph
showing the load average for the past minute. This is also shown
in digits at the top of the window. both are updated every second. A red 
'notch' marks the maximum load since it was started, and can be reset 
by pressing button2 or hidden with button3. The blue notch shows the 
5 minute load average.

By clicking on button1, a pop-up window appears showing the uptime,
the capacity of each filesystem, and memory/swap usage. More detailed
info on each filesystem is available by highlighting the corresponding
one. The way this window pops down is intentional, just to make it 
interesting. :)
Any filesystems with higher usage than specified by the -warn option (default
90%) are shown with a (default)green background.

Press Escape in the top level window to exit.

Loadmeter also has the ability to override window managers. Giving the
option '-override' causes the top-level window to have the
override_redirect bit set. This is useful for window managers that
insist upon decorating standard clients (eg Enlightenment, at
least up to DR0.9). If you've given this option, then you can
still resize and move the window. During moving and resizing, the 
cursor displays the geometry.

Ctrl-button1 lowers the window.
Ctrl-button2 raises and moves the window.
Ctrl-button3 raises and resizes the window.
A SIGUSR1 sent to the process will also raise the top level window.

There is also a '-parent' switch, which can be used to specify another
window (in decimal or hex form) to use as the parent for the toplevel 
one (default is the root). This is useful for banking several together 
inside another window for easy positioning, etc. The 'lower' function 
doesnt work if -parent is specified.  Also note that you can't use 
both -override and -parent at the same time.

Command-line options:

-disp <display>		Specify which X server to connect to
-geom <+x+y>		Specify position on the screen
-sync				Call sync() when checking disk usage
-numfont <font>		Use <font> for the load digits
-labelfont <font>	Use <font> for the hostname label
-popupfont <font>	Use <font> for the cursor and popup window
-popupbg <colour>	Use <colour> for the popup background
-popupfg <colour>	Use <colour> for the foreground of the popup
-warnbg <colour>	Use <colour> for the high disk usage warning colour
-meter <colour>		Use <colour> for the disk usage meter bar
-warn <pct>			Min percent capacity reqd to highlight a filesystem
-label <label>		Bargraph label to use instead of the hostname
-name <name>		Name of the app to present to the WM
-bh <blockheight>	Height of individual bargraph blocks (in pixels)
-override			Always override window manager
-parent <window>	Use <window> as the parent for the toplevel window.

These features are also available using Xresources. Eg you can have:

loadmeter*sync: True
loadmeter*label: load

loaded into the server database.


Features:

- Easy to read coloured bargraph display.
- Hostname displayed.
- Maximum load indicator.
- Uptime, memory and filesystem usage stats
- Low memory usage (around half that of xload) as it uses raw Xlib.
- Uses /proc to find stats (statfs() for fs usages) and avoids forking 
  sub processes.
- Efficient, both X11 network-wise (except stats pop-down :) and memory wise.
- Built-in resize and move functions.
- Can display itself within another window
- Takes advantage of the X resource database

Bugs (other features? :)

- If colours dont get allocated or files cant be opened, it'll probably
  crash. The reason for this is lack of checking, but this saves memory 
  and should succeed almost always anyway (unless /proc isn't mounted :).
- Don't bother asking me about versions for any OS apart from Linux. Getting
  this type of info on something such as Solaris requires root privileges, 
  and this I haven't got.


Check http://www.zip.com.au/~bb/linux/ for updates.

   Hack by Ben Buxton (bb@zip.com.au)