Content-type: text/html Manpage of ROUTE

ROUTE

Section: Manuel du programmeur de Linux (8)
Updated: 2 octobre 2003
Index Return to Main Contents

NOM

route - Afficher/manipuler la table de routage IP.

SYNOPSIS

route [-CFvnee]

route: [-v] [-A famille] add [-net|-host] cible [netmask Nm] [gw Gw] [metric N] [mss M] [window W] [irtt I] [reject] [mod] [dyn] [reinstate] [[dev] If]
route: [-v] [-A famille] del [-net|-host] cible [gw Gw] [netmask Nm] [metric N] [[dev] If]
route: [-V] [--version] [-h] [--help]

DESCRIPTION

route manipule les tables de routage IP du noyau. Son utilisation première consiste à configurer des routes statiques vers des hôtes ou des réseaux via une interface, après sa configuration par le programme ifconfig(8).

Avec les options add ou del, route modifie les tables de routage. Sans ces options, il affiche simplement le contenu actuel des tables.

OPTIONS

-A famille: Utiliser la famille d'adresses spécifiée (par exemple « inet » ; exécutez route --help pour obtenir la liste complète).
-F: Travailler sur la table de routage FIB (« Forwarding Information Base ») du noyau. C'est le comportement par défaut.
-C: Travailler sur le cache de routage du noyau.
-v: Activer le mode volubile.
-n: Afficher les adresses sous forme numérique, au lieu d'essayer de déterminer les noms d'hôtes symboliques. C'est utile si vous désirez comprendre pourquoi la route vers votre serveur de noms a disparu.
-e: Utiliser le format de netstat(8) pour l'affichage de la table de routage.
-ee: Générer une très longue ligne avec tous les paramètres de la table de routage.
del: Supprimer une route.
add: Ajouter une route.
cible: Le réseau ou l'hôte de destination, sous forme d'adresse IP en notation décimale pointée, ou sous forme de noms d'hôte ou de réseau.
-net: La cible est un réseau.
-host: La cible est un hôte.
netmask Nm: Spécifier le masque de réseau de la route à ajouter.
gw Gw: Router les paquets via une passerelle. NOTE : La passerelle concernée doit pouvoir être atteinte. Ceci signifie qu'une route statique vers cette passerelle doit préalablement exister. Si vous spécifiez l'adresse d'une de vos interfaces locales, elle sera utilisée pour décider de l'interface vers laquelle les paquets seront envoyés. Ceci est une bidouille permettant d'être compatible avec BSD.
metric M: Affecter la valeur M au champ métrique de la table de routage (utilisé par les démons de routage).
mss M: Fixer à M octets la taille maximum de segment (MSS ou « Maximum Segment Size ») de TCP, pour les connexions empruntant cette route. La valeur par défaut est donnée par le MTU du périphérique moins les en-têtes, ou un MTU inférieur quand se déclenche l'interrogation du MTU de la liaison. Ce réglage est utilisé pour forcer sur l'autre extrémité l'envoi de paquets TCP plus petits lorsque l'interrogation du MTU de la liaison ne fonctionne pas (habituellement à cause de pare-feux mal configurés qui bloquent les paquets ICMP de type « Fragmentation Nécessaire » ou « ICMP Fragmentation Needed »).
window W: Fixer à W octets la taille de la fenêtre de TCP pour les connexions relatives à cette route. C'est, en général, uniquement utilisé sur les réseaux AX.25 et avec les pilotes incapables de manipuler les trames dos-à-dos.
irtt I: Fixer le temps initial de trajet aller-retour (iRTT ou « round trip time ») pour les connexions TCP sur cette route à I millisecondes (1-12000). Typiquement, ceci ne concerne que les réseaux AX.25. Si la valeur est omise, on prend par défaut 300 ms (selon la RFC 1122).
reject: Installer une route bloquante, qui force l'échec d'une recherche de route. On l'utilise par exemple pour dissimuler des réseaux avant d'utiliser la route par défaut. Ce n'est pas une fonction de pare-feu.
mod, dyn, reinstate: Installer une route dynamique ou modifiée. En général, ces indicateurs ne sont positionnés que par des démons de routage, et ne servent que pour des besoins de diagnostics.
dev If: Forcer la route à être associée au périphérique spécifié, sinon le noyau tente de le déterminer par lui-même (en consultant les routes existantes et les spécifications de périphériques). Dans la plupart des réseaux normaux, vous n'en aurez pas besoin.
Si dev If est la dernière option en ligne de commande, le mot dev peut être omis, puisque c'est l'option par défaut. Autrement, l'ordre des modificateurs de route (metric - netmask - gw - dev) n'a pas d'importance.

EXEMPLES

route add -net 127.0.0.0: Ajoute l'entrée normale de bouclage (« loopback »), en utilisant le masque 255.0.0.0 (réseau de classe A, d'après l'adresse de destination) et en l'associant avec l'interface « lo » (en supposant que ce périphérique a été correctement configuré avec ifconfig(8)).
route add -net 192.56.76.0 netmask 255.255.255.0 dev eth0: Ajoute une route vers le réseau 192.56.76.x via « eth0 ». Le masque de classe C n'est pas vraiment nécessaire ici car 192.* est une adresse IP de classe C. Le mot « dev » peut être omis.
route add default gw mango-gw: Ajoute une route par défaut (qui sera utilisée si aucune autre route ne convient). Tous les paquets empruntant cette route passeront par la passerelle « mango-gw ». Le périphérique effectivement utilisé pour cette route dépend de la façon dont on atteint « mango-gw » - la route statique vers « mango-gw » devra être préalablement configurée.
route add ipx4 sl0: Ajoute une route vers l'hôte « ipx4 » via l'interface SLIP (en supposant que « ipx4 » est l'hôte SLIP).
route add -net 192.57.66.0 netmask 255.255.255.0 gw ipx4: Cette commande renvoie le réseau « 192.57.66.x » vers la passerelle définie par la commande précédente sur l'interface SLIP.
route add -net 224.0.0.0 netmask 240.0.0.0 dev eth0: Cette commande est obscure mais documentée pour que chacun puisse l'utiliser. Elle force toutes les routes d'adresse IP en classe D (multidiffusion) à passer par « eth0 ». C'est la configuration appropriée pour un noyau acceptant la multidiffusion.
route add -net 10.0.0.0 netmask 255.0.0.0 reject: Installe une route bloquante pour le réseau privé « 10.x.x.x ».

AFFICHAGE

Le contenu de la table de routage du noyau est affiché en colonnes comme suit :

Destination: Le réseau ou l'hôte de destination.
Passerelle: L'adresse de la passerelle ou « * » si aucune n'est définie.
Genmask: Le masque de réseau pour le réseau destinataire ; « 255.255.255.255 » pour un hôte et « 0.0.0.0 » pour la route par défaut (default).
Indic: Les indicateurs possibles sont
U (la route est active ou « up »)
H (la cible est un hôte)
G (utilise une passerelle ou « gateway »)
R (rétablit la route pour le routage dynamique)
D (configurée dynamiquement par le démon ou par une redirection)
M (modifiée par le démon de routage ou par une redirection)
A (installé par addrconf)
C (entrée du cache)
! (rejette la route)
Metric: La « distance » à la cible (habituellement comptée en sauts). Ce n'est pas utilisé par les noyaux récents, mais peut être requis par certains démons de routage.
Ref: Nombre de références à cette route (non utilisé dans le noyau Linux).
Use: Nombre de résolutions effectuées pour cette route. En fonction de l'option utilisée -F ou -C, on obtient les tentatives de résolution vers le cache manquées (-F) ou réussies (-C).
Iface: Interface vers laquelle seront envoyés les paquets empruntant cette route.
MSS: Taille de segment maximum par défaut pour les connexions TCP sur cette route.
Fenêtre: Taille de fenêtre par défaut pour les connexions TCP sur cette route.
irtt: Temps initial de trajet aller-retour (iRTT ou « initial Round Trip Time »). Le noyau utilise cette donnée pour deviner les meilleurs paramètres du protocole TCP sans attendre de réponse (pouvant être tardive).
HH (seulement pour le cache): Nombre d'entrées ARP et de routes cachées faisant référence au cache d'en-tête matériel pour la route cachée. La valeur est -1 si aucune adresse matérielle n'est nécessaire pour l'interface de la route cachée (par exemple, lo).
Arp (seulement pour le cache): Indique si oui ou non l'adresse matérielle pour la route en cache est encore à jour.

FICHIERS

/proc/net/ipv6_route
/proc/net/route
/proc/net/rt_cache

VOIR AUSSI

ifconfig(8), netstat(8), arp(8), rarp(8)

HISTORIQUE

route pour Linux a été originellement écrit par Fred N. van Kempen, <waltje@uwalt.nl.mugnet.org> puis modifié par Johannes Stille et Linus Torvalds pour pl15. Alan Cox a ajouté les options mss et window dans Linux 1.1.22. La prise en charge de irtt et la fusion avec netstat ont été réalisées par Bernd Eckenfels.

AUTEUR

Maintenu par Phil Blundell <Philip.Blundell@pobox.com>.

TRADUCTION

Ce document est une traduction réalisée par Jean Michel Vansteene <vanstee AT worldnet DOT fr> en 1998, mise à jour par Guillaume Audirac en août 2004 et révisée le 17 août 2006.

L'équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité. La version anglaise la plus à jour de ce document est toujours consultable via la commande : « LANG=C man 8 route ». N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.

This document was created by man2html, using the manual pages.
Time: 07:37:44 GMT, August 18, 2006