traceroute

Displays the route that packets take to the network host.
Syntax
traceroute[-4][6][-d][-F][-ffirst_ttl][-ggate,...][-I][-T][-idevice][-mmax_ttl][-Nsqueries][-pport][-ttos][-lflow_label][-wwaittime][-qnqueries][-r][-ssrc_addr][-zsendwait]host-addr[packetlen]
Command Default

Traceroute is disabled.

Parameters
-4
Displays IPv4 hops.
-6
Displays IPv6 hops.
-d
Enables socket-level debugging.
-F
Does not fragment the packets.
-ffirst tll
Starts from the first_ttl hop (instead from 1).
-ggate
Routes packets through the specified gateway. (maximum 8 for IPv4 and 127 for IPv6).
-I
Uses ICMP ECHO for tracerouting.
-T
Uses TCP SYN for tracerouting. Default port is 80.
idevice
Specifies a network interface with which to operate.
-mmax tll
Sets the max number of hops (max TTL to be reached). Default is 30.
-Nsqueries
Sets the number of probes to be tried simultaneously (default is 16).
-pport
Sets the destination port to use. It is either initial udp port value for "default" method (incremented by each probe, default is 33434), or initial seq for "icmp" (incremented as well, default from 1), or some constant destination port for other methods (with default of 80 for "tcp", 53 for "udp", etc.) .
-ttos
Sets the TOS (IPv4 type of service) or TC (IPv6 traffic class) value for outgoing packets.
-lflow_label
Uses specified flow_label for IPv6 packets.
-wwaittime
Sets the number of seconds to wait for response to a probe (default is 5.0). Non-integer (float point) values allowed too.
-qnqueries
Sets the number of probes per each hop. Default is 3.
-r
Bypasses the normal routing and sends the probes directly to a host on an attached network.
-ssrc_address
Uses source src_addr for outgoing packets.
-zsendwait
Minimal time interval between probes (default 0). If the value is more than 10, then it specifies a number in milliseconds, else it is a number of seconds (float point values allowed too).
host-address
The IPv4 host address to which tracerouting is applied.
packetlen
Sets the packet length.
Modes

Privileged EXEC mode

Usage Guidelines

Use the traceroute command to help troubleshoot network access or network performance issues.

This command is supported on all the controllers including the SmartZone Data Plane.

Examples

The following example uses IPv4 addresses to trace the route from the device to the host at 10.1.31.105 

device# traceroute -4 10.1.31.105
traceroute to 10.1.31.105 (10.1.31.105), 30 hops max, 60 byte packets
 1  10.174.84.1 (10.174.84.1)  2.712 ms  2.796 ms  2.893 ms
 2  77.77.77.2 (77.77.77.2)  0.292 ms  0.292 ms  0.408 ms
 3  10.174.86.1 (10.174.86.1)  0.680 ms  0.859 ms  1.053 ms
 4  10.174.127.17 (10.174.127.17)  4.397 ms  4.823 ms  5.191 ms
 5  10.7.136.30 (10.7.136.30)  0.922 ms  0.862 ms  0.907 ms
 6  10.7.136.225 (10.7.136.225)  1.335 ms  0.990 ms  0.971 ms
 7  172.16.2.50 (172.16.2.50)  3.127 ms  3.310 ms  3.228 ms
 8  172.16.4.242 (172.16.4.242)  222.211 ms  218.514 ms  222.099 ms
 9  172.16.4.241 (172.16.4.241)  216.834 ms  220.216 ms  220.244 ms
10  172.23.128.13 (172.23.128.13)  219.387 ms  223.637 ms  219.072 ms
11  10.7.2.243 (10.7.2.243)  223.541 ms  223.656 ms  219.682 ms
12  * * *
13  * * *
.
.
.
28  * * *
29  * * *
30  * * *

The following example sets the maximum number of hops to 15 tracing a route to the host at 10.1.31.105. 

device> traceroute -m 15 10.1.31.105
traceroute to 10.1.31.105 (10.1.31.105), 15 hops max, 60 byte packets
 1  10.174.84.1 (10.174.84.1)  2.876 ms  2.861 ms  2.893 ms
 2  77.77.77.2 (77.77.77.2)  0.370 ms  0.370 ms  0.334 ms
 3  10.174.86.1 (10.174.86.1)  0.604 ms  0.722 ms  0.842 ms
 4  10.174.127.17 (10.174.127.17)  4.321 ms  4.317 ms  4.489 ms
 5  10.7.136.30 (10.7.136.30)  0.839 ms  0.831 ms  0.794 ms
 6  10.7.136.225 (10.7.136.225)  1.132 ms  1.086 ms  1.054 ms
 7  172.16.2.50 (172.16.2.50)  2.800 ms  2.849 ms  2.890 ms
 8  172.16.4.242 (172.16.4.242)  220.259 ms  219.940 ms  219.844 ms
 9  172.16.4.241 (172.16.4.241)  216.658 ms  217.896 ms  216.566 ms
10  172.23.128.13 (172.23.128.13)  218.914 ms  219.710 ms  219.962 ms
11  10.7.2.243 (10.7.2.243)  219.888 ms  219.760 ms  219.764 ms
12  * * *
13  * * *
14  * * *
15  * * *
Parent topic: Commands Si - Z