Internet-Draft | MPLS MNA Encodings | July 2022 |
Rajamanickam, et al. | Expires 26 January 2023 | [Page] |
This document defines the MPLS Network Action (MNA) Header encoding formats to carry Network Actions and optionally Ancillary Data in the MPLS Label Stack and after the Label Stack. The MPLS Network Action can influence the forwarding decisions or can carry additional OAM information in the MPLS packet. This document follows the MNA requirements specified in draft-ietf-mpls-mna-requirements.¶
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 26 January 2023.¶
Copyright (c) 2022 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.¶
[RFC3032] defines MPLS Header for carrying a stack of MPLS labels which are used to forward packets in an MPLS network. Today's new applications require the MPLS packets to carry network action indicators and optional Ancillary Data (AD) that would be used in MPLS packet forwarding decision or for OAM purpose. Ancillary Data can be used to carry additional information, for example, a network slice identifier, In-Situ OAM (IOAM) data, etc. Several use-cases are described in [I-D.ietf-mpls-mna-usecases].¶
This document defines MPLS data plane extension header format to encode MPLS Network Actions (MNA) those are efficient to process in hardware. The MPLS Network Actions are encoded in the form of flags and opcodes. These MPLS Network Actions can be encoded without Ancillary Data (AD) or with In-Stack Ancillary Data (ISD) or with Post-Stack Ancillary Data (PSD) after the Bottom of the Stack (BOS). A new Special Purpose Label (SPL) will be assigned to indicate the presence of MPLS Network Action Sub-stack (MNAS) in the MPLS packet. This document follows the MNA requirements specified in [I-D.ietf-mpls-mna-requirements].¶
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in [RFC2119] [RFC8174] when, and only when, they appear in all capitals, as shown here.¶
The MNA terminology defined in [I-D.andersson-mpls-mna-fwk] and [I-D.ietf-mpls-mna-requirements] are used in this document.¶
Encoding MPLS Network Actions requires two main parts.¶
New In-Stack MPLS Network Action encoding format is defined in this document to carry the In-Stack Network Action and its Ancillary Data in the MPLS Label Stack.¶
The MPLS Network Action encoding formats defined in this document are flexible and allow to add In-Stack and Post-Stack MPLS Network Actions in a desired order in the same MPLS packet.¶
A new SPL value (TBA1) is assigned to indicate the presence of the MPLS Network Action Sub-stack (NAS).¶
First Word:¶
Second Word:¶
This word contains the Base Header, which indicates the some of the base attributes of the In-Stack and Post-Stack NAIs encoded. In this case, the TTL fields is re-purposed to encode the Base Header Information. But the Label and TC fields are used to encode the Flag-based In-Stack NAIs.¶
TTL Field¶
The following are the information that are encoded as part of TTL field.¶
Label Field¶
This field encoding the Flag-based NAIs which does not require any Ancillary data to be carried to process the In-Stack NAIs.¶
TC Field¶
This section describes the encoding format of the MPLS Network Actions carried as part of the MPLS Label Stack. The encoding format defined is flexible (e.g., stackable opcodes in desired order), extensible (by defining new NAI-Opcodes) and ASIC friendly (by using Sub-stack Length, Opcode+Data in the same field). This encoding format allows to carry Flag-based NAIs and the NAIs that required Ancillary Data in the same packet.¶
First Word:¶
Second Word:¶
This word contains the base MNA indicators and the Flag Based NAIs that has been described in the above section.¶
Third Word:¶
This word contains the NAIs that requires some Ancillary Data to be processed.¶
Label Field:¶
The first 8 bits are used to define the In-Stack Network Action Opcode (IS-NAI-Opcode). The opcode method of identifying a specific Network Actions are common in today's hardware ASICs (Similar to any IPv4/IPv6/VxLAN header processing), so this method is easy to be adopted by the existing hardware. This will allow the hardware ASICs to serially or in-parallel process the Network Actions.¶
This opcode ranges from 1 to 255. NAI-Opcode value of 0 is marked as invalid to avoid the label value aliasing with the reserved SPLs.¶
IS-NAI-Opcode/Flag-Based-NAI Bits MUST define the following procedure before it can be used:¶
Next 12 bits in the Label field and the 8 bits from the TTL field are used to carry Ancillary Data corresponding to the IS-NAI-Opcode.¶
TC Field:¶
This field is used to indicate the following.¶
TTL Field:¶
This 8-bit field is used to carry In-Stack Ancillary Data apart from the 12 bits in the Label field.¶
NOTE:¶
In some cases, the In-Stack Network Action can require more than 20 bits of supporting Ancillary Data. In these cases, the following Ancillary Data encoding should be used. This is applicable for the Flag-based In-Stack NAI encoding described in the section 3.1¶
First and Second Word:¶
These values are already described in the above section.¶
Third Word:¶
These values are also described above, but the ADL length will be set to "1", to indicate the presence of additional word data that is carried. This ADL length is corresponding to the specific opcode.¶
Fourth Word:¶
This is the Additional Ancillary Data that is encoded to support the IS-NAI-Opcode. The below is the format to encode single additional word to carry Ancillary Data. This format would be replicated for each additional word of Ancillary Data encoded.¶
Based on the PNI and HPI flags, the Post-Stack Network Actions will be processed. The details of the Post-Stack Network Action encoding have been provided in [I-D.song-mpls-extension-header].¶
Second Word:¶
Label Field:¶
TC Field:¶
TTL Field:¶
In this Example, let us assume that an application-C has been allocated a Flag position of "21" by IANA, If the application-C needs to execute its Network Action on the MPLS packet then the 2nd bit in the third Label field will be set to indicate the Flags position "21".¶
ADL is set to "1" indicates the Flag-Based-NAI word is encoded.¶
If the Flag-Based-NAI contains Hop-By-Hop NA then this bit will be set to "0".¶
IL is set to "1" indicates the additional In-Stack NAI word encoded.¶
INI flag is set to indicate the presence of the In-Stack NAI.¶
While encoding the Additional Ancillary Data, the Most Significant bit of the third Label Field MUST be set to "1" to prevent from aliasing with the reserved SPLs in the case of legacy devices.¶
In this Example, the MNA is carrying only the In-Stack Network Action that requires Ancillary Data.¶
Second Word:¶
IL length is set to "1" to indicate an additional 1 word of IS-NA is encoded.¶
INI flag is set to "1" to indicate the presence of In-Stack MPLS Network Actions.¶
Third Word:¶
Label Field:¶
TC Field:¶
TTL Field:¶
In this example, the IS-NA carries more than 20-bit of Ancillary Data.¶
Second Word:¶
Third Word:¶
Fourth Word:¶
Since it carried additional "1" word worth of Ancillary Data, ADL value in the second MPLS TC field is set to "1".¶
While encoding the Additional Ancillary Data, the Most Significant bit of the Label Field MUST be set to "1" to prevent from aliasing with the reserved SPLs in the case of legacy devices.¶
This is the example where the MPLS packet carries multiple In-Stack Network Actions that require Ancillary Data to process.¶
Thrid Word¶
Fourth Word¶
The node capability for the MPLS Network Action must be signaled before the MPLS Encapsulating node can add the necessary MPLS Network Action in the MPLS Label Stack. The capability signaling will be added in LDP, RSVP-TE, BGP, IS-IS, OSPF, BGP-LS, etc. This is outside the scope of this document.¶
The security considerations in [RFC3032] also apply to the extensions defined in this document. The NASI Label MUST NOT be exposed to the node which does not support it.¶
Encapsulating Node:¶
Intermediate Node:¶
Decapsulating Node:¶
Below are the IANA actions which this document is requesting.¶
The registries created by this document will be collected in a new registry grouping called "MPLS Network Action," which will be located at https://www.iana.org/assignments/mpls-network-action.¶
IANA is requested to create a new registry with name "MNA Encoding Flags" to assign the bit position and the meaning to the Flags to repurpose TTL and TC fields in the Label Stack Entry (LSE).¶
Bit Position | Description | Reference |
---|---|---|
11-0 | IETF Review | This document |
Following MNA Encoding Flag values are assigned from this registry.¶
Value | Description | Reference |
---|---|---|
0-2 | In-Stack Network Action Encoding Length (IL) | This document |
3 | Reserved | This document |
4 | In-Stack Network Action Presence Indicator (INI) | This document |
5 | Post-Stack Network Action Presence Indicator (PNI) | This document |
6 | Hop-By-Hop Post-Stack Network Action Processing Indicator (HPI) | This document |
7 | In-Stack Network Action Extension Presence Indicator (INE) | This document |
8 | End of Stack (S) | This document |
9-10 | Additional Data Length (ADL) | This document |
11 | Ingress-To-Egress (E) | This document |
IANA is requested to create a new registry with name "In-Stack MPLS Network Action Indicator Flags" to assign the bit position and the meaning to the Flag-based Network Actions upon the user request. Based on the need this registry will be extended more than 19 bit positions.¶
Bit Position | Description | Reference |
---|---|---|
18-0 | Unassigned | This document |
IANA is requested to create a new registry with name "In-Stack MPLS Network Action Indicator Opcodes" to assign IS-NAI-Opcode values. All code-points in the range 1 through 175 in this registry shall be allocated according to the "IETF Review" procedure as specified in [RFC8126]. Code points in the range 176 through 239 in this registry shall be allocated according to the "First Come First Served" procedure as specified in [RFC8126]. Remaining code-points are allocated according to Table 4:¶
Value | Description | Reference |
---|---|---|
0 - 175 | IETF Review | This document |
176 - 239 | First Come First Served | This document |
240 - 251 | Experimental Use | This document |
252 - 254 | Private Use | This document |
Following IS-NAI-Opcode Indicator values are assigned from this registry.¶
Value | Description | Reference |
---|---|---|
0 | Reserved | This document |
1 | Offset of start of Post-Stack Network Action Header | This document |
255 | Opcode Range Extension Beyond 255 | This document |
IANA is requested to allocate a value TBA1 for the SPL label from the "Base Special-Purpose MPLS Label Values" registry to indicate the presence of MNA Sub-stack.¶
Instead of encoding In-Stack Network Action Indicator Opcode in the Label field, here is an alternate way of adding In-Stack Network Action Indicator Opcode in the TTL field.¶
INI flag is set to "1" to indicate the presence of In-Stack MPLS Network Actions.¶
Since In-Stack MPLS Network Action encoding is part of the MPLS Header, the MPLS Header is redefined to encode the MPLS Network Actions.¶
Fourth Word:¶
Label Field:¶
TC Field:¶
TTL Field:¶
This carries In-Stack Network Action Indicator Opcode.¶
The authors of this document would like to thank the MPLS Working Group Design Team for the discussions and comments on this document. The authors would also like to thank Amanda Baber for reviewing the IANA Considerations and providing many useful suggestions.¶
TBA¶