IFCONFIG(8)

NOM
ifconfig – Configurer une interface réseau.

SYNOPSIS
ifconfig [-v] [-a] [-s] [interface]
ifconfig [-v] interface [type_famille_adresse] options | adresse ...

DESCRIPTION
ifconfig permet de configurer les interfaces réseau présentes dans le noyau. Il est utilisé pour les configurer au démarrage selon les besoins. Ensuite, il est utilisé généralement pour le débogage ou pour d'éventuels réglages du système.

Si aucun argument n'est donné, ifconfig affiche l'état des interfaces actives. Si seul le paramètre interface est donné, il affiche seulement l'état de l'interface correspondante ; si seul le paramètre -a est fourni, il affiche l'état de toutes les interfaces, même celles qui sont inactives. Autrement, il configure une interface.

Familles d'adresses
Si le premier argument après le nom d'interface est reconnu comme le nom d'une famille d'adresses prise en charge, alors cette famille d'adresses est utilisée pour décoder et afficher toutes les adresses du protocole. Les familles d'adresses actuellement prises en charge comprennent inet (TCP/IP, par défaut), inet6 (IPv6), ax25 (AMPR Packet Radio), ddp (Appletalk Phase 2), ipx (Novell IPX) et netrom (AMPR Packet Radio). Tous les nombres comme éléments de la notation décimale pointée d'IPV4 peuvent être décimaux, octaux ou hexadécimaux, conformément à la norme ISO C (c'est-à-dire qu'un « 0x » ou un « 0X » au début indique un nombre hexadécimal, un « O » un octal et autrement, le nombre est interprété comme un nombre décimal). L'utilisation de nombres hexadécimaux et octaux n'est pas conforme à la RFC et est donc déconseillée.

OPTIONS

-a  Afficher toutes les interfaces actuellement disponibles, même celles qui sont inactives.

-s  Afficher une liste courte (comme netstat -i)

-v  Mode volubile pour certaines conditions d'erreur

interface
    Correspond au nom de l'interface de réseau. C'est généralement un nom de pilote suivi d'un numéro d'unité, comme eth0 pour la première interface Ethernet. Si votre noyau accepte les alias d'interfaces, vous pouvez les spécifier avec eth0:0 pour le premier alias de eth0. Il est possible de les utiliser pour les affecter à davantage d'adresses. Pour supprimer un alias d'interface, utilisez ifconfig eth0:0 down. Note : pour chaque groupe (un même nœud donné par une combinaison adresse/masque de réseau), tous les alias sont supprimés si le premier alias (le principal) est supprimé.

up  Cet indicateur active l'interface donnée. Cette option est spécifiée de façon implicite si une adresse est affectée à l'interface ; vous pouvez éviter ce comportement lors de l'utilisation d'un alias d'interface en ajoutant un - à l'alias (par exemple, eth0:0-). Il est aussi supprimé lors de l'utilisation de l'adresse IPv4 0.0.0.0, car le noyau l'utilisera pour supprimer implicitement les alias d'interface.

down
    Cet indicateur désactive le pilote pour l'interface donnée.

[-]arp
    Activer ou désactiver l'utilisation du protocole ARP sur une interface.

[-]promisc
    Activer ou désactiver le mode promiscuous. S'il est activé, tous les paquets circulant sur le réseau seront reçus par l'interface.

[-]allmulti
    Activer ou désactiver le mode all-multicast. S'il est activé, l'interface recevra tous les paquets de multidiffusion circulant sur le réseau.

mtu N
    Ce paramètre définit la taille maximum de l'unité de transfert ou MTU (« Maximum Transfer Unit ») d'une interface.

dstaddr adresse
    Définir l'adresse IP distante dans le cas d'un lien point-à-point (comme PPP). Cette option est obsolète ; utilisez à la place l'option pointopoint.

netmask adresse
    Définir le masque de réseau IP pour cette interface. La valeur par défaut correspond au masque de réseau habituel pour les classes A, B ou C (déduite de l'adresse IP), mais une autre valeur peut être définie.

add adresse/longueur_préfixe
    Ajouter une adresse IPv6 à une interface.

del adresse/longueur_préfixe
    Supprimer une adresse IPv6 d'une interface.

tunnel ::aa.bb.cc.dd
    Créer un nouveau périphérique SIT (IPv6-dans-IPv4), fonctionnant en mode tunnel jusqu'à la destination donnée.

irq adresse
    Définir la ligne d'interruption utilisée par un périphérique. Certains périphériques ne sont pas capables de changer dynamiquement d'IRQ.

io_addr adresse
    Définir l'adresse de début dans l'espace d'entrée-sortie pour ce périphérique.

mem_start adresse
    Définir l'adresse de début de la mémoire partagée utilisée par un périphérique. Peu de périphériques ont besoin de ce paramètre.

media type
    Définir le port physique ou le type de médium utilisé par le périphérique. Tous les périphériques ne peuvent pas changer cette configuration et les types acceptés varient de l'un à l'autre. Les valeurs habituelles du type sont 10base2 (Ethernet fin), 10baseT (Ethernet 10Mbps en paire torsadée), AUI (émetteur-récepteur externe), etc. Le médium spécial de type auto permet d'indiquer au pilote de détecter automatiquement le médium utilisé. Une fois de plus, tous les pilotes n'acceptent pas cette option.

[-]broadcast [adresse]
    Si l'adresse est donnée, elle définit l'adresse de diffusion du protocole pour cette interface. Autrement, cela définit (ou supprime) l'indicateur IFF_BROADCAST de l'interface.

[-]pointopoint [adresse]
    Ce mot-clé active le mode point-à-point d'une interface, signifiant qu'il existe un lien direct entre 2 machines, sans que personne d'autre ne puisse être à l'écoute.
    Si l'adresse est également donnée, cela définit l'adresse de protocole de l'autre machine, de la même manière que le mot-clé obsolète dstaddr. Autrement, il définit (ou supprime) l'indicateur IFF_POINTOPOINT de l'interface.

hw classe adresse
    Définir l'adresse matérielle de l'interface, si le pilote du périphérique accepte cette opération. Le mot clé doit être suivie du nom de la classe matérielle et de l'adresse matérielle en caractères ASCII affichables. Les classes matérielles actuellement prises en charge comprennent ether (Ethernet), ax25 (AMPR AX.25), ARCnet et netrom (AMPR NET/ROM).

multicast
    Positionner l'indicateur de multidiffusion sur l'interface. Ce n'est généralement pas nécessaire puisque les pilotes positionnent correctement l'option eux-mêmes.

adresse
    L'adresse IP affectée à cette interface.

txqueuelen longueur
    Définir la longueur de la file d'attente de transmission du périphérique. Il est utile de la fixer à des valeurs faibles pour les périphériques lents avec un temps d'attente important (modems, ISDN), pour empêcher d'être perturbé par de rapides transferts de masse issus des trafics interactifs, comme telnet.

name nouveau_nom
    Changer le nom de cette interface à nouveau_nom. Il faut préalablement éteindre l'interface.

NOTES
Depuis la version 2.2 du noyau, il n'y a plus de statistiques d'interface explicites pour les alias d'interfaces. Les statistiques affichées pour la véritable adresse sont partagées avec toutes les adresses d'alias du même périphérique. Pour avoir des statistiques par adresse, il faut ajouter des règles de comptabilité explicites pour l'adresse en utilisant la commande iptables(8).

Depuis net-tools 1.60-4, ifconfig affiche les compteurs d'octets et ceux lisibles par un utilisateur en unités IEC 60027-2. Ainsi, 1 KiB vaut 2^10 octets. Notez que les nombres sont tronqués à la première décimale (ce qui peut être une erreur importante si vous considérez que 0,1 PiB vaut 112.589.990.684.262 octets :)

Des problèmes d'interruption avec les pilotes de périphériques Ethernet apparaissent avec EAGAIN (SIOCSIIFLAGS : Ressource temporairement indisponible) ; il s'agit sûrement d'un conflit d'interruptions. Voir http://www.scyld.com/expert/irq-conflict.html pour plus d'informations.

FICHIERS
/proc/net/dev
/proc/net/if_inet6

BOGUES
ifconfig utilise la méthode d'accès ioctl pour obtenir les informations complètes sur les adresses, ce qui limite les adresses matérielles à 8 octets. Comme les adresses matérielles Infiniband ont composées de 20 octets, seuls les 8 premiers sont affichés correctement. Veuillez utiliser la commande ip link du paquet iproute2 pour afficher les informations sur la couche liaison y compris les adresses matérielles.

Même si les adresses AppleTalk DDP et IPX sont affichées, elles ne peuvent pas être modifiées par cette commande.

VOIR AUSSI
route(8), netstat(8), arp(8), rarp(8), iptables(8), ifup(8), interfaces(5)
https://physics.nist.gov/cuu/Units/binary.html – Préfixes pour les multiples binaires.

AUTEURS
Fred N. van Kempen, <waltje@uwalt.nl.mugnet.org>
Alan Cox, <Alan.Cox@linux.org>
Phil Blundell, <Philip.Blundell@pobox.com>
Andi Kleen
Bernd Eckenfels, <net-tools@lina.inka.de>

TRADUCTION
La traduction française de cette page de manuel a été créée par Jean Michel VANSTEENE <vanstee@worldnet.fr>, Guillaume Audirac et Jean-Pierre Giraud <jean-pierregiraud@neuf.fr>

Cette traduction est une documentation libre ; veuillez vous reporter à la GNU General Public License version 3 (https://www.gnu.org/licenses/gpl-3.0.html) concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.

Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message à debian-l10n-french@lists.debian.org.