1. EAGLE Commands User's Guide
  2. Pass-Through Commands
  3. traceroute

6.19 traceroute

This command is used to determine the path taken by a UDP message to a specified remote host. The command can be invoked with either a hostname or IP address.

Options

Options and option parameters that are underlined indicate that a value must be specified for that option or parameter. For example, the traceroute command has the option destiination. The IP address can be specified for the remote host to which the UDP message is sent, as in the command traceroute 208.55.20.177. Do not enter the underlined option or parameter; enter a value for the information represented by the underlined option or parameter.

IP address

The IP address is a TCP/IP address expressed in standard “dot notation.” IP addresses consist of the system’s network number and the machine’s unique host number. An example IP address is 192.9.200.44, where 192.9.200 is the network number and 44 is the machine’s host number.

Range:
4 numbers separated by dots, with each number in the range of 0-255.
hostname

Hostname. The logical name assigned to the device with the IP address indicated.

Range:
String of characters, beginning with a letter, up to 120 characters in length.

Valid characters are a-z, A-Z, 0-9, - (hyphen), . (period)

-h

This option provides help information for the command.

-m maximum hops

This option specifies the maximum number of hops before the trace is terminated.

Range:
1-30
Default:
10
-n

This option specifies that only the IP Address of each host will be displayed (not the hostname).

-p port

This option provides the user port number.

Range:
1-65535
Default:
33434

Example

traceroute

traceroute www.remotedest.com

traceroute www.remotedest.com -m 20

traceroute www.remotedest.com -m 20 -n

traceroute 208.55.20.177

traceroute 208.55.20.177 -m 20 -p 40000

Dependencies

If a Domain Name is specified, the Domain Name must exist in the IP Host table or the Domain Name Server A or B must be provisioned.

Notes

The traceroute command is executed through the pass command.

Output

This example shows the help information for the command:

pass:loc=1103:cmd="traceroute" or

pass:loc=1103:cmd="traceroute -h" 

    Command entered at terminal #1.
;

    rlghncxa03w 04-07-27 08:32:34 EST  EAGLE5 31.6.0
    PASS: Command sent to card
;
    rlghncxa03w 04-07-27 08:32:34 EST  EAGLE5 31.6.0

    Usage: traceroute <hostname | ipaddr> [-h] [-m maxhops] [-n] [-p port]
    Options:
      -h         Displays this message
      -m maxhops Maximum number of hops to destination.  Range=1..30. Default= 10.
      -n names   Inhibits the display of intermediate host names
      -p port    Port number. Range=1..65535. Default=33434.
      hostname   Name of machine to trace
      ipaddr         
    Errors:
      *          Timeout
      !N         Unreachable Network
      !H         Unreachable Host
      !?nn       Unknown Failure (nn = ICMP Code)

;
    rlghncxa03w 04-07-27 08:32:34 EST  EAGLE5 31.6.0
 
TRACEROUTE command complete

This example shows output for a request to host www.remotedest.com. A maximum of 20 hops has been specified. Three packets are sent to each hop, with the time for each sample displayed. Intermediate host names are also displayed.

pass:loc=1103:cmd="traceroute www.remotedest.com -m 20" 

    Command entered at terminal #1.
;

    rlghncxa03w 04-07-27 08:32:34 EST  EAGLE5 31.6.0
    PASS: Command sent to card
;

    rlghncxa03w 04-07-27 08:32:34 EST  EAGLE5 31.6.0
    TRACEROUTE command in progress
;

    rlghncxa03w 04-07-27 08:32:34 EST  EAGLE5 31.6.0
;

    rlghncxa03w 04-07-27 08:32:34 EST  EAGLE5 31.6.0
    Traceroute to www.remotedest.com (208.55.20.177),
                  20 hops max, 100 byte packets
     1    5ms    5ms    5ms 216-187-242-57.ded.btitelecom.net (216.187.242.57)
     2   25ms   25ms   85ms 216-187-251-74.ded.btitelecom.net (216.187.251.74)
     3   25ms   25ms   25ms bti-rdu-c1-rtr.btitelecom.net (208.216.228.254)
     4   30ms   25ms   25ms Serial4-1-0.GW2.RDU1.ALTER.NET (157.130.34.93)
     5   35ms   35ms   40ms 178.ATM2-0.XR1.DCA1.ALTER.NET (146.188.162.50)
     6   40ms   40ms   35ms 195.at-2-0-0.XR1.DCA6.ALTER.NET (152.63.33.22)
     7   40ms   40ms   40ms 0.so-1-3-0.XL1.DCA6.ALTER.NET (152.63.35.114)
     8   40ms   40ms   40ms POS6-0.BR3.DCA6.ALTER.NET (152.63.38.117)
     9   40ms   40ms   40ms a3-0.uunet.mclnva02.us.bb.verio.net (204.255.169.90)
    10   75ms   75ms   75ms p16-0-0-0.r00.atlnga03.us.bb.verio.net (129.250.2.49)
    11   95ms   95ms   95ms p4-0-2-0.r01.bcrtfl01.us.bb.verio.net (129.250.4.54)
    12   95ms   95ms   95ms ge-1-1.r01.border.boca.verio.net (129.250.28.52)
    13   95ms   95ms   95ms ge-8-1.r01.edge.boca.verio.net (208.55.254.9)
    14   95ms   95ms   95ms www.remotedest.com (208.55.20.177)

    TRACEROUTE command complete

;

This example shows a request to host www.remotedest.com. No maximum number of hops has been specified. Intermediate host names are displayed. The display terminates after 10 hops.

pass:loc=1103:cmd="traceroute www.remotedest.com" 

    Command entered at terminal #1.
;

    rlghncxa03w 04-07-27 08:32:34 EST  EAGLE5 31.6.0
    PASS: Command sent to card
;

    rlghncxa03w 04-07-27 08:32:34 EST  EAGLE5 31.6.0

    TRACEROUTE command in progress
;

    rlghncxa03w 04-07-27 08:32:34 EST  EAGLE5 31.6.0
;

    rlghncxa03w 04-07-27 08:32:34 EST  EAGLE5 31.6.0
    Traceroute to www.remotedest.com (208.55.20.177),
                  10 hops max, 100 byte packets
     1    5ms    5ms    5ms 216-187-242-57.ded.btitelecom.net (216.187.242.57)
     2   25ms   25ms   25ms 216-187-251-74.ded.btitelecom.net (216.187.251.74)
     3   25ms   25ms   25ms bti-rdu-c1-rtr.btitelecom.net (208.216.228.254)
     4   25ms   25ms   25ms 157.130.34.93 (157.130.34.93)
     5   35ms   40ms   40ms 178.ATM2-0.XR1.DCA1.ALTER.NET (146.188.162.50)
     6   40ms   35ms   45ms 195.at-2-0-0.XR1.DCA6.ALTER.NET (152.63.33.22)
     7   45ms   40ms   40ms 0.so-1-3-0.XL1.DCA6.ALTER.NET (152.63.35.114)
     8   40ms   35ms   35ms POS6-0.BR3.DCA6.ALTER.NET (152.63.38.117)
     9   40ms   40ms   40ms a3-0.uunet.mclnva02.us.bb.verio.net (204.255.169.90)
    10   75ms   75ms   80ms p16-0-0-0.r00.atlnga03.us.bb.verio.net (129.250.2.49)

    Maximum number of hops reached

    TRACEROUTE command complete

;

This example shows a request to host IP address 208.55.20.177. No maximum number of hops has been specified. Intermediate host names are displayed. The display terminates after 10 hops.

pass:loc=1103:cmd="traceroute 208.55.20.177" 

    Command entered at terminal #1.
;

    rlghncxa03w 04-07-27 08:32:34 EST  EAGLE5 31.6.0
    PASS: Command sent to card
;

    rlghncxa03w 04-07-27 08:32:34 EST  EAGLE5 31.6.0

    TRACEROUTE command in progress

;

     rlghncxa03w 04-07-27 08:32:34 EST  EAGLE5 31.6.0
    Traceroute to www.remotedest.com (208.55.20.177),
                  10 hops max, 100 byte packets
     1    5ms    5ms    5ms 216-187-242-57.ded.btitelecom.net (216.187.242.57)
     2   55ms  260ms  300ms 216-187-251-74.ded.btitelecom.net (216.187.251.74)
     3   25ms   25ms   25ms bti-rdu-c1-rtr.btitelecom.net (208.216.228.254)
     4   25ms   25ms   25ms Serial4-1-0.GW2.RDU1.ALTER.NET (157.130.34.93)
     5   40ms   35ms   35ms 178.ATM2-0.XR1.DCA1.ALTER.NET (146.188.162.50)
     6   40ms   35ms   40ms 195.at-2-0-0.XR1.DCA6.ALTER.NET (152.63.33.22)
     7   35ms   40ms   40ms 0.so-1-3-0.XL1.DCA6.ALTER.NET (152.63.35.114)
     8   40ms   35ms   40ms POS6-0.BR3.DCA6.ALTER.NET (152.63.38.117)
     9   40ms   40ms   40ms a3-0.uunet.mclnva02.us.bb.verio.net (204.255.169.90)
    10   75ms   75ms   75ms p16-0-0-0.r00.atlnga03.us.bb.verio.net (129.250.2.49)
    Maximum number of hops reached

    TRACEROUTE command complete
;

This example shows a request to host IP address 208.55.20.177. A maximum of 20 hops has been specified. Intermediate host names are displayed.

pass:loc=1103:cmd="traceroute 208.55.20.177 -m 20" 

    Command entered at terminal #1.
;

    rlghncxa03w 04-07-27 08:32:34 EST  EAGLE5 31.6.0
    PASS: Command sent to card
;

    rlghncxa03w 04-07-27 08:32:34 EST  EAGLE5 31.6.0
 
    TRACEROUTE command in progress
;

    rlghncxa03w 04-07-27 08:32:34 EST  EAGLE5 31.6.0

;

    rlghncxa03w 05-07-27 08:32:34 EST  EAGLE5 31.6.0
    Traceroute to www.remotedest.com (208.55.20.177),
                  20 hops max, 100 byte packets
     1    5ms    5ms    5ms 216-187-242-57.ded.btitelecom.net (216.187.242.57)
     2   25ms   25ms   25ms 216-187-251-74.ded.btitelecom.net (216.187.251.74)
     3   25ms   25ms   25ms bti-rdu-c1-rtr.btitelecom.net (208.216.228.254)
     4   25ms   25ms   25ms Serial4-1-0.GW2.RDU1.ALTER.NET (157.130.34.93)
     5   35ms   35ms   35ms 178.ATM2-0.XR1.DCA1.ALTER.NET (146.188.162.50)
     6   35ms   40ms   35ms 195.at-2-0-0.XR1.DCA6.ALTER.NET (152.63.33.22)
     7   35ms   35ms   35ms 0.so-1-3-0.XL1.DCA6.ALTER.NET (152.63.35.114)
     8   40ms   35ms   35ms POS6-0.BR3.DCA6.ALTER.NET (152.63.38.117)
     9   40ms   40ms   40ms a3-0.uunet.mclnva02.us.bb.verio.net (204.255.169.90)
    10   75ms   75ms   75ms p16-0-0-0.r00.atlnga03.us.bb.verio.net(129.250.2.49)
    11   95ms   95ms   95ms p4-0-2-0.r01.bcrtfl01.us.bb.verio.net (129.250.4.54)
    12   95ms   95ms   95ms ge-1-1.r01.border.boca.verio.net (129.250.28.52)
    13   95ms   95ms   95ms ge-8-1.r01.edge.boca.verio.net (208.55.254.9)
    14   95ms   95ms   95ms www.remotedest.com (208.55.20.177)
    
    TRACEROUTE command complete
;

This example shows a request to host IP address 208.55.20.177. A maximum of 20 hops has been specified. Intermediate host names are not displayed because the –n option is specified.

pass:loc=1103:cmd="traceroute 208.55.20.177 -m 20 -n" 

    Command entered at terminal #1.
;
     rlghncxa03w 04-07-27 08:32:34 EST  EAGLE5 31.6.0
    PASS: Command sent to card
;

     rlghncxa03w 04-07-27 08:32:34 EST  EAGLE5 31.6.0

    TRACEROUTE command in progress
;

     rlghncxa03w 04-07-27 08:32:34 EST  EAGLE5 31.6.0

;

     rlghncxa03w 04-07-27 08:32:34 EST  EAGLE5 31.6.0
    Traceroute to www.remotedest.com (208.55.20.177),
                  20 hops max, 100 byte packets
     1    5ms    5ms    5ms 216.187.242.57
     2   25ms   25ms   25ms 216.187.251.74
     3   25ms   25ms   25ms 208.216.228.254
     4   30ms   30ms   30ms 157.130.34.93
     5   35ms   40ms   40ms 146.188.162.50
     6   40ms   40ms   40ms 152.63.33.22
     7   40ms   45ms   40ms 152.63.35.114
     8   40ms   40ms   35ms 152.63.38.117
     9   40ms   40ms   40ms 204.255.169.90
    10   75ms   75ms   75ms 129.250.2.49
    11   95ms   95ms   95ms 129.250.4.54
    12   95ms   95ms   95ms 129.250.28.52
    13   95ms   95ms   95ms 208.55.254.9
    14  110ms  100ms   95ms 208.55.20.177

    TRACEROUTE command complete
;

This example shows a request to host IP address www.remotedest.com. A maximum of 20 hops has been specified. Intermediate host names are not displayed because the –n option is specified.

pass:loc=1103:cmd="traceroute www.remotedest.com -m 20 -n" 

    Command entered at terminal #1.
;
    rlghncxa03w 04-07-27 08:32:34 EST  EAGLE5 31.6.0
    PASS: Command sent to card
;

    rlghncxa03w 04-07-27 08:32:34 EST  EAGLE5 31.6.0

    TRACEROUTE command in progress
;

    rlghncxa03w 04-07-27 08:32:34 EST  EAGLE5 31.6.0
;

    rlghncxa03w 05-07-27 08:32:34 EST  EAGLE5 31.6.0
    Traceroute to www.remotedest.com (208.55.20.177),
                  20 hops max, 100 byte packets
     1    5ms    5ms    5ms 216.187.242.57
     2   25ms   25ms   25ms 216.187.251.74
     3   25ms   25ms   25ms 208.216.228.254
     4   30ms   30ms   30ms 157.130.34.93
     5   35ms   40ms   40ms 146.188.162.50
     6   40ms   40ms   40ms 152.63.33.22
     7   40ms   45ms   40ms 152.63.35.114
     8   40ms   40ms   35ms 152.63.38.117
     9   40ms   40ms   40ms 204.255.169.90
    10   75ms   75ms   75ms 129.250.2.49
    11   95ms   95ms   95ms 129.250.4.54
    12   95ms   95ms   95ms 129.250.28.52
    13   95ms   95ms   95ms 208.55.254.9
    14  110ms  100ms   95ms 208.55.20.177

    TRACEROUTE command complete
;

This example shows a request to host IP address 208.55.20.177. A maximum of 20 hops has been specified. Intermediate host names are displayed. Application Port 40000 is used.

pass:loc=1103:cmd="traceroute 208.55.20.177 -m 20 -p 40000" 

    Command entered at terminal #1.
;

    rlghncxa03w 04-07-27 08:32:34 EST  EAGLE5 31.6.0
    PASS: Command sent to card
;

    rlghncxa03w 04-07-27 08:32:34 EST  EAGLE5 31.6.0

    TRACEROUTE command in progress
;

    rlghncxa03w 04-07-27 08:32:34 EST  EAGLE5 31.6.0
;

    rlghncxa03w 04-07-27 08:32:34 EST  EAGLE5 31.6.0
    Traceroute to www.remotedest.com (208.55.20.177),
                  20 hops max, 100 byte packets
     1    5ms    5ms    5ms 216-187-242-57.ded.btitelecom.net (216.187.242.57)
     2   25ms   25ms   25ms 216-187-251-74.ded.btitelecom.net (216.187.251.74)
     3   25ms   25ms   25ms 208.216.228.254 (208.216.228.254)
     4   25ms   25ms   25ms 157.130.34.93 (157.130.34.93)
     5   35ms   40ms   40ms 178.ATM2-0.XR1.DCA1.ALTER.NET (146.188.162.50)
     6   45ms   35ms   40ms 195.at-2-0-0.XR1.DCA6.ALTER.NET (152.63.33.22)
     7   35ms   40ms   40ms 0.so-1-3-0.XL1.DCA6.ALTER.NET (152.63.35.114)
     8   40ms   35ms   40ms POS6-0.BR3.DCA6.ALTER.NET (152.63.38.117)
     9   40ms   40ms   40ms a3-0.uunet.mclnva02.us.bb.verio.net (204.255.169.90)
    10   75ms   75ms   75ms p16-0-0-0.r00.atlnga03.us.bb.verio.net(129.250.2.49)
    11   95ms   95ms   95ms p4-0-2-0.r01.bcrtfl01.us.bb.verio.net (129.250.4.54)
    12   95ms   95ms   95ms ge-1-1.r01.border.boca.verio.net (129.250.28.52)
    13   95ms   95ms   95ms ge-8-1.r01.edge.boca.verio.net (208.55.254.9)
    14   95ms   95ms   95ms www.remotedest.com (208.55.20.177)

    TRACEROUTE command complete
;

This example shows a request to host IP address 204.202.136.31. A maximum of 20 hops has been specified. Intermediate host names are displayed. Several timeouts occur. An ICMP error is received (in this case, an unknown response with an ICMP code = 13), and the command is terminated immediately.

pass:loc=1103:cmd="traceroute 204.202.136.31 -m 20" 

    Command entered at terminal #1.
;

    rlghncxa03w 04-07-27 08:32:34 EST  EAGLE5 31.6.0
    PASS: Command sent to card
;
 
    rlghncxa03w 04-07-27 08:32:34 EST  EAGLE5 31.6.0
    TRACEROUTE command in progress
;
 
    rlghncxa03w 04-07-27 08:32:34 EST  EAGLE5 31.6.0
;

    rlghncxa03w 04-07-27 08:32:34 EST  EAGLE 31.6.0
    Traceroute to 204.202.136.31 (204.202.136.31),
                  20 hops max, 100 byte packets
     1    5ms    5ms    5ms 216-187-242-57.ded.btitelecom.net (216.187.242.57)
     2   25ms   25ms   25ms 216-187-251-74.ded.btitelecom.net (216.187.251.74)
     3   25ms   25ms   25ms bti-rdu-c1-rtr.btitelecom.net (208.216.228.254)
     4   25ms   25ms   25ms Serial4-1-0.GW2.RDU1.ALTER.NET (157.130.34.93)
     5   35ms   40ms   35ms 178.ATM2-0.XR1.DCA1.ALTER.NET (146.188.162.50)
     6   40ms   35ms   35ms 195.at-1-0-0.TR1.DCA6.ALTER.NET (152.63.33.206)
     7  110ms  115ms  115ms 121.at-1-1-0.TR1.SEA1.ALTER.NET (146.188.140.74)
     8  110ms  115ms  115ms 299.ATM7-0.XR1.SEA1.ALTER.NET (146.188.200.109)
     9  115ms  115ms  115ms 195.ATM5-0.GW5.SEA1.ALTER.NET (146.188.201.57)
    10  110ms  110ms  110ms waltdisney1-OC12-gw.customer.alter.net(157.130.182.30)
    11  110ms  115ms  110ms 204.202.138.71 (204.202.138.71)
    12    *      *      *   Request timed out
    13    !?13              Unreachable

    TRACEROUTE command complete

;
None.