wireless_tools/DISTRIBUTIONS.txt

   1         Distribution specific notes on Wireless Configuration
   2         -----------------------------------------------------
   3
   4 ***** HELP *****
   5         If people send me information about the specifics of each
   6 distribution, I'll try to collect that here. Don't forget to mention
   7 to which distribution those instructions apply, the tool used (if any)
   8 and the files modified.
   9         Actually, the people packaging my tools for a specific
  10 distribution have a moral obligation to send me the exact detailed
  11 instructions of what they have done. I will list in the wireless.7
  12 man page only distributions that give me an official answer.
  13 ***** HELP *****
  14
  15                                 -----
  16
  17 INTRODUCTION
  18 ------------
  19         The tools enable users to change the card settings at run time
  20 (when running iwconfig, for example). However, most users want the
  21 card to be configured either at boot time or when the card is
  22 activated in the system.
  23         Each distribution has its own configuration scripts, and
  24 therefore is slightly different. Some distributions even add some
  25 graphical setup tool (nice). This file describe the procedure for a
  26 few of them.
  27         Note : if you install the Pcmcia package in source form from
  28 the official Linux-Pcmcia web site (as opposed to precompiled by a
  29 distribution, please use the PCMCIA method).
  30
  31         Please remember : I don't use your distribution, and I have
  32 absolutely no clue about how your distribution works. I'm just
  33 collecting random information here without beeing able to verify it.
  34
  35                                 -----
  36
  37 WIRELESS DRIVERS
  38 ----------------
  39         Most Linux wireless drivers support Wireless Extensions, and
  40 therefore may be configure via Wireless Tools and the methods
  41 described in this file.
  42
  43         However, a few drivers have no support or limited support for
  44 Wireless Extensions (like read only). In those cases, these are your
  45 options :
  46                 o read the driver documentation.
  47                 o use the driver specific interface or tools to
  48 configure the card, and try to integrate that in your distribution.
  49                 o implement Wireless Extension support in the driver.
  50         In some cases, there are easier workaround. Different version
  51 of the driver may add Wireless Extension (often alongside the
  52 proprietary method). In some other case, there may be another driver
  53 supporting the same card and with support for Wireless Extensions.
  54
  55         Some Linux wireless drivers don't export all wireless settings
  56 via Wireless Extensions, not even through iwpriv. Those setting may be
  57 available through the driver specific interface. Refer to previous
  58 section for workarounds.
  59
  60 ---------------------------------------------------------------------
  61
  62 PCMCIA METHOD
  63 -------------
  64                 (Contributed by Jean Tourrilhes <jt@hpl.hp.com>)
  65         This method work for *all* distributions.
  66         For Pcmcia cards, it is possible to overwrite the Pcmcia
  67 configuration files of the distribution with the original Pcmcia
  68 configuration files from the Pcmcia package (/etc/pcmcia/*). If you
  69 install the Pcmcia package in source form from the official
  70 Linux-Pcmcia web site, this will be done automatically.
  71         Once this is done, you can no longer use the specific tools
  72 and configuration files of the distribution, and are required to use
  73 Pcmcia style of configuration (see Pcmcia Howto).
  74         In such a case, Wireless configuration is done through
  75 wireless.opts, and documented in the file PCMCIA.txt.
  76
  77 ---------------------------------------------------------------------
  78
  79 DEBIAN 2.2 (and earlier)
  80 ----------
  81                 (Contributed by Jean Tourrilhes <jt@hpl.hp.com>)
  82         Debian 2.2 (and earlier) doesn't support any Wireless
  83 Configuration. You are required to use the Pcmcia method. Also, the
  84 Wireless Tools package is not part of the standard packages.
  85
  86 ---------------------------------------------------------------------
  87
  88 DEBIAN 3.0 (and later)
  89 ----------
  90                 (Contributed by Guus Sliepen <guus@sliepen.eu.org>)
  91         Debian also has another way of configuring network devices,
  92 controlled by /etc/network/interfaces. Users can add a wireless
  93 interface to /etc/network/interfaces, using the standard options to
  94 set the address and such, but the wireless-tools package adds new
  95 option statements that can be used to configure keys, channel,
  96 etcetera.
  97         From the README.Debian script that comes with wireless-tools:
  98
  99         /etc/network/interfaces
 100         -----------------------
 101
 102 You can now add extra statements to the iface sections of the files in
 103 /etc/network/interfaces that are specific for wireless interfaces. They
 104 are of the form:
 105
 106     wireless_<function> <value>
 107
 108 Before the interface is brought up, such a statement will result in the
 109 execution of the following command:
 110
 111     iwconfig <interface> <function> <value>
 112
 113 Example:
 114
 115 iface eth0 inet static
 116     address 192.168.1.2
 117     network 192.168.1.0
 118     netmask 255.255.255.0
 119     broadcast 192.168.1.255
 120     wireless_essid Home
 121     wireless_mode ad_hoc
 122
 123         The current Debian script support all arguments present in
 124 wireless.opts apart from Nickname. You can check this in the script
 125 /etc/network/if-pre-up.d/wireless-tool.
 126         You will need of course to install the Wireless Tools package
 127 if it's not already done, which is part of the standard package list
 128 (use dselect, dpkg, apt or anything you like to get it).
 129
 130                                 -----
 131
 132                 (Contributed by Joey Hess <joey@dragon.kitenet.net>)
 133 /etc/network/interfaces is much more flexible than it appears. It can probably
 134 do everything pcmcia schemes can do, and more. Here is part of mine:
 135
 136 auto wlan0
 137 mapping wlan0
 138         script /usr/local/bin/ifscheme
 139
 140 iface wlan0-home inet static
 141         address 192.168.1.5
 142         gateway 192.168.1.1
 143         netmask 255.255.255.0
 144         wireless_mode ad_hoc
 145         wireless_essid wortroot
 146         wireless_nick dragon
 147         wireless_channel 1
 148
 149 iface wlan0-away inet dhcp
 150         wireless_mode managed
 151
 152 Now I can type 'ifscheme -s away' when I leave home, rather like
 153 cardctl scheme.
 154
 155 The ifscheme script is at http://bugs.debian.org/154444. If the request in
 156 bug #154442 is implemented, it will become very flexible indeed..
 157
 158 Debian will hopefully be using this same file eventually for pcmcia network
 159 devices too. It's already doable but takes a little work. This is all rather
 160 rough and badly documented so far.
 161
 162 You can also do mapping based on the MAC address, if you want specific
 163 configuration on specific card.  See
 164 /usr/share/doc/ifupdown/examples/get-mac-address.sh and the stanza in
 165 /usr/share/doc/ifupdown/examples/network-interfaces.gz that uses it.
 166 This comes back to the problem I alluded to with mapping scripts not
 167 being "nestable" yet, and bug #154442. You can do what you want today,
 168 but you may need to write your own mapping script which uses a
 169 combination of MAC address and scheme info to return a stanza name to
 170 ifupdown.
 171
 172                                 -----
 173
 174         You may also want to check ifupdown-roaming :
 175                 http://panopticon.csustan.edu/thood/ifupdown-roaming.html
 176
 177 ---------------------------------------------------------------------
 178
 179 SuSE 8.0 and later
 180 --------
 181                 (Contributed by Christian Zoz <zoz@suse.de>)
 182         All network configuration is done in the directory
 183 /etc/sysconfig/network. It does not matter if it's a build in NIC or
 184 PCMCIA, USB, etc. The files network.opts and wireless.opts in
 185 /etc/pcmcia are not used any longer. There is /sbin/ifup to set up all
 186 kind of network interface.
 187         There is a file /etc/sysconfig/network/wireless where you may
 188 set most of the options of iwconfig in seperate variables (they are
 189 named like the options). Additionally you may use
 190 WIRELESS_IWCONFIG_OPTIONS e.g. for setting key 2, 3 or 4 or
 191 unsupported iwconfig commands. This file is documented and its
 192 settings are used for any wlan NIC.
 193         Configuration of wireless variable looks like :
 194                 WIRELESS_ESSID="<essid>"
 195         Every variable from file wireless may be used in the interface
 196 configuration files /etc/sysconfig/network/ifcfg-* as well. As
 197 expectable this overwrites the global setting in wireless. For
 198 sophisticated use of the ifcfg-* files read 'man ifup'.
 199
 200         Hint for PCMCIA and USB users:
 201         You need not to use the iterface name for the configuration as
 202 this may vary from one plugin to another. You may use a description of
 203 your hardware instead (ifcfg-<MACADDRESS> or ifcfg-pcmcia-1 for card
 204 in Slot 1)
 205
 206         Some of the variables can be set with YaST2 as well.
 207
 208         If you miss the 'schemes' functionality from the pcmcia-cs
 209 packages use the tool SCPM (System Configuration Profile Management)
 210 instead. This extends the pcmcia schemes to the whole system
 211 configuration. Read 'info scpm'. Since SuSE 8.1 there also is a YaST2
 212 modul for SCPM.
 213
 214 ---------------------------------------------------------------------
 215
 216 RED-HAT 7.2
 217 -----------
 218                 (Grabbed from various source - Google is your friend)
 219         Configuration is done in the file :
 220                 /etc/sysconfig/network-scripts/ifcfg-ethN
 221         Where 'ethN' is the name of the wireless interface (such as
 222 eth0, eth1, ...).
 223         The following lines may be added in this file :
 224                 MODE=<mode>
 225                 ESSID="<essid>"
 226                 RATE=<rate>
 227                 TXPOWER=<txpower>
 228                 KEY="<key>"
 229         The full list of configuration can be found in the file :
 230                 /etc/sysconfig/network-scripts/ifup-wireless
 231
 232         Note that Brad Allison has other tips for 7.2 :
 233         http://jackal.dnsalias.com:8080/public/misc/wireless/wireless.html
 234
 235 ---------------------------------------------------------------------
 236
 237 RED-HAT 7.3 and later
 238 -----------
 239                 (Cut'n'pasted from Brad Allison web page)
 240         http://jackal.dnsalias.com:8080/public/misc/wireless/wireless.html
 241
 242         If you are running RedHat 7.3, I would tell you to simply run
 243 /usr/bin/redhat-config-network and click "Devices", Click "Add", then
 244 select "Wireless Connection". You can find the full instructions in
 245 RedHat's Customization Guide for RH7.3 in Chapter 6, Network
 246 Configuration: Wireless Connection.
 247                 http://www.redhat.com/docs/manuals/linux/
 248                 http://www.redhat.com/docs/manuals/linux/RHL-7.3-Manual/custom-guide/s1-network-config-wireless.html
 249
 250         However, according to the Errata: The version of the Red Hat
 251 Network Administration Tool that shipped with Red Hat Linux 7.3 did
 252 not include wireless connection in the configuration wizard. An
 253 enhancement errata will be released soon with this feature. You can
 254 download the newest version of redhat-config-network from rpmfind.net.
 255                 http://www.redhat.com/docs/errata/RHL-7.3-Manual/
 256                 http://www.rpmfind.net/linux/rpm2html/search.php?query=redhat-config-network&submit=Search+...
 257
 258                                 -----
 259
 260                 (Grabbed from various source - Google is your friend)
 261         The current graphical user interface support :
 262                 ESSID, Mode, Freq, Channel, Rate, Key
 263
 264         Compared to Red-Hat 7.2, the Wireless Setting in the
 265 configuration file have change to include the WIRELESS_ prefix :
 266                 WIRELESS_MODE=<mode>
 267                 WIRELESS_ESSID='<essid>'
 268                 WIRELESS_ENC_KEY='<key>'
 269         The underlying configuration files and configurations options
 270 seems to be indentical to what is done in Mandrake 8.2 (or vice
 271 versa), so please check the section below. This allow configuration of
 272 additional wireless settings not available in the GUI.
 273
 274                                 -----
 275
 276                 (Extrapolated from web page of Martin Pot <m.t.pot@ieee.org>)
 277                 http://ii.net/~mpot/wireless/router.cgi
 278         Red-Hat 7.3 also seem to support configuration in
 279 wireless.opts to some extent. But for compatibility with the network
 280 admin tools, I would still recommend to use the above method.
 281         Red-Hat 7.3 seems to load wvlan_cs for Orinoco cards and
 282 friends. The above web page explain how to switch it to orinoco_cs.
 283
 284 ---------------------------------------------------------------------
 285
 286 RED-HAT 9.0 and later
 287 -----------
 288                 (Cut'n'pasted from Dax Kelson web page)
 289         http://www.gurulabs.com/RedHatLinux9-review.html
 290
 291         A little known fact is that newer versions of RHL support
 292 multiple network profiles. This is useful for machines that commonly
 293 plug into different networks (think laptops). The easy way to create
 294 network profiles is to use the redhat-config-network command. The
 295 question then becomes, what happens when you type "ifup eth0"? The
 296 behavior wasn't defined in previous versions, however, now in RHL 9
 297 the following behavior is defined;
 298
 299         search path for:
 300 # ifup $DEV
 301         is:
 302 /etc/sysconfig/networking/profiles/$CURRENT_PROFILE/ifcfg-$DEV
 303 /etc/sysconfig/networking/profiles/default/ifcfg-$DEV
 304 /etc/sysconfig/network-scripts/ifcfg-$DEV
 305
 306         A cool trick is to boot your RHL box directly into a profile
 307 from the GRUB boot screen. To do this, create a separate
 308 /etc/boot/grub.conf entry for each network profile, and in each entry
 309 add the kernel argument netprofile=profilename.
 310
 311                                 -----
 312
 313         I'm pretty certain the profile scheme above also apply to
 314 wireless settings, which is good news...
 315
 316 ---------------------------------------------------------------------
 317
 318 MANDRAKE 8.2 and later
 319 ------------
 320                 (Grabbed from various source - Google is your friend)
 321         Configuration is done in the file :
 322                 /etc/sysconfig/network-scripts/ifcfg-ethN
 323         Where 'ethN' is the name of the wireless interface (such as
 324 eth0, eth1, ...).
 325         The following lines may be added in this file :
 326                 WIRELESS_MODE=<mode>
 327                 WIRELESS_ESSID=<essid>
 328                 WIRELESS_NWID=<nwid>
 329                 WIRELESS_FREQ=<freq/channel>
 330                 WIRELESS_SENS=<sensitivity>
 331                 WIRELESS_RATE=<rate>
 332                 WIRELESS_ENC_KEY=<keys>
 333                 WIRELESS_RTS=<rts>
 334                 WIRELESS_FRAG=<frag>
 335                 WIRELESS_IWCONFIG=<iwconfig command>
 336                 WIRELESS_IWSPY=<iwspy command>
 337                 WIRELESS_IWPRIV=<iwpriv command>
 338         Most likely, you only need to add a few of those lines and not
 339 all of them. The script doing the configuration and where you can
 340 check the details is :
 341                 /etc/network/network-scripts/ifup-wireless
 342         You will of course need the Wireless Extension package :
 343                 rpm -Uvh wireless-tools-XX-Xmdk.XXX.rpm
 344
 345         Mandrake can also have wireless setting added to its
 346 Auto-Install procedure :
 347         http://members.shaw.ca/mandrake/drakx/8.2/HTML/section4-13.html
 348
 349 ---------------------------------------------------------------------
 350
 351
 352         Have fun...
 353
 354         Jean