route
ROUTE(E)          Handbuch fr Linuxprogrammierer         ROUTE(E)



NAME
       route - Anzeigen der IP-Routen-Tabelle

SYNOPSIS
       route [-CFvnee]

       route  [-v]  [-A  Addressfamilie]  add  [-net|-host]  Ziel
              [netmask Nm] [gw Gw] [metric N] [mss M] [window  W]
              [irtt  I]  [reject]  [mod] [dyn] [reinstate] [[dev]
              Schnittstelle]

       route  [-v] [-A Adressfamilie] del [-net|-host]  Ziel  [gw
              Router]    [netmask    Nm]    [metric   N]   [[dev]
              Schnittstelle]

       route  [-V] [--version] [-h] [--help]

BESCHREIBUNG
       Route wird zum ndern der  IP-Routing-Tabelle  der  Kernels
       verwendet.   Seine  primre Verwendung ist statische Routen
       fur   bestimmte   Rechner   oder   Netzwerke   ber    eine
       Schnittstelle  einzutragen, nachdem diese mit dem Programm
       ifconfig(g) konfiguriert wurde.


OPTIONEN
       -v     schaltet ausfhrliche Ausgaben an.


       -A Adressfamilie
              Benutzt die  angegebene  Adresse,  z.B.  inet  oder
              inet6.


       -n     zeigt  numerische  Adressen  an, d.h. es wird nicht
              mehr versucht IP-Adressen in symbolische  Hostnamen
              umzuwandeln.  Dies kann z.B. ntzlich sein, wenn der
              Nameserver nicht mehr  erreichbar  ist,  z.B.  weil
              keine Route existiert.


       -e     Schaltet  das  Ausgabeformat  von netstat(t) fr die
              Anzeige der Routentabelle an.  -ee gibt  eine  sehr
              lange  Zeile  mit  allen  Routenparametern  aus der
              Routentabelle aus.


       -net   Das Ziel ist ein Netzwerk.


       -host  daS Ziel ist ein Rechner


       -F     Zeit die FIB Routentabelle des Kerns an.  Das  Aus-
              gabeformat kann mit den Optionen -e and -ee gendert
              werden.


       -C     zeigt den Routencache des Kernels an.


       del    Lescht eine Route.


       add    fgt eine Route zu.


       Ziel   Das Zielnetzwerk  oder  -System.   Die  Angabe  von
              sowohl  IP-Adressen  in  Form  von  dezimalen durch
              Punkt getrennten Quadrupeln als auch  Rechner-  und
              Netznamen ist zulssig.


       netmask Nm
              ndert  die  Netzwerksmaske  der  Route, die zugefgt
              werden soll.


       gw Router
              Alle IP-Pakete fr das Zielnetzwerk / -System werden
              zum angegebenen Router weitergeleitet.

              ANMERKUNG: Das angegebene Ziel mu zuerst erreichbar
              sein.  blicherweise bedeutet das, das  zuerst  eine
              statische  Route  zum  Router  eingetragen  werden.
              Wird  die  Adresse  einer   lokalen   Schnittstelle
              angegeben, so wird sie benutzt um zu entscheiden zu
              welcher  Schnittstelle  die  Pakete  weitergeleitet
              werden.  Dieses Merkmal dient der Kompatibilitt mit
              BSD.


       metric M
              Setzt das Metric-Feld der  Routentabelle,  das  von
              Routendmonen verwendet wird, auf M.


       mss M  Setzt  den  MSS-Wert (Maximum Segment Size) fr TCP-
              Verbindungen ber diese Route  auf  M  bytes.   Dies
              wird  normalerweise zur Verfeinerung der Routenein-
              stellungen verwendet.  Die Voreinstellung  ist  536
              bytes.


       window W
              Setzt  das  TCP-Fenster  fr  Verbindungen ber diese
              Route auf W bytes.  Dies wird blicherweise nur  auf
              AX.25-Netzwerken und mit Treibern, die Probleme mit
              aufeinanderfolgenden Paketen haben, benutzt.


       irtt A Setzt die Anfngliche Paketumlaufzeit (IRTT, Initial
              Round  Trip  Time)  fr  TCP-Verbindungen auf A mil-
              lisekunden.  Erlaubte Werte  sind  im  Bereich  von
              1-12000  Milisekunden.   Dies wird blicherweise nur
              auf AX.25 Netzwerken  benutzt.   Wenn  ausgelassen,
              dann  wird  der  Standardwert aus RFC1122 von 300ms
              benutzt.


       reject Installiert eine Blockaderoute, die im Abbruch  der
              Suche  nach  einer Route resultiert.  Dies wird zum
              Beispiel benutzt um Netzwerke auszumaskieren, bevor
              die  Standardroute  verwendet wird.  Dieses Merkmal
              ist NICHT zur Verwendung als Firewall gedacht.


       mod, dyn, reinstate
              Installiert  eine  dynamische   oder   modifizierte
              Route.  Beide Flaggen werden im allgemeinen nur von
              Routendmonen verwendet und dienen im route(e)  Kom-
              mando nur zu diagnostischen Zwecken.


       dev Schnittstelle
              Erzwingt,   da   die   Route  mit  der  angegebenen
              Schnittstelle assoziiert wird.  Ansonsten wrde  der
              Kern   selbststndig  versuchen,  die  Schnittstelle
              durch  berprfung  bereits   existierender   Routen,
              Schnittstellenspezifikationen  und  der  Stelle, zu
              der die Route zugefgt wird.  In  den  meisten  nor-
              malen Netzwerken wird dies nicht bentigt.

              Wird als letzte Option dev Schnittstelle angegeben,
              so kann das Schlsselwort dev ausgelassen werden, da
              es Standardwert ist.  Ansonsten ist die Reihenfolge
              der Optionen (metric, netmask, gw und dev), die die
              Route verndern, egal.


BEISPIELE
       route add -net 127.0.0.0
              erzeugt die normale Loopbackroute mit der Netzmaske
              255.0.0.0 (Netzwerk Klasse  A,  ermittelt  aus  der
              Zieladresse)    und    assoziert    sie   mit   der
              Schnittstelle lo unter der Annahme, da dieses  Gert
              vorher mit ifconfig(g) konfiguriert wurde.


       route add -net 192.56.76.0 netmask 255.255.255.0 dev eth0
              Legt  eine  Route zum Netzwerk 192.56.76.x ber eth0
              an.  Die Angabe  der  Klasse  C  Netzmaske  ist  in
              diesem  Fall nicht ntig, 192.* Klasse C IP-Adressen
              sind.  Das Wort dev darf in diesem Fall ausgelassen
              werden.


       route add default gw mango-gw
              legt  eine  Standardroute, d.h. eine Route die ver-
              wendet wird, wenn keine  andere  Route  passt,  an.
              Alle  Pakete  ber  diese  Route werden ber mango-gw
              weitergeleitet.  Die Schnittstelle, die  tatschlich
              fr  diese  Route verwendet wird, hngt davon ab, wie
              mango-gw erreicht werden kann.  Zuvor  mu  mango-gw
              bereits  ber  eine  andere  Route  erreicht  werden
              knnen.


       route add ipx4 sl0
              Legt eine Route zum  Rechner  ipx4  ber  die  SLIP-
              Schnittstelle  an.   Dabei  wird angenommen da ipx4
              der SLIP-Rechner auf der Gegenseite ist.


       route add -net 192.57.66.0 netmask 255.255.255.0 gw ipx4
              Dieses  Kommando  sorgt   dafr,   dass   das   Netz
              192.57.66.x  ber  die  obige  Route  ber  die SLIP-
              Schnittstelle weitergeleitet wird.


       route add 224.0.0.0 netmask 240.0.0.0 dev eth0
              Dieses etwas obscure Beispiel  wird  hier  dokumen-
              tiert,  um  zu zeigen, wie Multicastrouten angelegt
              werden.  Durch diese Route werden alle  Pakete  der
              Klasse   D  (Multicast)  ber  eth0  weitergeleitet.
              Diese die korrekte Konfiguration fr einen Kern  mit
              Multicast-Untersttzung.


       route add 10.0.0.0 netmask 255.0.0.0 reject
              Dies  installiert  eine  zurckweisende Route fr das
              private Netzwerk 10.x.x.x.



AUSGABE
       Die Ausgabe der Kernelroutentabelle besteht aus  folgenden
       Spalten

       Ziel   Das Zielnetzwerk oder -System.

       Router Die  Adresse  des weiterleitenden Routers oder "*",
              wenn keine gesetzt ist.

       Genmask
              Die Netzmaske fr das Zielnetz; '255.255.255.255' fr
              eine einzeles Zielsystem und '0.0.0.0' fr die Stan-
              dardroute (.  default).

       Flaggen
              Mgliche Flaggen sind
              U Route ist aktiviert ( up)
              H Ziel ist ein einzelner Rechner
              G Benutzt einen Router als gateway
              R modifiziert eine Route bei dynamischem Routen
              D Route ist dynamisch von einem daemon  oder  redi-
              rect-Paket erzeugt worden.
              M  modified  von  einem  Routendmon  oder redirekt-
              Paket.
              !  (zurckweisendeRoute)

       Metric Der Abstand zum Ziel, d.h. blicherweise die  Anzahl
              der Zwischenrouter.  Dieser Wert wird von aktuellen
              Kernen nicht verwendet, kann aber  u.U.   von  Rou-
              tendmonen bentigt werden.

       Ref    Anzahl  der  Referenzen  auf diese Route.  Wird vom
              Linux Kern nicht benutzt.

       Benutzer
              Zahl der Suchvorgnge nach  dieser  Route.   Abhngig
              von  -F  und  -C  werden  entweder  fehlgeschlagene
              Suchen im Cache (-F) oder Cache-Treffer (-C)  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).

       Schnittstelle
              Schnittstelle   auf   die  Pakete  fr  diese  Route
              geleitet werden.

       MSS    Maximale Segmentgre fr TCP-Verbindungen  ber  diese
              Route.

       Fenster
              Voreinstellung  fr  die Fenstergre von Verbindungen
              ber diese Route.

       irtt   Anfngliche Paketumlaufszeit  (IRTT,  Initial  Round
              Trip  Time).   Der  Kern benutzt diesen Wert um die
              bestmglichen   Parameter   fr   das   TCP-Protokoll
              abzuschtzen   ohne   mglicherweise   auf  eventuell
              langsame Antworten warten zu mssen.

       HH (cached only)
              Die Anzahl der ARP-Eintrge  und  gecachten  Routen,
              die  den  Hardware- headercache der gecachten Route
              referenzieren.  Die ist -1 wenn  keine  Hardwaread-
              resse  nicht  fr  den  Eintrag  der gecachten Route
              bentigt wird, z.B. fr lo.

       Arp (nur gecachet)
              Nur wenn die Hardwareadresse fr die gecachte  Route
              aktuell ist.


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


SIEHE AUCH
       ifconfig(g), netstat(t), arp(p), rarp(p)


GESCHICHTE
       Route  fr  Linux  wurde ursprnglich von Fred N. van Kempen
       geschrieben  (waltje@uwalt.nl.mugnet.org)  und  dann   von
       Johannes  Stille und Linus Torvalds fr pl15.  Alan Cox hat
       die mss und  window  Optionen  fr  Linux  1.1.22  zugefgt.
       Bernd  Eckenfels  hat  schlielich die Untersttzung fr irtt
       beigesteuert und den Code mit dem von Netstat vereinigt.

AUTOREN
       Route  wird  zur  Zeit  von  Phil  Blundel   (Philip.Blun-
       dell@pobox.com) gewartet.

bersetzung
       Ralf Bchle <ralf@gnu.org>



net-tools                  6. Mrz 1999                   ROUTE(E)