trace ip

---

Trace a packet to the specified destination address.

Syntax: trace ip dest-address

dest-address

IP address or host name (DNS) of the destination system.

Description: The trace ip command generates 3 datagrams addressed to the destination with the time-to-live (TTL) timer set to 1. The first receiving router on the path to the destination reads the timer, discards the packets, and returns an ICMP message.

The trace ip command repeats this process, incrementing the TTL until:

• the datagram reaches the specified destination
  
  
• the TTL expires
  
  
• you interrupt the sequence.
  
  

Output from the trace ip command consists of a list of all the routers between this router and the destination router including the round trip time for each of the three datagrams sent to that router. The clock granularity is 17ms; any round trip taking less than 17ms will display as 0.000 ms. If a '*' displays instead of a round trip time, it indicates that the probe datagram timed-out. The timeout interval is 5 seconds.

Use the trace ip command to display the IP routes a packet will traverse to the specified destination.

Pressing the CTRL-C key sequence aborts the trace.

Factory Default: None.

Command Mode: Executive and privileged.

Example: The following is sample output from the trace ip command initiated at host name server-doc2 and tracing the hops to host name firewall:

server-doc2#trace ip firewall Send to firewall(10.1.1.40) 30 hops max, 40 byte packets 1 sw-gate (10.5.0.1) 0.000 ms 0.000 ms 0.000 ms 2 10.1.4.1 (10.1.4.1) 0.000 ms 0.000 ms 0.000 ms 3 firewall (10.1.1.40) 0.000 ms * 0.000 ms server-doc2#

The following table describes the fields in the display:

Table 1-14. Fields Displayed by trace ip 

Field	Description
send to	The host name and IP address (in parenthesis) of the final destination of the trace. If a host name is not defined, the IP address displays in both fields.
hops max	The maximum number of hops the trace will traverse in an attempt to reach the destination IP address. Hops max is currently hard coded for 30 hops.
byte packets	The number of bytes in the trace packet. Byte packets is currently hard coded for 40 bytes.

Related Commands: None

Copyright © 2002 Avici Systems Inc.
Avici® and TSR® are registered trademarks of Avici Systems Inc.
IPriori™ and SSR™ are trademarks of Avici Systems Inc.

   Source File Name: IP_Commands.fm
    HTML File Name: IP_Commands19.html
    Last Updated: 05/30/02 at 13:21:32

Please email suggestions and comments to: doc@avici.com