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
11 .TH IWCONFIG 8 "22 juin 2004" "wireless-tools" "Manuel du programmeur Linux"
16 iwconfig \- configure une interface réseau sans-fil (wireless)
21 .BI "iwconfig [" interface ]
23 .BI "iwconfig " interface " [essid " X "] [nwid " N "] [freq " F "] [channel " C ]
25 .BI " [sens " S "] [mode " M "] [ap " A "] [nick " NN ]
27 .BI " [rate " R "] [rts " RT "] [frag " FT "] [txpower " T ]
29 .BI " [enc " E "] [key " K "] [power " P "] [retry " R ]
35 .BI "iwconfig --version"
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).
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 ).
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.
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.
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).
70 Avec certaines cartes, vous pouvez désactiver le contrôle du ESSID (ESSID
72 .IR off " ou " any " (et " on
77 .I " iwconfig eth0 essid any"
79 .I " iwconfig eth0 essid ""Mon Reseau""
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.
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.
90 Avec certaines cartes, vous pouvez désactiver le contrôle du Network ID (NWID
97 .I " iwconfig eth0 nwid AB34
99 .I " iwconfig eth0 nwid off"
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
108 Les canaux sont habituellement numérotés à partir de 1, et vous pouvez utiliser
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
117 .I " iwconfig eth0 freq 2422000000"
119 .I " iwconfig eth0 freq 2.422G"
121 .I " iwconfig eth0 channel 3"
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.
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).
138 .I " iwconfig eth0 sens -80"
141 Positionne le mode de fonctionnement du matériel, qui dépend de la topologie du
142 réseau. Le mode peut être
144 (réseau composé d'une seule cellule et sans Point d'Accès),
146 (un noeud se connecte à un réseau composé de plusieurs Points d'Accès, avec
149 (le noeud est le maître qui synchronise ou agit comme un Point d'Accès),
151 (le noeud transmet les paquets entre les autres n½uds wireless),
153 (le noeud agit comme un maître/répéteur supplémentaire),
155 (le noeud agit comme un moniteur passif et ne fait que recevoir des paquets) ou
160 .I " iwconfig eth0 mode Managed"
162 .I " iwconfig eth0 mode Ad-Hoc"
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).
170 Vous pouvez aussi utiliser
172 pour réactiver le mode automatique sans changer le Point d'Accès courant,
173 ou vous pouvez utiliser
177 pour forcer la carte à se ré associer avec le meilleur Point d'Accès courant.
181 .I " iwconfig eth0 ap 00:60:1D:01:23:45"
183 .I " iwconfig eth0 ap any"
185 .I " iwconfig eth0 ap off"
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.
195 .I " iwconfig eth0 nickname ""My Linux Node""
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.
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
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,
212 pour revenir à des paramètres fixes. Si vous spécifiez une valeur de débit
215 le driver utilisera tous les débits inférieurs et égaux à cette valeur.
219 .I " iwconfig eth0 rate 11M"
221 .I " iwconfig eth0 rate auto"
223 .I " iwconfig eth0 rate 5.5M auto"
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
233 .IR auto ", " fixed " ou " off .
237 .I " iwconfig eth0 rts 250"
239 .I " iwconfig eth0 rts off"
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 .
253 .I " iwconfig eth0 frag 512"
255 .I " iwconfig eth0 frag off"
257 .BR key / enc [ryption]
258 Utilisé pour manipuler les clefs de cryptage ou brouillage et le mode de
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
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
270 Les phrases en tant que mot de passe ne sont actuellement pas supportées.
272 Pour changer la clef active parmi les clefs déjà entrées, il suffit d'entrer
274 (sans entrer de valeur de clef).
277 désactive et réactive le cryptage.
279 Le mode de sécurité peut être
283 et sa signification dépend de la carte utilisée. Avec la plupart des cartes,
286 n'utilise pas d'authentification et la carte accepte des sessions non cryptées,
289 n'accepte que des sessions cryptées et la carte utilisera l'authentification
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
295 multiples. Les arguments peuvent être mis dans n'importe quel ordre, le
296 dernier sera prioritaire.
300 .I " iwconfig eth0 key 0123-4567-89"
302 .I " iwconfig eth0 key [3] 0123-4567-89"
304 .I " iwconfig eth0 key s:password [2]"
306 .I " iwconfig eth0 key [2]"
308 .I " iwconfig eth0 key open"
310 .I " iwconfig eth0 key off"
312 .I " iwconfig eth0 key restricted [3] 0123456789"
314 .I " iwconfig eth0 key 01-23 key 45-67 [4] key [4]"
317 Utilisé pour manipuler les paramètres et le mode du procédé de gestion
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).
331 désactive et réactive la gestion d'énergie. Enfin, vous pouvez mettre la
332 gestion d'énergie en mode
334 (reçoit tous les paquets),
336 (reçoit seulement les paquets unicast, ignore les paquets multicast et de
339 (reçoit seulement les paquets multicast et de broadcast, ignore l'unicast).
343 .I " iwconfig eth0 power period 2"
345 .I " iwconfig eth0 power 500m unicast"
347 .I " iwconfig eth0 power timeout 300u all"
349 .I " iwconfig eth0 power off"
351 .I " iwconfig eth0 power min period 2 power max period 4"
354 Pour les cartes supportant plusieurs puissances de transmission, règle la
355 puissance de transmission en dBm. Si
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
361 elle sera automatiquement convertie en dBm.
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
372 .I " iwconfig eth0 txpower 15"
374 .I " iwconfig eth0 txpower 30mW"
376 .I " iwconfig eth0 txpower auto"
378 .I " iwconfig eth0 txpower off"
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
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,
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.
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
402 qui est la limite inférieure d'essai (paquets non RTS/CTS).
406 .I " iwconfig eth0 retry 16"
408 .I " iwconfig eth0 retry lifetime 300m"
410 .I " iwconfig eth0 retry min limit 8"
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.
419 Cela n'est normalement pas nécessaire, car la carte appliquera éventuellement
420 les changements, mais peut être utile pour débuggage.
425 Pour chaque matériel qui supporte les extensions wireless,
429 utilisé (nom du matériel pour les protocoles propriétaires),
439 d'exploitation, l'adresse du
444 .BR "seuil RTS" " (" "RTS threshold" "), le "
445 .BR "seuil de fragmentation" " (" "fragmentation threshold" "), la
448 .BR "gestion de l'énergie" " (" "power management" ")"
449 (en fonction de la disponibilité).
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.
455 Quelques paramètres sont affichés seulement dans une forme abrégée (comme le
456 cryptage). Vous devez utiliser
458 pour avoir tous les détails.
460 Certains paramètres ont deux modes (comme le débit). Si la valeur est préfixée
463 cela veut dire que le paramètre est fixé et forcé à cette valeur, s'il est
466 le paramètre est en mode automatique et la valeur courante est montrée (et peut
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
475 sera montré comme une cellule
477 en mode ad hoc (pour des raisons évidentes), mais il fonctionne néanmoins
481 .I /proc/net/wireless
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.
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.
495 Force du signal reçu (RSSI - force du signal reçu). Cela peut être des unités
496 arbitraires ou des dBm,
498 utilise des méta-informations du pilote pour interpréter les valeurs
500 .I /proc/net/wireless
501 et affiche l'unité ou la valeur maximale correspondante (utilise l'arithmétique
504 cela peut être indéfini et vous devriez utiliser
508 Niveau du bruit de fond (quand aucun paquet n'est transmis). Commentaires
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
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.
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
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.
531 Autres paquets perdus en relation avec les opérations spécifiques au sans fil.
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.
542 Jean Tourrilhes \- jt@hpl.hp.com
547 Maxime CHARPENNE, août 2004 (wireless_tools.27-pre25).
549 .\" AVERTISSEMENT part
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
559 .I /proc/net/wireless