IWCONFIG(8) Manuel du programmeur Linux IWCONFIG(8) 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. PARAMETRES 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 frequence (ou canal), la sensibilite, le mode d'exploitation, l'adresse du Point d'Acces, le debit, 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). wireless-tools 30 mars 2006 IWCONFIG(8)