<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE rfc [
<!ENTITY nbsp "&#160;">
<!ENTITY zwsp "&#8203;">
<!ENTITY nbhy "&#8209;">
<!ENTITY wj "&#8288;">
]>
<rfc xmlns:xi="http://www.w3.org/2001/XInclude" submissionType="IETF" docName="draft-kbbma-mpls-1stnibble-05" category="std" ipr="trust200902" obsoletes="" updates="" xml:lang="en" symRefs="true" sortRefs="false" tocInclude="true" version="3">
  <!-- xml2rfc v2v3 conversion 3.16.0 -->
  <!-- Generated by id2xml 1.5.0 on 2023-03-09T15:36:48Z -->
	<front>
    <title abbrev="1st nibble">IANA Registry for the First Nibble Following a Label Stack</title>
    <seriesInfo name="Internet-Draft" value="draft-kbbma-mpls-1stnibble-05"/>
    <author initials="K." surname="Kompella" fullname="Kireeti Kompella">
      <organization>Juniper Networks</organization>
      <address>
        <postal>
          <street>1133 Innovation Way</street>
          <street>Sunnyvale,  94089</street>
          <street>United States of America</street>
        </postal>
        <email>kireeti.ietf@gmail.com</email>
      </address>
    </author>
    <author initials="S." surname="Bryant" fullname="Stewart Bryant">
      <organization>University of Surrey 5GIC</organization>
        <address>
        <email>sb@stewartbryant.com</email>
        </address>
    </author>
    <author initials="M." surname="Bocci" fullname="Matthew Bocci">
      <organization>Nokia</organization>
        <address>
        <email>matthew.bocci@nokia.com</email>
        </address>
    </author>
    <author initials="G." surname="Mirsky" fullname="Greg Mirsky" role="editor">
      <organization>Ericsson</organization>
        <address>
        <email>gregimirsky@gmail.com</email>
        </address>
    </author>
    <author initials="L." surname="Andersson" fullname="Loa Andersson">
      <organization>Huawei</organization>
        <address>
        <email>loa@pi.nu</email>
        </address>
    </author>
    <date year="2023"/>
    <workgroup>MPLS Working Group</workgroup>
    <abstract>
      <t>
   The goal of this memo is to create a new IANA registry (called the
   MPLS First Nibble registry) for the first nibble (4-bit field)
   immediately following an MPLS label stack.  The memo offers a
   rationale for such a registry, describes how the registry should be
   managed, and provides some initial entries.  Furthermore, this memo
   sets out some documentation requirements for registering new values.
   Finally, it provides some recommendations that makes processing MPLS
   packets easier and more robust.</t>
      <t>
   There is an important caveat on the use of this registry versus the
   IP version number registry.</t>
      <t>
   This memo, if published, would update <xref target="RFC4928" format="default"/> and <xref target="RFC8469" format="default"/>.</t>
    </abstract>
  </front>
  <middle>
    <section anchor="sect-1" numbered="true" toc="default">
      <name>Introduction</name>
      <t>
   An MPLS packet consists of a label stack, an optional "post-stack header" (PSH) and an optional embedded packet (in that order).  By
   PSH, we mean existing artifacts such as Control Words, BIER headers
   and the like, as well as new types of PSH being discussed in the MPLS
   Open Design Team meetings.  However, in the data plane, there are
   scant clues regarding the PSH, and no clue as to the type of embedded
   packet; this information is communicated via other means, such as the
   routing protocols that signal the labels in the stack.  Nonetheless,
   in order to better handle an MPLS packet in the data plane, it is
   common practice for network equipment to "guess" the type of embedded
   packet.  Such equipment may also need to process the post-stack
   header.  Both of these require parsing the data after the label
   stack.  To do this, the "first nibble" (the top four bits of the
   first octet following the label stack) is often used.</t>
      <t>
   The semantics and usage of the first nibble is not well documented,
   nor are the assignments of values.  This memo serves three purposes:</t>
      <ul spacing="normal">
        <li>To document the assignments already made</li>
        <li>To provide for the clear documentation of future assignments
      through the creation of an "MPLS First Nibble registry"</li>
        <li>Provide a method to tracking usage by requiring more consistent
      documentation</li>
        <li>To reiterate the importance that any MPLS packet not carrying
      plain IPv4 or IPv6 packets MUST contain a PSH</li>
      </ul>
      <t>
   There have been suggestions during discussions at the MPLS Open
   Design Team meetings that this document may serve as a registry for
   the PSH "headers of headers" types; however, this change needs WG
   consensus.</t>
      <section anchor="sect-1.1" numbered="true" toc="default">
        <name>Conventions and Definitions</name>
        <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
   BCP14 <xref target="RFC2119" format="default"/> <xref target="RFC8174" format="default"/> when, and only when, they appear in all
   capitals, as shown here.</t>
        <dl newline="false" spacing="normal">
          <dt>LSR:</dt>
          <dd>
            <t>
	label switching router.
            </t>
            <t/>
          </dd>
          <dt>MPLS packet:</dt>
          <dd>
            <t>
	one whose Layer 2 header declares the type to be MPLS.
            </t>
            <t>
	For Ethernet, that means the Ethertype is 0x8847 or 0x8848.
            </t>
          </dd>
          <dt>Label Stack:</dt>
          <dd>
            <t>
	(of an MPLS packet) all labels (four octet fields)
            </t>
            <t>
	after the Layer 2 header, up to and including the label with the
      BoS bit set (<xref target="RFC3032" format="default"/>).
            </t>
          </dd>
          <dt>MPLS First Nibble (MFN):</dt>
          <dd>
            <t>
	the most significant four bits of the first
            </t>
            <t>
	octet following the label stack.
            </t>
          </dd>
          <dt>MPLS Payload:</dt>
          <dd>
            <t>
	all data after the label stack, including the MFN, an
            </t>
            <t>
	optional post-stack header and the embedded packet.
            </t>
          </dd>
          <dt>Post-stack Header (PSH):</dt>
          <dd>
            <t>
	optional field of interest to the egress
            </t>
            <t>
	LSR (and possibly to transit LSRs).  Examples include a control
      word or an associated channel.  The PSH MUST indicate its length,
      so that a parser knows where the embedded packet starts.
            </t>
          </dd>
          <dt>Embedded Packet:</dt>
          <dd>
            <t>
	All octets beyond the PSH (if any).  This could be
            </t>
            <t>
	an IPv4 or IPv6 packet (e.g., for traffic engineering of IP
      packets, or for a Layer 3 VPN <xref target="RFC4364" format="default"/>), an Ethernet packet (for
      VPLS (<xref target="RFC4761" format="default"/>, <xref target="RFC4762" format="default"/>) or EVPN <xref target="RFC7432" format="default"/>), or some other type
      of Layer 2 frame <xref target="RFC4446" format="default"/>.
            </t>
          </dd>
        </dl>
        <figure anchor="ure-example-of-an-mpls-packet-with-label-stack">
          <name>Example of an MPLS Packet With Label Stack</name>
          <artwork name="" type="" align="left" alt=""><![CDATA[
   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
  +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+\
X |                        Layer 2 Header                         | |
  |                                                               | |
  +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+/
                                            TC   S       TTL
  +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+\
Y |             Label-1                   | TC  |0|      TTL      | |
  +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  |             Label-2                   | TC  |0|      TTL      | |
  +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  |               ...                     | TC  |0|      TTL      | |
  +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  |             Label-n                   | TC  |1|      TTL      | |
  +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+/
]]></artwork>
        </figure>
        <figure anchor="ure-2">
          <artwork name="" type="" align="left" alt=""><![CDATA[
  +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+\
A | (MFN) |                   IP packet                           | |
  +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  |                             data                              | |
  +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
                                 ...                                |
  +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  |                        end of IP packet                       | |
  +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+/
]]></artwork>
        </figure>
        <figure anchor="ure-3">
          <artwork name="" type="" align="left" alt=""><![CDATA[
  +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+\
B | (MFN) |                 non-IP packet                         | |
  +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  |                             data                              | |
  +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
                                 ...                                |
  +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  |                      end of non-IP packet                     | |
  +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+/
]]></artwork>
        </figure>
        <figure anchor="ure-4">
          <artwork name="" type="" align="left" alt=""><![CDATA[
  +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+\
C | (MFN) |                      PSH                              | |
  +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  |                              PSH                              | |
  +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
                                 ...                                |
  +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  |                          end of PSH                           | |
  +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  |                        embedded packet                        | |
  +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+/
]]></artwork>
        </figure>
        <t>
   Figure 1 shows an MPLS packet with Layer 2 header X and a label stack
   Y ending with Label-n.  Then, there are three examples of an MPLS
   payload.  The full MPLS packet thus would consist of [X Y A], or [X Y B], or [X Y C].</t>
        <t>
   A.  The first payload is a bare IP packet, i.e., no PSH.  The MFN
   (MPLS First Nibble) in this case overlaps with the IP version number.</t>
        <t>
   B.  The next payload is a bare non-IP packet; again, no PSH.  The MFN
   here is the first nibble of the payload, whatever it happens to be.</t>
        <t>
   C.  The last example is an MPLS Payload that starts with a PSH
   followed by the embedded packet.  Here, the embedded packet could be
   IP or non-IP.</t>
      </section>
    </section>
    <section anchor="sect-2" numbered="true" toc="default">
      <name>Rationale</name>
      <section anchor="sect-2.1" numbered="true" toc="default">
        <name>Why Look at the First Nibble</name>
        <t>
   An MPLS packet can contain many types of embedded packet.  The most
   common types are:</t>
        <ol spacing="normal" type="1"><li>An IPv4 packet (whose IP header has version number 4).</li>
          <li>An IPv6 packet (whose IP header has version number 6).</li>
          <li>A Layer 2 Ethernet frame (i.e., not including the Preamble or the
       Start frame delimiter), starting with the destination MAC
       address.</li>
        </ol>
        <t>
   Many other packet types are possible, and in principle, any Layer 2
   embedded packet is permissible; indeed, in the past, PPP, Frame Relay
   and ATM packets were reasonably common.</t>
        <t>
   In addition, there may be a post-stack header ahead of the embedded
   packet, and this needs be to parsed.  The MPLS First Nibble is
   currently used for both of these purposes.</t>
        <section anchor="sect-2.1.1" numbered="true" toc="default">
          <name>Load Balancing</name>
          <t>
   There are four common ways to load balance an MPLS packet:</t>
          <ol spacing="normal" type="1"><li>One can use the top label alone.</li>
            <li>One can do better by using all the (non-SPL) labels in the stack.</li>
            <li>One can do even better by "divining" the type of embedded packet,
       and using fields from the guessed header.</li>
            <li>One can do best by using either an Entropy Label <xref target="RFC6790" format="default"/> or a
       FAT Pseudowire Label <xref target="RFC6391" format="default"/>; see <xref target="sect-2.1.3" format="default"/>.)</li>
          </ol>
          <t>
   Load balancing based on just the top label means that all packets
   with that top label will go the same way -- this is far from ideal.
   Load balancing based on the entire label stack (not including SPLs)
   is better, but may still be uneven.  If, however, the embedded packet
   is an IP packet, then the combination of (&lt;source IP address&gt;, &lt;dest IP address&gt;, &lt;transport protocol&gt;, &lt;source port&gt;, and &lt;dest port&gt;)
   from the IP header of the embedded packet forms an excellent basis
   for load balancing.  This is what is typically used for load
   balancing IP packets.</t>
          <t>
   An MPLS packet doesn't, however, carry a payload type identifier.
   There is a simple (but dangerous) heuristic that is commonly used to
   guess the type of the embedded packet.  The first nibble, i.e., the
   four most significant bits of the first octet, of an IP header
   contains the IP version number.  This in turn indicates where to find
   the relevant fields for load balancing.  The heuristic goes roughly
   as follows:</t>
          <section anchor="sect-2.1.1.1" numbered="true" toc="default">
            <name>Heuristic for Load Balancing</name>
            <ol spacing="normal" type="1"><li>If the MFN is 0x4 (0100b), treat the payload as an IPv4 packet,
       and find the relevant fields for load balancing on that basis.</li>
              <li>If the MFN is 0x6 (0101b), treat the payload as an IPv6 packet,
       and find the relevant fields for load balancing on that basis.</li>
              <li>If the MFN is anything else, the MPLS payload is not an IP
       packet; fall back to load balancing using the label stack.</li>
            </ol>
            <t>
   This heuristic has been implemented in many (legacy) routers, and
   performs well in the case of Figure 1, A.  However, this heuristic
   can work very badly for Figure 1, B.  For example, if payload B is an
   Ethernet frame, then the MFN is the first nibble of the OUI of the
   destination MAC address, which can be 0x4 or 0x6, and if so would
   lead to very bad load balancing.  This behavior can happen to other
   types of non-IP payload as well.</t>
            <t>
   This in turn led to the idea of inserting a PSH (e.g., a pseudowire
   control word <xref target="RFC4385" format="default"/>, a DetNet control word <xref target="RFC8964" format="default"/> or a BIER
   header <xref target="RFC8296" format="default"/>) where the MPLS First Nibble is NOT 0x4 or 0x6, to
   explicitly prevent forwarding engines from confusing the MPLS payload
   with an IP packet.  <xref target="RFC8469" format="default"/> recommends the use of a control word
   when the embedded packet is an Ethernet frame.  RFC 8469 was
   published at the request of the operator community and the IEEE RAC
   as a result of operational difficulties with pseudowires that did not
   contain the control word.</t>
            <t>
   This memo introduces a requirement and a recommendation, the first
   building on the above; the second deprecating the use of the
   heuristic in <xref target="sect-2.1.1.1" format="default"/>.  The intent of both of these is that
   legacy routers continue to operate as they have, with no new problems
   introduced as a result of this memo.  However, new implementations
   SHOULD follow these recommendations for more robust operation.</t>
          </section>
        </section>
        <section anchor="sect-2.1.2" numbered="true" toc="default">
          <name>Requirement</name>
          <t>
   Going forward, network equipment MUST use a post-stack header with an
   MPLS First Nibble value that is not 0x4 or 0x6 in all cases when the
   MPLS payload is not an IP packet.  Effectively, Figure 1, B is
   disallowed.  [AGREED???]</t>
          <t>
   This replaces the following text from <xref target="RFC4928" format="default"/>, section 3, paragraph
   3:</t>
          <t>
   "It is REQUIRED, however, that applications depend upon in-order packet delivery restrict the first nibble values to 0x0 and 0x1. This will ensure that their traffic flows will not be affected if some future routing equipment does similar snooping on some future version(s) of IP."</t>
          <t>
   This also replaces the following text from <xref target="RFC8469" format="default"/>, section 4,
   paragraph 1:</t>
          <t>
   "This document updates [RFC4448] to state that both the ingress provider edge (PE) and the egress PE SHOULD support the Ethernet PW CW and that, if supported, the CW MUST be used."</t>
        </section>
        <section anchor="sect-2.1.3" numbered="true" toc="default">
          <name>Recommendation</name>
          <t>
   It is RECOMMENDED that, going forward, if good load balancing of MPLS
   packets is desired, either an Entropy Label or a FAT Pseudowire Label
   SHOULD be used; furthermore, going forward, the heuristic in
   <xref target="sect-2.1.1.1" format="default"/> MUST NOT be used.  [AGREED???]</t>
          <t>
   A consequence of Recommendation 2 is that, while legacy routers may
   look for a MPLS First Nibble of 0x4 or 0x6, no router will look for a
   MPLS First Nibble of 0x7 (or whatever the next IP version number will
   be) for load balancing purposes.  This means that the values 0x4 and
   0x6 are used to (sometimes incorrectly) identify IPv4 and IPv6
   packets, but no other First Nibble values will be used to identify IP
   packets.</t>
          <t>
   This obviates the need for paragraph 4, section 3 in <xref target="RFC4928" format="default"/>:</t>
          <t>
   "This behavior implies that if in the future an IP version is defined with a version number of 0x0 or 0x1, then equipment complying with this BCP would be unable to look past one or more MPLS headers, and loadsplit traffic from a single LSP across multiple paths based on a hash of specific fields in the IPv0 or IPv1 headers.  That is, IP traffic employing these version numbers would be safe from disturbances caused by inappropriate loadsplitting, but would also not be able to get the performance benefits."</t>
          <t>
   This also expands the MFN Registry to all 16 possible values, not
   just 0x0 and 0x1.</t>
        </section>
        <section anchor="sect-2.1.4" numbered="true" toc="default">
          <name>Parsing the Post-stack Header</name>
          <t>
   Given the above recommendations on the use of a post-stack header and
   future non-use of the heuristic (<xref target="sect-2.1.1.1" format="default"/>) via the use of
   Entropy or FAT Pseudowire Labels, the main reason for creating a
   First Nibble registry is to document the types of post-stack headers
   that may follow a label stack, and to simplify their parsing.</t>
        </section>
      </section>
      <section anchor="sect-2.2" numbered="true" toc="default">
        <name>Why Create a Registry</name>
        <t>
   The MPLS WG is currently engaged in updating the MPLS architecture;
   part of this work involves the use of post-stack headers.  This is
   not possible if post-stack header values are allocated on an ad hoc
   basis, and their parsing and semantics is ill-specified.  Consider
   that the MPLS First Nibble value of 0x0 has two different formats,
   depending on whether the post-stack header is a pseudowire control
   word or a DetNet control word; disambiguation requires the context of
   the service label.  This was a considered decision; documenting this
   would be helpful to future implementors.</t>
        <t>
   With a registy, post-stack headers become easier to parse; the values
   are unique, not needing means outside the data plane to interpret
   them correctly; and their semantics and usage are documented.  (Thank
   you, IANA!)</t>
      </section>
      <section anchor="sect-2.3" numbered="true" toc="default">
        <name>Caveat</name>
        <t>
   The use of the MPLS First Nibble stemmed from the desire to
   heuristically identify IP packets for load balancing purposes.  It
   was then discovered that non-IP packets, misidentified as IP when the
   heuristic failed, were being badly load balanced, leading to
   <xref target="RFC4928" format="default"/>.  This situation may confuse some as to relationship
   between the MPLS First Nibble Registry and the IP Version Numbers
   registry.  These registries are quite different:</t>
        <ol spacing="normal" type="1"><li>The IP Version Numbers registry's explicit purpose is to track IP
       version numbers in an IP header.</li>
          <li>The MPLS First Nibble registry's purpose is to track post-stack
       header types.</li>
        </ol>
        <t>
   The only intersection points between the two registries is for values
   0x4 and 0x6 (for backward compatibility).  There is no need to track
   future IP version number allocations in the MPLS First Nibble
   registry.</t>
      </section>
    </section>
    <section anchor="sect-3" numbered="true" toc="default">
      <name>IANA Considerations</name>
      <section anchor="sect-3.1" numbered="true" toc="default">
        <name>MPLS First Nibble Registry</name>
        <t>
   This memo recommends the creation of an IANA registry called "The MPLS First Nibble Registry" with the following values:<!--
   draft-kbbma-mpls-1stnibble-04.txt(544): Warning: Unexpected title: expected
   'Figure ...', found 'Table 1: MPLS First Nibble Values'.  This looks like a
   figure that has been entered as a texttable.  The generated XML will need
   adjustment.
   -->
        </t>
        <figure anchor="le-mpls-first-nibble-values">
          <name>MPLS First Nibble Values</name>
          <artwork name="" type="" align="left" alt=""><![CDATA[
 +=======+========================+===========+===================+
 | Value | Meaning                | Reference | Allocation Policy |
 +=======+========================+===========+===================+
 |   0x0 | PW Control Word        | RFC 4385  |                   |
 +-------+------------------------+-----------+-------------------+
 |   0x0 | DetNet Control Word    | RFC 8964  |                   |
 +-------+------------------------+-----------+-------------------+
 |   0x1 | PW Assoc Channel       | RFC 4385  |                   |
 +-------+------------------------+-----------+-------------------+
 |   0x2 | Unallocated            |           | Standards Action  |
 +-------+------------------------+-----------+-------------------+
 |   0x3 | Unallocated            |           | Standards Action  |
 +-------+------------------------+-----------+-------------------+
 |   0x4 | IPv4 header            | RFC 791   |                   |
 +-------+------------------------+-----------+-------------------+
 |   0x5 | BIER header            | RFC 8296  |                   |
 +-------+------------------------+-----------+-------------------+
 |   0x6 | IPv6 header            | RFC 8200  |                   |
 +-------+------------------------+-----------+-------------------+
 | 0x7-e | Unallocated            |           | Standards Action  |
 +-------+------------------------+-----------+-------------------+
 |   0xf | Reserved for expansion |           | Standards Action  |
 +-------+------------------------+-----------+-------------------+
]]></artwork>
        </figure>
        <section anchor="sect-3.1.1" numbered="true" toc="default">
          <name>Allocation Policy</name>
          <t>
   All new values registered here MUST use the Standards Action policy
   <xref target="RFC8126" format="default"/>.</t>
        </section>
      </section>
    </section>
  </middle>
  <back>
    <references>
      <name>References</name>
      <references>
        <name>Normative References</name>
        <reference anchor="RFC2119" target="https://www.rfc-editor.org/info/rfc2119" xml:base="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.2119.xml">
          <front>
            <title>Key words for use in RFCs to Indicate Requirement Levels</title>
            <author fullname="S. Bradner" initials="S." surname="Bradner"/>
            <date month="March" year="1997"/>
            <abstract>
              <t>In many standards track documents several words are used to signify the requirements in the specification.  These words are often capitalized.  This document defines these words as they should be interpreted in IETF documents.  This document specifies an Internet Best Current Practices for the Internet Community, and requests discussion and suggestions for improvements.</t>
            </abstract>
          </front>
          <seriesInfo name="BCP" value="14"/>
          <seriesInfo name="RFC" value="2119"/>
          <seriesInfo name="DOI" value="10.17487/RFC2119"/>
        </reference>
        <reference anchor="RFC3032" target="https://www.rfc-editor.org/info/rfc3032" xml:base="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.3032.xml">
          <front>
            <title>MPLS Label Stack Encoding</title>
            <author fullname="E. Rosen" initials="E." surname="Rosen"/>
            <author fullname="D. Tappan" initials="D." surname="Tappan"/>
            <author fullname="G. Fedorkow" initials="G." surname="Fedorkow"/>
            <author fullname="Y. Rekhter" initials="Y." surname="Rekhter"/>
            <author fullname="D. Farinacci" initials="D." surname="Farinacci"/>
            <author fullname="T. Li" initials="T." surname="Li"/>
            <author fullname="A. Conta" initials="A." surname="Conta"/>
            <date month="January" year="2001"/>
            <abstract>
              <t>This document specifies the encoding to be used by an LSR in order to transmit labeled packets on Point-to-Point Protocol (PPP) data links, on LAN data links, and possibly on other data links as well.  This document also specifies rules and procedures for processing the various fields of the label stack encoding. [STANDARDS-TRACK]</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="3032"/>
          <seriesInfo name="DOI" value="10.17487/RFC3032"/>
        </reference>
        <reference anchor="RFC4385" target="https://www.rfc-editor.org/info/rfc4385" xml:base="https://www.rfc-editor.org/refs/bibxml/reference.RFC.4385.xml">
          <front>
            <title>Pseudowire Emulation Edge-to-Edge (PWE3) Control Word for Use over an MPLS PSN</title>
            <author initials="S." surname="Bryant" fullname="S. Bryant">
              <organization/>
            </author>
            <author initials="G." surname="Swallow" fullname="G. Swallow">
              <organization/>
            </author>
            <author initials="L." surname="Martini" fullname="L. Martini">
              <organization/>
            </author>
            <author initials="D." surname="McPherson" fullname="D. McPherson">
              <organization/>
            </author>
            <date year="2006" month="February"/>
            <abstract>
              <t>This document describes the preferred design of a Pseudowire Emulation Edge-to-Edge (PWE3) Control Word to be used over an MPLS packet switched network, and the Pseudowire Associated Channel Header.  The design of these fields is chosen so that an MPLS Label Switching Router performing MPLS payload inspection will not confuse a PWE3 payload with an IP payload.  [STANDARDS-TRACK]</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="4385"/>
          <seriesInfo name="DOI" value="10.17487/RFC4385"/>
        </reference>
        <reference anchor="RFC4928" target="https://www.rfc-editor.org/info/rfc4928" xml:base="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.4928.xml">
          <front>
            <title>Avoiding Equal Cost Multipath Treatment in MPLS Networks</title>
            <author fullname="G. Swallow" initials="G." surname="Swallow"/>
            <author fullname="S. Bryant" initials="S." surname="Bryant"/>
            <author fullname="L. Andersson" initials="L." surname="Andersson"/>
            <date month="June" year="2007"/>
            <abstract>
              <t>This document describes the Equal Cost Multipath (ECMP) behavior of currently deployed MPLS networks.  This document makes best practice recommendations for anyone defining an application to run over an MPLS network that wishes to avoid the reordering that can result from transmission of different packets from the same flow over multiple different equal cost paths.  These recommendations rely on inspection of the IP version number field in packets.  Despite the heuristic nature of the recommendations, they provide a relatively safe way to operate MPLS networks, even if future allocations of IP version numbers were made for some purpose.  This document specifies an Internet Best Current Practices for the Internet Community, and requests discussion and suggestions for improvements.</t>
            </abstract>
          </front>
          <seriesInfo name="BCP" value="128"/>
          <seriesInfo name="RFC" value="4928"/>
          <seriesInfo name="DOI" value="10.17487/RFC4928"/>
        </reference>
        <reference anchor="RFC6391" target="https://www.rfc-editor.org/info/rfc6391" xml:base="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.6391.xml">
          <front>
            <title>Flow-Aware Transport of Pseudowires over an MPLS Packet Switched Network</title>
            <author fullname="S. Bryant" initials="S." role="editor" surname="Bryant"/>
            <author fullname="C. Filsfils" initials="C." surname="Filsfils"/>
            <author fullname="U. Drafz" initials="U." surname="Drafz"/>
            <author fullname="V. Kompella" initials="V." surname="Kompella"/>
            <author fullname="J. Regan" initials="J." surname="Regan"/>
            <author fullname="S. Amante" initials="S." surname="Amante"/>
            <date month="November" year="2011"/>
            <abstract>
              <t>Where the payload of a pseudowire comprises a number of distinct flows, it can be desirable to carry those flows over the Equal Cost Multiple Paths (ECMPs) that exist in the packet switched network. Most forwarding engines are able to generate a hash of the MPLS label stack and use this mechanism to balance MPLS flows over ECMPs.</t>
              <t>This document describes a method of identifying the flows, or flow groups, within pseudowires such that Label Switching Routers can balance flows at a finer granularity than individual pseudowires. The mechanism uses an additional label in the MPLS label stack. [STANDARDS-TRACK]</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="6391"/>
          <seriesInfo name="DOI" value="10.17487/RFC6391"/>
        </reference>
        <reference anchor="RFC6790" target="https://www.rfc-editor.org/info/rfc6790" xml:base="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.6790.xml">
          <front>
            <title>The Use of Entropy Labels in MPLS Forwarding</title>
            <author fullname="K. Kompella" initials="K." surname="Kompella"/>
            <author fullname="J. Drake" initials="J." surname="Drake"/>
            <author fullname="S. Amante" initials="S." surname="Amante"/>
            <author fullname="W. Henderickx" initials="W." surname="Henderickx"/>
            <author fullname="L. Yong" initials="L." surname="Yong"/>
            <date month="November" year="2012"/>
            <abstract>
              <t>Load balancing is a powerful tool for engineering traffic across a network.  This memo suggests ways of improving load balancing across MPLS networks using the concept of "entropy labels".  It defines the concept, describes why entropy labels are useful, enumerates properties of entropy labels that allow maximal benefit, and shows how they can be signaled and used for various applications.  This document updates RFCs 3031, 3107, 3209, and 5036. [STANDARDS-TRACK]</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="6790"/>
          <seriesInfo name="DOI" value="10.17487/RFC6790"/>
        </reference>
        <reference anchor="RFC8126" target="https://www.rfc-editor.org/info/rfc8126" xml:base="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.8126.xml">
          <front>
            <title>Guidelines for Writing an IANA Considerations Section in RFCs</title>
            <author fullname="M. Cotton" initials="M." surname="Cotton"/>
            <author fullname="B. Leiba" initials="B." surname="Leiba"/>
            <author fullname="T. Narten" initials="T." surname="Narten"/>
            <date month="June" year="2017"/>
            <abstract>
              <t>Many protocols make use of points of extensibility that use constants to identify various protocol parameters. To ensure that the values in these fields do not have conflicting uses and to promote interoperability, their allocations are often coordinated by a central record keeper. For IETF protocols, that role is filled by the Internet Assigned Numbers Authority (IANA).</t>
              <t>To make assignments in a given registry prudently, guidance describing the conditions under which new values should be assigned, as well as when and how modifications to existing values can be made, is needed. This document defines a framework for the documentation of these guidelines by specification authors, in order to assure that the provided guidance for the IANA Considerations is clear and addresses the various issues that are likely in the operation of a registry.</t>
              <t>This is the third edition of this document; it obsoletes RFC 5226.</t>
            </abstract>
          </front>
          <seriesInfo name="BCP" value="26"/>
          <seriesInfo name="RFC" value="8126"/>
          <seriesInfo name="DOI" value="10.17487/RFC8126"/>
        </reference>
        <reference anchor="RFC8174" target="https://www.rfc-editor.org/info/rfc8174" xml:base="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.8174.xml">
          <front>
            <title>Ambiguity of Uppercase vs Lowercase in RFC 2119 Key Words</title>
            <author fullname="B. Leiba" initials="B." surname="Leiba"/>
            <date month="May" year="2017"/>
            <abstract>
              <t>RFC 2119 specifies common key words that may be used in protocol specifications.  This document aims to reduce the ambiguity by clarifying that only UPPERCASE usage of the key words have the defined special meanings.</t>
            </abstract>
          </front>
          <seriesInfo name="BCP" value="14"/>
          <seriesInfo name="RFC" value="8174"/>
          <seriesInfo name="DOI" value="10.17487/RFC8174"/>
        </reference>
        <reference anchor="RFC8296" target="https://www.rfc-editor.org/info/rfc8296" xml:base="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.8296.xml">
          <front>
            <title>Encapsulation for Bit Index Explicit Replication (BIER) in MPLS and Non-MPLS Networks</title>
            <author fullname="IJ. Wijnands" initials="IJ." role="editor" surname="Wijnands"/>
            <author fullname="E. Rosen" initials="E." role="editor" surname="Rosen"/>
            <author fullname="A. Dolganow" initials="A." surname="Dolganow"/>
            <author fullname="J. Tantsura" initials="J." surname="Tantsura"/>
            <author fullname="S. Aldrin" initials="S." surname="Aldrin"/>
            <author fullname="I. Meilik" initials="I." surname="Meilik"/>
            <date month="January" year="2018"/>
            <abstract>
              <t>Bit Index Explicit Replication (BIER) is an architecture that provides optimal multicast forwarding through a "multicast domain", without requiring intermediate routers to maintain any per-flow state or to engage in an explicit tree-building protocol.  When a multicast data packet enters the domain, the ingress router determines the set of egress routers to which the packet needs to be sent.  The ingress router then encapsulates the packet in a BIER header.  The BIER header contains a bit string in which each bit represents exactly one egress router in the domain; to forward the packet to a given set of egress routers, the bits corresponding to those routers are set in the BIER header.  The details of the encapsulation depend on the type of network used to realize the multicast domain.  This document specifies a BIER encapsulation that can be used in an MPLS network or, with slight differences, in a non-MPLS network.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="8296"/>
          <seriesInfo name="DOI" value="10.17487/RFC8296"/>
        </reference>
        <reference anchor="RFC8469" target="https://www.rfc-editor.org/info/rfc8469" xml:base="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.8469.xml">
          <front>
            <title>Recommendation to Use the Ethernet Control Word</title>
            <author fullname="S. Bryant" initials="S." surname="Bryant"/>
            <author fullname="A. Malis" initials="A." surname="Malis"/>
            <author fullname="I. Bagdonas" initials="I." surname="Bagdonas"/>
            <date month="November" year="2018"/>
            <abstract>
              <t>The pseudowire (PW) encapsulation of Ethernet, as defined in RFC 4448, specifies that the use of the control word (CW) is optional. In the absence of the CW, an Ethernet PW packet can be misidentified as an IP packet by a label switching router (LSR). This may lead to the selection of the wrong equal-cost multipath (ECMP) path for the packet, leading in turn to the misordering of packets. This problem has become more serious due to the deployment of equipment with Ethernet Media Access Control (MAC) addresses that start with 0x4 or 0x6. The use of the Ethernet PW CW addresses this problem. This document RECOMMENDS the use of the Ethernet PW CW in all but exceptional circumstances.</t>
              <t>This document updates RFC 4448.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="8469"/>
          <seriesInfo name="DOI" value="10.17487/RFC8469"/>
        </reference>
        <reference anchor="RFC8964" target="https://www.rfc-editor.org/info/rfc8964" xml:base="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.8964.xml">
          <front>
            <title>Deterministic Networking (DetNet) Data Plane: MPLS</title>
            <author fullname="B. Varga" initials="B." role="editor" surname="Varga"/>
            <author fullname="J. Farkas" initials="J." surname="Farkas"/>
            <author fullname="L. Berger" initials="L." surname="Berger"/>
            <author fullname="A. Malis" initials="A." surname="Malis"/>
            <author fullname="S. Bryant" initials="S." surname="Bryant"/>
            <author fullname="J. Korhonen" initials="J." surname="Korhonen"/>
            <date month="January" year="2021"/>
            <abstract>
              <t>This document specifies the Deterministic Networking (DetNet) data plane when operating over an MPLS Packet Switched Network.  It leverages existing pseudowire (PW) encapsulations and MPLS Traffic Engineering (MPLS-TE) encapsulations and mechanisms.  This document builds on the DetNet architecture and data plane framework.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="8964"/>
          <seriesInfo name="DOI" value="10.17487/RFC8964"/>
        </reference>
      </references>
      <references>
        <name>Informative References</name>
        <reference anchor="RFC4364" target="https://www.rfc-editor.org/info/rfc4364" xml:base="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.4364.xml">
          <front>
            <title>BGP/MPLS IP Virtual Private Networks (VPNs)</title>
            <author fullname="E. Rosen" initials="E." surname="Rosen"/>
            <author fullname="Y. Rekhter" initials="Y." surname="Rekhter"/>
            <date month="February" year="2006"/>
            <abstract>
              <t>This document describes a method by which a Service Provider may use an IP backbone to provide IP Virtual Private Networks (VPNs) for its customers.  This method uses a "peer model", in which the customers' edge routers (CE routers) send their routes to the Service Provider's edge routers (PE routers); there is no "overlay" visible to the customer's routing algorithm, and CE routers at different sites do not peer with each other.  Data packets are tunneled through the backbone, so that the core routers do not need to know the VPN routes. [STANDARDS-TRACK]</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="4364"/>
          <seriesInfo name="DOI" value="10.17487/RFC4364"/>
        </reference>
        <reference anchor="RFC4446" target="https://www.rfc-editor.org/info/rfc4446" xml:base="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.4446.xml">
          <front>
            <title>IANA Allocations for Pseudowire Edge to Edge Emulation (PWE3)</title>
            <author fullname="L. Martini" initials="L." surname="Martini"/>
            <date month="April" year="2006"/>
            <abstract>
              <t>This document allocates the fixed pseudowire identifier and other fixed protocol values for protocols that have been defined in the Pseudo Wire Edge to Edge (PWE3) working group.  Detailed IANA allocation instructions are also included in this document.  This document specifies an Internet Best Current Practices for the Internet Community, and requests discussion and suggestions for improvements.</t>
            </abstract>
          </front>
          <seriesInfo name="BCP" value="116"/>
          <seriesInfo name="RFC" value="4446"/>
          <seriesInfo name="DOI" value="10.17487/RFC4446"/>
        </reference>
        <reference anchor="RFC4761" target="https://www.rfc-editor.org/info/rfc4761" xml:base="https://www.rfc-editor.org/refs/bibxml/reference.RFC.4761.xml">
          <front>
            <title>Virtual Private LAN Service (VPLS) Using BGP for Auto-Discovery and Signaling</title>
            <author initials="K." surname="Kompella" fullname="K. Kompella" role="editor">
              <organization/>
            </author>
            <author initials="Y." surname="Rekhter" fullname="Y. Rekhter" role="editor">
              <organization/>
            </author>
            <date year="2007" month="January"/>
            <abstract>
              <t>Virtual Private LAN Service (VPLS), also known as Transparent LAN Service and Virtual Private Switched Network service, is a useful Service Provider offering.  The service offers a Layer 2 Virtual Private Network (VPN); however, in the case of VPLS, the customers in the VPN are connected by a multipoint Ethernet LAN, in contrast to the usual Layer 2 VPNs, which are point-to-point in nature.</t>
              <t>This document describes the functions required to offer VPLS, a mechanism for signaling a VPLS, and rules for forwarding VPLS frames across a packet switched network.  [STANDARDS-TRACK]</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="4761"/>
          <seriesInfo name="DOI" value="10.17487/RFC4761"/>
        </reference>
        <reference anchor="RFC4762" target="https://www.rfc-editor.org/info/rfc4762" xml:base="https://www.rfc-editor.org/refs/bibxml/reference.RFC.4762.xml">
          <front>
            <title>Virtual Private LAN Service (VPLS) Using Label Distribution Protocol (LDP) Signaling</title>
            <author initials="M." surname="Lasserre" fullname="M. Lasserre" role="editor">
              <organization/>
            </author>
            <author initials="V." surname="Kompella" fullname="V. Kompella" role="editor">
              <organization/>
            </author>
            <date year="2007" month="January"/>
            <abstract>
              <t>This document describes a Virtual Private LAN Service (VPLS) solution using pseudowires, a service previously implemented over other tunneling technologies and known as Transparent LAN Services (TLS).  A VPLS creates an emulated LAN segment for a given set of users; i.e., it creates a Layer 2 broadcast domain that is fully capable of learning and forwarding on Ethernet MAC addresses and that is closed to a given set of users.  Multiple VPLS services can be supported from a single Provider Edge (PE) node.</t>
              <t>This document describes the control plane functions of signaling pseudowire labels using Label Distribution Protocol (LDP), extending RFC 4447.  It is agnostic to discovery protocols.  The data plane functions of forwarding are also described, focusing in particular on the learning of MAC addresses.  The encapsulation of VPLS packets is described by RFC 4448.  [STANDARDS-TRACK]</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="4762"/>
          <seriesInfo name="DOI" value="10.17487/RFC4762"/>
        </reference>
        <reference anchor="RFC7432" target="https://www.rfc-editor.org/info/rfc7432" xml:base="https://bib.ietf.org/public/rfc/bibxml/reference.RFC.7432.xml">
          <front>
            <title>BGP MPLS-Based Ethernet VPN</title>
            <author fullname="A. Sajassi" initials="A." role="editor" surname="Sajassi"/>
            <author fullname="R. Aggarwal" initials="R." surname="Aggarwal"/>
            <author fullname="N. Bitar" initials="N." surname="Bitar"/>
            <author fullname="A. Isaac" initials="A." surname="Isaac"/>
            <author fullname="J. Uttaro" initials="J." surname="Uttaro"/>
            <author fullname="J. Drake" initials="J." surname="Drake"/>
            <author fullname="W. Henderickx" initials="W." surname="Henderickx"/>
            <date month="February" year="2015"/>
            <abstract>
              <t>This document describes procedures for BGP MPLS-based Ethernet VPNs (EVPN).  The procedures described here meet the requirements specified in RFC 7209 -- "Requirements for Ethernet VPN (EVPN)".</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="7432"/>
          <seriesInfo name="DOI" value="10.17487/RFC7432"/>
        </reference>
      </references>
    </references>
  </back>
</rfc>
