Provided by: wireless-tools_30~pre9-5ubuntu2_i386 bug

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).