CTraceRoute v1.0

Download source files - 13 Kb

Welcome to CTraceRoute, a freeware MFC class to implement trace route functionality.

Features

Usage

History

API Reference

Planned Enhancements

Contacting the Author

Features

• Simple and clean C++ interface.
• The interface provided is synchronous which provides an easier programming model than using asynchronous sockets.
• virtual functions are provided to support callback.
• A configurable timeout can be set through the class API.
• The classes are fully Unicode compliant and include Unicode built options in the workspace file.

Usage

• To use the class in your code simply include tracer.cpp in your project and #include tracer.h in which ever of your modules needs to make calls to the class.
• Your code will need to include MFC either statically or dynamically.
• You will need to have a functioning winsock stack installed as the code links to wsock32.dll.
• The code will work just aswell in a GUI or console app. The code should also work in a multithreaded application, although it has not be explicitly tested in this scenario.

History

V1.0 (18th November 1998)

• Initial public release.

API Reference

The API consists of the the 2 classes:

CTraceRouteReply
CTraceRoute

CTraceRouteReply

This is an encapsulation of all the information as returned from a trace route request. It is a typedef for the following:

typedef CArray<CHostTraceMultiReply, CHostTraceMultiReply&> CTraceRouteReply

The members of CHostTraceMultiReply are as follows:

DWORD dwError	This is the error if any which occurred when doing a ping to this host. This corresponds to the values as returned from GetLastError. 0 represents no error occurred.
in_addr Address	The IP address of the host for this part of the trace route.
DWORD minRTT	Minimum round trip time in milliseconds for this host.
DWORD avgRTT	Average round trip time in milliseconds for this host.
DWORD maxRTT	Maximum round trip time in milliseconds for this host.

CTraceRoute

Trace
OnPingResult
OnSingleHostResult

CTraceRoute::Trace

BOOL CTraceRoute::Trace(LPCTSTR pszHostName, CTraceRouteReply& trr, UCHAR nHopCount = 30, DWORD dwTimeout = 30000, DWORD dwPingsPerHost = 3) const;

Return Value:
If the function succeeds, the return value is TRUE. If the function fails, the return value is FALSE. To get extended error information, call ::GetLastError().

Parameters:

• pszHostName -- The network address of the socket to connect to: a machine name such as "ftp.yourisp.com", or a dotted number such as "128.56.22.8" will both work.
• trr -- Upon successful return, this will contain all the information related to the trace route request. See CTraceRouteReply for further details.
• nHopCount -- This is the maximum TTL to use. This corresponds to the farthest router which the ping request will reach.
• dwTimeout -- The timeout for each ping in milliseconds.
• dwPingsPerHost -- The number of pings to perform per host.

Remarks:
This function implements the trace route functionality.

CTraceRoute::OnPingResult

virtual BOOL CTraceRoute::OnPingResult(int nPingNum, const CHostTraceSingleReply& htsr);

Return Value:
TRUE to continue the trace route. Returning FALSE will cancel the operation.

Parameters:

• nPingNum -- The ping reply which this function is being called for.
• htsr -- Contains the actual results from the ping for this host.

Remarks:
This function is called just after each ping reply. You can derive your own class from CTraceRoute and override this function so that your version is called at the appropriate times.

CTraceRoute::OnSingleHostResult

virtual BOOL CTraceRoute::OnSingleHostResult(int nHostNum, const CHostTraceMultiReply& htmr);

Return Value:
TRUE to continue the trace route. Returning FALSE will cancel the operation.

Parameters:

• nHostNum -- The current host which this function is being called for.
• htmr -- Contains the collective results from the ping for this host.

Remarks:
This function is called just after all the pings for each host is complete. You can derive your own class from CTraceRoute and override this function so that your version is called at the appropriate times. See the CMyTraceRoute class in main.cpp for a concrete implementation.

Planned Enhancements

• If you have any other suggested improvements, please let me know so that I can incorporate them into the next release.

Contacting the Author

PJ Naughter
Email: pjn@indigo.ie
Web: http://www.naughter.com
18th November 1998

You must Sign In to use this message board.

FAQ    Noise Tolerance Very HighHighMediumLowVery Low   Layout Expand Posts & RepliesThread ViewNo JavascriptNo JS + Preview   Per page 102550

Msgs 1 to 6 of 6 (Total in Forum: 6) (Refresh) FirstPrevNext

erroneous results NicolasCh 0:33 3 Jul '07   Hi. I have such results: Tracing route to codeproject.com over a maximum of 30 hops: 1 * * * Error:11013 2 * * * Error:11013 3 * * * Error:11013 4 * * * Error:11013 5 * * * Error:11013 6 * * * Error:11013 7 * * * Error:11013 8 * * * Error:11013 9 * * * Error:11013 10 * * * Error:11013 11 * * * Error:11013 12 * * * Error:11013 13 * * * Error:11013 14 * * * Error:11013 15 * * * Error:11013 16 * * * Error:11013 17 * * * Error:11013 18 * * * Error:11013 19 * * * Error:11013 20 * * * Error:11013 21 * * * Error:11013 22 * * * Error:11013 23 * * * Error:11013 24 * * * Error:11013 25 * * * Error:11013 26 1092 ms 1191 ms 1264 ms www.codeproject.com [69.10.233.10] Trace complete. Why? happynomm Sign In·View Thread·PermaLink 2.00/5 (1 vote) Preventing deadlock sapero_ 13:25 19 Apr '07   inside CTraceRoute::OnSingleHostResult i would add if (htmr.dwError == WSAHOST_NOT_FOUND) return false; to break the trace in case a host is blocked in hosts file. Sign In·View Thread·PermaLink Great Job.. RobJones 7:06 7 Apr '03   Great Job man.. keep up the good work. Rob Whoever said nothing's impossible never tried slamming a revolving door! Sign In·View Thread·PermaLink Host's Name Eric Hansen 5:58 27 Mar '03   I'm new to programming network communications. Most traceRT utilities (that I've seen) resolve the hostname when they are invoked. Win2k TraceRT partial output: Tracing route to HPR01 [10.0.0.1] over a maximum of 30 hops: The "HPR01" portion of this output is what I'm refering to. I'm trying to figure out how to do that and thought you may know, and also that this might be a good addition to your CTraceRoute class. Thanks in advance for any help... Eric Hansen ehansen@pmsi.cc Sign In·View Thread·PermaLink 3.00/5 (1 vote) Re: Host's Name pjnaughter 7:07 27 Mar '03   Make sure you have the latest version from my web site (www.naughter.com) as this is supported by the class. For example: F:\Dev\My Code\tracer\Release>tracer www.naughter.com Tracing route to www.naughter.com over a maximum of 30 hops: 1 0 ms 0 ms 0 ms (Hidden For security reasons) 2 704 ms 840 ms 1065 ms (Hidden For security reasons) 3 699 ms 893 ms 1218 ms (Hidden For security reasons) 4 740 ms 1124 ms 1411 ms (Hidden For security reasons) 5 704 ms 1200 ms 1451 ms (Hidden For security reasons) 6 735 ms 1264 ms 1607 ms (Hidden For security reasons) 7 755 ms 1203 ms 1452 ms so-1-1-0.TR2.FFT1.ALTER.NET [146.188.8.146] 8 795 ms 1235 ms 1460 ms so-5-0-0.IR2.DCA4.ALTER.NET [146.188.5.138] 9 1404 ms 1453 ms 1504 ms so-0-0-0.IL2.DCA6.ALTER.NET [146.188.13.41] 10 1400 ms 1468 ms 1551 ms 0.so-5-0-0.TL2.CHI4.ALTER.NET [152.63.13.41] 11 1447 ms 1450 ms 1456 ms 0.so-0-0-0.XL2.CHI4.ALTER.NET [152.63.13.33] 12 1447 ms 1684 ms 2152 ms 0.so-4-0-0.XR2.CHI4.ALTER.NET [152.63.2.58] 13 1451 ms 1452 ms 1455 ms 290.ATM6-0.XR2.CHI6.ALTER.NET [152.63.65.106] 14 1451 ms 1452 ms 1456 ms 500.at-7-3-0.CL2.CHI6.ALTER.NET [152.63.64.33] 15 843 ms 889 ms 923 ms 0.so-7-0-0.GW8.CHI6.ALTER.NET [152.63.64.25] 16 843 ms 905 ms 939 ms hostway-gw.customer.alter.net [157.130.122.174] 17 1236 ms 1268 ms 1311 ms c0-fe0.siteprotect.com [66.113.129.2] 18 843 ms 1310 ms 1632 ms 64.26.55.243 Trace complete. F:\Dev\My Code\tracer\Release> Note how the output include host names in addition to the IP address Sign In·View Thread·PermaLink 1.00/5 (1 vote) Re: Host's Name Eric Hansen 8:35 27 Mar '03   Oops sorry. I actually just came back here to reply to my own message that I was an idiot since the host name was already there. Thanks though for your prompt reply! Eric Hansen ehansen@pmsi.cc Sign In·View Thread·PermaLink 2.00/5 (1 vote)

Last Visit: 5:41 18 Mar '10     Last Update: 5:41 18 Mar '10 1