NDT-DEV email list created

Revision: 454
Author:   

Date:     Thu Aug  4 09:05:17 2011
Log:      Added web100 variables description.
http://code.google.com/p/ndt/source/detail?r=454

Modified:
 /wiki/NDTProtocol.wiki

=======================================
--- /wiki/NDTProtocol.wiki      Thu Aug  4 08:33:42 2011
+++ /wiki/NDTProtocol.wiki      Thu Aug  4 09:05:17 2011
@@ -574,7 +574,7 @@

 The S2C throughput test tests the achievable network bandwidth from the  
Server to the Client by performing a 10 second memory-to-memory data  
transfer.

-The NDT Server uses a [http://www.web100.org/ web100] project to perform a  
detailed connection measurements. This means that the Server is also  
collecting the web100 data variables, that MUST be send to the Client at  
the end of the whole test session.
+The NDT Server uses a [http://www.web100.org/ web100] project to perform a  
detailed connection measurements. This means that the Server is also  
collecting the web100 data variables, that MUST be send to the Client at  
the end of the whole test session. All available web100 data variables are  
described in [NDTProtocol#Appendix_A._web100_variables Appendix A].

 ==== S2C protocol ====

@@ -642,6 +642,8 @@

 where '\n' is a single new line character.

+All available web100 data variables are described in  
[NDTProtocol#Appendix_A._web100_variables Appendix A].
+
 At the end the Server MUST close the S2C test session by sending an empty  
TEST_FINALIZE message.

 A S2C throughput test session overview can be seen on the following  
sequence diagram:
@@ -763,3 +765,72 @@
                |<----------TEST_FINALIZE---------------|

 }}}
+
+= Appendix A. web100 variables =
+
+|| CurMSS || The current maximum segment size (MSS), in octets.||
+|| X_Rcvbuf || The socket receive buffer size in octets.  Note that the  
meaning of this variable is implementation dependent.  In particular, it  
may or may not include the reassembly queue. ||
+|| X_Sndbuf || The socket send buffer size in octets.  Note that the  
meaning of this variable is implementation dependent. Particularly, it may  
or may not include the retransmit queue. ||
+|| !AckPktsIn || The number of valid pure ack packets that have been  
received on this connection by the Local Host. ||
+|| !AckPktsOut || The number of pure ack packets that have been sent on  
this connection by the Local Host. ||
+|| !BytesRetrans || The number of octets retransmitted. ||
+|| !CongAvoid || The number of times the congestion window has been  
increased by the Congestion Avoidance algorithm. ||
+|| !CongestionOverCount || The number of congestion events which  
were 'backed out' of the congestion control state machine such that the  
congestion window was restored to a prior value. This can happen due to the  
Eifel algorithm [http://www.ietf.org/rfc/rfc3522.txt RFC3522] or other  
algorithms which can be used to detect and cancel spurious invocations of  
the Fast Retransmit Algorithm. ||
+|| !CongestionSignals || The number of multiplicative downward congestion  
window adjustments due to all forms of congestion signals, including Fast  
Retransmit, ECN and timeouts. This object summarizes all events that invoke  
the MD portion of AIMD congestion control, and as such is the best  
indicator of how cwnd is being affected by congestion. ||
+|| CountRTT || The number of round trip time samples included in  
tcpEStatsPathSumRTT and tcpEStatsPathHCSumRTT. ||
+|| !CurCwnd || The current congestion window, in octets. ||
+|| CurRTO || The current value of the retransmit timer RTO. ||
+|| !CurRwinRcvd || The most recent window advertisement received, in  
octets. ||
+|| !CurRwinSent || The most recent window advertisement sent, in octets. ||
+|| !CurSsthresh || The current slow start threshold in octets. ||
+|| DSACKDups || The number of duplicate segments reported to the local  
host by D-SACK blocks. ||
+|| !DataBytesIn || The number of octets contained in received data  
segments, including retransmitted data.  Note that this does not include  
TCP headers. ||
+|| !DataBytesOut || The number of octets of data contained in transmitted  
segments, including retransmitted data.  Note that this does not include  
TCP headers. ||
+|| !DataPktsIn || The number of segments received containing a positive  
length data segment. ||
+|| !DataPktsOut || The number of segments sent containing a positive  
length data segment. ||
+|| !DupAcksIn || The number of duplicate ACKs received. ||
+|| ECNEnabled || Enabled(1) if Explicit Congestion Notification (ECN) has  
been negotiated on, selfDisabled(2) if it is disabled or not implemented on  
the local host, or peerDisabled(3) if not negotiated by the remote hosts. ||
+|| !FastRetran || The number of invocations of the Fast Retransmit  
algorithm. ||
+|| !MaxCwnd || The maximum congestion window used during Slow Start, in  
octets. ||
+|| MaxMSS || The maximum MSS, in octets. ||
+|| MaxRTO || The maximum value of the retransmit timer RTO. ||
+|| MaxRTT || The maximum sampled round trip time. ||
+|| !MaxRwinRcvd || The maximum window advertisement received, in octets. ||
+|| !MaxRwinSent || The maximum window advertisement sent, in octets. ||
+|| !MaxSsthresh || The maximum slow start threshold, excluding the initial  
value. ||
+|| MinMSS || The minimum MSS, in octets. ||
+|| MinRTO || The minimum value of the retransmit timer RTO. ||
+|| MinRTT || The minimum sampled round trip time. ||
+|| !MinRwinRcvd || The minimum window advertisement received, in octets. ||
+|| !MinRwinSent || The minimum window advertisement sent, excluding the  
initial unscaled window advertised on the SYN, in octets. ||
+|| !NagleEnabled || True(1) if the Nagle algorithm is being used, else  
false(2). ||
+|| !OtherReductions || The number of congestion window reductions made as  
a result of anything other than AIMD congestion control algorithms.  
Examples of non-multiplicative window reductions include Congestion Window  
Validation [http://www.ietf.org/rfc/rfc2861.txt RFC2861] and experimental  
algorithms such as Vegas. ||
+|| !PktsIn || The total number of segments received. ||
+|| !PktsOut || The total number of segments sent. ||
+|| !PktsRetrans || The number of segments transmitted containing at least  
some retransmitted data. ||
+|| !RcvWinScale || The value of Rcv.Wind.Scale.  Note that !RcvWinScale is  
either zero or the same as !WinScaleSent. ||
+|| SACKEnabled || True(1) if SACK has been negotiated on, else false(2). ||
+|| SACKsRcvd || The number of SACK options received. ||
+|| !SendStall || The number of interface stalls or other sender local  
resource limitations that are treated as congestion signals. ||
+|| !SlowStart || The number of times the congestion window has been  
increased by the Slow Start algorithm. ||
+|| SampleRTT || The most recent raw round trip time measurement used in  
calculation of the RTO. ||
+|| SmoothedRTT || The smoothed round trip time used in calculation of the  
RTO. See SRTT in [http://www.ietf.org/rfc/rfc2988.txt RFC2988]. ||
+|| !SndWinScale || The value of Snd.Wind.Scale.  Note that !SndWinScale is  
either zero or the same as !WinScaleRcvd. ||
+|| !SndLimTimeRwin || The cumulative time spent in the 'Receiver Limited'  
state. ||
+|| !SndLimTimeCwnd || The cumulative time spent in the 'Congestion  
Limited' state. ||
+|| !SndLimTimeSender || The cumulative time spent in the 'Sender Limited'  
state. ||
+|| !SndLimTransRwin || The number of transitions into the 'Receiver  
Limited' state from either the 'Congestion Limited' or 'Sender Limited'  
states. This state is entered whenever TCP transmission stops because the  
sender has filled the announced receiver window. ||
+|| !SndLimTransCwnd || The number of transitions into the 'Congestion  
Limited' state from either the 'Receiver Limited' or 'Sender Limited'  
states. This state is entered whenever TCP transmission stops because the  
sender has reached some limit defined by congestion control (e.g. cwnd) or  
other algorithms (retransmission timeouts) designed to control network  
traffic. ||
+|| !SndLimTransSender || The number of transitions into the 'Sender  
Limited' state from either the 'Receiver Limited' or 'Congestion Limited'  
states. This state is entered whenever TCP transmission stops due to some  
sender limit such as running out of application data or other resources and  
the Karn algorithm. When TCP stops sending data for any reason which can  
not be classified as Receiver Limited or Congestion Limited it MUST be  
treated as Sender Limited. ||
+|| !SndLimBytesRwin || The cumulative bytes sent while in the 'Receiver  
Limited' state, as determined by the Local Host, when the Local Host is a  
sender.  This state is entered whenever TCP transmission stops due to  
Receiver not being able to receive data. ||
+|| !SndLimBytesCwnd ||The cumulative bytes sent while in the 'Congestion  
Limited' state, as determined by the Local Host, when the Local Host is a  
sender.  This state is entered whenever TCP transmission stops due to  
congestion. ||
+|| !SndLimBytesSender || The cumulative bytes sent while in the 'Sender  
Limited' state, as determined by the Local Host, when the Local Host is a  
sender.  This state is entered whenever TCP transmission stops because  
there is no more data in sender's buffer. ||
+|| !SubsequentTimeouts || The number of times the retransmit timeout has  
expired after the RTO has been doubled. See section 5.5 in  
[http://www.ietf.org/rfc/rfc2988.txt RFC2988]. ||
+|| SumRTT || The sum of all sampled round trip times. ||
+|| Timeouts || The number of times the retransmit timeout has expired when  
the RTO backoff multiplier is equal to one. ||
+|| !TimestampsEnabled || Enabled(1) if TCP timestamps have been negotiated  
on, selfDisabled(2) if they are disabled or not implemented on the local  
host, or peerDisabled(3) if not negotiated by the remote hosts. ||
+|| !WinScaleRcvd || The value of the received window scale option if one  
was received; otherwise, a value of -1. ||
+|| !WinScaleSent || The value of the transmitted window scale option if  
one was sent; otherwise, a value of -1. ||
+|| !DupAcksOut || The number of duplicate ACKs sent. ||
+|| !StartTimeUsec || The value of sysUpTime at the time this listener was  
established.  If the current state was entered prior to the last  
re-initialization of the local network management subsystem, then this  
object contains a zero value. ||
+|| Duration || The seconds part of the time elapsed  
between !StartTimeStamp and the most recent protocol event (segment sent or  
received). ||