|
Lines 8-45
Link Here
|
| 8 |
|
8 |
|
| 9 |
<sections> |
9 |
<sections> |
| 10 |
|
10 |
|
| 11 |
<version>1.2</version> |
11 |
<version>1.3</version> |
| 12 |
<date>2005-08-02</date> |
12 |
<date>2005-12-21</date> |
| 13 |
|
13 |
|
| 14 |
<section> |
14 |
<section> |
| 15 |
<title>Introduction</title> |
15 |
<title>Introduction</title> |
| 16 |
<body> |
16 |
<body> |
| 17 |
|
17 |
|
| 18 |
<p> |
18 |
<p> |
| 19 |
Currently we support wireless setup either by wireless-tools or wpa_supplicant. |
19 |
Currently we support wireless setup either by <c>wireless-tools</c> or |
| 20 |
The important thing to remember is that you configure for wireless networks on a |
20 |
<c>wpa_supplicant</c>. The important thing to remember is that you configure for |
| 21 |
global basis and not an interface basis. |
21 |
wireless networks on a global basis and not an interface basis. |
| 22 |
</p> |
22 |
</p> |
| 23 |
|
23 |
|
| 24 |
<p> |
24 |
<p> |
| 25 |
wpa_suppliant is the best choice, but it does not support all drivers. For a |
25 |
<c>wpa_suppliant</c> is the best choice, but it does not support all drivers. |
| 26 |
list of supported drivers, <uri |
26 |
For a list of supported drivers, <uri |
| 27 |
link="http://hostap.epitest.fi/wpa_supplicant">read the wpa_supplicant |
27 |
link="http://hostap.epitest.fi/wpa_supplicant">read the wpa_supplicant |
| 28 |
site</uri>. Also, wpa_supplicant can currently only connect to SSID's that |
28 |
site</uri>. Also, <c>wpa_supplicant</c> can currently only connect to SSID's |
| 29 |
you have configured for. |
29 |
that you have configured for. |
| 30 |
</p> |
30 |
</p> |
| 31 |
|
31 |
|
| 32 |
<p> |
32 |
<p> |
| 33 |
wireless-tools supports nearly all cards and drivers, but it cannot connect to |
33 |
<c>wireless-tools</c> supports nearly all cards and drivers, but it cannot |
| 34 |
WPA only Access Points. |
34 |
connect to WPA only Access Points. |
| 35 |
</p> |
35 |
</p> |
| 36 |
|
36 |
|
| 37 |
<warn> |
37 |
<warn> |
| 38 |
The linux-wlan-ng driver is not supported by baselayout at this time. This is |
38 |
The <c>linux-wlan-ng</c> driver is not supported by <c>baselayout</c> at this |
| 39 |
because linux-wlan-ng have their own setup and configuration which is completely |
39 |
time. This is because <c>linux-wlan-ng</c> have their own setup and |
| 40 |
different to everyone else's. The linux-wlan-ng devs are rumoured to be changing |
40 |
configuration which is completely different to everyone else's. The |
| 41 |
their setup over to wireless-tools - when this happens you may use linux-wlan-ng |
41 |
<c>linux-wlan-ng</c> devs are rumoured to be changing their setup over to |
| 42 |
with baselayout. |
42 |
<c>wireless-tools</c> - when this happens you may use <c>linux-wlan-ng</c> |
|
|
43 |
with <c>baselayout</c>. |
| 43 |
</warn> |
44 |
</warn> |
| 44 |
|
45 |
|
| 45 |
</body> |
46 |
</body> |
|
Lines 59-72
Link Here
|
| 59 |
</pre> |
60 |
</pre> |
| 60 |
|
61 |
|
| 61 |
<impo> |
62 |
<impo> |
| 62 |
You have to have CONFIG_PACKET enabled in your kernel for wpa_supplicant to |
63 |
You have to have <c>CONFIG_PACKET</c> enabled in your kernel for |
| 63 |
work. |
64 |
<c>wpa_supplicant</c> to work. |
| 64 |
</impo> |
65 |
</impo> |
| 65 |
|
66 |
|
| 66 |
<p> |
67 |
<p> |
| 67 |
Now we have to configure <path>/etc/conf.d/net</path> to so that we prefer |
68 |
Now we have to configure <path>/etc/conf.d/net</path> to so that we prefer |
| 68 |
wpa_supplicant over wireless-tools (if both are installed, wireless-tools is the |
69 |
<c>wpa_supplicant</c> over <c>wireless-tools</c> (if both are installed, |
| 69 |
default). |
70 |
<c>wireless-tools</c> is the default). |
| 70 |
</p> |
71 |
</p> |
| 71 |
|
72 |
|
| 72 |
<pre caption="configure /etc/conf.d/net for wpa_supplicant"> |
73 |
<pre caption="configure /etc/conf.d/net for wpa_supplicant"> |
|
Lines 79-96
Link Here
|
| 79 |
</pre> |
80 |
</pre> |
| 80 |
|
81 |
|
| 81 |
<note> |
82 |
<note> |
| 82 |
If you're using the host-ap driver you will need to put the card in Managed mode |
83 |
If you're using the host-ap driver you will need to put the card in <e>Managed |
| 83 |
before it can be used with wpa_supplicant correctly. You can use |
84 |
mode</e> before it can be used with <c>wpa_supplicant</c> correctly. You can use |
| 84 |
<e>iwconfig_eth0="mode managed"</e> to achieve this in |
85 |
<e>iwconfig_eth0="mode managed"</e> to achieve this in |
| 85 |
<path>/etc/conf.d/net</path>. |
86 |
<path>/etc/conf.d/net</path>. |
| 86 |
</note> |
87 |
</note> |
| 87 |
|
88 |
|
| 88 |
<p> |
89 |
<p> |
| 89 |
That was simple wasn't it? However, we still have to configure wpa_supplicant |
90 |
That was simple wasn't it? However, we still have to configure |
| 90 |
itself which is a bit more tricky depending on how secure the Access Points are |
91 |
<c>wpa_supplicant</c> itself which is a bit more tricky depending on how secure |
| 91 |
that you are trying to connect to. The below example is taken and simplified |
92 |
the Access Points are that you are trying to connect to. The below example is |
| 92 |
from <path>/etc/wpa_supplicant.conf.example</path> which ships with |
93 |
taken and simplified from <path>/etc/wpa_supplicant.conf.example</path> which |
| 93 |
wpa_supplicant. |
94 |
ships with <c>wpa_supplicant</c>. |
| 94 |
</p> |
95 |
</p> |
| 95 |
|
96 |
|
| 96 |
<pre caption="an example /etc/wpa_supplicant.conf"> |
97 |
<pre caption="an example /etc/wpa_supplicant.conf"> |
|
Lines 258-294
Link Here
|
| 258 |
<th>Description</th> |
259 |
<th>Description</th> |
| 259 |
</tr> |
260 |
</tr> |
| 260 |
<tr> |
261 |
<tr> |
| 261 |
<ti>any</ti> |
262 |
<ti><c>any</c></ti> |
| 262 |
<ti>Default behaviour</ti> |
263 |
<ti>Default behaviour</ti> |
| 263 |
</tr> |
264 |
</tr> |
| 264 |
<tr> |
265 |
<tr> |
| 265 |
<ti>preferredonly</ti> |
266 |
<ti><c>preferredonly</c></ti> |
| 266 |
<ti>We will only connect to visible APs in the preferred list</ti> |
267 |
<ti>We will only connect to visible APs in the preferred list</ti> |
| 267 |
</tr> |
268 |
</tr> |
| 268 |
<tr> |
269 |
<tr> |
| 269 |
<ti>forcepreferred</ti> |
270 |
<ti><c>forcepreferred</c></ti> |
| 270 |
<ti> |
271 |
<ti> |
| 271 |
We will forceably connect to APs in the preferred order if they are not |
272 |
We will forceably connect to APs in the preferred order if they are not |
| 272 |
found in a scan |
273 |
found in a scan |
| 273 |
</ti> |
274 |
</ti> |
| 274 |
</tr> |
275 |
</tr> |
| 275 |
<tr> |
276 |
<tr> |
| 276 |
<ti>forcepreferredonly</ti> |
277 |
<ti><c>forcepreferredonly</c></ti> |
| 277 |
<ti> |
278 |
<ti> |
| 278 |
Do not scan for APs - instead just try to connect to each one in order |
279 |
Do not scan for APs - instead just try to connect to each one in order |
| 279 |
</ti> |
280 |
</ti> |
| 280 |
</tr> |
281 |
</tr> |
| 281 |
<tr> |
282 |
<tr> |
| 282 |
<ti>forceany</ti> |
283 |
<ti><c>forceany</c></ti> |
| 283 |
<ti>Same as forcepreferred + connect to any other available AP</ti> |
284 |
<ti>Same as forcepreferred + connect to any other available AP</ti> |
| 284 |
</tr> |
285 |
</tr> |
| 285 |
</table> |
286 |
</table> |
| 286 |
|
287 |
|
| 287 |
<p> |
288 |
<p> |
| 288 |
Finally we have some blacklist_aps and unique_ap selection. blacklist_aps works |
289 |
Finally we have some <c>blacklist_aps</c> and <c>unique_ap</c> selection. |
| 289 |
in a similar way to preferred_aps. unique_ap is a yes or no value that says if a |
290 |
<c>blacklist_aps</c> works in a similar way to <c>preferred_aps</c>. |
| 290 |
second wireless interface can connect to the same Access Point as the first |
291 |
<c>unique_ap</c> is a yes or no value that says if a second wireless interface |
| 291 |
interface. |
292 |
can connect to the same Access Point as the first interface. |
| 292 |
</p> |
293 |
</p> |
| 293 |
|
294 |
|
| 294 |
<pre caption="blacklist_aps and unique_ap example"> |
295 |
<pre caption="blacklist_aps and unique_ap example"> |
|
Lines 369-432
Link Here
|
| 369 |
<th>Description</th> |
370 |
<th>Description</th> |
| 370 |
</tr> |
371 |
</tr> |
| 371 |
<tr> |
372 |
<tr> |
| 372 |
<ti>iwconfig_eth0</ti> |
373 |
<ti><c>iwconfig_eth0</c></ti> |
| 373 |
<ti/> |
374 |
<ti/> |
| 374 |
<ti>See the iwconfig man page for details on what to send iwconfig</ti> |
375 |
<ti>See the iwconfig man page for details on what to send <c>iwconfig</c></ti> |
| 375 |
</tr> |
376 |
</tr> |
| 376 |
<tr> |
377 |
<tr> |
| 377 |
<ti>iwpriv_eth0</ti> |
378 |
<ti><c>iwpriv_eth0</c></ti> |
| 378 |
<ti/> |
379 |
<ti/> |
| 379 |
<ti>See the iwpriv man page for details on what to send iwpriv</ti> |
380 |
<ti>See the iwpriv man page for details on what to send <c>iwpriv</c></ti> |
| 380 |
</tr> |
381 |
</tr> |
| 381 |
<tr> |
382 |
<tr> |
| 382 |
<ti>sleep_scan_eth0</ti> |
383 |
<ti><c>sleep_scan_eth0</c></ti> |
| 383 |
<ti>0</ti> |
384 |
<ti><c>0</c></ti> |
| 384 |
<ti> |
385 |
<ti> |
| 385 |
The number of seconds to sleep before attempting to scan. This is needed |
386 |
The number of seconds to sleep before attempting to scan. This is needed |
| 386 |
when the driver/firmware needs more time to active before it can be used. |
387 |
when the driver/firmware needs more time to active before it can be used. |
| 387 |
</ti> |
388 |
</ti> |
| 388 |
</tr> |
389 |
</tr> |
| 389 |
<tr> |
390 |
<tr> |
| 390 |
<ti>sleep_associate_eth0</ti> |
391 |
<ti><c>sleep_associate_eth0</c></ti> |
| 391 |
<ti>5</ti> |
392 |
<ti><c>5</c></ti> |
| 392 |
<ti> |
393 |
<ti> |
| 393 |
The number of seconds to wait for the interface to associate with the |
394 |
The number of seconds to wait for the interface to associate with the |
| 394 |
Access Point before moving onto the next one |
395 |
Access Point before moving onto the next one |
| 395 |
</ti> |
396 |
</ti> |
| 396 |
</tr> |
397 |
</tr> |
| 397 |
<tr> |
398 |
<tr> |
| 398 |
<ti>associate_test_eth0</ti> |
399 |
<ti><c>associate_test_eth0</c></ti> |
| 399 |
<ti>MAC</ti> |
400 |
<ti><c>MAC</c></ti> |
| 400 |
<ti> |
401 |
<ti> |
| 401 |
Some drivers do not reset the MAC address associated with to an |
402 |
Some drivers do not reset the MAC address associated with to an invalid one |
| 402 |
invalid one when they loose or attempt to associate. |
403 |
when they loose or attempt to associate. Some drivers do not reset the |
| 403 |
Some drivers do not reset the quality level when they loose |
404 |
quality level when they loose or attempt assocciation. Valid settings are |
| 404 |
or attempt assocciation. |
405 |
<c>MAC</c>, <c>quality</c> and <c>all</c>. |
| 405 |
Valid settings are MAC, quality and all. |
|
|
| 406 |
</ti> |
406 |
</ti> |
| 407 |
</tr> |
407 |
</tr> |
| 408 |
<tr> |
408 |
<tr> |
| 409 |
<ti>scan_mode_eth0</ti> |
409 |
<ti><c>scan_mode_eth0</c></ti> |
| 410 |
<ti/> |
410 |
<ti/> |
| 411 |
<ti> |
411 |
<ti> |
| 412 |
Some drivers have to scan in ad-hoc mode, so if scanning fails |
412 |
Some drivers have to scan in ad-hoc mode, so if scanning fails |
| 413 |
try setting ad-hoc here |
413 |
try setting <c>ad-hoc</c> here |
| 414 |
</ti> |
414 |
</ti> |
| 415 |
</tr> |
415 |
</tr> |
| 416 |
<tr> |
416 |
<tr> |
| 417 |
<ti>iwpriv_scan_pre_eth0</ti> |
417 |
<ti><c>iwpriv_scan_pre_eth0</c></ti> |
| 418 |
<ti/> |
418 |
<ti/> |
| 419 |
<ti> |
419 |
<ti> |
| 420 |
Sends some iwpriv commands to the interface before scanning. |
420 |
Sends some <c>iwpriv</c> commands to the interface before scanning. |
| 421 |
See the iwpriv man page for more details |
421 |
See the iwpriv man page for more details. |
| 422 |
</ti> |
422 |
</ti> |
| 423 |
</tr> |
423 |
</tr> |
| 424 |
<tr> |
424 |
<tr> |
| 425 |
<ti>iwpriv_scan_post_eth0</ti> |
425 |
<ti><c>iwpriv_scan_post_eth0</c></ti> |
| 426 |
<ti/> |
426 |
<ti/> |
| 427 |
<ti> |
427 |
<ti> |
| 428 |
Sends some iwpriv commands to the interface after scanning. |
428 |
Sends some <c>iwpriv</c> commands to the interface after scanning. |
| 429 |
See the iwpriv man page for more details |
429 |
See the iwpriv man page for more details. |
| 430 |
</ti> |
430 |
</ti> |
| 431 |
</tr> |
431 |
</tr> |
| 432 |
</table> |
432 |
</table> |
|
Lines 439-447
Link Here
|
| 439 |
<body> |
439 |
<body> |
| 440 |
|
440 |
|
| 441 |
<p> |
441 |
<p> |
| 442 |
Someones when you connect to ESSID1 you need a static IP and when you connect to |
442 |
Someones when you connect to <e>ESSID1</e> you need a static IP and when you |
| 443 |
ESSID2 you need DHCP. Infact most module variables we can change per ESSID. |
443 |
connect to <e>ESSID2</e> you need DHCP. Infact most module variables we can |
| 444 |
Here's how we do this. |
444 |
change per ESSID. Here's how we do this. |
| 445 |
</p> |
445 |
</p> |
| 446 |
|
446 |
|
| 447 |
<note> |
447 |
<note> |
|
Lines 449-457
Link Here
|
| 449 |
</note> |
449 |
</note> |
| 450 |
|
450 |
|
| 451 |
<impo> |
451 |
<impo> |
| 452 |
You <e>will</e> need to consult the |
452 |
You <e>will</e> need to consult the <uri |
| 453 |
<uri link="?part=4&chap=2#variable_name">variable name</uri> |
453 |
link="?part=4&chap=2#variable_name">variable name</uri> documentation. |
| 454 |
documentation. |
|
|
| 455 |
</impo> |
454 |
</impo> |
| 456 |
|
455 |
|
| 457 |
<pre caption="override network settings per ESSID"> |
456 |
<pre caption="override network settings per ESSID"> |