doc/ipv6.texi

   1 @node IPv6 Support
   2 @chapter IPv6 Support
   3
   4 Frr fully supports IPv6 routing.  As described so far, Frr supports
   5 RIPng, OSPFv3, and BGP-4+.  You can give IPv6 addresses to an interface
   6 and configure static IPv6 routing information.  Frr 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 Previous versions of Frr could be built without IPv6 support.  This is
  12 no longer possible.
  13
  14 @menu
  15 * Router Advertisement::
  16 @end menu
  17
  18 @node Router Advertisement
  19 @section Router Advertisement
  20
  21 @deffn {Interface Command} {no ipv6 nd suppress-ra} {}
  22 Send router advertisment messages.
  23 @end deffn
  24
  25 @deffn {Interface Command} {ipv6 nd suppress-ra} {}
  26 Don't send router advertisment messages.
  27 @end deffn
  28
  29 @deffn {Interface Command} {ipv6 nd prefix @var{ipv6prefix} [@var{valid-lifetime}] [@var{preferred-lifetime}] [off-link] [no-autoconfig] [router-address]} {}
  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.
  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.
  65 @end itemize
  66 @end deffn
  67
  68 @deffn {Interface Command} {ipv6 nd ra-interval <1-1800>} {}
  69 @deffnx {Interface Command} {no ipv6 nd ra-interval [<1-1800>]} {}
  70 The  maximum  time allowed between sending unsolicited multicast router
  71 advertisements from the interface, in seconds.
  72
  73 Default: @code{600}
  74 @end deffn
  75
  76 @deffn {Interface Command} {ipv6 nd ra-interval msec <70-1800000>} {}
  77 @deffnx {Interface Command} {no ipv6 nd ra-interval [msec <70-1800000>]} {}
  78 The  maximum  time allowed between sending unsolicited multicast router
  79 advertisements from the interface, in milliseconds.
  80
  81 Default: @code{600000}
  82 @end deffn
  83
  84 @deffn {Interface Command} {ipv6 nd ra-lifetime <0-9000>} {}
  85 @deffnx {Interface Command} {no ipv6 nd ra-lifetime [<0-9000>]} {}
  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
  96 @deffn {Interface Command} {ipv6 nd reachable-time <1-3600000>} {}
  97 @deffnx {Interface Command} {no ipv6 nd reachable-time [<1-3600000>]} {}
  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
 101 this router).
 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
 123 @end deffn
 124
 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
 133 @deffn {Interface Command} {ipv6 nd home-agent-preference <0-65535>} {}
 134 @deffnx {Interface Command} {no ipv6 nd home-agent-preference [<0-65535>]} {}
 135 The value to be placed in Home Agent Option, when Home Agent config flag is set,
 136 which indicates to hosts Home Agent preference. The default value of 0 stands
 137 for the lowest preference possible.
 138
 139 Default: 0
 140 @end deffn
 141
 142 @deffn {Interface Command} {ipv6 nd home-agent-lifetime <0-65520>} {}
 143 @deffnx {Interface Command} {no ipv6 nd home-agent-lifetime [<0-65520>]} {}
 144 The value to be placed in Home Agent Option, when Home Agent config flag is set,
 145 which indicates to hosts Home Agent Lifetime. The default value of 0 means to
 146 place the current Router Lifetime value.
 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
 159 @deffn {Interface Command} {ipv6 nd router-preference (high|medium|low)} {}
 160 @deffnx {Interface Command} {no ipv6 nd router-preference [(high|medium|low)]} {}
 161 Set default router preference in IPv6 router advertisements per RFC4191.
 162
 163 Default: medium
 164 @end deffn
 165
 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
 175 @example
 176 @group
 177 interface eth0
 178  no ipv6 nd suppress-ra
 179  ipv6 nd prefix 2001:0DB8:5009::/64
 180 @end group
 181 @end example
 182
 183 For more information see @cite{RFC2462 (IPv6 Stateless Address Autoconfiguration)}
 184 , @cite{RFC4861 (Neighbor Discovery for IP Version 6 (IPv6))}
 185 , @cite{RFC6275 (Mobility Support in IPv6)}
 186 and @cite{RFC4191 (Default Router Preferences and More-Specific Routes)}.