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         If your kernel has the relevant Wireless Extensions but the tools
   9         refuse to compile, then your kernel headers in /usr/include are
  10         pointing to the wrong place (very common with Debian).
  11
  12 You need :
  13 --------
  14         o Compiler and development environment
  15         o A kernel supporting wireless extensions version 9 or higher
  16                 -> from 2.2.14 onward
  17                 -> from 2.3.24 onward
  18                 Note : CONFIG_NET_RADIO must be enabled
  19         o A driver supporting wireless extensions
  20                 -> Wavelan isa from kernels above
  21                 -> Wavelan pcmcia from pcmcia 3.1.2 onward
  22                 -> Netwave pcmcia from pcmcia 3.1.2 onward
  23                 -> Wavelan IEEE pcmcia drivers
  24                 -> Proxim RangeLan2/Symphony driver
  25                 -> Patch your favourite driver
  26         Note : more recent kernels and drivers are likely to support
  27                 more wireless extension features...
  28
  29 Recommended versions :
  30 --------------------
  31         This are the latest updates of the Wireless Extensions :
  32         o Kernel (wireless extension definition) :
  33                 -> Kernel 2.2.14 onward
  34                 -> Kernel 2.3.24 onward
  35         o Drivers with wireless extension support :
  36                 -> Wavelan isa from kernels above
  37                 -> Wavelan pcmcia from pcmcia 3.1.1 onward
  38                 -> Netwave pcmcia from pcmcia 3.1.2 onward
  39                 -> Wavelan IEEE pcmcia GPL driver (wvlan) 1.0.1 onward
  40                 -> Wavelan IEEE pcmcia binary driver (wavelan2) v4.00 onward
  41                 -> Proxim RangeLan2/Symphony driver 1.4.3 onward
  42
  43 Compile wireless tools :
  44 ----------------------
  45         In theory, a "make" should suffice.
  46         In practice, there is big troubles with the headers. If you
  47 have glibc and kernel 2.2.X headers, that should be all
  48 right. Depending on which version of the kernel headers (might be
  49 different from kernel) and library headers you have, you need to play
  50 with the options buried in iwcommon.h.
  51         Note : as some internal data structures change from kernel to
  52 kernel, you are advised to not use the precompiled version but to
  53 recompile your own.
  54         "xwireless" is not currently in a compilable state.
  55
  56 Installation :
  57 ------------
  58         I advise to copy the executable (iwconfig, iwspy and iwpriv)
  59 in /usr/local/bin or /usr/local/sbin. The man pages (iwconfig.8,
  60 iwspy.8 and iwpriv.8) should be copied in /usr/local/man/man8 or
  61 /usr/man/man8.
  62
  63
  64 List of contributors and changelog is in iwcommon.h.
  65
  66         Jean <jt@hpl.hp.com>