File	Date	Author	Commit
CVS	2009-11-03	Don Park	[95d938] Initial checkin from CVS repo
misc	2009-11-03	Don Park	[95d938] Initial checkin from CVS repo
src	2009-11-03	Don Park	[95d938] Initial checkin from CVS repo
.gitignore	2009-11-03	Don Park	[f4e04e] first of the freshenups
COPYING	2009-11-03	Don Park	[95d938] Initial checkin from CVS repo
ChangeLog	2009-11-03	Don Park	[95d938] Initial checkin from CVS repo
Makefile.am	2009-11-03	Don Park	[95d938] Initial checkin from CVS repo
Makefile.in	2009-11-03	Don Park	[0a4378] first of the freshenups
README	2009-11-03	Don Park	[95d938] Initial checkin from CVS repo
autogen.sh	2009-11-03	Don Park	[95d938] Initial checkin from CVS repo
configure.ac	2009-11-03	Don Park	[95d938] Initial checkin from CVS repo
depcomp	2009-11-03	Don Park	[95d938] Initial checkin from CVS repo
install-sh	2009-11-03	Don Park	[95d938] Initial checkin from CVS repo
missing	2009-11-03	Don Park	[95d938] Initial checkin from CVS repo
mkinstalldirs	2009-11-03	Don Park	[95d938] Initial checkin from CVS repo

Read Me

21 December 2004
=== Building AP Radar ===

* Prerequisites
gtkmm 2.2 (www.gtkmm.org)
gtk 2.2 (www.gtk.org)

The Mandrake RPM packages I used for release 0.50 is
libgtkmm2.0_1-devel-2.2.8-2mdk
libsigc++1.2_5-devel-1.2.5-5mdk
libgtk+2.0_0-devel-2.2.4-2mdk
libiw26-devel-26-1mdk
and all their dependent RPMs.

* To build AP Radar from a source tarball, run configure
$ ./configure
$ make


* To build from CVS you have to do a funky automake dance:
$ sh autogen.sh
$ ./configure
$ make

AP Radar is meant to be a helpful "agent" to the end
user. It focuses on automating tedious tasks and using
the wireless extensions for linux to do its netstumbling. 
It should sense things like "oh now Im in range of my
home AP, so now I'll use that" and "that pesky wireless
driver changed ESSIDs when it shouldnt have, Ill set
the ESSID back to what it was" and "Oh I see my work
AP so I'll set the WEP key and hop on!" The scanning
support has the ability to watch for APs while saying 
associated to an AP.


== Troubleshooting ==

The single best test to see if AP Radar will work for you:
$ iwlist eth0 scanning
If you see this kind of output:
wlan0     Scan completed :
          Cell 01 - Address: 00:04:5A:0E:5F:2E
                    ESSID:"www.personaltelco.net/node74"
                    Mode:Master
[......]

Then AP Radar should work properly.

If you see anything else, then:
Are you using the Orinoco driver?
 As of version 0.13e, the orinoco driver does not
 support wireless scanning.
 wvlan, wavelan, and wavelan2 also do not support wireless scanning.

Are you using the HostAP driver?
 hostap v0.1.2 needs this flag set:
 iwpriv wlan0 host_roaming 1

Are you using the Aironet driver?
 There are no known problems with the airo driver.



== Contact ==

Project Page: http://apradar.sourceforge.net
Contact me: Don Park <donp@personaltelco.net>
Personal Telco Project http://www.personaltelco.net
Wireless Extensions for Linux: 
http://www.hpl.hp.com/personal/Jean_Tourrilhes/Linux/Tools.html