2a199f8b19
Previously, a green hint line was drawn on the CPU window for each multiple of 1. This meant as the load average approached 40 (the height of the window), the window would gradually fill up entirely with green. To get around this, we switch to a yellow hint line for each multiple of 10 once the load passes 10. And then a red hint line for each multiple of 100 once the load passes 100. This fixes Debian bug #894801, reported by Pedro Gimeno <debian.bts@personal.formauri.es>.
209 lines
4.7 KiB
Groff
209 lines
4.7 KiB
Groff
'\" t
|
|
.\" Man page for wmmon
|
|
.\" Copyright (c) 2003 Software in the Public Interest, Inc.
|
|
.\"
|
|
.\" 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.
|
|
.\"
|
|
.\" 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.
|
|
.\"
|
|
.\" 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., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
|
|
.\"
|
|
.TH wmmon 1 "May 1998" "WMMON 1.0b2"
|
|
|
|
.SH NAME
|
|
wmmon \- Window Maker dockapp for monitoring system information
|
|
|
|
.SH SYNOPSIS
|
|
|
|
.B wmmon
|
|
[
|
|
.I OPTION
|
|
]
|
|
|
|
.SH DESCRIPTION
|
|
|
|
.B WMMon
|
|
monitors the realtime CPU load as well as the average system load,
|
|
and gives you some nice additional features too. It is intended for
|
|
docking in Window Maker.
|
|
|
|
It currently provides:
|
|
|
|
.IP \(bu 4
|
|
a realtime CPU stress meter;
|
|
.IP \(bu
|
|
an auto-scaled average system load meter, like
|
|
.B xload
|
|
and
|
|
.BR wmavgload ;
|
|
.IP \(bu
|
|
hint lines change color as the system load increases.
|
|
.RS
|
|
.IP \(bu
|
|
green for multiples of 1
|
|
.IP \(bu
|
|
yellow for multiples of 10
|
|
.IP \(bu
|
|
red for multiples of 100
|
|
.RE
|
|
.IP \(bu
|
|
a realtime disk I/O stress meter;
|
|
.IP \(bu
|
|
auto-scaled disk I/O load meter;
|
|
.IP \(bu
|
|
realtime memory and swap usage meters;
|
|
.IP \(bu
|
|
a display for system uptime;
|
|
.IP \(bu
|
|
three user-defined commands to launch.
|
|
|
|
.SH OPTIONS
|
|
|
|
.TP
|
|
.BI \-display \ display
|
|
This option specifies the X server to contact; see
|
|
.IR X(7x) .
|
|
|
|
.TP
|
|
.BI \-geometry \ geometry
|
|
This option specifies the preferred position of clock; see
|
|
.IR X(7x) .
|
|
|
|
.TP
|
|
.BR \-l
|
|
Lock the mode, so that it cannot be cycled by clicking on the upper-left
|
|
widget. You can use this to open multiple copies of
|
|
.BR WMMon ,
|
|
each set to a different mode.
|
|
|
|
.TP
|
|
.BR \-i
|
|
Start in disk I/O mode, which displays instantaneous disk usage and
|
|
average disk load.
|
|
|
|
.TP
|
|
.BR \-b
|
|
Include buffers and cache in memory usage calculations. The trend in
|
|
recent years has been to not include this in memory load monitors, but it
|
|
can be useful information.
|
|
|
|
.TP
|
|
.BR \-s
|
|
Start in system information mode, which displays memory usage, swap usage,
|
|
and uptime.
|
|
|
|
.TP
|
|
.B \-h
|
|
Show help information.
|
|
|
|
.TP
|
|
.B \-v
|
|
Print the version number.
|
|
|
|
.SH USAGE
|
|
The
|
|
.B WMMon
|
|
display can be cycled between CPU, disk I/O, and system
|
|
information displays by clicking on the upper-left widget. This
|
|
displays CPU information by default.
|
|
|
|
WMMon can also be used to launch programs. You may click either left,
|
|
middle, or right mouse buttons in the average-load section of the
|
|
window. The pre-configured program will be launched according to the
|
|
mouse button clicked. (see
|
|
.B CONFIGURATION FILE
|
|
below.)
|
|
|
|
In order to move
|
|
.BR WMMon ,
|
|
drag on the outer edges. These are not sensitive to mouse clicks.
|
|
|
|
.SH "DOCKING IN WINDOW MANAGERS"
|
|
|
|
.TP
|
|
Window Maker
|
|
|
|
Window Maker users should drag and drop the
|
|
.B WMMon
|
|
window on the Dock. Then, right-click on the border of the window and
|
|
select \*(lqSettings...\*(rq. Check \*(lqStart when Window Maker
|
|
is started\*(rq.
|
|
|
|
.TP
|
|
AfterStep
|
|
|
|
AfterStep users should put the following in their
|
|
.I $HOME/.steprc
|
|
|
|
.RS 16
|
|
Wharf wmmon \- MaxSwallow "wmmon" wmmon &
|
|
.RE
|
|
|
|
.TP
|
|
Other window managers
|
|
|
|
.B WMMon
|
|
runs nicely as a 64x64 shaped icon on your desktop.
|
|
|
|
.SH "CONFIGURATION FILE"
|
|
|
|
.B WMMon
|
|
can launch three user-defined commands, triggered by left, middle and
|
|
right mouse button clicks. You can define the commands to launch in
|
|
.I $HOME/.wmmonrc
|
|
|
|
.RS
|
|
.PD 0
|
|
left: xterm
|
|
.PP
|
|
middle: xload
|
|
.PP
|
|
right: xcalc
|
|
.PP
|
|
.PD
|
|
.RE
|
|
|
|
If
|
|
.B WMMon
|
|
detects a
|
|
.I $HOME/.wmmonrc
|
|
file, it will launch the appropriate command when you click on the clock.
|
|
|
|
The system administrator can define default commands in
|
|
.IR /etc/wmmonrc .
|
|
The administrator may also choose to \*(lqfix\*(rq particular commands,
|
|
making it impossible for users to change. These commands can be defined in
|
|
.IR /etc/wmmonrc.fixed ,
|
|
although this isn't a nice thing to do.
|
|
|
|
.SH FILES
|
|
|
|
.I /etc/wmmonrc
|
|
.br
|
|
.I $HOME/.wmmonrc
|
|
.br
|
|
.I /etc/wmmonrc.fixed
|
|
|
|
.SH AUTHORS
|
|
|
|
.B WMMon
|
|
was written by Martijn Pieterse and Antoine Nulle.
|
|
|
|
This manual page was written by Simon Law <sfllaw@debian.org> for the
|
|
.B Debian
|
|
system (but may be used by others). It is based on the documentation provided
|
|
by the original program.
|
|
|
|
This manual 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.
|