/[gentoo]/xml/htdocs/doc/en/handbook/hb-net-wireless.xml
Gentoo

Diff of /xml/htdocs/doc/en/handbook/hb-net-wireless.xml

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

Revision 1.1 Revision 1.2
40happens you may use linux-wlan-ng with baselayout. 40happens you may use linux-wlan-ng with baselayout.
41</warn> 41</warn>
42 42
43</body> 43</body>
44</section> 44</section>
45
46<section> 45<section>
47<title>WPA Supplicant</title> 46<title>WPA Supplicant</title>
48<body> 47<body>
48
49<p> 49<p>
50<uri link="http://hostap.epitest.fi/wpa_supplicant">WPA Supplicant</uri> is 50<uri link="http://hostap.epitest.fi/wpa_supplicant">WPA Supplicant</uri> is
51a package that allows you to connect to WPA enabled access points. It's setup 51a package that allows you to connect to WPA enabled access points. It's setup
52is fairly fluid as it is still in beta - however it works fine for the most 52is fairly fluid as it is still in beta - however it works fine for the most
53part. 53part.
101<comment># Let wpa_supplicant take care of scanning and AP selection</comment> 101<comment># Let wpa_supplicant take care of scanning and AP selection</comment>
102ap_scan=1 102ap_scan=1
103 103
104<comment># Simple case: WPA-PSK, PSK as an ASCII passphrase, allow all valid ciphers</comment> 104<comment># Simple case: WPA-PSK, PSK as an ASCII passphrase, allow all valid ciphers</comment>
105network={ 105network={
106 ssid="simple" 106 ssid="simple"
107 psk="very secret passphrase" 107 psk="very secret passphrase"
108 <comment># The higher the priority the sooner we are matched</comment> 108 <comment># The higher the priority the sooner we are matched</comment>
109 priority=5 109 priority=5
110} 110}
111 111
112<comment># Same as previous, but request SSID-specific scanning (for APs that reject 112<comment># Same as previous, but request SSID-specific scanning (for APs that reject
113# broadcast SSID)</comment> 113# broadcast SSID)</comment>
114network={ 114network={
115 ssid="second ssid" 115 ssid="second ssid"
116 scan_ssid=1 116 scan_ssid=1
117 psk="very secret passphrase" 117 psk="very secret passphrase"
118 priority=2 118 priority=2
119} 119}
120 120
121<comment># Only WPA-PSK is used. Any valid cipher combination is accepted</comment> 121<comment># Only WPA-PSK is used. Any valid cipher combination is accepted</comment>
122network={ 122network={
123 ssid="example" 123 ssid="example"
124 proto=WPA 124 proto=WPA
125 key_mgmt=WPA-PSK 125 key_mgmt=WPA-PSK
126 pairwise=CCMP TKIP 126 pairwise=CCMP TKIP
127 group=CCMP TKIP WEP104 WEP40 127 group=CCMP TKIP WEP104 WEP40
128 psk=06b4be19da289f475aa46a33cb793029d4ab3db7a23ee92382eb0106c72ac7bb 128 psk=06b4be19da289f475aa46a33cb793029d4ab3db7a23ee92382eb0106c72ac7bb
129 priority=2 129 priority=2
130} 130}
131 131
132<comment># Plaintext connection (no WPA, no IEEE 802.1X)</comment> 132<comment># Plaintext connection (no WPA, no IEEE 802.1X)</comment>
133network={ 133network={
134 ssid="plaintext-test" 134 ssid="plaintext-test"
135 key_mgmt=NONE 135 key_mgmt=NONE
136} 136}
137 137
138<comment># Shared WEP key connection (no WPA, no IEEE 802.1X)</comment> 138<comment># Shared WEP key connection (no WPA, no IEEE 802.1X)</comment>
139network={ 139network={
140 ssid="static-wep-test" 140 ssid="static-wep-test"
141 key_mgmt=NONE 141 key_mgmt=NONE
142 wep_key0="abcde" 142 wep_key0="abcde"
143 wep_key1=0102030405 143 wep_key1=0102030405
144 wep_key2="1234567890123" 144 wep_key2="1234567890123"
145 wep_tx_keyidx=0 145 wep_tx_keyidx=0
146 priority=5 146 priority=5
147} 147}
148 148
149<comment># Shared WEP key connection (no WPA, no IEEE 802.1X) using Shared Key 149<comment># Shared WEP key connection (no WPA, no IEEE 802.1X) using Shared Key
150# IEEE 802.11 authentication</comment> 150# IEEE 802.11 authentication</comment>
151network={ 151network={
152 ssid="static-wep-test2" 152 ssid="static-wep-test2"
153 key_mgmt=NONE 153 key_mgmt=NONE
154 wep_key0="abcde" 154 wep_key0="abcde"
155 wep_key1=0102030405 155 wep_key1=0102030405
156 wep_key2="1234567890123" 156 wep_key2="1234567890123"
157 wep_tx_keyidx=0 157 wep_tx_keyidx=0
158 priority=5 158 priority=5
159 auth_alg=SHARED 159 auth_alg=SHARED
160} 160}
161 161
162<comment># IBSS/ad-hoc network with WPA-None/TKIP</comment> 162<comment># IBSS/ad-hoc network with WPA-None/TKIP</comment>
163network={ 163network={
164 ssid="test adhoc" 164 ssid="test adhoc"
165 mode=1 165 mode=1
166 proto=WPA 166 proto=WPA
167 key_mgmt=WPA-NONE 167 key_mgmt=WPA-NONE
168 pairwise=NONE 168 pairwise=NONE
169 group=TKIP 169 group=TKIP
170 psk="secret passphrase" 170 psk="secret passphrase"
171} 171}
172 172</pre>
173</pre>
174 173
175</body> 174</body>
176</section> 175</section>
177
178<section> 176<section>
179<title>Wireless Tools</title> 177<title>Wireless Tools</title>
180 178
181<subsection> 179<subsection>
182<title>Initial setup and Managed Mode</title> 180<title>Initial setup and Managed Mode</title>
234preferred_aps=( "ESSID1" "ESSID2" ) 232preferred_aps=( "ESSID1" "ESSID2" )
235</pre> 233</pre>
236 234
237</body> 235</body>
238</subsection> 236</subsection>
239
240<subsection> 237<subsection>
241<title>Fine tune Access Point Selection</title> 238<title>Fine tune Access Point Selection</title>
242<body> 239<body>
243 240
244<p> 241<p>
253<c>associate_order</c> variable. Here's a table of values and how they 250<c>associate_order</c> variable. Here's a table of values and how they
254control this. 251control this.
255</p> 252</p>
256 253
257<table> 254<table>
258 <tr> 255<tr>
259 <th>Value</th> 256 <th>Value</th>
260 <th>Description</th> 257 <th>Description</th>
261 </tr> 258</tr>
262 <tr> 259<tr>
263 <ti>any</ti> 260 <ti>any</ti>
264 <ti>Default behaviour</ti> 261 <ti>Default behaviour</ti>
265 </tr> 262</tr>
266 <tr> 263<tr>
267 <ti>preferredonly</ti> 264 <ti>preferredonly</ti>
268 <ti>We will only connect to visible APs in the preferred list</ti> 265 <ti>We will only connect to visible APs in the preferred list</ti>
269 </tr> 266</tr>
270 <tr> 267<tr>
271 <ti>forcepreferred</ti> 268 <ti>forcepreferred</ti>
272 <ti> 269 <ti>
273 We will forceably connect to APs in the preferred order if they are not 270 We will forceably connect to APs in the preferred order if they are not
274 found in a scan 271 found in a scan
275 </ti> 272 </ti>
276 </tr> 273</tr>
277 <tr> 274<tr>
278 <ti>forcepreferredonly</ti> 275 <ti>forcepreferredonly</ti>
279 <ti> 276 <ti>
280 Do not scan for APs - instead just try to connect to each one in order 277 Do not scan for APs - instead just try to connect to each one in order
281 </ti> 278 </ti>
282 </tr> 279</tr>
283 <tr> 280<tr>
284 <ti>forceany</ti> 281 <ti>forceany</ti>
285 <ti>Same as forcepreferred + connect to any other available AP</ti> 282 <ti>Same as forcepreferred + connect to any other available AP</ti>
286 </tr> 283</tr>
287</table> 284</table>
288 285
289<p> 286<p>
290Finally we have some blacklist_aps and unique_ap selection. blacklist_aps 287Finally we have some blacklist_aps and unique_ap selection. blacklist_aps
291works in a similar way to preferred_aps. unique_ap is a yes or no value 288works in a similar way to preferred_aps. unique_ap is a yes or no value
304unique_ap="yes" 301unique_ap="yes"
305</pre> 302</pre>
306 303
307</body> 304</body>
308</subsection> 305</subsection>
309
310<subsection> 306<subsection>
311<title>Ad-Hoc and Master Modes</title> 307<title>Ad-Hoc and Master Modes</title>
312<body> 308<body>
313 309
314<p> 310<p>
354cards sold in Japan is 14. 350cards sold in Japan is 14.
355</impo> 351</impo>
356 352
357</body> 353</body>
358</subsection> 354</subsection>
359
360<subsection> 355<subsection>
361<title>Troubleshooting Wireless Tools</title> 356<title>Troubleshooting Wireless Tools</title>
362<body> 357<body>
363 358
364<p> 359<p>
366and running due to driver or environment problems. Here's a table of other 361and running due to driver or environment problems. Here's a table of other
367things you can try. 362things you can try.
368</p> 363</p>
369 364
370<table> 365<table>
371 <tr> 366<tr>
372 <th>Variable</th> 367 <th>Variable</th>
373 <th>Default Value</th> 368 <th>Default Value</th>
374 <th>Description</th> 369 <th>Description</th>
375 </tr> 370</tr>
376 <tr> 371<tr>
377 <ti>iwconfig_eth0</ti> 372 <ti>iwconfig_eth0</ti>
378 <ti/> 373 <ti/>
379 <ti>See the iwconfig man page for details on what to send iwconfig</ti> 374 <ti>See the iwconfig man page for details on what to send iwconfig</ti>
380 </tr> 375</tr>
381 <tr> 376<tr>
382 <ti>iwpriv_eth0</ti> 377 <ti>iwpriv_eth0</ti>
383 <ti/> 378 <ti/>
384 <ti>See the iwpriv man page for details on what to send iwpriv</ti> 379 <ti>See the iwpriv man page for details on what to send iwpriv</ti>
385 </tr> 380</tr>
386 <tr> 381<tr>
387 <ti>sleep_scan_eth0</ti> 382 <ti>sleep_scan_eth0</ti>
388 <ti>0</ti> 383 <ti>0</ti>
389 <ti> 384 <ti>
390 The number of seconds to sleep before attempting to scan. This is needed 385 The number of seconds to sleep before attempting to scan. This is needed
391 when the driver/firmware needs more time to active before it can be used. 386 when the driver/firmware needs more time to active before it can be used.
392 </ti> 387 </ti>
393 </tr> 388</tr>
394 <tr> 389<tr>
395 <ti>sleep_associate_eth0</ti> 390 <ti>sleep_associate_eth0</ti>
396 <ti>5</ti> 391 <ti>5</ti>
397 <ti> 392 <ti>
398 The number of seconds to wait for the interface to associate with the 393 The number of seconds to wait for the interface to associate with the
399 Access Point before moving onto the next one 394 Access Point before moving onto the next one
400 </ti> 395 </ti>
401 </tr> 396</tr>
402 <tr> 397<tr>
403 <ti>associate_test_eth0</ti> 398 <ti>associate_test_eth0</ti>
404 <ti>MAC</ti> 399 <ti>MAC</ti>
405 <ti> 400 <ti>
406 Some drivers do not reset the MAC address associated with to an 401 Some drivers do not reset the MAC address associated with to an
407 invalid one when they loose or attempt to associate.<br/> 402 invalid one when they loose or attempt to associate.<br/>
408 Some drivers do not reset the quality level when whey loose 403 Some drivers do not reset the quality level when whey loose
409 or attempt assocciation.<br/> 404 or attempt assocciation.<br/>
410 Valid settings are MAC, quality and all. 405 Valid settings are MAC, quality and all.
411 </ti> 406 </ti>
412 </tr> 407</tr>
413 <tr> 408<tr>
414 <ti>scan_mode_eth0</ti> 409 <ti>scan_mode_eth0</ti>
415 <ti/> 410 <ti/>
416 <ti> 411 <ti>
417 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
418 try setting ad-hoc here 413 try setting ad-hoc here
419 </ti> 414 </ti>
420 </tr> 415</tr>
421 <tr> 416<tr>
422 <ti>iwpriv_scan_pre_eth0</ti> 417 <ti>iwpriv_scan_pre_eth0</ti>
423 <ti/> 418 <ti/>
424 <ti> 419 <ti>
425 Sends some iwpriv commands to the interface before scanning<br/> 420 Sends some iwpriv commands to the interface before scanning<br/>
426 See the iwpriv man page for more details 421 See the iwpriv man page for more details
427 </ti> 422 </ti>
428 </tr> 423</tr>
429 <tr> 424<tr>
430 <ti>iwpriv_scan_post_eth0</ti> 425 <ti>iwpriv_scan_post_eth0</ti>
431 <ti/> 426 <ti/>
432 <ti> 427 <ti>
433 Sends some iwpriv commands to the interface after scanning<br/> 428 Sends some iwpriv commands to the interface after scanning<br/>
434 See the iwpriv man page for more details 429 See the iwpriv man page for more details
435 </ti> 430 </ti>
436 </tr> 431</tr>
437</table> 432</table>
438 433
439</body> 434</body>
440</subsection> 435</subsection>
441
442</section> 436</section>
443
444<section> 437<section>
445<title>Defining network configuration per ESSID</title> 438<title>Defining network configuration per ESSID</title>
446<body> 439<body>
447 440
448<p> 441<p>

Legend:
Removed from v.1.1  
changed lines
  Added in v.1.2

  ViewVC Help
Powered by ViewVC 1.1.20