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>