in.routed.8 (bbf215553c7233fbab8a0afdf1fac74c44781867) in.routed.8 (c55633c3b85a97a093b3f79f341aee08eb6bd15b)
1'\" te
2.\" Copyright (c) 2008 Sun Microsystems, Inc. All Rights Reserved.
3.\" Copyright 1989 AT&T
4.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
5.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
6.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
1'\" te
2.\" Copyright (c) 2008 Sun Microsystems, Inc. All Rights Reserved.
3.\" Copyright 1989 AT&T
4.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
5.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
6.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
7.TH IN.ROUTED 8 "Jul 24, 2008"
7.TH IN.ROUTED 8 "March 30, 2022"
8.SH NAME
9in.routed, routed \- network routing daemon
10.SH SYNOPSIS
8.SH NAME
9in.routed, routed \- network routing daemon
10.SH SYNOPSIS
11.LP
12.nf
13\fB/usr/sbin/in.routed\fR [\fB-AdghmnqsStVz\fR] [\fB-T\fR \fItracefile\fR [\fB-v\fR]]
14 [\fB-F\fR \fInet\fR[/mask ][,metric]] [\fB-P\fR \fIparams\fR]
15.fi
16
17.SH DESCRIPTION
11.nf
12\fB/usr/sbin/in.routed\fR [\fB-AdghmnqsStVz\fR] [\fB-T\fR \fItracefile\fR [\fB-v\fR]]
13 [\fB-F\fR \fInet\fR[/mask ][,metric]] [\fB-P\fR \fIparams\fR]
14.fi
15
16.SH DESCRIPTION
18.sp
19.LP
20The daemon \fBin.routed\fR, often referred to as \fBrouted\fR, is invoked at
21boot time to manage the network routing tables. It uses Routing Information
22Protocol, RIPv1 (RFC 1058), RIPv2 (RFC 2453), and Internet Router Discovery
23Protocol (RFC 1256) to maintain the kernel routing table. The RIPv1 protocol is
24based on the reference 4.3BSD daemon.
25.sp
26.LP
27\fBin.routed\fR is managed by means of the service management facility (SMF),

--- 58 unchanged lines hidden (view full) ---

86changes. The change in the kernel routing table is reflected in the next batch
87of response packets sent. If the next response is not scheduled for a while, a
88flash update response containing only recently changed routes is sent.
89.sp
90.LP
91In addition to processing incoming packets, in.routed also periodically checks
92the routing table entries. If an entry has not been updated for 3 minutes, the
93entry's metric is set to infinity and marked for deletion. Deletions are
17The daemon \fBin.routed\fR, often referred to as \fBrouted\fR, is invoked at
18boot time to manage the network routing tables. It uses Routing Information
19Protocol, RIPv1 (RFC 1058), RIPv2 (RFC 2453), and Internet Router Discovery
20Protocol (RFC 1256) to maintain the kernel routing table. The RIPv1 protocol is
21based on the reference 4.3BSD daemon.
22.sp
23.LP
24\fBin.routed\fR is managed by means of the service management facility (SMF),

--- 58 unchanged lines hidden (view full) ---

83changes. The change in the kernel routing table is reflected in the next batch
84of response packets sent. If the next response is not scheduled for a while, a
85flash update response containing only recently changed routes is sent.
86.sp
87.LP
88In addition to processing incoming packets, in.routed also periodically checks
89the routing table entries. If an entry has not been updated for 3 minutes, the
90entry's metric is set to infinity and marked for deletion. Deletions are
94delayed until the route has been advertised with an infnite metric to insure
91delayed until the route has been advertised with an infinite metric to insure
95the invalidation is propagated throughout the local internet. This is a form of
96poison reverse.
97.sp
98.LP
99Routes in the kernel table that are added or changed as a result of ICMP
100Redirect messages are deleted after a while to minimize black-holes. When a TCP
101connection suffers a timeout, the kernel tells \fBin.routed\fR, which deletes
102all redirected routes through the gateway involved, advances the age of all RIP

--- 80 unchanged lines hidden (view full) ---

183.LP
184Gateways marked external are also passive, but are not placed in the kernel
185routing table, nor are they included in routing updates. The function of
186external entries is to indicate that another routing process will install such
187a route if necessary, and that other routes to that destination should not be
188installed by \fBin.routed\fR. Such entries are required only when both routers
189might learn of routes to the same destination.
190.SH OPTIONS
92the invalidation is propagated throughout the local internet. This is a form of
93poison reverse.
94.sp
95.LP
96Routes in the kernel table that are added or changed as a result of ICMP
97Redirect messages are deleted after a while to minimize black-holes. When a TCP
98connection suffers a timeout, the kernel tells \fBin.routed\fR, which deletes
99all redirected routes through the gateway involved, advances the age of all RIP

--- 80 unchanged lines hidden (view full) ---

180.LP
181Gateways marked external are also passive, but are not placed in the kernel
182routing table, nor are they included in routing updates. The function of
183external entries is to indicate that another routing process will install such
184a route if necessary, and that other routes to that destination should not be
185installed by \fBin.routed\fR. Such entries are required only when both routers
186might learn of routes to the same destination.
187.SH OPTIONS
191.sp
192.LP
193Listed below are available options. Any other argument supplied is interpreted
194as the name of a file in which the actions of \fBin.routed\fR should be logged.
195It is better to use \fB-T\fR (described below) instead of appending the name of
196the trace file to the command. Associated SMF properties for these options are
197described, and can be set by means of a command of the form:
198.sp
199.in +2
200.nf

--- 221 unchanged lines hidden (view full) ---

422.RS 4n
423Increase the debugging level, which causes more information to be logged on the
424tracefile specified with \fB-T\fR or stdout. The debugging level can be
425increased or decreased with the \fBSIGUSR1\fR or \fBSIGUSR2\fR signals or with
426the \fBrtquery\fR(8) command.
427.RE
428
429.SH FILES
188Listed below are available options. Any other argument supplied is interpreted
189as the name of a file in which the actions of \fBin.routed\fR should be logged.
190It is better to use \fB-T\fR (described below) instead of appending the name of
191the trace file to the command. Associated SMF properties for these options are
192described, and can be set by means of a command of the form:
193.sp
194.in +2
195.nf

--- 221 unchanged lines hidden (view full) ---

417.RS 4n
418Increase the debugging level, which causes more information to be logged on the
419tracefile specified with \fB-T\fR or stdout. The debugging level can be
420increased or decreased with the \fBSIGUSR1\fR or \fBSIGUSR2\fR signals or with
421the \fBrtquery\fR(8) command.
422.RE
423
424.SH FILES
430.sp
431.ne 2
432.na
433\fB\fB/etc/defaultrouter\fR\fR
434.ad
435.RS 22n
436If this file is present and contains the address of a default router, the
437system startup script does not run \fBin.routed\fR. See \fBdefaultrouter\fR(5).
438.RE

--- 4 unchanged lines hidden (view full) ---

443\fB\fB/etc/gateways\fR\fR
444.ad
445.RS 22n
446List of distant gateways and general configuration options for \fBin.routed\fR.
447See \fBgateways\fR(5).
448.RE
449
450.SH SEE ALSO
425.ne 2
426.na
427\fB\fB/etc/defaultrouter\fR\fR
428.ad
429.RS 22n
430If this file is present and contains the address of a default router, the
431system startup script does not run \fBin.routed\fR. See \fBdefaultrouter\fR(5).
432.RE

--- 4 unchanged lines hidden (view full) ---

437\fB\fB/etc/gateways\fR\fR
438.ad
439.RS 22n
440List of distant gateways and general configuration options for \fBin.routed\fR.
441See \fBgateways\fR(5).
442.RE
443
444.SH SEE ALSO
451.sp
452.LP
453.BR ioctl (2),
445.BR ioctl (2),
454.BR inet (3SOCKET),
446.BR inet (3C),
455.BR icmp (4P),
456.BR inet (4P),
457.BR udp (4P),
458.BR defaultrouter (5),
459.BR gateways (5),
460.BR attributes (7),
461.BR route (8),
462.BR routeadm (8),

--- 11 unchanged lines hidden (view full) ---

474\fIRIP-v2 MD5 Authentication (RFC 2082, January 1997)\fR
475.sp
476.LP
477\fIRouting Information Protocol, v1 (RFC 1058, June 1988)\fR
478.sp
479.LP
480\fIICMP Router Discovery Messages (RFC 1256, September 1991)\fR
481.SH NOTES
447.BR icmp (4P),
448.BR inet (4P),
449.BR udp (4P),
450.BR defaultrouter (5),
451.BR gateways (5),
452.BR attributes (7),
453.BR route (8),
454.BR routeadm (8),

--- 11 unchanged lines hidden (view full) ---

466\fIRIP-v2 MD5 Authentication (RFC 2082, January 1997)\fR
467.sp
468.LP
469\fIRouting Information Protocol, v1 (RFC 1058, June 1988)\fR
470.sp
471.LP
472\fIICMP Router Discovery Messages (RFC 1256, September 1991)\fR
473.SH NOTES
482.sp
483.LP
484In keeping with its intended design, this daemon deviates from RFC 2453 in two
485notable ways:
486.RS +4
487.TP
488.ie t \(bu
489.el o
490By default, \fBin.routed\fR does not discard authenticated RIPv2 messages when
491RIP authentication is not configured. There is little to gain from dropping

--- 16 unchanged lines hidden ---
474In keeping with its intended design, this daemon deviates from RFC 2453 in two
475notable ways:
476.RS +4
477.TP
478.ie t \(bu
479.el o
480By default, \fBin.routed\fR does not discard authenticated RIPv2 messages when
481RIP authentication is not configured. There is little to gain from dropping

--- 16 unchanged lines hidden ---