WMND(1)WMND(1)NAME
WMND - WindowMaker network device monitor
SYNOPSISwmnd { options }
DESCRIPTION
WMND is a WindowMaker dock application that shows a graph of the net‐
work traffic of the past few minutes, current activity and current and
overall send and receive rates. Additionally it can launch any program
in response to mouse clicks.
OPTIONS-i interface
Select the interface to start with.
-I interface
Interface/s to monitor. Defaults to all but lo and irda. Under
linux (using the linux_proc driver) you can specify multiple
interfaces separated by commas to force offline ones and combine
them into a single instance.
-D driver
Specify a driver to use. Defaults to auto-probe.
-l Start using long device names.
-m Start with maximal values hidden.
-t Start without displaying connection time of ppp links.
-M Use the maximal values of the entire history.
-w mode
Select display mode to start with. Use wmnd-h for a list of
available display modes. Right clicks on the graph cycle
through all available modes.
-r rate
refresh rate in microseconds
-s scroll
scroll rate in tenths of seconds
-S steps
Number of scroll steps to wait before updating the speed rate
indicator.
-b Scale the values of the maximum and current rate by factors of
base 2 instead of the default 10-based scaling. (1K equals 1024
in binary mode, but 1000 in decimal mode.)
-c color
tx color
-C color
rx color
-L color
middle line color
-d display
Draw onto X11 display display
-f config
Read config instead of ~/.wmndrc
-F Don't parse ~/.wmndrc
-h Show summary of options.
-v Show version of WMND.
-q Be less verbose (display only errors).
-Q Show informational messages.
-o float
Smoothing factor (a float from 0 to 1).
-a bytes
Use a fixed scale for the bytes modes specified in bytes per
second. By default uses an automatic scale.
-n name
Change the WMND class/title name (defaults to "wmnd").
USAGE
Active Interface
You can cycle in realtime through all available active interfaces by
simply left-clicking on the interface name gadget on the upperleft cor‐
ner of WMND or use the mouse wheel.
The 'lo' interface is an exception, 'lo' only works when invoked from
the commandline (wmnd -I lo), lo was mainly built in for testing pur‐
poses.
Device Name
By default, WMND show device name in short term of four characters, for
example, the ippp0 will be displayed as ipp0. You can toggle the
device name between short and long by right-click on it.
Graphic Mode
Left-click on the main graphic area to cycle the graphic mode.
Max Meter
Left-click to toggle the history max or screen max, default is screen
max when WMND is startup. Right-click to hide or show. Middle-click to
zoom the statistics in a separated trend window. You can cycle the
active interface and middle-click again to monitor multiple interfaces
concurrently.
Byte/Packet Mode
Left-click on the letter gadgeted on the right-top corner can switch
between the Byte or Packet counter mode. "B" for byte, "p" for packet.
The current mode affects the external trend window too.
User Script
Click on the bottom rate meter can invoke the user command defined in
resource file .wmndrc.
Dragging WMND
Be sure to drag WMND on it's outer edges, it's a bit picky due to the
large gfx pixmap it keeps. You can also use a keyboard and mouse short‐
cut (perhaps ALT+left-click) in your window manager to drag it around.
Drivers
solaris_fpppd
Solaris/Linux ppp streams driver. Gathers device data from
/dev/ppp. Uses code from the Solaris/Linux pppd server and it
should work wherever Solaris/Linux pppd works.
linux_proc
Reads data from the linux proc(5) virtual filesystem.
freebsd_sysctl
Uses the MIB to gather device statistics under FreeBSD (offline
devices handling is buggy, support needed!)
netbsd_ioctl
Read statistics through the NetBSD ioctl call.
solaris_kstat
Gather all devices of class net from the kstat library.
irix_pcp
Reads metrics from the IRIX Performance Co-Pilot daemon. Inter‐
face format:
[host@]interface
generic_snmp
Query an IF-MIB capable snmp server for gathering interface sta‐
tistics. By default generic_snmp connects to localhost and uses
the public community. You can change the community/host/inter‐
face to monitor by using the -I flag:
[community@]host[:interface]
You must specify an interface number, not an interface name. If
the interface number is 0, or there's no interface specifica‐
tion, WMND will display all available interfaces. By default the
community name is "public". Beware that by specifying an snmp v1
community name on a command line can be dangerous on an multi‐
user platform. Please read the README file on the distribution
for more details.
testing_dummy
This is the "last resort" driver, it shows a null device useful
only to make WMND don't exit when all other drivers failed. Can
be enhanced to display something at compile time.
FILES
~/.wmndrc User configuration.
The format of this file is described in the example file "wmndrc" com‐
ing with the distribution (see /usr/share/doc/wmnd/).
SIGNALS
SIGTERM SIGINT
Clean WMND shutdown.
BUGS
Report bugs and suggestion to the current WMND maintainer: wave++
<wavexx@users.sf.net>. More information (including usage instructions)
can be found into the README file found into the distribution. These
information should be integrated here too.
SEE ALSOX(3x), wmaker(1x), proc(5), trend(1)AUTHOR
This manual page was written by Arthur Korn <arthur@korn.ch>. The
original WMND authour is Reed Lai, but it is currently maintained by
Yuri D'Elia <wavexx@users.sf.net>.
Jan 29, 2008 WMND(1)
