TraceRoute Class

Properties   Methods   Events   Configuration Settings   Errors  

The TraceRoute class allows you to trace the path IP packets take on the Internet.

Class Name

IPWorks_TraceRoute

Procedural Interface

 ipworks_traceroute_open();
 ipworks_traceroute_close($res);
 ipworks_traceroute_register_callback($res, $id, $function);
 ipworks_traceroute_get_last_error($res);
 ipworks_traceroute_get_last_error_code($res);
 ipworks_traceroute_set($res, $id, $index, $value);
 ipworks_traceroute_get($res, $id, $index);
 ipworks_traceroute_do_config($res, $configurationstring);
 ipworks_traceroute_do_doevents($res);
 ipworks_traceroute_do_interrupt($res);
 ipworks_traceroute_do_reset($res);
 ipworks_traceroute_do_traceto($res, $host);

Remarks

The component implements a standard IP Traceroute as defined in RFC 1393.

To use the class, simply call the TraceTo method and set the Host parameter to the domain name or IP address of the host you want to trace the path to. This is identical to setting the RemoteHost property to the domain name or IP address. The class will start sending probe packets towards the host, and as it receives replies it will fire Hop events giving information about the route. The same information is also provided in the Hops properties.

The ResolveNames property enables or disables DNS resolution of IP addresses received during the trace. If set to False only IP addresses are provided. If set to True the class will attempt to resolve the names of the hosts in the route. This may considerably increase the time it takes to complete the trace.

The HopTimeout property determines the maximum waiting time for a response in each hop of the trace, while the Timeout property defines the maximum waiting time for the whole trace. The HopLimit property specifies the maximum number of hops allowed for a trace.