1in.rdisc(1M)            System Administration Commands            in.rdisc(1M)
2
3
4

NAME

6       in.rdisc, rdisc - network router discovery daemon
7

SYNOPSIS

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

DESCRIPTION

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

OPTIONS

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

ATTRIBUTES

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

SEE ALSO

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)
Impressum