traceroute

Last Updated : Nov 06, 2012 |
Traces the route packets are taking to a particular host by displaying the hops along the path.
Prolog information
Metadata
Keywords:
Note:
Pressing any key while traceroute is operating, terminates the ongoing trace. However, pressing any key while traceroute is probing a locally terminated tunnel (GRE, ESP) exits the tunnel without terminating the ongoing trace.

Syntax

traceroute host [local-address ip-addr] [probe-count count] [dest-port-base dest-port] [dest-port-increment increment] [source-port source-port] [timeout timeout] [dscp dscp] [next-hop {next-hop-if-name | next-hop-ip-addr}] [max-ttl max-ttl] [size size] [protocol protocol] [include-tunnel-hops] [set-df-bit]

Parameters

Parameter
Description
Possible Values
Default Value
host
The destination host of the traceroute probes, specified as an IP address or host name
ip_addr
The local IP address of the traceroute probes
The outbound interface address
count
The number of times each TTL value is repeated for a traceroute
1-5
3
dest-port
The destination port of the first probe sent
1,024- 65,535
33,434
increment
An integer that determines by how much the destination port is incremented for each probe sent, starting from base port
0-254
1
source-port
The source port of the traceroute probes
1,024- 65,535
33,434
timeout
The duration, in milliseconds, that traceroute waits for a response for each probe sent, until it gives up and marks this probe as unreachable
10ms- 120sec in milliseconds
2 seconds in milliseconds
dscp
The value of the DS field of the traceroute probes
0-63
0
next-hop-if-name
The interface name of the next hop
next-hop-ip-addr
The IP address of the next hop
max-ttl
Do not probe over this TTL value
1-50
30
size
The L4 payload length, in bytes
8-4,088
40
protocol
The protocol type of the traceroute probes
ICMP, UDP
UDP
include- tunnel-hops
Keyword that specifies that traceroute display the route taken by the probes as they traverse locally terminated tunnels (such as GRE, ESP)
set-df-bit
Keyword that specifies to set the Don't-Fragment field of the traceroute probes

User level

read-only

Context

general

Example

To trace the route to IP address 60.60.60.1, including the route taken by the probes as they traverse locally terminated tunnels:
Gxxx-001(super)# traceroute 60.60.60.1 include-tunnel-hops
Tracing route to 60.60.60.1 over a maximum of 30 hops, 40 bytes packets.
Press any key to abort.
  1     3 ms     3 ms     3 ms    111.111.111.114   ESP tunnel
  2     6 ms     5 ms     6 ms    60.60.60.1        GRE tunnel
Trace complete.