traceroute

Last Updated : Nov 06, 2012 |

Traces the route packets are taking to a particular host by displaying the hops along the path.

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.