SYNOPSIS

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

DESCRIPTION

wavemon stores its configuration parameters within the file ~/.wavemonrc in every user's home directory. This manpage provides an in-depth description of the available options. Every setting corresponds to a configuration item you'll find on the preferences screen within the program (F7 key).

interface = <ifname>

(Interface)

This parameter specifies, you guessed it, the name of the interface wavemon uses for operation. Only valid identifiers of existing wireless network devices are allowed, otherwise the program launch will fail.

stat_updates = <n>

(Statistics updates)

This controls the intervals between updates of the statistics data. Range: 10..4000ms.

lhist_slot_size = <n>

(Histogram update cycles)

This determines how many obtained statistics values are averaged into one level histogram slot. So, if your statistics update interval is 50ms and your histogram slot size is 4, the histogram is moved one slot further every 2 seconds. Range: 1..64.

meter_smoothness = <n>

(Level meter smoothness)

Determines the responsiveness of level meters, tracking the moving average rather than following each new sample. The given value specifies the percentage of the history (the 'inertia') of preceding samples. A value of 0 disables this option. Range: 0..99%.

info_updates = <n>

(Dynamic info updates)

With this setting, you can control the intervals between updates of the dynamic device parameters, i.e. those values that may change, but not frequently. Dynamic parameters are for example the current bitrate of your wireless link. Range: 1..60s.

override_auto_scale = (enabled|disabled)

(Override scale autodetect)

Setting this parameter to "enabled" overrides the auto-detection of the bar graph and histogram scale boundaries, allowing you to specify your own scales.

min_signal_level, max_signal_level = <n>

(Minimum signal level, Maximum signal level)

These parameters allow you to set the left and right boundaries of the signal level scales. Ranges: -128..-60dBm (minimum), -59..120dBm (maximum).

min_noise_level, max_noise_level = <n>

(Minimum noise level, Maximum noise level)

These work similar to the signal boundary settings. Ranges: -128..-60dBm (minimum), -60..120dBm (maximum).

random = (enabled|disabled)

(Random signals)

This switch controls a fancy random generator you can use for testing functions and scales.

lo_threshold_action = (disabled|beep|flash|beep+flash)

(Low threshold action)

This function allows you to assign a warning facility to a defineable threshold at the lower end of the signal scale. It is meant for alarming you when a signal appears at the receiver.

lo_threshold = <n>

(Low threshold)

This defines the low threshold. Makes only sense when the above setting is active. Range: -120..-60dBm.

hi_threshold_action = (disabled|beep|flash|beep+flash)

(High threshold action)

This is similar to lo_threshold_action, only this time the threshold is at the upper end of the scale and the action is performed when the signal level drops below it. The acoustic signal is also different in order to be easily distinguishable from the lower one. Correctly adjusted, this little fellow will tell you when you should move closer to the base station.

hi_threshold = <n>

(High threshold)

This defines the high threshold. Makes only sense when the above setting is active. Range: -59..120dBm.

startup_screen = (info|histogram|access points)

(Startup screen)

This setting determines which of the screens will be shown at program startup.

AUTHOR

Jan Morgenstern <[email protected]>

The current maintainer is Gerrit Renker <[email protected]>

COPYRIGHT

wavemon is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2, or (at your option) any later version.

wavemon is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with wavemon; see the file COPYING. If not, write to the Free Software Foundation, 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.