doc/user/ipv6.rst

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