<?xml version="1.0" encoding="US-ASCII"?>
<!DOCTYPE rfc SYSTEM "rfc2629.dtd">
<?rfc toc="yes"?>
<?rfc tocompact="yes"?>
<?rfc tocdepth="3"?>
<?rfc tocindent="yes"?>
<?rfc symrefs="yes"?>
<?rfc sortrefs="yes"?>
<?rfc comments="yes"?>
<?rfc inline="yes"?>
<?rfc compact="yes"?>
<?rfc subcompact="no"?>
<rfc category="std" docName="draft-li-apn-header-05" ipr="trust200902">
  <front>
    <title abbrev="APN Header">Application-aware Networking (APN)
    Header</title>

    <author fullname="Zhenbin Li" initials="Z. " surname="Li">
      <organization>Huawei Technologies</organization>

      <address>
        <postal>
          <street/>

          <city>Beijing</city>

          <code>100095</code>

          <country>China</country>
        </postal>

        <email>lizhenbin@huawei.com</email>
      </address>
    </author>

    <author fullname="Shuai Zhang" initials="S. " surname="Zhang">
      <organization>China Unicom</organization>

      <address>
        <postal>
          <street/>

          <city>Beijing</city>

          <code/>

          <country>China</country>
        </postal>

        <email>zhangs366@chinaunicom.cn</email>
      </address>
    </author>

    <author fullname="Nan Geng" initials="N. " surname="Geng">
      <organization>Huawei Technologies</organization>

      <address>
        <postal>
          <street/>

          <city/>

          <code/>

          <country>China</country>
        </postal>

        <email>gengnan@huawei.com</email>
      </address>
    </author>

    <date day="10" month="Nov" year="2025"/>

    <abstract>
      <t>This document defines the application-aware networking (APN) header
      which can be used in a variety of data planes.</t>
    </abstract>
  </front>

  <middle>
    <section title="Introduction">
      <t>Application-aware Networking (APN) is introduced in <xref
      target="I-D.li-apn-framework"/> and <xref
      target="I-D.li-apn-problem-statement-usecases"/>. APN conveys an
      attribute with data packets in the network and makes the network aware
      of fine-grain requirements at the user group and application group
      levels.</t>

      <t>Such an attribute is acquired, constructed in a structured value, and
      then encapsulated in the packets. Such a structured value is treated as
      an opaque object in the network, to which the network operator applies
      policies in various nodes/service functions along the path and provides
      corresponding services.</t>

      <t>This structured attribute can be encapsulated in various data planes
      adopted within a Network Operator's controlled and limited domain, e.g.
      MPLS, VXLAN, SR/SRv6 and other tunnel technologies, which waits to be
      further specified.</t>

      <t>This document defines the application-aware networking (APN) header
      which can be used in different data planes. The typical data planes
      include the MPLS data plane and IPv6 data plane..</t>
    </section>

    <section 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">RFC 2119</xref> <xref target="RFC8174">RFC
      8174</xref> when, and only when, they appear in all capitals, as shown
      here.</t>
    </section>

    <section title="Terminologies">
      <t>APN: Application-aware Networking</t>

      <t>APN Attribute: Application-aware Networking Attribute, including APN
      ID and APN Parameters. It can be added at the edge devices of an APN
      domain along with the tunnel encapsulation.</t>

      <t>APN ID: Application-aware Networking ID, including Application Group
      ID and User Group ID.</t>

      <t>APN Para: Application-aware Networking Parameters, e.g.,
      network performance parameters.</t>
    </section>

    <section title="Application-aware Networking Header">
      <t>A common header is defined and can be used in different data planes.
      The common header carries the APN attribute that is composed of APN ID
      and APN parameters.</t>

      <t>This document defines three types of APN ID:</t>

      <t>- Type 1 APN ID: it is 32 bits.</t>

      <t>- Type 2 APN ID: it is 64 bits.</t>

      <t>- Type 3 APN ID: it is 128 bits.</t>

      <t>According to the types of APN ID, three types of APN headers are
      defined.</t>

      <t/>

      <t>Type 1 APN Header:</t>

      <t><figure align="center">
          <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 
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|  APN-ID-Type  |     Flags     |         APN-Para-Type         |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                             APN-ID                            |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                       Intent (Optional)                       |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                                                               |
|                       APN-Para (Optional)                     |
                             ......                              
|                                                               |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

           Figure 1. APN Header with Type 1 APN ID
]]></artwork>
        </figure>In this type of APN Header, the length of the APN ID is 32
      bits.</t>

      <t>APN-ID-Type: An 8-bit identifier, indicates the type of APN ID.</t>

      <t>Flags: An 8-bit field. The possible flags will be defined in the future
      versions of this document.</t>

      <t>APN-Para-Type: A 16-bit map that specifies which APN parameters are
      specified for the APN ID. The APN-Para-Type value is a bitmap. The
      packing order of the APN parameters follows the bit order as specified
      in the APN-Para-Type bitmap field. The following bits are defined in
      this document, with details on each bit described in Section 6.</t>

      <t>Bit 0 (Most significant bit) When set, indicates the presence of the
      bandwidth requirement.</t>

      <t>Bit 1 When set, indicates the presence of the delay requirement.</t>

      <t>Bit 2 When set, indicates the presence of the jitter requirement.</t>

      <t>Bit 3 When set, indicates the presence of the packet loss rate
      requirement.</t>

      <t>APN-ID: A 32-bit identifier.</t>

      <t>Intent: A 32-bit identifier, represents a set of service requirements
      to the network.</t>

      <t>APN-Para: A variable field including APN parameters. The presence of
      the APN parameters is indicated by the APN-Para-Type.</t>

      <t>Type 2 APN Header</t>

      <t><figure align="center">
          <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 
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|  APN-ID-Type  |     Flags     |         APN-Para-Type         |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                                                               |
|                             APN-ID                            |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                       Intent (Optional)                       |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                                                               |
|                       APN-Para (Optional)                     |
                             ......                              
|                                                               |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

           Figure 2. APN Header with Type 2 APN ID
]]></artwork>
        </figure></t>

      <t>In this type of APN Header, the length of the APN ID is 64 bits.</t>

      <t>APN-ID-Type: An 8-bit identifier, indicates the type of APN ID.</t>

      <t>Flags: An 8-bit field. The possible flags will be defined in the
      future versions of this document.</t>

      <t>APN-Para-Type: A 16-bit map which specifies which APN parameters are
      specified for the APN ID. The following bits are defined in this
      document, with details on each bit described in the Section 6. The order
      of packing the data fields in each node data element follows the bit
      order of the APN-Para-Type field, as follows:</t>

      <t>Bit 0 (Most significant bit) When set, indicates the presence of the
      bandwidth requirement.</t>

      <t>Bit 1 When set, indicates the presence of the delay requirement.</t>

      <t>Bit 2 When set, indicates the presence of the jitter requirement.</t>

      <t>Bit 3 When set, indicates the presence of the packet loss rate
      requirement.</t>

      <t>APN-ID: A 64-bit identifier.</t>

      <t>Intent: A 32-bit identifier, represents a set of service requirements
      to the network.</t>

      <t>APN-Para: A variable field including APN parameters. The presence of
      the APN parameters is indicated by the APN-Para-Type.</t>

      <t/>

      <t>Type 3 APN Header</t>

      <t><figure align="center">
          <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 
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|  APN-ID-Type  |     Flags     |         APN-Para-Type         |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                                                               |
|                             APN-ID                            |
|                                                               |
|                                                               |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                       Intent (Optional)                       |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                                                               |
|                       APN-Para (Optional)                     |
                             ......                              
|                                                               |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

           Figure 3. APN Header with Type 3 APN ID
]]></artwork>
        </figure></t>

      <t>In this type of APN Header, the length of the APN ID is 128 bits.</t>

      <t>APN-ID-Type: An 8-bit identifier, indicates the type of APN ID.</t>

      <t>Flags: An 8-bit field. The possible flags will be defined in the
      future versions of this document.</t>

      <t>APN-Para-Type: A 16-bit map which specifies which APN parameters are
      specified for the APN ID. The following bits are defined in this
      document, with details on each bit described in the Section 6. The order
      of packing the data fields in each node data element follows the bit
      order of the APN-Para-Type field, as follows:</t>

      <t>Bit 0 (Most significant bit) When set, indicates the presence of the
      bandwidth requirement.</t>

      <t>Bit 1 When set, indicates the presence of the delay requirement.</t>

      <t>Bit 2 When set, indicates the presence of the jitter requirement.</t>

      <t>Bit 3 When set, indicates the presence of the packet loss rate
      requirement.</t>

      <t>APN-ID: A 128-bit identifier.</t>

      <t>Intent: A 32-bit identifier, represents a set of service requirements
      to the network.</t>

      <t>APN-Para: A variable field including APN parameters. The presence of
      the APN parameters is indicated by the APN-Para-Type.</t>
    </section>

    <section title="APN ID">
      <t>The APN ID can be divided into three parts:</t>

      <t>APP-Group-ID: Application Group ID</t>

      <t>USER-Group-ID: User Group ID</t>

      <t>Reserved: The reserved field.</t>

      <t><figure align="center">
          <artwork><![CDATA[+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|      APP-Group-ID     |    USER-Group-ID    |    Reserved     |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

                Figure 4. Structure of APN-ID]]></artwork>
        </figure></t>

      <t>The lengths of the APP-Group-ID and the USER-Group-ID are variable.
      Their lengths must be configured and consistent within a specific APN
      domain.</t>
    </section>

    <section title="APN Parameters">
      <t>In the APN Header, the APN-Para-Type is a bit field to indicate the
      presence of corresponding APN parameters. When the bit is set, the
      corresponding APN parameter MUST exist in the APN Header. The length of
      each APN parameter is 32 bits. Thus it is easy to skip over unknown
      requirements.</t>

      <t>Typical APN parameters are the parameters related with the network
      performance requirements as follows:</t>

      <t>1. Bandwidth Requirement</t>

      <t>This Bandwidth Requirement parameter indicates the minimum acceptable
      bandwidth for the APN traffic. The format of this parameter is shown in
      the following diagram:</t>

      <figure>
        <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
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
   |                          Bandwidth                            |
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

                Figure 5. Bandwidth Requirement Parameter
]]></artwork>
      </figure>

      <t>where:</t>

      <t>Bandwidth: This 32-bit unsigned integer field carries the bandwidth
      requirement in Mbps along the path.</t>

      <t>2. Delay Requirement</t>

      <t>This Delay Requirement parameter indicates the maximum acceptable
      delay. The format of this parameter is shown in the following
      diagram:</t>

      <t><figure>
          <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
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
   |    RESERVED   |                   Delay                       |
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
                     
                   Figure 6. Delay Requirement Parameter
]]></artwork>
        </figure></t>

      <t>where:</t>

      <t>RESERVED: This field is reserved for future use. It MUST be set to 0
      when sent and MUST be ignored when received.</t>

      <t>Delay: This 24-bit field carries the delay requirements in
      microseconds, encoded as an unsigned integer value. When set to the
      maximum value 16,777,215 (16.777215 sec), then the delay is not
      constrained. This value is the highest delay that can be tolerated.</t>

      <t>3. Delay Variation Requirement</t>

      <t>This Delay Variation Requirement parameter indicates the maximum
      acceptable delay variation. The format of this parameter is shown in the
      following diagram:</t>

      <t><figure>
          <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
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
   |  RESERVED     |               Delay Variation                 |
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  
                   Figure 7. Delay Variation Parameter
]]></artwork>
        </figure></t>

      <t>where:</t>

      <t>RESERVED: This field is reserved for future use. It MUST be set to 0
      when sent and MUST be ignored when received.</t>

      <t>Delay Variation: This 24-bit field carries the delay variation
      requirements in microseconds, encoded as an unsigned integer value.</t>

      <t>4. Packet Loss Rate Requirement</t>

      <t>This Packet Loss Rate Requirement parameter indicates the maximum
      acceptable packet loss rate. The format of this parameter is shown in
      the following diagram:</t>

      <figure>
        <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
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
   |    RESERVED   |                    Packet Loss Rate           |
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

                   Figure 8. Packet Loss Rate Sub-TLV
]]></artwork>
      </figure>

      <t>where:</t>

      <t>RESERVED: This field is reserved for future use. It MUST be set to 0
      when sent and MUST be ignored when received.</t>

      <t>Packet Loss Rate: This 24-bit field carries packet loss rate
      requirement in packets per second as an unsigned integer. This value is
      the highest packet-loss rate that can be tolerated.</t>
    </section>

    <section anchor="IANA" title="IANA Considerations">
      <t>These IANA Considerations conform to [RFC8126].</t>

      <t>IANA is requested to create the following new registries on a new
      "Application-Aware Networking (APN)" webpage.</t>

      <section title="APN ID Types">
        <t>IANA is requested to create the following registry on the
        Application-Aware Networking (APN) Attribute webpage:</t>

        <t>Name: APN ID Types</t>

        <t>Registration Procedure: IETF Review</t>

        <t>Reference: [this document]</t>

        <figure>
          <artwork><![CDATA[  
		
   Value    Description     Reference
   -----   -------------   ---------------
       0    reserved
       1    Type 1 APN ID   [this document]
       2    Type 2 APN ID   [this document]
       3    Type 3 APN ID   [this document]
   4-254    unassigned
     255    reserved

]]></artwork>
        </figure>
      </section>

      <section title="APN Parameter Types">
        <t>IANA is requested to create the following registry on the
        Application-Aware Networking (APN) Attribute webpage:</t>

        <t>Name: APN Parameter Types</t>

        <t>Registration Procedure: IETF Review</t>

        <t>Reference: [this document]</t>

        <figure>
          <artwork><![CDATA[      

   Bit    Description               Reference
   ---   -----------------------   ---------------
     0   Bandwidth requirement     [this document]
     1   Delay requirement         [this document]
     2   Jitter requirement        [this document]
     3   Packet loss requirement   [this document]
  4-15   unassigned

]]></artwork>
        </figure>
      </section>
    </section>

    <section title="Acknowledgements">
      <t>The suggestions of the following are gratefully acknowledged: Stefano
      Previdi, Adrian Farrel, Donald Eastlake.</t>
    </section>

    <section anchor="Security" title="Security Considerations">
      <t>The Security Considerations described in <xref
      target="I-D.li-apn-problem-statement-usecases"/> and <xref
      target="I-D.peng-apn-security-privacy-consideration"/> can be referred
      to.</t>
    </section>
  </middle>

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

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

      <?rfc include='reference.RFC.8174'?>
	  
	  <?rfc include='reference.I-D.li-apn-framework'?>
	  
    </references>

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

      <?rfc include='reference.I-D.li-apn-problem-statement-usecases'?>

      <?rfc include='reference.I-D.peng-apn-security-privacy-consideration'?>
    </references>
  </back>
</rfc>
