OSDN Git Service

6093c2e8d75cef0ec4b4a912ac9766058b285423
[android-x86/external-wireless-tools.git] / wireless_tools / INSTALL
1 Very important note :
2 -------------------
3         This release of the Wireless Tools is not compatible with Wireless
4         Extensions earlier than 9.
5         Kernels that support this version of the Wireless Tools are listed
6         below. For all kernels before that, please use the version v19 of
7         the Wireless Tools.
8         You might have headers troubles and it doesn't compile, see below...
9
10 You need :
11 --------
12         o Compiler and development environment
13         o A kernel supporting wireless extensions version 9 or higher
14                 -> from 2.2.14 onward
15                 -> from 2.3.24 onward
16                 Note : CONFIG_NET_RADIO must be enabled
17         o (Optional) A Pcmcia package supporting Wireless Extension
18         o A driver supporting wireless extensions
19                 -> Wavelan isa
20                 -> Wavelan pcmcia
21                 -> Netwave pcmcia
22                 -> Wavelan IEEE pcmcia drivers
23                 -> Aironet MPL driver
24                 -> Proxim RangeLan2/Symphony driver
25                 -> Raylink/WegGear2.4 driver
26                 -> Check my web page for latest list of drivers,
27                         otherwise patch your favourite driver...
28         Note : more recent kernels and drivers are likely to support
29                 more wireless extension features...
30
31 Recommended versions :
32 --------------------
33         This are the latest updates of the Wireless Extensions :
34         o Kernel (wireless extension definition) :
35                 -> Kernel 2.2.14 onward
36                 -> Kernel 2.3.24 onward
37         o Pcmcia package :
38                 -> Pcmcia 3.1.15 onward
39         o Drivers with wireless extension support :
40                 -> Wavelan isa from kernels above
41                 -> Wavelan pcmcia from pcmcia 3.1.1 onward
42                 -> Netwave pcmcia from pcmcia 3.1.2 onward
43                 -> Wavelan IEEE pcmcia GPL driver (wvlan_cs) 1.0.5 onward
44                 -> Aironet MPL driver (airo_cs.c) 1.4 onward
45                 -> Proxim RangeLan2/Symphony driver 1.4.3 onward
46                 -> Raylink/WegGear2.4 driver 1.70 (note : read only)
47
48 Compile wireless tools :
49 ----------------------
50         In theory, a "make" should suffice to create the tools.
51         In practice, there is big troubles with the kernel
52 headers. See below for how to fix that.
53         Note : as some internal data structures change from kernel to
54 kernel, you are advised to not use the precompiled version of the
55 tools but to recompile your own.
56
57 Installation :
58 ------------
59         If I were you, I would not trust a "make install". If you feel
60 courageous, just do "make install". It may even do the right thing.
61         I advise to copy the executable (iwconfig, iwspy and iwpriv)
62 in /usr/local/sbin or /usr/sbin. The man pages (iwconfig.8, iwspy.8
63 and iwpriv.8) should be copied in /usr/local/man/man8 or
64 /usr/man/man8.
65         In fact, if you want to use Pcmcia wireless.opts, this step is
66 mandatory...
67
68 Kernel headers (why it doesn't compile) :
69 ---------------------------------------
70         Some changes in the kernel headers and glibc headers are
71 making my life difficult.
72         If you have glibc and kernel 2.2.X headers (or greater), that
73 should be all right. This is the default for most modern distributions.
74         In the other cases, depending on which version of the kernel
75 headers (might be different from kernel) and library headers you have,
76 you need to play with the options at the top of the Makefile.
77
78         The second issue is that some distributions install some
79 independant kernel headers in /usr/include. If you upgrade your
80 kernel, those headers become out of sync and you don't benefit from
81 the latest Wireless Extensions. Even worse, it can sometimes prevent
82 the tools from compiling.
83         The trick is to copy the file .../include/linux/wireless.h
84 from the kernel to the /usr/include headers.
85         A similar procedure may be used to update Wireless Extensions
86 in an older kernel...
87
88         Jean <jt@hpl.hp.com>