Documentation of variables for the Web100 TCP Kernel Instrumentation Set (KIS) project. Matt Mathis Jeffrey Semke Raghu Reddy John Heffner Pittsburgh Supercomputing Center Web 100 Project (c) All rights reserved. This document contains incomplete and unpublished research results. This interim version is provided only to enable developers to build an initial tool set. Future version of this document are likely to differ from this version in incompatible ways -- newer versions will completely supersede this version. Terminology: Local Host: the host from which the KIS was read Remote Host: a host that has a TCP connection between the local host and itself SNMP Data Types taken from RFC 1902 "Structure of Management Information for Version 2 of the Simple Network Management Protocol (SNMPv2)" ------------------------------------------------------------------------------ CATEGORY: CONNECTION ID CatDescr: The 5 tuple that uniquely identifies every connection. ------------------------------------------------------------------------------ VariableName: protocol Scope: standard ShortDescr: Protocol type for this connection Category: CONNECTION ID ProcType: Integer32 Description: Protocol type for this connection. R/W: read-only ------------------------------------------------------------------------------ VariableName: LocalAddress Scope: standard ShortDescr: Local IP Address Category: CONNECTION ID ProcType: Ip_Address Description: IP Address of the host from which the KIS was read. R/W: read-only ------------------------------------------------------------------------------ VariableName: LocalAddressType Scope: standard ShortDescr: Local Address Type Category: CONNECTION ID ProcType: Integer Description: The address type of tcpEStatsConnectLocalAddress. Only ipv4(1) and ipv6(2) are expected. R/W: read-only ------------------------------------------------------------------------------ VariableName: LocalPort Scope: standard ShortDescr: Local Port Number Category: CONNECTION ID ProcType: Unsigned16 Description: The Local Host's TCP port number for a connection. R/W: read-only ------------------------------------------------------------------------------ VariableName: RemAddress Scope: standard RenameFrom: RemoteAddress ShortDescr: Remote IP Address Category: CONNECTION ID ProcType: Ip_Address Description: IP Address of the Remote host's end of a connection. R/W: read-only ------------------------------------------------------------------------------ VariableName: RemPort Scope: standard RenameFrom: RemotePort ShortDescr: Remote Port Number Category: CONNECTION ID ProcType: Unsigned16 Description: The Remote Host's TCP port number for a connection. R/W: read-only ------------------------------------------------------------------------------ CATEGORY: WAD CatDescr: Work Around Deamon for the Net100 project. These controls are not safe for general use. ------------------------------------------------------------------------------ VariableName: WAD_IFQ Scope: internal ShortDescr: Disable enter_cwr when IF queue is full Category: WAD ProcType: Gauge32 Description: Disable enter_cwr when IF queue is full R/W: read-write ------------------------------------------------------------------------------ VariableName: WAD_MaxBurst Scope: internal ShortDescr: Allow bursts when cwnd is greater than awnd Category: WAD ProcType: Gauge32 Description: Cwnd is limited to WAD_MaxBurst above the actual window. Set it very large if you want no burst suppression. The system default is 3. R/W: read-write ------------------------------------------------------------------------------ CATEGORY: CONNECTION STATE CatDescr: Flags indicating if various protocol features or algorithms are enabled. All of the options listed here are fully described in various standards documents. SNMPfile: 1conn SNMPprefix: tcpEStatsConnection ------------------------------------------------------------------------------ VariableName: State Scope: standard ShortDescr: TCP State Category: CONNECTION STATE ProcType: INTEGER Description: An integer value representing the connection state from the TCP State Transition Diagram. R/W: read-only Comment: @@@@@@@@ Update descr PossibleValues: wcStateClosed(1) wcStateListen(2) wcStateSynSent(3) wcStateSynReceived(4) wcStateEstablished(5) wcStateFinWait1(6) wcStateFinWait2(7) wcStateCloseWait(8) wcStateLastAck(9) wcStateClosing(10) wcStateTimeWait(11) wcStateDeleteTcb(12) ------------------------------------------------------------------------------ VariableName: SACKEnabled Scope: standard SNMPname: SACK ShortDescr: SACK Enabled Category: CONNECTION STATE ProcType: TruthValue Description: True(1) if SACK has been negotiated on, else false(2). See RFC 2018. R/W: read-only ------------------------------------------------------------------------------ VariableName: TimestampsEnabled Scope: standard SNMPname: TimeStamps ShortDescr: Timestamps Enabled Category: CONNECTION STATE ProcType: TruthValue Description: True(1) if timestamps have been negotiated on, else false(2). See RFC 1323. R/W: read-only ------------------------------------------------------------------------------ VariableName: ECNEnabled Scope: standard SNMPname: ECN ShortDescr: Explicit Congestion Notification is Enabled Category: CONNECTION STATE ProcType: TruthValue Description: True(1) if ECN has been negotiated on, else false(2). R/W: read-only ------------------------------------------------------------------------------ VariableName: NagleEnabled Scope: standard SNMPname: Nagle ShortDescr: Nagle Algorithm Enabled Category: CONNECTION STATE ProcType: TruthValue Description: True(1) if the Nagle algorithm is being used, else false(2). R/W: read-only ------------------------------------------------------------------------------ VariableName: SndWinScale Scope: standard SNMPname: SndWindScale ShortDescr: Window scale used by the sender to decode sed.wnd Category: CONNECTION STATE ProcType: Integer32 Description: The value of Snd.Wind.Scale from RFC 1323. Note that SndWindScale is either zero or the same as WinScaleRcvd. R/W: read-only ------------------------------------------------------------------------------ VariableName: RcvWinScale Scope: standard SNMPname: RcvWindScale ShortDescr: Window scale used by the receiver to encode seg.wnd Category: CONNECTION STATE ProcType: Integer32 Description: The value of Rcv.Wind.Scale from RFC 1323. Note that RcvWindScale is either zero or the same as WinScaleSent. R/W: read-only ------------------------------------------------------------------------------ CATEGORY: SYN OPTIONS CatDescr: Statistics on options present on the SYN and SYN-ACK. SNMPfile: 2synops SNMPprefix: tcpEStatsSynOpts ------------------------------------------------------------------------------ VariableName: ActiveOpen Scope: standard ShortDescr: True if local host was the one that sent the SYN. Category: SYN OPTIONS ProcType: TruthValue Description: True(1) if the local connection traversed the SYN-SENT state, else false(2). See RFC 793. R/W: read-only ------------------------------------------------------------------------------ VariableName: MSSSent Scope: standard ShortDescr: Mss Option sent Category: SYN OPTIONS ProcType: Gauge32 Description: The value sent in an MSS option, or zero if none. R/W: read-only ------------------------------------------------------------------------------ VariableName: MSSRcvd Scope: standard ShortDescr: MSS Option received Category: SYN OPTIONS ProcType: Gauge32 Description: The value received in an MSS option, or zero if none. R/W: read-only ------------------------------------------------------------------------------ VariableName: WinScaleSent Scope: standard # RenameFrom: SendWinScale ShortDescr: Requested Window Scale Out Category: CONNECTION STATE ProcType: Integer32 PossibleValues: (-1..14) Description: The value of the transmitted window scale option if one was sent; otherwise, a value of -1. See RFC 1323. R/W: read-only ------------------------------------------------------------------------------ VariableName: WinScaleRcvd Scope: standard # RenameFrom: RecvWinScale ShortDescr: requested window scale Category: CONNECTION STATE ProcType: Integer32 PossibleValues: (-1..14) Description: The value of the received window scale option if one was received; otherwise, a value of -1. See RFC 1323. R/W: read-only ------------------------------------------------------------------------------ VariableName: SACKokSent Scope: standard ShortDescr: SACKok was sent in SYN or SYN-ACK Category: SYN OPTIONS ProcType: TruthValue Description: True(1) if SACKok option was sent, else false(2). See RFC 2018. R/W: read-only ------------------------------------------------------------------------------ VariableName: SACKokRcvd Scope: standard ShortDescr: SACKok was seen in SYN or SYN-ACK Category: SYN OPTIONS ProcType: TruthValue Description: True(1) if SACKok option was received, else false(2). See RFC 2018. R/W: read-only ------------------------------------------------------------------------------ VariableName: TimeStampSent Scope: standard ShortDescr: Timestamp sent in SYN or SYN-ACK Category: SYN OPTIONS ProcType: TruthValue Description: True(1) if Timestamp option was sent, else false(2). See RFC 1323. R/W: read-only ------------------------------------------------------------------------------ VariableName: TimeStampRcvd Scope: standard ShortDescr: Timestamp received in SYN or SYN-ACK Category: SYN OPTIONS ProcType: TruthValue Description: True(1) if Timestamp option was received, else false(2). See RFC 1323. R/W: read-only ------------------------------------------------------------------------------ CATEGORY: DATA TRAFFIC CatDescr: Statistics on aggregate packets and data sent on a connection. These provide a direct measure of the Internet capacity consumed by a connection. SNMPfile: 3data SNMPprefix: tcpEStatsData ------------------------------------------------------------------------------ VariableName: PktsOut Scope: standard ShortDescr: Total Packets Out Category: DATA TRAFFIC ProcType: Counter32 Description: The total number of packets sent. R/W: read-only ------------------------------------------------------------------------------ VariableName: DataPktsOut Scope: standard ShortDescr: Data Packets Out Category: DATA TRAFFIC ProcType: Counter32 Description: The number of packets sent containing a positive length data segment. R/W: read-only ------------------------------------------------------------------------------ VariableName: DataBytesOut Scope: standard ShortDescr: Data Bytes Out Category: DATA TRAFFIC ProcType: Counter64 Description: The number of octets of data contained in transmitted segments, including retransmitted data. R/W: read-only ------------------------------------------------------------------------------ VariableName: PktsIn Scope: standard ShortDescr: Total Packets In Category: DATA TRAFFIC ProcType: Counter32 Description: The total number of packets received. R/W: read-only ------------------------------------------------------------------------------ VariableName: DataPktsIn Scope: standard ShortDescr: Total Data Packets In Category: DATA TRAFFIC ProcType: Counter32 Description: The number of packets received containing a positive length data segment. R/W: read-only ------------------------------------------------------------------------------ VariableName: DataBytesIn Scope: standard ShortDescr: Data Bytes In Category: DATA TRAFFIC ProcType: Counter64 Description: The number of octets contained in received data segments, including retransmitted data. Note that this does not include TCP headers. R/W: read-only ------------------------------------------------------------------------------ VariableName: SoftErrors Scope: standard ShortDescr: Soft Errors Category: LOCAL RECEIVER ProcType: Counter32 Description: The number packets that fail various consistency tests. R/W: read-only ------------------------------------------------------------------------------ VariableName: SoftErrorReason Scope: standard ShortDescr: Identifies the consistency test that most recently failed Category: LOCAL RECEIVER ProcType: INTEGER Description: Identifies the consistency test that most recently failed. R/W: read-only PossibleValues: belowDataWindow(1) /* network reordering, window probe or keep alive */ aboveDataWindow(2) /* impl bug or fraud only */ belowAckWindow(3) /* network reordering */ aboveAckWindow(4) /* impl bug or fraud only */ belowTSWindow(5) /* PAWS detected network reordering */ aboveTSWindow(6) /* impl bug or fraud only */ dataCheckSum(7) /* incorrect checksum */ ------------------------------------------------------------------------------ VariableName: IpTtl Scope: standard ShortDescr: TTL on the incomming segment Category: DATA TRAFFIC ProcType: Integer32 Description: The value of the TTL field carried in the most recently received IP header. R/W: read-only ------------------------------------------------------------------------------ CATEGORY: DATA SEQUENCE CatDescr: Sequence numbers and throughput statistics for the connection ------------------------------------------------------------------------------ VariableName: SndUna Scope: standard RenameFrom: snd_una ShortDescr: Oldest Unacknowledged Sequence Number. See RFC 793. Category: DATA SEQUENCE ProcType: Counter32 Description: The value of SND.UNA, the oldest unacknowledged sequence number. R/W: read-only ------------------------------------------------------------------------------ VariableName: SndNxt Scope: standard RenameFrom: snd_nxt ShortDescr: Next Sequence Number to be Sent Category: DATA SEQUENCE ProcType: Integer32 Description: The value of SND.NXT, the next sequence number to be sent. Note that TCP can retransmit lost data by pulling SndNxt back to the lost data. See 793. R/W: read-only ------------------------------------------------------------------------------ VariableName: SndMax Scope: standard RenameFrom: snd_max ShortDescr: Maximum Value of snd_nxt Category: DATA SEQUENCE ProcType: Counter32 Description: The farthest forward (right most) SND.NXT value. Note that this will be equal to snd_nxt except when snd_nxt is pulled back during a recovery. R/W: read-only ------------------------------------------------------------------------------ VariableName: ThruBytesAcked Scope: standard RenameFrom: ThruBytesSent ShortDescr: Total throughput bytes sent Category: DATA SEQUENCE ProcType: Counter64 Description: The number of octets for which cumulative acknowledgments have been received. Note that this will be the sum of changes in snd_una, accounting for sequence wraps. R/W: read-only ------------------------------------------------------------------------------ VariableName: SndISS Scope: standard SNMPname: SndInitial ShortDescr: Initial SYN sequence number Category: DATA SEQUENCE ProcType: Counter32 Description: Initial send sequence number. R/W: read-only ------------------------------------------------------------------------------ VariableName: RcvNxt Scope: standard RenameFrom: rcv_nxt ShortDescr: Next sequence number expected on an incoming segment Category: DATA SEQUENCE ProcType: Counter32 Description: The value of RCV.NXT from RFC 793. The next sequence number expected on an incoming segment, and the left or lower edge of the receive window. R/W: read-only ------------------------------------------------------------------------------ VariableName: ThruBytesReceived Scope: standard ShortDescr: Total throughput bytes received Category: DATA SEQUENCE ProcType: Counter64 Description: The number of octets for which cumulative acknowledgments have been sent. Note that this will be the sum of changes in rcv_nxt, accounting for sequence wraps. R/W: read-only ------------------------------------------------------------------------------ VariableName: RecvISS Scope: standard SNMPname: RecInitial ShortDescr: Initial receive sequence number Category: DATA SEQUENCE ProcType: Counter32 Description: Initial receive sequence number. R/W: read-only ------------------------------------------------------------------------------ VariableName: Duration Scope: standard RenameFrom: CurrTime ShortDescr: Duration Category: DATA TRAFFIC ProcType: Counter64 Description: Connection duration in micro-seconds from StartTime to the most recent protocol event (packet sent or received). R/W: read-only ------------------------------------------------------------------------------ VariableName: StartTimeUsec Scope: standard SNMPname: StartTimeStamp RenameFrom: StartTimeSec StartTime ShortDescr: Start Time Category: DATA TRAFFIC ProcType: Integer32 SNMPType: DateAndTime Description: Time of the start of the connection. R/W: read-only ------------------------------------------------------------------------------ CATEGORY: SENDER CONGESTION TRIAGE CatDescr: First level instruments to determine which subsystems are controlling overall performance by throttling TCP data transmission. The three parallel sets of instruments measure the extent to which the receiver window, network congestion or the sender's available data limit TCP's performance. They reflect bottlenecks at the receiver, network or sender respectively. SNMPfile: 4congest SNMPprefix: tcpEStatsSndCong ------------------------------------------------------------------------------ VariableName: SndLimTransRwin Scope: standard ShortDescr: Receiver Limited Transitions Category: SENDER CONGESTION TRIAGE ProcType: Counter32 Description: 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. R/W: read-only ------------------------------------------------------------------------------ VariableName: SndLimTimeRwin Scope: standard ShortDescr: Receiver Limited Time Category: SENDER CONGESTION TRIAGE ProcType: Counter32 Description: The cumulative time (in msecs) spent in the "Receiver Limited" state. See SndLimTransRwin. R/W: read-only ------------------------------------------------------------------------------ VariableName: SndLimBytesRwin Scope: standard ShortDescr: Receiver Limited Bytes Category: SENDER CONGESTION TRIAGE ProcType: Counter64 Description: The cumulative octets sent while in the "Receiver Limited" state. See SndLimTransRwin. R/W: read-only ------------------------------------------------------------------------------ VariableName: SndLimTransCwnd Scope: standard ShortDescr: Congestion Limited Transitions Category: SENDER CONGESTION TRIAGE ProcType: Counter32 Description: 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. R/W: read-only ------------------------------------------------------------------------------ VariableName: SndLimTimeCwnd Scope: standard ShortDescr: Congestion Limited Time Category: SENDER CONGESTION TRIAGE ProcType: Counter32 Description: The cumulative time (in msecs) spent in the "Congestion Limited" state. See SndLimTransCwnd. When there is a retransmission timeout, in should be counted in SndLimTimeCwnd (and not the cumulative time for some other state.) R/W: read-only ------------------------------------------------------------------------------ VariableName: SndLimBytesCwnd Scope: standard ShortDescr: Congestion Limited Bytes Category: SENDER CONGESTION TRIAGE ProcType: Counter64 Description: The cumulative bytes sent while in the "Congestion Limited" state. See SndLimTransCwnd. R/W: read-only ------------------------------------------------------------------------------ VariableName: SndLimTransSender Scope: standard SNMPname: SndLimTransSnd ShortDescr: Sender Limited Transitions Category: SENDER CONGESTION TRIAGE ProcType: Counter32 Description: 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. R/W: read-only ------------------------------------------------------------------------------ VariableName: SndLimTimeSender Scope: standard SNMPname: SndLimTimeSnd ShortDescr: Sender Limited Time Category: SENDER CONGESTION TRIAGE ProcType: Counter32 Description: The cumulative time (in msecs) spent in the "Sender Limited" state. See SndLimTransSnd. R/W: read-only ------------------------------------------------------------------------------ VariableName: SndLimBytesSender Scope: standard SNMPname: SndLimBytesSnd ShortDescr: Sender Limited Bytes Category: SENDER CONGESTION TRIAGE ProcType: Counter64 Description: The cumulative bytes sent while in the "Sender Limited" state. See SndLimTransSnd. R/W: read-only ------------------------------------------------------------------------------ CATEGORY: SENDER CONGESTION MODEL CatDescr: Instruments on abstract events needed to model congestion along the network path. These instruments are sufficient to fit the actual performance to an updated macroscopic performance model. See RFC 2581. ------------------------------------------------------------------------------ VariableName: SlowStart Scope: standard ShortDescr: Slow Start Window Opens Category: SENDER CONGESTION MODEL ProcType: Counter32 Description: The number of times the congestion window has been increased by the Slow Start algorithm. See RFC 2581. R/W: read-only ------------------------------------------------------------------------------ VariableName: CongAvoid Scope: standard ShortDescr: Congestion Avoidance Window Opens Category: SENDER CONGESTION MODEL ProcType: Counter32 Description: The number of times the congestion window has been increased by the Congestion Avoidance algorithm. See RFC 2581. R/W: read-only ------------------------------------------------------------------------------ VariableName: CongestionSignals Scope: standard SNMPname: CongSignals RenameFrom: Recoveries PreCongCountRTT ShortDescr: Total Congestion Signals. Category: SENDER CONGESTION MODEL ProcType: Counter32 Description: The number of multiplicative downward congestion window adjustments due to all forms of congestion signals, including Fast Retransmit, ECN and timeouts. Note that retransmission timeouts multiplicatively reduce the window implicitly by setting ssthresh. In order to minimize spurious congestion indications due to out of order segments, CongstionSignals should be increment in association with the Fast Retransmit algorithm. R/W: read-only ------------------------------------------------------------------------------ VariableName: OtherReductions Scope: standard ShortDescr: Other Congestion Window Reductions Category: SENDER CONGESTION MODEL ProcType: Counter32 Description: The number of congestion window reductions made as a result of anything other than AIMD congestion control algorithms. All window reductions MUST be counted as either CongestionSignals or OtherReductions. Examples of non-multiplicative window reductions include experimental algorithms such as Vegas. R/W: read-only Comment: @@@@@@@ Need to cite Vegas ------------------------------------------------------------------------------ VariableName: CongestionOverCount Scope: standard SNMPname: CongOverCount ShortDescr: Overcounted congestion Signals Category: SENDER CONGESTION MODEL ProcType: Counter32 Description: 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. Backed out congestion events can not be backed out of CongestionSignals and PreCongSumCwnd, etc. R/W: read-only ------------------------------------------------------------------------------ VariableName: CwndRestores Scope: standard ShortDescr: Number of time cwnd is setback to a prior value Category: SENDER CONGESTION MODEL ProcType: Counter32 Description: The number of times cwnd is restored from a prior saved value R/W: read-only Comment: This may replace CongestionOverCount ------------------------------------------------------------------------------ VariableName: CurCwnd Scope: standard RenameFrom: CurrentCwnd ShortDescr: Current Congestion Window Category: SENDER CONGESTION MODEL ProcType: Gauge32 Description: The current congestion window, in octets. R/W: read-only ------------------------------------------------------------------------------ VariableName: MaxSsCwnd Scope: standard RenameFrom: MaxCwnd ShortDescr: Maximum SS Congestion Window Category: SENDER CONGESTION MODEL ProcType: Gauge32 Description: The maximum congestion window used during Slow Start, in octets. R/W: read-only ------------------------------------------------------------------------------ VariableName: MaxCaCwnd Scope: standard ShortDescr: Maximum CA Congestion Window Category: SENDER CONGESTION MODEL ProcType: Gauge32 Description: The maximum congestion window used during Congestion Avoidence, in octets. R/W: read-only ------------------------------------------------------------------------------ VariableName: LimCwnd Scope: standard ShortDescr: Maximum Congestion Window Category: SENDER CONGESTION MODEL ProcType: Gauge32 Description: The maximum congestion window which may be used, in octets. R/W: read-write ------------------------------------------------------------------------------ VariableName: CurSsthresh Scope: standard RenameFrom: CurrentSsthresh ShortDescr: Current Slowstart Threshold Category: SENDER CONGESTION MODEL ProcType: Gauge32 Description: The current slow start threshold in octets. R/W: read-only ------------------------------------------------------------------------------ VariableName: MaxSsthresh Scope: standard ShortDescr: Maximum Slowstart Threshold Category: SENDER CONGESTION MODEL ProcType: Gauge32 Description: The maximum slow start threshold, excluding the initial value. R/W: read-only ------------------------------------------------------------------------------ VariableName: MinSsthresh Scope: standard ShortDescr: Minimum Slowstart Threshold Category: SENDER CONGESTION MODEL ProcType: Gauge32 Description: The minimum slow start threshold. R/W: read-only ------------------------------------------------------------------------------ CATEGORY: SENDER PATH LOSS MODEL CatDescr: Instruments that characterize the segment loss mechanism by collecting statistics on how the losses are correlated to other losses and protocol events. SNMPfile: 5path SNMPprefix: tcpEStatsPath ------------------------------------------------------------------------------ VariableName: FastRetran Scope: standard ShortDescr: Fast Retransmits Category: SENDER PATH LOSS MODEL ProcType: Counter32 Description: The number of invocations of the Fast Retransmit algorithm. See RFC 2581. R/W: read-only ------------------------------------------------------------------------------ VariableName: Timeouts Scope: standard ShortDescr: Number of Initial Timeouts Category: SENDER PATH LOSS MODEL ProcType: Counter32 Description: The number of times the retransmit timeout has expired when the RTO backoff multiplier is equal to one. See RFC 2988. R/W: read-only. ------------------------------------------------------------------------------ VariableName: SubsequentTimeouts Scope: standard ShortDescr: Subsequent (repeated) Timeouts Category: SENDER PATH LOSS MODEL ProcType: Counter32 Description: The number of times the retransmit timeout has expired when the RTO backoff multiplier is greater than one. See RFC 2988. R/W: read-only ------------------------------------------------------------------------------ VariableName: CurTimeoutCount Scope: standard RenameFrom: CurrTimeoutCount ShortDescr: Current Repeated Timeout Count Category: SENDER PATH LOSS MODEL ProcType: Gauge32 Description: The current number of times the retransmit timeout has expired without receiving an acknowledgment for new data. See RFC 2988. R/W: read-only ------------------------------------------------------------------------------ VariableName: AbruptTimeouts Scope: standard ShortDescr: Abrupt Timeouts Category: SENDER PATH LOSS MODEL ProcType: Counter32 Description: The number of timeouts that occured without any immediately preceding duplicate acknowledgments or other indications of congestion as determined by the implementation. R/W: read-only ------------------------------------------------------------------------------ VariableName: PktsRetrans Scope: standard ShortDescr: Packets With Retransmitted Data Category: SENDER PATH LOSS MODEL ProcType: Counter32 Description: The number of segments transmitted containing at least some retransmitted data. R/W: read-only ------------------------------------------------------------------------------ VariableName: BytesRetrans Scope: standard ShortDescr: Retransmitted Bytes Category: SENDER PATH LOSS MODEL ProcType: Counter32 Description: The number of octets retransmitted. R/W: read-only ------------------------------------------------------------------------------ VariableName: DupAcksIn Scope: standard ShortDescr: Number of Duplicate Acks Received Category: SENDER PATH LOSS MODEL ProcType: Counter32 Description: The number of duplicate ACKs received. R/W: read-only ------------------------------------------------------------------------------ VariableName: SACKsRcvd Scope: standard ShortDescr: Number of SACKs Options Received Category: SENDER PATH LOSS MODEL ProcType: Counter32 Description: The number of SACK options received. See RFC 2018. R/W: read-only ------------------------------------------------------------------------------ VariableName: SACKBlocksRcvd Scope: standard ShortDescr: Number of SACKs blocks Received Category: SENDER PATH LOSS MODEL ProcType: Counter32 Description: The number of SACK blocks received (within SACK options). R/W: read-only ------------------------------------------------------------------------------ VariableName: PreCongSumCwnd Scope: standard RenameFrom: SumCwndAtCong ShortDescr: Sum Congestion Window at Congestion Category: SENDER CONGESTION MODEL ProcType: Counter32 Description: The sum of the values of the congestion window, in octets, captured each time a congestion signal is received. This MUST be updated each time CongestionSignals is incremented, such that the ratio is the average window at congestion. R/W: read-only ------------------------------------------------------------------------------ VariableName: PreCongSumRTT Scope: standard ShortDescr: Sum of the RTT as measured just before congestion. Category: SENDER PATH LOSS MODEL ProcType: Counter32 Description: Sum of the last sample of the RTT (SampledRTT) prior to a received congestion signals. This MUST be updated each time CongestionSignals is incremented, such that the ratio is the average RTT just prior to congestion. R/W: read-only ------------------------------------------------------------------------------ VariableName: PostCongSumRTT Scope: standard ShortDescr: Sum of the RTT as measured just after congestion. Category: SENDER PATH LOSS MODEL ProcType: Counter32 Description: Sum of the first RTT sample following a received congestion signal. R/W: read-only ------------------------------------------------------------------------------ VariableName: PostCongCountRTT Scope: standard ShortDescr: Count of the RTT as measured just after congestion Category: SENDER PATH LOSS MODEL ProcType: Counter32 Description: The number of RTT samples included in PostCongSumRTT, such that the ratio is average RTT just after congestion. R/W: read-only ------------------------------------------------------------------------------ CATEGORY: SENDER PATH OTHER SIGNALS CatDescr: Instruments at the sender to detect other types of non-loss congestion signals such as source quench or ECN. ------------------------------------------------------------------------------ VariableName: ECNsignals Scope: standard ShortDescr: All ECN congestions signals Category: SENDER PATH OTHER SIGNALS ProcType: Counter32 Description: The number of congestion signals delivered via all forms of explicit congestion notification including the ECE bit and failing the ECN nonce check, etc. R/W: read-only ------------------------------------------------------------------------------ VariableName: ECERcvd Scope: standard ShortDescr: ECE congestions signals Category: SENDER PATH OTHER SIGNALS ProcType: Counter32 Description: The number of congestion signals received via the RFC3168 ECE bit. R/W: read-only ------------------------------------------------------------------------------ VariableName: SendStall Scope: standard ShortDescr: local resource stalls treated as congestion signals Category: SENDER PATH OTHER SIGNALS ProcType: Counter32 Description: The number of interface stalls or other sender local resource limitations that are treated as congestion signals. R/W: read-only ------------------------------------------------------------------------------ VariableName: QuenchRcvd Scope: standard ShortDescr: ICMP Quench Messages received Category: SENDER PATH OTHER SIGNALS ProcType: Counter32 Description: The number of ICMP quench messages that are treated as congestion signals. R/W: read-only ------------------------------------------------------------------------------ CATEGORY: SENDER PATH REORDER MODEL CatDescr: Instruments at the sender to infer that the TCP's reliable delivery mechanisms are being confused by packet reordering on the path from the sender to the receiver. ------------------------------------------------------------------------------ VariableName: RetranThresh Scope: standard ShortDescr: Duplicate ACKs needed to trigger FR Category: SENDER PATH REORDER MODEL ProcType: Gauge32 Description: The number of duplicate acknowledgments required to trigger Fast Retransmit. R/W: read-only ------------------------------------------------------------------------------ VariableName: SndDupAckEpisodes Scope: standard ShortDescr: Dup Ack Episodes Category: SENDER PATH REORDER MODEL ProcType: Integer32 Description: The number of times that a duplicate acknowledgment episode ends without a retransmission (e.g. due to reorderd data). R/W: read-only ------------------------------------------------------------------------------ VariableName: SumBytesReordered Scope: standard ShortDescr: Sum Bytes Reordered Category: SENDER PATH REORDER MODEL ProcType: Integer32 Description: The sum of the amounts SND.UNA advances on the acknowledgment which ends a dup-ack episodes without a retransmission. R/W: read-only ------------------------------------------------------------------------------ VariableName: NonRecovDA Scope: standard ShortDescr: Duplicate Acks attributed to Out-of-Order Category: SENDER PATH REORDER MODEL ProcType: Counter32 Description: Duplicate acks (or SACKS) attributed to out-of-order segments because they were withdrawn prior to reaching RetranThresh and triggering fast retransmit. R/W: read-only ------------------------------------------------------------------------------ VariableName: AckAfterFR Scope: standard ShortDescr: ACKs following FR, but not due to FR (way ooo) Category: SENDER PATH REORDER MODEL ProcType: Counter32 Description: The number of acknowledgments reporting out-of-order segments after the segments have already be retransmitted (e.g. as detected by the Eiffel algorithm). R/W: read-only ------------------------------------------------------------------------------ VariableName: DSACKDups Scope: standard ShortDescr: Duplicate Data DSACK Reports Category: SENDER PATH REORDER MODEL ProcType: Counter32 Description: The number of duplicate segments reported to the local host by D-SACK blocks. See RFC 2883. R/W: read-only ------------------------------------------------------------------------------ CATEGORY: SENDER PATH RTT CatDescr: Instruments on the round trip time and the retransmission timeout timer. See RFC 2988. ------------------------------------------------------------------------------ VariableName: SampleRTT Scope: standard RenameFrom: SampledRTT ShortDescr: Most recent RTT sample Category: SENDER PATH RTT ProcType: Gauge32 Description: The most recent raw round trip time measurement, in milliseconds, used in calculation of the RTO. R/W: read-only ------------------------------------------------------------------------------ VariableName: SmoothedRTT Scope: standard ShortDescr: Smoothed RTT Category: SENDER PATH RTT ProcType: Gauge32 Description: The smoothed round trip time, in milliseconds, used in calculation of the RTO. See SRTT in RFC 2988 R/W: read-only ------------------------------------------------------------------------------ VariableName: RTTVar Scope: standard ShortDescr: RTT variation Category: SENDER PATH RTT ProcType: Gauge32 Description: The round trip time variation, in milliseconds, used in calculation of the RTO. See RTTVAR in RFC 2988. R/W: read-only ------------------------------------------------------------------------------ VariableName: MaxRTT Scope: standard ShortDescr: Maximum RTT Category: SENDER PATH RTT ProcType: Gauge32 Description: The maximum sampled round trip time, in milliseconds. R/W: read-only ------------------------------------------------------------------------------ VariableName: MinRTT Scope: standard ShortDescr: Minimum RTT Category: SENDER PATH RTT ProcType: Gauge32 Description: The minimum sampled round trip time, in milliseconds. R/W: read-only ------------------------------------------------------------------------------ VariableName: SumRTT Scope: standard ShortDescr: Cumulative RTT Category: SENDER PATH RTT ProcType: Counter64 Description: The sum of all sampled round trip times, in milliseconds. R/W: read-only ------------------------------------------------------------------------------ VariableName: CountRTT Scope: standard ShortDescr: Category: SENDER PATH RTT ProcType: Counter32 Description: The number of round trip time samples included in SumRTT. R/W: read-only ------------------------------------------------------------------------------ VariableName: CurRTO Scope: standard RenameFrom: CurrentRTO ShortDescr: Current Retransmission Timer Category: SENDER PATH RTT ProcType: Gauge32 Description: The current value of the retransmit timer RTO, in milliseconds, not scaled by the RTO backoff multiplier. See RFC 2988. R/W: read-only ------------------------------------------------------------------------------ VariableName: MaxRTO Scope: standard ShortDescr: Maximum Retransmission Timer Category: SENDER PATH RTT ProcType: Gauge32 Description: The maximum value of the retransmit timmer RTO, in milliseconds, not scaled by the RTO backoff multiplier. See RFC 2988. R/W: read-only ------------------------------------------------------------------------------ VariableName: MinRTO Scope: standard ShortDescr: Minimum Retransmission Timer Category: SENDER PATH RTT ProcType: Gauge32 Description: The minimum value of the retransmit timmer RTO, in milliseconds, not scaled by the RTO backoff multiplier. See RFC 2988. R/W: read-only ------------------------------------------------------------------------------ CATEGORY: SENDER PATH SEGMENT SIZE CatDescr: Sender's maximum segment size, and the range of values explored by the path MTU discovery algorithm. ------------------------------------------------------------------------------ VariableName: CurMSS Scope: standard RenameFrom: CurrentMSS ShortDescr: Current Maximum Segment Size Category: SENDER PATH SEGMENT SIZE ProcType: Gauge32 Description: The current maximum segment size (MSS), in octets. R/W: read-only ------------------------------------------------------------------------------ VariableName: MaxMSS Scope: standard ShortDescr: Maximum MSS Category: SENDER PATH SEGMENT SIZE ProcType: Gauge32 Description: The maximum MSS, in octets. See RFC 1191. R/W: read-only ------------------------------------------------------------------------------ VariableName: MinMSS Scope: standard ShortDescr: Minimum MSS Category: SENDER PATH SEGMENT SIZE ProcType: Gauge32 Description: The minimum MSS, in octets. See RFC 1191. R/W: read-only ------------------------------------------------------------------------------ CATEGORY: SENDER BUFFER CatDescr: Instruments and controls on the senders buffer usage, including any buffering in the application interface to TCP and the retransmit queue. All "buffer memory" instruments are assumed to include OS data structure overhead. SNMPfile: 6sendbuf SNMPprefix: tcpEStatsSendBuff ------------------------------------------------------------------------------ VariableName: CurRetxQueue Scope: standard RenameFrom: CurRetranQueue ShortDescr: Current size of retransmit queue Category: SENDER BUFFER ProcType: Gauge32 Description: The current number of bytes of data occupying the retransmit queue. R/W: read-only ------------------------------------------------------------------------------ VariableName: MaxRetxQueue Scope: standard RenameFrom: MaxRetranQueue ShortDescr: Maximum size of retransmit queue Category: SENDER BUFFER ProcType: Gauge32 Description: The maximum number of bytes of data occupying the retransmit queue. R/W: read-only ------------------------------------------------------------------------------ VariableName: CurAppWQueue Scope: standard ShortDescr: Current size of application write queue Category: SENDER BUFFER ProcType: Gauge32 Description: The current number of bytes of untransmitted application data queued pending first transmission. untransmitted data. R/W: read-only ------------------------------------------------------------------------------ VariableName: MaxAppWQueue Scope: standard ShortDescr: Maximum size of application write queue Category: SENDER BUFFER ProcType: Gauge32 Description: The maximum number of bytes of untransmitted application data queued pending first transmission. untransmitted data. R/W: read-only ------------------------------------------------------------------------------ VariableName: X_SBufMode Scope: internal ShortDescr: Send buffer mode Category: SENDER BUFFER ProcType: Gauge32 Description: A mechanism for changing the send buffering mode of a connection. Current values taken may be: (0) Default Linux kernel buffering (1) Web100 "autotuned" buffering R/W: read-write ------------------------------------------------------------------------------ VariableName: X_Sndbuf Scope: internal ShortDescr: Socket sndbuf size Category: SENDER BUFFER ProcType: Gauge32 Description: The socket send buffer size is bytes. Note that the meaning of this variable is implementation dependent. Particularly, it may or may not include the retransmit queue. R/W: read-only ------------------------------------------------------------------------------ CATEGORY: LOCAL RECEIVER CatDescr: Instruments on the state of the Local receiver. SNMPfile: 7receiver SNMPprefix: tcpEStatsRec ------------------------------------------------------------------------------ VariableName: CurRwinSent Scope: standard RenameFrom: CurrentRwinSent ShortDescr: current receiver window out Category: LOCAL RECEIVER ProcType: Gauge32 Description: The most recent window advertisement sent, in octets. R/W: read-only ------------------------------------------------------------------------------ VariableName: MaxRwinSent Scope: standard ShortDescr: maximum receiver window out Category: LOCAL RECEIVER ProcType: Gauge32 Description: The maximum window advertisement sent, in octets. R/W: read-only ------------------------------------------------------------------------------ VariableName: MinRwinSent Scope: standard ShortDescr: minimum receiver window out Category: LOCAL RECEIVER ProcType: Gauge32 Description: The minimum window advertisement sent, excluding the initial unscaled window advertised on the SYN, in octets. R/W: read-only ------------------------------------------------------------------------------ VariableName: LimRwin Scope: standard ShortDescr: Bound on announced receiver window Category: LOCAL RECEIVER ProcType: Gauge32 Description: The maximum window advertisement which may be sent, in octets. R/W: read-write ------------------------------------------------------------------------------ VariableName: DupAckEpisodes Scope: standard ShortDescr: Number of Duplicate Acks Sent when prior Ack was not duplicate Category: LOCAL RECEIVER ProcType: Counter32 Description: The number of times that a contiguous series of duplicate acknowledgments have been sent. R/W: read-only ------------------------------------------------------------------------------ VariableName: DupAcksOut Scope: standard ShortDescr: Number of Duplicate Acks Sent Category: LOCAL RECEIVER ProcType: Counter32 Description: The number of duplicate ACKs sent. R/W: read-only ------------------------------------------------------------------------------ VariableName: CERcvd Scope: standard ShortDescr: Received segments with Congestion Experienced bits Category: LOCAL RECEIVER ProcType: Counter32 Description: Received segments with Congestion Experienced bits. See RFC 2481. R/W: read-only ------------------------------------------------------------------------------ VariableName: ECNSent Scope: standard ShortDescr: Number of times CE bits have set ECN Category: LOCAL RECEIVER ProcType: Counter32 Description: Number of times CE bits have set ECN. See RFC 2481. R/W: read-only ------------------------------------------------------------------------------ VariableName: ECNNonceRcvd Scope: standard ShortDescr: Number of ECN Nonces received Category: LOCAL RECEIVER ProcType: Counter32 Description: Number of ECN Nonces received. Note that the low bit is the same as the one bit nonce sum. R/W: read-only ------------------------------------------------------------------------------ VariableName: X_RcvRTT Scope: internal ShortDescr: Receiver RTT estimate Category: LOCAL RECEIVER ProcType: Gauge32 Description: The receiver's RTT estimate, if available. Note that there is no standard for receiver RTT measurement. R/W: read-only ------------------------------------------------------------------------------ CATEGORY: LOCAL RECEIVER BUFFER CatDescr: Instruments on the receiver buffer usage, including any buffering in the application interface to TCP and the reassembly queue. ------------------------------------------------------------------------------ VariableName: CurReasmQueue Scope: standard ShortDescr: Current size of reassembly queue Category: LOCAL RECEIVER BUFFER ProcType: Gauge32 Description: The current number of bytes of sequence space spanned by the reassembly queue. This is generally the difference between rcv.nxt and the sequence number of the right most edge of the reassembly queue. R/W: read-only ------------------------------------------------------------------------------ VariableName: MaxReasmQueue Scope: standard ShortDescr: Maximum size of reassembly queue Category: LOCAL RECEIVER BUFFER ProcType: Gauge32 Description: The maximum value of CurReasmQueue R/W: read-only Comment: Is an indirect ref OK? Should the compiler generate the full tag? ------------------------------------------------------------------------------ VariableName: CurAppRQueue Scope: standard ShortDescr: Current size of application read queue Category: LOCAL RECEIVER BUFFER ProcType: Gauge32 Description: The current number of bytes of application data has been acknowledged by TCP but not yet delivered to the application. R/W: read-only ------------------------------------------------------------------------------ VariableName: MaxAppRQueue Scope: standard ShortDescr: Maximum size of application read queue Category: LOCAL RECEIVER BUFFER ProcType: Gauge32 Description: The maximum number of bytes of application data has been acknowledged by TCP but not yet delivered to the application. R/W: read-only ------------------------------------------------------------------------------ VariableName: X_RBufMode Scope: internal ShortDescr: Send buffer mode Category: SENDER BUFFER ProcType: Gauge32 Description: A mechanism for changing the receive buffering mode of a connection. Current values taken may be: (0) Default Linux kernel buffering (1) Web100 "autotuned" buffering R/W: read-write ------------------------------------------------------------------------------ VariableName: X_Rcvbuf Scope: internal ShortDescr: Socket rcvbuf size Category: LOCAL RECEIVER BUFFER ProcType: Gauge32 Description: The socket receive buffer size is bytes. Note that the meaning of this variable is implementation dependent. In particular, it may or may not include the reassembly queue. R/W: read-only ------------------------------------------------------------------------------ VariableName: X_wnd_clamp Scope: internal ShortDescr: X_wnd_clamp Category: LOCAL RECEIVER BUFFER ProcType: Gauge32 Description: Code dissection. R/W: read-only ------------------------------------------------------------------------------ VariableName: X_rcv_ssthresh Scope: internal ShortDescr: X_rcv_ssthresh Category: LOCAL RECEIVER BUFFER ProcType: Gauge32 Description: Code dissection. R/W: read-only ------------------------------------------------------------------------------ VariableName: X_dbg1 Scope: internal ShortDescr: X_dbg1 Category: LOCAL RECEIVER BUFFER ProcType: Gauge32 Description: Debugging R/W: read-only ------------------------------------------------------------------------------ VariableName: X_dbg2 Scope: internal ShortDescr: X_dbg2 Category: LOCAL RECEIVER BUFFER ProcType: Gauge32 Description: Debugging R/W: read-only ------------------------------------------------------------------------------ VariableName: X_dbg3 Scope: internal ShortDescr: X_dbg3 Category: LOCAL RECEIVER BUFFER ProcType: Gauge32 Description: Debugging R/W: read-only ------------------------------------------------------------------------------ VariableName: X_dbg4 Scope: internal ShortDescr: X_dbg4 Category: LOCAL RECEIVER BUFFER ProcType: Gauge32 Description: Debugging R/W: read-only ------------------------------------------------------------------------------ CATEGORY: OBSERVED RECEIVER WINDOW CatDescr: Instruments on receiver window updates used to infer the receiver's state. These can be collected at the sender or anywhere along the network path, including at the receiver. SNMPfile: 8rwin SNMPprefix: tcpEStatsObsRec ------------------------------------------------------------------------------ VariableName: CurRwinRcvd Scope: standard RenameFrom: CurrentRwinRcvd ShortDescr: Current Receiver Window Category: OBSERVED RECEIVER WINDOW ProcType: Gauge32 Description: The most recent window advertisement received, in octets. R/W: read-only ------------------------------------------------------------------------------ VariableName: MaxRwinRcvd Scope: standard ShortDescr: Maximum Receiver Window Category: OBSERVED RECEIVER WINDOW ProcType: Gauge32 Description: The maximum window advertisement received, in octets. R/W: read-only ------------------------------------------------------------------------------ VariableName: MinRwinRcvd Scope: standard ShortDescr: Minimum Receiver Window Category: OBSERVED RECEIVER WINDOW ProcType: Gauge32 Description: The minimum window advertisement received, in octets. R/W: read-only ------------------------------------------------------------------------------ CATEGORY: NULL CatDescr: NULL ------------------------------------------------------------------------------