Provided by:
wireless-tools_30~pre9-5ubuntu1_i386 
NOM
iwconfig - configure une interface reseau 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 a ifconfig(8), mais est dedie aux interfaces
wireless. Il est utilise pour positionner les parametres des interfaces
reseaux qui sont specifiques aux operations wireless (par exemple : la
frequence). Iwconfig peut aussi etre utilise pour afficher ces
parametres, et les statistiques concernant le sans fil (extraites de
/proc/net/wireless).
Tous ces parametres et statistiques dependent du materiel. Chaque
pilote ne fournira que quelques uns d'entre eux en fonction du support
materiel, et l'etendue des valeurs peut changer. Veuillez vous referer
aux pages man de chaque materiel pour plus de details.
PARAM`ETRES
essid Positionne le ESSID (ou Network Name - pour certains produits,
il peut aussi etre designe comme Domain ID). L'ESSID est utilise
pour identifier les cellules qui font partie du meme reseau
virtuel.
Par opposition a l'adresse de l'AP (Point d'Acces) ou au NWID
qui definissent une seule cellule, l'ESSID definit un groupe de
cellules connectees via des repeteurs ou via l'infrastructure,
ou l'utilisateur peut errer (<< roamer >>) de maniere
transprente (c.-a-d. changer de noeud sans perdre sa connexion).
Avec certaines cartes, vous pouvez desactiver le controle du
ESSID (<< ESSID promiscuous >>) avec off ou any (et on pour le
reactiver).
Si le ESSID du reseau est un des mots-clefs speciaux (off, on ou
any), vous devrez utiliser -- pour l'echapper.
Exemples :
iwconfig eth0 essid any
iwconfig eth0 essid "Mon Reseau"
iwconfig eth0 essid -- "ANY"
nwid Positionne le Network ID. Comme tous les reseaux sans fil
adjacents partagent le meme medium, ce parametre est utilise
pour les differencier (creer des reseaux logiques colocalises)
et pour identifier des noeuds appartenant a la meme cellule.
Ce parametre est seulement utilise par les materiels anterieurs
a 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 desactiver le controle du
Network ID (NWID promiscuous) avec off (et on pour le
reactiver).
Exemples :
iwconfig eth0 nwid AB34
iwconfig eth0 nwid off
nick[name]
Positionne le surnom (nickname), ou nom de station. Quelques
produits 802.11 le definissent, mais il n'est pas utilise dans
la mesure ou les protocoles les plus usites (MAC, IP, TCP) ne
s'en servent pas en l'etat. Seuls quelques outils de diagnostic
peuvent l'utiliser.
Exemple :
iwconfig eth0 nickname "My Linux Node"
mode Positionne le mode de fonctionnement du materiel, qui depend de
la topologie du reseau. Le mode peut etre Ad-Hoc (reseau compose
d'une seule cellule et sans Point d'Acces), Managed (un noeud se
connecte a un reseau compose de plusieurs Points d'Acces, avec
roaming ou errance), Master (le noeud est le maitre qui
synchronise ou agit comme un Point d'Acces), Repeater (le noeud
transmet les paquets entre les autres noeuds wireless),
Secondary (le noeud agit comme un maitre/repeteur
supplementaire), 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 frequence d'exploitation ou canal du peripherique.
Une valeur inferieure a 1 000 indique un numero de canal, une
valeur superieure a 1 000 est une frequence en Hz. Vous pouvez
ajouter le suffixe k, M ou G a la valeur (par exemple,
<< 2.46G >> pour la frequence 2,46 GHz), ou ajouter suffisamment
de '0'.
Les canaux sont habituellement numerotes a partir de 1, et vous
pouvez utiliser iwlist(8) pour obtenir le nombre total de
canaux, lister les frequences disponibles, et afficher la
frequence courante comme un canal. Suivants les reglementations,
certaines frequences/canaux peuvent ne pas etre disponibles.
La plupart du temps lorsque le mode Managed est utilise, le
Point d'Acces impose le canal et le pilote refusera le parametre
de la frequence. Dans le mode Ad-Hoc, le parametre frequence
doit seulement etre utilise a la creation de la cellule
initiale, et doit etre ignore quand on rejoint une cellule
existante.
Vous pouvez aussi utiliser off ou auto pour laisser la carte
choisir le meilleur canal (lorsque c'est supporte).
Exemples :
iwconfig eth0 freq 2422000000
iwconfig eth0 freq 2.422G
iwconfig eth0 channel 3
iwconfig eth0 channel auto
ap Force la carte a s'enregistrer aupres du Point d'Acces donne par
l'adresse, si c'est possible. Cette adresse est l'identite de la
cellule du Point d'Acces, celle indique par un scanning
wireless, qui peut etre differente de son adresse MAC. Si le
lien wireless est point-a-point, mettre l'adresse de l'autre
cote du lien. Si le lien est ad-hoc, mettre l'identite de la
cellule du reseau ad-hoc.
Quand la qualite de la connexion devient trop mauvaise, le
pilote peut revenir en mode automatique (la carte selectionne le
meilleur Point d'Acces a portee).
Vous pouvez aussi utiliser off pour reactiver le mode
automatique sans changer le Point d'Acces courant, ou vous
pouvez utiliser any ou auto pour forcer la carte a se
re-associer avec le meilleur Point d'Acces 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 debits, positionne le debit
en b/s. Le debit est la vitesse a laquelle les bits sont
transmis sur le medium, la vitesse du lien pour l'utilisateur
est inferieure a cause du partage du medium et des diverses
entetes.
Vous pouvez ajouter le suffixe k, M ou G a la valeur
(multiplicateur decimal : 10^3, 10^6 et 10^9 b/s), ou ajouter
suffisamment de '0'. Les valeurs en-dessous de 1 000 sont
specifiques a la carte, habituellement un index de la liste des
debit supportes. Utilisez auto pour selectionner le mode debit
automatique (repli a un debit moindre pour les canaux bruites),
ce qui est le mode par defaut pour la plupart des cartes, et
fixed pour revenir a des parametres fixes. Si vous specifiez une
valeur de debit et ajoutez auto, le driver utilisera tous les
debits inferieurs et egaux a 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,
regle 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-fixee par mW, elle sera automatiquement
convertie en dBm.
De plus, on et off active et desactive la radio, et auto et
fixed active et desactive le controle 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 sensibilite. Cela definie comment la
carte est sensible aux mauvaises conditions de fonctionnement
(signal faible, interference). Les valeurs positives sont
considerees comme des valeurs brutes et utilisees telles quelles
par le materiel ou un pourcentage, les valeurs negatives sont
interpretees en dBm. En fonction de la conception du matetiel,
ce parametre peut controler diverses fonctions.
Sur les cartes modernes, ce parametre controle habituellement le
seuil du handover/roaming (seuil de cession), signal le plus bas
pour lequel le materiel reste associe au Point d'Acces courant.
Lorsque le signal passe en-dessous de ce seuil, la carte
commence a chercher un nouveau/meilleur Point d'Acces.
Certaines cartes peuvent utiliser le nombre de beacons manquees
pour declencher cela. En cas de forte densite de Points d'Acces,
un seuil plus haut assure d'etre toujours associe au meilleur
AP, et a l'inverse pour les faibles densites d'APs, un seuil
plus bas reduit les pertes d'associations.
Sur les cartes plus anciennes, ce parametre controle
habituellement le seuil de report (defer treshold), signal le
plus faible pour lequel le materiel considere le canal occupe.
Les niveaux de signal au-dessus de ce seuil font que le materiel
inhibe sa propre transmission, tandis que les signaux plus
faibles que ce seuil sont ignores et le materiel est libre de
transmettre. Cela est souvent fortement lie au seuil de
reception, le plus bas niveau de signal pour lequel le materiel
essaye de recevoir un paquet. Des parametres apropriees pour ces
seuils evitent a la carte de perdre du temps sur le bruit de
fond lors des receptions de transmissions faibles. Les
conceptions modernes semblent controler ces seuils
automatiquement.
Exemple :
iwconfig eth0 sens -80
iwconfig eth0 sens 2
retry La plupart des cartes supportent les retransmissions MAC
(controle d'acces au medium), et certaines permettent le
parametrage du mecanisme des tentatives (en cas d'echec).
Pour fixer le nombre maximum d'essais, entrez limit `valeur'.
C'est une valeur absolue (sans unite), et c'est le cas par
defaut (si rien n'est specifie). Pour fixer le temps maximum
autorise au mecanisme MAC pour ses tentatives, entrez lifetime
`valeur'. Par defaut, cette valeur est en secondes, ajouter le
suffixe m ou u pour specifier 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 definissent
les limites inferieure et superieure (NDT : de l'intervalle
temporel dans lequel le mecanisme MAC est autorise a reiterer
ses tentatives). D'autres cartes definissent des valeurs
differentes en fonction de la taille des paquets, par exemple la
norme 802.11 definit une min limit qui est la limite inferieure
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 << poignee de main >> avant chaque
transmission de paquet pour etre sur que le canal est libre.
Cela ajoute des entetes (NDT : donnees de gestion), mais
augmente les performances en cas de noeuds caches ou d'un grand
nombre de noeuds actifs. Ce parametre fixe la taille du plus
petit paquet pour lequel le noeud envoie un RTS ; une valeur
egale a la taille maximale des paquets inhibe ce mecanisme. Vous
pouvez aussi positionner ce parametre sur auto, fixed ou off.
Exemples :
iwconfig eth0 rts 250
iwconfig eth0 rts off
frag[mentation_threshold]
La fragmentation permet de decouper un paquet IP en une salve de
plus petits fragments transmis sur le medium. Dans la plupart
des cas, cela ajoute des entetes, mais dans un environnement
tres bruite, cela reduit les couts de transmission dus aux
erreurs et permet aux paquets d'etre achemines malgre des salves
d'interferences. Ce parametre fixe la taille de fragment
maximale qui est toujours inferieure a la taille maximale des
paquets.
Ce parametre peut aussi controler le << Frame Bursting >>
disponible sur certaines cartes, capacite a envoyer de multiple
paquets IP ensembles. Ce mecanisme sera active si la taille de
fragment est plus grande que la taille maximale de paquet.
Vous pouvez aussi mettre ce parametre a auto, fixed ou off.
Exemples :
iwconfig eth0 frag 512
iwconfig eth0 frag off
key/enc[ryption]
Utilise pour manipuler les clefs de cryptage ou brouillage et le
mode de securite.
Pour configurer la clef courante de cryptage, il suffit d'entrer
la clef en hexadecimal telle que XXXX-XXXX-XXXX-XXXX ou
XXXXXXXX. Pour entrer une autre clef que la clef courante,
ajoutez (au debut ou a la fin) [index] a la clef elle-meme (cela
ne changera pas la clef active). Vous pouvez aussi entrer la
clef comme une chaine ASCII en utilisant le prefixe s:. Les
phrases en tant que mot de passe ne sont actuellement pas
supportees.
Pour changer la clef active parmi les clefs deja entrees, il
suffit d'entrer l'[index] (sans entrer de valeur de clef).
off et on desactive et reactive le cryptage.
Le mode de securite peut etre open ou restricted, et sa
signification depend de la carte utilisee. Avec la plupart des
cartes, le mode open n'utilise pas d'authentification et la
carte accepte des sessions non cryptees, alors que le mode
restricted n'accepte que des sessions cryptees 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
etre 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 Utilise pour manipuler les parametres et le mode du procede de
gestion d'energie.
Pour fixer la periode entre les eveils, entrez period `valeur'.
Pour fixer la temporisation avant le retour en veille, entrez la
timeout `valeur'. Pour parametrer le niveau generique de
sauvegarde d'energie, entrez saving `valeur'. Vous pouvez aussi
ajouter les modificateurs min et max. Par defaut, ces valeurs
sont exprimees en secondes, ajoutez le suffixe m ou u pour
specifier les valeurs en millisecondes ou microsecondes.
Parfois, ces valeurs sont sans unite (nombre de periodes de
beacon, dwell, pourcentage ou similaire).
off et on desactive et reactive la gestion d'energie. Enfin,
vous pouvez mettre la gestion d'energie en mode all (recoit tous
les paquets), unicast (recoit seulement les paquets unicast,
ignore les paquets multicast et de broadcast) et multicast
(recoit 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 a utiliser un jeu specifique de modulations. Les
cartes modernes supportent diverses modulations, certaines etant
standards telles 802.11b ou 802.11g, d'autres etant
proprietaires. Cette commande force la carte a utiliser
seulement le jeu specifique de modulations liste par la ligne de
commande. Ceci peut etre utilise pour resoudre des problemes
d'interoperabilite.
La liste des modulations disponibles depend du couple
carte/pilote et peut etre affichee en utilisant iwlist
modulation. Notez que certains couples carte/pilote peuvent ne
pas etre capables de selectionner chaque modulation listee
indepandement, certaines intervenant comme un groupe. Vous
pouvez aussi mettre ce parametre a 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 immediatement les
changements effectues par les Wireless Extensions (elles peuvent
attendre pour prendre en compte les changements ou les appliquer
seulement quand la carte est montee via ifconfig). Cette
commande (si disponible) force la carte a appliquer les
changements en suspens.
Cela n'est normalement pas necessaire, car la carte appliquera
eventuellement les changements, mais peut etre utile pour
debuggage.
AFFICHAGE
Pour chaque materiel qui supporte les extensions wireless, iwconfig
affichera le nom du protocole MAC utilise (nom du materiel pour les
protocoles proprietaires), l'ESSID (Network Name), le NWID, la
fr'equence (ou canal), la sensibilit'e, le mode d'exploitation, l'adresse
du Point d'Acc`es, le d'ebit, le seuil RTS (RTS threshold), le seuil de
fragmentation (fragmentation threshold), la clef de cryptage et les
parametres de gestion de l''energie (power management) (en fonction de
la disponibilite).
Les parametres affiches ont la meme signification et la meme valeur que
ceux que vous pouvez regler, veuillez vous reporter a la precedente
partie pour leur explication detaillee.
Quelques parametres sont affiches seulement dans une forme abregee
(comme le cryptage). Vous devez utiliser iwlist(8) pour avoir tous les
details.
Certains parametres ont deux modes (comme le debit). Si la valeur est
prefixee par << = >>, cela veut dire que le parametre est fixe et force
a cette valeur, s'il est prefixe par << : >>, le parametre est en mode
automatique et la valeur courante est montree (et peut changer).
Access Point/Cell
Une adresse egale a 00:00:00:00:00:00 signifie que la carte n'a
pas reussi a s'associer avec un Point d'Acces (le plus souvent
une question de configuration). Le parametre Access Point sera
montre comme une cellule (Cell) en mode ad-hoc (pour des raisons
evidentes), mais il fonctionne neanmoins de la meme maniere.
Si /proc/net/wireless existe, iwconfig affichera aussi son contenu. Il
faut noter que ces valeurs dependent des specifications du pilote et de
la carte, vous devrez donc vous referez a la documentation du pilote
pour une interpretation correcte de ces valeurs.
Link quality
Qualite globale du lien. Peut etre base sur le niveau de
contention ou des interferences, le taux d'erreur de trame ou de
bit, la qualite du signal recu, certaines synchronisations
temporelles, ou d'autre metrique materielle. C'est une valeur
agregat, et depend totalement du pilote et du materiel.
Signal level
Force du signal recu (RSSI - force du signal recu). Ce peut etre
des unites arbitraires ou des dBm, iwconfig utilise les meta-
informations du pilote pour interpreter les valeurs brutes
donnees par /proc/net/wireless et affiche l'unite ou la valeur
maximale correspondante (en utilisant l'arithmetique 8 bits). En
mode Ad-Hoc cela peut etre indefini et vous devriez utiliser
iwspy.
Noise level
Niveau du bruit de fond (quand aucun paquet n'est transmis).
Commentaires similaires a ceux de Signal level.
Rx invalid nwid
Nombre de paquets recus avec un NWID ou ESSID different. Utilise
pour detecter des problemes de configuration ou l'existence de
reseau adjacent (sur la meme frequence).
Rx invalid crypt
Nombre de paquets que le materiel a ete incapable de decrypter.
Cela peut etre utilise pour detecter des mauvais parametres de
cryptage.
Rx invalid frag
Nombre de paquets pour lesquels le materiel a ete incapable de
re-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 reussi a envoyer. La
plupart des protocoles MAC reessayent un certain nombre de fois
avant d'abandonner.
invalid misc
Autres paquets perdus en relation avec les operations
specifiques au sans fil.
Missed beacon
Nombre de beacons periodiques emis par la Cellule ou le Point
d'Acces que nous avons manque. Les beacons sont envoyes a
intervalles reguliers pour maintenir la coordination de la
cellule, l'impossibilite de les recevoir indiquant souvent que
la carte est hors de portee.
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 perimee. 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).