| Internet-Draft | STAMP CoS ECN Update | June 2025 |
| White & Mirsky | Expires 6 December 2025 | [Page] |
This document describes an optional extension to the Class of Service monitoring functionality of Simple Two-way Active Measurement Protocol that enables the upstream monitoring of the Explicit Congestion Notification and thus updates RFC 8972.¶
This Internet-Draft is submitted in full conformance with the provisions of BCP 78 and BCP 79.¶
Internet-Drafts are working documents of the Internet Engineering Task Force (IETF). Note that other groups may also distribute working documents as Internet-Drafts. The list of current Internet-Drafts is at https://datatracker.ietf.org/drafts/current/.¶
Internet-Drafts are draft documents valid for a maximum of six months and may be updated, replaced, or obsoleted by other documents at any time. It is inappropriate to use Internet-Drafts as reference material or to cite them other than as "work in progress."¶
This Internet-Draft will expire on 6 December 2025.¶
Copyright (c) 2025 IETF Trust and the persons identified as the document authors. All rights reserved.¶
This document is subject to BCP 78 and the IETF Trust's Legal Provisions Relating to IETF Documents (https://trustee.ietf.org/license-info) in effect on the date of publication of this document. Please review these documents carefully, as they describe your rights and restrictions with respect to this document. Code Components extracted from this document must include Revised BSD License text as described in Section 4.e of the Trust Legal Provisions and are provided without warranty as described in the Revised BSD License.¶
[RFC8972] defined several extensions to Simple Two-way Active Measurement Protocol (STAMP). Among those is Class of Service (CoS) TLV that enables monitoring of the Differential Services Code Point (DSCP) marking in downstream and upstream directions. Also, CoS TLV supports downstream monitoring of the Explicit Congestion Notification (ECN). Experience deploying STAMP and its extensions demonstrated that it is helpful to an operator to monitor ECN's consistency in the upstream direction. This specification defines the extension of the CoS TLV in a backward compatible manner to support monitoring of ECN in the upstream direction of the STAMP test session.¶
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in BCP 14 [RFC2119] [RFC8174] when, and only when, they appear in all capitals, as shown here.¶
The STAMP Session-Sender MAY include a CoS TLV in the STAMP test packet. The format of the CoS TLV is presented in Figure 1.¶
0 1 2 3
0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|STAMP TLV Flags| CoS Type | Length |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| DSCP1 | DSCP2 |EC2|RPD|EC1|RPE| Reserved |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
¶
where the fields are defined as follows.¶
A STAMP Session-Reflector that receives a test packet with the CoS TLV MUST include the CoS TLV in the reflected test packet. The Session-Reflector MUST copy the value of the DSCP and ECN fields of the IP header of the received STAMP test packet into the DSCP2 and EC2 fields, respectively, in the CoS TLV in the reflected test packet. The Session-Reflector MUST use the local policy to verify whether the use of the value of the DSCP1 field is permitted in the domain. If it is, the Session-Reflector MUST set the DSCP field's value in the IP header of the reflected test packet equal to the value of the DSCP1 field of the received test packet. Otherwise, the Session-Reflector MUST use the DSCP value of the received STAMP packet and set the value of the RPD field to 1. Upon receiving the reflected packet, if the value of the RPD field is 0, the Session-Sender will save the DSCP value for analysis of the CoS in the reverse direction. If the value of the RP field in the received reflected packet is 1, only CoS in the forward direction can be analyzed.¶
The Session-Reflector MUST set the ECN value in the IP header of the reflected STAMP test packet to the value of the EC1 field. The Session-Reflector MUST set the RPE field in the CoS TLV in the reflected test packet to the value 0b01. As a result, the Session-Sender can detect whether the recommended values for DSCP and ECN fields in the reflected packets were used by inspecting the value of the RPD and RPE fields in the received reflected test packet.¶
The extended CoS TLV defined in this draft is backward compatible with the specification in Section 4.4 of [RFC8972]. The handling of the DSCP1, DSCP2, EC2 and RPD fields defined here is identical to the handling defined for the equivalent fields in Section 4.4 of [RFC8972].¶
Consider a case when an implementation that supports this specification performs as Session-Sender, and the intended Session-Reflector's support of the CoS TLV is according to Section 4.4 of [RFC8972]. If the operator requires monitoring ECN in the reverse direction, the value of the EC1 field will be set to a non-zero value. Because the Session-Reflector would treat the EC1 field as part of the Reserved field, it would ignore its value as per Section 4.4 of [RFC8972]. Further, the Session-Reflector would treat the RPE field as part of the Reserved field and thus it would send the value 0b00 in the reflected STAMP packet, rather than sending the value 0b01. Consequently, the Session-Sender will determine that the ECN value in the IP header of the reflected test packet was not set to the requested value.¶
Also, this specification supports the case when the Session-Reflector supports the extended CoS TLV as defined in this specification and the Session-Sender supports the CoS TLV according to Section 4.4 of [RFC8972]. In that scenario, the Session-Sender will set its [RFC8972] Reserved field to zeros. The Session-Reflector will interpret the first two bits of that field as the EC1 field, as shown in Figure 1 and thus will set the value of the ECN field in the IP header of the reflected packet to 0b00. Further the Session-Reflector will set the RPE field to 0b01. The Session-Sender will treat the RPE field as part of the Reserved field and will ignore its value.¶
This document includes no request to IANA.¶
This document extends the functionality of the CoS TLV ([RFC8972]) and inherits all the security considerations applicable to the base STAMP specification [RFC8762] and [RFC8972].¶
As this specification defined the mechanism to test ECN mapping, this document inherits all the security considerations discussed in [RFC2474]. Monitoring and optional control of ECN for a reflected STAMP test packet using the extended CoS TLV may be used across the Internet so that the Session-Sender and the Session-Reflector are located in different domains.¶
This becomes an Appendix [REPLACE]¶
Karthik Sundaresan, William Hawkins III, Xiao Min¶