Provided by: net-tools_1.60-23ubuntu3_i386 bug

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  utilisation
       premiere  consiste  a configurer des routes statiques vers des hotes ou
       des reseaux via une interface, apres sa configuration par le  programme
       ifconfig(8).

OPTIONS

       -v     Active le mode verbeux.

       -A famille
              Utilise la famille d'adresses specifiee (p.ex. `inet', `inet6').

       -n     Affiche les adresses numeriques, au lieu d'essayer de determiner
              les noms d'hotes. C'est utile si vous essayer de savoir pourquoi
              la route vers votre serveur de nom a disparu.

       -e     utilise  netstat(8)-format  pour  l'affichage  de  la  table  de
              routage.  -ee  Genere  une  tres  longue  ligne  avec  tous  les
              parametres a partir de la table de routage.

       -net   la cible est un reseau.

       -host  la cible est un hote.

       -F     affiche  la  table  de routage FIB du noyau. L'organisation peut
              etre changee avec -e et -ee

       -C     affiche le cache de routage du noyau.

       del    supprime une route.

       add    ajoute une route.

       cible  L'hote ou le reseau destination. Vous pouvez fournir une adresse
              IP en notation decimale pointee ou un nom d'hote ou de reseau.

       netmask Nm
              specifie le masque reseau de la route a ajouter.

       gw Gw  signifie  que  tout paquet IP envoye a cette adresse  sera route
              par la passerelle specifiee.  NOTE: La passerelle concernee doit
              pouvoir  etre atteinte. Ceci signifie qu'une route statique vers
              cette passerelle doit prealablement exister.  Si vous  specifiez
              l'adresse de l'une de vos interfaces locales, elle sera utilisee
              pour decider de l'interface vers  laquelle  les  paquets  seront
              envoyes.  Ceci  est  une  bidouille permettant d'etre compatible
              BSD.

       metric M
              Affecte la valeur M au champ metrique de  la  table  de  routage
              (utilise par les demons de routage).

       mss M  Specifie  le  MSS  (Maximum  Segment  Size,  Taille  maximum  de
              segment) de TCP, pour les connexions empreintant cette route. Ce
              n'est  normalement  utilise que pour des optimisations fines des
              configurations de routage.

       window W
              Definit la taille de fenetre TCP a W octets pour les  connexions
              relatives a cette route. C'est en general uniquement utilise sur
              les reseaux AX.25 et avec les pilotes  incapables  de  manipuler
              les trames dos a dos.

       irtt I Definit  le  iRTT  initial (round trip time) pour les connexions
              TCP sur cette  route  a  I  millisecondes  (1-12000).  C'est  en
              general  uniquement  utilise  sur les reseaux AX.25. Si omis, la
              valeur par defaut (300 ms selon le RFC 1122) est utilisee.

       reject Installe  une  route  bloquante,  qui  forcera   l'echec   d'une
              recherche.   C'est  par exemple utilise pour masquer les reseaux
              avant d'utiliser la route par defaut. Ce n'est pas une  fonction
              de pare-feu.

       mod, dyn, reinstate
              Installe  une  route dynamique ou modifiee. Les deux indicateurs
              ne sont en general positionnes que par le demon de routage. Cela
              ne sert que pour des besoins de diagnostics.

       dev If Force  la  route a etre associee au peripherique specifie, sinon
              le noyau tentera de le determiner par  lui-meme  (en  consultant
              les  routes  existantes et les specifications de peripheriques).
              Dans la plupart des reseaux normaux, vous n'aurez pas besoin  de
              ceci.

              If dev If est la derniere option de la ligne de commande, le mot
              dev  peut  etre  omis,  puisque  c'est  la  valeur  par  defaut.
              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'entree  loopback  normale,  en  utilisant  le   masque
              255.0.0.0  (reseau  de classe A, selon l'adresse de destination)
              et  associee  avec  l'interface  "lo"  (en  supposant   que   ce
              peripherique a ete correctement configure avec ifconfig(8)).

       route add -net 192.56.76.0 netmask 255.255.255.0 dev eth0
              ajoute  une  route  vers  le  reseau  192.56.76.x via "eth0". Le
              masque de classe C n'est pas vraiment necessaire ici  car  192.*
              est une adresse IP de classe C. Le mot "dev" peut etre omis.

       route add default gw mango-gw
              ajoute  une  route par defaut (qui sera utilisee si aucune autre
              route ne convient). Tous les  paquets  empreintant  cette  route
              passeront par "mango-gw". Le peripherique qui sera effectivement
              utilise pour cette route depend de  la  facon  dont  on  atteint
              "mango-gw"  -  la  route  statique  vers  "mango-gw"  devra etre
              prealablement configuree.

       route add ipx4 sl0
              ajoute une route vers l'hote "ipx4"  via  l'interface  SLIP  (en
              supposant que "ipx4" est l'hote SLIP).

       route add -net 192.57.66.0 netmask 255.255.255.0 gw ipx4
              Cette  commande  route  le  reseau  "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 documentee et les gens savent ce qu'il
              faut  faire?  Ceci  force  toutes  les  routes  IP des classes D
              (multicast)  a  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 'rejetee' pour le reseau prive "10.x.x.x."

RESULTATS

       Le  contenu  des  tables  de  routage du noyaus est affiche en colonnes
       comme suit

       Destination
              Le reseau ou hote destination.

       Gateway
              L'adresse de la passerelle ou '*' si indefini.

       Genmask
              Le   masque   de   reseau   pour   le    reseau    destinataire;
              '255.255.255.255'  pour  un  hote et '0.0.0.0' pour la route par
              defaut ( default ).

       Indicateurs
              Les indicateurs possibles sont
              U (la route est active = up)
              H (la cible est un h^ote)
              G (utilise comme passerelle)
              R (r'etablit la route pour le routage dynamique)
              D (dynamiquement configuree par le demon ou par redirect)
              M (modifi'ee par le demon de routage ou par redirect)
              !  (rej`ete la route)

       Metric La 'distance' a la cible (habituellement comptee  en  hops).  Ce
              n'est  pas utilise par les noyaux recents, mais peut-etre requis
              par certains demons de routage.

       Ref    Nombre de references a cette route. (Pas utilise 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 envoyes.

       MSS    Taille de segment maximum par defaut pour les connexions TCP sur
              cette route.

       Window Taille de fenetre par defaut pour les connexions TCP  sur  cette
              route.

       irtt   RTT  Initial  (Round  Trip  Time).  Le  noyau  utilise ceci pour
              essayer les meilleurs parametres protocolaires TCP sans attendre
              de reponse (eventuellement tardive).

       HH (seulement cach'e)
              Le  nombre  d'entrees ARP et de routes cachees faisant reference
              au cache d'en-tete materiel pour la route en cache. Ce  sera  la
              valeur  -1  si  aucune  adresse materielle n'est necessaire pour
              l'interface de la route cachee (p.ex. lo).

       Arp (seulement cach'e)
              Indique si oui ou non l'adresse  materielle  pour  la  route  en
              cache est encore a 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  ete originellement ecrit par Fred N. van Kempen,
       <waltje@uwalt.nl.mugnet.org> puis modifie par Johannes Stille et  Linus
       Torvalds pour pl15. Alan Cox a ajoute les options concernant la gestion
       des fenetres et MSS pour Linux 1.1.22. Le support de irtt et la  fusion
       avec netstat ont ete realises par Bernd Eckenfels.

AUTEUR

       Maintenu   par   Phil  Blundell  <Philip.Blundell@pobox.com>  et  Bernd
       Eckenfels <net-tools@lina.inka.de>.

TRADUCTION

       Jean-Michel VANSTEENE <vanstee@worldnet.fr>