1in.rdisc(1M) System Administration Commands in.rdisc(1M)
2
3
4
6 in.rdisc, rdisc - network router discovery daemon
7
9 /usr/sbin/in.rdisc [-a] [-f] [-s] [send-address] [receive-address]
10
11
12 /usr/sbin/in.rdisc -r [-p preference] [-T interval]
13 [send-address] [receive-address]
14
15
17 in.rdisc remains part of the software distribution of the Solaris Oper‐
18 ating Environment. It is, however, not used by default. in.routed(1M)
19 includes the functionality provided by in.rdisc. See routeadm(1M) for
20 details of how to specify the IPV4 routing daemon.
21
22
23 in.rdisc implements the ICMP router discovery protocol. The first form
24 of the command is used on hosts and the second form is used on routers.
25
26
27 in.rdisc can be invoked in either the first form (host mode) or second
28 form (router mode).
29
30
31 On a host, in.rdisc populates the network routing tables with default
32 routes. On a router, advertises the router to all the hosts.
33
34
35 in.rdisc is managed by the service management facility (SMF), by means
36 of the service identifier:
37
38 svc:/network/routing/rdisc:default
39
40
41
42 Host (First Form)
43 On a host, in.rdisc listens on the ALL_HOSTS (224.0.0.1) multicast
44 address for ROUTER_ADVERTISE messages from routers. The received mes‐
45 sages are handled by first ignoring those listed router addresses with
46 which the host does not share a network. Among the remaining addresses,
47 the ones with the highest preference are selected as default routers
48 and a default route is entered in the kernel routing table for each one
49 of them.
50
51
52 Optionally, in.rdisc can avoid waiting for routers to announce them‐
53 selves by sending out a few ROUTER_SOLICITATION messages to the
54 ALL_ROUTERS (224.0.0.2) multicast address when it is started.
55
56
57 A timer is associated with each router address. The address will no
58 longer be considered for inclusion in the routing tables if the timer
59 expires before a new advertise message is received from the router. The
60 address will also be excluded from consideration if the host receives
61 an advertise message with the preference being maximally negative or
62 with a lifetime of zero.
63
64 Router (Second Form)
65 When in.rdisc is started on a router, it uses the SIOCGIFCONF ioctl(2)
66 to find the interfaces configured into the system and it starts listen‐
67 ing on the ALL_ROUTERS multicast address on all the interfaces that
68 support multicast. It sends out advertise messages to the ALL_HOSTS
69 multicast address advertising all its IP addresses. A few initial
70 advertise messages are sent out during the first 30 seconds and after
71 that it will transmit advertise messages approximately every 600 sec‐
72 onds.
73
74
75 When in.rdisc receives a solicitation message, it sends an advertise
76 message to the host that sent the solicitation message.
77
78
79 When in.rdisc is terminated by a signal, it sends out an advertise mes‐
80 sage with the preference being maximally negative.
81
83 Supported options and equivalent SMF service properties are listed
84 below. SMF service properties are set using a command of the form:
85
86 # routeadm -m rdisc:default key=value
87
88
89
90 -a Accept all routers independent of the preference they
91 have in their advertise messages. Normally, in.rdisc
92 only accepts (and enters in the kernel routing tables)
93 the router or routers with the highest preference. Use
94 of this option is equivalent to setting the accept_all
95 property to true.
96
97
98 -f Run in.rdisc forever even if no routers are found.
99 Normally, in.rdisc gives up if it has not received any
100 advertise message after soliciting three times, in
101 which case it exits with a non-zero exit code. If -f
102 is not specified in the first form then -s must be
103 specified. For SMF execution, this option is required.
104
105
106 -r Act as a router, rather than a host. Use of this
107 option is equivalent to setting the act_as_router
108 property to true.
109
110
111 -s Send three solicitation messages initially to quickly
112 discover the routers when the system is booted. When
113 -s is specified, in.rdisc exits with a non-zero exit
114 code if it can not find any routers. This can be over‐
115 ridden with the -f option. This option is not compati‐
116 ble with SMF execution and is not supported for the
117 rdisc service.
118
119
120 -p preference Set the preference transmitted in the solicitation
121 messages. The default is zero. Use of this option is
122 equivalent to setting the preference property.
123
124
125 -T interval Set the interval between transmitting the advertise
126 messages. The default time is 600 seconds. Use of this
127 option is equivalent to setting the transmit_interval
128 property.
129
130
131
132 The send-address and receive-address daemon options can be set by
133 means of the send_address and receive_address properties.
134
136 See attributes(5) for descriptions of the following attributes:
137
138
139
140
141 ┌─────────────────────────────┬─────────────────────────────┐
142 │ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
143 ├─────────────────────────────┼─────────────────────────────┤
144 │Availability │SUNWroute │
145 └─────────────────────────────┴─────────────────────────────┘
146
148 in.routed(1M), routeadm(1M), svcadm(1M), ioctl(2), gateways(4),
149 attributes(5), smf(5), icmp(7P), inet(7P)
150
151
152 Deering, S.E., editor, ICMP Router Discovery Messages, RFC 1256, Net‐
153 work Information Center, SRI International, Menlo Park, California,
154 September 1991.
155
156
157
158SunOS 5.11 9 Nov 2006 in.rdisc(1M)