Tracing the route from the switch to a host address

The traceroute command enables you to trace the route from the switch to a host address.

This command outputs information for each (router) hop between the switch and the destination address. Note that every time you execute traceroute, it uses the same default settings unless you specify otherwise for that instance of the command.

Syntax:


traceroute {< ip-address | hostname >} [maxttl <1-255>] [minttl <1-255>] [probes <1-5>] [source {<ip-address | source-vlan <vid> | loopback <0-7>}] [dstport <1-34000>] [srcport <1-34000>] [ip-option {<record-route | loose-source-route | strict-source-route | include-timestamp | include-timestamp-and-address | include timestamp-from>}] [< timeout 1-120 >]

Lists the IP address or hostname of each hop in the route, plus the time in microseconds for the traceroute packet reply to the switch for each hop.


{< ip-address | hostname >}

The IP address or hostname of the device to which to send the traceroute.


[minttl < 1-255 >]
For the current instance of traceroute, changes the minimum number of hops allowed for each probe packet sent along the route.
  • If minttl is greater than the actual number of hops, the output includes only the hops at and above the minttl threshold. (The hops below the threshold are not listed.)

  • If minttl matches the actual number of hops, only that hop is shown in the output.

  • If minttl is less than the actual number of hops, all hops are listed.

For any instance of traceroute, if you want a minttl value other than the default, you must specify that value.(Default: 1)

[maxttl < 1-255 >]

For the current instance of traceroute, changes the maximum number of hops allowed for each probe packet sent along the route.If the destination address is further from the switch than maxttl allows, traceroute lists the IP addresses for all hops it detects up to the maxttl limit.For any instance of traceroute, if you want a maxttl value other than the default, you must specify that value.(Default: 30)


[probes < 1-5 >]

For the current instance of traceroute, changes the number of queries the switch sends for each hop in the route.For any instance of traceroute, if you want a probes value other than the default, you must specify that value.(Default: 3)


[source {< ip-addr | vid | loopback <0-7> >}]

The source IPv4 address, VLAN ID, or Loopback address.


[dstport < 1-34000 >]

Destination port.


[srcport < 1-34000 >]

Source port.


[ip-option]

Specify an IP option, such as loose or strict source routing, or an include-timestamp option:[include-timestamp]: Adds the timestamp option to the IP header. The timestamp displays the amount of travel time to and from a host.Default: 9[include-timestamp-and-address]: Records the intermediate router's timestamp and IP address.Default: 4[loose-source-route <IP-addr>] : Prompts for the IP address of each source IP on the path.It allows you to specify the IP addresses that you want the ping packet to go through; the packet may go through other IP addresses as well.[record-route <1-9>] : Displays the IP addresses of the interfaces that the ping packet goes through on its way to the destination and on the way back.When specified without loose or strict recording, the source route is not recorded. The source route is automatically recorded when loose or strict source routing is enabled.Default: 9[strict-source-route <IP-addr>] : Restricts the ping packet to only those IP addresses that have been specified and no other addresses.[timeout <1-120>]: For the current instance of traceroute, changes the timeout period the switch waits for each probe of a hop in the route.For any instance of traceroute, if you want a timeout value other than the default, you must specify that value.(Default: 5 seconds)

NOTE:

For information about traceroute6, see the IPv6 configuration guide for your switch.