OSDN Git Service

v23
[android-x86/external-wireless-tools.git] / wireless_tools / INSTALL
index 9f39ed4..efa4eca 100644 (file)
@@ -1,35 +1,78 @@
+Very important note :
+-------------------
+       This release of the Wireless Tools is not compatible with Wireless
+       Extensions earlier than 9.
+       Kernels that support this version of the Wireless Tools are listed
+       below. For all kernels before that, please use the version v19 of
+       the Wireless Tools.
+       You might have headers troubles and it doesn't compile, see below...
+
 You need :
 --------
-       o A kernel supporting wireless extensions
-               -> from 2.1.17 onward
-               -> from 2.0.30 onward
-               -> patch available for 1.2.13
+       o Compiler and development environment
+       o A kernel supporting wireless extensions version 9 or higher
+               -> from 2.2.14 onward
+               -> from 2.3.24 onward
                Note : CONFIG_NET_RADIO must be enabled
-       o Driver supporting wireless extensions
-               -> Wavelan isa from kernel 2.1.17 onward
-               -> Wavelan pcmcia from pcmcia 2.9.2 onward
-               -> Netwave pcmcia from pcmcia 2.9.12 onward
-               -> Wavelan IEEE pcmcia drivers
-               -> Proxim RangeLan2/Symphony driver
-               -> Patch your favourite driver
+       o (Optional) A Pcmcia package supporting Wireless Extension
+       o A driver supporting wireless extensions
+               -> 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...
 
+Recommended versions :
+--------------------
+       This are the latest updates of the Wireless Extensions :
+       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 :
+               -> Check my web pages for latest list of drivers,
+                       otherwise patch your favourite driver...
+
 Compile wireless tools :
 ----------------------
-       In theory, a make should suffice.
-       In practice, there is big troubles with the headers. 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 buried in iwcommon.h.
+       In theory, a "make" should suffice to create the tools.
+       In practice, there is big troubles with the kernel
+headers. See below for how to fix that.
+       Note : as some internal data structures change from kernel to
+kernel, you are advised to not use the precompiled version of the
+tools but to recompile your own.
 
+Installation :
+------------
+       If I were you, I would not trust a "make install". If you feel
+courageous, just do "make install". It may even do the right thing.
+       I advise to copy the executable (iwconfig, iwspy and iwpriv)
+in /usr/local/sbin or /usr/sbin. The man pages (iwconfig.8, iwspy.8
+and iwpriv.8) should be copied in /usr/local/man/man8 or
+/usr/man/man8.
+       In fact, if you want to use Pcmcia wireless.opts, this step is
+mandatory...
 
-This package was originally created by:
-
-       Jean <jt@hpl.hp.com>
+Kernel headers (why it doesn't compile) :
+---------------------------------------
+       Some changes in the kernel headers and glibc headers are
+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.
 
-And is now being maintained by:
-       Justin Seger <jseger@media.mit.edu>
+       The second issue is that some distributions install some
+independant kernel headers in /usr/include. If you upgrade your
+kernel, those headers become out of sync and you don't benefit from
+the latest Wireless Extensions. Even worse, it can sometimes prevent
+the tools from compiling.
+       The trick is to copy the file .../include/linux/wireless.h
+from the kernel to the /usr/include headers.
+       A similar procedure may be used to update Wireless Extensions
+in an older kernel...
 
-It seem that I've been taking over !
        Jean <jt@hpl.hp.com>