-
Cisco IOS IPv6 Command Reference
-
Introduction
-
IPv6 Commands: aaa accounting multicast default through clear ipv6 mobile home-agents
-
IPv6 Commands: clear ipv6 mobile traffic through debug bgp vpnv6 unicast
-
IPv6 Commands: debug crypto ipv6 ipsec through debug ipv6 pim
-
IPv6 Commands: debug ipv6 pim df-election through ip http server
-
IPv6 Commands: ip name server through ipv6 general-prefix
-
IPv6 Commands: ipv6 hello-interval eigrp through ipv6 mld static-group
-
IPv6 Commands: ipv6 mobile home-agent through ipv6 ospf database-filter all out
-
IPv6 Commands: ipv6 ospf dead-interval through ipv6 split-horizon eigrp
-
IPv6 Commands: mpls traffic-eng auto-bw timers through route-map
-
IPv6 Commands: router-id (IPv6) through show bgp ipv6 labels
-
IPv6 Commands: show bgp ipv6 neighbors through show crypto isakmp peers
-
IPv6 Commands: show crypto isakmp policy through show ipv6 eigrp neighbors
-
IPv6 Commands: show ipv6 eigrp topology through show ipv6 nat statistics
-
IPv6 Commands: show ipv6 nat translations through show ipv6 protocols
-
IPv6 Commands: show ipv6 rip through snmp-server host
-
IPv6 Commands: snmp-server user through variance (EIGRP)
-
Table Of Contents
default-information originate (IPv6 IS-IS)
default-information originate (IPv6 OSPF)
distribute-list prefix-list (IPv6 EIGRP)
distribute-list prefix-list (IPv6 OSPF)
distribute-list prefix-list (IPv6 RIP)
debug ipv6 pim df-election
To display debug messages for Protocol Independent Multicast (PIM) bidirectional designated forwarder (DF) election message processing, use the debug ipv6 pim df-election command in privileged EXEC mode. To disable debug messages for PIM bidirectional DF election message processing, use the no form of this command.
debug ipv6 pim df-election [interface type number] [rp rp-name | rp-address]
no debug ipv6 pim df-election [interface type number] [rp rp-name | rp-address]
Syntax Description
Command Default
Debugging for PIM bidirectional DF election message processing is not enabled.
Command Modes
Privileged EXEC
Command History
Usage Guidelines
Use the debug ipv6 pim df-election command if traffic is not flowing properly when operating in PIM bidirectional mode or if the show ipv6 pim df and show ipv6 pim df winner commands do not display the expected information.
Examples
The following example shows how to enable debugging for PIM bidirectional DF election message processing on Ethernet interface 1/0 and at 200::1:
debug ipv6 pim df-election interface ethernet 1/0 rp 200::1Related Commands
debug ipv6 policy
To display IPv6 policy routing packet activity, use the debug ipv6 policy command in user EXEC or privileged EXEC mode. To disable debugging output, use the no form of this command.
debug ipv6 policy [access-list-name]
no debug ipv6 policy [access-list-name]
Syntax Description
access-list-name
(Optional) Name of the IPv6 access list for which to clear the match counters. Names cannot contain a space or quotation mark, or begin with a numeric.
Command Default
IPv6 policy routing packet activity is not displayed.
Command Modes
User EXEC
Privileged EXECCommand History
12.3(7)T
This command was introduced.
12.2(30)S
This command was integrated into Cisco IOS Release 12.2(30)S.
Usage Guidelines
If no access list is specified using the optional access-list-name argument, information about all policy-matched and policy-routed packets is displayed.
After you configure IPv6 policy routing, use the debug ipv6 policy command to verify that IPv6 policy-based routing (PBR) is policy-routing packets normally. Policy routing looks at various parts of the packet and then routes the packet based on certain user-defined attributes in the packet. The debug ipv6 policy command helps you determine what policy routing is following. It displays information about whether a packet matches the criteria, and if so, the resulting routing information for the packet.
Do not use the debug ipv6 policy command unless you suspect a problem with IPv6 PBR policy routing.
Examples
The following example enables IPv6 policy routing packet activity. The output for this command is self-explanatory:
Router# debug ipv6 policy00:02:38:IPv6 PBR:Ethernet0/0, matched src 2003::90 dst 2001:1000::1 protocol 5800:02:38:IPv6 PBR:set nexthop 2003:1::95, interface Ethernet1/000:02:38:IPv6 PBR:policy route via Ethernet1/0/2003:1::95debug ipv6 pool
To enable debugging on IPv6 prefix pools, use the debug ipv6 pool command in privileged EXEC mode. To disable debugging, use the no form of this command.
debug ipv6 pool
no debug ipv6 pool
Syntax Description
This command has no keywords or arguments.
Command Default
No debugging is active.
Command Modes
Privileged EXEC
Command History
Examples
The following example enables debugging for IPv6 prefix pools:
Router# debug ipv6 pool2w4d: IPv6 Pool: Deleting route/prefix 2001:0DB8::/29 to Virtual-Access1 for cisco2w4d: IPv6 Pool: Returning cached entry 2001:0DB8::/29 for cisco on Virtual-Access1 topool12w4d: IPv6 Pool: Installed route/prefix 2001:0DB8::/29 to Virtual-Access1 for ciscoRelated Commands
debug ipv6 rip
To display debug messages for IPv6 Routing Information Protocol (RIP) routing transactions, use the debug ipv6 rip command in privileged EXEC mode. To disable debug messages for IPv6 RIP routing transactions, use the no form of this command.
debug ipv6 rip [interface-type interface-number]
no debug ipv6 rip [interface-type interface-number]
Syntax Description
interface-type
(Optional) The interface type about which to display debug messages.
interface-number
(Optional) The interface number about which to display debug messages.
Command Default
IPv6 RIP debugging is not enabled.
Command Modes
Privileged EXEC
Command History
Usage Guidelines
The debug ipv6 rip command is similar to the debug ip rip command, except that it is IPv6-specific.
Note
By default, the network server sends the output from debug commands and system error messages to the console. To redirect debug output, use the logging command options within global configuration mode. Destinations include the console, virtual terminals, internal buffer, and UNIX hosts running a syslog server. For complete information on debug commands and redirecting debug output, refer to the Cisco IOS Debug Command Reference.
Using this command without arguments enables IPv6 RIP debugging for RIP packets that are sent and received on all router interfaces. Using this command with arguments enables IPv6 RIP debugging for RIP packets that are sent and received only on the specified interface.
Caution
Examples
The following example shows output for the debug ipv6 rip command:
Router# debug ipv6 rip13:09:10:RIPng:Sending multicast update on Ethernet1/1 for as1_rip13:09:10: src=FE80::203:E4FF:FE12:CC1D13:09:10: dst=FF02::9 (Ethernet1/1)13:09:10: sport=521, dport=521, length=3213:09:10: command=2, version=1, mbz=0, #rte=113:09:10: tag=0, metric=1, prefix=::/013:09:28:RIPng:response received from FE80::202:FDFF:FE77:1E42 on Ethernet1/1 for as1_rip13:09:28: src=FE80::202:FDFF:FE77:1E42 (Ethernet1/1)13:09:28: dst=FF02::913:09:28: sport=521, dport=521, length=3213:09:28: command=2, version=1, mbz=0, #rte=113:09:28: tag=0, metric=1, prefix=2000:0:0:1:1::/80The example shows two RIP packets; both are updates, known as "responses" in RIP terminology and indicated by a "command" value of 2. The first is an update sent by this router, and the second is an update received by this router. Multicast update packets are sent to all neighboring IPv6 RIP routers (all routers that are on the same links as the router sending the update, and that have IPv6 RIP enabled). An IPv6 RIP router advertises the contents of its routing table to its neighbors by periodically sending update packets over those interfaces on which IPv6 RIP is configured. An IPv6 router may also send "triggered" updates immediately following a routing table change. In this case the updates only includes the changes to the routing table. An IPv6 RIP router may solicit the contents of the routing table of a neighboring router by sending a Request (command =1) message to the router. The router will respond by sending an update (Response, command=2) containing its routing table. In the example, the received response packet could be a periodic update from the address FE80::202:FDFF:FE77:1E42 or a response to a RIP request message that was previously sent by the local router.
Table 18 describes the significant fields shown in the display.
Related Commands
debug ipv6 routing
Displays debug messages for IPv6 routing table updates and route cache updates.
debug ipv6 routing
To display debug messages for IPv6 routing table updates and route cache updates, use the debug ipv6 routing command in privileged EXEC mode. To disable debug messages for IPv6 routing table updates and route cache updates, use the no form of this command.
debug ipv6 routing
no debug ipv6 routing
Syntax Description
This command has no arguments or keywords.
Command Default
Debugging for IPv6 routing table updates and route cache updates is not enabled.
Command Modes
Privileged EXEC
Command History
Usage Guidelines
The debug ipv6 routing command is similar to the debug ip routing command, except that it is IPv6-specific.
Note
Examples
The following example shows output for the debug ipv6 routing command:
Router# debug ipv6 routing13:18:43:IPv6RT0:Add 2000:0:0:1:1::/80 to table13:18:43:IPv6RT0:Better next-hop for 2000:0:0:1:1::/80, [120/2]13:19:09:IPv6RT0:Add 2000:0:0:2::/64 to table13:19:09:IPv6RT0:Better next-hop for 2000:0:0:2::/64, [20/1]13:19:09:IPv6RT0:Add 2000:0:0:2:1::/80 to table13:19:09:IPv6RT0:Better next-hop for 2000:0:0:2:1::/80, [20/1]13:19:09:IPv6RT0:Add 2000:0:0:4::/64 to table13:19:09:IPv6RT0:Better next-hop for 2000:0:0:4::/64, [20/1]13:19:37:IPv6RT0:Add 2000:0:0:6::/64 to table13:19:37:IPv6RT0:Better next-hop for 2000:0:0:6::/64, [20/2]The debug ipv6 routing command displays messages whenever the routing table changes. For example, the following message indicates that a route to the prefix 2000:0:0:1:1::/80 was added to the routing table at the time specified in the message.
13:18:43:IPv6RT0:Add 2000:0:0:1:1::/80 to tableThe following message indicates that the prefix 2000:0:0:2::/64 was already in the routing table; however, a received advertisement provided a lower cost path to the prefix. Therefore, the routing table was updated with the lower cost path. (The [20/1] in the example is the administrative distance [20] and metric [1] of the better path.)
13:19:09:IPv6RT0:Better next-hop for 2000:0:0:2::/64, [20/1]Related Commands
debug isis spf-events
To display a log of significant events during an Intermediate System-to-Intermediate System (IS-IS) shortest-path first (SPF) computation, use the debug isis spf-events command in privileged EXEC mode. To disable debugging output, use the no form of this command.
debug isis spf-events
no debug isis spf-events
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC
Command History
Usage Guidelines
This command displays information about significant events that occur during SPF-related processing.
Examples
The following example displays significant events during an IS-IS SPF computation:
Router# debug isis spf-eventsISIS-Spf: Compute L2 IPv6 SPTISIS-Spf: Move 0000.0000.1111.00-00 to PATHS, metric 0ISIS-Spf: Add 0000.0000.2222.01-00 to TENT, metric 10ISIS-Spf: Move 0000.0000.2222.01-00 to PATHS, metric 10ISIS-Spf: considering adj to 0000.0000.2222 (Ethernet3/1) metric 10, level 2, circuit 3, adj 3ISIS-Spf: (accepted)ISIS-Spf: Add 0000.0000.2222.00-00 to TENT, metric 10ISIS-Spf: Next hop 0000.0000.2222 (Ethernet3/1)ISIS-Spf: Move 0000.0000.2222.00-00 to PATHS, metric 10ISIS-Spf: Add 0000.0000.2222.02-00 to TENT, metric 20ISIS-Spf: Next hop 0000.0000.2222 (Ethernet3/1)ISIS-Spf: Move 0000.0000.2222.02-00 to PATHS, metric 20ISIS-Spf: Add 0000.0000.3333.00-00 to TENT, metric 20ISIS-Spf: Next hop 0000.0000.2222 (Ethernet3/1)ISIS-Spf: Move 0000.0000.3333.00-00 to PATHS, metric 20default (IPv6 OSPF)
To return a parameter to its default value, use the default command in router configuration mode.
default [area | auto-cost | default-information | default-metric | discard-route | distance | distribute-list | ignore | log-adjacency-changes | maximum-paths | passive-interface | redistribute | router-id | summary-prefix | timers]
Syntax Description
Command Default
This command is disabled by default.
Command Modes
Router configuration
Command History
12.2(15)T
This command was introduced.
12.2(28)SB
This command was integrated into Cisco IOS Release 12.2(28)SB.
Usage Guidelines
The command is removed if it is disabled by default.
Examples
In the following example, OSPF for IPv6 area parameters are reset to the default values:
default timers spfdefault-information originate (IPv6 IS-IS)
To inject an IPv6 default route into an Intermediate System-to-Intermediate System (IS-IS) IPv6 routing domain, use the default-information originate command in address family configuration mode. To disable this feature, use the no form of this command.
default-information originate [route-map map-name]
no default-information originate [route-map map-name]
Syntax Description
route-map map-name
(Optional) Route map should be used to advertise the default route conditionally.
The map-name argument identifies a configured route map.
Command Default
Disabled
Command Modes
Address family configuration
Command History
Usage Guidelines
The default-information originate (IPv6 IS-IS) command is similar to the default-information originate (IS-IS) command, except that it is IPv6-specific.
If a router configured with this command has an IPv6 route to ::/0 in the routing table, IS-IS will originate an advertisement for ::/0 in its link-state packets (LSPs).
Without a route map, the default is advertised only in Level 2 LSPs. For Level 1 routing, there is another mechanism to find the default route, which is for the router to look for the closest Level 1 or Level 2 router. The closest Level 1 or Level 2 router can be found by looking at the attached bit (ATT) in Level 1 LSPs.
A route map can be used for two purposes:
•
•
With a match ipv6 address standard-access-list command, you can specify one or more IPv6 routes that must exist before the router will advertise ::/0.
Examples
The following example shows the IPv6 default route (::/0) being advertised with all other routes in router updates:
Router(config)# router isis area01Router(config-router)# address-family ipv6Router(config-router-af)# default-information originateRelated Commands
default-information originate (IPv6 OSPF)
To generate a default external route into an Open Shortest Path First (OSPF) for IPv6 routing domain, use the default-information originate command in router configuration mode. To disable this feature, use the no form of this command.
default-information originate [always] metric metric-value [metric-type type-value] [route-map map-name]
no default-information originate [always] metric metric-value [metric-type type-value] [route-map map-name]
Syntax Description
Command Default
This command is disabled by default.
Command Modes
Router configuration
Command History
12.2(15)T
This command was introduced.
12.2(28)SB
This command was integrated into Cisco IOS Release 12.2(28)SB.
Usage Guidelines
Whenever you use the redistribute or the default-information router configuration command to redistribute routes into an OSPF for IPv6 routing domain, the Cisco IOS software automatically becomes an Autonomous System Boundary Router (ASBR). However, an ASBR does not, by default, generate a default route into the OSPF for IPv6 routing domain. The software still must have a default route for itself before it generates one, except when you have specified the always keyword.
When you use this command for the OSPF for IPv6 process, the default network must reside in the routing table, and you must satisfy the route-map map-name keyword and argument. Use the default-information originate always route-map map-name form of the command when you do not want the dependency on the default network in the routing table.
Examples
The following example specifies a metric of 100 for the default route redistributed into the OSPF for IPv6 routing domain, an external metric type of type 2, and the default route to be always advertised:
default-information originate always metric 100 metric-type 2Related Commands
redistribute (IPv6)
Redistributes IPv6 routes from one routing domain into another routing domain.
default-metric (EIGRP)
To set metrics for the Enhanced Interior Gateway Routing Protocol (EIGRP), use the default-metric command in router configuration mode. To remove the metric value and restore the default state, use the no form of this command.
default-metric bandwidth delay reliability loading mtu
no default-metric bandwidth delay reliability loading mtu
Syntax Description
Command Default
Only connected routes can be redistributed without a default metric. The metric of redistributed connected routes is set to 0.
Command Modes
Router configuration
Command History
Usage Guidelines
You must use a default metric to redistribute a protocol into EIGRP, unless you use the redistribute command. Automatic metric translations occur between IGRP and EIGRP. You do not need default metrics to redistribute IGRP or EIGRP into itself.
Note
Metric defaults have been carefully set to work for a wide variety of networks. Take great care when changing these values.
Default metrics are supported only when you are redistributing from IGRP, EIGRP, or static routes.
Examples
The following example shows how the redistributed Routing Information Protocol (RIP) metrics are translated into EIGRP metrics with values as follows: bandwidth = 1000, delay = 100, reliability = 250, loading = 100, and MTU = 1500:
router eigrp 109network 172.16.0.0redistribute ripdefault-metric 1000 100 250 100 1500Related Commands
default-metric (IPv6)
To set default metric values for routes redistributed into the Open Shortest Path First (OSPF) for IPv6 routing protocol, use the default-metric command in router configuration mode. To return to the default state, use the no form of this command.
default-metric metric-value
no default-metric metric-value
Syntax Description
metric-value
Default metric value appropriate for the specified routing protocol. The range is from 1 to 4294967295.
Command Default
Built-in, automatic metric translations, as appropriate for each routing protocol.
Command Modes
Router configuration
Command History
12.2(15)T
This command was introduced.
12.2(28)SB
This command was integrated into Cisco IOS Release 12.2(28)SB.
Usage Guidelines
The default-metric command is used in conjunction with the redistribute router configuration command to cause the current routing protocol to use the same metric value for all redistributed routes. A default metric helps solve the problem of redistributing routes with incompatible metrics. Whenever metrics do not convert, using a default metric provides a reasonable substitute and enables the redistribution to proceed.
Finer control over the metrics of reditributed routes can be gained by using the options to the redistribute command, including route maps.
Examples
The following example shows an OSPF for IPv6 routing protocol redistributing routes from the Routing Information Protocol (RIP) process named process1. All the redistributed routes are advertised with a metric of 10.
ipv6 router ospf 100default-metric 10redistribute rip process1Related Commands
redistribute (IPv6)
Redistributes IPv6 routes from one routing domain into another routing domain.
deny (IPv6)
To set deny conditions for an IPv6 access list, use the deny command in IPv6 access list configuration mode. To remove the deny conditions, use the no form of this command.
deny protocol {source-ipv6-prefix/prefix-length | any | host source-ipv6-address} [operator [port-number]] {destination-ipv6-prefix/prefix-length | any | host destination-ipv6-address} [operator [port-number]] [dest-option-type [doh-number | doh-type]] [dscp value] [flow-label value] [fragments] [log] [log-input] [mobility] [mobility-type [mh-number | mh-type]] [routing] [routing-type routing-number] [sequence value] [time-range name] [undetermined-transport]
no deny protocol {source-ipv6-prefix/prefix-length | any | host source-ipv6-address} [operator [port-number]] {destination-ipv6-prefix/prefix-length | any | host destination-ipv6-address} [operator [port-number]] [dest-option-type [doh-number | doh-type]] [dscp value] [flow-label value] [fragments] [log] [log-input] [mobility] [mobility-type [mh-number | mh-type]] [routing] [routing-type routing-number] [sequence value] [time-range name] [undetermined-transport]
Internet Control Message Protocol
deny icmp {source-ipv6-prefix/prefix-length | any | host source-ipv6-address} [operator [port-number]] {destination-ipv6-prefix/prefix-length | any | host destination-ipv6-address} [operator [port-number]] [icmp-type [icmp-code] | icmp-message] [dest-option-type [doh-number | doh-type]] [dscp value] [flow-label value] [fragments] [log] [log-input] [mobility] [mobility-type [mh-number | mh-type]] [routing] [routing-type routing-number] [sequence value] [time-range name]
Transmission Control Protocol
deny tcp {source-ipv6-prefix/prefix-length | any | host source-ipv6-address} [operator [port-number]] {destination-ipv6-prefix/prefix-length | any | host destination-ipv6-address} [operator [port-number]] [ack] [dest-option-type [doh-number | doh-type]] [dscp value] [established] [fin] [flow-label value] [fragments] [log] [log-input] [mobility] [mobility-type [mh-number | mh-type]] [neq {port | protocol}] [psh] [range {port | protocol}] [routing] [routing-type routing-number] [rst] [sequence value] [syn] [time-range name] [urg]
User Datagram Protocol
deny udp {source-ipv6-prefix/prefix-length | any | host source-ipv6-address} [operator [port-number]] {destination-ipv6-prefix/prefix-length | any | host destination-ipv6-address} [operator [port-number]] [dest-option-type [doh-number | doh-type]] [dscp value] [flow-label value] [fragments] [log] [log-input] [mobility] [mobility-type [mh-number | mh-type]] [neq {port | protocol}] [range {port | protocol}] [routing] [routing-type routing-number] [sequence value] [time-range name]
Syntax Description
