1RDISC6(8)                   System Manager's Manual                  RDISC6(8)
2
3
4

NAME

6       rdisc - ICMPv6 Router Discovery tool
7

SYNOPSIS

9       rdisc6  [-qv]  [-r attempts] [-s source_ip] [-w wait_ms] [IPv6 address]
10       <iface>
11
12

DESCRIPTON

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

OPTIONS

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

SECURITY

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

SEE ALSO

89       ndisc6(8), ipv6(7)
90
91

AUTHOR

93       Rémi Denis-Courmont <remi at remlab dot net>
94
95       http://www.remlab.net/ndisc6/
96
97
98
99rdisc6                              $Date$                           RDISC6(8)