traceroute6

Syntax

traceroute6 [ipv6-address|hostname][minttl 1 - 255][maxttl 1 - 255][timeout 1 - 120][probes 1 - 5][source ipv6-addr|vid|loopback 0 - 7|oobm][dstport 1 - 34000][srcport 1 - 34000]

Syntax

traceroute6 [link-local-address %vlan vid|hostname][minttl 1 - 255][maxttl 1 - 255][timeout 1 - 120][probes 1 - 5][source ipv6-addr|vid|oobm]

Description

Lists the IPv6 address of each hop in the route to the specified destination host device with the time (in microseconds) required for a packet reply to be received from each next-hop device.

Options

ipv6-address

IPv6 address of a destination host device.

link-local-address %vlan vlan-id

IPv6 link-local address, where %vlan vlan-id specifies the VLAN ID number.

hostname

Hostname of an IPv6 host device configured on an IPv6 DNS server.

oobm

For switches that have a separate out-of-band management (OOBM) port, oobm specifies that the traffic originates from the out-of-band management port.

minttl

Minimum number of hops allowed for each probe packet sent along the route. Default : 1; Range : 1 - 255

  • If the minttl value is greater than the actual number of hops, the traceroute output displays only the hops equal to or greater than the configured minttl threshold value. The hops below the threshold value are not displayed.

  • If the minttl value is the same as the actual number of hops, only the final hop is displayed in the command output.

  • If the minttl value is less than the actual number of hops, all hops to the destination host are displayed.

maxttl

Maximum number of hops allowed for each probe packet sent along the route. Valid values: 1 - 255. Default: 30

If the maxttl value is less than the actual number of hops required to reach the host, the traceroute output displays only the IPv6 addresses of the hops detected by the configured maxttl value.

timeout

Number of seconds within which a response is required from the IPv6 device at each hop in the route to the destination host before the traceroute operation times out.

Default : 5 seconds; Range : 1 - 120

probes

Number of times a traceroute is performed to locate the IPv6 device at any hop in the route to the specified host before the operation times out.

Default : 3; Range: 1 - 5

source [ ipv6-addr | vid ]

The source IPv6 address or VLAN of the traceroute device or the VLAN ID on which the traceroute packet is being sent.

dstport 1 - 34000

Destination port.

srcport 1 - 34000

Source port.

Example output

IPv6 traceroute probes

Switch# traceroute6 2001:db8::10
traceroute to 2001:db8::10
      1 hop min, 30 hops max, 5 sec. timeout, 3 probes
 1 2001:db8::a:1c:e3:3           0 ms   0 ms   0 ms
 2 2001:db8:0:7::5               7 ms   3 ms   0 ms
 3 2001:db8::214:c2ff:fe4c:e480  0 ms   1 ms   0 ms
 4 2001:db8::10                  0 ms   1 ms   0 ms
First three hops

Intermediate router hops with the time (in milliseconds) for the switch to receive a response from each of the three probes sent to each router.

Last hop

Destination IPv6 address

Switch# traceroute6 2001:db8::10 maxttl 7
traceroute to fe80::1:2:3:4
      1 hop min, 7 hops max, 5 sec. timeout, 3 probes
1 2001:db8::a:1c:e3:3           0 ms   0 ms   0 ms
2 2001:db8:0:7::5               0 ms   0 ms   0 ms
3 * 2001:db8::214:c2ff:fe4c:e480 *
4 * * *
5 * * *
6 * * *
7 * * *

At hop 3, the first and third probes timed out, but the second probe reached the router. Each timed-out probe is displayed with an asterisk (*). The four remaining probes within the configured seven-hop maximum (maxttl) also timed out without finding a next-hop router or the destination IPv6 address.