_     _   ___   _   _  _____  _   _   ___   __   _
   | | _ | | / _ \ | | | || ____|| |_| | / _ \ |  \ | |
   | || || || /_\ || | | || ___| | ___ || /_\ ||   \| |
   | || || || ___ | \ | / | |___ | | | || ___ || |\   |
www.\_/ \_/ |_| |_|  \_/  |_____||_| |_||_| |_||_| \__|.de

wireless extensions for linux-wlan-ng 
version 0.0.3-2

COPYRIGHT
---------
This application 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 of the License, or (at your option) any later version. 

This application 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
Library General Public License for more details.

You should have received a copy of the GNU General Public
License along with this library; if not, write to the Free
Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
02111 USA.  

Note: 
Please have a look at https://www.wavehan.de/www/projekte/prism2/COPYING
or http://www.gnu.org/ for the complete GNU GPL 2.0 License

ABOUT
-----
	NOTE: This is not a part of the linux-wlan-ng project, yet.
 
	Wireless Tools 10+ compatibility for linux-wlan-ng based on
	code of wlancfg and orinoco_cs. It should be possible to have
	a full- featured, enhanced replacement of the kernel- wireless
	drivers without loosing the compatibility to common interfaces
	like /proc/net/wireless and iwconfig. 
	
INSTALLATION
------------

	- Please check if you've enabled "CONFIG_NET_WIRELESS" and
	"CONFIG_NET_RADIO" in your kernel configuration.

	- Extract linux-wlan-ng:
		# tar zxvf linux-wlan-ng-x.x.x.tar.gz

	- Apply the patch:
		# patch -p0 < linux-wlan-ng-x.x.x.wireless-ext.x.x.x.diff

	- Compile:
		# cd linux-wlan-ng-x.x.x
		# make config all install

STATE
-----
	- /proc/net/wireless support works

	Examples:

	A PrismII- card: 
	---
	Inter-| sta-|   Quality        |   Discarded packets
 	 face | tus | link level noise |  nwid  crypt   misc
 	 wlan0: 0000   64.  111.    0.       0      0      0
	---	

	A PrismII- card in ap- mode:
	--- 
	Inter-| sta-|   Quality        |   Discarded packets
 	 face | tus | link level noise |  nwid  crypt   misc
 	 wlan0: 0001    0.    0.    0.       0      0      0
	---


	- wireless extension ioctls support works 

	currently supported ioctls:
	SIOCGIWNAME  /* get name == wireless protocol */	
	SIOCSIWFREQ  /* set channel */
	SIOCGIWFREQ  /* get channel */
	SIOCGIWMODE  /* get operation mode */
	SIOCGIWAP    /* get access point MAC addresses */
	SIOCGIWESSID /* get ESSID */	
	SIOCGIWNICKN /* get node name/nickname */
	SIOCGIWPRIV  /* get private ioctls for iwpriv. This is
			not necessary and not implemented but
			i'll return a useless dummy for
			demonstration. */ 

	Example:
	
	A PrismII- card:
	---
	# iwconfig wlan0
	wlan0     IEEE 802.11-b  ESSID:"non-spec"  Nickname:"reyk"
          Mode:Managed  Channel:3  Access Point: 44:44:44:44:44:44
          Link Quality:0  Signal level:27  Noise level:27
          Rx invalid nwid:0  invalid crypt:0  invalid misc:0
	---

TODO
----
	- testing and debuging
	- implementation of more wireless extension- ioctls:
		- set essid
		- set nick
		- ...
	- ...
	- Hermes (Lucent) support?

CONTACT
-------
	Reyk Floeter <reyk@synack.de>, https://reyk.synack.de/
	GnuPG key fingerprint:
	5B32 5DF9 0281 0F4D 44A7  567A 0141 6092 729F 899D

	Project Homepage:
 	https://www.wavehan.de/projekte/prism2/
	
	CVS:
	[disfunct]

END ;-)