Previous Topic

Next Topic

Book Contents

IPv6 Routing Commands

This section describes the IPv6 commands you use to configure IPv6 on the system and on the interfaces. This section also describes IPv6 management commands and show commands.

ipv6 forwarding

This command enables IPv6 forwarding on the router.

no ipv6 forwarding

This command disables IPv6 forwarding on the router

ipv6 hop-limit

This command defines the unicast hop count used in ipv6 packets originated by the node. The value is also included in router advertisements. Valid values for hops are 1-64 inclusive. The default "not configured" means that a value of zero is sent in router advertisements and a value of 64 is sent in packets originated by the node. Note that this is not the same as configuring a value of 64.

no ipv6 hop-limit

This command returns the unicast hop count to the default.

ipv6 unicast-routing

Use this command to enable the forwarding of IPv6 unicast datagrams.

no ipv6 unicast-routing

Use this command to disable the forwarding of IPv6 unicast datagrams.

ipv6 enable

Use this command to enable IPv6 routing on an interface or range of interfaces, including tunnel and loopback interfaces, that has not been configured with an explicit IPv6 address. When you use this command, the interface is automatically configured with a link-local address. You do not need to use this command if you configured an IPv6 global address on the interface.

no ipv6 enable

Use this command to disable IPv6 routing on an interface.

ipv6 address

Use this command to configure an IPv6 address on an interface or range of interfaces, including tunnel and loopback interfaces, and to enable IPv6 processing on this interface. You can assign multiple globally reachable addresses to an interface by using this command. You do not need to assign a link-local address by using this command since one is automatically created. The prefix field consists of the bits of the address to be configured. The prefix-length designates how many of the high-order contiguous bits of the address make up the prefix.

You can express IPv6 addresses in eight blocks. Also of note is that instead of a period, a colon now separates each block. For simplification, leading zeros of each 16 bit block can be omitted. One sequence of 16 bit blocks containing only zeros can be replaced with a double colon "::", but not more than one at a time (otherwise it is no longer a unique representation).

The hexadecimal letters in the IPv6 addresses are not case-sensitive. An example of an IPv6 prefix and prefix length is 3ffe:1::1234/64. The optional [eui-64] field designates that IPv6 processing on the interfaces was enabled using an EUI-64 interface ID in the low order 64 bits of the address. If you use this option, the value of prefix-length must be 64 bits.

no ipv6 address

Use this command to remove all IPv6 addresses on an interface or specified IPv6 address. The prefix parameter consists of the bits of the address to be configured. The prefix-length designates how many of the high-order contiguous bits of the address comprise the prefix.The optional [eui-64] field designates that IPv6 processing on the interfaces was enabled using an EUI-64 interface ID in the low order 64 bits of the address. If you do not supply any parameters, the command deletes all the IPv6 addresses on an interface.

ipv6 address dhcp

This command enables the DHCPv6 client on an in-band interface so that it can acquire network information, such as the IPv6 address, from a network DHCP server.

no ipv6 address dhcp

This command releases a leased address and disables DHCPv6 on an interface.

ipv6 route

Use this command to configure an IPv6 static route. The ipv6-prefix is the IPv6 network that is the destination of the static route. The prefix-length is the length of the IPv6 prefix — a decimal value (usually 0-64) that shows how many of the high-order contiguous bits of the address comprise the prefix (the network portion of the address). A slash mark must precede the prefix-length. The next-hop-address is the IPv6 address of the next hop that can be used to reach the specified network. Specifying Null0 as nexthop parameter adds a static reject route. The preference parameter is a value the router uses to compare this route with routes from other route sources that have the same destination. The range for preference is 1–255, and the default value is 1. You can specify a unit/slot/port or tunnel tunnel_id interface to identify direct static routes from point-to-point and broadcast interfaces. The interface must be specified when using a link-local address as the next hop. A route with a preference of 255 cannot be used to forward traffic.

no ipv6 route

Use this command to delete an IPv6 static route. Use the command without the optional parameters to delete all static routes to the specified destination. Use the preference parameter to revert the preference of a route to the default preference.

ipv6 route distance

This command sets the default distance (preference) for IPv6 static routes. Lower route distance values are preferred when determining the best route. The ipv6 route command allows you to optionally set the distance (preference) of an individual static route. The default distance is used when no distance is specified in this command.

Changing the default distance does not update the distance of existing static routes, even if they were assigned the original default distance. The new default distance will only be applied to static routes created after invoking the ipv6 route distance command.

no ipv6 route distance

This command resets the default static route preference value in the router to the original default preference. Lower route preference values are preferred when determining the best route.

ipv6 mtu

This command sets the maximum transmission unit (MTU) size, in bytes, of IPv6 packets on an interface or range of interfaces. This command replaces the default or link MTU with a new MTU value.

NOTE: The default MTU value for a tunnel interface is 1480. You cannot change this value.

no ipv6 mtu

This command resets maximum transmission unit value to default value.

ipv6 nd dad attempts

This command sets the number of duplicate address detection probes transmitted on an interface or range of interfaces. Duplicate address detection verifies that an IPv6 address on an interface is unique.

no ipv6 nd dad attempts

This command resets to number of duplicate address detection value to default value.

ipv6 nd managed-config-flag

This command sets the "managed address configuration" flag in router advertisements on the interface or range of interfaces. When the value is true, end nodes use DHCPv6. When the value is false, end nodes automatically configure addresses.

no ipv6 nd managed-config-flag

This command resets the "managed address configuration" flag in router advertisements to the default value.

ipv6 nd ns-interval

This command sets the interval between router advertisements for advertised neighbor solicitations, in milliseconds. An advertised value of 0 means the interval is unspecified. This command can configure a single interface or a range of interfaces.

no ipv6 nd ns-interval

This command resets the neighbor solicit retransmission interval of the specified interface to the default value.

ipv6 nd other-config-flag

This command sets the "other stateful configuration" flag in router advertisements sent from the interface.

no ipv6 nd other-config-flag

This command resets the "other stateful configuration" flag back to its default value in router advertisements sent from the interface.

ipv6 nd ra-interval

This command sets the transmission interval between router advertisements on the interface or range of interfaces.

no ipv6 nd ra-interval

This command sets router advertisement interval to the default.

ipv6 nd ra-lifetime

This command sets the value, in seconds, that is placed in the Router Lifetime field of the router advertisements sent from the interface or range of interfaces. The lifetime value must be zero, or it must be an integer between the value of the router advertisement transmission interval and 9000. A value of zero means this router is not to be used as the default router.

no ipv6 nd ra-lifetime

This command resets router lifetime to the default value.

ipv6 nd reachable-time

This command sets the router advertisement time to consider a neighbor reachable after neighbor discovery confirmation. Reachable time is specified in milliseconds. A value of zero means the time is unspecified by the router. This command can configure a single interface or a range of interfaces.

no ipv6 nd reachable-time

This command means reachable time is unspecified for the router.

ipv6 nd suppress-ra

This command suppresses router advertisement transmission on an interface or range of interfaces.

no ipv6 nd suppress-ra

This command enables router transmission on an interface.

ipv6 nd prefix

Use the ipv6 nd prefix command to configure parameters associated with prefixes the router advertises in its router advertisements. The first optional parameter is the valid lifetime of the router, in seconds. You can specify a value or indicate that the lifetime value is infinite. The second optional parameter is the preferred lifetime of the router.

This command can be used to configure a single interface or a range of interfaces. The router advertises its global IPv6 prefixes in its router advertisements (RAs). An RA only includes the prefixes of the IPv6 addresses configured on the interface where the RA is transmitted. Addresses are configured using the ipv6 nd prefix interface configuration command. Each prefix advertisement includes information about the prefix, such as its lifetime values and whether hosts should use the prefix for on-link determination or address auto-configuration. Use the ipv6 nd prefix command to configure these values.

The ipv6 nd prefix command allows you to preconfigure RA prefix values before you configure the associated interface address. In order for the prefix to be included in RAs, you must configure an address that matches the prefix using the ipv6 address command. Prefixes specified using ipv6 nd prefix without associated interface address will not be included in RAs and will not be committed to the device configuration.

no ipv6 nd prefix

This command sets prefix configuration to default values.

ipv6 unreachables

Use this command to enable the generation of ICMPv6 Destination Unreachable messages on the interface or range of interfaces. By default, the generation of ICMPv6 Destination Unreachable messages is enabled.

no ipv6 unreachables

Use this command to prevent the generation of ICMPv6 Destination Unreachable messages.

ipv6 icmp error-interval

Use this command to limit the rate at which ICMPv6 error messages are sent. The rate limit is configured as a token bucket, with two configurable parameters, burst-size and burst-interval. The burst-interval specifies how often the token bucket is initialized with burst-size tokens. burst-interval is from 0 to 2147483647 milliseconds (msec). The burst-size is the number of ICMPv6 error messages that can be sent during one burst-interval. The range is from 1 to 200 messages. To disable ICMP rate limiting, set burst-interval to zero (0).

no ipv6 icmp error-interval

Use the no form of the command to return burst-interval and burst-size to their default values.

show ipv6 brief

Use this command to display the IPv6 status of forwarding mode and IPv6 unicast routing mode.

show ipv6 interface

Use this command to show the usability status of IPv6 interfaces and whether ICMPv6 Destination Unreachable messages may be sent.

If you use the brief parameter, the following information displays for all configured IPv6 interfaces:

If you specify an interface, the following information also appears.

If an IPv6 prefix is configured on the interface, the following information also appears.

show ipv6 interface vlan

Use the show ipv6 interface vlan in Privileged EXEC mode to show to show the usability status of IPv6 VLAN interfaces.

show ipv6 dhcp interface

This command displays a list of all IPv6 addresses currently leased from a DHCP server on a specific in-band interface.

show ipv6 neighbor

Use this command to display information about the IPv6 neighbors.

clear ipv6 neighbors

Use this command to clear all entries IPv6 neighbor table or an entry on a specific interface. Use the unit/slot/port parameter to specify the interface.

show ipv6 route

This command displays the IPv6 routing table The ipv6-address specifies a specific IPv6 address for which the best-matching route would be displayed. The ipv6-prefix/ipv6-prefix length specifies a specific IPv6 network for which the matching route would be displayed. The interface specifies that the routes with next-hops on the interface be displayed. The protocol specifies the protocol that installed the routes. The protocol is one of the following keywords: connected, open, static. The all specifies that all routes including best and non-best routes are displayed. Otherwise, only the best routes are displayed.

NOTE: If you use the connected keyword for protocol, the all option is not available because there are no best or non-best connected routes.

The show ipv6 route command displays the routing tables in the following format:

The columns for the routing table display the following information:

To administratively control the traffic destined to a particular network and prevent it from being forwarded through the router, you can configure a static reject route on the router. Such traffic would be discarded and the ICMP destination unreachable message is sent back to the source. This is typically used for preventing routing loops. The reject route added in the RTO is of the type OSPF Inter-Area. Reject routes (routes of REJECT type installed by any protocol) are not redistributed by OSPF/RIP. Reject routes are supported in both OSPFv2 and OSPFv3.

show ipv6 route preferences

Use this command to show the preference value associated with the type of route. Lower numbers have a greater preference. A route with a preference of 255 cannot be used to forward traffic.

show ipv6 route summary

This command displays the summary of the routing table. Use  to display the count summary for all routes, including best and non-best routes. Use the command without parameters to display the count summary for only the best routes.

show ipv6 vlan

This command displays IPv6 VLAN routing interface addresses.

The rest of the output for this command is displayed in a table with the following column headings:

show ipv6 traffic

Use this command to show traffic and statistics for IPv6 and ICMPv6. Specify a logical, loopback, or tunnel interface to view information about traffic on a specific interface. If you do not specify an interface, the command displays information about traffic on all interfaces.

a. ICMPv6 Group Membership Response Messages are supported in VxWorks but are not supported in Linux.

b. ICMPv6 Group Membership Reduction Messages are not supported in Linux but are supported in VxWorks.

clear ipv6 statistics

Use this command to clear IPv6 statistics for all interfaces or for a specific interface, including loopback and tunnel interfaces. IPv6 statistics display in the output of the show ipv6 traffic command. If you do not specify an interface, the counters for all IPv6 traffic statistics reset to zero.

See also

IPv6 Commands

IPv6 Management Commands

Tunnel Interface Commands

Loopback Interface Commands