.TH wavemon 1 "September 2016" Linux "User Manuals" .SH NAME wavemon \- a wireless network monitor .SH SYNOPSIS .B wavemon [-h] [-i .I ifname .B ] [-g] [-v] .SH DESCRIPTION \fIwavemon\fR is a ncurses-based monitoring application for wireless network devices. It plots levels in real-time as well as showing wireless and network related device information. The \fIwavemon\fR 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" screen represents the same levels as a moving histogram. On startup, you'll see (depending on configuration) one of the different monitor screens. At the bottom, you'll find a \fImenu-bar\fR listing the screens and their activating keys. Each screen is activated by either the corresponding function key or the key corresponding to the first character of the screen name. The following screens can be selected: .TP .B Info (F1 or 'i') This is the most comprehensive screen. It displays a condensed overview of wireless-specific parameters and network statistics, as well as bar graphs. The layout is arranged into several sub-sections. The .B Interface section at the top shows information about the monitoring interface, including interface name, type, ESSID, and available encryption formats. Below, in the .B Levels section, you can see up to four bargraphs showing (1) relative signal quality and (2) signal level in dBm. If the wireless driver also supports noise level information, additionally (3) noise level in dBm and (4) Signal-Noise-Ratio (SNR) in dB are shown. The colour of the signal level bargraph changes from 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 current thresholds. The .B Statistics section displays packet and byte counters and a few other packet-related statistics. The subsequent .B Info subsection lists the current operational mode and configuration of the wireless interface. What parameters are actually shown depends on the capabilities and selected mode of your network device. Lastly, the .B Network section shows network-level parameters. The MAC-address is resolved from \fBethers\fR(5). The IPv4 address is shown in CIDR notation (RFC\ 4632 \fIaddress\fR\fB/\fR\fIprefix_len\fR format). Since often those two values also determine the broadcast address (last 32 \- \fIprefix_len\fR bits set to 1), that address is shown only if it does not derive from the interface address and prefix length. Likewise, the interface MTU is shown only if it differs from the default Ethernet MTU of 1500 bytes. .TP .B 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 at the right hand side (depending on configuration). At the very minimum, the evolution of the signal-level is shown. If the wireless driver also supports noise-level information, additionally a noise graph and associated SNR graph appear. .TP .B Scan window (F3 or 's') A periodically updated network scan, showing access points and other wireless clients. It is sorted depending on \fIsort_order\fR and \fIsort_ascending\fR, see \fBwavemonrc\fR(5). Each entry starts with the ESSID, followed by the colour-coded MAC address and the signal/channel information. A green/red MAC address indicates an (un-)encrypted access point, the colour changes to yellow for non-access points (in this case the mode is shown at the end of the line). The uncoloured information following the MAC address lists relative and absolute 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 few statistics, such as most (least) crowded channels (least crowded channels are listed when sorting by descending channel). The \fIsort_order\fR can also directly be changed via these keyboard shortcuts: \fIa\fRscending, \fId\fRescending; by \fIe\fRssid, \fIs\fRignal, \fIc\fRhannel (\fIC\fR also with signal), \fIm\fRac address, or by \fIo\fRpen access (\fIO\fR also with signal). .TP .B Preferences (F7 or 'p') This screen allows you to change all program options such as interface and level scale parameters, and to save the new settings to the configuration file. Select a parameter with and , then change the value with and . Please refer to \fBwavemonrc\fR(5) for an in-depth description of applicable settings. .TP .B Help (F8 or 'h') This page might show an online-help. .TP .B About (F9 or 'a') Release information and contact URLs. .TP \fBQuit (F10 or 'q') Exit \fIwavemon\fR. .LP \fBNote:\fR some operations, such as displaying encryption information or performing scans, require \fBCAP_NET_ADMIN\fR privileges (see \fBcapabilities\fR(7)). For non-root users, these can be enabled by installing \fIwavemon\fR setuid-root. .SH "OPTIONS" .IP "\fB\-i \fIinterface\fR\fR" override autodetection and use the specified \fIinterface\fR. .IP "\fB\-g\fR" check screen \fIgeometry\fR: a minimum size is required for proper display; this flag adds a check to ensure it is sufficiently large. Enable this if window does not display properly. .IP "\fB\-h\fR" print help and exit. .IP "\fB\-v\fR" print version information and exit. .SH Troubleshooting wavemon will exit with \fB'no supported wireless interfaces found'\fR if no usable wireless interfaces were detected. Check if your wireless interfaces is otherwise usable, using e.g. \fIiw\fR, \fIiwconfig\fR, 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. .SH "ENVIRONMENT VARIABLES" .IP "LC_NUMERIC" Influences the grouping of numbers if set. See also \fBlocale\fR(1). .SH FILES .IP $HOME/.wavemonrc The local per-user configuration file. .SH "AUTHOR" Written by Jan Morgenstern . .SH "REPORTING BUGS" Open an issue on \fIhttps://github.com/uoaerg/wavemon/issues\fR. .SH "COPYRIGHT" This is free software with ABSOLUTELY NO WARRANTY. See file COPYING for details. .SH "SEE ALSO" .BR wavemonrc (5), .BR wireless (7), .BR ethers (5), .BR locale (1), .BR capabilities (7) span class='deletions'>-4/+9 Fixes issue that became apparent after switch to DST 2012-03-26modbuslog: add 1 second sleep before modbus retriesJonathan McCrohan1-0/+1 2012-03-26modbuslog: ensure no logs recorded if libmodbus errorsJonathan McCrohan1-6/+7 2012-03-26modbuslog: ensure arrays are zero'd before useJonathan McCrohan1-0/+6 2012-03-25modbuslog: move exclusively to numbytesJonathan McCrohan2-25/+38 2012-03-25modbuslog: force interval wrap aroundJonathan McCrohan1-1/+1 A hand edited file could miss the wrap around magic number and miss it. 2012-03-24ftphelper: add --version argumentJonathan McCrohan1-0/+8 2012-03-21Double the width of registervalueJonathan McCrohan1-1/+1 2012-03-14modbuslog: Fix bitshiftingv1.4Jonathan McCrohan1-5/+2 Was not working correctly with Digirail 4C 2012-03-13modbuslog: fix logic typov1.3Jonathan McCrohan1-1/+1 break != continue Introduced in 1cac28534c332d771bfd7a1a216bdaacbfe27fd1 2012-03-13modbuslog: reindentJonathan McCrohan1-3/+4 2012-03-13modbuslog: Make debug messages more 'English'Jonathan McCrohan1-1/+4 2012-03-13modbuslog.cfg: set /dev/ttyUSB0 as default entryJonathan McCrohan1-1/+1 2012-03-13modbuslog: improve error handlingJonathan McCrohan1-3/+6 2012-03-13modbuslog: fix syslog regressionJonathan McCrohan1-1/+1 Introduced in 58bba2bc1f7da50109467a5ffd233b94623deac5 2012-03-13modbuslog: Surround syslog outputs with bracketsJonathan McCrohan1-8/+8 2012-03-13ftpupload: use fully qualified pathsJonathan McCrohan1-3/+10 cron requires them 2012-03-12Force log upon startupJonathan McCrohan1-2/+8 2012-03-12ftphelper: Fix off by one errorv1.2Jonathan McCrohan1-7/+7 Date in filename represents file generation time, not date of logfile. Throwback to fieldcommander sqlite to logfile days. 2012-03-12Add cron.d entryJonathan McCrohan2-0/+9 2012-03-127 day rolling uploadJonathan McCrohan1-8/+22 2012-03-09Fix ftpuploadJonathan McCrohan1-1/+5 2012-03-07ReindentJonathan McCrohan1-5/+6 2012-03-07Made logs more 'English'Jonathan McCrohan1-3/+4 2012-03-07Surround log startup notice with empty linesJonathan McCrohan1-0/+2 2012-03-07Add compile time version numbersJonathan McCrohan2-1/+10 Uses git tags as version number 2012-03-05Fix copypasta errorv1.1Jonathan McCrohan1-10/+18 wrong variable used. 2012-03-05Rearrange syslog output to read 8N1 rather than N81Jonathan McCrohan1-2/+2 2012-03-05Refactor codeJonathan McCrohan2-6/+4 No source chances, reindent only. 2012-03-05Add syslog loggingJonathan McCrohan1-24/+57 2012-03-04Remove unused #define statementsJonathan McCrohan1-3/+0 2012-02-20Prune archive after 3 monthsJonathan McCrohan3-0/+7 2012-02-20Update documentationJonathan McCrohan1-3/+5 2012-02-20Add PHP to make installJonathan McCrohan1-0/+3 2012-02-20Update MakefileJonathan McCrohan1-0/+17 2012-02-20Move interval.txt to src/Jonathan McCrohan2-1/+1 2012-02-19Remove debug/testing files.Jonathan McCrohan50-4742/+0 2012-02-15Archive files after upload.Jonathan McCrohan1-0/+2 2012-02-12Fix typo in README.Jonathan McCrohan1-1/+1 2012-02-12Add ftp upload function + add documentation.Jonathan McCrohan5-3/+151 2012-01-10Handle 32bit signed overflow.Jonathan McCrohan1-1/+6 2012-01-10Update README.Jonathan McCrohan1-1/+3