1WMND(1) General Commands Manual WMND(1)
2
6 WMND - WindowMaker network device monitor
7
9 wmnd { options }
10
12 WMND is a WindowMaker dock application that shows a graph of the net‐
13 work traffic of the past few minutes, current activity and current and
14 overall send and receive rates. Additionally it can launch any program
15 in response to mouse clicks.
16
18 -i interface
19 Select the interface to start with.
20 -I interface
22 Interface/s to monitor. Defaults to all but lo and irda. Under
23 linux (using the linux_proc driver) you can specify multiple
24 interfaces separated by commas to force offline ones and combine
25 them into a single instance.
26 -D driver
28 Specify a driver to use. Defaults to auto-probe.
29 -l Start using long device names.
31 -m Start with maximal values hidden.
33 -t Start without displaying connection time of ppp links.
35 -M Use the maximal values of the entire history.
37 -w mode
39 Select display mode to start with. Use wmnd -h for a list of
40 available display modes. Right clicks on the graph cycle
41 through all available modes.
42 -r rate
44 refresh rate in microseconds
45 -s scroll
47 scroll rate in tenths of seconds
48 -S steps
50 Number of scroll steps to wait before updating the speed rate
51 indicator.
52 -b Scale the values of the maximum and current rate by factors of
54 base 2 instead of the default 10-based scaling. (1K equals 1024
55 in binary mode, but 1000 in decimal mode.)
56 -c color
58 tx color
59 -C color
61 rx color
62 -L color
64 middle line color
65 -d display
67 Draw onto X11 display display
68 -f config
70 Read config instead of ~/.wmndrc
71 -F Don't parse ~/.wmndrc
73 -h Show summary of options.
75 -v Show version of WMND.
77 -q Be less verbose (display only errors).
79 -Q Show informational messages.
81 -o float
83 Smoothing factor (a float from 0 to 1).
84 -a bytes
86 Use a fixed scale for the bytes modes specified in bytes per
87 second. By default uses an automatic scale.
88 -n name
90 Change the WMND class/title name (defaults to "wmnd").
91
94 Active Interface
95 You can cycle in realtime through all available active interfaces by
96 simply left-clicking on the interface name gadget on the upperleft cor‐
97 ner of WMND or use the mouse wheel.
98 The 'lo' interface is an exception, 'lo' only works when invoked from
100 the commandline (wmnd -I lo), lo was mainly built in for testing pur‐
101 poses.
102 Device Name
104 By default, WMND show device name in short term of four characters, for
105 example, the ippp0 will be displayed as ipp0. You can toggle the
106 device name between short and long by right-click on it.
107 Graphic Mode
109 Left-click on the main graphic area to cycle the graphic mode.
110 Max Meter
112 Left-click to toggle the history max or screen max, default is screen
113 max when WMND is startup. Right-click to hide or show. Middle-click to
114 zoom the statistics in a separated trend window. You can cycle the
115 active interface and middle-click again to monitor multiple interfaces
116 concurrently.
117 Byte/Packet Mode
119 Left-click on the letter gadgeted on the right-top corner can switch
120 between the Byte or Packet counter mode. "B" for byte, "p" for packet.
121 The current mode affects the external trend window too.
122 User Script
124 Click on the bottom rate meter can invoke the user command defined in
125 resource file .wmndrc.
126 Dragging WMND
128 Be sure to drag WMND on it's outer edges, it's a bit picky due to the
129 large gfx pixmap it keeps. You can also use a keyboard and mouse short‐
130 cut (perhaps ALT+left-click) in your window manager to drag it around.
131 Drivers
133 solaris_fpppd
134 Solaris/Linux ppp streams driver. Gathers device data from
135 /dev/ppp. Uses code from the Solaris/Linux pppd server and it
136 should work wherever Solaris/Linux pppd works.
137 linux_proc
139 Reads data from the linux proc(5) virtual filesystem.
140 freebsd_sysctl
142 Uses the MIB to gather device statistics under FreeBSD (offline
143 devices handling is buggy, support needed!)
144 netbsd_ioctl
146 Read statistics through the NetBSD ioctl call.
147 solaris_kstat
149 Gather all devices of class net from the kstat library.
150 irix_pcp
152 Reads metrics from the IRIX Performance Co-Pilot daemon. Inter‐
153 face format:
154 [host@]interface
156 generic_snmp
159 Query an IF-MIB capable snmp server for gathering interface sta‐
160 tistics. By default generic_snmp connects to localhost and uses
161 the public community. You can change the community/host/inter‐
162 face to monitor by using the -I flag:
163 [community@]host[:interface]
165 You must specify an interface number, not an interface name. If
167 the interface number is 0, or there's no interface specifica‐
168 tion, WMND will display all available interfaces. By default the
169 community name is "public". Beware that by specifying an snmp v1
170 community name on a command line can be dangerous on an multi‐
171 user platform. Please read the README file on the distribution
172 for more details.
173 testing_dummy
175 This is the "last resort" driver, it shows a null device useful
176 only to make WMND don't exit when all other drivers failed. Can
177 be enhanced to display something at compile time.
178
180 ~/.wmndrc User configuration.
181 The format of this file is described in the example file "wmndrc" com‐
183 ing with the distribution (see /usr/share/doc/wmnd/).
184
186 SIGTERM SIGINT
187 Clean WMND shutdown.
188
190 Report bugs and suggestion to the current WMND maintainer: wave++
191 <wavexx@users.sf.net>. More information (including usage instructions)
192 can be found into the README file found into the distribution. These
193 information should be integrated here too.
194
196 X(3x), wmaker(1x), proc(5), trend(1)
197
199 This manual page was written by Arthur Korn <arthur@korn.ch>. The
200 original WMND authour is Reed Lai, but it is currently maintained by
201 Yuri D'Elia <wavexx@users.sf.net>.
202 Jan 29, 2008 WMND(1)