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                 -> Check my web pages for latest list of drivers,
  20                         otherwise patch your favourite driver...
  21         Note : more recent kernels and drivers are likely to support
  22                 more wireless extension features...
  23
  24 Compile wireless tools :
  25 ----------------------
  26         In theory, a "make" should suffice to create the tools.
  27         In practice, there is big troubles with the kernel
  28 headers. See below for how to fix that.
  29         Note : as some internal data structures change from kernel to
  30 kernel, you are advised to not use the precompiled version of the
  31 tools but to recompile your own.
  32
  33 Installation :
  34 ------------
  35         If I were you, I would not trust a "make install". If you feel
  36 courageous, just do "make install". It may even do the right
  37 thing. Actually, with the various bugfixes that happened over the
  38 time, it nowadays tend to do the right thing.
  39         I advise to copy the executable (iwconfig, iwspy and iwpriv)
  40 in /usr/local/sbin or /usr/sbin. The man pages (iwconfig.8, iwspy.8
  41 and iwpriv.8) should be copied in /usr/local/man/man8 or
  42 /usr/man/man8.
  43         In fact, if you want to use Pcmcia wireless.opts, this step is
  44 mandatory...
  45
  46 Kernel headers (why it doesn't compile) :
  47 ---------------------------------------
  48         Some changes in the kernel headers and glibc headers are
  49 making my life difficult. We now have a mechanism to automatically
  50 select the proper header based on various bits of information (libc
  51 version & kernel version), but it may fail to do the right thing.
  52         You may also see the message :
  53                 "Your kernel/libc combination is not supported"
  54         If this happens to you, you will need to hack the rules at the
  55 top of iwlib.h and send me the patch.
  56
  57         The second issue is that some distributions install some
  58 independant kernel headers in /usr/include. If you upgrade your
  59 kernel, those headers become out of sync and you don't benefit from
  60 the latest Wireless Extensions. Even worse, it can sometimes prevent
  61 the tools from compiling.
  62         The trick is to copy the file .../include/linux/wireless.h
  63 from the kernel to the /usr/include headers.
  64
  65 Multi-kernel installation (expert only) :
  66 ---------------------------------------
  67         People who run different kernel on the same system may have
  68 problems due to the fact that those kernel have different version of
  69 Wireless Extensions and the Wireless Tools need to match the version
  70 of Wireless Extension used.
  71
  72         It is now possible to install multiple versions of the
  73 Wireless Tools on a system and get the proper version used based on
  74 the kernel running, using a redirector. However, this support is still
  75 experimental and for expert users only.
  76         The redirector will work properly only with kernel using
  77 Wireless Extensions version 16 and higher. Earlier version of Wireless
  78 Extensions will be detected as either v15 (v12, v13, v14 and v15) or
  79 as v11 (v11 and earlier).
  80
  81         The installation looks typically like :
  82 ------------------------------------
  83 make clean
  84 make FORCE_WEXT_VERSION=11
  85 make vinstall FORCE_WEXT_VERSION=11
  86 make clean
  87 make FORCE_WEXT_VERSION=15
  88 make vinstall FORCE_WEXT_VERSION=15
  89 make clean
  90 make FORCE_WEXT_VERSION=16
  91 make vinstall FORCE_WEXT_VERSION=16
  92 [...]
  93 ------------------------------------
  94
  95
  96         Jean <jt@hpl.hp.com>