1 .\" Jean II - HPLB - 1996 => HPL - 2004
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 .\" Mise à jour 2007/07 : version 29-pre21
11 .\" Mise à jour 2007/10 : version 30-pre1
12 .\" Mise à jour 2007/10/29 : version 30-pre3
14 .TH IWCONFIG 8 "30 mars 2006" "wireless-tools" "Manuel du programmeur Linux"
19 iwconfig \- configure une interface réseau sans-fil (wireless)
24 .BI "iwconfig [" interface ]
26 .BI "iwconfig " interface " [essid " X "] [nwid " N "] [mode " M "] [freq " F "]
28 .BI " [channel " C "] [sens " S "] [ap " A "] [nick " NN ]
30 .BI " [rate " R "] [rts " RT "] [frag " FT "] [txpower " T ]
32 .BI " [enc " E "] [key " K "] [power " P "] [retry " R ]
34 .BI " [modu " M "] [commit]
38 .BI "iwconfig --version"
46 mais est dédié aux interfaces wireless. Il est utilisé pour positionner les
47 paramètres des interfaces réseaux qui sont spécifiques aux opérations wireless
48 (par exemple\ : la fréquence).
50 peut aussi être utilisé pour afficher ces paramètres, et les statistiques
51 concernant le sans fil (extraites de
52 .IR /proc/net/wireless ).
54 Tous ces paramètres et statistiques dépendent du matériel. Chaque pilote ne
55 fournira que quelques uns d'entre eux en fonction du support matériel, et
56 l'étendue des valeurs peut changer. Veuillez vous référer aux pages man de
57 chaque matériel pour plus de détails.
64 Positionne le ESSID (ou Network Name - pour certains produits, il peut aussi
65 être désigné comme Domain ID). L'ESSID est utilisé pour identifier les cellules
66 qui font partie du même réseau virtuel.
68 Par opposition à l'adresse de l'AP (Point d'Accès) ou au NWID qui définissent
69 une seule cellule, l'ESSID définit un groupe de cellules connectées via des
70 répéteurs ou via l'infrastructure, où l'utilisateur peut errer («\ roamer\ »)
71 de manière transprente (c.-à-d. changer de noeud sans perdre sa connexion).
73 Avec certaines cartes, vous pouvez désactiver le contrôle du ESSID («\ ESSID
75 .IR off " ou " any " (et " on
78 Si le ESSID du réseau est un des mots-clefs spéciaux
79 .RI ( off ", " on " ou " any ),
86 .I " iwconfig eth0 essid any"
88 .I " iwconfig eth0 essid ""Mon Reseau""
90 .I " iwconfig eth0 essid -- ""ANY""
93 Positionne le Network ID. Comme tous les réseaux sans fil adjacents partagent
94 le même médium, ce paramètre est utilisé pour les différencier (créer des
95 réseaux logiques colocalisés) et pour identifier des noeuds appartenant à la
98 Ce paramètre est seulement utilisé par les matériels antérieurs à 802.11, la
99 norme 802.11 se servant du ESSID et de l'adresse de l'AP pour cette fonction.
101 Avec certaines cartes, vous pouvez désactiver le contrôle du Network ID (NWID
108 .I " iwconfig eth0 nwid AB34
110 .I " iwconfig eth0 nwid off"
113 Positionne le surnom (nickname), ou nom de station. Quelques produits
114 802.11 le définissent, mais il n'est pas utilisé dans la mesure où les
115 protocoles les plus usités (MAC, IP, TCP) ne s'en servent pas en l'état.
116 Seuls quelques outils de diagnostic peuvent l'utiliser.
120 .I " iwconfig eth0 nickname ""My Linux Node""
123 Positionne le mode de fonctionnement du matériel, qui dépend de la topologie du
124 réseau. Le mode peut être
126 (réseau composé d'une seule cellule et sans Point d'Accès),
128 (un noeud se connecte à un réseau composé de plusieurs Points d'Accès, avec
131 (le noeud est le maître qui synchronise ou agit comme un Point d'Accès),
133 (le noeud transmet les paquets entre les autres noeuds wireless),
135 (le noeud agit comme un maître/répéteur supplémentaire),
137 (le noeud agit comme un moniteur passif et ne fait que recevoir des paquets) ou
142 .I " iwconfig eth0 mode Managed"
144 .I " iwconfig eth0 mode Ad-Hoc"
147 Positionne la fréquence d'exploitation ou canal du périphérique. Une valeur
148 inférieure à 1\ 000 indique un numéro de canal, une valeur supérieure à 1\ 000
149 est une fréquence en Hz. Vous pouvez ajouter le suffixe k, M ou G à la valeur
150 (par exemple, «\ 2.46G\ » pour la fréquence 2,46\ GHz), ou ajouter suffisamment
153 Les canaux sont habituellement numérotés à partir de 1, et vous pouvez utiliser
155 pour obtenir le nombre total de canaux, lister les fréquences disponibles, et
156 afficher la fréquence courante comme un canal. Suivants les réglementations,
157 certaines fréquences/canaux peuvent ne pas être disponibles.
159 La plupart du temps lorsque le mode Managed est utilisé, le Point d'Accès
160 impose le canal et le pilote refusera le paramètre de la fréquence. Dans le
161 mode Ad-Hoc, le paramètre fréquence doit seulement être utilisé à la
162 création de la cellule initiale, et doit être ignoré quand on rejoint une
165 Vous pouvez aussi utiliser
169 pour laisser la carte choisir le meilleur canal (lorsque c'est supporté).
173 .I " iwconfig eth0 freq 2422000000"
175 .I " iwconfig eth0 freq 2.422G"
177 .I " iwconfig eth0 channel 3"
179 .I " iwconfig eth0 channel auto"
182 Force la carte à s'enregistrer auprès du Point d'Accès donné par l'adresse,
183 si c'est possible. Cette adresse est l'identité de la cellule du Point
184 d'Accès, celle indiqué par un scanning wireless, qui peut être différente de
185 son adresse MAC. Si le lien wireless est point-à-point, mettre l'adresse de
186 l'autre côté du lien. Si le lien est ad-hoc, mettre l'identité de la cellule
189 Quand la qualité de la connexion devient trop mauvaise,
190 le pilote peut revenir en mode automatique (la carte sélectionne le meilleur
191 Point d'Accès à portée).
193 Vous pouvez aussi utiliser
195 pour réactiver le mode automatique sans changer le Point d'Accès courant,
196 ou vous pouvez utiliser
200 pour forcer la carte à se ré-associer avec le meilleur Point d'Accès courant.
204 .I " iwconfig eth0 ap 00:60:1D:01:23:45"
206 .I " iwconfig eth0 ap any"
208 .I " iwconfig eth0 ap off"
210 .BR rate / bit [rate]
211 Pour les cartes supportant plusieurs débits, positionne le débit en b/s. Le
212 débit est la vitesse à laquelle les bits sont transmis sur le médium, la
213 vitesse du lien pour l'utilisateur est inférieure à cause du partage du
214 médium et des diverses entêtes.
216 Vous pouvez ajouter le suffixe k, M ou G à la valeur (multiplicateur
217 décimal\ : 10^3, 10^6 et 10^9\ b/s), ou ajouter suffisamment de '0'. Les
218 valeurs en-dessous de 1\ 000 sont spécifiques à la carte, habituellement un
219 index de la liste des débit supportés. Utilisez
221 pour sélectionner le mode débit automatique (repli à un débit moindre pour les
222 canaux bruités), ce qui est le mode par défaut pour la plupart des cartes, et
224 pour revenir à des paramètres fixes. Si vous spécifiez une valeur de débit
227 le driver utilisera tous les débits inférieurs et égaux à cette valeur.
231 .I " iwconfig eth0 rate 11M"
233 .I " iwconfig eth0 rate auto"
235 .I " iwconfig eth0 rate 5.5M auto"
238 Pour les cartes supportant plusieurs puissances de transmission, règle la
239 puissance de transmission en dBm. Si
241 est la puissance en Watt, la puissance en dBm est
242 .IR "P\ =\ 30\ +\ 10.log(W)" .
243 Si la valeur est post-fixée par
245 elle sera automatiquement convertie en dBm.
249 active et désactive la radio, et
250 .IR auto " et " fixed
251 active et désactive le contrôle de puissance (si ces fonctions sont
256 .I " iwconfig eth0 txpower 15"
258 .I " iwconfig eth0 txpower 30mW"
260 .I " iwconfig eth0 txpower auto"
262 .I " iwconfig eth0 txpower off"
265 Positionne le seuil de sensibilité. Cela définie comment la carte est sensible
266 aux mauvaises conditions de fonctionnement (signal faible, interférence). Les
267 valeurs positives sont considérées comme des valeurs brutes et utilisées telles
268 quelles par le matériel ou un pourcentage, les valeurs négatives sont
269 interprétées en dBm. En fonction de la conception du matétiel, ce paramètre
270 peut contrôler diverses fonctions.
272 Sur les cartes modernes, ce paramètre contrôle habituellement le seuil du
273 handover/roaming (seuil de cession), signal le plus bas pour lequel le matériel
274 reste associé au Point d'Accès courant. Lorsque le signal passe en-dessous de
275 ce seuil, la carte commence à chercher un nouveau/meilleur Point d'Accès.
276 Certaines cartes peuvent utiliser le nombre de beacons manquées pour déclencher
277 cela. En cas de forte densité de Points d'Accès, un seuil plus haut assure
278 d'être toujours associé au meilleur AP, et à l'inverse pour les faibles
279 densités d'APs, un seuil plus bas réduit les pertes d'associations.
281 Sur les cartes plus anciennes, ce paramètre contrôle habituellement le seuil de
282 report (defer treshold), signal le plus faible pour lequel le matériel considère
283 le canal occupé. Les niveaux de signal au-dessus de ce seuil font que le
284 matériel inhibe sa propre transmission, tandis que les signaux plus faibles que
285 ce seuil sont ignorés et le matériel est libre de transmettre. Cela est souvent
286 fortement lié au seuil de réception, le plus bas niveau de signal pour lequel
287 le matériel essaye de recevoir un paquet. Des paramètres apropriées pour ces
288 seuils évitent à la carte de perdre du temps sur le bruit de fond lors des
289 réceptions de transmissions faibles. Les conceptions modernes semblent contrôler
290 ces seuils automatiquement.
295 .I " iwconfig eth0 sens -80"
297 .I " iwconfig eth0 sens 2"
300 La plupart des cartes supportent les retransmissions MAC (contrôle d'accès
301 au médium), et certaines permettent le paramétrage du mécanisme des tentatives
304 Pour fixer le nombre maximum d'essais, entrez
305 .IR "limit `valeur'" .
306 C'est une valeur absolue (sans unité), et c'est le cas par défaut (si rien n'est
308 Pour fixer le temps maximum autorisé au mécanisme MAC pour ses tentatives,
310 .IR "lifetime `valeur'" .
311 Par défaut, cette valeur est en secondes, ajouter le suffixe m ou u pour
312 spécifier les valeurs en millisecondes ou microsecondes.
314 Vous pouvez aussi ajouter les modificateurs
315 .IR short ", " long ", " min " et " max "."
316 Si la carte supporte le mode automatique, ils définissent les limites
317 inférieure et supérieure (NDT\ : de l'intervalle temporel dans lequel le
318 mécanisme MAC est autorisé à réitérer ses tentatives). D'autres cartes
319 définissent des valeurs différentes en fonction de la taille des paquets, par
320 exemple la norme 802.11 définit une
322 qui est la limite inférieure d'essai (paquets non RTS/CTS).
326 .I " iwconfig eth0 retry 16"
328 .I " iwconfig eth0 retry lifetime 300m"
330 .I " iwconfig eth0 retry short 12"
332 .I " iwconfig eth0 retry min limit 8"
335 RTS/CTS ajoute une «\ poignée de main\ » avant chaque transmission de paquet
336 pour être sûr que le canal est libre. Cela ajoute des entêtes (NDT\ : données de
337 gestion), mais augmente les performances en cas de noeuds cachés ou d'un grand
338 nombre de noeuds actifs. Ce paramètre fixe la taille du plus petit paquet pour
339 lequel le noeud envoie un RTS\ ; une valeur égale à la taille maximale des
340 paquets inhibe ce mécanisme. Vous pouvez aussi positionner ce paramètre sur
341 .IR auto ", " fixed " ou " off .
345 .I " iwconfig eth0 rts 250"
347 .I " iwconfig eth0 rts off"
349 .BR frag [mentation_threshold]
350 La fragmentation permet de découper un paquet IP en une salve de plus petits
351 fragments transmis sur le médium. Dans la plupart des cas, cela ajoute des
352 entêtes, mais dans un environnement très bruité, cela réduit les coûts de
353 transmission dûs aux erreurs et permet aux paquets d'être acheminés malgré
354 des salves d'interférences. Ce paramètre fixe la taille de fragment maximale
355 qui est toujours inférieure à la taille maximale des paquets.
357 Ce paramètre peut aussi contrôler le «\ Frame Bursting\ » disponible sur
358 certaines cartes, capacité à envoyer de multiple paquets IP ensembles. Ce
359 mécanisme sera activé si la taille de fragment est plus grande que la taille
362 Vous pouvez aussi mettre ce paramètre à
363 .IR auto ", " fixed " ou " off .
367 .I " iwconfig eth0 frag 512"
369 .I " iwconfig eth0 frag off"
371 .BR key / enc [ryption]
372 Utilisé pour manipuler les clefs de cryptage ou brouillage et le mode de
375 Pour configurer la clef courante de cryptage, il suffit d'entrer la clef
376 en hexadécimal telle que
377 .IR XXXX-XXXX-XXXX-XXXX " ou " XXXXXXXX .
378 Pour entrer une autre clef que la clef courante, ajoutez (au début ou à la
381 à la clef elle-même (cela ne changera pas la clef active). Vous pouvez aussi
382 entrer la clef comme une chaîne ASCII en utilisant le préfixe
384 Les phrases en tant que mot de passe ne sont actuellement pas supportées.
386 Pour changer la clef active parmi les clefs déjà entrées, il suffit d'entrer
388 (sans entrer de valeur de clef).
391 désactive et réactive le cryptage.
393 Le mode de sécurité peut être
397 et sa signification dépend de la carte utilisée. Avec la plupart des cartes,
400 n'utilise pas d'authentification et la carte accepte des sessions non cryptées,
403 n'accepte que des sessions cryptées et la carte utilisera l'authentification
406 Si vous avez besoin de mettre plusieurs clefs, ou de mettre une clef et de
407 changer la clef active, vous avez besoin d'utiliser des instructions de clef
409 multiples. Les arguments peuvent être mis dans n'importe quel ordre, le
410 dernier sera prioritaire.
414 .I " iwconfig eth0 key 0123-4567-89"
416 .I " iwconfig eth0 key [3] 0123-4567-89"
418 .I " iwconfig eth0 key s:password [2]"
420 .I " iwconfig eth0 key [2]"
422 .I " iwconfig eth0 key open"
424 .I " iwconfig eth0 key off"
426 .I " iwconfig eth0 key restricted [3] 0123456789"
428 .I " iwconfig eth0 key 01-23 key 45-67 [4] key [4]"
431 Utilisé pour manipuler les paramètres et le mode du procédé de gestion
434 Pour fixer la période entre les éveils, entrez
435 .IR "period `valeur'" .
436 Pour fixer la temporisation avant le retour en veille, entrez la
437 .IR "timeout `valeur'" .
438 Pour paramétrer le niveau générique de sauvegarde d'énergie, entrez
439 .IR "saving `valeur'" .
440 Vous pouvez aussi ajouter les modificateurs
441 .IR min " et " max ".
442 Par défaut, ces valeurs sont exprimées en secondes, ajoutez le suffixe m ou u
443 pour spécifier les valeurs en millisecondes ou microsecondes. Parfois, ces
444 valeurs sont sans unité (nombre de périodes de beacon, dwell, pourcentage ou
448 désactive et réactive la gestion d'énergie. Enfin, vous pouvez mettre la
449 gestion d'énergie en mode
451 (reçoit tous les paquets),
453 (reçoit seulement les paquets unicast, ignore les paquets multicast et de
456 (reçoit seulement les paquets multicast et de broadcast, ignore l'unicast).
460 .I " iwconfig eth0 power period 2"
462 .I " iwconfig eth0 power 500m unicast"
464 .I " iwconfig eth0 power timeout 300u all"
466 .I " iwconfig eth0 power saving 3"
468 .I " iwconfig eth0 power off"
470 .I " iwconfig eth0 power min period 2 power max period 4"
473 Force la carte à utiliser un jeu spécifique de modulations. Les cartes modernes
474 supportent diverses modulations, certaines étant standards telles 802.11b ou
475 802.11g, d'autres étant propriétaires. Cette commande force la carte à utiliser
476 seulement le jeu spécifique de modulations listé par la ligne de commande. Ceci
477 peut être utilisé pour résoudre des problèmes d'interopérabilité.
479 La liste des modulations disponibles dépend du couple carte/pilote et peut être
480 affichée en utilisant
481 .IR "iwlist modulation" .
482 Notez que certains couples carte/pilote peuvent ne pas être capables de
483 sélectionner chaque modulation listée indépandement, certaines intervenant comme
484 un groupe. Vous pouvez aussi mettre ce paramètre à
486 pour laisser le couple carte/pilote faire de son mieux.
490 .I " iwconfig eth0 modu 11g"
492 .I " iwconfig eth0 modu CCK OFDMa"
494 .I " iwconfig eth0 modu auto"
497 Certaines cartes peuvent ne pas appliquer immédiatement les changements
498 effectués par les Wireless Extensions (elles peuvent attendre pour prendre en
499 compte les changements ou les appliquer seulement quand la carte est montée via
501 Cette commande (si disponible) force la carte à appliquer les changements en
504 Cela n'est normalement pas nécessaire, car la carte appliquera éventuellement
505 les changements, mais peut être utile pour débuggage.
510 Pour chaque matériel qui supporte les extensions wireless,
514 utilisé (nom du matériel pour les protocoles propriétaires),
524 d'exploitation, l'adresse du
529 .BR "seuil RTS" " (" "RTS threshold" "), le "
530 .BR "seuil de fragmentation" " (" "fragmentation threshold" "), la
533 .BR "gestion de l'énergie" " (" "power management" ")"
534 (en fonction de la disponibilité).
536 Les paramètres affichés ont la même signification et la même valeur que ceux
537 que vous pouvez régler, veuillez vous reporter à la précédente partie pour
538 leur explication détaillée.
540 Quelques paramètres sont affichés seulement dans une forme abrégée (comme le
541 cryptage). Vous devez utiliser
543 pour avoir tous les détails.
545 Certains paramètres ont deux modes (comme le débit). Si la valeur est préfixée
548 cela veut dire que le paramètre est fixé et forcé à cette valeur, s'il est
551 le paramètre est en mode automatique et la valeur courante est montrée (et peut
554 .BR "Access Point" / Cell
555 Une adresse égale à 00:00:00:00:00:00 signifie que la carte n'a pas réussi à
556 s'associer avec un Point d'Accès (le plus souvent une question de
560 sera montré comme une cellule
562 en mode ad-hoc (pour des raisons évidentes), mais il fonctionne néanmoins
566 .I /proc/net/wireless
569 affichera aussi son contenu. Il faut noter que ces valeurs dépendent des
570 spécifications du pilote et de la carte, vous devrez donc vous référez à la
571 documentation du pilote pour une interprétation correcte de ces valeurs.
574 Qualité globale du lien. Peut être basé sur le niveau de contention ou des
575 interférences, le taux d'erreur de trame ou de bit, la qualité du signal reçu,
576 certaines synchronisations temporelles, ou d'autre métrique matérielle. C'est
577 une valeur agrégat, et dépend totalement du pilote et du matériel.
580 Force du signal reçu (RSSI - force du signal reçu). Ce peut être des unités
581 arbitraires ou des dBm,
583 utilise les méta-informations du pilote pour interpréter les valeurs
585 .I /proc/net/wireless
586 et affiche l'unité ou la valeur maximale correspondante (en utilisant
587 l'arithmétique 8 bits). En mode
589 cela peut être indéfini et vous devriez utiliser
593 Niveau du bruit de fond (quand aucun paquet n'est transmis). Commentaires
598 Nombre de paquets reçus avec un NWID ou ESSID différent. Utilisé pour détecter
599 des problèmes de configuration ou l'existence de réseau adjacent (sur la même
603 Nombre de paquets que le matériel a été incapable de décrypter. Cela peut être
604 utilisé pour détecter des mauvais paramètres de cryptage.
607 Nombre de paquets pour lesquels le matériel a été incapable de ré-assembler
608 correctement les fragments de la couche liaison (le plus souvent, il en manque
611 .B Tx excessive retries
612 Nombre de paquets que la carte n'a pas réussi à envoyer. La plupart des
613 protocoles MAC réessayent un certain nombre de fois avant d'abandonner.
616 Autres paquets perdus en relation avec les opérations spécifiques au sans fil.
619 Nombre de beacons périodiques émis par la Cellule ou le Point d'Accès que nous
620 avons manqué. Les beacons sont envoyés à intervalles réguliers pour maintenir la
621 coordination de la cellule, l'impossibilité de les recevoir indiquant souvent
622 que la carte est hors de portée.
627 Jean Tourrilhes \- jt@hpl.hp.com
632 Maxime CHARPENNE, octobre 2007 (wireless_tools.30-pre3).
634 .\" AVERTISSEMENT part
636 .SH AVERTISSEMENT SUR LA TRADUCTION
637 Il est possible que cette traduction soit imparfaite ou périmée. En cas de
638 doute, veuillez vous reporter au document original en langue anglaise fourni
644 .I /proc/net/wireless