v23

[android-x86/external-wireless-tools.git] / wireless_tools / INSTALL

diff --git a/wireless_tools/INSTALL b/wireless_tools/INSTALL
index 7aa92c0..efa4eca 100644 (file)
--- a/wireless_tools/INSTALL
+++ b/wireless_tools/INSTALL
@@ -5,9 +5,7 @@ Very important note :
        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.
        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.

-       If your kernel has the relevant Wireless Extensions but the tools
-       refuse to compile, then your kernel headers in /usr/include are
-       pointing to the wrong place (very common with Debian).
+       You might have headers troubles and it doesn't compile, see below...

 
 You need :
 --------
 
 You need :
 --------


@@ -16,13 +14,10 @@ You need :
                -> from 2.2.14 onward
                -> from 2.3.24 onward
                Note : CONFIG_NET_RADIO must be enabled
                -> from 2.2.14 onward
                -> from 2.3.24 onward
                Note : CONFIG_NET_RADIO must be enabled

+       o (Optional) A Pcmcia package supporting Wireless Extension

        o A driver supporting wireless extensions
        o A driver supporting wireless extensions

-               -> Wavelan isa from kernels above
-               -> Wavelan pcmcia from pcmcia 3.1.2 onward
-               -> Netwave pcmcia from pcmcia 3.1.2 onward
-               -> Wavelan IEEE pcmcia drivers
-               -> Proxim RangeLan2/Symphony driver
-               -> Patch your favourite driver
+               -> 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...
 
        Note : more recent kernels and drivers are likely to support
                more wireless extension features...
 


@@ -32,35 +27,52 @@ Recommended versions :
        o Kernel (wireless extension definition) :
                -> Kernel 2.2.14 onward
                -> Kernel 2.3.24 onward
        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 :
        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) 1.0.1 onward
-               -> Wavelan IEEE pcmcia binary driver (wavelan2) v4.00 onward
-               -> Proxim RangeLan2/Symphony driver 1.4.3 onward
+               -> Check my web pages for latest list of drivers,
+                       otherwise patch your favourite driver...

 
 Compile wireless tools :
 ----------------------
 
 Compile wireless tools :
 ----------------------

-       In theory, a "make" should suffice.
-       In practice, there is big troubles with the headers. If you
-have glibc and kernel 2.2.X headers, that should be all
-right. 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
        Note : as some internal data structures change from kernel to

-kernel, you are advised to not use the precompiled version but to
-recompile your own.
-       "xwireless" is not currently in a compilable state.
+kernel, you are advised to not use the precompiled version of the
+tools but to recompile your own.

 
 Installation :
 ------------
 
 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)
        I advise to copy the executable (iwconfig, iwspy and iwpriv)

-in /usr/local/bin or /usr/local/sbin. The man pages (iwconfig.8,
-iwspy.8 and iwpriv.8) should be copied in /usr/local/man/man8 or
+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.
 /usr/man/man8.

+       In fact, if you want to use Pcmcia wireless.opts, this step is
+mandatory...

 
 

+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.

 
 

-List of contributors and changelog is in iwcommon.h.
+       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...

 
        Jean <jt@hpl.hp.com>
 
        Jean <jt@hpl.hp.com>