Provided by: wireless-tools_30~pre9-17ubuntu1_amd64 
NOM
iwconfig - configure une interface réseau sans-fil (wireless)
SYNOPSIS
iwconfig [interface]
iwconfig interface [essid X] [nwid N] [mode M] [freq F]
[channel C] [sens S] [ap A] [nick NN]
[rate R] [rts RT] [frag FT] [txpower T]
[enc E] [key K] [power P] [retry R]
[modu M] [commit]
iwconfig --help
iwconfig --version
DESCRIPTION
Iwconfig est similaire à ifconfig(8), mais est dédié aux interfaces wireless. Il est
utilisé pour positionner les paramètres des interfaces réseaux qui sont spécifiques aux
opérations wireless (par exemple : la fréquence). Iwconfig peut aussi être utilisé pour
afficher ces paramètres, et les statistiques concernant le sans fil (extraites de
/proc/net/wireless).
Tous ces paramètres et statistiques dépendent du matériel. Chaque pilote ne fournira que
quelques uns d'entre eux en fonction du support matériel, et l'étendue des valeurs peut
changer. Veuillez vous référer aux pages man de chaque matériel pour plus de détails.
PARAMÈTRES
essid Positionne le ESSID (ou Network Name - pour certains produits, il peut aussi être
désigné comme Domain ID). L'ESSID est utilisé pour identifier les cellules qui font
partie du même réseau virtuel.
Par opposition à l'adresse de l'AP (Point d'Accès) ou au NWID qui définissent une
seule cellule, l'ESSID définit un groupe de cellules connectées via des répéteurs
ou via l'infrastructure, où l'utilisateur peut errer (« roamer ») de manière
transprente (c.-à-d. changer de noeud sans perdre sa connexion).
Avec certaines cartes, vous pouvez désactiver le contrôle du ESSID (« ESSID
promiscuous ») avec off ou any (et on pour le réactiver).
Si le ESSID du réseau est un des mots-clefs spéciaux (off, on ou any), vous devrez
utiliser -- pour l'échapper.
Exemples :
iwconfig eth0 essid any
iwconfig eth0 essid "Mon Reseau"
iwconfig eth0 essid -- "ANY"
nwid Positionne le Network ID. Comme tous les réseaux sans fil adjacents partagent le
même médium, ce paramètre est utilisé pour les différencier (créer des réseaux
logiques colocalisés) et pour identifier des nœuds appartenant à la même cellule.
Ce paramètre est seulement utilisé par les matériels antérieurs à 802.11, la norme
802.11 se servant du ESSID et de l'adresse de l'AP pour cette fonction.
Avec certaines cartes, vous pouvez désactiver le contrôle du Network ID (NWID
promiscuous) avec off (et on pour le réactiver).
Exemples :
iwconfig eth0 nwid AB34
iwconfig eth0 nwid off
nick[name]
Positionne le surnom (nickname), ou nom de station. Quelques produits 802.11 le
définissent, mais il n'est pas utilisé dans la mesure où les protocoles les plus
usités (MAC, IP, TCP) ne s'en servent pas en l'état. Seuls quelques outils de
diagnostic peuvent l'utiliser.
Exemple :
iwconfig eth0 nickname "My Linux Node"
mode Positionne le mode de fonctionnement du matériel, qui dépend de la topologie du
réseau. Le mode peut être Ad-Hoc (réseau composé d'une seule cellule et sans Point
d'Accès), Managed (un nœud se connecte à un réseau composé de plusieurs Points
d'Accès, avec roaming ou errance), Master (le nœud est le maître qui synchronise ou
agit comme un Point d'Accès), Repeater (le nœud transmet les paquets entre les
autres nœuds wireless), Secondary (le nœud agit comme un maître/répéteur
supplémentaire), Monitor (le nœud agit comme un moniteur passif et ne fait que
recevoir des paquets) ou Auto.
Exemple :
iwconfig eth0 mode Managed
iwconfig eth0 mode Ad-Hoc
freq/channel
Positionne la fréquence d'exploitation ou canal du périphérique. Une valeur
inférieure à 1 000 indique un numéro de canal, une valeur supérieure à 1 000 est
une fréquence en Hz. Vous pouvez ajouter le suffixe k, M ou G à la valeur (par
exemple, « 2.46G » pour la fréquence 2,46 GHz), ou ajouter suffisamment de '0'.
Les canaux sont habituellement numérotés à partir de 1, et vous pouvez utiliser
iwlist(8) pour obtenir le nombre total de canaux, lister les fréquences
disponibles, et afficher la fréquence courante comme un canal. Suivants les
réglementations, certaines fréquences/canaux peuvent ne pas être disponibles.
La plupart du temps lorsque le mode Managed est utilisé, le Point d'Accès impose le
canal et le pilote refusera le paramètre de la fréquence. Dans le mode Ad-Hoc, le
paramètre fréquence doit seulement être utilisé à la création de la cellule
initiale, et doit être ignoré quand on rejoint une cellule existante.
Vous pouvez aussi utiliser off ou auto pour laisser la carte choisir le meilleur
canal (lorsque c'est supporté).
Exemples :
iwconfig eth0 freq 2422000000
iwconfig eth0 freq 2.422G
iwconfig eth0 channel 3
iwconfig eth0 channel auto
ap Force la carte à s'enregistrer auprès du Point d'Accès donné par l'adresse, si
c'est possible. Cette adresse est l'identité de la cellule du Point d'Accès, celle
indiqué par un scanning wireless, qui peut être différente de son adresse MAC. Si
le lien wireless est point-à-point, mettre l'adresse de l'autre côté du lien. Si le
lien est ad-hoc, mettre l'identité de la cellule du réseau ad-hoc.
Quand la qualité de la connexion devient trop mauvaise, le pilote peut revenir en
mode automatique (la carte sélectionne le meilleur Point d'Accès à portée).
Vous pouvez aussi utiliser off pour réactiver le mode automatique sans changer le
Point d'Accès courant, ou vous pouvez utiliser any ou auto pour forcer la carte à
se ré-associer avec le meilleur Point d'Accès courant.
Exemple :
iwconfig eth0 ap 00:60:1D:01:23:45
iwconfig eth0 ap any
iwconfig eth0 ap off
rate/bit[rate]
Pour les cartes supportant plusieurs débits, positionne le débit en b/s. Le débit
est la vitesse à laquelle les bits sont transmis sur le médium, la vitesse du lien
pour l'utilisateur est inférieure à cause du partage du médium et des diverses
entêtes.
Vous pouvez ajouter le suffixe k, M ou G à la valeur (multiplicateur décimal :
10^3, 10^6 et 10^9 b/s), ou ajouter suffisamment de '0'. Les valeurs en-dessous de
1 000 sont spécifiques à la carte, habituellement un index de la liste des débit
supportés. Utilisez auto pour sélectionner le mode débit automatique (repli à un
débit moindre pour les canaux bruités), ce qui est le mode par défaut pour la
plupart des cartes, et fixed pour revenir à des paramètres fixes. Si vous spécifiez
une valeur de débit et ajoutez auto, le driver utilisera tous les débits inférieurs
et égaux à cette valeur.
Exemples :
iwconfig eth0 rate 11M
iwconfig eth0 rate auto
iwconfig eth0 rate 5.5M auto
txpower
Pour les cartes supportant plusieurs puissances de transmission, règle la puissance
de transmission en dBm. Si W est la puissance en Watt, la puissance en dBm est
P = 30 + 10.log(W). Si la valeur est post-fixée par mW, elle sera automatiquement
convertie en dBm.
De plus, on et off active et désactive la radio, et auto et fixed active et
désactive le contrôle de puissance (si ces fonctions sont disponibles).
Exemples :
iwconfig eth0 txpower 15
iwconfig eth0 txpower 30mW
iwconfig eth0 txpower auto
iwconfig eth0 txpower off
sens Positionne le seuil de sensibilité. Cela définie comment la carte est sensible aux
mauvaises conditions de fonctionnement (signal faible, interférence). Les valeurs
positives sont considérées comme des valeurs brutes et utilisées telles quelles par
le matériel ou un pourcentage, les valeurs négatives sont interprétées en dBm. En
fonction de la conception du matétiel, ce paramètre peut contrôler diverses
fonctions.
Sur les cartes modernes, ce paramètre contrôle habituellement le seuil du
handover/roaming (seuil de cession), signal le plus bas pour lequel le matériel
reste associé au Point d'Accès courant. Lorsque le signal passe en-dessous de ce
seuil, la carte commence à chercher un nouveau/meilleur Point d'Accès. Certaines
cartes peuvent utiliser le nombre de beacons manquées pour déclencher cela. En cas
de forte densité de Points d'Accès, un seuil plus haut assure d'être toujours
associé au meilleur AP, et à l'inverse pour les faibles densités d'APs, un seuil
plus bas réduit les pertes d'associations.
Sur les cartes plus anciennes, ce paramètre contrôle habituellement le seuil de
report (defer treshold), signal le plus faible pour lequel le matériel considère le
canal occupé. Les niveaux de signal au-dessus de ce seuil font que le matériel
inhibe sa propre transmission, tandis que les signaux plus faibles que ce seuil
sont ignorés et le matériel est libre de transmettre. Cela est souvent fortement
lié au seuil de réception, le plus bas niveau de signal pour lequel le matériel
essaye de recevoir un paquet. Des paramètres apropriées pour ces seuils évitent à
la carte de perdre du temps sur le bruit de fond lors des réceptions de
transmissions faibles. Les conceptions modernes semblent contrôler ces seuils
automatiquement.
Exemple :
iwconfig eth0 sens -80
iwconfig eth0 sens 2
retry La plupart des cartes supportent les retransmissions MAC (contrôle d'accès au
médium), et certaines permettent le paramétrage du mécanisme des tentatives (en cas
d'échec).
Pour fixer le nombre maximum d'essais, entrez limit `valeur'. C'est une valeur
absolue (sans unité), et c'est le cas par défaut (si rien n'est spécifié). Pour
fixer le temps maximum autorisé au mécanisme MAC pour ses tentatives, entrez
lifetime `valeur'. Par défaut, cette valeur est en secondes, ajouter le suffixe m
ou u pour spécifier les valeurs en millisecondes ou microsecondes.
Vous pouvez aussi ajouter les modificateurs short, long, min et max. Si la carte
supporte le mode automatique, ils définissent les limites inférieure et supérieure
(NDT : de l'intervalle temporel dans lequel le mécanisme MAC est autorisé à
réitérer ses tentatives). D'autres cartes définissent des valeurs différentes en
fonction de la taille des paquets, par exemple la norme 802.11 définit une min
limit qui est la limite inférieure d'essai (paquets non RTS/CTS).
Exemples :
iwconfig eth0 retry 16
iwconfig eth0 retry lifetime 300m
iwconfig eth0 retry short 12
iwconfig eth0 retry min limit 8
rts[_threshold]
RTS/CTS ajoute une « poignée de main » avant chaque transmission de paquet pour
être sûr que le canal est libre. Cela ajoute des entêtes (NDT : données de
gestion), mais augmente les performances en cas de nœuds cachés ou d'un grand
nombre de nœuds actifs. Ce paramètre fixe la taille du plus petit paquet pour
lequel le nœud envoie un RTS ; une valeur égale à la taille maximale des paquets
inhibe ce mécanisme. Vous pouvez aussi positionner ce paramètre sur auto, fixed ou
off.
Exemples :
iwconfig eth0 rts 250
iwconfig eth0 rts off
frag[mentation_threshold]
La fragmentation permet de découper un paquet IP en une salve de plus petits
fragments transmis sur le médium. Dans la plupart des cas, cela ajoute des entêtes,
mais dans un environnement très bruité, cela réduit les coûts de transmission dûs
aux erreurs et permet aux paquets d'être acheminés malgré des salves
d'interférences. Ce paramètre fixe la taille de fragment maximale qui est toujours
inférieure à la taille maximale des paquets.
Ce paramètre peut aussi contrôler le « Frame Bursting » disponible sur certaines
cartes, capacité à envoyer de multiple paquets IP ensembles. Ce mécanisme sera
activé si la taille de fragment est plus grande que la taille maximale de paquet.
Vous pouvez aussi mettre ce paramètre à auto, fixed ou off.
Exemples :
iwconfig eth0 frag 512
iwconfig eth0 frag off
key/enc[ryption]
Utilisé pour manipuler les clefs de cryptage ou brouillage et le mode de sécurité.
Pour configurer la clef courante de cryptage, il suffit d'entrer la clef en
hexadécimal telle que XXXX-XXXX-XXXX-XXXX ou XXXXXXXX. Pour entrer une autre clef
que la clef courante, ajoutez (au début ou à la fin) [index] à la clef elle-même
(cela ne changera pas la clef active). Vous pouvez aussi entrer la clef comme une
chaîne ASCII en utilisant le préfixe s:. Les phrases en tant que mot de passe ne
sont actuellement pas supportées.
Pour changer la clef active parmi les clefs déjà entrées, il suffit d'entrer
l'[index] (sans entrer de valeur de clef).
off et on désactive et réactive le cryptage.
Le mode de sécurité peut être open ou restricted, et sa signification dépend de la
carte utilisée. Avec la plupart des cartes, le mode open n'utilise pas
d'authentification et la carte accepte des sessions non cryptées, alors que le mode
restricted n'accepte que des sessions cryptées et la carte utilisera
l'authentification si disponible.
Si vous avez besoin de mettre plusieurs clefs, ou de mettre une clef et de changer
la clef active, vous avez besoin d'utiliser des instructions de clef (key)
multiples. Les arguments peuvent être mis dans n'importe quel ordre, le dernier
sera prioritaire.
Exemples :
iwconfig eth0 key 0123-4567-89
iwconfig eth0 key [3] 0123-4567-89
iwconfig eth0 key s:password [2]
iwconfig eth0 key [2]
iwconfig eth0 key open
iwconfig eth0 key off
iwconfig eth0 key restricted [3] 0123456789
iwconfig eth0 key 01-23 key 45-67 [4] key [4]
power Utilisé pour manipuler les paramètres et le mode du procédé de gestion d'énergie.
Pour fixer la période entre les éveils, entrez period `valeur'. Pour fixer la
temporisation avant le retour en veille, entrez la timeout `valeur'. Pour
paramétrer le niveau générique de sauvegarde d'énergie, entrez saving `valeur'.
Vous pouvez aussi ajouter les modificateurs min et max. Par défaut, ces valeurs
sont exprimées en secondes, ajoutez le suffixe m ou u pour spécifier les valeurs en
millisecondes ou microsecondes. Parfois, ces valeurs sont sans unité (nombre de
périodes de beacon, dwell, pourcentage ou similaire).
off et on désactive et réactive la gestion d'énergie. Enfin, vous pouvez mettre la
gestion d'énergie en mode all (reçoit tous les paquets), unicast (reçoit seulement
les paquets unicast, ignore les paquets multicast et de broadcast) et multicast
(reçoit seulement les paquets multicast et de broadcast, ignore l'unicast).
Exemples :
iwconfig eth0 power period 2
iwconfig eth0 power 500m unicast
iwconfig eth0 power timeout 300u all
iwconfig eth0 power saving 3
iwconfig eth0 power off
iwconfig eth0 power min period 2 power max period 4
modu[lation]
Force la carte à utiliser un jeu spécifique de modulations. Les cartes modernes
supportent diverses modulations, certaines étant standards telles 802.11b ou
802.11g, d'autres étant propriétaires. Cette commande force la carte à utiliser
seulement le jeu spécifique de modulations listé par la ligne de commande. Ceci
peut être utilisé pour résoudre des problèmes d'interopérabilité.
La liste des modulations disponibles dépend du couple carte/pilote et peut être
affichée en utilisant iwlist modulation. Notez que certains couples carte/pilote
peuvent ne pas être capables de sélectionner chaque modulation listée
indépandement, certaines intervenant comme un groupe. Vous pouvez aussi mettre ce
paramètre à auto pour laisser le couple carte/pilote faire de son mieux.
Exemples :
iwconfig eth0 modu 11g
iwconfig eth0 modu CCK OFDMa
iwconfig eth0 modu auto
commit Certaines cartes peuvent ne pas appliquer immédiatement les changements effectués
par les Wireless Extensions (elles peuvent attendre pour prendre en compte les
changements ou les appliquer seulement quand la carte est montée via ifconfig).
Cette commande (si disponible) force la carte à appliquer les changements en
suspens.
Cela n'est normalement pas nécessaire, car la carte appliquera éventuellement les
changements, mais peut être utile pour débuggage.
AFFICHAGE
Pour chaque matériel qui supporte les extensions wireless, iwconfig affichera le nom du
protocole MAC utilisé (nom du matériel pour les protocoles propriétaires), l'ESSID
(Network Name), le NWID, la fréquence (ou canal), la sensibilité, le mode d'exploitation,
l'adresse du Point d'Accès, le débit, le seuil RTS (RTS threshold), le seuil de
fragmentation (fragmentation threshold), la clef de cryptage et les paramètres de gestion
de l'énergie (power management) (en fonction de la disponibilité).
Les paramètres affichés ont la même signification et la même valeur que ceux que vous
pouvez régler, veuillez vous reporter à la précédente partie pour leur explication
détaillée.
Quelques paramètres sont affichés seulement dans une forme abrégée (comme le cryptage).
Vous devez utiliser iwlist(8) pour avoir tous les détails.
Certains paramètres ont deux modes (comme le débit). Si la valeur est préfixée par « = »,
cela veut dire que le paramètre est fixé et forcé à cette valeur, s'il est préfixé par
« : », le paramètre est en mode automatique et la valeur courante est montrée (et peut
changer).
Access Point/Cell
Une adresse égale à 00:00:00:00:00:00 signifie que la carte n'a pas réussi à
s'associer avec un Point d'Accès (le plus souvent une question de configuration).
Le paramètre Access Point sera montré comme une cellule (Cell) en mode ad-hoc (pour
des raisons évidentes), mais il fonctionne néanmoins de la même manière.
Si /proc/net/wireless existe, iwconfig affichera aussi son contenu. Il faut noter que ces
valeurs dépendent des spécifications du pilote et de la carte, vous devrez donc vous
référez à la documentation du pilote pour une interprétation correcte de ces valeurs.
Link quality
Qualité globale du lien. Peut être basé sur le niveau de contention ou des
interférences, le taux d'erreur de trame ou de bit, la qualité du signal reçu,
certaines synchronisations temporelles, ou d'autre métrique matérielle. C'est une
valeur agrégat, et dépend totalement du pilote et du matériel.
Signal level
Force du signal reçu (RSSI - force du signal reçu). Ce peut être des unités
arbitraires ou des dBm, iwconfig utilise les méta-informations du pilote pour
interpréter les valeurs brutes données par /proc/net/wireless et affiche l'unité ou
la valeur maximale correspondante (en utilisant l'arithmétique 8 bits). En mode Ad-
Hoc cela peut être indéfini et vous devriez utiliser iwspy.
Noise level
Niveau du bruit de fond (quand aucun paquet n'est transmis). Commentaires
similaires à ceux de Signal level.
Rx invalid nwid
Nombre de paquets reçus avec un NWID ou ESSID différent. Utilisé pour détecter des
problèmes de configuration ou l'existence de réseau adjacent (sur la même
fréquence).
Rx invalid crypt
Nombre de paquets que le matériel a été incapable de décrypter. Cela peut être
utilisé pour détecter des mauvais paramètres de cryptage.
Rx invalid frag
Nombre de paquets pour lesquels le matériel a été incapable de ré-assembler
correctement les fragments de la couche liaison (le plus souvent, il en manque un).
Tx excessive retries
Nombre de paquets que la carte n'a pas réussi à envoyer. La plupart des protocoles
MAC réessayent un certain nombre de fois avant d'abandonner.
invalid misc
Autres paquets perdus en relation avec les opérations spécifiques au sans fil.
Missed beacon
Nombre de beacons périodiques émis par la Cellule ou le Point d'Accès que nous
avons manqué. Les beacons sont envoyés à intervalles réguliers pour maintenir la
coordination de la cellule, l'impossibilité de les recevoir indiquant souvent que
la carte est hors de portée.
AUTEUR
Jean Tourrilhes - jt@hpl.hp.com
TRADUCTION
Maxime CHARPENNE, octobre 2007 (wireless_tools.30-pre3).
AVERTISSEMENT SUR LA TRADUCTION
Il est possible que cette traduction soit imparfaite ou périmée. En cas de doute, veuillez
vous reporter au document original en langue anglaise fourni avec le programme.
FICHIERS
/proc/net/wireless
VOIR AUSSI
ifconfig(8), iwspy(8), iwlist(8), iwevent(8), iwpriv(8), wireless(7).