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