Vyatta Network OS Documentation

Learn how to install, configure and operate the Vyatta NOS, which helps drive our virtual networking & physical platforms portfolio.

traceroute <host> debug-socket

Displays the route that packets take to a network host.

traceroute [ ipv4 | ipv6 ] host debug-socket [ options ]
ipv4
Explicitly force IPv4 traceouting. By default, the program will try to resolve the name given, and choose the appropriate protocol automatically. If resolving a host name returns both IPv4 and IPv6 addresses, traceroute will use IPv4.
ipv6
Explicitly force IPv6 traceouting. By default, the program will try to resolve the name given, and choose the appropriate protocol automatically. If resolving a host name returns both IPv4 and IPv6 addresses, traceroute will use IPv6.
host
A host that is the destination for the trace. The host is specified as a name (if DNS is being used on the network), as an IPv4 or IPv6 address, or as a MAC address (format h:h:h:h:h:h:h:h).
debug-socket
Enables socket level debugging.
options
The following entries are options. Multiple options can be included on the same command line.
as-path
Performs AS path lookups in routing registries and print results directly after the corresponding addresses.
bypass-routing
Bypasses the normal routing tables and send directly to a host on an attached network. If the host is not on a directly-attached network, an error is returned. This option can be used to ping a local host through an interface that has no route through it.
first-ttl value
Specifies the first time-to-live value. Defaults to 1.
gateway address
Routes the request through a specified gateway.
icmp-echo
Uses ICMP echo for the traceroute probe.
icmp-extensions
Shows ICMP extensions (rfc4884). The general form is CLASS/TYPE: followed by a hexadecimal dump.
interface value
Specifies the interface that the device must use for traceroute requests.
interval value
Specifies the time in seconds between traceroute requests from the device.
max-ttl value
Specifies the maximum number of hops for the probe.
no-fragment
Does not fragment the probe packets.
num-queries number
Specifies the number of probe packets per hop. The default is 3.
port number
For UDP tracing, specifies the destination port base traceroute will use (the destination port number will be incremented by each probe). For ICMP tracing, specifies the initial icmp sequence value (incremented by each probe too). For TCP specifies just the (constant) destination port to connect.
seq-queries number
Specifies the number of sequential probe packets.
source-addr host
Specifies an alternative source host by hostname, IPv4 address, or MAC address.
tcp-syn
Uses TCP SYN for the probes.
tos value
Marks the packets with the specified Type of Service (TOS) value.
version
Displays the timestamp during ping output.
wait-time value
Specifies the time (seconds) to wait for a response from the probe. Default is 5 seconds.

Operational mode

Use this command to perform a “traceroute” operation for a network host. This operation uses the IP protocol time-to-live (TTL) field and attempts to elicit an Internet Control Message Protocol (ICMP) TIME_EXCEEDED response from each gateway along the path to a host to track the route that a set of packets follows. It attempts to trace the route an IP packet follows to an Internet host by launching User Datagram Protocol (UDP) probe packets with a small time to live, then listening for an ICMP “Time exceeded” reply from a gateway.

The following example illustrates a traceroute to google.com with socket level debugging enabled.

vyatta@vyatta# traceroute google.com debug-socket
traceroute to google.com (216.58.216.14), 30 hops max, 60 byte packets
1  gateway.attlocal.net (10.0.6.1)  0.422 ms  0.399 ms  0.498 ms
2  75-25-153-214.uvs.sntcca.sbcglobal.net (75.25.153.214)  16.520 ms  6.484 ms  6.460 ms
3  76-198-128-2.lightspeed.mtvwca.sbcglobal.net (76.198.128.2)  33.529 ms  36.814 ms  26.584 ms
4  71.145.0.192 (71.145.0.192)  26.546 ms  39.056 ms  38.523 ms
5  12.83.39.189 (12.83.39.189)  39.763 ms  30.819 ms  44.405 ms
6  12.122.136.181 (12.122.136.181)  44.407 ms  43.366 ms  43.334 ms
7  * * *
8  216.239.49.170 (216.239.49.170)  28.635 ms 216.239.49.168 (216.239.49.168)  28.293 ms
                                                            216.239.49.170 (216.239.49.170)  25.805 ms
9  209.85.246.253 (209.85.246.253)  32.914 ms  34.112 ms 209.85.246.20 (209.85.246.20)  30.330 ms
10  64.233.174.204 (64.233.174.204)  36.979 ms  36.492 ms  38.584 ms
11  64.233.175.151 (64.233.175.151)  37.497 ms  37.496 ms 64.233.174.189 (64.233.174.189)  37.503 ms
12  209.85.142.91 (209.85.142.91)  36.126 ms  36.735 ms  36.686 ms
13  lax02s21-in-f14.1e100.net (216.58.216.14)  34.280 ms  32.453 ms  31.764 ms