Vyatta Network OS Documentation

Learn how to install, configure and operate the Vyatta NOS, which helps drive our virtual networking & physical platforms portfolio.

interfaces tunnel <tunx> ipv6 router-advert <action>

Specifies router advertisements (RAs) to be sent from a tunnel interface.

set interfaces tunnel tunx ipv6 router-advert [ cur-hop-limit limit ] [ default-lifetime lifetime ] [ default-preference preference ] [ link-mtu mtu ] [ managed-flag state ] [ max-interval interval ] [ min-interval interval ] [ other-config-flag state ] [ prefix ipv6net [ autonomous-flag state | on-link-flag state | preferred-lifetime lifetime | valid-lifetime lifetime ] ] [ reachable-time time ] [ retrans-timer time ] [ send-advert state ]
delete interfaces tunnel tunx ipv6 router-advert [ cur-hop-limit ] [ default-lifetime ] [ default-preference ] [ link-mtu ] [ managed-flag ] [ max-interval ] [ min-interval ] [ other-config-flag ] [ prefix ipv6net [ autonomous-flag | on-link-flag | preferred-lifetime | valid-lifetime ] ] [ reachable-time ] [ retrans-timer ] [ send-advert ]
show interfaces tunnel tunx ipv6 router-advert

Router advertisements are not sent on an interface.

tunx
The identifier of a tunnel interface. The identifier ranges from tun0 through tunx, where x is a nonnegative integer.
cur-hop-limit limit
Limits the Hop Count field of the IP header for outgoing (unicast) IP packets. This limit is placed in the Hop Count field. The limit ranges from 0 through 255. The default limit is 64. A limit of 0 means that the limit is unspecified by the router.
default-lifetime lifetime
Specifies the lifetime, in seconds, associated with the default router. The lifetime either is 0, which indicates that the router is not a default router, or ranges from the interval specified in the max-interval argument through 9000 (18.2 hours). If not entered, the lifetime is three times the interval specified in the max-interval argument.
default-preference preference
Specifies the preference associated with the default router. The preference is one of the following:

low: Makes the default router low preference.

medium: Makes the default router medium preference.

high: Makes the default router high preference.

The default preference is medium.

link-mtu mtu
Specifies the MTU to be advertised for the link. The MTU either is 0 or ranges from 1280 through the maximum MTU for the type of link, as defined in RFC 2464. The default MTU is 0, which means the MTU is not specified in the router advertisement message. That is because it is expected that the MTU is configured directly on the interface itself and not for routing advertisements. You can configure this option in cases where the link MTU is not well known.

If the MTU entered here does not match the MTU configured on the interface, the system issues a warning but does not fail.

managed-flag state
Specifies whether to use the administered protocol for address autoconfiguration. The state is either of the following:

true: Specifies that hosts use the administered (stateful) protocol for address autoconfiguration in addition to any addresses autoconfigured using stateless address autoconfiguration.

false: Specifies that hosts use only stateless address autoconfiguration.

The default state is false.

max-interval interval
Specifies the maximum time, in seconds, allowed between sending unsolicited multicast router advertisements from the interface. The interval ranges from 4 through 1800. The default interval is 600 (10 minutes).
min-interval interval
Specifies the minimum time, in seconds, allowed between sending unsolicited multicast router advertisements from the interface. The interval ranges from 3 through 0.75 times the interval specified in the max-interval argument. The default interval is 0.33 times the interval specified in the max-interval argument.
other-config-flag state
Specifes that the interface uses the administered (stateful) protocol for autoconfiguration of nonaddress information, as defined in RFC 4862. The state is either of the following:

true: Specifies that hosts use the administered protocol for autoconfiguration of nonaddress information.

false: Specifies that hosts use stateless autoconfiguration of nonaddress information.

The default state is false.

prefix ipv6net
Multi-node. Specifies an IPv6 prefix, in the format ipv6-address/prefix, to be advertised on the IPv6 interface.

You can define more than one IPv6 prefix by configuring multiple prefix configuration nodes.

autonomous-flag state
Specifies whether the IPv6 prefix can be used for autonomous address configuration as defined in RFC 4862. The state is either of the following:

true: Specifies that the prefix can be used for autonomous address configuration.

false: Specifies that the prefix cannot be used for autonomous address configuration.

The default state is true.

on-link-flag state
Specifies whether the IPv6 prefix can be used for on-link determination, as defined in RFC 4862. The state is either of the following:

true: Specifies that the prefix can be used for on-link determination.

false: Specifies that the advertisement makes no statement about on-link or off-link properties of the prefix. For instance, the prefix might be used for address configuration with some addresses belonging to the prefix being on-link and others being off-link.

The default state is true.

preferred-lifetime lifetime
Specifies the lifetime, in seconds, that the addresses generated from the IPv6 prefix through Stateless Address Autoconfiguration (SLAAC) is to remain preferred, as defined in RFC 4862. The lifetime is with respect to the time the packet is sent. The lifetime ranges from 1 through 4294967296 plus the infinity keyword, which represents forever. (The actual value of infinity is a byte in which all bits are set to 1s: 0XFFFFFFFF.) The default lifetime is 604800 (7 days).
valid-lifetime lifetime
Specifies the lifetime, in seconds, that the IPv6 prefix is valid for the purpose of on-link determination, as defined in RFC 4862. The lifetime is with respect to the time the packet is sent. The lifetime ranges from 1 through 4294967296 plus the infinity keyword, which represents forever. (The actual value of infinity is a byte in which all bits are set to 1s: 0XFFFFFFFF.) The default lifetime is 2592000 (30 days).
reachable-time time
Specifies the length of time, in milliseconds, for which the system assumes a neighbor is reachable after having received a reachability confirmation. This time is used by address resolution and the Neighbor Unreachability Detection algorithm (see Section 7.3 of RFC 2461). The time ranges from 0 through 3600000, where 0 means the reachable time is not specified in the router advertisement message. The default time is 0.
retrans-timer time
Specifies the length of time, in milliseconds, between retransmitted NS messages. This time is used by address resolution and the Neighbor Unreachability Detection algorithm (see Sections 7.2 and 7.3 of RFC 2461). The time ranges from 0 through 4294967295, where 0 means the retransmit time is not specified in the router advertisement message. The default time is 0.
send-advert state
Specifies whether router advertisements are to be sent from this interface. The state is either of the following:

true: Sends router advertisements from this interface.

false: Does not send router advertisements from this interface. If this state is in effect, parameters in this configuration subtree are still used to configure the local implementation parameters.

The default state is true.

Configuration mode


interfaces {
	tunnel tunx {
		ipv6 {
			router-advert {
				cur-hop-limit limit
				default-lifetime lifetime
				default-preference preference
				link-mtu mtu
				managed-flag state
				max-interval interval
				min-interval interval
				other-config-flag state
				prefix ipv6net {
					autonomous-flag state
					on-link-flag state
					preferred-lifetime lifetime
					valid-lifetime lifetime
				}
				reachable-time time
				retrans-timer time
				send-advert state
			}
		}
	}
}

Use this command to configure RAs to be sent from a tunnel interface.

Router advertisements are sent by IPv6 routers to advertise their existence to hosts on the network. IPv6 hosts do not send RAs.

If the router-advert node of the configuration tree is missing, RAs are not sent. In addition, if IPv6 forwarding is disabled either globally (by using the system ipv6 disable-forwarding command) or on the interface (by using the interfaces tunnel <tunx> ipv6 disable-forwarding command), RAs are not sent.

Most RA parameters are required by either the Neighbor Discovery (ND) protocol or the Stateless Address Autoconfiguration (SLAAC) protocol. These parameters are used locally for the IPv6 implementation and become part of the RA messages sent to hosts on the network so that they can be configured appropriately.

Use the set form of this command to create the router-advert configuration node and begin to send RAs.

Use the delete form of this command to delete the router-advert configuration node and stop sending RAs.

Use the show form of this command to display the current configuration for sending RAs.