v23

wireless_tools/CHANGELOG.h

@@ -1,11 +1,12 @@
 /*
  *	Wireless Tools
  *
- *		Jean II - HPLB 97->99 - HPL 99->01
+ *		Jean II - HPLB 97->99 - HPL 99->02
  *
  * The changelog...
  *
- * This file is released under the GPL license.
+ * This files is released under the GPL license.
+ *     Copyright (c) 1997-2002 Jean Tourrilhes <[email protected]>
  */
 
 /* --------------------------- HISTORY --------------------------- */
@@ -148,6 +149,30 @@
  *	o Show typical/average quality in iwspy [iwspy]
  *	o Get Wireless Stats through ioctl instead of /proc [iwlib]
  *
+ * wireless 23 :
+ * -----------
+ *	o Split iw_check_addr_type() into two functions mac/if [iwlib]
+ *	o iw_in_addr() does appropriate iw_check_xxx itself  [iwlib]
+ *	o Allow iwspy on MAC address even if IP doesn't check [iwspy]
+ *	o Allow iwconfig ap on MAC address even if IP doesn't check [iwconfig]
+ *	---
+ *	o Fix iwlist man page about extra commands [iwlist]
+ *	---
+ *	o Fix Makefile rules for library compile (more generic) [Makefile]
+ *	---
+ *	o Set max length for all GET request with a iw_point [various]
+ *	o Fix set IW_PRIV_TYPE_BYTE to be endian/align clean [iwpriv]
+ *	---
+ *		(From Kernel Jake <[email protected]>)
+ *	o Add '/' at the end of directories to create them [Makefile]
+ *		(From Pavel Roskin <[email protected]>)
+ *	o Replace "cp" with "install" to get permissions proper [Makefile]
+ *	o Install Man-Pages at the proper location [Makefile]
+ *	o Add automatic header selection based on libc/kernel [iwlib.h]
+ *	---
+ *	o Add "commit" to force parameters on the card [iwconfig]
+ *	o Wrap ioctl() in iw_set/get_ext() wrappers [all]
+ *	o Beautify set request error messages [iwconfig]
  */
 
 /* ----------------------------- TODO ----------------------------- */

wireless_tools/INSTALL

@@ -16,14 +16,7 @@ You need :
 		Note : CONFIG_NET_RADIO must be enabled
 	o (Optional) A Pcmcia package supporting Wireless Extension
 	o A driver supporting wireless extensions
-		-> Wavelan isa
-		-> Wavelan pcmcia
-		-> Netwave pcmcia
-		-> Wavelan IEEE pcmcia drivers
-		-> Aironet MPL driver
-		-> Proxim RangeLan2/Symphony driver
-		-> Raylink/WegGear2.4 driver
-		-> Check my web page for latest list of drivers,
+		-> Check my web pages for latest list of drivers,
 			otherwise patch your favourite driver...
 	Note : more recent kernels and drivers are likely to support
 		more wireless extension features...
@@ -34,16 +27,12 @@ Recommended versions :
 	o Kernel (wireless extension definition) :
 		-> Kernel 2.2.14 onward
 		-> Kernel 2.3.24 onward
+		-> Kernel 2.4.0 onward
 	o Pcmcia package :
 		-> Pcmcia 3.1.15 onward
 	o Drivers with wireless extension support :
-		-> Wavelan isa from kernels above
-		-> Wavelan pcmcia from pcmcia 3.1.1 onward
-		-> Netwave pcmcia from pcmcia 3.1.2 onward
-		-> Wavelan IEEE pcmcia GPL driver (wvlan_cs) 1.0.5 onward
-		-> Aironet MPL driver (airo_cs.c) 1.4 onward
-		-> Proxim RangeLan2/Symphony driver 1.4.3 onward
-		-> Raylink/WegGear2.4 driver 1.70 (note : read only)
+		-> Check my web pages for latest list of drivers,
+			otherwise patch your favourite driver...
 
 Compile wireless tools :
 ----------------------
@@ -68,12 +57,13 @@ mandatory...
 Kernel headers (why it doesn't compile) :
 ---------------------------------------
 	Some changes in the kernel headers and glibc headers are
-making my life difficult.
-	If you have glibc and kernel 2.2.X headers (or greater), that
-should be all right. This is the default for most modern distributions.
-	In the other cases, depending on which version of the kernel
-headers (might be different from kernel) and library headers you have,
-you need to play with the options at the top of the Makefile.
+making my life difficult. We now have a mechanism to automatically
+select the proper header based on various bits of information (libc
+version & kernel version), but it may fail to do the right thing.
+	You may also see the message :
+		"Your kernel/libc combination is not supported"
+	If this happens to you, you will need to hack the rules at the
+top of iwlib.h and send me the patch.
 
 	The second issue is that some distributions install some
 independant kernel headers in /usr/include. If you upgrade your

wireless_tools/Makefile

@@ -4,8 +4,9 @@
 
 # Targets to build
 STATIC=libiw.a
-DYNAMIC=libiw.so.22
+DYNAMIC=libiw.so.23
 PROGS= iwconfig iwlist iwpriv iwspy iwgetid
+MANPAGES=iwconfig.8 iwlist.8 iwpriv.8 iwspy.8
 
 # Composition of the library :
 OBJS = iwlib.o
@@ -16,26 +17,12 @@ IWLIBS=$(OBJS)
 
 # Installation directory. By default, go in local.
 # Distributions should probably use /usr/sbin, but they probably know better...
-INSTALL_DIR= /usr/local/sbin
-INSTALL_LIB= /usr/local/lib
-INSTALL_INC= /usr/local/include
+INSTALL_DIR= /usr/local/sbin/
+INSTALL_LIB= /usr/local/lib/
+INSTALL_INC= /usr/local/include/
+INSTALL_MAN= /usr/local/man
 
-# This is our header selection. Try to hide the mess and the misery :-(
-# Please choose *only one* of the define...
-
-# Kernel headers 2.4.X + Glibc 2.2 - Mandrake 8.0, Debian 2.3, RH 7.1
-#HEADERS= -DGLIBC22_HEADERS
-
-# Kernel headers 2.0.X + Glibc 2.0 - Debian 2.0, RH 5
-# Kernel headers 2.2.X + Glibc 2.1 - Debian 2.2, RH 6.1
-# Kernel headers 2.4.X + Glibc 2.1 - Debian 2.2 upgraded, RH 7.0
-HEADERS= -DGLIBC_HEADERS
-
-# Kernel headers 2.2.X + Glibc 2.0 - Debian 2.1
-#HEADERS= -DKLUDGE_HEADERS
-
-# Kernel headers 2.0.X + libc5 - old systems
-#HEADERS= -DLIBC5_HEADERS
+# Header selection is now supposed to be automatic...
 
 # Use private copy of Wireless Extension definition instead of the
 # system wide one in /usr/include/linux. Use with care.
@@ -76,21 +63,24 @@ iwgetid: iwgetid.o
 	$(CC) $(CFLAGS) -o $@ $^
 
 # Compilation of the dynamic library
-libiw.so.22: $(OBJS)
+$(DYNAMIC): $(OBJS)
 	$(CC) -O2 -shared -o $@ -Wl,-soname,$@ -lm -lc $^
 
 # Compilation of the static library
-libiw.a: $(OBJS)
+$(STATIC): $(OBJS)
 	$(RM) $@
 	ar cru $@ $^
 	ranlib $@
 
 # So crude but so effective ;-)
+# Less crude thanks to many contributions ;-)
 install::
-	cp $(PROGS) $(INSTALL_DIR)
-	cp $(STATIC) $(DYNAMIC) $(INSTALL_LIB)
-	echo "Don't forget to fix you /etc/ld.so.conf and run ldconfig."
-	cp iwlib.h $(INSTALL_INC)
+	install -m 755 $(PROGS) $(INSTALL_DIR)
+	install -m 644 $(STATIC) $(INSTALL_LIB)
+	install -m 755 $(DYNAMIC) $(INSTALL_LIB)
+	echo "Don't forget to fix your /etc/ld.so.conf and run ldconfig."
+	install -m 644 iwlib.h $(INSTALL_INC)
+	install -m 644 $(MANPAGES) $(INSTALL_MAN)/man8/
 
 clean::
 	$(RM_CMD) 

wireless_tools/iwconfig.8

@@ -20,6 +20,8 @@ iwconfig \- configure a wireless network interface
 .BI "                   [rate " R "] [rts " RT "] [frag " FT "] [txpower " T ]
 .br
 .BI "                   [enc " E "] [key " K "] [power " P "] [retry " R ]
+.br
+.BI "                   [commit]
 .\"
 .\" DESCRIPTION part
 .\"
@@ -324,6 +326,15 @@ is the short retry limit (non RTS/CTS packets).
 .I "	iwconfig eth0 retry lifetime 300m"
 .br
 .I "	iwconfig eth0 retry min limit 8"
+.TP
+.BR commit
+Some cards may not apply changes done through Wireless Extensions
+immediately (they may wait to agregate the changes or apply it only
+when the card is brought up). This command (when available) force
+the card to apply all pending changes.
+.br
+This is normally not needed, because the card will eventually apply
+the changes, but can be usefull for debugging.
 .\"
 .\" DISPLAY part
 .\"