nexmon – Blame information for rev 1

Subversion Repositories:
Rev:
Rev Author Line No. Line
1 office 1 .\" Jean II - HPLB - 1996 => HPL - 2004
2 .\" iwconfig.8
3 .\"
4 .\" Traduction 2003/07/15 Maxime CHARPENNE (voir
5 .\" http://www.delafond.org/traducmanfr/)
6 .\" 1ère traduction : version 26
7 .\" Mise à jour 2004/01/28 : version 27-pre9 (beta)
8 .\" Mise à jour 2004/02/26 : version 27-pre11 (alpha)
9 .\" Mise à jour 2004/08/23 : version 27-pre25
10 .\"
11 .TH IWCONFIG 8 "22 juin 2004" "wireless-tools" "Manuel du programmeur Linux"
12 .\"
13 .\" NAME part
14 .\"
15 .SH NOM
16 iwconfig \- configure une interface réseau sans-fil (wireless)
17 .\"
18 .\" SYNOPSIS part
19 .\"
20 .SH SYNOPSIS
21 .BI "iwconfig [" interface ]
22 .br
23 .BI "iwconfig " interface " [essid " X "] [nwid " N "] [freq " F "] [channel " C ]
24 .br
25 .BI " [sens " S "] [mode " M "] [ap " A "] [nick " NN ]
26 .br
27 .BI " [rate " R "] [rts " RT "] [frag " FT "] [txpower " T ]
28 .br
29 .BI " [enc " E "] [key " K "] [power " P "] [retry " R ]
30 .br
31 .BI " [commit]
32 .br
33 .BI "iwconfig --help"
34 .br
35 .BI "iwconfig --version"
36 .\"
37 .\" DESCRIPTION part
38 .\"
39 .SH DESCRIPTION
40 .B Iwconfig
41 est similaire à
42 .IR ifconfig (8),
43 mais est dédié aux interfaces wireless. Il est utilisé pour manier les
44 paramètres des interfaces réseaux qui sont spécifiques aux opérations wireless
45 (par exemple\ : la fréquence).
46 .B Iwconfig
47 peut aussi être utilisé pour afficher ces paramètres, et les statistiques
48 concernant le sans fil (extraites de
49 .IR /proc/net/wireless ).
50 .PP
51 Tous ces paramètres et statistiques dépendent du matériel. Chaque pilote ne
52 fournira que quelques uns d'entre eux en fonction du support matériel, et
53 l'étendue des valeurs peut changer. Veuillez vous référer aux pages man de
54 chaque matériel pour plus de détails.
55 .\"
56 .\" PARAMETER part
57 .\"
58 .SH PARAMÈTRES
59 .TP
60 .B essid
61 Positionne le ESSID ( ou Network Name - pour certains produits, il peut aussi
62 être désigné comme Domain ID). L'ESSID est utilisé pour identifier les cellules
63 qui font partie du même réseau virtuel.
64 .br
65 Par opposition à l'adresse de l'AP ou au NWID qui définissent une seule cellule,
66 l'ESSID définit un groupe de cellules connectées via des répéteurs ou via
67 l'infrastructure, où l'utilisateur peut «\ roamer\ » ou errer de manière
68 transprente (c.-à-d. changer de cellule sans perdre sa connexion).
69 .br
70 Avec certaines cartes, vous pouvez désactiver le contrôle du ESSID (ESSID
71 promiscuous) avec
72 .IR off " ou " any " (et " on
73 pour le réactiver).
74 .br
75 .B Exemples :
76 .br
77 .I " iwconfig eth0 essid any"
78 .br
79 .I " iwconfig eth0 essid ""Mon Reseau""
80 .TP
81 .BR nwid / domain
82 Positionne le Network ID (pour certains produits, il peut aussi être appelé
83 Domain ID). Comme tous les réseaux sans fil adjacents partagent le même médium,
84 ce paramètre est utilisé pour les différencier (créer des réseaux logiques
85 colocalisés) et pour identifier des noeuds appartenant à la même cellule.
86 .br
87 Ce paramètre est seulement utilisé par les matériels antérieurs à 802.11, la
88 norme 802.11 se servant du ESSID et de l'adresse de l'AP pour cette fonction.
89 .br
90 Avec certaines cartes, vous pouvez désactiver le contrôle du Network ID (NWID
91 promiscuous) avec
92 .IR off " (et " on
93 pour le réactiver).
94 .br
95 .B Exemples :
96 .br
97 .I " iwconfig eth0 nwid AB34
98 .br
99 .I " iwconfig eth0 nwid off"
100 .TP
101 .BR freq / channel
102 Positionne la fréquence d'exploitation ou canal du périphérique. Une valeur
103 inférieure à 1\ 000 indique un numéro de canal, une valeur supérieure à 1\ 000
104 est une fréquence en Hz. Vous pouvez ajouter le suffixe k, M ou G à la valeur
105 (par exemple, «\ 2.46G\ » pour la fréquence 2,46\ GHz), ou ajouter suffisamment
106 de «\ 0\ ».
107 .br
108 Les canaux sont habituellement numérotés à partir de 1, et vous pouvez utiliser
109 .IR iwlist (8)
110 pour obtenir le nombre total de canaux, lister les fréquences disponibles, et
111 afficher le fréquence courante comme un canal.
112 Suivants les réglementations, certaines fréquences/canaux peuvent ne pas
113 être disponibles.
114 .br
115 .B Exemples :
116 .br
117 .I " iwconfig eth0 freq 2422000000"
118 .br
119 .I " iwconfig eth0 freq 2.422G"
120 .br
121 .I " iwconfig eth0 channel 3"
122 .TP
123 .B sens
124 Positionne le seuil de sensibilité. C'est le niveau de signal le plus bas pour
125 lequel le matériel essaye de réceptionner un paquet, les signaux plus bas sont
126 ignorés. Ceci est utilisé pour éviter de recevoir le bruit de fond, donc vous
127 devriez le positionner en fonction du niveau de bruit moyen. Les valeurs
128 positives sont supposées être les valeurs brutes utilisées par le matériel ou
129 un pourcentage, les valeurs négatives sont supposées être des dBm.
130 .br
131 Avec certains matériels, ce paramètre contrôle aussi le seuil de report
132 (defer threshold) (signal le plus faible pour lequel le matériel considère le
133 canal occupé) et le seuil de cession (handover threshold) (niveau de signal pour
134 lequel le matériel commence à chercher un nouveau Point d'Accès).
135 .br
136 .B Exemple :
137 .br
138 .I " iwconfig eth0 sens -80"
139 .TP
140 .B mode
141 Positionne le mode de fonctionnement du matériel, qui dépend de la topologie du
142 réseau. Le mode peut être
143 .I Ad-Hoc
144 (réseau composé d'une seule cellule et sans Point d'Accès),
145 .I Managed
146 (un noeud se connecte à un réseau composé de plusieurs Points d'Accès, avec
147 roaming ou errance),
148 .I Master
149 (le noeud est le maître qui synchronise ou agit comme un Point d'Accès),
150 .I Repeater
151 (le noeud transmet les paquets entre les autres n½uds wireless),
152 .I Secondary
153 (le noeud agit comme un maître/répéteur supplémentaire),
154 .I Monitor
155 (le noeud agit comme un moniteur passif et ne fait que recevoir des paquets) ou
156 .IR Auto .
157 .br
158 .B Exemple :
159 .br
160 .I " iwconfig eth0 mode Managed"
161 .br
162 .I " iwconfig eth0 mode Ad-Hoc"
163 .TP
164 .B ap
165 Force la carte à s'enregistrer auprès du Point d'Accès donné par l'adresse,
166 si c'est possible. Quand la qualité de la connexion devient trop mauvaise,
167 le pilote peut revenir en mode automatique (la carte sélectionne le meilleur
168 Point d'Accès à portée).
169 .br
170 Vous pouvez aussi utiliser
171 .I off
172 pour réactiver le mode automatique sans changer le Point d'Accès courant,
173 ou vous pouvez utiliser
174 .I any
175 ou
176 .I auto
177 pour forcer la carte à se ré associer avec le meilleur Point d'Accès courant.
178 .br
179 .B Exemple :
180 .br
181 .I " iwconfig eth0 ap 00:60:1D:01:23:45"
182 .br
183 .I " iwconfig eth0 ap any"
184 .br
185 .I " iwconfig eth0 ap off"
186 .TP
187 .BR nick [name]
188 Positionne le surnom (nickname), ou nom de station. Quelques produits
189 802.11 le définissent, mais il n'est pas utilisé dans la mesure où les
190 protocoles les plus usités (MAC, IP, TCP) ne s'en servent pas en l'état.
191 Seuls quelques outils de diagnostic peuvent l'utiliser.
192 .br
193 .B Exemple :
194 .br
195 .I " iwconfig eth0 nickname ""My Linux Node""
196 .TP
197 .BR rate / bit [rate]
198 Pour les cartes supportant plusieurs débits, positionne le débit en b/s. Le
199 débit est la vitesse à laquelle les bits sont transmis sur le médium, la
200 vitesse du lien pour l'utilisateur est inférieure à cause du partage du médium
201 et des diverses entêtes.
202 .br
203 Vous pouvez ajouter le suffixe k, M ou G à la valeur (multiplicateur décimal\ :
204 10^3, 10^6 et 10^9\ b/s), ou ajouter suffisamment de «\ 0\ ». Les valeurs
205 en-dessous de 1000 sont spécifiques à la carte, habituellement un index de la
206 liste des débit supportés. Utilisez
207 .I auto
208 pour sélectionner le mode débit automatique (repli à un débit moindre pour
209 les canaux bruités), ce qui est le mode par défaut pour la plupart des cartes,
210 et
211 .I fixed
212 pour revenir à des paramètres fixes. Si vous spécifiez une valeur de débit
213 et ajoutez
214 .IR auto ,
215 le driver utilisera tous les débits inférieurs et égaux à cette valeur.
216 .br
217 .B Exemples :
218 .br
219 .I " iwconfig eth0 rate 11M"
220 .br
221 .I " iwconfig eth0 rate auto"
222 .br
223 .I " iwconfig eth0 rate 5.5M auto"
224 .TP
225 .BR rts [_threshold]
226 RTS/CTS ajoute une «\ poignée de main\ » avant chaque transmission de paquet
227 pour être sûr que le canal est libre. Cela ajoute des entêtes (NDT\ : données de
228 gestion), mais augmente les performances en cas de n½uds cachés ou
229 d'un grand nombre de noeuds actifs. Ce paramètre fixe la taille du plus petit
230 paquet pour lequel le noeud envoie un RTS\ ; une valeur égale à la taille
231 maximale des paquets inhibe ce mécanisme. Vous pouvez aussi positionner
232 ce paramètre sur
233 .IR auto ", " fixed " ou " off .
234 .br
235 .B Exemples :
236 .br
237 .I " iwconfig eth0 rts 250"
238 .br
239 .I " iwconfig eth0 rts off"
240 .TP
241 .BR frag [mentation_threshold]
242 La fragmentation permet de découper un paquet IP en une série de plus petits
243 fragments transmis par le médium. Dans la plupart des cas, cela ajoute des
244 entêtes, mais dans un environnement très bruité, cela réduit les coûts de
245 transmission dus aux erreurs et permet aux paquets d'être acheminés malgré
246 des séries d'interférences. Ce paramètre fixe la taille de fragment maximale\ ;
247 une valeur égale à la taille maximale de paquet désactive ce procédé. Vous
248 pouvez aussi mettre ce paramètre à
249 .IR auto ", " fixed " ou " off .
250 .br
251 .B Exemples :
252 .br
253 .I " iwconfig eth0 frag 512"
254 .br
255 .I " iwconfig eth0 frag off"
256 .TP
257 .BR key / enc [ryption]
258 Utilisé pour manipuler les clefs de cryptage ou brouillage et le mode de
259 sécurité.
260 .br
261 Pour mettre la clef courante de cryptage, il suffit d'entrer la clef
262 en hexadécimal telle que
263 .IR XXXX-XXXX-XXXX-XXXX " ou " XXXXXXXX .
264 Pour entrer une autre clef que la clef courante, ajoutez (au début ou à la
265 fin)
266 .I [index]
267 à la clef elle-même (cela ne changera pas la clef active). Vous pouvez aussi
268 entrer la clef comme une chaîne ASCII en utilisant le préfixe
269 .IR s: .
270 Les phrases en tant que mot de passe ne sont actuellement pas supportées.
271 .br
272 Pour changer la clef active parmi les clefs déjà entrées, il suffit d'entrer
273 .RI l' "[index]"
274 (sans entrer de valeur de clef).
275 .br
276 .IR off " et " on
277 désactive et réactive le cryptage.
278 .br
279 Le mode de sécurité peut être
280 .I open
281 ou
282 .IR restricted ,
283 et sa signification dépend de la carte utilisée. Avec la plupart des cartes,
284 le mode
285 .I open
286 n'utilise pas d'authentification et la carte accepte des sessions non cryptées,
287 alors que le mode
288 .I restricted
289 n'accepte que des sessions cryptées et la carte utilisera l'authentification
290 si disponible.
291 .br
292 Si vous avez besoin de mettre plusieurs clefs, ou de mettre une clef et de
293 changer la clef active, vous avez besoin d'utiliser des instructions à clefs
294 .RB ( "key" )
295 multiples. Les arguments peuvent être mis dans n'importe quel ordre, le
296 dernier sera prioritaire.
297 .br
298 .B Exemples :
299 .br
300 .I " iwconfig eth0 key 0123-4567-89"
301 .br
302 .I " iwconfig eth0 key [3] 0123-4567-89"
303 .br
304 .I " iwconfig eth0 key s:password [2]"
305 .br
306 .I " iwconfig eth0 key [2]"
307 .br
308 .I " iwconfig eth0 key open"
309 .br
310 .I " iwconfig eth0 key off"
311 .br
312 .I " iwconfig eth0 key restricted [3] 0123456789"
313 .br
314 .I " iwconfig eth0 key 01-23 key 45-67 [4] key [4]"
315 .TP
316 .BR power
317 Utilisé pour manipuler les paramètres et le mode du procédé de gestion
318 d'énergie.
319 .br
320 Pour fixer la période entre les éveils, entrez la
321 .IR "period `valeur'" .
322 Pour fixer la temporisation avant le retour en veille, entrez la
323 .IR "timeout `valeur'" .
324 Vous pouvez aussi ajouter les modificateurs
325 .IR min " et " max ".
326 Par défaut, ces valeurs sont exprimées en secondes, ajoutez le suffixe m ou u
327 pour spécifier les valeurs en millisecondes ou microsecondes. Parfois, ces
328 valeurs sont sans unité (nombre de périodes de beacon, dwell ou similaire).
329 .br
330 .IR off " et " on
331 désactive et réactive la gestion d'énergie. Enfin, vous pouvez mettre la
332 gestion d'énergie en mode
333 .I all
334 (reçoit tous les paquets),
335 .I unicast
336 (reçoit seulement les paquets unicast, ignore les paquets multicast et de
337 broadcast) et
338 .I multicast
339 (reçoit seulement les paquets multicast et de broadcast, ignore l'unicast).
340 .br
341 .B Exemples :
342 .br
343 .I " iwconfig eth0 power period 2"
344 .br
345 .I " iwconfig eth0 power 500m unicast"
346 .br
347 .I " iwconfig eth0 power timeout 300u all"
348 .br
349 .I " iwconfig eth0 power off"
350 .br
351 .I " iwconfig eth0 power min period 2 power max period 4"
352 .TP
353 .BR txpower
354 Pour les cartes supportant plusieurs puissances de transmission, règle la
355 puissance de transmission en dBm. Si
356 .I W
357 est la puissance en Watt, la puissance en dBm est
358 .IR "P\ =\ 30\ +\ 10.log(W)" .
359 Si la valeur est post fixée par
360 .IR mW ,
361 elle sera automatiquement convertie en dBm.
362 .br
363 De plus,
364 .IR on " et " off
365 active et désactive la radio, et
366 .IR auto " et " fixed
367 active et désactive le contrôle de puissance (si ces fonctions sont
368 disponibles).
369 .br
370 .B Exemples :
371 .br
372 .I " iwconfig eth0 txpower 15"
373 .br
374 .I " iwconfig eth0 txpower 30mW"
375 .br
376 .I " iwconfig eth0 txpower auto"
377 .br
378 .I " iwconfig eth0 txpower off"
379 .TP
380 .BR retry
381 La plupart des cartes supportent les retransmissions MAC (contrôle d'accès
382 au médium), et certaines permettent le paramétrage du mécanisme des tentatives
383 (en cas d'échec).
384 .br
385 Pour fixer le nombre maximum d'essais, entrez
386 .IR "limit `valeur'" .
387 C'est une valeur absolue (sans unité).
388 Pour fixer le temps maximum autorisé au mécanisme MAC pour ses tentatives,
389 entrez
390 .IR "lifetime `valeur'" .
391 Par défaut, cette valeur est en secondes, ajouter le suffixe m ou u pour
392 spécifier les valeurs en millisecondes ou microsecondes.
393 .br
394 Vous pouvez aussi ajouter les modificateurs
395 .IR min " et " max ".
396 Si la carte supporte le mode automatique, ils définissent les limites du
397 lifetime, ou les limites inférieure et supérieure (NDT\ : de l'intervalle
398 temporel dans lequel le mécanisme MAC est autorisé à réitérer ses tentatives).
399 D'autres cartes définissent des valeurs différentes en fonction de la taille
400 des paquets, par exemple la norme 802.11 définit une
401 .I min limit
402 qui est la limite inférieure d'essai (paquets non RTS/CTS).
403 .br
404 .B Exemples :
405 .br
406 .I " iwconfig eth0 retry 16"
407 .br
408 .I " iwconfig eth0 retry lifetime 300m"
409 .br
410 .I " iwconfig eth0 retry min limit 8"
411 .TP
412 .BR commit
413 Certaines cartes peuvent ne pas appliquer immédiatement les changements
414 effectués par les Wireless Extensions (elles peuvent attendre pour prendre en
415 compte les changements ou les appliquer seulement quand la carte est montée via
416 ifconfig). Cette commande (si disponible) force la carte à appliquer les
417 changements en suspens.
418 .br
419 Cela n'est normalement pas nécessaire, car la carte appliquera éventuellement
420 les changements, mais peut être utile pour débuggage.
421 .\"
422 .\" DISPLAY part
423 .\"
424 .SH AFFICHAGE
425 Pour chaque matériel qui supporte les extensions wireless,
426 .I iwconfig
427 affiche le nom du
428 .B protocole MAC
429 utilisé (nom du matériel pour les protocoles propriétaires),
430 .RB l' ESSID
431 (Network Name), le
432 .BR NWID ,
433 la
434 .B fréquence
435 (ou canal), la
436 .BR sensibilité ,
437 le
438 .B mode
439 d'exploitation, l'adresse du
440 .BR "Point d'Accès",
441 le
442 .BR débit ,
443 le
444 .BR "seuil RTS" " (" "RTS threshold" "), le "
445 .BR "seuil de fragmentation" " (" "fragmentation threshold" "), la
446 .B clef de cryptage
447 et les paramètres de
448 .BR "gestion de l'énergie" " (" "power management" ")"
449 (en fonction de la disponibilité).
450 .PP
451 Les paramètres affichés ont la même signification et la même valeur que ceux
452 que vous pouvez régler, veuillez vous reporter à la précédente partie pour
453 leur explication détaillée.
454 .br
455 Quelques paramètres sont affichés seulement dans une forme abrégée (comme le
456 cryptage). Vous devez utiliser
457 .IR iwlist (8)
458 pour avoir tous les détails.
459 .br
460 Certains paramètres ont deux modes (comme le débit). Si la valeur est préfixée
461 par
462 .RB «\ =\ »,
463 cela veut dire que le paramètre est fixé et forcé à cette valeur, s'il est
464 préfixé par
465 .RB «\ :\ »,
466 le paramètre est en mode automatique et la valeur courante est montrée (et peut
467 changer).
468 .TP
469 .BR "Access Point" / Cell
470 Une adresse égale à 00:00:00:00:00:00 signifie que la carte n'a pas réussi à
471 s'associer avec un Point d'Accès (le plus souvent une question de
472 configuration).
473 Le paramètre
474 .B Access Point
475 sera montré comme une cellule
476 .RB ( Cell )
477 en mode ad hoc (pour des raisons évidentes), mais il fonctionne néanmoins
478 de la même manière.
479 .PP
480 Si
481 .I /proc/net/wireless
482 existe,
483 .I iwconfig
484 affichera aussi son contenu. Il faut noter que ces valeurs dépendent des
485 spécifications du pilote et de la carte, vous devrez donc vous référez à la
486 documentation du pilote pour une interprétation correcte de ces valeurs.
487 .TP
488 .B Link quality
489 Qualité globale du lien. Peut être basé sur le niveau de contention ou des
490 interférences, le taux d'erreur de trame ou de bit, la qualité du signal reçu,
491 des synchronisations temporelles, ou autre métrique matérielle. C'est une valeur
492 agrégat, et dépend totalement du pilote et du matériel.
493 .TP
494 .B Signal level
495 Force du signal reçu (RSSI - force du signal reçu). Cela peut être des unités
496 arbitraires ou des dBm,
497 .I iwconfig
498 utilise des méta-informations du pilote pour interpréter les valeurs
499 brutes données par
500 .I /proc/net/wireless
501 et affiche l'unité ou la valeur maximale correspondante (utilise l'arithmétique
502 8 bits). En mode
503 .I Ad-Hoc
504 cela peut être indéfini et vous devriez utiliser
505 .IR iwspy .
506 .TP
507 .B Noise level
508 Niveau du bruit de fond (quand aucun paquet n'est transmis). Commentaires
509 similaires à ceux de
510 .BR "Signal level" .
511 .TP
512 .B Rx invalid nwid
513 Nombre de paquets reçus avec un NWID ou ESSID différent. Utilisé pour détecter
514 des problèmes de configuration ou l'existence de réseau adjacent (sur la même
515 fréquence).
516 .TP
517 .B Rx invalid crypt
518 Nombre de paquets que le matériel a été incapable de décrypter. Cela peut être
519 utilisé pour détecter des mauvais paramètres de cryptage.
520 .TP
521 .B Rx invalid frag
522 Nombre de paquets pour lesquels le matériel a été incapable de ré-assembler
523 correctement les fragments de la couche liaison (le plus souvent, il en manque
524 un).
525 .TP
526 .B Tx excessive retries
527 Nombre de paquets que la carte n'a pas réussi à envoyer. La plupart des
528 protocoles MAC réessaient un certain nombre de fois avant d'abandonner.
529 .TP
530 .B invalid misc
531 Autres paquets perdus en relation avec les opérations spécifiques au sans fil.
532 .TP
533 .B Missed beacon
534 Nombre de beacons périodiques émis par la Cellule ou le Point d'Accès que nous
535 avons manqué. Les beacons sont envoyés à intervalles réguliers pour maintenir la
536 coordination de la cellule, l'impossibilité de les recevoir indiquant souvent
537 que la carte est hors de portée.
538 .\"
539 .\" AUTHOR part
540 .\"
541 .SH AUTEUR
542 Jean Tourrilhes \- jt@hpl.hp.com
543 .\"
544 .\" TRADUCTION part
545 .\"
546 .SH TRADUCTION
547 Maxime CHARPENNE, août 2004 (wireless_tools.27-pre25).
548 .\"
549 .\" AVERTISSEMENT part
550 .\"
551 .SH AVERTISSEMENT SUR LA TRADUCTION
552 Il est possible que cette traduction soit imparfaite ou périmée. En cas de
553 doute, veuillez vous reporter au document original en langue anglaise fourni
554 avec le programme.
555 .\"
556 .\" FILES part
557 .\"
558 .SH FICHIERS
559 .I /proc/net/wireless
560 .\"
561 .\" SEE ALSO part
562 .\"
563 .SH VOIR AUSSI
564 .BR ifconfig (8),
565 .BR iwspy (8),
566 .BR iwlist (8),
567 .BR iwevent (8),
568 .BR iwpriv (8),
569 .BR wireless (7).