About
-----
Wireless Access Point Utilites for Unix - it's a set of utilites to configure
and monitor Wireless Access Points under Unix using SNMP protocol. Utilites
knownly compiles and run under Linux, FreeBSD, NetBSD, MacOS-X, AIX, QNX and OpenBSD.
Programs writen by Roman Festchook (  ) without any
help from manufacturers and released under the terms GNU General Public
License version 2.0. A copy of the license file is included with this
distribution package.

As for version 1.2 Wireless Access Point Utilites for Unix include three utils:

ap-config: config and get stats from AP:
	    setting briging, wireless and ip options, WEP encryption,
		mac authorization, radio signal power, communiti to
		restrict access to AP, enabling/disabling antennas,
		hiding ESSID in broadcast messages;
	    device test mode;
	    getting info about AP sofware and hardware, dynamically updated
		ethernet and wireless ports statistics, list of associated
		stations and vizible APs (option to save mac addresses of
		current associated stations to file);
	    executing commands on AP;
	config and get stats from devices that support 
	    MIB-II, IEEE 802.11 MIB and NWN DOT11EXT MIB:
	    setting briging and wireless options, WEP encryption,
		mac authorization, communities to restrict access to AP,
		enabling/disabling antennas;
	    getting info about AP sofware and hardware, dynamically updated 
		wireless port statistics, information about latest events
		and errors, list of current associated stations	with info
		about signal quality and station activity (option to save
		mac addresses of associated stations to file);
	search for connected APs;
	nice and portable ncurses-based user interface with context-help
		navigation menus, floating drop-down menus to choose from
		options list, options file to store connect options and
		subshell.
	
ap-mrtg: to get stat from AP (ATMEL based) and return it in MRTG parsable format:
	getting ethernet statistics in bytes, wireless statistics in packets,
		associated stations number and Link Quality/Signal Strenght
		stats from AP in client mode.
	
ap-trapd: to receive, parse and log trap messages from AP (ATMEL based):
	log data using standart syslogd;
	running by not privileged user;
	listening on the specified interface (only on Linux).

Supported Hardware
------------------
ap-utils support Atmel chipset based Access Points with ATMEL Private MIB,
also supported No Wires Needed APs (IEEE 802.11 MIB and NWN DOT11EXT MIB) and
Netgear ME102 with new entreprise-id.
Known/Reported working hardware you can find in table.
If you have ap-utils worked with not listed hardware please report.
If it possible include in your report sysinfo screen from config utility.

+------------------------------------------------------------------------------+
|				Supported Access Points			       |
+------------------------------------------------------------------------------+
| Manufacturer			| Models		| Type		       |
+-------------------------------+-----------------------+----------------------+
| Global Sun			| ProWave GL2411AP	| ATMEL		       |
| Linksys	    		| WAP11 pre2 version	| ATMEL		       |
| SMC		    		| MC2655W		| ATMEL		       |
| Netgear	    		| ME102		  	| ATMEL, ME102	       |
| Eumitcom	    		| WA3001A		| ATMEL		       |
| Edimax	    		| EW-7205		| ATMEL		       |
| Target	    		| WLAP 24212		| ATMEL  	       |
| Micronet          		| SP918			| ATMEL		       |
| Smartbridges	    		| airPoint, airBridge	| ATMEL		       |
| Belkin Components 		| F5D6130		| ATMEL		       |
| GemTek	    		| TEW-210APB		| ATMEL		       |
| GemTek            		| WX-1500		| NWN		       |
| Intellinet        		| AP, Wireless Bridge	| ATMEL		       |
| D-Link	    		| DWL 900AP		| ATMEL		       |
| D-Link	    		| DWL 1000AP		| NWN		       |
| WLink Syst. (D-Link subs.)	| Wen-2021		| ATMEL		       |
| Compex	    		| WavePort WP11		| NWN		       |
| Zoom		    		| ZoomAir11AP		| NWN		       |
| Telecom	    		| T-Sinus 130X		| ATMEL		       |
| Ovislink          		| Airlive WL-1100AP	| ATMEL		       |
| CC&C Technologies 		| Access Point		| ATMEL		       |
| Compaq	    		| WL-400		| NWN (mostly works)   |
| Asus		    		| WL-300		| ATMEL		       |
| Topcom	    		| SkyLanR@cer 500	| ATMEL		       |
| Fiberline			| WL-1200AP		| ME102		       |
| CNet				| CNAP-711		| ATMEL		       |
| Yakumo			| Access Point		| ATMEL		       |
| Dynalink (Askey)		| RTW020		| ATMEL		       |
| Acer				| Warplink EJA-A	| NWN		       |
| Svec				| FD1811		| ATMEL, ME102	       |
+-------------------------------+-----------------------+----------------------+

Where to get more information
-----------------------------
You can find info about utils from this README and from man pages
for utilites, also read INSTALL and TODO files at top level directory.
In the Documentation directory of this packages and in our web page
http://ap-utils.polesye.net/ you can find additional info and useful links.
Also we have maillist to discuss any related topics - more info at
http://ap-utils.polesye.net/.

Contributing & reporting problems
---------------------------------
Any help in developing, bugfixing and testing are welcome. Also any
additional documentation, free hardware to support it and job offers
greatly welcomed.
Any comments please send to my email - roma at polesye.net or to maillist.

Before sending bugreports please read docs (firstly README and FAQ) and 
upgrade to latest version of utils. If problem still exist please,
send a detailed description of your problem to maillist.
Include the version of the program, the operating system that you are
using, the compiler and compiler flags used to compile the program (if
you know them), what kind of distribution you are using (if a
GNU/Linux system).
If the program crashed and produces a core dump, please provide a
stack trace of the program.
You can do this by running dbx or gdb like this:
    gdb <utility_name> core
    (gdb) where

