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 noeuds 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 noeud se connecte à un réseau
composé de plusieurs Points d'Accès, avec roaming ou errance),
Master (le noeud est le maître qui synchronise ou agit comme
un Point d'Accès), Repeater (le noeud transmet les paquets
entre les autres noeuds wireless), Secondary (le noeud agit comme
un maître/répéteur supplémentaire), Monitor (le
noeud 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 noeuds
cachés ou d'un grand nombre de noeuds actifs. Ce paramètre fixe
la taille du plus petit paquet pour lequel le noeud 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).