route - affiche / manipule la table de routage IP

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]

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.

-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.

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».

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.

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

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

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.

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

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

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.