Ubuntu Manpage: iwconfig - configure une interface réseau sans-fil (wireless)

Provided by: wireless-tools_30~pre9-3ubuntu4_i386

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

Ubuntu manuals

NOM