- Wireless Tools
- --------------
+ Wireless Tools & IfRename
+ -------------------------
- This package contain the Wireless tools, used to manipulate
-the Wireless Extensions. The Wireless Extension is an interface
+ This package contains the Wireless tools, used to manipulate
+the Wireless Extensions. The Wireless Extensions is an interface
allowing you to set Wireless LAN specific parameters and get the
specific stats.
+ It also contains the IfRename package, used for advance
+renaming of network interfaces.
-web page
+web page :
--------
You'll find a lot of useful info on :
http://www.hpl.hp.com/personal/Jean_Tourrilhes/Linux/Tools.html
http://web.hpl.hp.com/personal/Jean_Tourrilhes/Linux/
+Precompiled version :
+-------------------
+ Most Linux distributions offer precompiled package containing
+these tools. And many of them preinstall them by default. On the other
+hand, installation of this package is (now) easy and allows you to get
+a more up-to-date version.
+
INSTALL
-------
- This file contains installation instruction and requirements.
+ This file contains installation instructions and requirements.
+ A *must*-read.
+
+DISTRIBUTION.txt
+----------------
+ This file documents how to configure wireless cards at
+boot time with various Linux distributions (using Wireless
+Extensions). Please read it carefully before asking questions.
+ In this file, I try to collect all the specifics of Wireless
+Extensions integration in the most common Linux distributions. I need
+your help to complete this file.
+
+HOTPLUG-UDEV.txt
+----------------
+ This file documents how to manage and configure removable
+wireless cards using Hotplug or uDev. This is more advanced than the
+simple procedures of DISTRIBUTION.txt. This is currently mostly Debian
+specific, but I hope you will contribute for other distributions.
PCMCIA.txt
----------
- This file describes how to use Pcmcia init script to configure
-Wireless Extensions and how to use Pcmcia schemes.
+ This file describes how to use PCMCIA init script to configure
+Wireless Extensions and how to use PCMCIA schemes.
man pages (iwconfig.8, iwlist.8, iwpriv.8, iwspy.8)
---------
- VERY IMPORTANT : I try to keep the man page up to date, so
+ VERY IMPORTANT : I try to keep the man pages up to date, so
you'd better read them before asking questions.
- ALSO IMPORTANT : Those man pages describe the capacity of the
-tools, no device implement the full range (and driver usually
+ ALSO IMPORTANT : Those man pages describe the capacities of
+the tools, no device implements the full range (and drivers usually
implement even less).
As far as I know, the man pages are the most complete, up to
date and accurate documentation of the wireless tools. An update of
-the web page related to Wireless Extension is long overdue. Send
+the web page related to Wireless Extensions is long overdue. Send
feedback to me.
- The man pages can either be copied in a location where the
+ The man pages can either be copied into a location where the
command "man" will find them, such as /usr/local/man/man8, or can be
read locally with the command :
nroff -man xxx.8 | less
+localised man pages (fr.ISO8859-1/* ; fr.UTF-8/* ; cs/*)
+-------------------
+ Localised man pages are not made by me, therefore the only
+localisations available are those sent to me by courageous volonteers,
+and I expect those man pages to 'lag' compared to the english
+version (i.e. not have all the latest updates). Translating man pages
+is not a very gratifying task, especially due to my broken english,
+and many technical terms don't translate well to other languages, so
+refer to the english version when in doubt.
+
iwconfig.c
----------
The main wireless tool. Used for device configuration and to see
iwspy.c
-------
- Mobile IP support test and allow get get stats per MAC address
-(instead of globally). Also, for some driver/device, this is the only
-way to get stats in Ad-Hoc mode.
+ Mobile IP support test and allows to get stats per MAC
+address (instead of globally). Also, for some drivers/devices, this is
+the only way to get stats in Ad-Hoc mode.
iwpriv.c
--------
iwgetid.c
---------
Output the ESSID or NWID of the specified device.
- Can also output it in a form that can be used as a Pcmcia Scheme.
+ Can also output it in a form that can be used as a PCMCIA Scheme.
+
+iwevent.c
+---------
+ Display Wireless Events. Most recent drivers will support this
+relatively new feature, but some older drivers may not support it.
+
+ifrename.c :
+----------
+ Rename network interfaces based on various selectors.
+
+iwlib.c
+-------
+ The Wireless Tools helper library. May be useful if you want
+to create your own applications using Wireless Extensions.
+
+iwmulticall.c
+-------------
+ Multicall version of the tools for embedded systems.
-Changelog, contributions
+Changelog, contributions :
------------------------
- See iwcommon.h
+ See CHANGELOG.h
wireless.h
----------
- Definition of the Wireless Extensions. You may drop this file
-in your kernel headers to update the Wireless Extensions.
+ Definition of the Wireless Extensions. Remember that the
+definition used by the drivers and the tools must match, otherwise
+funny things may happen. The tools try to check for that.
+ Since Wireless Extensions v12, you can no longer drop this
+file into your kernel headers to update the Wireless Extensions, you
+need to use the full patches available on my web page. So, the use is
+more if you plan to do some cross compile or something similar.
+ Just for your enjoyment, there are various releases of it. If
+your kernel/drivers are old, you may want to try the older releases...
+
+sample_xxx.c :
+------------
+ Various samples of code showing how to implement some of the
+more tricky features of Wireless Extensions in your driver.
+ Note that there is no guarantee that this code compiles, let
+alone works, but it should point you in the proper direction.
+ Also, have a look at existing drivers in the Linux kernel.
+
+19-udev-ifrename.rules :
+----------------------
+ udev rules to integrate properly ifrename (udev >= 107).
+
+iw26x_restore_full_essid.diff :
+-----------------------------
+ Current Linux kernel have a few bugs managing ESSID. These
+patches fix it. The first patch (iw261_...) is for kernel 2.6.19 to
+2.6.21, the second patch (iw262_...) is for kernel 2.6.22 and later.
Other tools :
-----------
- My web page above list many other tools using Wireless
+ My web page lists many other tools using Wireless
Extensions that you may find useful...
+ http://www.hpl.hp.com/personal/Jean_Tourrilhes/Linux/Tools.html#links
+Other questions :
+---------------
+ You have the source, and it is documented. In 99% of cases,
+you will find your answer there.
- The list of changes, credits and errata notes are in
-iwcommon.h. Compilation might be tricky, see iwcommon.h for header
-problems...
+ Good luck...
Jean <jt@hpl.hp.com>
OSDN Git Service
