MAN page from Fedora 30 wavemon-0.9.1-1.fc30.x86_64.rpm
Section: User Manuals (1)
Updated: September 2016Index
wavemon - a wireless network monitor
SYNOPSISwavemon [-h] [-iifname] [-g] [-v]
is a ncurses-based monitoring application for wireless networkdevices. It plots levels in real-time as well as showing wireless and networkrelated device information.
The wavemon interface splits into different "screens".Each screen presents information in a specific manner. For example, the"info" screen shows current levels as bargraphs, whereas the "level" screenrepresents the same levels as a moving histogram.
On startup, you'll see (depending on configuration) one of the differentmonitor screens. At the bottom, you'll find a menu-bar listing thescreens and their activating keys. Each screen is activated by either thecorresponding function key or the key corresponding to the first characterof the screen name. The following screens can be selected:
- Info (F1 or 'i')
- This is the most comprehensive screen. It displays a condensed overview ofwireless-specific parameters and network statistics, as well as bar graphs.The layout is arranged into several sub-sections.
TheInterfacesection at the top shows information about the monitoring interface,including interface name, type, ESSID, and available encryption formats.
Below, in theLevelssection, you can see up to four bargraphs showing (1) relative signal qualityand (2) signal level in dBm. If the wireless driver also supports noise levelinformation, additionally (3) noise level in dBm and (4) Signal-Noise-Ratio(SNR) in dB are shown. The colour of the signal level bargraph changesfrom red to yellow and green at fixed levels. If thresholds have been set,two arrows on the signal level graph will show the positions of the currentthresholds.
TheStatisticssection displays packet and byte counters and a few other packet-relatedstatistics.
The subsequentInfosubsection lists the current operational mode and configuration of thewireless interface. What parameters are actually shown depends on thecapabilities and selected mode of your network device.
Lastly, theNetworksection shows network-level parameters. The MAC-address is resolved fromethers(5). The IPv4 address is shown in CIDR notation (RFC 4632address/prefix_len format). Since often those two valuesalso determine the broadcast address (last 32 - prefix_len bits setto 1), that address is shown only if it does not derive from the interfaceaddress and prefix length. Likewise, the interface MTU is shown only if itdiffers from the default Ethernet MTU of 1500 bytes.
- Level histogram (F2 or 'l')
- This is a full-screen histogram plot showing the evolution of levels with time.The screen is partitioned into a grid, with dBm levels shown in green atthe right hand side (depending on configuration). At the very minimum,the evolution of the signal-level is shown. If the wireless driver alsosupports noise-level information, additionally a noise graph and associatedSNR graph appear.
- Scan window (F3 or 's')
- A periodically updated network scan, showing access points and otherwireless clients. It is sorted depending on sort_order and sort_ascending, see wavemonrc(5).Each entry starts with the ESSID, followed by the colour-coded MACaddress and the signal/channel information. A green/red MAC address indicatesan (un-)encrypted access point, the colour changes to yellow for non-accesspoints (in this case the mode is shown at the end of the line). Theuncoloured information following the MAC address lists relative andabsolute signal strengths, channel, frequency, and station-specific information.The station-specific information includes the station type (ESS for Access Point,IBSS for Ad-Hoc network), station count and channel utilisation.
A status line at the bottom informs about the current sort order and a fewstatistics, such as most (least) crowded channels (least crowded channelsare listed when sorting by descending channel).
The sort_order can also directly be changed via these keyboard shortcuts:ascending, descending; by essid, signal, channel (C also with signal),mac address, or by open access (O also with signal).
- Preferences (F7 or 'p')
- This screen allows you to change all program options such as interface andlevel scale parameters, and to save the new settings to the configurationfile. Select a parameter with <up> and <down>, then change the value with<left> and <right>. Please refer to wavemonrc(5) for an in-depthdescription of applicable settings.
- Help (F8 or 'h')
- This page might show an online-help.
- About (F9 or 'a')
- Release information and contact URLs.
- Quit (F10 or 'q')
- Exit wavemon.
Note: some operations, such as displaying encryption information or performing scans, requireCAP_NET_ADMIN privileges (see capabilities(7)). For non-root users, these can beenabled by installing wavemon setuid-root.
- -i interface
- override autodetection and use the specified interface.
- check screen geometry: a minimum size is required for proper display; this flagadds a check to ensure it is sufficiently large. Enable this if window does not displayproperly.
- print help and exit.
- print version information and exit.
wavemon will exit with 'no supported wireless interfaces found'
if no usable wireless interfaceswere detected. Check if your wireless interfaces is otherwise usable, using e.g. iw
,or similar tools. The interface should appear in /proc/net/dev and, if wireless extensions are supported,also in /proc/net/wireless. If the interface does not appear, causes can be a missing (or not loaded)kernel module, or missing firmware, which some cards need to operate.
- Influences the grouping of numbers if set. See also locale(1).
- The local per-user configuration file.
Written by Jan Morgenstern <janAATTjm-music.de>.
Open an issue on https://github.com/uoaerg/wavemon/issues
This is free software with ABSOLUTELY NO WARRANTY. See file COPYING for details.
- ENVIRONMENT VARIABLES
- REPORTING BUGS
- SEE ALSO
This document was created byman2html,using the manual pages.