Annotation of cci/usr/src/man/man8/routed.8c, revision 1.1

1.1     ! root        1: .TH ROUTED 8C "3 February 1983"
        !             2: .UC 4
        !             3: .SH NAME
        !             4: routed \- network routing daemon
        !             5: .SH SYNOPSIS
        !             6: .B /etc/routed
        !             7: [
        !             8: .B \-s
        !             9: ] [
        !            10: .B \-q
        !            11: ] [
        !            12: .B \-t
        !            13: ] [
        !            14: .I logfile
        !            15: ]
        !            16: .SH DESCRIPTION
        !            17: .I Routed
        !            18: is invoked at boot time to manage the network routing tables.
        !            19: The routing daemon uses a variant of the Xerox NS Routing
        !            20: Information Protocol in maintaining up to date kernel routing
        !            21: table entries.
        !            22: .PP
        !            23: In normal operation
        !            24: .I routed
        !            25: listens on
        !            26: .IR udp (4P)
        !            27: socket 520 (decimal)
        !            28: for routing information packets.  If the host is an
        !            29: internetwork router, it periodically supplies copies
        !            30: of its routing tables to any directly connected hosts
        !            31: and networks.
        !            32: .PP
        !            33: When
        !            34: .I routed
        !            35: is started, it uses the SIOCGIFCONF
        !            36: .I ioctl
        !            37: to find those
        !            38: directly connected interfaces configured into the
        !            39: system and marked ``up'' (the software loopback interface
        !            40: is ignored).  If multiple interfaces
        !            41: are present, it is assumed the host will forward packets
        !            42: between networks.
        !            43: .I Routed
        !            44: then transmits a 
        !            45: .I request
        !            46: packet on each interface (using a broadcast packet if
        !            47: the interface supports it) and enters a loop, listening
        !            48: for
        !            49: .I request
        !            50: and
        !            51: .I response
        !            52: packets from other hosts.
        !            53: .PP
        !            54: When a
        !            55: .I request
        !            56: packet is received, 
        !            57: .I routed
        !            58: formulates a reply based on the information maintained in its
        !            59: internal tables.  The
        !            60: .I response
        !            61: packet generated contains a list of known routes, each marked
        !            62: with a ``hop count'' metric (a count of 16, or greater, is
        !            63: considered ``infinite'').  The metric associated with each
        !            64: route returned provides a metric
        !            65: .IR "relative to the sender" .
        !            66: .PP
        !            67: .I Response
        !            68: packets received by
        !            69: .I routed
        !            70: are used to update the routing tables if one of the following
        !            71: conditions is satisfied:
        !            72: .TP
        !            73: (1)
        !            74: No routing table entry exists for the destination network
        !            75: or host, and the metric indicates the destination is ``reachable''
        !            76: (i.e. the hop count is not infinite).
        !            77: .TP
        !            78: (2)
        !            79: The source host of the packet is the same as the router in the
        !            80: existing routing table entry.  That is, updated information is
        !            81: being received from the very internetwork router through which
        !            82: packets for the destination are being routed.
        !            83: .TP
        !            84: (3)
        !            85: The existing entry in the routing table has not been updated for
        !            86: some time (defined to be 90 seconds) and the route is at least
        !            87: as cost effective as the current route.
        !            88: .TP
        !            89: (4)
        !            90: The new route describes a shorter route to the destination than
        !            91: the one currently stored in the routing tables; the metric of
        !            92: the new route is compared against the one stored in the table
        !            93: to decide this.
        !            94: .PP
        !            95: When an update is applied,
        !            96: .I routed
        !            97: records the change in its internal tables and generates a
        !            98: .I response
        !            99: packet to all directly connected hosts and networks.
        !           100: .I Routed
        !           101: waits a short period
        !           102: of time (no more than 30 seconds) before modifying the kernel's
        !           103: routing tables to allow possible unstable situations to settle.
        !           104: .PP
        !           105: In addition to processing incoming packets,
        !           106: .I routed
        !           107: also periodically checks the routing table entries.
        !           108: If an entry has not been updated for 3 minutes, the entry's metric
        !           109: is set to infinity and marked for deletion.  Deletions are delayed
        !           110: an additional 60 seconds to insure the invalidation is propagated
        !           111: throughout the internet.
        !           112: .PP
        !           113: Hosts acting as internetwork routers gratuitously supply their
        !           114: routing tables every 30 seconds to all directly connected hosts
        !           115: and networks.
        !           116: .PP
        !           117: Supplying the
        !           118: .B \-s
        !           119: option forces 
        !           120: .I routed
        !           121: to supply routing information whether it is acting as an internetwork
        !           122: router or not.
        !           123: The
        !           124: .B \-q
        !           125: option is the opposite of the
        !           126: .B \-s
        !           127: option.  If the
        !           128: .B \-t
        !           129: option is specified, all packets sent or received are
        !           130: printed on the standard output.  In addition,
        !           131: .I routed
        !           132: will not divorce itself from the controlling terminal
        !           133: so that interrupts from the keyboard will kill the process.
        !           134: Any other argument supplied is interpreted as the name
        !           135: of file in which 
        !           136: .IR routed 's
        !           137: actions should be logged.  This log contains information
        !           138: about any changes to the routing tables and a history of
        !           139: recent messages sent and received which are related to
        !           140: the changed route.
        !           141: .PP
        !           142: In addition to the facilities described above, 
        !           143: .I routed
        !           144: supports the notion of ``distant''
        !           145: .I passive
        !           146: and 
        !           147: .I active
        !           148: gateways.  When 
        !           149: .I routed
        !           150: is started up, it reads the file
        !           151: .I /etc/gateways
        !           152: to find gateways which may not be identified using
        !           153: the SIOGIFCONF
        !           154: .IR ioctl .
        !           155: Gateways specified in this manner should be marked passive
        !           156: if they are not expected to exchange routing information,
        !           157: while gateways marked active
        !           158: should be willing to exchange routing information (i.e.
        !           159: they should have a
        !           160: .I routed
        !           161: process running on the machine).
        !           162: Passive gateways are maintained in the
        !           163: routing tables forever and information
        !           164: regarding their existence is included in
        !           165: any routing information transmitted.
        !           166: Active gateways are treated equally to network
        !           167: interfaces.  Routing information is distributed
        !           168: to the gateway and if no routing information is
        !           169: received for a period of the time, the associated
        !           170: route is deleted.
        !           171: .PP
        !           172: The 
        !           173: .I /etc/gateways
        !           174: is comprised of a series of lines, each in
        !           175: the following format:
        !           176: .PP
        !           177: .nf
        !           178: < \fBnet\fP | \fBhost\fP > \fIname1\fP \fBgateway\fP \fIname2\fP \fBmetric\fP \fIvalue\fP < \fBpassive\fP | \fBactive\fP >
        !           179: .fi
        !           180: .PP
        !           181: The 
        !           182: .B net
        !           183: or
        !           184: .B host
        !           185: keyword indicates if the route is to a network or specific host.
        !           186: .PP
        !           187: .I Name1
        !           188: is the name of the destination network or host.  This may be a
        !           189: symbolic name located in
        !           190: .I /etc/networks
        !           191: or
        !           192: .IR /etc/hosts ,
        !           193: or an Internet address specified in ``dot'' notation; see
        !           194: .IR inet (3N).
        !           195: .PP
        !           196: .I Name2
        !           197: is the name or address of the gateway to which messages should
        !           198: be forwarded.
        !           199: .PP
        !           200: .I Value
        !           201: is a metric indicating the hop count to the destination host
        !           202: or network.
        !           203: .PP
        !           204: The keyword
        !           205: .B passive
        !           206: or
        !           207: .B active
        !           208: indicates if the gateway should be treated as 
        !           209: .I passive
        !           210: or
        !           211: .I active
        !           212: (as described above).
        !           213: .SH FILES
        !           214: .DT
        !           215: /etc/gateways  for distant gateways
        !           216: .SH "SEE ALSO"
        !           217: ``Internet Transport Protocols'', XSIS 028112, Xerox System Integration
        !           218: Standard.
        !           219: .br
        !           220: udp(4P)
        !           221: .SH BUGS
        !           222: The kernel's routing tables may not correspond to those of
        !           223: .I routed
        !           224: for short periods of time while processes utilizing existing
        !           225: routes exit; the only remedy for this is to place the routing
        !           226: process in the kernel.
        !           227: .PP
        !           228: .I Routed
        !           229: should listen to intelligent interfaces, such as an IMP, and
        !           230: to error protocols, such as ICMP, to gather more information.

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.