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>