X-Git-Url: http://git.osdn.net/view?p=android-x86%2Fexternal-wireless-tools.git;a=blobdiff_plain;f=wireless_tools%2FINSTALL;h=6093c2e8d75cef0ec4b4a912ac9766058b285423;hp=7aa92c00b20c141f3726b839f7a4d1a9381fcd14;hb=37268af80055faf826140ff0c255f495df34b616;hpb=bcc23ab3dacbe0d30b7b5e8adb7badbe2e254a7d diff --git a/wireless_tools/INSTALL b/wireless_tools/INSTALL index 7aa92c0..6093c2e 100644 --- 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. - 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 : -------- @@ -16,13 +14,17 @@ You need : -> 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 - -> Wavelan isa from kernels above - -> Wavelan pcmcia from pcmcia 3.1.2 onward - -> Netwave pcmcia from pcmcia 3.1.2 onward + -> Wavelan isa + -> Wavelan pcmcia + -> Netwave pcmcia -> Wavelan IEEE pcmcia drivers + -> Aironet MPL driver -> Proxim RangeLan2/Symphony driver - -> Patch your favourite driver + -> Raylink/WegGear2.4 driver + -> Check my web page for latest list of drivers, + otherwise patch your favourite driver... Note : more recent kernels and drivers are likely to support more wireless extension features... @@ -32,35 +34,55 @@ Recommended versions : o Kernel (wireless extension definition) : -> Kernel 2.2.14 onward -> Kernel 2.3.24 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) 1.0.1 onward - -> Wavelan IEEE pcmcia binary driver (wavelan2) v4.00 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) 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 -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 : ------------ + 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/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. + 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. + 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. -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