ROUTE

Section: Manuel du programmeur de Linux (8)
Updated: 2 oct 2003
Index


NOM
SYNOPSIS
DESCRIPTION
OPTIONS
EXEMPLES
AFFICHAGE
FICHIERS
VOIR AUSSI
HISTORIQUE
AUTEUR
TRADUCTION
AVERTISSEMENT SUR LA TRADUCTION

NOM

route - affiche / manipule 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, le programme route modifie les tables de routage. Sans ces options, il affiche simplement le contenu actuel des tables.

OPTIONS

-A famille
Utilise la famille d'adresses spécifiée (par exemple «inet» ; exécutez «route --help» pour obtenir la liste complète).
-F
Travaille sur la table de routage FIB («Forwarding Information Base») du noyau. C'est le comportement par défaut.
-C
Travaille sur le cache de routage du noyau.
-v
Active le mode verbeux.
-n
Affiche 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
Utilise le format de netstat(8) pour l'affichage de la table de routage. -ee Génère une très longue ligne avec tous les paramètres de la table de routage.
del
Supprime une route.
add
Ajoute 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écifie le masque de réseau de la route à ajouter.
gw Gw
Route 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
Affecte la valeur M au champ métrique de la table de routage (utilisé par les démons de routage).
mss M
Fixe à 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é 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
Fixe à 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
Fixe 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 le RFC 1122).
reject
Installe 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
Installe 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
Force 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 (multi-diffusion) à passer par «eth0». C'est la configuration appropriée pour un noyau acceptant la multi-diffusion.
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

Jean-Michel Vansteene, Guillaume Audirac (août 2004)

AVERTISSEMENT SUR LA TRADUCTION

Il est possible que cette traduction soit imparfaite ou périmée. En cas de doute, veuillez vous reporter au document original en langue anglaise fourni avec le programme.