1) Synopsis
-----------

wavemon is a wireless device monitoring application that allows you to watch
signal and noise levels, packet statistics, device configuration and network
parameters of your wireless network hardware. It *should* work (though with
varying features) with all devices supported by the Linux wireless kernel
extensions by Jean Tourrilhes.

See the man page for an in-depth description of operation and configuration.


2) Where to obtain
------------------
You can always find the latest version at:

	http://eden-feed.erg.abdn.ac.uk/wavemon

Please check this page for updates and for further information.
wavemon is distributed under the GPLv3, refer to the file COPYING.


3) How to build
---------------
wavemon uses autoconf, so that in most cases you can simply run

	./configure
	make
	sudo make install

to build and install the package. Type 'make uninstall' if not happy.
Refer to the file INSTALL for generic installation instructions.

To grant users access to restricted networking operations (e.g. reading WEP
keys or performing scan operations), use additionally

	sudo make install-suid-root

If you have changed some of the autoconf files or use a git version, run
	./config/bootstrap
(requires a recent installation of 'autotools').


3) Bugs?
--------
Send bug reports, comments, and suggestions to <gerrit@erg.abdn.ac.uk>.
4a50d00f7498e73ee625d9703e1720cd9738cd'>tree</a><a href='/lcd4linux.git/commit/smoketest.sh?id=204a50d00f7498e73ee625d9703e1720cd9738cd&amp;follow=1'>commit</a><a href='/lcd4linux.git/diff/smoketest.sh?id=204a50d00f7498e73ee625d9703e1720cd9738cd&amp;follow=1'>diff</a><a href='/lcd4linux.git/stats/smoketest.sh'>stats</a></td><td class='form'><form class='right' method='get' action='/lcd4linux.git/log/smoketest.sh'>
<input type='hidden' name='id' value='204a50d00f7498e73ee625d9703e1720cd9738cd'/><input type='hidden' name='showmsg' value='1'/><select name='qt'>
<option value='grep'>log msg</option>
<option value='author'>author</option>
<option value='committer'>committer</option>
<option value='range'>range</option>
</select>
<input class='txt' type='search' size='10' name='q' value=''/>
<input type='submit' value='search'/>
</form>
</td></tr></table>
<div class='path'>path: <a href='/lcd4linux.git/log/?id=204a50d00f7498e73ee625d9703e1720cd9738cd&amp;showmsg=1&amp;follow=1'>root</a>/<a href='/lcd4linux.git/log/smoketest.sh?id=204a50d00f7498e73ee625d9703e1720cd9738cd&amp;showmsg=1&amp;follow=1'>smoketest.sh</a> (<a href='/lcd4linux.git/log/smoketest.sh?id=204a50d00f7498e73ee625d9703e1720cd9738cd&amp;showmsg=1'>unfollow</a>)</div><div class='content'><table class='list nowrap'><tr class='nohover'><th class='left'>Age</th><th class='left'>Commit message (<a href='/lcd4linux.git/log/smoketest.sh?id=204a50d00f7498e73ee625d9703e1720cd9738cd&amp;follow=1'>Collapse</a>)</th><th class='left'>Author</th><th class='left'>Files</th><th class='left'>Lines</th></tr>
<tr class='logheader'><td><span title='2010-06-21 02:07:13 +0000'>2010-06-21</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/drv_FW8888.c?id=595ed4ad9868a1c304b8eebaa2fd205546b8aff9&amp;follow=1'>driver for Allnet FW8888 from Claas Hilbrecht</a></td><td>michael</td><td>8</td><td><span class='deletions'>-7986</span>/<span class='insertions'>+375</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
git-svn-id: https://ssl.bulix.org/svn/lcd4linux/trunk@1123 3ae390bd-cb1e-0410-b409-cd5a39f66f1f


</td></tr>
<tr class='logheader'><td><span title='2010-06-21 01:49:28 +0000'>2010-06-21</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/smoketest.sh?id=52f974cad14f0b99cfb59b996f0f26779ded255b&amp;follow=1'>ASTUSB driver from Henrik Schondorff</a></td><td>michael</td><td>9</td><td><span class='deletions'>-288</span>/<span class='insertions'>+612</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
git-svn-id: https://ssl.bulix.org/svn/lcd4linux/trunk@1122 3ae390bd-cb1e-0410-b409-cd5a39f66f1f


</td></tr>
<tr class='logheader'><td><span title='2010-05-19 02:26:47 +0000'>2010-05-19</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/configure?id=c4cdfc501c99cddaee73f15fffb9d17ddd3b68ae&amp;follow=1'>Ticket #170 (picolcd graphic build error) fixed by matt</a></td><td>michael</td><td>1</td><td><span class='deletions'>-0</span>/<span class='insertions'>+1</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
git-svn-id: https://ssl.bulix.org/svn/lcd4linux/trunk@1121 3ae390bd-cb1e-0410-b409-cd5a39f66f1f


</td></tr>
<tr class='logheader'><td><span title='2010-05-17 07:02:10 +0000'>2010-05-17</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/drv_picoLCDGraphic.c?id=d37c96b53ed8c6a4a53257fc34d86757c67c267d&amp;follow=1'>Ticket #184 (LCD::contrast and LCD::backlight segfaulting) fixed</a></td><td>michael</td><td>1</td><td><span class='deletions'>-2</span>/<span class='insertions'>+2</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
git-svn-id: https://ssl.bulix.org/svn/lcd4linux/trunk@1120 3ae390bd-cb1e-0410-b409-cd5a39f66f1f


</td></tr>
<tr class='logheader'><td><span title='2010-04-22 22:35:19 +0000'>2010-04-22</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/drv_picoLCDGraphic.c?id=06caf998da7e1dd8bbda1e504cb894638e9b26b1&amp;follow=1'>drv_picoLCDGraphic.c: changed two annoying info messages to debugging messages</a></td><td>mzuther</td><td>1</td><td><span class='deletions'>-2</span>/<span class='insertions'>+2</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
git-svn-id: https://ssl.bulix.org/svn/lcd4linux/trunk@1119 3ae390bd-cb1e-0410-b409-cd5a39f66f1f


</td></tr>
<tr class='logheader'><td><span title='2010-04-18 17:22:41 +0000'>2010-04-18</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/drv_picoLCDGraphic.c?id=303e1ef13683e1171f03a3e5b3a6f80c4650c8f5&amp;follow=1'>drv_picoLCDGraphic.c: alternative use of keypad widgets (instead of GPIO)</a></td><td>mzuther</td><td>1</td><td><span class='deletions'>-2</span>/<span class='insertions'>+78</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
git-svn-id: https://ssl.bulix.org/svn/lcd4linux/trunk@1118 3ae390bd-cb1e-0410-b409-cd5a39f66f1f


</td></tr>
<tr class='logheader'><td><span title='2010-04-18 11:47:58 +0000'>2010-04-18</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/drv_X11.c?id=299b4fb7dfccc166e5bbb34616b51da001ffb6d1&amp;follow=1'>X11 driver: correctly handle key releases</a></td><td>mzuther</td><td>2</td><td><span class='deletions'>-17</span>/<span class='insertions'>+28</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
git-svn-id: https://ssl.bulix.org/svn/lcd4linux/trunk@1117 3ae390bd-cb1e-0410-b409-cd5a39f66f1f


</td></tr>
<tr class='logheader'><td><span title='2010-03-12 22:17:15 +0000'>2010-03-12</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/drv_G15.c?id=d1c03f054cf14908aa5fc1f7d3eba6d4dcb46994&amp;follow=1'>changed hardcoded pixel resolution to configuration; usb_*_np functions only ↵</a></td><td>volker</td><td>1</td><td><span class='deletions'>-21</span>/<span class='insertions'>+30</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
if available; try to get USB vendor name

git-svn-id: https://ssl.bulix.org/svn/lcd4linux/trunk@1116 3ae390bd-cb1e-0410-b409-cd5a39f66f1f


</td></tr>
<tr class='logheader'><td><span title='2010-02-23 03:27:16 +0000'>2010-02-23</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/plugin_huawei.c?id=adaa4da6bb46042c127714a20fde31ff12fa96a2&amp;follow=1'>'Fix the huawei e220 at commands' by Jar</a></td><td>michael</td><td>1</td><td><span class='deletions'>-12</span>/<span class='insertions'>+9</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
git-svn-id: https://ssl.bulix.org/svn/lcd4linux/trunk@1115 3ae390bd-cb1e-0410-b409-cd5a39f66f1f


</td></tr>
<tr class='logheader'><td><span title='2010-02-15 21:44:43 +0000'>2010-02-15</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/drv_picoLCDGraphic.c?id=0bffa599cc6501471fcf97ea331f6ebd458fdadc&amp;follow=1'>drv_picoLCDGraphic.c: minimum USB read timeout is now 1 ms</a></td><td>mzuther</td><td>1</td><td><span class='deletions'>-1</span>/<span class='insertions'>+1</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
git-svn-id: https://ssl.bulix.org/svn/lcd4linux/trunk@1114 3ae390bd-cb1e-0410-b409-cd5a39f66f1f


</td></tr>
<tr class='logheader'><td><span title='2010-02-14 12:05:58 +0000'>2010-02-14</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/drv_picoLCDGraphic.c?id=3d85ed2b1731a7bef0f57fe6d70136c4f9fa6cc5&amp;follow=1'>drv_picoLCDGraphic.c: added configuration for USB read timeout</a></td><td>mzuther</td><td>1</td><td><span class='deletions'>-1</span>/<span class='insertions'>+9</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
git-svn-id: https://ssl.bulix.org/svn/lcd4linux/trunk@1113 3ae390bd-cb1e-0410-b409-cd5a39f66f1f


</td></tr>
<tr class='logheader'><td><span title='2010-02-14 02:47:49 +0000'>2010-02-14</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/plugin_fifo.c?id=3c4915845fd50fe5c5b1591f505df3cf60473f51&amp;follow=1'>indent.sh run</a></td><td>michael</td><td>1</td><td><span class='deletions'>-172</span>/<span class='insertions'>+171</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
git-svn-id: https://ssl.bulix.org/svn/lcd4linux/trunk@1112 3ae390bd-cb1e-0410-b409-cd5a39f66f1f


</td></tr>
<tr class='logheader'><td><span title='2010-02-14 02:46:43 +0000'>2010-02-14</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/plugin_huawei.c?id=2f27e641cea4f304e68a29ec1335b7b4215035c0&amp;follow=1'>plugin_huawei-fix-interval-check_V2.patch from Jar</a></td><td>michael</td><td>1</td><td><span class='deletions'>-35</span>/<span class='insertions'>+35</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
git-svn-id: https://ssl.bulix.org/svn/lcd4linux/trunk@1111 3ae390bd-cb1e-0410-b409-cd5a39f66f1f


</td></tr>
<tr class='logheader'><td><span title='2010-02-12 13:18:16 +0000'>2010-02-12</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/plugin_fifo.c?id=3a23df4023621d147789140298d9adff6c2c5438&amp;follow=1'>Improved config behavior.</a></td><td>mjona</td><td>1</td><td><span class='deletions'>-9</span>/<span class='insertions'>+32</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
git-svn-id: https://ssl.bulix.org/svn/lcd4linux/trunk@1110 3ae390bd-cb1e-0410-b409-cd5a39f66f1f


</td></tr>
<tr class='logheader'><td><span title='2010-02-12 13:16:27 +0000'>2010-02-12</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/cfg.c?id=4f3ae24f7c6365082e1bde846a9d39b7a337e228&amp;follow=1'>Fixed a segmentation fault bug in cfg_get().</a></td><td>mjona</td><td>1</td><td><span class='deletions'>-1</span>/<span class='insertions'>+1</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
git-svn-id: https://ssl.bulix.org/svn/lcd4linux/trunk@1109 3ae390bd-cb1e-0410-b409-cd5a39f66f1f


</td></tr>
<tr class='logheader'><td><span title='2010-02-11 16:48:56 +0000'>2010-02-11</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/plugin_fifo.c?id=555ed9099a1d3f78f059f9906c91022f98660cdc&amp;follow=1'>All static memory allocations were turned into dynamical ones.</a></td><td>mjona</td><td>1</td><td><span class='deletions'>-128</span>/<span class='insertions'>+200</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
Improved configuration parameters:
- FifoPath	to specify the fifo path (if absent, a built in replacement is used)
- FifoBufSize	to specify the size of the internal buffer (this parameter is optional as
		the plugin will try to match the number of display columns; if it fails and
		no FifoBufSize parameter is supplied then a built in replacement is used)
Simplified and rationalized init and exit functions:
most global variables have been localized.
Fixed several off-by-one overflows memory bugs.



git-svn-id: https://ssl.bulix.org/svn/lcd4linux/trunk@1108 3ae390bd-cb1e-0410-b409-cd5a39f66f1f


</td></tr>
<tr class='logheader'><td><span title='2010-02-07 20:45:51 +0000'>2010-02-07</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/timer.c?id=b35fc3f8cbd2ddda61fc256e771c61efc0457a59&amp;follow=1'>timer.c: two small optimizations (removed "flag"; tv_usec can't be negative)</a></td><td>mzuther</td><td>1</td><td><span class='deletions'>-7</span>/<span class='insertions'>+4</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
git-svn-id: https://ssl.bulix.org/svn/lcd4linux/trunk@1107 3ae390bd-cb1e-0410-b409-cd5a39f66f1f


</td></tr>
<tr class='logheader'><td><span title='2010-02-07 14:03:46 +0000'>2010-02-07</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/widget_timer.c?id=7496af7c8678b4ee97f9913b26dad028149eed79&amp;follow=1'>added grouping of widgets by update interval (new file "timer_group.c")</a></td><td>mzuther</td><td>13</td><td><span class='deletions'>-168</span>/<span class='insertions'>+441</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
git-svn-id: https://ssl.bulix.org/svn/lcd4linux/trunk@1106 3ae390bd-cb1e-0410-b409-cd5a39f66f1f


</td></tr>
<tr class='logheader'><td><span title='2010-02-07 02:52:59 +0000'>2010-02-07</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/timer.c?id=dcb29d2726791b4b770d4b36d27ee81d79a38f9e&amp;follow=1'>BUG: handle negative delays in timer_process() (timer.c)</a></td><td>mzuther</td><td>1</td><td><span class='deletions'>-0</span>/<span class='insertions'>+4</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
git-svn-id: https://ssl.bulix.org/svn/lcd4linux/trunk@1105 3ae390bd-cb1e-0410-b409-cd5a39f66f1f


</td></tr>
<tr class='logheader'><td><span title='2010-02-06 23:51:27 +0000'>2010-02-06</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/timer.c?id=7a8ba6a1135800510b93621b78e6d0d3f53e0c2c&amp;follow=1'>timer.c: I had forgotten how to initialize a "struct" :)</a></td><td>mzuther</td><td>1</td><td><span class='deletions'>-3</span>/<span class='insertions'>+4</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
git-svn-id: https://ssl.bulix.org/svn/lcd4linux/trunk@1104 3ae390bd-cb1e-0410-b409-cd5a39f66f1f


</td></tr>
<tr class='logheader'><td><span title='2010-02-06 21:42:05 +0000'>2010-02-06</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/timer.c?id=fd89168c6b1e62541f8aa683c6d03a1d19eba7e5&amp;follow=1'>BUG: compensate timers for processing delay ("timer.c")</a></td><td>mzuther</td><td>1</td><td><span class='deletions'>-1</span>/<span class='insertions'>+3</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
git-svn-id: https://ssl.bulix.org/svn/lcd4linux/trunk@1103 3ae390bd-cb1e-0410-b409-cd5a39f66f1f


</td></tr>
<tr class='logheader'><td><span title='2010-02-06 11:29:12 +0000'>2010-02-06</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/timer.c?id=43aef95679f4be26c5fb99c03d18118de3006f03&amp;follow=1'>timer.c: exchanged "proprietary code" with timeradd() and timersub() functions</a></td><td>mzuther</td><td>1</td><td><span class='deletions'>-14</span>/<span class='insertions'>+10</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
git-svn-id: https://ssl.bulix.org/svn/lcd4linux/trunk@1102 3ae390bd-cb1e-0410-b409-cd5a39f66f1f


</td></tr>
<tr class='logheader'><td><span title='2010-02-04 13:48:59 +0000'>2010-02-04</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/timer.c?id=15d08f4e90531ed35cea32538a7bd9e7a6ae7e32&amp;follow=1'>timer.c: removed fruitless changes to variable "flag" from timer_process()</a></td><td>mzuther</td><td>1</td><td><span class='deletions'>-2</span>/<span class='insertions'>+0</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
git-svn-id: https://ssl.bulix.org/svn/lcd4linux/trunk@1101 3ae390bd-cb1e-0410-b409-cd5a39f66f1f


</td></tr>
<tr class='logheader'><td><span title='2010-02-04 13:18:13 +0000'>2010-02-04</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/timer.c?id=39494819fd4f2741de434edb798755c399c66319&amp;follow=1'>According to its man page, timercmp() is broken on some systems -- applied ↵</a></td><td>mzuther</td><td>1</td><td><span class='deletions'>-1</span>/<span class='insertions'>+1</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
the recommended (and equivalent) change.

git-svn-id: https://ssl.bulix.org/svn/lcd4linux/trunk@1100 3ae390bd-cb1e-0410-b409-cd5a39f66f1f


</td></tr>
<tr class='logheader'><td><span title='2010-02-04 09:37:37 +0000'>2010-02-04</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/plugin_huawei.c?id=0dab110627d99bc1d2d5dbe1eec5765de1b287e9&amp;follow=1'>small warning removed</a></td><td>michael</td><td>1</td><td><span class='deletions'>-1</span>/<span class='insertions'>+1</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
git-svn-id: https://ssl.bulix.org/svn/lcd4linux/trunk@1099 3ae390bd-cb1e-0410-b409-cd5a39f66f1f


</td></tr>
<tr class='logheader'><td><span title='2010-02-04 09:37:12 +0000'>2010-02-04</span></td><td class='logsubject'><a href='/lcd4linux.git/commit/plugin_fifo.c?id=88b4878241e82dc129591b93091f06599b3d2d67&amp;follow=1'>clear errno after creating the FIFO by Claas Hilbrecht</a></td><td>michael</td><td>1</td><td><span class='deletions'>-0</span>/<span class='insertions'>+2</span></td></tr>
<tr class='nohover-highlight'><td/><td colspan='5' class='logmsg'>
git-svn-id: https://ssl.bulix.org/svn/lcd4linux/trunk@1098 3ae390bd-cb1e-0410-b409-cd5a39f66f1f


</td></tr>