mapi_readme.txt

MAPI: API for wireless cards under Linux 提供wireless的API函数。大家可以通过这个程序

********************************************************************
*       MAPI: API for wireless cards under Linux         Version 1.0 
*
*                   Moustafa A. Youssef 
*                       MIND Lab '01
*                                                          Nov, 2001
********************************************************************

. Contents
	1- License Agreement
	2- Descrption
	3- Files Included

1.  License Agreement

This API 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.

This API 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.

THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESS OR 
IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A 
PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE 
AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 
SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, 
BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 
INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF 
LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 
POSSIBILITY OF SUCH DAMAGE.


This API is based on the wireless tools by: Jean II - HPLB '99


2. Description

The MAPI API should work with any  device driver that supports wireless 
extensions provided that th driver inplements the wireless extensions 
correctly.

The API comes with 2 examples:
	- example1.c: lists most of the capabilities of the API.
	- example_ap.c: lists the specific capability of getting the 
	signal strength from all the access points in the range. For the 
	best of my knowledge, only the mwavelan_cs driver (available for 
	download at: www.cs.umd.edu/users/moustafa/mwavelan) supports this 
	feature.    

3. Files Included
	- mapi.h: API header file.
	- mapi.c: API implementation file.
	- iwcommon.h: Common functions from the wireless tools package.
	- iwcommon.c: Common functions implementation from the wireless 
	tools package.
	- example1.c: Example file for using the API.
	- example_ap.c: Example file for testing the access point 
	capabilities.
	- README.txt: This file. 


. Please send your comments and suggestions to:
	[e-mail]