ROUTE(E) Linux Programmer's Manual ROUTE(E) NAME 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 la table de routage IP du noyau. Son util- isation premire consiste configurer des routes statiques vers des htes ou des rseaux via une interface, aprs sa configuration par le programme ifconfig(g). OPTIONS -v Active le mode verbeux. -A famille Utilise la famille d'adresses spcifie (p.ex. `inet', `inet6'). -n Affiche les adresses numriques, au lieu d'essayer de dterminer les noms d'htes. C'est utile si vous essayer de savoir pourquoi la route vers votre serveur de nom a disparu. -e utilise netstat(t)-format pour l'affichage de la table de routage. -ee Gnre une trs longue ligne avec tous les paramtres partir de la table de routage. -net la cible est un rseau. -host la cible est un hte. -F affiche la table de routage FIB du noyau. L'organi- sation peut tre change avec -e et -ee -C affiche le cache de routage du noyau. del supprime une route. add ajoute une route. cible L'hte ou le rseau destination. Vous pouvez fournir une adresse IP en notation dcimale pointe ou un nom d'hte ou de rseau. netmask Nm spcifie le masque rseau de la route ajouter. gw Gw signifie que tout paquet IP envoy cette adresse sera rout par la passerelle spcifie. NOTE: La passerelle concerne doit pouvoir tre atteinte. Ceci signifie qu'une route statique vers cette passerelle doit pralablement exister. Si vous spcifiez l'adresse de l'une de vos interfaces locales, elle sera utilise pour dcider de l'inter- face vers laquelle les paquets seront envoys. Ceci est une bidouille permettant d'tre compatible BSD. metric M Affecte la valeur M au champ mtrique de la table de routage (utilis par les dmons de routage). mss M Spcifie le MSS (Maximum Segment Size, Taille maxi- mum de segment) de TCP, pour les connexions empreintant cette route. Ce n'est normalement utilis que pour des optimisations fines des config- urations de routage. Par dfaut la valeur est 536. window W Dfinit la taille de fentre TCP W octets pour les connexions relatives cette route. C'est en gnral uniquement utilis sur les rseaux AX.25 et avec les pilotes incapables de manipuler les trames dos dos. irtt I Dfinit le iRTT initial (round trip time) pour les connexions TCP sur cette route I millisecondes (1-12000). C'est en gnral uniquement utilis sur les rseaux AX.25. Si omis, la valeur par dfaut (300 ms selon le RFC 1122) est utilise. reject Installe une route bloquante, qui forcera l'chec d'une recherche. C'est par exemple utilis pour masquer les rseaux avant d'utiliser la route par dfaut. Ce n'est pas une fonction de pare-feu. mod, dyn, reinstate Installe une route dynamique ou modifie. Les deux indicateurs ne sont en gnral positionns que par le dmon de routage. Cela ne sert que pour des besoins de diagnostics. dev If Force la route tre associe au priphrique spcifi, sinon le noyau tentera de le dterminer par lui-mme (en consultant les routes existantes et les spcifi- cations de priphriques). Dans la plupart des rseaux normaux, vous n'aurez pas besoin de ceci. If dev If est la dernire option de la ligne de com- mande, le mot dev peut tre omis, puisque c'est la valeur par dfaut. Autrement l'ordre des modifica- teurs de route (metric - netmask - gw - dev) n'a pas d'importance. EXEMPLES route add -net 127.0.0.0 ajoute l'entre loopback normale, en utilisant le masque 255.0.0.0 (rseau de classe A, selon l'adresse de destination) et associe avec l'inter- face "lo" (en supposant que ce priphrique a t cor- rectement configur avec ifconfig(g)). route add -net 192.56.76.0 netmask 255.255.255.0 dev eth0 ajoute une route vers le rseau 192.56.76.x via "eth0". Le masque de classe C n'est pas vraiment ncessaire 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 dfaut (qui sera utilise si aucune autre route ne convient). Tous les paquets empreintant cette route passeront par "mango-gw". Le priphrique qui sera effectivement utilis pour cette route dpend de la faon dont on atteint "mango-gw" - la route statique vers "mango-gw" devra tre pralablement configure. route add ipx4 sl0 ajoute une route vers l'hte "ipx4" via l'interface SLIP (en supposant que "ipx4" est l'hte SLIP). route add -net 192.57.66.0 netmask 255.255.255.0 gw ipx4 Cette commande route le rseau "192.57.66.x" par l'ancienne route vers l'interface SLIP. route add 224.0.0.0 netmask 240.0.0.0 dev eth0 Ceci est une commande mal documente et les gens savent ce qu'il faut faire? Ceci force toutes les routes IP des classes D (multicast) passer par "eth0". C'est la configuration correcte, normale pour un noyau supportant le multicast. route add 10.0.0.0 netmask 255.0.0.0 reject Installe une route 'rejete' pour le rseau priv "10.x.x.x." RESULTATS Le contenu des tables de routage du noyaus est affich en colonnes comme suit Destination Le rseau ou hte destination. Gateway L'adresse de la passerelle ou '*' si indfini. Genmask Le masque de rseau pour le rseau destinataire; '255.255.255.255' pour un hte et '0.0.0.0' pour la route par dfaut ( default ). Indicateurs Les indicateurs possibles sont U (la route est active = up) H (la cible est un hte) G (utilise comme passerelle) R (rtablit la route pour le routage dynamique) D (dynamiquement configure par le dmon ou par redi- rect) M (modifie par le dmon de routage ou par redirect) ! (rejte la route) Metric La 'distance' la cible (habituellement compte en hops). Ce n'est pas utilis par les noyaux rcents, mais peut-tre requis par certains dmons de routage. Ref Nombre de rfrences cette route. (Pas utilis dans le noyau Linux.) Use Count of lookups for the route. Depending on the use of -F and -C this will be either route cache misses (-F) or hits (-C). Iface Interface vers laquelle les paquets empruntant cette route seront envoys. MSS Taille de segment maximum par dfaut pour les con- nexions TCP sur cette route. Window Taille de fentre par dfaut pour les connexions TCP sur cette route. irtt RTT Initial (Round Trip Time). Le noyau utilise ceci pour essayer les meilleurs paramtres protoco- laires TCP sans attendre de rponse (ventuellement tardive). HH (seulement cach) Le nombre d'entres ARP et de routes caches faisant rfrence au cache d'en-tte matriel pour la route en cache. Ce sera la valeur -1 si aucune adresse matrielle n'est ncessaire pour l'interface de la route cache (p.ex. lo). Arp (seulement cach) Indique si oui ou non l'adresse matrielle pour la route en cache est encore jour. FICHIERS /proc/net/ipv6_route /proc/net/route /proc/net/rt_cache VOIR AUSSI ifconfig(g), netstat(t), arp(p), rarp(p) 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 concernant la gestion des fentres et MSS pour Linux 1.1.22. Le support de irtt et la fusion avec netstat ont t raliss par Bernd Eckenfels. AUTEUR Maintenu par Phil Blundell <Philip.Blundell@pobox.com>. TRADUCTION Jean-Michel VANSTEENE (vanstee@worldnet.fr) net-tools 8 Aot 1997 ROUTE(E)