wireless_tools/INSTALL

   1 Very important note :
   2 -------------------
   3         This release of the Wireless Tools is not compatible with
   4 Wireless Extensions earlier than 9. Version 9 and 10 should work fine
   5 but are not recommended. Version 8 and earlier will not work.
   6         Kernels that support this version of the Wireless Tools are
   7 listed below. For all kernels before that, see at the end.
   8
   9 You need :
  10 --------
  11         o Compiler and development environment
  12         o A kernel supporting wireless extensions version 11 or higher
  13                 -> from 2.4.4 onward (including 2.6.X)
  14                 Note : CONFIG_NET_RADIO must be enabled
  15         o (Optional) A Pcmcia package supporting Wireless Extension
  16         o A driver supporting wireless extensions
  17                 -> Check my web pages for status of various drivers.
  18         Note : more recent kernels and drivers are likely to support
  19                 more wireless extension features...
  20
  21 Compile wireless tools :
  22 ----------------------
  23         In theory, a "make" should suffice to create the tools.
  24
  25 Installation :
  26 ------------
  27         "make install" should do the right thing for you, and install
  28 the tools, their library and the man pages. You can also uninstall the
  29 tools via "make uninstall".
  30         Note that the default installation is in the directory
  31 '/usr/local/sbin'. This may not be in your path. Also, other version
  32 of the tools may exist on the system, so double check which version is
  33 the default and adjust your path as necessary.
  34
  35 Create a local copy of the tools :
  36 --------------------------------
  37         By default, the package is built with iwlib as a dynamic
  38 library, and the tool will expect to use the default version of libiw
  39 on the system.
  40         If you just want to experiment with a "local" version of the
  41 tools, you may want to pass the BUILD_STATIC flag to Makefile. It will
  42 create a self contained version of the tools.
  43 -------------
  44 make clean
  45 make BUILD_STATIC='y'
  46 -------------
  47         The resulting binary can be used in the compilation directory
  48 or installed in any place you like.
  49
  50 Wireless headers (past history) :
  51 -------------------------------
  52         Previous version of the Wireless Tools had to be compiled with
  53 the same version of Wireless Extension that the kernel was using, and
  54 that was a major source of troubles.
  55         Starting with version 27, Wireless Tools include all the ugly
  56 code to deal with any version of Wireless Extensions, so now you can
  57 compile a single "generic" version of the tools for any kernel.
  58         Well, there are some limits, Wireless Extensions earlier than
  59 v11 are not supported (v9 and v10 should work fine), and versions
  60 later than the latest definition in the package are not
  61 supported. Once compile, the command "iwconfig --version" should tell
  62 you that.
  63         Note that the previous option to make versioned installed of
  64 the tools no longer make sense and therefore is gone.
  65
  66 Other useful Makefile options :
  67 -----------------------------
  68         PREFIX : where the tools will be installed (default : /usr/local)
  69         BUILD_STATIC : build tools with a static version of the wireless lib
  70         BUILD_NOLIBM : build tools without mathematical lib (slower)
  71         Note that you should pass the same command line options for
  72 all invocations of make ("make" and "make install").
  73
  74         If you want the absolute minimal footprint, you may want to
  75 look into the multicall version of the tools. You can build it with
  76 "make iwmulticall" and install it with "make install-iwmulticall".
  77
  78 Old kernel with older Wireless Extensions :
  79 -----------------------------------------
  80         Kernel prior to 2.2.14 : Those kernels include Wireless
  81 Extensions v8 or earlier. Those versions don't have proper support for
  82 802.11b, so are not very useful. You may want to consider upgrading.
  83         Kernel 2.2.19 to 2.2.25 : Those kernels include Wireless
  84 Extensions v10. The tools should mostly work with it, but many drivers
  85 won't. You can upgrade those kernel to WE v15 with a patch on my web
  86 page.
  87         Kernel 2.2.14 to 2.2.18 : Those kernels include Wireless
  88 Extensions v9. Same as above, you may want to upgrade to a later 2.2.X
  89 kernel and then apply the patch.
  90         Kernel 2.0.X : Those kernels include very old version of
  91 Wireless Extensions. Same deal as old 2.2.X kernels.
  92
  93         Jean <jt@hpl.hp.com>