====== iwconf ======

  * Objet : iwconfig
  * Niveau requis : {{tag>débutant}}
  * Commentaires : //Outil spécifique à utiliser avec le wifi. //
  * Débutant, à savoir : [[:doc:systeme:commandes:le_debianiste_qui_papillonne|Utiliser GNU/Linux en ligne de commande, tout commence là !.]] :-)
  * Suivi : {{tag>à-compléter}}
    * Création par [[user>smolski]] 11/12/2016
    * Testé par <...> le <...> FIXME
  * Commentaires sur le forum : [[https://debian-facile.org/viewtopic.php?id=16169 | Lien vers le forum concernant ce tuto]] ((N'hésitez pas à y faire part de vos remarques, succès, améliorations ou échecs !))

===== Introduction =====

La commande iwconfig est le principal outil de manipulation des paramètres d'une interface de réseau sans fil. \\
Son mode de fonctionnement est calqué sur celui de la [[:doc:reseau:ifconfig]] qui est utilisée pour le paramétrage au niveau réseau avec le protocole IP.


===== Installation =====

Nous avons besoin d'installer [[:doc:reseau:wireless-tools|wireless-tools]] et wpa_supplicant. \\
Pour ce faire :
<code root>apt-get update && apt-get install wpasupplicant wireless-tools </code>
Il est à noter que **wpasupplicant** n'est nécessaire que pour l'utilisation d'un cryptage **WPA**, ce qui doit être le cas si votre réseau est réellement sécurisé…

===== Utilisation =====

Voici trois exemples d'exécution de la commande sans spécification de paramètre. \\
Comme dans le cas de la commande //ifconfig//, l'exécution de la commande //iwconfig// affiche l'ensemble des valeurs courantes des options de l'interface.

Résultats obtenu en terminal user avec une interface IEEE 802.11b.
<code user>
/sbin/iwconfig wlan0</code>
<file config retour de commande>
wlan0     IEEE 802.11-DS  ESSID:"wlan.lab" 1
          Mode:Managed2  Frequency:2.442 GHz3  Access Point: 00:0E:83:88:E8:D44
          Bit Rate:11 Mb/s   Tx-Power=20 dBm   Sensitivity=0/65535
          Retry limit:16   RTS thr:off   Fragment thr:off
          Power Management:off
          Link Quality=100/100  Signal level=-34 dBm  Noise level=-90 dBm
          Rx invalid nwid:9418  Rx invalid crypt:0  Rx invalid frag:0
          Tx excessive retries:0  Invalid misc:54513   Missed beacon:0</file>

Résultats obtenu en terminal user avec une interface IEEE 802.11g.
<code user>
/sbin/iwconfig wlan0</code>
<file config retour de la commande>
wlan0     IEEE 802.11g  ESSID:"ma-Box" 1
          Mode:Managed2  Frequency:2.412 GHz3  Access Point: 00:0F:66:DC:3D:314
          Bit Rate:54 Mb/s   Tx-Power=20 dBm   Sensitivity=8/0
          Retry limit:7   RTS thr:off   Fragment thr:off
          Encryption key:<snipped/>   Security mode:open
          Power Management:off
          Link Quality=99/100  Signal level=-23 dBm  Noise level=-88 dBm
          Rx invalid nwid:0  Rx invalid crypt:4  Rx invalid frag:0
          Tx excessive retries:0  Invalid misc:0   Missed beacon:0</file>

Résultats obtenu avec une interface non associée :
<code user>
/sbin/iwconfig wlan0</code>
<file config retour de la commande>
wlan0     unassociated  ESSID:off/any 1
          Mode:Managed2  Channel=03  Access Point: Not-Associated4
          Bit Rate:0 kb/s   Tx-Power=20 dBm   Sensitivity=8/0
          Retry limit:7   RTS thr:off   Fragment thr:off
          Encryption key:off
          Power Management:off
          Link Quality:0  Signal level:0  Noise level:0
          Rx invalid nwid:0  Rx invalid crypt:4  Rx invalid frag:0
          Tx excessive retries:0  Invalid misc:12   Missed beacon:0</file>

==== Remarque ====

Informations sur le type de réseau sans-fil et l'identification du service.

La chaîne IEEE 802.11-DS désigne un réseau de type IEEE 802.11b alors que la chaîne IEEE 802.11g désigne directement le type de réseau. \\
L'acronyme ''ESSID'' signifie //Extended Service Set Identifier//. \\
La chaîne de 32 caractères maximum correspondante identifie le domaine réseau auquel appartient l'interface.

==== Option essid ====

L'option essid de la commande iwconfig sert à configurer le nom de réseau. C'est la première option à paramétrer lors de l'implantation d'une station dans un nouveau réseau. La syntaxe est du type :
<code root>
iwconfig wlan<i> essid "<ma-Box>"</code>

==== Option mode ====

Informations sur le type d'infrastructure du réseau sans fil. \\
Cette option mode peut prendre plusieurs valeurs.

<note>Pour plus d'information sur les valeurs de l'option mode, consulter  [[:doc:systeme:man | les pages man]] :<code user>man iwconfig</code></note>

Dans le contexte de ce document, on ne s'intéresse qu'aux trois valeurs suivantes :

=== mode Ad-Hoc ===

Dans ce mode, l'interface s'associe directement aux autres stations sans utiliser un point d'accès. \\ C'est le mode à utiliser lorsque l'on souhaite communiquer d'un hôte à l'autre sans information sur la présence d'une infrastructure.

=== mode Managed ===

Dans ce mode, l'interface s'associe à une infrastructure réseau comprenant un ou plusieurs point d'accès et peut gérer les déplacements entre zones de couverture radio (roaming).

=== mode Monitor ===

Dans ce mode, l'interface est placée en mode moniteur passif et collecte l'ensemble des trames présentes dans sa zone de couverture radio. \\
C'est dans ce mode que l'on peut capturer et analyser les trames de gestion et de contrôle du réseau sans fil.

La syntaxe d'utilisation de cette option est du type :
<code root>
iwconfig wlan<i> mode managed</code>

===== Lien utile =====

  * [[doc:reseau:wireless-tools | Wireless-tools - Les outils pour le wifi]]