Provided by: wavemon_0.7.4-1_amd64 bug

NAME

       wavemon - a wireless network monitor

SYNOPSIS

       wavemon [-h] [-i ifname ] [-l] [-r] [-v]

DESCRIPTION

       wavemon  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.
       Currently,  wavemon  is  still  based  on  the  wireless  extensions  by  Jean  Tourrilhes
       <jt@hpl.hp.com>.

       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" 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 menu-bar listing the screens and their function key names.
       The following screens can be selected:

       Info (F1)
              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 Interface section at the top shows information about the monitoring  interface,
              including interface name, type, ESSID, and available encryption formats.

              Below, in the 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 Statistics section displays packet and byte counters and a  few  other  packet-
              related statistics.

              The subsequent 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  Network  section  shows  network-level parameters. The MAC-address is
              resolved from ethers(5). The IPv4 address  is  shown  in  CIDR  notation  (RFC 4632
              address/prefix_len  format).  Since  often  those  two  values  also  determine the
              broadcast address (last 32 - prefix_len 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.

              Another keyboard shortcut for this screen is 'i'.

       Level histogram (F2)
              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.

       Scan window (F3)
              A  periodically  updated  network  scan,  showing  access points and other wireless
              clients, ordered by frequency and then descending order  of  signal  quality.  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 the
              mode if the node is not an access point.

              Please note that gathering meaningful scan data can take  several  seconds.  Partly
              for  this  reason,  the  Scan  window  is the only screen that can not be suspended
              (CTRL-Z).

       Preferences (F7)
              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 <up> and <down>, then change the  value  with  <left>  and  <right>.
              Please refer to wavemonrc(5) for an in-depth description of applicable settings.

       Help (F8)
              This page might show an online-help.

       About (F9)
              Release information and contact URLs.

       Quit (F10)
              Exit wavemon. An alternative shortcut for quitting is 'q'.

       Note:  some  operations,  such  as  displaying encryption information or performing scans,
       require CAP_NET_ADMIN privileges (see capabilities(7)). For non-root users, these  can  be
       enabled by installing wavemon setuid-root.

OPTIONS

       -i interface
              override autodetection and use the specified interface.

       -d     dump interface parameters to stdout and exit.

       -g     check  screen  geometry:  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.

       -r     generate random levels (for testing purposes).

       -h     print help and exit.

       -v     print version information and exit.

ENVIRONMENT VARIABLES

       LC_NUMERIC
              Influences the grouping of numbers if set. See also locale(1).

FILES

       $HOME/.wavemonrc
              The local per-user configuration file.

AUTHOR

       Written by Jan Morgenstern <jan@jm-music.de>.

REPORTING BUGS

       Send bug reports and/or suggestions to Gerrit Renker <gerrit@erg.abdn.ac.uk>.

COPYRIGHT

       This is free software with ABSOLUTELY NO WARRANTY. See file COPYING for details.

SEE ALSO

       wavemonrc(5), wireless(7), ethers(5), locale(1), capabilities(7)