Commit | Line | Data |
---|---|---|
0fccfdb8 | 1 | .\" Copyright (c) 1986, 1991 The Regents of the University of California. |
92c0cb22 | 2 | .\" All rights reserved. |
bbd6082e | 3 | .\" |
266e2b06 | 4 | .\" %sccs.include.redist.man% |
bbd6082e | 5 | .\" |
0fccfdb8 | 6 | .\" @(#)XNSrouted.8 6.4 (Berkeley) %G% |
92c0cb22 | 7 | .\" |
0fccfdb8 CL |
8 | .Dd |
9 | .Dt XNSROUTED 8 | |
10 | .Os BSD 4.3 | |
11 | .Sh NAME | |
12 | .Nm XNSrouted | |
13 | .Nd NS Routing Information Protocol daemon | |
14 | .Sh SYNOPSIS | |
15 | .Nm XNSrouted | |
16 | .Op Fl q | |
17 | .Op Fl s | |
18 | .Op Fl t | |
19 | .Op Ar logfile | |
20 | .Sh DESCRIPTION | |
21 | .Nm XNSrouted | |
bbd6082e KM |
22 | is invoked at boot time to manage the Xerox NS routing tables. |
23 | The NS routing daemon uses the Xerox NS Routing | |
24 | Information Protocol in maintaining up to date kernel routing | |
25 | table entries. | |
0fccfdb8 CL |
26 | .Pp |
27 | Available options: | |
28 | .Bl -tag -width logfile | |
29 | .It Fl q | |
30 | Do not supply routing information (opposite of | |
31 | .Fl s | |
32 | option below). | |
33 | .It Fl s | |
34 | Forces | |
35 | .Nm XNSrouted | |
36 | to supply routing information whether it is acting as an internetwork | |
37 | router or not. | |
38 | .It Fl t | |
39 | All packets sent or received are | |
40 | printed on the standard output. In addition, | |
41 | .Nm XNSrouted | |
42 | will not divorce itself from the controlling terminal | |
43 | so that interrupts from the keyboard will kill the process. | |
44 | .It Ar logfile | |
45 | Name of file in which | |
46 | .Nm XNSrouted Ns 's | |
47 | actions should be logged. This log contains information | |
48 | about any changes to the routing tables and a history of | |
49 | recent messages sent and received which are related to | |
50 | the changed route. | |
51 | .El | |
52 | .Pp | |
bbd6082e | 53 | In normal operation |
0fccfdb8 | 54 | .Nm XNSrouted |
bbd6082e KM |
55 | listens |
56 | for routing information packets. If the host is connected to | |
57 | multiple NS networks, it periodically supplies copies | |
58 | of its routing tables to any directly connected hosts | |
59 | and networks. | |
0fccfdb8 | 60 | .Pp |
bbd6082e | 61 | When |
0fccfdb8 CL |
62 | .Nm XNSrouted |
63 | is started, it uses the | |
64 | .Dv SIOCGIFCONF | |
65 | .Xr ioctl 2 | |
bbd6082e KM |
66 | to find those |
67 | directly connected interfaces configured into the | |
0fccfdb8 CL |
68 | system and marked |
69 | .Dq up | |
70 | (the software loopback interface | |
bbd6082e KM |
71 | is ignored). If multiple interfaces |
72 | are present, it is assumed the host will forward packets | |
73 | between networks. | |
0fccfdb8 | 74 | .Nm XNSrouted |
bbd6082e | 75 | then transmits a |
0fccfdb8 | 76 | .Em request |
bbd6082e KM |
77 | packet on each interface (using a broadcast packet if |
78 | the interface supports it) and enters a loop, listening | |
79 | for | |
0fccfdb8 | 80 | .Em request |
bbd6082e | 81 | and |
0fccfdb8 | 82 | .Em response |
bbd6082e | 83 | packets from other hosts. |
0fccfdb8 | 84 | .Pp |
bbd6082e | 85 | When a |
0fccfdb8 | 86 | .Em request |
bbd6082e | 87 | packet is received, |
0fccfdb8 | 88 | .Nm XNSrouted |
bbd6082e KM |
89 | formulates a reply based on the information maintained in its |
90 | internal tables. The | |
0fccfdb8 | 91 | .Em response |
bbd6082e | 92 | packet generated contains a list of known routes, each marked |
0fccfdb8 CL |
93 | with a |
94 | .Dq hop count | |
95 | metric (a count of 16, or greater, is | |
96 | considered | |
97 | .Dq infinite ) . | |
98 | The metric associated with each | |
bbd6082e | 99 | route returned provides a metric |
0fccfdb8 CL |
100 | .Em relative to the sender . |
101 | .Pp | |
102 | .Em Response | |
bbd6082e | 103 | packets received by |
0fccfdb8 | 104 | .Nm XNSrouted |
bbd6082e KM |
105 | are used to update the routing tables if one of the following |
106 | conditions is satisfied: | |
0fccfdb8 CL |
107 | .Bl -bullet |
108 | .It | |
bbd6082e KM |
109 | No routing table entry exists for the destination network |
110 | or host, and the metric indicates the destination is ``reachable'' | |
111 | (i.e. the hop count is not infinite). | |
0fccfdb8 | 112 | .It |
bbd6082e KM |
113 | The source host of the packet is the same as the router in the |
114 | existing routing table entry. That is, updated information is | |
115 | being received from the very internetwork router through which | |
116 | packets for the destination are being routed. | |
0fccfdb8 | 117 | .It |
bbd6082e KM |
118 | The existing entry in the routing table has not been updated for |
119 | some time (defined to be 90 seconds) and the route is at least | |
120 | as cost effective as the current route. | |
0fccfdb8 | 121 | .It |
bbd6082e KM |
122 | The new route describes a shorter route to the destination than |
123 | the one currently stored in the routing tables; the metric of | |
124 | the new route is compared against the one stored in the table | |
125 | to decide this. | |
0fccfdb8 CL |
126 | .El |
127 | .Pp | |
bbd6082e | 128 | When an update is applied, |
0fccfdb8 | 129 | .Nm XNSrouted |
bbd6082e | 130 | records the change in its internal tables and generates a |
0fccfdb8 | 131 | .Em response |
bbd6082e | 132 | packet to all directly connected hosts and networks. |
0fccfdb8 | 133 | .Xr Routed 8 |
bbd6082e KM |
134 | waits a short period |
135 | of time (no more than 30 seconds) before modifying the kernel's | |
136 | routing tables to allow possible unstable situations to settle. | |
0fccfdb8 | 137 | .Pp |
bbd6082e | 138 | In addition to processing incoming packets, |
0fccfdb8 | 139 | .Nm XNSrouted |
bbd6082e KM |
140 | also periodically checks the routing table entries. |
141 | If an entry has not been updated for 3 minutes, the entry's metric | |
142 | is set to infinity and marked for deletion. Deletions are delayed | |
143 | an additional 60 seconds to insure the invalidation is propagated | |
144 | to other routers. | |
0fccfdb8 | 145 | .Pp |
bbd6082e KM |
146 | Hosts acting as internetwork routers gratuitously supply their |
147 | routing tables every 30 seconds to all directly connected hosts | |
148 | and networks. | |
0fccfdb8 CL |
149 | .Sh SEE ALSO |
150 | .Xr idp 4 | |
151 | .Rs | |
152 | .%T "Internet Transport Protocols" | |
153 | .%R "XSIS 028112" | |
154 | .%Q "Xerox System Integration Standard" | |
155 | .Re | |
156 | .Sh HISTORY | |
bbd6082e | 157 | The |
0fccfdb8 CL |
158 | .Nm |
159 | command appeared in | |
160 | .Bx 4.3 . |