<?xml version="1.0" encoding="US-ASCII"?>
<!-- This template is for creating an Internet Draft using xml2rfc,
     which is available here: http://xml.resource.org. -->
<!DOCTYPE rfc SYSTEM "rfc2629.dtd">
<?xml-stylesheet type='text/xsl' href='rfc2629.xslt' ?>
<!-- used by XSLT processors -->
<!-- For a complete list and description of processing instructions (PIs), 
     please see http://xml.resource.org/authoring/README.html. -->
<?rfc strict="yes" ?>
<!-- give errors regarding ID-nits and DTD validation -->
<!-- control the table of contents (ToC) -->
<?rfc toc="yes"?>
<!-- generate a ToC -->
<?rfc tocdepth="3"?>
<!-- the number of levels of subsections in ToC. default: 3 -->
<!-- control references -->
<?rfc symrefs="yes"?>
<!-- use symbolic references tags, i.e, [RFC2119] instead of [1] -->
<?rfc sortrefs="yes" ?>
<!-- sort the reference entries alphabetically -->
<!-- control vertical white space 
     (using these PIs as follows is recommended by the RFC Editor) -->
<?rfc compact="yes" ?>
<!-- do not start each main section on a new page -->
<?rfc subcompact="no" ?>
<!-- keep one blank line between list items -->
<!-- end of list of popular I-D processing instructions -->
<rfc category="std" docName="draft-song-mpls-extension-header-06" ipr="trust200902">
  <front>
    <title abbrev="MPLS Extension Header">MPLS Extension Header</title>

    <author fullname="Haoyu Song" initials="H." role="editor" surname="Song">
      <organization>Futurewei Technologies</organization>
      <address>
        <postal>
		<street> </street>
          <city>Santa Clara</city>
          <country>USA</country>
        </postal>
        <email>haoyu.song@futurewei.com</email>
      </address>
    </author>


    <author fullname="Zhenbin Li" initials="Z." surname="Li">
      <organization>Huawei</organization>
      <address>
        <postal>
		<street> </street>
          <city>Beijing</city>
          <country>P.R. China</country>
        </postal>
        <email>lizhenbin@huawei.com</email>
      </address>
    </author>

    <author fullname="Tianran Zhou" initials="T." surname="Zhou">
      <organization>Huawei</organization>
      <address>
        <postal>
		<street> </street>
          <city>Beijing</city>
          <country>P.R. China</country>
        </postal>
        <email>zhoutianran@huawei.com</email>
      </address>
    </author>

    <author fullname="Loa Andersson" initials="L." surname="Andersson">
      <organization>Bronze Dragon Consulting</organization>
      <address>
        <postal>
          <street> </street>
          <city>Stockholm</city>
          <country>Sweden</country>
        </postal>
		<email>loa@pi.nu</email>
      </address>
    </author>
	
	<author fullname="Zhaohui Zhang" initials="Z." surname="Zhang">
		<organization>Juniper Networks</organization>
      <address>
        <postal>
          <street> </street>
          <city>Boston</city>
          <country>USA</country>
        </postal>
		<email>zzhang@juniper.net</email>
      </address>
    </author>
	
    <date day="10" month="January" year="2022"/>

    <area>RTG</area>

    <workgroup>MPLS</workgroup>
    
    <!---->

    <keyword>MPLS, Extension Header</keyword>

    <abstract>
	    <t>Motivated by the need to support multiple in-network services and functions in an MPLS network, 
        this document describes a generic and extensible method to encapsulate extension headers into MPLS packets. 
	    The encapsulation method allows stacking multiple extension headers and quickly accessing any of them as well as 
	    the original upper layer protocol header and payload. We show how the extension header 
	    can be used to support several new network applications and optimize some existing network services. </t>    
    </abstract>

    <note title="Requirements Language">
      <t>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 <xref target="RFC2119"></xref><xref target="RFC8174"></xref> when, and only when, they appear in all
   capitals, as shown here.</t>
    </note>
  </front>

  <middle>
    <section title="Motivation">
	    <t>Some applications require adding instructions and/or metadata to user packets within a network.
		    Such examples include <xref target="I-D.ietf-ippm-ioam-data">In-situ OAM (IOAM)</xref>
		    and <xref target="RFC7665">Service Function Chaining (SFC)</xref>. New applications are emerging.
	        It is possible that the instructions and/or metadata for multiple applications are stacked together
		    in one packet to support a compound service.</t>

	    <t>Conceivably, such instructions and/or metadata would be encoded as new headers and encapsulated in user packets.
		    Such headers may require to be processed in fast path or in slow path.
		    Moreover, such headers may require being attended at each hop on the forwarding path (i.e., hop-by-hop or HBH) or
		    at designated end nodes (i.e., end-to-end or E2E).</t>

	    <t>The encapsulation of the new header(s) poses some challenges to MPLS networks, because 
		    the MPLS protocol header contains no explicit indicator for the upper layer protocols by design.
		    We leave the discussion on the indicator of new header(s) in an MPLS packet to another companion document <xref target="I-D.song-mpls-eh-indicator"/>.
		    In this document, we focus on the encode and encapsulation of new headers in an MPLS packet.  </t>

	    <t>The similar problem has been tackled for some particular application before. However, these solutions have some drawbacks:</t>

	    <t><list style="symbols">
                <t> The solutions rely on either the built-in next-protocol indicator in the header or the knowledge of the format and size of the header to access the following packet data.
			The node is required to be able to parse the new header, which is unrealistic in an incremental deployment environment.</t>
		<t> These works only provide piecemeal solution which assumes the new header is the only extra header and its location in the packet is fixed by default. It is impossible or difficult 
			to support multiple new headers in one packet due to the conflicted assumption.</t>	
		<t> Some previous work such as <xref target="RFC5586">G-ACH</xref> was explicitly defined for control channel only but what we need is the   user packet service.</t>
            </list></t>

	    <t>To solve these problems, we introduce extension header as a general and extensible means to support new in-network functions and applications in MPLS networks. 
		    The idea is similar to IPv6 
		    extension headers which offer a huge innovation potential (e.g, network security, 
		    <xref target="RFC8754">SRv6</xref>, 
		    <xref target="I-D.ietf-spring-srv6-network-programming">network programming</xref>, 
		    <xref target="I-D.xu-clad-spring-sr-service-chaining">SFC</xref>, etc.). 
		    Thanks to the existence of extension headers, it is straightforward 
		    to introduce new in-network services into IPv6 networks. 
		    For example, it has been proposed to carry <xref target="I-D.brockners-inband-oam-transport">IOAM header</xref> 
		    as a new extension header option in IPv6 networks.</t>

	    <t>Nevertheless, IPv6 EH is not perfect either. It has three issues: </t>
		
		<t><list style="symbols">
		 <t>IPv6's header is large compared to MPLS, claiming extra bandwidth overhead and complicating the packet processing. We prefer to retain the header compactness in MPLS networks. </t>
		 <t>IPv6's extension headers are chained with the original upper layer protocol headers in a flat stack. One must scan all the extension headers to access the upper layer protocol headers and the payload. This is inconvenient and raises some performance concerns for some applications(e.g., DPI and ECMP). The new scheme for MPLS header extension needs to address these issues too. </t>
		 <t> <xref target="RFC8200" /> enforces many constraints to IPv6 extension headers (e.g., EH can only be added or deleted by the end nodes specified by the IP addresses in the IPv6 header, and there is only one Hop-by-Hop EH that can be processed on the path nodes), which are not suitable for MPLS networks. For example, MPLS label stacks are added and changed in network, and there could be tunnel within tunnel, so the extension headers need more flexibility.</t>	    
		</list></t>
    </section>
    
    <section title="MPLS Extension Header">
	    <t> From the previous discussion, we have laid out the design requirements to support extension headers in MPLS networks:</t>

      		<t><list style="hanging">
			<t hangText="Performance:"> Unnecessary label stack scanning for a label 
					and the full extension header stack scanning for the upper layer protocol should be avoided. The extension headers a node needs to process should be located as close to the MPLS label stack as possible. Each extension header is better to serve only one application to avoid the need of packing multiple TLV options in one extension header.</t>
			<t hangText="Scalability:"> New applications can be supported by introducing new extension headers. Multiple extension headers can
				be easily stacked together to support multiple services simultaneously.</t> 	
			<t hangText="Backward Compatibility:"> Legacy devices which do not recognize the extension header option should still be able to forward the 
				packets as usual. If a device recognize some of the extension headers but not the others in an extension header stack, 
				it can process the known headers only while ignoring the others. </t>
			<t hangText="Flexibility:"> A node can be configured to process or not process any EH. Any tunnel end nodes in the MPLS domain can add new EH to the packets which shall be removed on the other end of the tunnel. </t>
	    </list></t>


	    <t> We assume the MPLS label stack has included some indicator of the extension header(s). The actual extension headers are inserted between the MPLS label stack and the original upper layer packet header. The format of the MPLS packets with extension headers is shown in <xref target="figure_1"></xref>. </t> 
		

 <t><figure anchor="figure_1" title="MPLS with Extension Headers">
         <artwork><![CDATA[

   0                                  31 
   +--------+--------+--------+--------+  \ 
   |                                   |  | 
   ~     MPLS Label Stack              ~  |
   |                                   |  |
   +--------+--------+--------+--------+  | 
   |     EH Indicator (TBD)            |   > MPLS Label Stack
   +--------+--------+--------+--------+  |  (extended with EHI)
   |                                   |  |
   ~     MPLS Label Stack              ~  |
   |                                   |  |
   +--------+--------+--------+--------+ < 
   | Header of Extension Headers (HEH) |  |
   +--------+--------+--------+--------+  |
   |                                   |  |
   ~     Extension Header (EH) 1       ~  |
   |                                   |  |
   +--------+--------+--------+--------+   > MPLS EH Fields
   ~                                   ~  |  (new)
   +--------+--------+--------+--------+  |
   |                                   |  |
   ~     Extension Header (EH) N       ~  | 
   |                                   |  |
   +--------+--------+--------+--------+ <
   |                                   |  |
   ~    Upper Layer Headers/Payload    ~   > MPLS Payload
   |                                   |  |  (as is)
   +--------+--------+--------+--------+  /
   
]]></artwork>
	</figure></t>


	<t>Following the MPLS label stack is the 4-octet Header of Extension Headers (HEH), which indicates the total number of extension headers in this packet, the overall 
		length of the extension headers, the type of the original upper layer header, and the type of the next header. The format of the HEH is shown in <xref target="figure_2"></xref>.</t>


 <t><figure anchor="figure_2" title="HEH Format">
         <artwork><![CDATA[

    0           1         2          3		 
    0123 4567 89012345 67890123 45678901		 
   +----+----+--------+--------+--------+  
   | R  |EHC |  EHTL  |  OUL   |   NH   |
   +----+----+--------+--------+--------+
   
]]></artwork>
	</figure></t>

	<t>The meaning of the fields in an HEH is as follows:</t>

      		<t><list style="hanging">
          		<t hangText="R:"> 4-bit reserved. The nibble value means to avoid conflicting with IP version numbers.</t>
			<t hangText="EHC:"> 4-bit unsigned integer for the Extension Header Counter.  
				This field keeps the total number of extension headers included in this packet. It does not count the original 
				upper layer protocol headers. At most 15 EHs are allowed in one packet.</t> 	
			<t hangText="EHTL:"> 8-bit unsigned integer for the Extension Header Total Length in 4-octet units. This field keeps the total 
				length of the extension headers in this packet, not including the HEH itself.</t>
			<t hangText="OUL:"> 8-bit Original Upper Layer protocol number indicating the original upper layer protocol type. It can be set to "UNKNOWN" if unknown. </t>
			<t hangText="NH:"> 8-bit selector for the Next Header. This field identifies the type of the header immediately following the HEH.</t> 
		</list></t>

		<t> The value of the reserved nibble needs further consideration. The EHC field can be used to keep track of the number of extension headers when some headers are inserted or removed at some network nodes. 
			The EHTL field can help to skip all the
			extension headers in one step if the original upper layer protocol headers or payload need to be accessed. The OUL field can help identify the type of the original upper layer protocol.</t>

		<t>The format of an Extension Header (EH) is shown in <xref target="figure_3"></xref>.</t>


 <t><figure anchor="figure_3" title="EH Format">
         <artwork><![CDATA[

    0          1          2          3		 
    01234567 89012345 67890123 45678901		 
   +--------+--------+--------+-------+  
   |  NH    |  HLEN  |EXT     |       |
   +--------+--------+--------+       |  
   |                                  |
   ~        Header Specific Data      ~
   |                                  |
   +--------+--------+----------------+

]]></artwork>
	</figure></t>

	<t>The meaning of the fields in an EH is as follows:</t>

      		<t><list style="hanging">
			<t hangText="NH:"> 8-bit indicator for the Next Header. This field identifies the type of the EH immediately following this EH.</t> 
			<t hangText="HLEN:"> 8-bit unsigned integer for the Extension Header Length in 4-octet units, not including the first 4 octets.</t>
			<t hangText="EXT:"> 8-bit optional type extension. To save the Next Header numbers and extend the number space, it is possible to use one "Next Header" code to cover a set of sub-types. Each sub-type is assigned a new code in a different name space. This field is optional and it is only specified for some specific EH type. </t>
			<t hangText="Header Specific Data:"> Variable length field for the specification of the EH. This field is 4-octet aligned.</t>
	        </list></t>	


	<t>The extension headers as well as the first original upper layer protocol header are chained together through the NH field in HEH and EHs.
		The encoding of NH can share the same value registry for IPv4/IPv6 protocol numbers. Values for new EH types shall be assigned by IANA.</t>


	<t>Specifically, the NH field of the last EH in a chain can have some special values, which shall be assigned by IANA as well:</t>

      		<t><list style="hanging">
			<t hangText="NONE (No Next Header):"> Indicates that there is no other header and payload after this header. 
			        This can be used to transport packets with only extension header(s), for example, the control packets for control or the probe packets for measurements. Note that value 59 was reserved 
					for "IPv6 No Next Header" indicator. It may be possible for MPLS EH to share this value.</t>
			<t hangText="UNKNOWN (Unknown Next Header):"> Indicates that the type of the header after this header is unknown. 
				This is intended to be compatible with the original MPLS design in which
				the upper layer protocol type is unknown from the MPLS header alone.</t>
			<t hangText="MPLS:"> Indicates that the original upper layer protocol is still MPLS and another MPLS label stack follows.</t>
	        </list></t>

	
	<t>Note that the original upper layer protocol can be of type "MPLS", which implies that in a packet there might be multiple label stacks separated by EHs. Having more than one independent label stack is not new. For example, A Bier header could separate the transport/bier labels and the payload labels; An MPLS PW network could be implemented on the top of another infrastructure MPLS network. In such cases, we have the flexibility to apply different services to different label stacks. </t>
	
    </section>

    <section anchor="ehtype" title="Type of MPLS Extension Headers">

	    <t>Basically, there are two types of MPLS EHs: HBH and E2E. E2E means that the EH is only supposed to be inserted/removed and processed at the MPLS tunnel end points 
		    where the MPLS header is inserted or removed. 
		    The EHs that need to be processed on path nodes within the MPLS tunnel are of the HBH type. However, any node in the tunnel can be configured to ignore 
		    an HBH EH, even if it is capable of processing it.</t>

	    <t>If there are two types of EHs in a packet, the HBH EHs must take precedence over the E2E EHs. </t> 

	    <t>Making a distinction of the EH types and ordering the EHs in a packet help improve the forwardidng performance. For example, if a node within an MPLS tunnel finds only 
		    E2E EHs in a packet, it can avoid scanning the EH list.</t>   

    </section> 

    <section anchor="Operation" title="Operation on MPLS Extension Headers">
	    
	 <t>When the first EH X needs to be added to an MPLS packet, an EH indicator is inserted into the proper location in the MPLS label stack.
		 A HEH is then inserted after the MPLS label stack, in which EHCNT is set to 1, EHTLEN is set to the length of X in 4-octet units, and NH is set to the header value of X.
		 At last, X is inserted after the HEH, in which NH and HELN are set accordingly. Note that if this operation happens at a PE device, 
		 the upper layer protocol is known before the MPLS encapsulation, so its 
	       value can be saved in the NH field if desired. Otherwise, the NH field is filled with the value of "UNKNOWN".</t>

       <t>When an EH Y needs to be added to an MPLS packet which already contains extension header(s), the EHCNT and EHTLEN in the HEH are updated accordingly (i.e., EHCNT
	       is incremented by 1 and EHTLEN is incremented by the size of Y in 4-octet units).
          Then a proper location for Y in the EH chain is located. Y is inserted at this location. The NH field of Y is copied from the previous EH's 
	  NH field (or from the HEH's NH field, if Y is the first EH in the chain). The previous EH's NH value, or, if Y is the first EH in the chain, the HEH's NH, 
	  is set to the header value of Y.</t>


       <t>Deleting an EH simply reverses the above operation. If the deleted EH is the last one, the EH indicator and HEH can also be removed.</t> 

       <t>When processing an MPLS packet with extension headers, the node needs to scan through the entire EH chain and process the EH one by one. 
	       The node should ignore any unrecognized EH or the EH that is configured as "No Processing".</t> 

       <t>The EH can be categorized into HBH or E2E. Since EHs are ordered based on their type(i.e., HBH EHs are located before E2E EHs), a node
	       can avoid some unnecessary EH scan. </t>      

    </section>

    <section anchor="Usecase" title="Use Cases">

	    <t>In this section, we show how MPLS extension header can be used to support several new network applications.</t>    

      		<t><list style="hanging">
          		<t hangText="In-situ OAM:">In-situ OAM (IOAM) records flow OAM information within user packets while the packets traverse a
				network. The instruction and collected data are kept in an IOAM header <xref target="I-D.ietf-ippm-ioam-data"></xref>.
				When applying IOAM in an MPLS network, the IOAM header can be encapsulated as an MPLS extension header.</t> 
			<t hangText="Network Telemetry and Measurement:"> A network telemetry and instruction header can be carried as an extension header to instruct a node what type of 
				network measurements should be done. For example, the method described in <xref target="RFC8321"></xref> can be implemented in MPLS networks since
				the EH provides a natural way to color MPLS packets.</t>
			<t hangText="Network Security:"> Security related functions often require user packets to carry some metadata. In a DoS limiting network architecture, a 
				"packet passport" header is used to embed packet authentication information for each node to verify.</t>  	
			<t hangText="Segment Routing and Network Programming:"> MPLS extension header can support the implementation of a new flavor of the MPLS-based segment routing, 
				with better performance and richer functionalities. The details will be described in another draft.</t> 	
		</list></t>	


		<t>With MPLS extension headers, multiple in-network applications can be stacked together. For example, IOAM and SFC can be applied at the same time to support network OAM 
			and service function chaining. A node can stop scanning the extension header stack if all the known headers it can process have been located. For example, if IOAM 
	                is the first EH in a stack and a node is configured to process IOAM only, it will stop searching the EH stack when the IOAM EH is found.</t>  

    </section>

    <section anchor="Security" title="Security Considerations">
      <t>TBD</t>
    </section>

    <section anchor="IANA" title="IANA Considerations">
      <t>This document requests IANA to assign two new Internet Protocol Numbers from the "Protocol Numbers" Registry
         to indicate "No Next Header" and "Unknown Next Header". </t>
      <t>This document does not create any other new registries.</t>
    </section>
    
    <section anchor="Contributors" title="Contributors">
      <t>
        The other contributors of this document are listed as follows.
      </t><t>
      <list style="symbols">
	      <t>James Guichard</t>	      
	      <t>Stewart Bryant</t>	      
	      <t>Andrew Malis</t>	      
      </list>	  	
      </t>
    </section>

    <section anchor="Acknowledgments" title="Acknowledgments">
      <t>TBD.</t>
    </section>
  </middle>

  <back>
    <references title="Normative References">
      <?rfc include='reference.RFC.2119'?>
      <?rfc include='reference.RFC.8174'?>
      <?rfc include='reference.RFC.7665'?>
      <?rfc include='reference.RFC.8321'?>
	  <?rfc include='reference.RFC.8754'?>
    </references>

    <references title="Informative References">
	  <?rfc include='reference.RFC.5586'?>
	  <?rfc include='reference.RFC.8200'?>
      <?rfc include='reference.I-D.ietf-spring-srv6-network-programming'?>
	  <?rfc include='reference.I-D.song-mpls-eh-indicator'?>
      <?rfc include='reference.I-D.xu-clad-spring-sr-service-chaining'?> 
      <?rfc include='reference.I-D.brockners-inband-oam-transport'?> 
      <?rfc include='reference.I-D.ietf-ippm-ioam-data'?> 
    </references>
  </back>
</rfc>
