IFCONFIG(8) Manuel de l'administrateur systeme de Linux IFCONFIG(8) NOM ifconfig - Configurer une interface reseau. SYNOPSIS ifconfig [-v] [-a] [-s] [interface] ifconfig [-v] interface [type_famille_adresse] options | adresse ... DESCRIPTION ifconfig permet de configurer les interfaces reseau presentes dans le noyau. Il est utilise pour les configurer au demarrage selon les besoins. Ensuite, il est utilise generalement pour le debogage ou pour d'eventuels reglages du systeme. Si aucun argument n'est donne, ifconfig affiche l'etat des interfaces actives. Si seul le parametre interface est donne, il affiche seulement l'etat de l'interface correspondante ; si seul le parametre -a est fourni, il affiche l'etat de toutes les interfaces, meme celles qui sont inactives. Autrement, il configure une interface. Familles d'adresses Si le premier argument apres le nom d'interface est reconnu comme le nom d'une famille d'adresses prise en charge, alors cette famille d'adresses est utilisee pour decoder et afficher toutes les adresses du protocole. Les familles d'adresses actuellement prises en charge comprennent inet (TCP/IP, par defaut), inet6 (IPv6), ax25 (AMPR Packet Radio), ddp (Appletalk Phase 2), ipx (Novell IPX) et netrom (AMPR Packet Radio). Tous les nombres comme elements de la notation decimale pointee d'IPV4 peuvent etre decimaux, octaux ou hexadecimaux, conformement a la norme ISO C (c'est-a-dire qu'un << 0x >> ou un << 0X >> au debut indique un nombre hexadecimal, un << O >> un octal et autrement, le nombre est interprete comme un nombre decimal). L'utilisation de nombres hexadecimaux et octaux n'est pas conforme a la RFC et est donc deconseillee. OPTIONS -a Afficher toutes les interfaces actuellement disponibles, meme 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 reseau. C'est generalement un nom de pilote suivi d'un numero d'unite, comme eth0 pour la premiere interface Ethernet. Si votre noyau accepte les alias d'interfaces, vous pouvez les specifier avec eth0:0 pour le premier alias de eth0. Il est possible de les utiliser pour les affecter a davantage d'adresses. Pour supprimer un alias d'interface, utilisez ifconfig eth0:0 down. Note : pour chaque groupe (un meme noeud donne par une combinaison adresse/masque de reseau), tous les alias sont supprimes si le premier alias (le principal) est supprime. up Cet indicateur active l'interface donnee. Cette option est specifiee de facon implicite si une adresse est affectee a l'interface ; vous pouvez eviter ce comportement lors de l'utilisation d'un alias d'interface en ajoutant un - a l'alias (par exemple, eth0:0-). Il est aussi supprime 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 desactive le pilote pour l'interface donnee. [-]arp Activer ou desactiver l'utilisation du protocole ARP sur une interface. [-]promisc Activer ou desactiver le mode promiscuous. S'il est active, tous les paquets circulant sur le reseau seront recus par l'interface. [-]allmulti Activer ou desactiver le mode all-multicast. S'il est active, l'interface recevra tous les paquets de multidiffusion circulant sur le reseau. mtu N Ce parametre definit la taille maximum de l'unite de transfert ou MTU (<< Maximum Transfer Unit >>) d'une interface. dstaddr adresse Definir l'adresse IP distante dans le cas d'un lien point-a-point (comme PPP). Cette option est obsolete ; utilisez a la place l'option pointopoint. netmask adresse Definir le masque de reseau IP pour cette interface. La valeur par defaut correspond au masque de reseau habituel pour les classes A, B ou C (deduite de l'adresse IP), mais une autre valeur peut etre definie. add adresse/longueur_prefixe Ajouter une adresse IPv6 a une interface. del adresse/longueur_prefixe Supprimer une adresse IPv6 d'une interface. tunnel ::aa.bb.cc.dd Creer un nouveau peripherique SIT (IPv6-dans-IPv4), fonctionnant en mode tunnel jusqu'a la destination donnee. irq adresse Definir la ligne d'interruption utilisee par un peripherique. Certains peripheriques ne sont pas capables de changer dynamiquement d'IRQ. io_addr adresse Definir l'adresse de debut dans l'espace d'entree-sortie pour ce peripherique. mem_start adresse Definir l'adresse de debut de la memoire partagee utilisee par un peripherique. Peu de peripheriques ont besoin de ce parametre. media type Definir le port physique ou le type de medium utilise par le peripherique. Tous les peripheriques ne peuvent pas changer cette configuration et les types acceptes varient de l'un a l'autre. Les valeurs habituelles du type sont 10base2 (Ethernet fin), 10baseT (Ethernet 10Mbps en paire torsadee), AUI (emetteur-recepteur externe), etc. Le medium special de type auto permet d'indiquer au pilote de detecter automatiquement le medium utilise. Une fois de plus, tous les pilotes n'acceptent pas cette option. [-]broadcast [adresse] Si l'adresse est donnee, elle definit l'adresse de diffusion du protocole pour cette interface. Autrement, cela definit (ou supprime) l'indicateur IFF_BROADCAST de l'interface. [-]pointopoint [adresse] Ce mot-cle active le mode point-a-point d'une interface, signifiant qu'il existe un lien direct entre 2 machines, sans que personne d'autre ne puisse etre a l'ecoute. Si l'adresse est egalement donnee, cela definit l'adresse de protocole de l'autre machine, de la meme maniere que le mot-cle obsolete dstaddr. Autrement, il definit (ou supprime) l'indicateur IFF_POINTOPOINT de l'interface. hw classe adresse Definir l'adresse materielle de l'interface, si le pilote du peripherique accepte cette operation. Le mot cle doit etre suivie du nom de la classe materielle et de l'adresse materielle en caracteres ASCII affichables. Les classes materielles 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 generalement pas necessaire puisque les pilotes positionnent correctement l'option eux-memes. adresse L'adresse IP affectee a cette interface. txqueuelen longueur Definir la longueur de la file d'attente de transmission du peripherique. Il est utile de la fixer a des valeurs faibles pour les peripheriques lents avec un temps d'attente important (modems, ISDN), pour empecher d'etre perturbe par de rapides transferts de masse issus des trafics interactifs, comme telnet. name nouveau_nom Changer le nom de cette interface a nouveau_nom. Il faut prealablement eteindre 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 affichees pour la veritable adresse sont partagees avec toutes les adresses d'alias du meme peripherique. Pour avoir des statistiques par adresse, il faut ajouter des regles de comptabilite 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 unites IEC 60027-2. Ainsi, 1 KiB vaut 2^10 octets. Notez que les nombres sont tronques a la premiere decimale (ce qui peut etre une erreur importante si vous considerez que 0,1 PiB vaut 112.589.990.684.262 octets :) Des problemes d'interruption avec les pilotes de peripheriques Ethernet apparaissent avec EAGAIN (SIOCSIIFLAGS : Ressource temporairement indisponible) ; il s'agit surement 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 methode d'acces ioctl pour obtenir les informations completes sur les adresses, ce qui limite les adresses materielles a 8 octets. Comme les adresses materielles Infiniband ont composees de 20 octets, seuls les 8 premiers sont affiches correctement. Veuillez utiliser la commande ip link du paquet iproute2 pour afficher les informations sur la couche liaison y compris les adresses materielles. Meme si les adresses AppleTalk DDP et IPX sont affichees, elles ne peuvent pas etre modifiees 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 - Prefixes pour les multiples binaires. AUTEURS Fred N. van Kempen, Alan Cox, Phil Blundell, Andi Kleen Bernd Eckenfels, TRADUCTION La traduction francaise de cette page de manuel a ete creee par Jean Michel VANSTEENE , Guillaume Audirac et Jean- Pierre Giraud Cette traduction est une documentation libre ; veuillez vous reporter a la GNU General Public License version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITE LEGALE. Si vous decouvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message a . net-tools 3 octobre 2008 IFCONFIG(8)