WMND(1)

NAME
WMND - WindowMaker network device monitor

SYNOPSIS
wmnd { options }

DESCRIPTION
WMND is a WindowMaker dock application that shows a graph of the network 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
    Interfaces to monitor. Defaults to all but lo and irda.

-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).

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 corner of WMND.

The 'lo' interface is an exception, 'lo' only works when invoked from the commandline (wmnd -I lo), lo was mainly built in for testing purposes.

  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 display.

  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.

  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 shortcut (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!)

solaris_kstat
    Gather all devices of class net from the kstat library.

irix_pcp
    Reads metrics from the IRIX Performance Co-Pilot daemon. Read the README for problems with this driver.

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 enchanged to display something at compile time.

FILES
~/.wmndrc    User configuration.

The format of this file is:

    # WMND configuration file

    # middle line in wave mode color
    md_color=#71e371

    # RX/TX color (can be #xxxxxx, or color name from rgb.txt)
    rx_color=#188a86
    tx_color=#00fff2

    # refresh between status polling (not graph scroll speed)
    # numbering in nanoseconds
    refresh=50000

    # bar graph scroll speed (in tenths of seconds) this setting
    # also affects the rate and max speed displays.  the longer
    # the delay, more inaccurate these are since the max and
    # rate values are averaged across this interval
    scroll=1

    # average sampling for the speed display at the bottom of the
    # pixmap. this is the number of times to wait (in terms of
    # scrolling steps) before displaying the average speed of
    # that period. The time of the period can be calculated (in
    # tenth of seconds) with: scroll * avg_steps
    avg_steps=1

    # smooth: smoothing factor. A float value ranging from 0 to 1. This is
    # really the "amount" of the new speed against the history each time is
    # sampled from the device. A low value (0.1) will remove random spikes
    # from the graph. Values higher that 1 will instead enchange spikes.
    # Disabled by default (0).
    smooth=0

    # buttons for user scripts
    # bt1_action=su -c ethereal
    # bt2_action=
    # bt3_action=

    # respects the -b in command line (yes, no)
    binary_scale=no

    # display or not the device uptime (yes, no)
    display_time=yes

    # use a specific driver (driver name, %auto for automatic)
    driver=%auto

    # driver interface to monitor (interface name, %any for all)
    driver_interface=%any

    # automatically select and show the interface on startup
    # if avaible (interface name, %first for first avaible)
    interface_name=%first

    # Show max values (yes, no)
    show_max_values=yes

    # Use long interface names (yes, no)
    use_long_names=no

    # Max values through entire history
    use_max_history=no

    # Wave mode (traditional, waveform, wmnet, ...)
    wave_mode=wmnet

    # be less verbose (display only errors)
    # quiet=yes

SIGNALS

SIGUSR1
    Internally restart all driver's interfaces (only usefull for programming/testing purposes).

SIGTERM SIGINT
    Clean WMND shutdown.

BUGS
Report bugs and suggestion to the current WMND maintainer: Wave++ <wavexx@users.sf.net>

SEE ALSO
X(3x), wmaker(1x). proc(5)

AUTHOR
This manual page was written by Arthur Korn <arthur@korn.ch>. The original WMND authour is Reed Lai <reed@wingeer.org>.