doc/ipv6.texi

   1 @node IPv6 Support
   2 @chapter IPv6 Support
   3
   4 Quagga fully supports IPv6 routing.  As described so far, Quagga supports
   5 RIPng, OSPFv3 and BGP-4+.  You can give IPv6 addresses to an interface
   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
  65 @deffn {Interface Command} {ipv6 nd ra-interval SECONDS} {}
  66 @deffnx {Interface Command} {no ipv6 nd ra-interval} {}
  67 The  maximum  time allowed between sending unsolicited multicast router
  68 advertisements from the interface, in seconds. Must be no less than 3 seconds.
  69
  70 Default: @code{600}
  71 @end deffn
  72
  73 @deffn {Interface Command} {ipv6 nd ra-interval msec MILLISECONDS} {}
  74 @deffnx {Interface Command} {no ipv6 nd ra-interval msec} {}
  75 The  maximum  time allowed between sending unsolicited multicast router
  76 advertisements from the interface, in milliseconds. Must be no less than 30 milliseconds.
  77
  78 Default: @code{600000}
  79 @end deffn
  80 @deffn {Interface Command} {ipv6 nd ra-lifetime SECONDS} {}
  81 @deffnx {Interface Command} {no ipv6 nd ra-lifetime} {}
  82 The value to be placed in the Router Lifetime field of router advertisements
  83 sent from the interface, in seconds. Indicates the usefulness of the router
  84 as a default router on this interface. Setting the value to zero indicates
  85 that the router should not be considered a default router on this interface.
  86 Must be either zero or between value specified with @var{ipv6 nd ra-interval}
  87 (or default) and 9000 seconds.
  88
  89 Default: @code{1800}
  90 @end deffn
  91
  92 @deffn {Interface Command} {ipv6 nd reachable-time MILLISECONDS} {}
  93 @deffnx {Interface Command} {no ipv6 nd reachable-time} {}
  94 The value to be placed in the Reachable Time field in the Router Advertisement
  95 messages sent by the router, in milliseconds. The configured time enables the
  96 router to detect unavailable neighbors. The value zero means unspecified (by
  97 this router). Must be no greater than @code{3,600,000} milliseconds (1 hour).
  98
  99 Default: @code{0}
 100 @end deffn
 101
 102 @deffn {Interface Command} {ipv6 nd managed-config-flag} {}
 103 @deffnx {Interface Command} {no ipv6 nd managed-config-flag} {}
 104 Set/unset flag in IPv6 router advertisements which indicates to hosts that they
 105 should use managed (stateful) protocol for addresses autoconfiguration in
 106 addition to any addresses autoconfigured using stateless address
 107 autoconfiguration.
 108
 109 Default: not set
 110 @end deffn
 111
 112 @deffn {Interface Command} {ipv6 nd other-config-flag} {}
 113 @deffnx {Interface Command} {no ipv6 nd other-config-flag} {}
 114 Set/unset flag in IPv6 router advertisements which indicates to hosts that
 115 they should use administered (stateful) protocol to obtain autoconfiguration
 116 information other than addresses.
 117
 118 Default: not set
 119 @end deffn
 120
 121 @deffn {Interface Command} {ipv6 nd home-agent-config-flag} {}
 122 @deffnx {Interface Command} {no ipv6 nd home-agent-config-flag} {}
 123 Set/unset flag in IPv6 router advertisements which indicates to hosts that
 124 the router acts as a Home Agent and includes a Home Agent Option.
 125
 126 Default: not set
 127 @end deffn
 128
 129 @deffn {Interface Command} {ipv6 nd home-agent-preference} {}
 130 @deffnx {Interface Command} {no ipv6 nd home-agent-preference} {}
 131 The value to be placed in Home Agent Option, when Home Agent config flag is set,
 132 which indicates to hosts Home Agent preference.
 133
 134 Default: 0
 135 @end deffn
 136
 137 @deffn {Interface Command} {ipv6 nd home-agent-lifetime} {}
 138 @deffnx {Interface Command} {no ipv6 nd home-agent-lifetime} {}
 139 The value to be placed in Home Agent Option, when Home Agent config flag is set,
 140 which indicates to hosts Home Agent Lifetime. A value of 0 means to place Router Lifetime value.
 141
 142 Default: 0
 143 @end deffn
 144
 145 @deffn {Interface Command} {ipv6 nd adv-interval-option} {}
 146 @deffnx {Interface Command} {no ipv6 nd adv-interval-option} {}
 147 Include an Advertisement Interval option which indicates to hosts the maximum time,
 148 in milliseconds, between successive unsolicited Router Advertisements.
 149
 150 Default: not set
 151 @end deffn
 152
 153 @deffn {Interface Command} {ipv6 nd router-preference (high|medium|low)} {}
 154 @deffnx {Interface Command} {no ipv6 nd router-preference} {}
 155 Set default router preference in IPv6 router advertisements per RFC4191.
 156
 157 Default: medium
 158 @end deffn
 159
 160 @example
 161 @group
 162 interface eth0
 163  no ipv6 nd suppress-ra
 164  ipv6 nd prefix 2001:0DB8:5009::/64
 165 @end group
 166 @end example
 167
 168 For more information see @cite{RFC2462 (IPv6 Stateless Address Autoconfiguration)}
 169 , @cite{RFC2461 (Neighbor Discovery for IP Version 6 (IPv6))}
 170 , @cite{RFC3775 (Mobility Support in IPv6 (Mobile IPv6))}
 171 and @cite{RFC4191 (Default Router Preferences and More-Specific Routes)}.