Manuels pour la ligne de commande

Man » Manuel ifconfig en ligne - documentation détaillée en ligne pour la page de manuel ifconfig

🌍
ifconfig - configurer une interface réseau

SYNOPSIS

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

DESCRIPTION

Ifconfig est utilisé pour configurer les interfaces réseau résidentes du noyau. Il est utilisé au démarrage pour configurer les interfaces si nécessaire. Après cela, il n'est généralement nécessaire que pour le débogage ou lorsque le réglage du système est requis.

Si aucun argument n'est donné, ifconfig affiche l'état des interfaces actuellement actives. Si un seul argument d'interface est donné, il affiche l'état de l'interface donnée uniquement ; si un seul argument -a est donné, il affiche l'état de toutes les interfaces, même celles qui sont désactivées. Sinon, il configure une interface.

Familles d'adresses

Si le premier argument après le nom de l'interface est reconnu comme le nom d'une famille d'adresses prise en charge, cette famille d'adresses est utilisée pour décoder et afficher toutes les adresses de protocole. Les familles d'adresses prises en charge incluent actuellement 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 fournis en tant que parties de la notation décimale en points IPv4 peuvent être décimaux, octaux ou hexadécimaux, comme spécifié dans la norme ISO C (c'est-à-dire qu'un préfixe 0x ou 0X implique un nombre hexadécimal ; sinon, un préfixe '0' implique un nombre octal ; sinon, le nombre est interprété comme décimal). L'utilisation de nombres hexadécimaux et octaux n'est pas conforme à la RFC et, par conséquent, son utilisation est déconseillée.

OPTIONS

-a     affiche toutes les interfaces actuellement disponibles, même si elles sont désactivées

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

-v     affiche plus d'informations pour certaines conditions d'erreur

interface

Le nom de l'interface. Il s'agit généralement d'un nom de pilote suivi d'un numéro d'unité, par exemple eth0 pour la première interface Ethernet. Si votre noyau prend en charge les interfaces alias, vous pouvez les spécifier avec une syntaxe telle que eth0:0 pour le premier alias de eth0. Vous pouvez les utiliser pour attribuer davantage d'adresses. Pour supprimer une interface alias, utilisez ifconfig eth0:0 down. Remarque : pour chaque portée (c'est-à-dire le même réseau avec une combinaison adresse/masque de sous-réseau), tous les alias sont supprimés si vous supprimez le premier (principal).

up     Ce drapeau permet d'activer l'interface. Il est implicitement spécifié si une adresse est attribuée à l'interface ; vous pouvez supprimer ce comportement lorsque vous utilisez une interface alias en ajoutant un - à l'alias (par exemple, eth0:0-). Il est également supprimé lorsque vous utilisez l'adresse IPv4 0.0.0, car le noyau l'utilisera implicitement pour supprimer les interfaces alias.

down : ce drapeau désactive le pilote de cette interface.

[-]arp : active ou désactive l’utilisation du protocole ARP sur cette interface.

[-]promisc :
Active ou désactive le mode promiscu du l’interface. Si cette option est sélectionnée, toutes les paquets du réseau seront reçus par l’interface.

[-]allmulti :
Active ou désactive le mode multicast. Si cette option est sélectionnée, tous les paquets multicast du réseau seront reçus par l’interface.

mtu N : ce paramètre définit l’unité de transmission maximale (MTU) d’une interface.

dstaddr addr :
Définit l’adresse IP distante pour une liaison point à point (tel que PPP). Ce mot-clé est désormais obsolète ; utilisez le mot-clé pointopoint.

netmask addr :
Définit le masque de réseau IP pour cette interface. Cette valeur est par défaut le masque de réseau de classe A, B ou C habituel (dérivé de l’adresse IP de l’interface), mais il peut être défini sur n’importe quelle valeur.

add addr/prefixlen :
Ajoute une adresse IPv6 à une interface.

del addr/prefixlen :
Supprime une adresse IPv6 d’une interface.

tunnel ::aa.bb.cc.dd :
Crée un nouveau périphérique SIT (IPv6-in-IPv4), en effectuant un tunneling vers la destination spécifiée.

irq addr :
Définit la ligne d’interruption utilisée par ce périphérique. Tous les périphériques ne peuvent pas modifier dynamiquement leur paramètre IRQ.

io_addr addr :
Définit l’adresse de début dans l’espace E/S pour ce périphérique.

mem_start addr :
Définit l’adresse de début pour la mémoire partagée utilisée par ce périphérique. Seuls quelques périphériques en ont besoin.

media type :
Définit le type de port physique ou de média à utiliser par le périphérique. Tous les périphériques ne peuvent pas modifier ce paramètre, et ceux qui le peuvent varient dans les valeurs qu’ils prennent en charge. Les valeurs typiques pour type sont 10base2 (Ethernet fin), 10baseT (paires torsadées Ethernet 10 Mbps), AUI (transmetteur externe), etc. Le type de média spécial auto peut être utilisé pour indiquer au pilote de détecter automatiquement le média. Encore une fois, tous les pilotes ne peuvent pas le faire.

[-]broadcast [addr] :
Si l’argument adresse est donné, définit l’adresse de diffusion du protocole pour cette interface. Sinon, définit (ou efface) le drapeau IFF\_BROADCAST pour l’interface.

[-]pointopoint [addr] :
Ce mot-clé active le mode point à point d’une interface, ce qui signifie qu’il s’agit d’une liaison directe entre deux machines, sans que personne d’autre n’écoute.
Si l’argument adresse est également donné, définit l’adresse du protocole de l’autre côté de la liaison, tout comme le fait le mot-clé obsolète dstaddr. Sinon, définit ou efface le drapeau IFF\_POINTOPOINT pour l’interface.

hw class address :
Définit l’adresse matérielle de cette interface, si le pilote du périphérique prend en charge cette opération.
Le mot-clé doit être suivi du nom de la classe matérielle et de l’équivalent ASCII imprimable de l’adresse matérielle. Les classes matérielles actuellement prises en charge incluent ether (Ethernet), ax25 (AMPR AX.25), ARCnet et netrom (AMPR NET/ROM).

multicast :
Définit le drapeau multicast sur l’interface. Cela ne devrait pas être nécessaire en général, car les pilotes définissent correctement le drapeau.

address :
L’adresse IP à attribuer à cette interface.

txqueuelen length

Définit la longueur de la file d'attente de transmission du périphérique. Il est utile de définir cette valeur à des valeurs faibles pour les périphériques plus lents avec une latence élevée (liaisons modem, RNIS) afin d'éviter que les transferts en masse rapides ne perturbent trop le trafic interactif tel que telnet.

name newname

Modifie le nom de cette interface en newname. L'interface doit d'abord être désactivée.

NOTES

Depuis la version 2.2 du noyau, il n'existe plus de statistiques d'interface explicites pour les interfaces alias. Les statistiques affichées pour l'adresse d'origine sont partagées avec toutes les adresses alias sur le même périphérique. Si vous souhaitez des statistiques par adresse, vous devez ajouter des règles de comptabilité explicites pour l'adresse à l'aide de la commande iptables(8).

Depuis net-tools 1.60-4, ifconfig affiche des compteurs d'octets et des compteurs lisibles par l'homme avec des unités IEC 600272. Ainsi, 1 KiB équivaut à 2^10 octets. Notez que les nombres sont tronqués à une décimale (ce qui peut être une erreur assez importante si l'on considère que 0,1 PiB équivaut à 112 589 990 684 262 octets !).

Les problèmes d'interruption avec les pilotes de périphérique Ethernet échouent avec EAGAIN (SIOCSIIFLAGS : ressource temporairement indisponible). Il s'agit très probablement d'un conflit d'interruption. Consultez http://www.scyld.com/expert/irq-conflict.html pour plus d'informations.

FICHIERS

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

BUGS

Ifconfig utilise la méthode d'accès ioctl pour obtenir toutes les informations d'adresse, ce qui limite les adresses matérielles à 8 octets. Étant donné qu'une adresse matérielle Infiniband comporte 20 octets, seuls les 8 premiers octets sont affichés correctement. Veuillez utiliser la commande ip link du paquet iproute2 pour afficher les informations de couche de liaison, y compris l'adresse matérielle.

Bien que les adresses Appletalk DDP et IPX soient 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) http://physics.nist.gov/cuu/Units/binary.html - Préfixes pour les multiples binaires

AUTEURS

Fred N. van Kempen, <_> Alan Cox, <_> Phil Blundell, <_> Andi Kleen Bernd Eckenfels, <_>