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