SoftLayer Utility Network::traceroute
From SoftLayer Development Network Wiki
traceroute is a member of the SoftLayer_Utility_Network service.
Contents |
Overview
Perform an ICMP traceroute from SoftLayer's application servers to the given IP address or hostname and return the raw results of that command. The returned result is similar to the result received from running the command `traceroute` from a UNIX command shell. A traceroute sends small diagnostic packets to every hop along the network route to a given host. Traceroutes are useful tools for debugging network connectivity to a host on the Internet. Routing loops and intermediate hop timeouts help to narrow down problematic providers along the network chain. Some providers elect to deny ICMP on their networks, which may cause a traceroute to show skewed results. Furthermore, many providers assign a low priority to traceroutes in their infrastructure which may lead to inaccurate hop response times. Running traceroute on a hostname instead of an IP address may fail if DNS lookup for that hostname also fails.
Return Type
traceroute returns the string data type.
Headers
Required Headers
traceroute requires the following headers:
Parameters
traceroute takes the following parameters:
address
An IP address or hostname to traceroute.
- Type: string
Error Handling
traceroute throws the following exceptions:
- SoftLayer_Exception_Public
- Throw the exception "Please provide an address to traceroute." if the address parameter is empty.
- SoftLayer_Exception_Public
- Throw the exception "Please provide a valid IP address or hostname." if the address parameter is not a valid IP address or hostname.
Associated Methods
- SoftLayer_Utility_Network::ping
- SoftLayer_Utility_Network::nslookup
- SoftLayer_Utility_Network::whois
