traceroute <host> port <number>
Displays the route that packets take to a network host.
- 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).
- portnumber
- 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.
- 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.
- debug-socket
- Enables socket level debugging.
- first-ttlvalue
- Specifies the first time-to-live value. Defaults to 1.
- gatewayaddress
- 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.
- interfacevalue
- Specifies the interface that the device must use for traceroute requests.
- intervalvalue
- Specifies the time in seconds between traceroute requests from the device.
- max-ttlvalue
- Specifies the maximum number of hops for the probe.
- no-fragment
- Does not fragment the probe packets.
- num-queriesnumber
- Specifies the number of probe packets per hop. The default is 3.
- seq-queriesnumber
- Specifies the number of sequential probe packets.
- source-addrhost
- Specifies an alternative source host by hostname, IPv4 address, or MAC address.
- tcp-syn
- Uses TCP SYN for the probes.
- tosvalue
- Marks the packets with the specified Type of Service (TOS) value.
- version
- Displays the timestamp during ping output.
- wait-timevalue
- 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 through port 80.
vyatta@vyatta# traceroute google.com port 80
traceroute to google.com (74.125.224.1), 30 hops max, 60 byte packets
1 gateway.attlocal.net (10.0.6.1) 0.383 ms 0.337 ms 0.327 ms
2 75-25-153-214.uvs.sntcca.sbcglobal.net (75.25.153.214) 1.689 ms 1.582 ms 1.461 ms
3 76-198-128-2.lightspeed.mtvwca.sbcglobal.net (76.198.128.2) 22.674 ms 21.656 ms 21.901 ms
4 71.145.0.192 (71.145.0.192) 26.552 ms 21.609 ms 21.732 ms
5 12.83.39.185 (12.83.39.185) 23.492 ms 12.83.39.189 (12.83.39.189) 24.755 ms 12.83.39.185 (12.83.39.185) 23.333 ms
6 12.122.136.181 (12.122.136.181) 23.033 ms 22.736 ms 23.119 ms
7 * * *
8 216.239.49.168 (216.239.49.168) 25.157 ms 24.775 ms 24.790 ms
9 72.14.232.33 (72.14.232.33) 25.859 ms 25.051 ms 25.207 ms
10 nuq04s18-in-f1.1e100.net (74.125.224.1) 25.102 ms 24.958 ms 25.077 ms