<?xml version="1.0" encoding="US-ASCII"?>
<!DOCTYPE rfc SYSTEM "rfc2629.dtd">
<rfc category="std" docName="draft-ietf-pim-reserved-bits-04"
     ipr="trust200902" obsoletes="6166"
     updates="3973, 5015, 5059, 6754, 7761, 8364">
  <?rfc toc="yes"?>

  <?rfc compact="yes"?>

  <?rfc subcompact="no"?>

  <?rfc symrefs="yes"?>

  <front>
    <title abbrev="PIM Type Extension and Reserved Bits">PIM Message Type
    Space Extension and Reserved Bits</title>

    <author fullname="Stig Venaas" initials="S." surname="Venaas">
      <organization>Cisco Systems, Inc.</organization>

      <address>
        <postal>
          <street>Tasman Drive</street>

          <city>San Jose</city>

          <code>CA 95134</code>

          <country>USA</country>
        </postal>

        <email>stig@cisco.com</email>
      </address>
    </author>

    <author fullname="Alvaro Retana" initials="A." surname="Retana">
      <organization>Futurewei Technologies, Inc.</organization>

      <address>
        <postal>
          <street>2330 Central Expressway</street>

          <city>Santa Clara</city>

          <region/>

          <code>CA 95050</code>

          <country>USA</country>
        </postal>

        <phone/>

        <facsimile/>

        <email>alvaro.retana@futurewei.com</email>

        <uri/>
      </address>
    </author>

    <date day="19" month="September" year="2019"/>

    <area>Routing</area>

    <keyword>Multicast</keyword>

    <abstract>
      <t>The PIM version 2 messages share a common message header format. The
      common header definition contains eight reserved bits. This document
      specifies how these bits may be used by individual message types, and
      creates a registry containing the per-message-type usage. This document
      also extends the PIM type space by defining three new message types. For
      each of the new types, four of the previously reserved bits are used to
      form an extended type range.</t>

      <t>This document Updates RFC 7761 and RFC 3973 by defining the use of
      the currently Reserved field in the PIM common header. This document
      further updates RFC 7761 and RFC 3973, along with RFC 5015, RFC 5059,
      RFC 6754 and RFC 8364, by specifying the use of the currently Reserved
      bits for each PIM message.</t>

      <t>This document obsoletes RFC 6166.</t>
    </abstract>
  </front>

  <middle>
    <section title="Introduction">
      <t>The PIM version 2 messages share a common message header format
      defined in the PIM Sparse Mode <xref target="RFC7761"/> specification.
      The common header definition contains eight Reserved bits. While all
      message types use this common header, there is no document formally
      specifying that these bits are to be used per message type.</t>

      <t>This document refers to the bits specified as Reserved in the common
      PIM header <xref target="RFC7761"/> as PIM message type Flag Bits, or
      simply Flag Bits, and it specifies that they are to be separately used
      on a per-message-type basis. It creates a registry containing the
      per-message-type usage. </t>

      <t>This document Updates <xref target="RFC7761"/> and <xref
      target="RFC3973"/> by defining the use of the currently Reserved field
      in the PIM common header. This document further updates <xref
      target="RFC7761"/> and <xref target="RFC3973"/>, along with <xref
      target="RFC5015"/>, <xref target="RFC5059"/>, <xref target="RFC6754"/>
      and <xref target="RFC8364"/>, by specifying the use of the currently
      Reserved bits for each PIM message.</t>

      <t>The currently defined PIM message types are in the range from 0 to
      15. That type space is almost exhausted. Message type 15 was reserved by
      <xref target="RFC6166"/> for type space extension. In <xref
      target="ext"/>, this document specifies the use of the Flag Bits for
      message types 13, 14 and 15 in order to extend the PIM type space. This
      document Obsoletes <xref target="RFC6166"/>.</t>
    </section>

    <section title="Conventions used in this document">
      <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 target="RFC8174"/> when, and only when,
      they appear in all capitals, as shown here.</t>
    </section>

    <section title="PIM header common format">
      <t>The common PIM header is defined in section 4.9 of <xref
      target="RFC7761"/>. This document updates the definition of the Reserved
      field and refers to that field as PIM message type Flag Bits, or simply
      Flag Bits. The new common header format is as below. <figure
          title="Figure 1: New Common Header">
          <artwork><![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
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
   |PIM Ver| Type  |   Flag Bits   |           Checksum            |
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
        ]]></artwork>
        </figure></t>

      <t>The Flag Bits field is defined in <xref target="flagbits"/>. All
      other fields remain unchanged.</t>
    </section>

    <section anchor="flagbits" title="Flag Bit definitions">
      <t>Unless otherwise specified, all the Flag Bits for each PIM type are
      Reserved <xref target="RFC8126"/>. They MUST be set to zero on
      transmission, and they MUST be ignored upon receipt. The specification
      of a new PIM type MUST indicate whether the bits should be treated
      differently.</t>

      <t>When defining Flag Bits, it is helpful to have a well-defined way of
      referring to a particular bit. The most significant of the Flag Bits,
      the bit immediately following the type field is referred to as bit 7.
      The least significant, the bit right in front of the checksum field is
      referred to as bit 0. This is shown in the diagram below.</t>

      <t><figure title="Figure 2: Flag Bits">
          <artwork><![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
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
   |PIM Ver| Type  |7 6 5 4 3 2 1 0|           Checksum            |
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
        ]]></artwork>
        </figure></t>

      <section title="Flag Bits for Type 4 (Bootstrap)">
        <t>PIM message type 4 (Bootstrap) <xref target="RFC5059"/> defines
        Flag Bit 7 as No-Forward. The usage of the bit is defined in that
        document. The remaining Flag Bits are Reserved.</t>
      </section>

      <section title="Flag Bits for Type 10 (DF Election)">
        <t>PIM message type 10 (DF Election) <xref target="RFC5015"/>
        specifies that the four most significant Flag Bits (bits 4-7) are to
        be used as a Subtype. The usage of those bits is defined in that
        document. The remaining Flag Bits are Reserved.</t>
      </section>

      <section title="Flag Bits for Type 12 (PFM)">
        <t>PIM message type 12 (PFM) <xref target="RFC8364"/> defines Flag Bit
        7 as No-Forward. The usage of the bit is defined in that document. The
        remaining Flag Bits are Reserved.</t>
      </section>

      <section title="Flag Bits for Types 13, 14 and 15 (Type Space Extension)">
        <t>These types and the corresponding Flag Bits are defined in <xref
        target="ext"/>.</t>
      </section>
    </section>

    <section anchor="ext" title="PIM Type Space Extension">
      <t>This document defines types 13, 14 and 15, such that each of these
      types has 16 subtypes, providing a total of 48 subtypes available for
      future PIM extensions. This is achieved by defining a new SubType field
      (see Figure 3) using the four most significant Flag Bits (bits 4-7). The
      notation type.subtype is used to reference these new extended types. The
      remaining four Flag Bits (bits 0-3) are Reserved to be used by each
      extended type (abbreviated as FB below). </t>

      <t><figure title="Figure 3: Sub-Types">
          <artwork><![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
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
   |PIM Ver| Type  |SubType|  FB   |           Checksum            |
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
        ]]></artwork>
        </figure></t>
    </section>

    <section title="Security Considerations">
      <t>This document clarifies the use of the Flag Bits in the common PIM
      header and it extends the PIM type space. As such, there is no impact on
      security or changes to the considerations in <xref target="RFC7761"/>
      and <xref target="RFC3973"/>.</t>
    </section>

    <section anchor="IANA" title="IANA Considerations">
      <t>This document updates the PIM Message Types registry to indicate
      which Flag Bits are defined for use by each of the PIM message types.
      The Registry should now reference this document instead of <xref
      target="RFC6166"/>. The Registration Policy remains IETF Review <xref
      target="RFC8126"/>. Assignments into this registry MUST define any
      non-default usage (see <xref target="flagbits"/>) of the Flag Bits in
      addition to defining the Type.</t>

      <t>The updated PIM Message Types registry is shown below.</t>

      <t><figure title="Table 1: Updated PIM Message Types Registry">
          <artwork><![CDATA[
 Type         Name                   Flag Bits        Reference
---------------------------------------------------------------------
  0         Hello                  0-7: Reserved   [RFC3973][RFC7761]

  1         Register               0-7: Reserved   [RFC7761]

  2         Register Stop          0-7: Reserved   [RFC7761]

  3         Join/Prune             0-7: Reserved   [RFC3973][RFC7761]

  4         Bootstrap              0-6: Reserved   [RFC5059][RFC7761]
                                   7: No-Forward   [RFC5059]

  5         Assert                 0-7: Reserved   [RFC3973][RFC7761]

  6         Graft                  0-7: Reserved   [RFC3973]

  7         Graft-Ack              0-7: Reserved   [RFC3973]

  8         Candidate RP           0-7: Reserved   [RFC7761]
              Advertisement 

  9         State Refresh          0-7: Reserved   [RFC3973]
 
 10         DF Election            0-3: Reserved   [RFC5015]
                                   4-7: Subtype    [RFC5015]

 11         ECMP Redirect          0-7: Reserved   [RFC6754]

 12         PIM Flooding Mechanism 0-6: Reserved   [RFC8364]
                                   7: No-Forward   [RFC8364]

 13.0-15.15 Unassigned             0-3: Unassigned [this document]
]]></artwork>
        </figure>The Unassigned types above, as explained in <xref
      target="ext"/>, use the extended type notation of type.subtype. Each
      extended type only has 4 Flag Bits available. New extended message types
      should be assigned conscutively, starting with 13.0, then 13.1, etc.</t>
    </section>
  </middle>

  <back>
    <references title="Normative References">
      <?rfc include='reference.RFC.2119' ?>

      <?rfc include='reference.RFC.7761' ?>

      <?rfc include='reference.RFC.8126'?>

      <?rfc include='reference.RFC.8174'?>
    </references>

    <references title="Informative References">
      <?rfc include='reference.RFC.6166'?>

      <?rfc include='reference.RFC.3973' ?>

      <?rfc include='reference.RFC.6754' ?>

      <?rfc include='reference.RFC.8364' ?>

      <?rfc include='reference.RFC.5059' ?>

      <?rfc include='reference.RFC.5015' ?>
    </references>
  </back>
</rfc>
