File:  [ELWIX - Embedded LightWeight unIX -] / embedaddon / quagga / doc / ipv6.texi
Revision 1.1.1.3 (vendor branch): download - view: text, annotated - select for diffs - revision graph
Wed Nov 2 10:09:11 2016 UTC (7 years, 8 months ago) by misho
Branches: quagga, MAIN
CVS tags: v1_0_20160315, HEAD
quagga 1.0.20160315

    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 <1-1800>} {}
   66: @deffnx {Interface Command} {no ipv6 nd ra-interval [<1-1800>]} {}
   67: The  maximum  time allowed between sending unsolicited multicast router
   68: advertisements from the interface, in seconds.
   69: 
   70: Default: @code{600}
   71: @end deffn
   72: 
   73: @deffn {Interface Command} {ipv6 nd ra-interval msec <70-1800000>} {}
   74: @deffnx {Interface Command} {no ipv6 nd ra-interval [msec <70-1800000>]} {}
   75: The  maximum  time allowed between sending unsolicited multicast router
   76: advertisements from the interface, in milliseconds.
   77: 
   78: Default: @code{600000}
   79: @end deffn
   80: 
   81: @deffn {Interface Command} {ipv6 nd ra-lifetime <0-9000>} {}
   82: @deffnx {Interface Command} {no ipv6 nd ra-lifetime [<0-9000>]} {}
   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: 
   93: @deffn {Interface Command} {ipv6 nd reachable-time <1-3600000>} {}
   94: @deffnx {Interface Command} {no ipv6 nd reachable-time [<1-3600000>]} {}
   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
   98: this router).
   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: 
  130: @deffn {Interface Command} {ipv6 nd home-agent-preference <0-65535>} {}
  131: @deffnx {Interface Command} {no ipv6 nd home-agent-preference [<0-65535>]} {}
  132: The value to be placed in Home Agent Option, when Home Agent config flag is set, 
  133: which indicates to hosts Home Agent preference. The default value of 0 stands
  134: for the lowest preference possible.
  135: 
  136: Default: 0
  137: @end deffn
  138: 
  139: @deffn {Interface Command} {ipv6 nd home-agent-lifetime <0-65520>} {}
  140: @deffnx {Interface Command} {no ipv6 nd home-agent-lifetime [<0-65520>]} {}
  141: The value to be placed in Home Agent Option, when Home Agent config flag is set, 
  142: which indicates to hosts Home Agent Lifetime. The default value of 0 means to
  143: place the current Router Lifetime value.
  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)} {}
  157: @deffnx {Interface Command} {no ipv6 nd router-preference [(high|medium|low)]} {}
  158: Set default router preference in IPv6 router advertisements per RFC4191.
  159: 
  160: Default: medium
  161: @end deffn
  162: 
  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: 
  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)}
  181: , @cite{RFC4861 (Neighbor Discovery for IP Version 6 (IPv6))}
  182: , @cite{RFC6275 (Mobility Support in IPv6)}
  183: and @cite{RFC4191 (Default Router Preferences and More-Specific Routes)}.

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>