Index: net/third_party/udt/doc/doc/structure.htm |
=================================================================== |
--- net/third_party/udt/doc/doc/structure.htm (revision 78992) |
+++ net/third_party/udt/doc/doc/structure.htm (working copy) |
@@ -1,239 +0,0 @@ |
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> |
-<html xmlns="http://www.w3.org/1999/xhtml"> |
-<head> |
-<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" /> |
-<title> UDT Reference</title> |
-<link rel="stylesheet" href="udtdoc.css" type="text/css" /> |
-<style type="text/css"> |
-<!-- |
-.style1 { |
- color: #0000FF; |
- font-style: italic; |
-} |
---> |
-</style> |
-</head> |
- |
-<body> |
-<div class="ref_head"> UDT Reference: Structures</div> |
- |
-<h3><font color="#000080">UDT Socket Structures</font></h3> |
- |
-<p>The structures used in UDT API are listed in the table below:</p> |
- |
-<table width="100%" border="1" cellpadding="1" cellspacing="0" bordercolor="#CCCCCC"> |
- <tr> |
- <td width="17%" class="table_headline"><strong>Structures</strong></td> |
- <td width="83%" class="table_headline"><strong>Comments</strong></td> |
- </tr> |
- <tr> |
- <td><a href="#1">UDTSOCKET</a></td> |
- <td>UDT socket descriptor</td> |
- </tr> |
- <tr> |
- <td><a href="#2">ERRORINFO</a></td> |
- <td>Description of UDT system errors</td> |
- </tr> |
- <tr> |
- <td><a href="#3">UDSET</a></td> |
- <td>Set of UDT sockets</td> |
- </tr> |
- <tr> |
- <td><a href="#4">TRACEINFO</a></td> |
- <td>UDT performance statistics and protocol parameters</td> |
- </tr> |
-</table> |
- |
-<h5><a name="1" id="1"></a>UDTSOCKET</h5> |
-<p>This is used as the descriptor of a UDT socket. Its internal is not exposed to application and subject to future changes.</p> |
- |
-<h5><a name="2" id="2"></a>ERRORINFO</h5> |
-<p>The ERRORINFO structure contains the specific information of a UDT error. It has two helper functions to let applications know an integral error code and a piece of text information.</p> |
-<table width="100%" border="1" cellpadding="1" cellspacing="0" bordercolor="#CCCCCC"> |
- <tr> |
- <td width="30%" class="table_headline"><strong>Functions</strong></td> |
- <td width="70%" class="table_headline"><strong>Comments</strong></td> |
- </tr> |
- <tr> |
- <td>int getErrorCode()</td> |
- <td>read the UDT error code</td> |
- </tr> |
- <tr> |
- <td>const char* getErrorMessage()</td> |
- <td>read the text information about the error.</td> |
- </tr> |
- <tr> |
- <td>void clear()</td> |
- <td>clear the error information (set to SUCCESS).</td> |
- </tr> |
-</table> |
- |
-<h5><a name="3" id="3"></a>UDSET</h5> |
-<p>The UDSET structure is used with <a href="select.htm"><strong>select</strong></a> call to access multiple UDT descriptors.</p> |
-<p>Four macros are defined on the UDSET structure to processing a UDT socket set. They are very similar to the fd_set structure and macros in traditional standard socket API.</p> |
- |
-<table width="100%" border="1" cellpadding="1" cellspacing="0" bordercolor="#CCCCCC"> |
- <tr> |
- <td width="30%" class="table_headline"><strong>Macros</strong></td> |
- <td width="70%" class="table_headline"><strong>Comments</strong></td> |
- </tr> |
- <tr> |
- <td>UD_CLR(<em>u</em>, *<em>set</em>)</td> |
- <td>remove socket <em>u</em> from <em>set</em>.</td> |
- </tr> |
- <tr> |
- <td>UD_ISSET(u, *set)</td> |
- <td>check if <em>u</em> is in <em>set</em>.</td> |
- </tr> |
- <tr> |
- <td>UD_SET(<em>u</em>, *<em>set</em>)</td> |
- <td>add <em>u</em> into the <em>set.</em></td> |
- </tr> |
- <tr> |
- <td>UD_ZERO(*<em>set</em>)</td> |
- <td>initialize <em>set</em> to empty.</td> |
- </tr> |
-</table> |
- |
-<h5><a name="4" id="4"></a>TRACEINFO</h5> |
-<p>The TRACEINFO structure stores the performance trace information. Its member attributes can be read directly by applications.</p> |
- |
-<table width="100%" border="1" cellpadding="1" cellspacing="0" bordercolor="#CCCCCC"> |
- <tr> |
- <td width="17%" class="table_headline"><strong>Members</strong></td> |
- <td width="83%" class="table_headline"><strong>Comments</strong></td> |
- </tr> |
- <tr> |
- <td colspan="2"><span class="style1">The following attributes are aggregate values since the UDT socket is created.</span></td> |
- </tr> |
- <tr> |
- <td>int64_t msTimeStamp</td> |
- <td>time elapsed since the UDT socket is created, in milliseconds</td> |
- </tr> |
- <tr> |
- <td>int64_t pktSentTotal</td> |
- <td>total number of sent packets, including retransmissions</td> |
- </tr> |
- <tr> |
- <td>int64_t pktRecvTotal</td> |
- <td>total number of received packets</td> |
- </tr> |
- <tr> |
- <td>int pktSndLossTotal</td> |
- <td>total number of lost packets, measured in the sending side</td> |
- </tr> |
- <tr> |
- <td>int pktRcvLossTotal</td> |
- <td>total number of lost packets, measured in the receiving side</td> |
- </tr> |
- <tr> |
- <td>int pktRetransTotal</td> |
- <td>total number of retransmitted packets, measured in the sending side</td> |
- </tr> |
- <tr> |
- <td>int pktSentACKTotal</td> |
- <td>total number of sent ACK packets</td> |
- </tr> |
- <tr> |
- <td>int pktRecvACKTotal</td> |
- <td>total number of received ACK packets</td> |
- </tr> |
- <tr> |
- <td>int pktSentNAKTotal</td> |
- <td>total number of sent NAK packets</td> |
- </tr> |
- <tr> |
- <td>int pktRecvNAKTotal</td> |
- <td>total number of received NAK packets</td> |
- </tr> |
- <tr> |
- <td colspan="2"><span class="style1">The following attributes are local values since the last time they are recorded.</span></td> |
- </tr> |
- <tr> |
- <td>int64 pktSent</td> |
- <td>number of sent packets, including retransmissions</td> |
- </tr> |
- <tr> |
- <td>int64 pktRecv</td> |
- <td>number of received packets</td> |
- </tr> |
- <tr> |
- <td>int pktSndLoss</td> |
- <td>number of lost packets, measured in the sending side</td> |
- </tr> |
- <tr> |
- <td>int pktRcvLoss</td> |
- <td>number of lost packets, measured in the receiving side</td> |
- </tr> |
- <tr> |
- <td>int pktRetrans</td> |
- <td>number of retransmitted packets, measured in the sending side</td> |
- </tr> |
- <tr> |
- <td>int pktSentACK</td> |
- <td>number of sent ACK packets</td> |
- </tr> |
- <tr> |
- <td>int pktRecvACK</td> |
- <td>number of received ACK packets</td> |
- </tr> |
- <tr> |
- <td>int pktSentNAK</td> |
- <td>number of sent NAK packets</td> |
- </tr> |
- <tr> |
- <td>int pktRecvNAK</td> |
- <td>number of received NAK packets</td> |
- </tr> |
- <tr> |
- <td>double mbpsSendRate</td> |
- <td>sending rate in Mbps</td> |
- </tr> |
- <tr> |
- <td>double mbpsRecvRate</td> |
- <td>receiving rate in Mbps</td> |
- </tr> |
- <tr> |
- <td colspan="2"><span class="style1">The following attributes are instant values at the time they are observed.</span></td> |
- </tr> |
- <tr> |
- <td>double usPktSndPeriod</td> |
- <td>packet sending period, in microseconds</td> |
- </tr> |
- <tr> |
- <td>int pktFlowWindow</td> |
- <td>flow window size, in number of packets</td> |
- </tr> |
- <tr> |
- <td>int pktCongestionWindow</td> |
- <td>congestion window size, in number of packets</td> |
- </tr> |
- <tr> |
- <td>int pktFlightSize</td> |
- <td>number packets on the flight</td> |
- </tr> |
- <tr> |
- <td>double msRTT</td> |
- <td>round trip time, in milliseconds</td> |
- </tr> |
- <tr> |
- <td>double mbpsBandwidth</td> |
- <td>estimated bandwidth, in Mbps</td> |
- </tr> |
- <tr> |
- <td>int byteAvailSndBuf</td> |
- <td>available sending buffer size, in bytes</td> |
- </tr> |
- <tr> |
- <td>int byteAvailRcvBuf</td> |
- <td>available receiving buffer size, in bytes</td> |
- </tr> |
-</table> |
- |
-<h5>See Also</h5> |
-<p><strong><a href="structure.htm">UDT Socket Structures</a></strong></p> |
- |
-<p> </p> |
- |
-</body> |
-</html> |