blob: c740234e3f19bb5d337a4ba36b631f3ee8ee4b11 [file] [log] [blame]
paul76b89b42004-11-06 17:13:09 +00001@node IPv6 Support
paul718e3742002-12-13 20:15:29 +00002@chapter IPv6 Support
3
paul7190f4e2003-08-12 12:40:20 +00004Quagga fully supports IPv6 routing. As described so far, Quagga supports
paul718e3742002-12-13 20:15:29 +00005RIPng, OSPFv3 and BGP-4+. You can give IPv6 addresses to an interface
hasso3e31cde2004-05-18 11:58:59 +00006and configure static IPv6 routing information. Quagga IPv6 also provides
paul718e3742002-12-13 20:15:29 +00007automatic address configuration via a feature called @code{address
8auto configuration}. To do it, the router must send router advertisement
9messages to the all nodes that exist on the network.
10
11@menu
12* Router Advertisement::
13@end menu
14
paul76b89b42004-11-06 17:13:09 +000015@node Router Advertisement
paul718e3742002-12-13 20:15:29 +000016@section Router Advertisement
17
gdta2c0a572004-11-05 12:59:21 +000018@deffn {Interface Command} {no ipv6 nd suppress-ra} {}
hasso3e31cde2004-05-18 11:58:59 +000019Send router advertisment messages.
paul718e3742002-12-13 20:15:29 +000020@end deffn
21
gdta2c0a572004-11-05 12:59:21 +000022@deffn {Interface Command} {ipv6 nd suppress-ra} {}
hasso3e31cde2004-05-18 11:58:59 +000023Don't send router advertisment messages.
24@end deffn
25
26@deffn {Interface Command} {ipv6 nd prefix @var{ipv6prefix} [@var{valid-lifetime}] [@var{preferred-lifetime}] [off-link] [no-autconfig]} {}
27Configuring the IPv6 prefix to include in router advertisements. Several prefix
28specific optional parameters and flags may follow:
29@itemize @bullet
30@item
31@var{valid-lifetime} - the length of time in seconds during what the prefix is
32valid for the purpose of on-link determination. Value @var{infinite} represents
33infinity (i.e. a value of all one bits (@code{0xffffffff})).
34
35Range: @code{<0-4294967295>} Default: @code{2592000}
36
37@item
38@var{preferred-lifetime} - the length of time in seconds during what addresses
39generated from the prefix remain preferred. Value @var{infinite} represents
40infinity.
41
42Range: @code{<0-4294967295>} Default: @code{604800}
43
44@item
45@var{off-link} - indicates that advertisement makes no statement about on-link or
46off-link properties of the prefix.
47
48Default: not set, i.e. this prefix can be used for on-link determination.
49
50@item
51@var{no-autoconfig} - indicates to hosts on the local link that the specified prefix
52cannot be used for IPv6 autoconfiguration.
53
54Default: not set, i.e. prefix can be used for autoconfiguration.
55@end itemize
56@end deffn
57
58@deffn {Interface Command} {ipv6 nd ra-interval SECONDS} {}
59@deffnx {Interface Command} {no ipv6 nd ra-interval} {}
60The maximum time allowed between sending unsolicited multicast router
61advertisements from the interface, in seconds. Must be no less than 3 seconds.
62
63Default: @code{600}
64@end deffn
65
66@deffn {Interface Command} {ipv6 nd ra-lifetime SECONDS} {}
67@deffnx {Interface Command} {no ipv6 nd ra-lifetime} {}
68The value to be placed in the Router Lifetime field of router advertisements
69sent from the interface, in seconds. Indicates the usefulness of the router
70as a default router on this interface. Setting the value to zero indicates
71that the router should not be considered a default router on this interface.
72Must be either zero or between value specified with @var{ipv6 nd ra-interval}
73(or default) and 9000 seconds.
74
75Default: @code{1800}
76@end deffn
77
78@deffn {Interface Command} {ipv6 nd reachable-time MILLISECONDS} {}
79@deffnx {Interface Command} {no ipv6 nd reachable-time} {}
80The value to be placed in the Reachable Time field in the Router Advertisement
81messages sent by the router, in milliseconds. The configured time enables the
82router to detect unavailable neighbors. The value zero means unspecified (by
83this router). Must be no greater than @code{3,600,000} milliseconds (1 hour).
84
85Default: @code{0}
86@end deffn
87
88@deffn {Interface Command} {ipv6 nd managed-config-flag} {}
89@deffnx {Interface Command} {no ipv6 nd managed-config-flag} {}
90Set/unset flag in IPv6 router advertisements which indicates to hosts that they
91should use managed (stateful) protocol for addresses autoconfiguration in
92addition to any addresses autoconfigured using stateless address
93autoconfiguration.
94
95Default: not set
96@end deffn
97
98@deffn {Interface Command} {ipv6 nd other-config-flag} {}
99@deffnx {Interface Command} {no ipv6 nd other-config-flag} {}
100Set/unset flag in IPv6 router advertisements which indicates to hosts that
101they should use administered (stateful) protocol to obtain autoconfiguration
102information other than addresses.
103
104Default: not set
paul718e3742002-12-13 20:15:29 +0000105@end deffn
106
107@example
108@group
109interface eth0
gdta2c0a572004-11-05 12:59:21 +0000110 no ipv6 nd suppress-ra
hasso3e31cde2004-05-18 11:58:59 +0000111 ipv6 nd prefix 2001:0DB8:5009::/64
paul718e3742002-12-13 20:15:29 +0000112@end group
113@end example
hasso3e31cde2004-05-18 11:58:59 +0000114
115For more information see @cite{RFC2462 (IPv6 Stateless Address Autoconfiguration)}
116and @cite{RFC2461 (Neighbor Discovery for IP Version 6 (IPv6))}.