]>
Commit | Line | Data |
---|---|---|
76b89b4a | 1 | @node IPv6 Support |
718e3744 | 2 | @chapter IPv6 Support |
3 | ||
438f5286 | 4 | Frr fully supports IPv6 routing. As described so far, Frr supports |
41d9cc6a | 5 | RIPng, OSPFv3, and BGP-4+. You can give IPv6 addresses to an interface |
438f5286 | 6 | and configure static IPv6 routing information. Frr IPv6 also provides |
718e3744 | 7 | automatic address configuration via a feature called @code{address |
8 | auto configuration}. To do it, the router must send router advertisement | |
9 | messages to the all nodes that exist on the network. | |
10 | ||
438f5286 | 11 | Previous versions of Frr could be built without IPv6 support. This is |
9b7f18cf DL |
12 | no longer possible. |
13 | ||
718e3744 | 14 | @menu |
15 | * Router Advertisement:: | |
16 | @end menu | |
17 | ||
76b89b4a | 18 | @node Router Advertisement |
718e3744 | 19 | @section Router Advertisement |
20 | ||
a2c0a57b | 21 | @deffn {Interface Command} {no ipv6 nd suppress-ra} {} |
3e31cded | 22 | Send router advertisment messages. |
718e3744 | 23 | @end deffn |
24 | ||
a2c0a57b | 25 | @deffn {Interface Command} {ipv6 nd suppress-ra} {} |
3e31cded | 26 | Don't send router advertisment messages. |
27 | @end deffn | |
28 | ||
29c4c9bd | 29 | @deffn {Interface Command} {ipv6 nd prefix @var{ipv6prefix} [@var{valid-lifetime}] [@var{preferred-lifetime}] [off-link] [no-autoconfig] [router-address]} {} |
3e31cded | 30 | Configuring the IPv6 prefix to include in router advertisements. Several prefix |
31 | specific optional parameters and flags may follow: | |
32 | @itemize @bullet | |
33 | @item | |
34 | @var{valid-lifetime} - the length of time in seconds during what the prefix is | |
35 | valid for the purpose of on-link determination. Value @var{infinite} represents | |
36 | infinity (i.e. a value of all one bits (@code{0xffffffff})). | |
37 | ||
38 | Range: @code{<0-4294967295>} Default: @code{2592000} | |
39 | ||
40 | @item | |
41 | @var{preferred-lifetime} - the length of time in seconds during what addresses | |
42 | generated from the prefix remain preferred. Value @var{infinite} represents | |
43 | infinity. | |
44 | ||
45 | Range: @code{<0-4294967295>} Default: @code{604800} | |
46 | ||
47 | @item | |
48 | @var{off-link} - indicates that advertisement makes no statement about on-link or | |
49 | off-link properties of the prefix. | |
50 | ||
51 | Default: not set, i.e. this prefix can be used for on-link determination. | |
52 | ||
53 | @item | |
54 | @var{no-autoconfig} - indicates to hosts on the local link that the specified prefix | |
55 | cannot be used for IPv6 autoconfiguration. | |
56 | ||
57 | Default: not set, i.e. prefix can be used for autoconfiguration. | |
29c4c9bd | 58 | |
59 | @item | |
60 | @var{router-address} - indicates to hosts on the local link that the specified | |
61 | prefix | |
62 | contains a complete IP address by setting R flag. | |
63 | ||
64 | Default: not set, i.e. hosts do not assume a complete IP address is placed. | |
3e31cded | 65 | @end itemize |
66 | @end deffn | |
67 | ||
4afa50b3 DO |
68 | @deffn {Interface Command} {ipv6 nd ra-interval <1-1800>} {} |
69 | @deffnx {Interface Command} {no ipv6 nd ra-interval [<1-1800>]} {} | |
3e31cded | 70 | The maximum time allowed between sending unsolicited multicast router |
4afa50b3 | 71 | advertisements from the interface, in seconds. |
3e31cded | 72 | |
73 | Default: @code{600} | |
74 | @end deffn | |
75 | ||
4afa50b3 DO |
76 | @deffn {Interface Command} {ipv6 nd ra-interval msec <70-1800000>} {} |
77 | @deffnx {Interface Command} {no ipv6 nd ra-interval [msec <70-1800000>]} {} | |
29c4c9bd | 78 | The maximum time allowed between sending unsolicited multicast router |
4afa50b3 | 79 | advertisements from the interface, in milliseconds. |
29c4c9bd | 80 | |
81 | Default: @code{600000} | |
82 | @end deffn | |
4afa50b3 DO |
83 | |
84 | @deffn {Interface Command} {ipv6 nd ra-lifetime <0-9000>} {} | |
85 | @deffnx {Interface Command} {no ipv6 nd ra-lifetime [<0-9000>]} {} | |
3e31cded | 86 | The value to be placed in the Router Lifetime field of router advertisements |
87 | sent from the interface, in seconds. Indicates the usefulness of the router | |
88 | as a default router on this interface. Setting the value to zero indicates | |
89 | that the router should not be considered a default router on this interface. | |
90 | Must be either zero or between value specified with @var{ipv6 nd ra-interval} | |
91 | (or default) and 9000 seconds. | |
92 | ||
93 | Default: @code{1800} | |
94 | @end deffn | |
95 | ||
4afa50b3 DO |
96 | @deffn {Interface Command} {ipv6 nd reachable-time <1-3600000>} {} |
97 | @deffnx {Interface Command} {no ipv6 nd reachable-time [<1-3600000>]} {} | |
3e31cded | 98 | The value to be placed in the Reachable Time field in the Router Advertisement |
99 | messages sent by the router, in milliseconds. The configured time enables the | |
100 | router to detect unavailable neighbors. The value zero means unspecified (by | |
4afa50b3 | 101 | this router). |
3e31cded | 102 | |
103 | Default: @code{0} | |
104 | @end deffn | |
105 | ||
106 | @deffn {Interface Command} {ipv6 nd managed-config-flag} {} | |
107 | @deffnx {Interface Command} {no ipv6 nd managed-config-flag} {} | |
108 | Set/unset flag in IPv6 router advertisements which indicates to hosts that they | |
109 | should use managed (stateful) protocol for addresses autoconfiguration in | |
110 | addition to any addresses autoconfigured using stateless address | |
111 | autoconfiguration. | |
112 | ||
113 | Default: not set | |
114 | @end deffn | |
115 | ||
116 | @deffn {Interface Command} {ipv6 nd other-config-flag} {} | |
117 | @deffnx {Interface Command} {no ipv6 nd other-config-flag} {} | |
118 | Set/unset flag in IPv6 router advertisements which indicates to hosts that | |
119 | they should use administered (stateful) protocol to obtain autoconfiguration | |
120 | information other than addresses. | |
121 | ||
122 | Default: not set | |
718e3744 | 123 | @end deffn |
124 | ||
29c4c9bd | 125 | @deffn {Interface Command} {ipv6 nd home-agent-config-flag} {} |
126 | @deffnx {Interface Command} {no ipv6 nd home-agent-config-flag} {} | |
127 | Set/unset flag in IPv6 router advertisements which indicates to hosts that | |
128 | the router acts as a Home Agent and includes a Home Agent Option. | |
129 | ||
130 | Default: not set | |
131 | @end deffn | |
132 | ||
4afa50b3 DO |
133 | @deffn {Interface Command} {ipv6 nd home-agent-preference <0-65535>} {} |
134 | @deffnx {Interface Command} {no ipv6 nd home-agent-preference [<0-65535>]} {} | |
29c4c9bd | 135 | The value to be placed in Home Agent Option, when Home Agent config flag is set, |
4afa50b3 DO |
136 | which indicates to hosts Home Agent preference. The default value of 0 stands |
137 | for the lowest preference possible. | |
29c4c9bd | 138 | |
139 | Default: 0 | |
140 | @end deffn | |
141 | ||
b58c9080 TT |
142 | @deffn {Interface Command} {ipv6 nd home-agent-lifetime <0-65520>} {} |
143 | @deffnx {Interface Command} {no ipv6 nd home-agent-lifetime [<0-65520>]} {} | |
29c4c9bd | 144 | The value to be placed in Home Agent Option, when Home Agent config flag is set, |
4afa50b3 DO |
145 | which indicates to hosts Home Agent Lifetime. The default value of 0 means to |
146 | place the current Router Lifetime value. | |
29c4c9bd | 147 | |
148 | Default: 0 | |
149 | @end deffn | |
150 | ||
151 | @deffn {Interface Command} {ipv6 nd adv-interval-option} {} | |
152 | @deffnx {Interface Command} {no ipv6 nd adv-interval-option} {} | |
153 | Include an Advertisement Interval option which indicates to hosts the maximum time, | |
154 | in milliseconds, between successive unsolicited Router Advertisements. | |
155 | ||
156 | Default: not set | |
157 | @end deffn | |
158 | ||
b60668d0 | 159 | @deffn {Interface Command} {ipv6 nd router-preference (high|medium|low)} {} |
4afa50b3 | 160 | @deffnx {Interface Command} {no ipv6 nd router-preference [(high|medium|low)]} {} |
b60668d0 CC |
161 | Set default router preference in IPv6 router advertisements per RFC4191. |
162 | ||
163 | Default: medium | |
164 | @end deffn | |
165 | ||
6ae93c05 DO |
166 | @deffn {Interface Command} {ipv6 nd mtu <1-65535>} {} |
167 | @deffnx {Interface Command} {no ipv6 nd mtu [<1-65535>]} {} | |
168 | Include an MTU (type 5) option in each RA packet to assist the attached hosts | |
169 | in proper interface configuration. The announced value is not verified to be | |
170 | consistent with router interface MTU. | |
171 | ||
172 | Default: don't advertise any MTU option | |
173 | @end deffn | |
174 | ||
718e3744 | 175 | @example |
176 | @group | |
177 | interface eth0 | |
a2c0a57b | 178 | no ipv6 nd suppress-ra |
3e31cded | 179 | ipv6 nd prefix 2001:0DB8:5009::/64 |
718e3744 | 180 | @end group |
181 | @end example | |
3e31cded | 182 | |
183 | For more information see @cite{RFC2462 (IPv6 Stateless Address Autoconfiguration)} | |
6eb0c5ab DO |
184 | , @cite{RFC4861 (Neighbor Discovery for IP Version 6 (IPv6))} |
185 | , @cite{RFC6275 (Mobility Support in IPv6)} | |
b60668d0 | 186 | and @cite{RFC4191 (Default Router Preferences and More-Specific Routes)}. |