wmmon(1)						      General Commands Manual							  wmmon(1)

NAME

       wmmon - Window Maker dockapp for monitoring system information

SYNOPSIS

       wmmon [ OPTION ]

DESCRIPTION

       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:

       o   a realtime CPU stress meter;

       o   an auto-scaled average system load meter, like xload and wmavgload;

       o   a realtime disk I/O stress meter;

       o   auto-scaled disk I/O load meter;

       o   realtime memory and swap usage meters;

       o   a display for system uptime;

       o   three user-defined commands to launch.

OPTIONS

       -display display
	      This option specifies the X server to contact; see X(7x).

       -geometry geometry
	      This option specifies the preferred position of clock; see X(7x).

       -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 WMMon,
	      each set to a different mode.

       -i     Start in disk I/O mode, which displays instantaneous disk usage and average disk load.

       -b     Include  buffers and cache in memory usage calculations. The trend in recent years has been to not include this in memory load moni-
	      tors, but it can be useful information.

       -s     Start in system information mode, which displays memory usage, swap usage, and uptime.

       -h     Show help information.

       -v     Print the version number.

USAGE

       The 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 CONFIGURATION FILE below.)

       In order to move WMMon, drag on the outer edges.  These are not sensitive to mouse clicks.

DOCKING IN WINDOW MANAGERS

       Window Maker

	      Window Maker users should drag and drop the WMMon window on the Dock.  Then, right-click on the border  of  the  window  and  select
	      "Settings...".  Check "Start when Window Maker is started".

       AfterStep

	      AfterStep users should put the following in their $HOME/.steprc

		       Wharf wmmon - MaxSwallow "wmmon" wmmon &

       Other window managers

	      WMMon runs nicely as a 64x64 shaped icon on your desktop.

CONFIGURATION FILE

       WMMon  can  launch  three  user-defined	commands, triggered by left, middle and right mouse button clicks.  You can define the commands to
       launch in $HOME/.wmmonrc

	      left: xterm
	      middle: xload
	      right: xcalc
       If WMMon detects a $HOME/.wmmonrc file, it will launch the appropriate command when you click on the clock.

       The system administrator can define default commands in /etc/wmmonrc.  The administrator may also choose to "fix" particular commands, mak-
       ing it impossible for users to change.  These commands can be defined in /etc/wmmonrc.fixed, although this isn't a nice thing to do.

FILES

       /etc/wmmonrc
       $HOME/.wmmonrc
       /etc/wmmonrc.fixed

AUTHORS

       WMMon was written by Martijn Pieterse and Antoine Nulle.

       This  manual  page was written by Simon Law <sfllaw@debian.org> for the Debian system (but may be used by others). It is based on the docu-
       mentation 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.

WMMON 1.0b2							     May 1998								  wmmon(1)