1RDISC6(8) System Manager's Manual RDISC6(8)
2
3
4
6 rdisc - ICMPv6 Router Discovery tool
7
9 rdisc6 [-qv] [-r attempts] [-s source_ip] [-w wait_ms] [IPv6 address]
10 <iface>
11
12
14 RDisc6 is an Unix program which implements the ICMPv6 Router Discovery
15 in userland (it is normally done by the kernel). It is used to lookup
16 the list of on-link routers and IPv6 prefixes.
17
18 It can also be used to force the kernel to update the state of a given
19 IPv6-autoconfigured network interface.
20
21 The name of the network interface to probe routers for must be speci‐
22 fied.
23
24
26 -1 or --single
27 Exit as soon as the first advertisement is received.
28
29
30 -h or --help
31 Display some help and exit.
32
33
34 -m or --multiple
35 Wait for possible multiple advertisements and print all of them
36 (default).
37
38
39 -n or --numeric
40 If the optional parameter is not a valid IPv6 address, do not
41 try to resolve it as a DNS hostname.
42
43
44 -q or --quiet
45 Only display advertised IPv6 prefixes. Display nothing in case
46 of failure. That is mostly useful when calling the program from
47 a shell script.
48
49
50 -r attempts or --retry attempts
51 Send ICMPv6 Router Discovery that many times until a reply is
52 received, or abort. By default, rdisc6 will try 3 times before
53 aborting (MAX_RTR_SOLICITATIONS from RFC2461).
54
55
56 -s source_ip or --source source_ip
57 Specify the IPv6 address to be used as the source for the router
58 solicitation packets.
59
60
61 -V or --version
62 Display program version and license and exit.
63
64
65 -v or --verbose
66 Display verbose information. That is the default.
67
68
69 -w wait_ms or --wait wait_ms
70 Wait wait_ms milliseconds for a response before retrying. By
71 default, rdisc6 waits 4 second between each attempts (RTR_SOLIC‐
72 ITATION_INTERVAL from RFC2461).
73
74
75 If rdisc6 does not receive any response after the specified number of
76 attempts waiting for wait_ms milliseconds each time, it will exit with
77 code 2. On error, it exits with code 1. Otherwise it exits with code
78 0.
79
80
82 rdisc6 must be setuid root to allow use by non privileged users. It
83 will drop its root privileges before any attempt is made to send or
84 receive data from the network to reduce the possible impact of a secu‐
85 rity vulnerability.
86
87
89 ndisc6(8), ipv6(7)
90
91
93 Rémi Denis-Courmont <remi at remlab dot net>
94
95 http://www.remlab.net/ndisc6/
96
97
98
99rdisc6 $Date$ RDISC6(8)