traceroute

Traces the network path of packets as they are forwarded to a destination address.

Syntax

traceroute { IPv4_address | host-name | ipv6 [ dest-ipv6-addr | host-name ] } [ interface ] [ maxttl value ] [ minttl value ] [ src-addr src-addr ] [ timeout seconds ] [ vrf vrf-name ]

Parameters

IPv4_address
Specifies the IPv4 address of the destination device.
host-name
Specifies the hostname of the destination device.
ipv6 dest-ipv6-addr
Specifies the IPv6 address of the destination device.
interface
Selects the output interface.
maxttl value
Maximum Time To Live value in a number of hops.
minttl value
Minimum Time To Live value in a number of hops.
src-addr address
Specifies the IPv4 or IPv6 address of the source device.
timeout seconds
The traceroute timeout value.
vrf vrf-name
Name of the VRF. If no VRF is specified, the default-vrf is used.

Modes

Privileged EXEC mode

Usage Guidelines

To use the traceroute command on the management VRF, enter mgmt-vrf. You must enter the name of the management VRF manually.

Examples

The following example executes an IPv6 traceroute, with minimum and maximum TTL values.

device# traceroute ipv6 fec0:60:69bc:92:218:8bff:fe40:1470 maxttl 128 minttl 30 src-addr fec0:60:69bc:92:205:33ff:fe9e:3f20 timeout 3
 
traceroute to fec0:60:69bc:92:218:8bff:fe40:1470 (fec0:60:69bc:92:218:8bff:fe40:1470), 128 hops max, 80 byte packets
30  fec0:60:69bc:92:218:8bff:fe40:1470 (fec0:60:69bc:92:218:8bff:fe40:1470)  2.145 ms  2.118 ms  2.085 ms