interfaces dataplane <interface-name> vif <vif-id> ipv6 router-advert
Specifies the router advertisements to be sent from a vif.
Router advertisements are not sent on a vif.
- interface-name
- The name of a data plane interface. For more information about the supported interface name formats, refer to Data Plane Interface.
- vif-id
- The ID of a vif. The ID ranges from 1 through 4094.
- cur-hop-limit limit
- Specifies the Hop Count field of the IP header for outgoing (unicast) IP packets. This value is placed in the Hop Count field of the IP header for outgoing (unicast) IP packets. The range is 0 to 255. The default is 64. A limit of 0 means unspecified by the router.
- default-lifetime lifetime
- Specifies the lifetime, in seconds, that is associated with the default router. A lifetime of 0 indicates that the router is not a default router. The lifetime ranges from the value configured for the max-interval option to 9000 (18.2 hours). If the lifetime is not configured, the value for this timer is three times max-interval.
- default-preference preference
- The preference associated with the default router. Supported values are as follows:
low: The default router is low preference.
medium: The default router is medium preference.
high: The default router is high preference.
The default is medium.
- link-mtu mtu
- Specifies the MTU to be advertised for the link. The MTU 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 when the link MTU is not well known.
If the MTU that is set here does not match the MTU that is configured on the interface, the system issues a warning but does not fail.
- managed-flag state
- Whether to use the administered protocol for address autoconfiguration. The state is either of the following:
true: Hosts use the administered (stateful) protocol for address autoconfiguration in addition to any addresses autoconfigured using stateless address autoconfiguration.
false: Hosts use only stateless address autoconfiguration.
The default state is false.
- max-interval interval
- Specifies the maximum time, in seconds, that is allowed between sending unsolicited multicast router advertisements from the interface. The interval ranges from 4 through 1800. The default is 600 (10 minutes).
- min-interval interval
- Specifies the minimum time, in seconds, that is allowed between sending unsolicited multicast router advertisements from the interface. The interval ranges from 3 through 0.75 times the max-interval option. The default interval is 0.33 times max-interval.
- other-config-flag state
- Specifies that the interface use the administered (stateful) protocol for autoconfiguration of nonaddress information, as defined in RFC 4862. The state is either of the following:
true: Hosts use the administered protocol for autoconfiguration of nonaddress information.
false: Hosts use stateless autoconfiguration of nonaddress information.
The default state is false.
- prefix ipv6net
- Multinode. Specifies the IPv6 prefix to be advertised on the IPv6 interface, in the format ipv6-address/prefix.
You can define more than one IPv6 prefix by configuring multiple prefix configuration nodes.
- autonomous-flag state
- Specifies whether the prefix can be used for autonomous address configuration as defined in RFC 4862. The state is either of the following:
true: The prefix can be used for autonomous address configuration.
false: The prefix cannot be used for autonomous address configuration.
The default state is true.
- on-link-flag state
- Specifies whether the prefix can be used for onlink determination, as defined in RFC 4862. The state is either of the following:
true: The prefix can be used for onlink determination.
false: The advertisement makes no statement about onlink 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 onlink and others being off-link.
The default state is true.
- preferred-lifetime lifetime
- Specifies the length of time, in seconds, that the addresses generated from the prefix by Stateless Address Autoconfiguration (SLAAC) is to remain preferred, as defined in RFC 4862. The interval 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 length of time, in seconds, that the prefix is valid for onlink determination, as defined in RFC 4862. The interval is with respect to the time the packet is sent. The time 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 a value of 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 a value of 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 a 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 {
dataplane interface-name {
vif vif-id {
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 specify the router advertisements to be sent from a vif.
Router advertisements are sent by IPv6 routers to advertise their existence to hosts on the network. IPv6 hosts do not send router advertisements.
If the router-advert node of the configuration tree is missing, router advertisements 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 interfaces dataplane <interface-name> vif <vif-id> ipv6 disable-forwarding), router advertisements are not sent.
Most router advertisement parameters are required by either the Neighbor Discovery (ND) protocol or the Stateless Address Autoconfiguration (SLAAC) protocol. These parameters are used both 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 router advertisements on a vif.
Use the delete form of this command to delete router-advert configuration node and stop sending router advertisements on a vif.
Use the show form of this command to view router advertisement configuration for a vif.