<?xml version="1.0" encoding="utf-8"?>
  <?xml-stylesheet type="text/xsl" href="rfc2629.xslt" ?>
  <!-- generated by https://github.com/cabo/kramdown-rfc version 1.6.17 (Ruby 2.7.0) -->


<!DOCTYPE rfc  [
  <!ENTITY nbsp    "&#160;">
  <!ENTITY zwsp   "&#8203;">
  <!ENTITY nbhy   "&#8209;">
  <!ENTITY wj     "&#8288;">

]>

<?rfc comments="yes"?>

<rfc ipr="trust200902" docName="draft-ietf-teas-rfc8776-update-05" category="std" consensus="true" submissionType="IETF" obsoletes="8776" tocInclude="true" sortRefs="true" symRefs="true">
  <front>
    <title abbrev="TE Common YANG Types">Common YANG Data Types for Traffic Engineering</title>

    <author initials="I." surname="Busi" fullname="Italo Busi">
      <organization>Huawei</organization>
      <address>
        <email>italo.busi@huawei.com</email>
      </address>
    </author>
    <author initials="A." surname="Guo" fullname="Aihua Guo">
      <organization>Futurewei Technologies</organization>
      <address>
        <email>aihuaguo.ietf@gmail.com</email>
      </address>
    </author>
    <author initials="X." surname="Liu" fullname="Xufeng Liu">
      <organization>Alef Edge</organization>
      <address>
        <email>xufeng.liu.ietf@gmail.com</email>
      </address>
    </author>
    <author initials="T." surname="Saad" fullname="Tarek Saad">
      <organization>Cisco Systems Inc.</organization>
      <address>
        <email>tsaad.net@gmail.com</email>
      </address>
    </author>
    <author initials="V. P." surname="Beeram" fullname="Vishnu Pavan Beeram">
      <organization>Juniper Networks</organization>
      <address>
        <email>vbeeram@juniper.net</email>
      </address>
    </author>
    <author initials="I." surname="Bryskin" fullname="Igor Bryskin">
      <organization>Individual</organization>
      <address>
        <email>i_bryskin@yahoo.com</email>
      </address>
    </author>

    <date year="2023" month="July" day="10"/>

    
    <workgroup>TEAS Working Group</workgroup>
    

    <abstract>


<t>This document defines a collection of common data types and groupings in YANG data modeling language. These derived common types and groupings are intended to be imported by modules that model Traffic Engineering (TE) configuration and state capabilities. This document obsoletes RFC 8776.</t>



    </abstract>



  </front>

  <middle>


<section anchor="introduction"><name>Introduction</name>

<t>YANG <xref target="RFC6020"/> <xref target="RFC7950"/> is a data modeling language used to model configuration data, state data, Remote Procedure Calls, and notifications for network management protocols such as the Network Configuration Protocol (NETCONF) <xref target="RFC6241"/>. The YANG language supports a small set of built-in data types and provides mechanisms to derive other types from the built-in types.</t>

<t>This document introduces a collection of common data types derived from the built-in YANG data types. The derived types and groupings are designed to be the common types applicable for modeling Traffic Engineering (TE) features in model(s) defined outside of this document.</t>

<t>This document adds few additional common data types, identities, and groupings to both the "ietf-te-types" and the "ietf-te-packet-types" YANG models and obsoletes <xref target="RFC8776"/>.</t>

<t>For further details, see the revision statements of the YANG modules in Sections X and Y or the summary in Appendix A.</t>

<t>CHANGE NOTE: These definitions have been developed in <xref target="I-D.ietf-teas-yang-te"/>, <xref target="I-D.ietf-teas-yang-path-computation"/> and <xref target="I-D.ietf-teas-yang-l3-te-topo"/> and are quite mature: <xref target="I-D.ietf-teas-yang-te"/> and <xref target="I-D.ietf-teas-yang-path-computation"/> in particular are in WG Last Call and some definitions have been moved to this document as part of WG LC comments resolution.</t>

<t>RFC Editor: remove the CHANGE NOTE above and this note</t>

<section anchor="requirements-notation"><name>Requirements Notation</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 BCP 14 <xref target="RFC2119"/> <xref target="RFC8174"/> when, and only when, they
appear in all capitals, as shown here.</t>

</section>
<section anchor="terminology"><name>Terminology</name>

<t>The terminology for describing YANG data models is found in
   <xref target="RFC7950"/>.</t>

</section>
<section anchor="prefixes-in-data-node-names"><name>Prefixes in Data Node Names</name>

<t>In this document, names of data nodes and other data model objects
  are prefixed using the standard prefix associated with the
  corresponding YANG imported modules, as shown in <xref target="tab-prefixes"/>.</t>

<texttable title="Prefixes and corresponding YANG modules" anchor="tab-prefixes">
      <ttcol align='left'>Prefix</ttcol>
      <ttcol align='left'>YANG module</ttcol>
      <ttcol align='left'>Reference</ttcol>
      <c>yang</c>
      <c>ietf-yang-types</c>
      <c><xref target="RFC6991"/></c>
      <c>inet</c>
      <c>ietf-inet-types</c>
      <c><xref target="RFC6991"/></c>
      <c>rt-types</c>
      <c>ietf-routing-types</c>
      <c><xref target="RFC8294"/></c>
      <c>te-types</c>
      <c>ietf-te-types</c>
      <c>RFCXXXX</c>
      <c>te-packet-types</c>
      <c>ietf-te-packet-types</c>
      <c>RFCXXXX</c>
</texttable>

<t>RFC Editor: Please replace XXXX with the RFC number assigned to this document.</t>

</section>
</section>
<section anchor="acronyms-and-abbreviations"><name>Acronyms and Abbreviations</name>

<t>GMPLS:</t>

<ul empty="true"><li>
  <t>Generalized Multiprotocol Label Switching</t>
</li></ul>

<t>LSP:</t>

<ul empty="true"><li>
  <t>Label Switched Path</t>
</li></ul>

<t>LSR:</t>

<ul empty="true"><li>
  <t>Label Switching Router</t>
</li></ul>

<t>LER:</t>

<ul empty="true"><li>
  <t>Label Edge Router</t>
</li></ul>

<t>MPLS:</t>

<ul empty="true"><li>
  <t>Multiprotocol Label Switching</t>
</li></ul>

<t>RSVP:</t>

<ul empty="true"><li>
  <t>Resource Reservation Protocol</t>
</li></ul>

<t>TE:</t>

<ul empty="true"><li>
  <t>Traffic Engineering</t>
</li></ul>

<t>DS-TE:</t>

<ul empty="true"><li>
  <t>Differentiated Services Traffic Engineering</t>
</li></ul>

<t>SRLG:</t>

<ul empty="true"><li>
  <t>Shared Risk Link Group</t>
</li></ul>

<t>NBMA:</t>

<ul empty="true"><li>
  <t>Non-Broadcast Multi-Access</t>
</li></ul>

<t>APS:</t>

<ul empty="true"><li>
  <t>Automatic Protection Switching</t>
</li></ul>

<t>SD:</t>

<ul empty="true"><li>
  <t>Signal Degrade</t>
</li></ul>

<t>SF:</t>

<ul empty="true"><li>
  <t>Signal Fail</t>
</li></ul>

<t>WTR:</t>

<ul empty="true"><li>
  <t>Wait-to-Restore</t>
</li></ul>

<t>PM:</t>

<ul empty="true"><li>
  <t>Performance Metrics</t>
</li></ul>

</section>
<section anchor="overview"><name>Overview</name>

<t>This document defines two YANG modules for common TE types: "ietf-te-types" for TE generic types and "ietf-te-packet-types" for packet-specific types. Other technology-specific TE types are outside the scope of this document.</t>

<section anchor="te-types-module-contents"><name>TE Types Module Contents</name>

<t>The "ietf-te-types" module (<xref target="te-yang-code"/>) contains common TE types that are independent and agnostic of any specific technology or control-plane instance.</t>

<t>The "ietf-te-types" module contains the following YANG reusable types and groupings:</t>

<t>te-bandwidth:</t>

<ul empty="true"><li>
  <t>A YANG grouping that defines the generic TE bandwidth. The modeling structure allows augmentation for each technology. For unspecified technologies, the string-encoded "te-bandwidth" type is used.</t>
</li></ul>

<t>te-label:</t>

<ul empty="true"><li>
  <t>A YANG grouping that defines the generic TE label. The modeling structure allows augmentation for each technology. For unspecified technologies, "rt-types:generalized-label" is used.</t>
</li></ul>

<t>performance-metrics-attributes:</t>

<ul empty="true"><li>
  <t>A YANG grouping that defines one-way and two-way measured Performance Metrics (PM) and indications of anomalies on link(s) or the path as defined in <xref target="RFC7471"/>, <xref target="RFC8570"/>, and <xref target="RFC7823"/>.</t>
</li></ul>

<t>performance-metrics-throttle-container:</t>

<ul empty="true"><li>
  <t>A YANG grouping that defines configurable thresholds for advertisement suppression and measurement intervals.</t>
</li></ul>

<t>te-ds-class:</t>

<ul empty="true"><li>
  <t>A type representing the Differentiated Services (DS) Class-Type of traffic as defined in <xref target="RFC4124"/>.</t>
</li></ul>

<t>te-label-direction:</t>

<ul empty="true"><li>
  <t>An enumerated type for specifying the forward or reverse direction of a label.</t>
</li></ul>

<t>te-hop-type:</t>

<ul empty="true"><li>
  <t>An enumerated type for specifying that a hop is loose or strict.</t>
</li></ul>

<t>te-global-id:</t>

<ul empty="true"><li>
  <t>A type representing the identifier that uniquely identifies an operator, which can be either a provider or a client. The definition of this type is taken from <xref target="RFC6370"/> and <xref target="RFC5003"/>. This attribute type is used solely to provide a globally unique context for TE topologies.</t>
</li></ul>

<t>te-node-id:</t>

<ul empty="true"><li>
  <t>A type representing the identifier for a node in a TE topology. The identifier is represented as 4 octets in dotted-quad notation. This attribute MAY be mapped to the Router Address TLV described in Section 2.4.1 of <xref target="RFC3630"/>, the TE Router ID described in Section 3 of <xref target="RFC6827"/>, the Traffic Engineering Router ID TLV described in Section 4.3 of <xref target="RFC5305"/>, or the TE Router ID TLV described in Section 3.2.1 of <xref target="RFC6119"/>. The reachability of such a TE node MAY be achieved by a mechanism such as that described in Section 6.2 of <xref target="RFC6827"/>.</t>
</li></ul>

<t>te-topology-id:</t>

<ul empty="true"><li>
  <t>A type representing the identifier for a topology. It is optional to have one or more prefixes at the beginning, separated by colons. The prefixes can be "network-types" as defined in the "ietf-network" module in <xref target="RFC8345"/>, to help the user better understand the topology before further inquiry is made.</t>
</li></ul>

<t>te-tp-id:</t>

<ul empty="true"><li>
  <t>A type representing the identifier of a TE interface Link Termination Point (LTP) on a specific TE node where the TE link connects. This attribute is mapped to a local or remote link identifier <xref target="RFC3630"/> <xref target="RFC5305"/>.</t>
</li></ul>

<t>te-path-disjointness:</t>

<ul empty="true"><li>
  <t>A type representing the different resource disjointness options for a TE tunnel path as defined in <xref target="RFC4872"/>.</t>
</li></ul>

<t>admin-groups:</t>

<ul empty="true"><li>
  <t>A union type for a TE link's classic or extended administrative groups as defined in <xref target="RFC3630"/>, <xref target="RFC5305"/>, and <xref target="RFC7308"/>.</t>
</li></ul>

<t>srlg:</t>

<ul empty="true"><li>
  <t>A type representing the Shared Risk Link Group (SRLG) as defined in <xref target="RFC4203"/> and <xref target="RFC5307"/>.</t>
</li></ul>

<t>te-metric:</t>

<ul empty="true"><li>
  <t>A type representing the TE metric as defined in <xref target="RFC3785"/>.</t>
</li></ul>

<t>te-recovery-status:</t>

<ul empty="true"><li>
  <t>An enumerated type for the different statuses of a recovery action as defined in <xref target="RFC4427"/> and <xref target="RFC6378"/>.</t>
</li></ul>

<t>path-attribute-flags:</t>

<ul empty="true"><li>
  <t>A base YANG identity for supported LSP path flags as defined in <xref target="RFC3209"/>, <xref target="RFC4090"/>, <xref target="RFC4736"/>, <xref target="RFC5712"/>, <xref target="RFC4920"/>, <xref target="RFC5420"/>, <xref target="RFC7570"/>, <xref target="RFC4875"/>, <xref target="RFC5151"/>, <xref target="RFC5150"/>, <xref target="RFC6001"/>, <xref target="RFC6790"/>, <xref target="RFC7260"/>, <xref target="RFC8001"/>, <xref target="RFC8149"/>, and <xref target="RFC8169"/>.</t>
</li></ul>

<t>link-protection-type:</t>

<ul empty="true"><li>
  <t>A base YANG identity for supported link protection types as defined in <xref target="RFC4872"/> and <xref target="RFC4427"/>.</t>
</li></ul>

<t>restoration-scheme-type:</t>

<ul empty="true"><li>
  <t>A base YANG identity for supported LSP restoration schemes as defined in <xref target="RFC4872"/>.</t>
</li></ul>

<t>protection-external-commands:</t>

<ul empty="true"><li>
  <t>A base YANG identity for supported protection-related external commands used for troubleshooting purposes, as defined in <xref target="RFC4427"/> and <xref target="ITU_G.808.1"/>.</t>
</li></ul>

<t>CHANGE NOTE: The description and reference of the identity action-exercise, which applies only to APS and it is not defined in RFC4427, has been updated to reference ITU-T G.808.1.</t>

<t>RFC Editor: remove the CHANGE NOTE above and this note</t>

<t>association-type:</t>

<ul empty="true"><li>
  <t>A base YANG identity for supported LSP association types as defined in <xref target="RFC6780"/>, <xref target="RFC4872"/>, <xref target="RFC4873"/>, and <xref target="RFC8800"/>.</t>
</li></ul>

<t>CHANGE NOTE: The association-type-diversity identity, defined in <xref target="RFC8800"/> has been added to the association-type base identity.</t>

<t>RFC Editor: remove the CHANGE NOTE above and this note</t>

<t>objective-function-type:</t>

<ul empty="true"><li>
  <t>A base YANG identity for supported path objective functions as defined in <xref target="RFC5541"/>.</t>
</li></ul>

<t>CHANGE NOTE: The objective-function-type identity has been redefined to be used only for path objective functions and a new svec-objective-function-type identity has been added for the Synchronization VECtor (SVEC) objective functions. Therefore the of-minimize-agg-bandwidth-consumption, of-minimize-load-most-loaded-link and of-minimize-cost-path-set identities, defined in <xref target="RFC5541"/> and derived from the objective-function-type identity, have been obsoleted because not applicable to paths but to Synchronization VECtor (SVEC) objects.</t>

<t>RFC Editor: remove the CHANGE NOTE above and this note</t>

<t>te-tunnel-type:</t>

<ul empty="true"><li>
  <t>A base YANG identity for supported TE tunnel types as defined in <xref target="RFC3209"/> and <xref target="RFC4875"/>.</t>
</li></ul>

<t>lsp-encoding-types:</t>

<ul empty="true"><li>
  <t>A base YANG identity for supported LSP encoding types as defined in <xref target="RFC3471"/>.</t>
</li></ul>

<t>lsp-protection-type:</t>

<ul empty="true"><li>
  <t>A base YANG identity for supported LSP protection types as defined in <xref target="RFC4872"/> and <xref target="RFC4873"/>.</t>
</li></ul>

<t>switching-capabilities:</t>

<ul empty="true"><li>
  <t>A base YANG identity for supported interface switching capabilities as defined in <xref target="RFC3471"/>.</t>
</li></ul>

<t>resource-affinities-type:</t>

<ul empty="true"><li>
  <t>A base YANG identity for supported attribute filters associated with a tunnel that must be satisfied for a link to be acceptable as defined in <xref target="RFC2702"/> and <xref target="RFC3209"/>.</t>
</li></ul>

<t>path-metric-type:</t>

<ul empty="true"><li>
  <t>A base YANG identity for supported path metric types as defined in <xref target="RFC3785"/> and <xref target="RFC7471"/>.</t>
</li></ul>

<t>explicit-route-hop:</t>

<ul empty="true"><li>
  <t>A YANG grouping that defines supported explicit routes as defined in <xref target="RFC3209"/> and <xref target="RFC3477"/>.</t>
</li></ul>

<t>te-link-access-type:</t>

<ul empty="true"><li>
  <t>An enumerated type for the different TE link access types as defined in <xref target="RFC3630"/>.</t>
</li></ul>

<t>CHANGE NOTE: The module "ietf-te-types" has been updated to add the following YANG identities, types and groupings.</t>

<t>RFC Editor: remove the CHANGE NOTE above and this note</t>

<t>bandwidth-scientific-notation:</t>

<ul empty="true"><li>
  <t>This data type represents the bandwidth, in bit-per-second, using the scientific notation (e.g., 10e3).</t>
</li></ul>

<t>lsp-provisioning-error-reason:</t>

<ul empty="true"><li>
  <t>A base YANG identity for reporting LSP provisioning error reasons. No standard LPS provisioning error reasons are defined in this document.</t>
</li></ul>

<t>path-computation-error-reason:</t>

<ul empty="true"><li>
  <t>A base YANG identity for reporting path computation error reasons as defined in <xref target="pc-error"/>.</t>
</li></ul>

<t>protocol-origin-type:</t>

<ul empty="true"><li>
  <t>A base YANG identity for the type of protocol origin as defined in <xref target="protocol-origin"/>.</t>
</li></ul>

<t>svec-objective-function-type:</t>

<ul empty="true"><li>
  <t>A base YANG identity for supported SVEC objective functions as defined in <xref target="RFC5541"/> and <xref target="RFC8685"/>.</t>
</li></ul>

<t>svec-metric-type:</t>

<ul empty="true"><li>
  <t>A base YANG identity for supported SVEC objective functions as defined in <xref target="RFC5541"/>.</t>
</li></ul>

<t>encoding-and-switching-type:</t>

<ul empty="true"><li>
  <t>This is a common grouping to define the LSP encoding and switching types.</t>
</li></ul>

<t>CHANGE NOTE: The tunnel-admin-state-auto YANG identity, derived from the tunnel-admin-status-type base YANG identity has also been added. No description is provided, since no description for the tunnel-admin-status-type base YANG identity has been provided in RFC8776.</t>

<t>CHANGE NOTE: The lsp-restoration-restore-none YANG identity, derived from the lsp-restoration-type base YANG identity has also been added. No description is provided, since no description for the lsp-restoration-type base YANG identity has been provided in RFC8776.</t>

<t>RFC Editor: remove the two CHANGE NOTEs above and this note</t>

<section anchor="pc-error"><name>Path Computation Errors</name>

<t>The "ietf-te-types" module contains the YANG reusable identities for reporting path computation error reasons as defined in <xref target="RFC5440"/>, <xref target="RFC5441"/>, <xref target="RFC5520"/>, <xref target="RFC5557"/>, <xref target="RFC8306"/>, and <xref target="RFC8685"/>.</t>

<t>It also defines the following additional YANG reusable identities for reporting also the following path computation error reasons:</t>

<t>path-computation-error-no-topology:</t>

<ul empty="true"><li>
  <t>A YANG identity for reporting path computation error when there is no topology with the provided topology identifier.</t>
</li></ul>

</section>
<section anchor="protocol-origin"><name>Protocol Origin</name>

<t>The "ietf-te-types" module contains the YANG reusable identities for the type of protocol origin as defined in <xref target="RFC5440"/> and <xref target="RFC9012"/>.</t>

<t>It also defines the following additional YANG reusable identities for the type of protocol origin:</t>

<t>protocol-origin-api:</t>

<ul empty="true"><li>
  <t>A YANG identity to be used when  the type of protocol origin is an Application Programmable Interface (API).</t>
</li></ul>

</section>
</section>
<section anchor="packet-te-types-module-contents"><name>Packet TE Types Module Contents</name>

<t>The "ietf-te-packet-types" module (<xref target="pkt-yang-code"/>) covers the common types and groupings that are specific to packet technology.</t>

<t>The "ietf-te-packet-types" module contains the following YANG reusable types and groupings:</t>

<t>backup-protection-type:</t>

<ul empty="true"><li>
  <t>A base YANG identity for supported protection types that a backup or bypass tunnel can provide as defined in <xref target="RFC4090"/>.</t>
</li></ul>

<t>te-class-type:</t>

<ul empty="true"><li>
  <t>A type that represents the Diffserv-TE Class-Type as defined in <xref target="RFC4124"/>.</t>
</li></ul>

<t>bc-type:</t>

<ul empty="true"><li>
  <t>A type that represents Diffserv-TE Bandwidth Constraints (BCs) as defined in <xref target="RFC4124"/>.</t>
</li></ul>

<t>bc-model-type:</t>

<ul empty="true"><li>
  <t>A base YANG identity for supported Diffserv-TE Bandwidth Constraints Models as defined in <xref target="RFC4125"/>, <xref target="RFC4126"/>, and <xref target="RFC4127"/>.</t>
</li></ul>

<t>te-bandwidth-requested-type:</t>

<ul empty="true"><li>
  <t>An enumerated type for the different options to request bandwidth for a specific tunnel.</t>
</li></ul>

<t>performance-metrics-attributes-packet:</t>

<ul empty="true"><li>
  <t>A YANG grouping that contains the generic performance metrics and additional packet-specific metrics.</t>
</li></ul>

<t>CHANGE NOTE: The module "ietf-te-packet-types" has been updated to add the following YANG identities and groupings.</t>

<t>RFC Editor: remove the CHANGE NOTE above and this note</t>

<t>bandwidth-profile-type:</t>

<ul empty="true"><li>
  <t>A base YANG identity for various bandwidth profiles specified in <xref target="MEF_10.3"/>, <xref target="RFC2697"/>, <xref target="RFC2698"/> and <xref target="RFC4115"/> that may be used to limit bandwidth utilization of packet flows (e.g., MPLS-TE LSPs).</t>
</li></ul>

<t>te-packet-path-bandwidth</t>

<ul empty="true"><li>
  <t>A YANG grouping that defines the path bandwidth information and could be used in any Packet TE model (e.g., MPLS-TE topology model) for the path bandwidth representation (e.g., the bandwidth of an MPLS-TE LSP).</t>
</li></ul>

<ul empty="true"><li>
  <t>All the path and LSP bandwidth related sections in the "ietf-te-types" generic module, <xref target="te-yang-code"/>, need to be augmented with this grouping for the usage of Packet TE technologies.</t>
</li></ul>

<ul empty="true"><li>
  <t>The Packet TE path bandwidth can be represented by a bandwidth profile as follow:</t>
</li></ul>

<figure><artwork type="ascii-art"><![CDATA[
         +--:(packet)
           +--rw bandwidth-profile-name?   string
           +--rw bandwidth-profile-type?   identityref
           +--rw cir?                      uint64
           +--rw eir?                      uint64
           +--rw cbs?                      uint64
           +--rw ebs?                      uint64
]]></artwork></figure>

<t>NOTE: Other formats for the MPLS-TE path bandwidth are defined in <xref target="I-D.ietf-teas-yang-te-mpls"/> and they could be added in a future update of this document.</t>

<t>te-packet-link-bandwidth:</t>

<ul empty="true"><li>
  <t>A YANG grouping that defines the link bandwidth information and could be used in any Packet TE model (e.g., MPLS-TE topology) for link bandwidth representation.</t>
</li></ul>

<ul empty="true"><li>
  <t>All the link bandwidth related sections in the "ietf-te-types" generic module, <xref target="te-yang-code"/>, need to be augmented with this grouping for the usage of Packet TE technologies.</t>
</li></ul>

<ul empty="true"><li>
  <t>The Packet TE link bandwidth can be represented by a bandwidth expressed in scientific notation as follow:</t>
</li></ul>

<figure><artwork type="ascii-art"><![CDATA[
         +--:(packet)
           +--rw packet-bandwidth?   bandwidth-scientific-notation
]]></artwork></figure>

</section>
</section>
<section anchor="te-yang-code"><name>TE Types YANG Module</name>

<t>The "ietf-te-types" module imports from the following modules:</t>

<t><list style="symbols">
  <t>"ietf-yang-types" and "ietf-inet-types" as defined in <xref target="RFC6991"/></t>
  <t>"ietf-routing-types" as defined in <xref target="RFC8294"/></t>
</list></t>

<t>In addition to <xref target="RFC6991"/> and <xref target="RFC8294"/>, this module references the following documents in defining the types and YANG groupings:
<xref target="RFC3272"/>, <xref target="RFC4090"/>, <xref target="RFC4202"/>, <xref target="RFC4328"/>, <xref target="RFC4561"/>, <xref target="RFC4657"/>, <xref target="RFC4736"/>, <xref target="RFC6004"/>, <xref target="RFC6511"/>, <xref target="RFC7139"/>, <xref target="RFC7308"/>, <xref target="RFC7551"/>, <xref target="RFC7571"/>, <xref target="RFC7579"/>, and <xref target="ITU-T_G.709"/>.</t>

<t>CHANGE NOTE: Please focus your review only on the updates to the YANG model: see also <xref target="te-yang-diff"/>.</t>

<t>RFC Editor: remove the CHANGE NOTE above and this note</t>

<figure title="TE Types YANG module" anchor="fig-te-yang"><sourcecode type="yang" markers="true" name="ietf-te-types@2023-06-27.yang"><![CDATA[
module ietf-te-types {
  yang-version 1.1;
  namespace "urn:ietf:params:xml:ns:yang:ietf-te-types";
  prefix te-types;

  import ietf-inet-types {
    prefix inet;
    reference
      "RFC 6991: Common YANG Data Types";
  }
  import ietf-yang-types {
    prefix yang;
    reference
      "RFC 6991: Common YANG Data Types";
  }
  import ietf-routing-types {
    prefix rt-types;
    reference
      "RFC 8294: Common YANG Data Types for the Routing Area";
  }

  import ietf-network {
    prefix "nw";
    reference "RFC 8345: A YANG Data Model for Network Topologies";
  }

  import ietf-network-topology {
    prefix "nt";
    reference "RFC 8345: A YANG Data Model for Network Topologies";
  }

  organization
    "IETF Traffic Engineering Architecture and Signaling (TEAS)
     Working Group";
  contact
    "WG Web:   <https://datatracker.ietf.org/wg/teas/>
     WG List:  <mailto:teas@ietf.org>

     Editor:   Tarek Saad
               <mailto:tsaad.net@gmail.com>

     Editor:   Rakesh Gandhi
               <mailto:rgandhi@cisco.com>

     Editor:   Vishnu Pavan Beeram
               <mailto:vbeeram@juniper.net>

     Editor:   Xufeng Liu
               <mailto:xufeng.liu.ietf@gmail.com>

     Editor:   Igor Bryskin
               <mailto:i_bryskin@yahoo.com>";
  description
    "This YANG module contains a collection of generally useful
     YANG data type definitions specific to TE.  The model fully
     conforms to the Network Management Datastore Architecture
     (NMDA).

     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 (RFC 2119) (RFC 8174) when, and only when,
     they appear in all capitals, as shown here.

     Copyright (c) 2023 IETF Trust and the persons identified as
     authors of the code.  All rights reserved.

     Redistribution and use in source and binary forms, with or
     without modification, is permitted pursuant to, and subject to
     the license terms contained in, the Revised BSD License set
     forth in Section 4.c of the IETF Trust's Legal Provisions
     Relating to IETF Documents
     (https://trustee.ietf.org/license-info).

     This version of this YANG module is part of RFC XXXX
     (https://www.rfc-editor.org/info/rfcXXXX); see the RFC itself
     for full legal notices.";

  revision 2023-06-27 {
    description
      "Added:
      - base identity lsp-provisioning-error-reason;
      - identity association-type-diversity;
      - identity tunnel-admin-state-auto;
      - identity lsp-restoration-restore-none;
      - base identity path-computation-error-reason and
        its derived identities;
      - base identity protocol-origin-type and
        its derived identities;
      - base identity svec-objective-function-type and its derived
        identities;
      - base identity svec-metric-type and its derived identities;
      - grouping encoding-and-switching-type.
      
      Updated:
      - description of the base identity objective-function-type;
      - description and reference of identity action-exercise.
      
      Obsoleted:
      - identity of-minimize-agg-bandwidth-consumption
      - identity of-minimize-load-most-loaded-link
      - identity of-minimize-cost-path-set";
    reference
      "RFC XXXX: Updated Common YANG Data Types for Traffic
      Engineering";
  }
  // RFC Editor: replace XXXX with actual RFC number, update date
  // information and remove this note

  revision 2020-06-10 {
    description
      "Latest revision of TE types.";
    reference
      "RFC 8776: Common YANG Data Types for Traffic Engineering";
  }

  /**
   * Typedefs
   */

  typedef admin-group {
    type yang:hex-string {
      /* 01:02:03:04 */
      length "1..11";
    }
    description
      "Administrative group / resource class / color representation
       in 'hex-string' type.
       The most significant byte in the hex-string is the farthest
       to the left in the byte sequence.  Leading zero bytes in the
       configured value may be omitted for brevity.";
    reference
      "RFC 3630: Traffic Engineering (TE) Extensions to OSPF
       Version 2
       RFC 5305: IS-IS Extensions for Traffic Engineering
       RFC 7308: Extended Administrative Groups in MPLS Traffic
       Engineering (MPLS-TE)";
  }

  typedef admin-groups {
    type union {
      type admin-group;
      type extended-admin-group;
    }
    description
      "Derived types for TE administrative groups.";
  }

  typedef extended-admin-group {
    type yang:hex-string;
    description
      "Extended administrative group / resource class / color
       representation in 'hex-string' type.
       The most significant byte in the hex-string is the farthest
       to the left in the byte sequence.  Leading zero bytes in the
       configured value may be omitted for brevity.";
    reference
      "RFC 7308: Extended Administrative Groups in MPLS Traffic
       Engineering (MPLS-TE)";
  }

  typedef path-attribute-flags {
    type union {
      type identityref {
        base session-attributes-flags;
      }
      type identityref {
        base lsp-attributes-flags;
      }
    }
    description
      "Path attributes flags type.";
  }

  typedef performance-metrics-normality {
    type enumeration {
      enum unknown {
        value 0;
        description
          "Unknown.";
      }
      enum normal {
        value 1;
        description
          "Normal.  Indicates that the anomalous bit is not set.";
      }
      enum abnormal {
        value 2;
        description
          "Abnormal.  Indicates that the anomalous bit is set.";
      }
    }
    description
      "Indicates whether a performance metric is normal (anomalous
       bit not set), abnormal (anomalous bit set), or unknown.";
    reference
      "RFC 7471: OSPF Traffic Engineering (TE) Metric Extensions
       RFC 7823: Performance-Based Path Selection for Explicitly
       Routed Label Switched Paths (LSPs) Using TE Metric
       Extensions
       RFC 8570: IS-IS Traffic Engineering (TE) Metric Extensions";
  }

  typedef srlg {
    type uint32;
    description
      "SRLG type.";
    reference
      "RFC 4203: OSPF Extensions in Support of Generalized
       Multi-Protocol Label Switching (GMPLS)
       RFC 5307: IS-IS Extensions in Support of Generalized
       Multi-Protocol Label Switching (GMPLS)";
  }

  typedef te-common-status {
    type enumeration {
      enum up {
        description
          "Enabled.";
      }
      enum down {
        description
          "Disabled.";
      }
      enum testing {
        description
          "In some test mode.";
      }
      enum preparing-maintenance {
        description
          "The resource is disabled in the control plane to prepare
           for a graceful shutdown for maintenance purposes.";
        reference
          "RFC 5817: Graceful Shutdown in MPLS and Generalized MPLS
           Traffic Engineering Networks";
      }
      enum maintenance {
        description
          "The resource is disabled in the data plane for maintenance
           purposes.";
      }
      enum unknown {
        description
          "Status is unknown.";
      }
    }
    description
      "Defines a type representing the common states of a TE
       resource.";
  }

  typedef te-bandwidth {
    type string {
      pattern '0[xX](0((\.0?)?[pP](\+)?0?|(\.0?))|'
            + '1(\.([\da-fA-F]{0,5}[02468aAcCeE]?)?)?'
            + '[pP](\+)?(12[0-7]|'
            + '1[01]\d|0?\d?\d)?)|0[xX][\da-fA-F]{1,8}|\d+'
            + '(,(0[xX](0((\.0?)?[pP](\+)?0?|(\.0?))|'
            + '1(\.([\da-fA-F]{0,5}[02468aAcCeE]?)?)?'
            + '[pP](\+)?(12[0-7]|'
            + '1[01]\d|0?\d?\d)?)|0[xX][\da-fA-F]{1,8}|\d+))*';
    }
    description
      "This is the generic bandwidth type.  It is a string containing
       a list of numbers separated by commas, where each of these
       numbers can be non-negative decimal, hex integer, or
       hex float:

       (dec | hex | float)[*(','(dec | hex | float))]

       For the packet-switching type, the string encoding follows
       the type 'bandwidth-ieee-float32' as defined in RFC 8294
       (e.g., 0x1p10), where the units are in bytes per second.

       For the Optical Transport Network (OTN) switching type,
       a list of integers can be used, such as '0,2,3,1', indicating
       two ODU0s and one ODU3.  ('ODU' stands for 'Optical Data
       Unit'.)  For Dense Wavelength Division Multiplexing (DWDM),
       a list of pairs of slot numbers and widths can be used,
       such as '0,2,3,3', indicating a frequency slot 0 with
       slot width 2 and a frequency slot 3 with slot width 3.
       Canonically, the string is represented as all lowercase and in
       hex, where the prefix '0x' precedes the hex number.";
    reference
      "RFC 8294: Common YANG Data Types for the Routing Area
       ITU-T Recommendation G.709: Interfaces for the
       optical transport network";
  }

  typedef te-ds-class {
    type uint8 {
      range "0..7";
    }
    description
      "The Differentiated Services Class-Type of traffic.";
    reference
      "RFC 4124: Protocol Extensions for Support of Diffserv-aware
       MPLS Traffic Engineering, Section 4.3.1";
  }

  typedef te-global-id {
    type uint32;
    description
      "An identifier to uniquely identify an operator, which can be
       either a provider or a client.
       The definition of this type is taken from RFCs 6370 and 5003.
       This attribute type is used solely to provide a globally
       unique context for TE topologies.";
    reference
      "RFC 5003: Attachment Individual Identifier (AII) Types for
       Aggregation
       RFC 6370: MPLS Transport Profile (MPLS-TP) Identifiers";
  }

  typedef te-hop-type {
    type enumeration {
      enum loose {
        description
          "A loose hop in an explicit path.";
      }
      enum strict {
        description
          "A strict hop in an explicit path.";
      }
    }
    description
      "Enumerated type for specifying loose or strict paths.";
    reference
      "RFC 3209: RSVP-TE: Extensions to RSVP for LSP Tunnels,
       Section 4.3.3";
  }

  typedef te-link-access-type {
    type enumeration {
      enum point-to-point {
        description
          "The link is point-to-point.";
      }
      enum multi-access {
        description
          "The link is multi-access, including broadcast and NBMA.";
      }
    }
    description
      "Defines a type representing the access type of a TE link.";
    reference
      "RFC 3630: Traffic Engineering (TE) Extensions to OSPF
       Version 2";
  }

  typedef te-label-direction {
    type enumeration {
      enum forward {
        description
          "Label allocated for the forward LSP direction.";
      }
      enum reverse {
        description
          "Label allocated for the reverse LSP direction.";
      }
    }
    description
      "Enumerated type for specifying the forward or reverse
       label.";
  }

  typedef te-link-direction {
    type enumeration {
      enum incoming {
        description
          "The explicit route represents an incoming link on
           a node.";
      }
      enum outgoing {
        description
          "The explicit route represents an outgoing link on
           a node.";
      }
    }
    description
      "Enumerated type for specifying the direction of a link on
       a node.";
  }

  typedef te-metric {
    type uint32;
    description
      "TE metric.";
    reference
      "RFC 3785: Use of Interior Gateway Protocol (IGP) Metric as a
       second MPLS Traffic Engineering (TE) Metric";
  }

  typedef te-node-id {
    type yang:dotted-quad;
    description
      "A type representing the identifier for a node in a TE
       topology.
       The identifier is represented as 4 octets in dotted-quad
       notation.
       This attribute MAY be mapped to the Router Address TLV
       described in Section 2.4.1 of RFC 3630, the TE Router ID
       described in Section 3 of RFC 6827, the Traffic Engineering
       Router ID TLV described in Section 4.3 of RFC 5305, or the
       TE Router ID TLV described in Section 3.2.1 of RFC 6119.
       The reachability of such a TE node MAY be achieved by a
       mechanism such as that described in Section 6.2 of RFC 6827.";
    reference
      "RFC 3630: Traffic Engineering (TE) Extensions to OSPF
       Version 2, Section 2.4.1
       RFC 5305: IS-IS Extensions for Traffic Engineering,
       Section 4.3
       RFC 6119: IPv6 Traffic Engineering in IS-IS, Section 3.2.1
       RFC 6827: Automatically Switched Optical Network (ASON)
       Routing for OSPFv2 Protocols, Section 3";
  }

  typedef te-oper-status {
    type te-common-status;
    description
      "Defines a type representing the operational status of
       a TE resource.";
  }

  typedef te-admin-status {
    type te-common-status;
    description
      "Defines a type representing the administrative status of
       a TE resource.";
  }

  typedef te-path-disjointness {
    type bits {
      bit node {
        position 0;
        description
          "Node disjoint.";
      }
      bit link {
        position 1;
        description
          "Link disjoint.";
      }
      bit srlg {
        position 2;
        description
          "SRLG (Shared Risk Link Group) disjoint.";
      }
    }
    description
      "Type of the resource disjointness for a TE tunnel path.";
    reference
      "RFC 4872: RSVP-TE Extensions in Support of End-to-End
       Generalized Multi-Protocol Label Switching (GMPLS) Recovery";
  }

  typedef te-recovery-status {
    type enumeration {
      enum normal {
        description
          "Both the recovery span and the working span are fully
           allocated and active, data traffic is being
           transported over (or selected from) the working
           span, and no trigger events are reported.";
      }
      enum recovery-started {
        description
          "The recovery action has been started but not completed.";
      }
      enum recovery-succeeded {
        description
          "The recovery action has succeeded.  The working span has
           reported a failure/degrade condition, and the user traffic
           is being transported (or selected) on the recovery span.";
      }
      enum recovery-failed {
        description
          "The recovery action has failed.";
      }
      enum reversion-started {
        description
          "The reversion has started.";
      }
      enum reversion-succeeded {
        description
          "The reversion action has succeeded.";
      }
      enum reversion-failed {
        description
          "The reversion has failed.";
      }
      enum recovery-unavailable {
        description
          "The recovery is unavailable, as a result of either an
           operator's lockout command or a failure condition
           detected on the recovery span.";
      }
      enum recovery-admin {
        description
          "The operator has issued a command to switch the user
           traffic to the recovery span.";
      }
      enum wait-to-restore {
        description
          "The recovery domain is recovering from a failure/degrade
           condition on the working span that is being controlled by
           the Wait-to-Restore (WTR) timer.";
      }
    }
    description
      "Defines the status of a recovery action.";
    reference
      "RFC 4427: Recovery (Protection and Restoration) Terminology
       for Generalized Multi-Protocol Label Switching (GMPLS)
       RFC 6378: MPLS Transport Profile (MPLS-TP) Linear Protection";
  }

  typedef te-template-name {
    type string {
      pattern '/?([a-zA-Z0-9\-_.]+)(/[a-zA-Z0-9\-_.]+)*';
    }
    description
      "A type for the name of a TE node template or TE link
       template.";
  }

  typedef te-topology-event-type {
    type enumeration {
      enum add {
        value 0;
        description
          "A TE node or TE link has been added.";
      }
      enum remove {
        value 1;
        description
          "A TE node or TE link has been removed.";
      }
      enum update {
        value 2;
        description
          "A TE node or TE link has been updated.";
      }
    }
    description
      "TE event type for notifications.";
  }

  typedef te-topology-id {
    type union {
      type string {
        length "0";
        // empty string
      }
      type string {
        pattern '([a-zA-Z0-9\-_.]+:)*'
              + '/?([a-zA-Z0-9\-_.]+)(/[a-zA-Z0-9\-_.]+)*';
      }
    }
    description
      "An identifier for a topology.
       It is optional to have one or more prefixes at the beginning,
       separated by colons.  The prefixes can be 'network-types' as
       defined in the 'ietf-network' module in RFC 8345, to help the
       user better understand the topology before further inquiry
       is made.";
    reference
      "RFC 8345: A YANG Data Model for Network Topologies";
  }

  typedef te-tp-id {
    type union {
      type uint32;
      // Unnumbered
      type inet:ip-address;
      // IPv4 or IPv6 address
    }
    description
      "An identifier for a TE link endpoint on a node.
       This attribute is mapped to a local or remote link identifier
       as defined in RFCs 3630 and 5305.";
    reference
      "RFC 3630: Traffic Engineering (TE) Extensions to OSPF
       Version 2
       RFC 5305: IS-IS Extensions for Traffic Engineering";
  }

  // CHANGE NOTE: The typedef path-type below has been
  // added in this module revision
  // RFC Editor: remove the note above and this note
  typedef path-type {
    type enumeration {
      enum primary-path {
        description
          "Indicates that the TE path is a primary path.";
      }
      enum secondary-path {
        description
          "Indicates that the TE path is a secondary path.";
      }
      enum primary-reverse-path {
        description
          "Indicates that the TE path is a primary reverse path.";
      }
      enum secondary-reverse-path {
        description
          "Indicates that the TE path is a secondary reverse path.";
      }
    }
    description
      "The type of TE path, indicating whether a path is a primary, 
      or a reverse primary, or a secondary, or a reverse secondary 
      path.";
  }

  /* TE features */

  feature p2mp-te {
    description
      "Indicates support for Point-to-Multipoint TE (P2MP-TE).";
    reference
      "RFC 4875: Extensions to Resource Reservation Protocol -
       Traffic Engineering (RSVP-TE) for Point-to-Multipoint TE
       Label Switched Paths (LSPs)";
  }

  feature frr-te {
    description
      "Indicates support for TE Fast Reroute (FRR).";
    reference
      "RFC 4090: Fast Reroute Extensions to RSVP-TE for LSP Tunnels";
  }

  feature extended-admin-groups {
    description
      "Indicates support for TE link extended administrative
       groups.";
    reference
      "RFC 7308: Extended Administrative Groups in MPLS Traffic
       Engineering (MPLS-TE)";
  }

  feature named-path-affinities {
    description
      "Indicates support for named path affinities.";
  }

  feature named-extended-admin-groups {
    description
      "Indicates support for named extended administrative groups.";
  }

  feature named-srlg-groups {
    description
      "Indicates support for named SRLG groups.";
  }

  feature named-path-constraints {
    description
      "Indicates support for named path constraints.";
  }

  feature path-optimization-metric {
    description
      "Indicates support for path optimization metrics.";
  }

  feature path-optimization-objective-function {
    description
      "Indicates support for path optimization objective functions.";
  }

  /*
   * Identities
   */

  // CHANGE NOTE: The base identity lsp-provisioning-error-reason 
  // has been added in this module revision
  // RFC Editor: remove the note above and this note
  identity lsp-provisioning-error-reason {
    description
      "Base identity for LSP provisioning errors.";
  }

  identity session-attributes-flags {
    description
      "Base identity for the RSVP-TE session attributes flags.";
  }

  identity local-protection-desired {
    base session-attributes-flags;
    description
      "Local protection is desired.";
    reference
      "RFC 3209: RSVP-TE: Extensions to RSVP for LSP Tunnels,
       Section 4.7.1";
  }

  identity se-style-desired {
    base session-attributes-flags;
    description
      "Shared explicit style, to allow the LSP to be established
       and share resources with the old LSP.";
    reference
      "RFC 3209: RSVP-TE: Extensions to RSVP for LSP Tunnels";
  }

  identity local-recording-desired {
    base session-attributes-flags;
    description
      "Label recording is desired.";
    reference
      "RFC 3209: RSVP-TE: Extensions to RSVP for LSP Tunnels,
       Section 4.7.1";
  }

  identity bandwidth-protection-desired {
    base session-attributes-flags;
    description
      "Requests FRR bandwidth protection on LSRs, if present.";
    reference
      "RFC 4090: Fast Reroute Extensions to RSVP-TE for LSP Tunnels";
  }

  identity node-protection-desired {
    base session-attributes-flags;
    description
      "Requests FRR node protection on LSRs, if present.";
    reference
      "RFC 4090: Fast Reroute Extensions to RSVP-TE for LSP Tunnels";
  }

  identity path-reevaluation-request {
    base session-attributes-flags;
    description
      "This flag indicates that a path re-evaluation (of the
       current path in use) is requested.  Note that this does
       not trigger any LSP reroutes but instead just signals a
       request to evaluate whether a preferable path exists.";
    reference
      "RFC 4736: Reoptimization of Multiprotocol Label Switching
       (MPLS) Traffic Engineering (TE) Loosely Routed Label Switched
       Path (LSP)";
  }

  identity soft-preemption-desired {
    base session-attributes-flags;
    description
      "Soft preemption of LSP resources is desired.";
    reference
      "RFC 5712: MPLS Traffic Engineering Soft Preemption";
  }

  identity lsp-attributes-flags {
    description
      "Base identity for LSP attributes flags.";
  }

  identity end-to-end-rerouting-desired {
    base lsp-attributes-flags;
    description
      "Indicates end-to-end rerouting behavior for an LSP
       undergoing establishment.  This MAY also be used to
       specify the behavior of end-to-end LSP recovery for
       established LSPs.";
    reference
      "RFC 4920: Crankback Signaling Extensions for MPLS and GMPLS
       RSVP-TE
       RFC 5420: Encoding of Attributes for MPLS LSP Establishment
       Using Resource Reservation Protocol Traffic Engineering
       (RSVP-TE)
       RFC 7570: Label Switched Path (LSP) Attribute in the Explicit
       Route Object (ERO)";
  }

  identity boundary-rerouting-desired {
    base lsp-attributes-flags;
    description
      "Indicates boundary rerouting behavior for an LSP undergoing
       establishment.  This MAY also be used to specify
       segment-based LSP recovery through nested crankback for
       established LSPs.  The boundary Area Border Router (ABR) /
       Autonomous System Border Router (ASBR) can decide to forward
       the PathErr message upstream to either an upstream boundary
       ABR/ASBR or the ingress LSR.  Alternatively, it can try to
       select another egress boundary LSR.";
    reference
      "RFC 4920: Crankback Signaling Extensions for MPLS and GMPLS
       RSVP-TE
       RFC 5420: Encoding of Attributes for MPLS LSP Establishment
       Using Resource Reservation Protocol Traffic Engineering
       (RSVP-TE)
       RFC 7570: Label Switched Path (LSP) Attribute in the Explicit
       Route Object (ERO)";
  }

  identity segment-based-rerouting-desired {
    base lsp-attributes-flags;
    description
      "Indicates segment-based rerouting behavior for an LSP
       undergoing establishment.  This MAY also be used to specify
       segment-based LSP recovery for established LSPs.";
    reference
      "RFC 4920: Crankback Signaling Extensions for MPLS and GMPLS
       RSVP-TE
       RFC 5420: Encoding of Attributes for MPLS LSP Establishment
       Using Resource Reservation Protocol Traffic Engineering
       (RSVP-TE)
       RFC 7570: Label Switched Path (LSP) Attribute in the Explicit
       Route Object (ERO)";
  }

  identity lsp-integrity-required {
    base lsp-attributes-flags;
    description
      "Indicates that LSP integrity is required.";
    reference
      "RFC 4875: Extensions to Resource Reservation Protocol -
       Traffic Engineering (RSVP-TE) for Point-to-Multipoint TE
       Label Switched Paths (LSPs)
       RFC 7570: Label Switched Path (LSP) Attribute in the Explicit
       Route Object (ERO)";
  }

  identity contiguous-lsp-desired {
    base lsp-attributes-flags;
    description
      "Indicates that a contiguous LSP is desired.";
    reference
      "RFC 5151: Inter-Domain MPLS and GMPLS Traffic Engineering --
       Resource Reservation Protocol-Traffic Engineering (RSVP-TE)
       Extensions
       RFC 7570: Label Switched Path (LSP) Attribute in the Explicit
       Route Object (ERO)";
  }

  identity lsp-stitching-desired {
    base lsp-attributes-flags;
    description
      "Indicates that LSP stitching is desired.";
    reference
      "RFC 5150: Label Switched Path Stitching with Generalized
       Multiprotocol Label Switching Traffic Engineering (GMPLS TE)
       RFC 7570: Label Switched Path (LSP) Attribute in the Explicit
       Route Object (ERO)";
  }

  identity pre-planned-lsp-flag {
    base lsp-attributes-flags;
    description
      "Indicates that the LSP MUST be provisioned in the
       control plane only.";
    reference
      "RFC 6001: Generalized MPLS (GMPLS) Protocol Extensions for
       Multi-Layer and Multi-Region Networks (MLN/MRN)
       RFC 7570: Label Switched Path (LSP) Attribute in the Explicit
       Route Object (ERO)";
  }

  identity non-php-behavior-flag {
    base lsp-attributes-flags;
    description
      "Indicates that non-PHP (non-Penultimate Hop Popping) behavior
       for the LSP is desired.";
    reference
      "RFC 6511: Non-Penultimate Hop Popping Behavior and Out-of-Band
       Mapping for RSVP-TE Label Switched Paths
       RFC 7570: Label Switched Path (LSP) Attribute in the Explicit
       Route Object (ERO)";
  }

  identity oob-mapping-flag {
    base lsp-attributes-flags;
    description
      "Indicates that signaling of the egress binding information is
       out of band (e.g., via the Border Gateway Protocol (BGP)).";
    reference
      "RFC 6511: Non-Penultimate Hop Popping Behavior and Out-of-Band
       Mapping for RSVP-TE Label Switched Paths
       RFC 7570: Label Switched Path (LSP) Attribute in the Explicit
       Route Object (ERO)";
  }

  identity entropy-label-capability {
    base lsp-attributes-flags;
    description
      "Indicates entropy label capability.";
    reference
      "RFC 6790: The Use of Entropy Labels in MPLS Forwarding
       RFC 7570: Label Switched Path (LSP) Attribute in the Explicit
       Route Object (ERO)";
  }

  identity oam-mep-entity-desired {
    base lsp-attributes-flags;
    description
      "OAM Maintenance Entity Group End Point (MEP) entities
       desired.";
    reference
      "RFC 7260: GMPLS RSVP-TE Extensions for Operations,
       Administration, and Maintenance (OAM) Configuration";
  }

  identity oam-mip-entity-desired {
    base lsp-attributes-flags;
    description
      "OAM Maintenance Entity Group Intermediate Points (MIP)
       entities desired.";
    reference
      "RFC 7260: GMPLS RSVP-TE Extensions for Operations,
       Administration, and Maintenance (OAM) Configuration";
  }

  identity srlg-collection-desired {
    base lsp-attributes-flags;
    description
      "SRLG collection desired.";
    reference
      "RFC 7570: Label Switched Path (LSP) Attribute in the Explicit
       Route Object (ERO)
       RFC 8001: RSVP-TE Extensions for Collecting Shared Risk
       Link Group (SRLG) Information";
  }

  identity loopback-desired {
    base lsp-attributes-flags;
    description
      "This flag indicates that a particular node on the LSP is
       required to enter loopback mode.  This can also be
       used to specify the loopback state of the node.";
    reference
      "RFC 7571: GMPLS RSVP-TE Extensions for Lock Instruct and
       Loopback";
  }

  identity p2mp-te-tree-eval-request {
    base lsp-attributes-flags;
    description
      "P2MP-TE tree re-evaluation request.";
    reference
      "RFC 8149: RSVP Extensions for Reoptimization of Loosely Routed
       Point-to-Multipoint Traffic Engineering Label Switched Paths
       (LSPs)";
  }

  identity rtm-set-desired {
    base lsp-attributes-flags;
    description
      "Residence Time Measurement (RTM) attribute flag requested.";
    reference
      "RFC 8169: Residence Time Measurement in MPLS Networks";
  }

  identity link-protection-type {
    description
      "Base identity for the link protection type.";
  }

  identity link-protection-unprotected {
    base link-protection-type;
    description
      "Unprotected link type.";
    reference
      "RFC 4872: RSVP-TE Extensions in Support of End-to-End
       Generalized Multi-Protocol Label Switching (GMPLS) Recovery";
  }

  identity link-protection-extra-traffic {
    base link-protection-type;
    description
      "Extra-Traffic protected link type.";
    reference
      "RFC 4427: Recovery (Protection and Restoration) Terminology
       for Generalized Multi-Protocol Label Switching (GMPLS)";
  }

  identity link-protection-shared {
    base link-protection-type;
    description
      "Shared protected link type.";
    reference
      "RFC 4872: RSVP-TE Extensions in Support of End-to-End
       Generalized Multi-Protocol Label Switching (GMPLS) Recovery";
  }

  identity link-protection-1-for-1 {
    base link-protection-type;
    description
      "One-for-one (1:1) protected link type.";
    reference
      "RFC 4872: RSVP-TE Extensions in Support of End-to-End
       Generalized Multi-Protocol Label Switching (GMPLS) Recovery";
  }

  identity link-protection-1-plus-1 {
    base link-protection-type;
    description
      "One-plus-one (1+1) protected link type.";
    reference
      "RFC 4872: RSVP-TE Extensions in Support of End-to-End
       Generalized Multi-Protocol Label Switching (GMPLS) Recovery";
  }

  identity link-protection-enhanced {
    base link-protection-type;
    description
      "A compound link protection type derived from the underlay
       TE tunnel protection configuration supporting the TE link.";
  }

  identity association-type {
    description
      "Base identity for the tunnel association.";
  }

  identity association-type-recovery {
    base association-type;
    description
      "Association type for recovery, used to associate LSPs of the
       same tunnel for recovery.";
    reference
      "RFC 4872: RSVP-TE Extensions in Support of End-to-End
       Generalized Multi-Protocol Label Switching (GMPLS) Recovery
       RFC 6780: RSVP ASSOCIATION Object Extensions";
  }

  identity association-type-resource-sharing {
    base association-type;
    description
      "Association type for resource sharing, used to enable
       resource sharing during make-before-break.";
    reference
      "RFC 4873: GMPLS Segment Recovery
       RFC 6780: RSVP ASSOCIATION Object Extensions";
  }

  identity association-type-double-sided-bidir {
    base association-type;
    description
      "Association type for double-sided bidirectional LSPs,
       used to associate two LSPs of two tunnels that are
       independently configured on either endpoint.";
    reference
      "RFC 7551: RSVP-TE Extensions for Associated Bidirectional
       Label Switched Paths (LSPs)";
  }

  identity association-type-single-sided-bidir {
    base association-type;
    description
      "Association type for single-sided bidirectional LSPs,
       used to associate two LSPs of two tunnels, where one
       tunnel is configured on one side/endpoint and the other
       tunnel is dynamically created on the other endpoint.";
    reference
      "RFC 6780: RSVP ASSOCIATION Object Extensions
       RFC 7551: RSVP-TE Extensions for Associated Bidirectional
       Label Switched Paths (LSPs)";
  }

  // CHANGE NOTE: The identity association-type-diversity below has 
  // been added in this module revision
  // RFC Editor: remove the note above and this note
  identity association-type-diversity {
    base association-type;
    description
      "Association Type diversity used to associate LSPs whose 
      paths are to be diverse from each other.";
    reference
      "RFC8800: Path Computation Element Communication Protocol 
      (PCEP) Extension for Label Switched Path (LSP) Diversity 
      Constraint Signaling";
  }

  // CHANGE NOTE: The description of the base identity 
  // objective-function-type has been updated 
  // in this module revision
  // RFC Editor: remove the note above and this note
  identity objective-function-type {
    description
      "Base identity for path objective function type.";
  }

  identity of-minimize-cost-path {
    base objective-function-type;
    description
      "Objective function for minimizing path cost.";
    reference
      "RFC 5541: Encoding of Objective Functions in the Path
       Computation Element Communication Protocol (PCEP)";
  }

  identity of-minimize-load-path {
    base objective-function-type;
    description
      "Objective function for minimizing the load on one or more
       paths.";
    reference
      "RFC 5541: Encoding of Objective Functions in the Path
       Computation Element Communication Protocol (PCEP)";
  }

  identity of-maximize-residual-bandwidth {
    base objective-function-type;
    description
      "Objective function for maximizing residual bandwidth.";
    reference
      "RFC 5541: Encoding of Objective Functions in the Path
       Computation Element Communication Protocol (PCEP)";
  }

  // CHANGE NOTE: The identity of-minimize-agg-bandwidth-consumption
  // below has been obsoleted in this module revision
  // RFC Editor: remove the note above and this note
  identity of-minimize-agg-bandwidth-consumption {
    base objective-function-type;
    status obsolete;
    description
      "Objective function for minimizing aggregate bandwidth
      consumption.";
    reference
      "RFC 5541: Encoding of Objective Functions in the Path
      Computation Element Communication Protocol (PCEP)";
  }

  // CHANGE NOTE: The identity of-minimize-load-most-loaded-link
  // below has been obsoleted in this module revision
  // RFC Editor: remove the note above and this note
  identity of-minimize-load-most-loaded-link {
    base objective-function-type;
    status obsolete;
    description
      "Objective function for minimizing the load on the link that
      is carrying the highest load.";
    reference
      "RFC 5541: Encoding of Objective Functions in the Path
      Computation Element Communication Protocol (PCEP)";
  }

  // CHANGE NOTE: The identity of-minimize-cost-path-set
  // below has been obsoleted in this module revision
  // RFC Editor: remove the note above and this note
  identity of-minimize-cost-path-set {
    base objective-function-type;
    status obsolete;
    description
      "Objective function for minimizing the cost on a path set.";
    reference
      "RFC 5541: Encoding of Objective Functions in the Path
       Computation Element Communication Protocol (PCEP)";
  }

  identity path-computation-method {
    description
      "Base identity for supported path computation mechanisms.";
  }

  identity path-locally-computed {
    base path-computation-method;
    description
      "Indicates a constrained-path LSP in which the
       path is computed by the local LER.";
    reference
      "RFC 3272: Overview and Principles of Internet Traffic
       Engineering, Section 5.4";
  }

  identity path-externally-queried {
    base path-computation-method;
    description
      "Constrained-path LSP in which the path is obtained by
       querying an external source, such as a PCE server.
       In the case that an LSP is defined to be externally queried,
       it may also have associated explicit definitions (provided
       to the external source to aid computation).  The path that is
       returned by the external source may require further local
       computation on the device.";
    reference
      "RFC 3272: Overview and Principles of Internet Traffic
       Engineering
       RFC 4657: Path Computation Element (PCE) Communication
       Protocol Generic Requirements";
  }

  identity path-explicitly-defined {
    base path-computation-method;
    description
      "Constrained-path LSP in which the path is
       explicitly specified as a collection of strict and/or loose
       hops.";
    reference
      "RFC 3209: RSVP-TE: Extensions to RSVP for LSP Tunnels
       RFC 3272: Overview and Principles of Internet Traffic
       Engineering";
  }

  identity lsp-metric-type {
    description
      "Base identity for the LSP metric specification types.";
  }

  identity lsp-metric-relative {
    base lsp-metric-type;
    description
      "The metric specified for the LSPs to which this identity
       refers is specified as a value relative to the IGP metric
       cost to the LSP's tail end.";
    reference
      "RFC 4657: Path Computation Element (PCE) Communication
       Protocol Generic Requirements";
  }

  identity lsp-metric-absolute {
    base lsp-metric-type;
    description
      "The metric specified for the LSPs to which this identity
       refers is specified as an absolute value.";
    reference
      "RFC 4657: Path Computation Element (PCE) Communication
       Protocol Generic Requirements";
  }

  identity lsp-metric-inherited {
    base lsp-metric-type;
    description
      "The metric for the LSPs to which this identity refers is
       not specified explicitly; rather, it is directly inherited
       from the IGP cost.";
    reference
      "RFC 4657: Path Computation Element (PCE) Communication
       Protocol Generic Requirements";
  }

  identity te-tunnel-type {
    description
      "Base identity from which specific tunnel types are derived.";
  }

  identity te-tunnel-p2p {
    base te-tunnel-type;
    description
      "TE Point-to-Point (P2P) tunnel type.";
    reference
      "RFC 3209: RSVP-TE: Extensions to RSVP for LSP Tunnels";
  }

  identity te-tunnel-p2mp {
    base te-tunnel-type;
    description
      "TE P2MP tunnel type.";
    reference
      "RFC 4875: Extensions to Resource Reservation Protocol -
       Traffic Engineering (RSVP-TE) for Point-to-Multipoint TE
       Label Switched Paths (LSPs)";
  }

  identity tunnel-action-type {
    description
      "Base identity from which specific tunnel action types
       are derived.";
  }

  identity tunnel-action-resetup {
    base tunnel-action-type;
    description
      "TE tunnel action that tears down the tunnel's current LSP
       (if any) and attempts to re-establish a new LSP.";
  }

  identity tunnel-action-reoptimize {
    base tunnel-action-type;
    description
      "TE tunnel action that reoptimizes the placement of the
       tunnel LSP(s).";
  }

  identity tunnel-action-switchpath {
    base tunnel-action-type;
    description
      "TE tunnel action that switches the tunnel's LSP to use the
       specified path.";
  }

  identity te-action-result {
    description
      "Base identity from which specific TE action results
       are derived.";
  }

  identity te-action-success {
    base te-action-result;
    description
      "TE action was successful.";
  }

  identity te-action-fail {
    base te-action-result;
    description
      "TE action failed.";
  }

  identity tunnel-action-inprogress {
    base te-action-result;
    description
      "TE action is in progress.";
  }

  identity tunnel-admin-state-type {
    description
      "Base identity for TE tunnel administrative states.";
  }

  identity tunnel-admin-state-up {
    base tunnel-admin-state-type;
    description
      "Tunnel's administrative state is up.";
  }

  identity tunnel-admin-state-down {
    base tunnel-admin-state-type;
    description
      "Tunnel's administrative state is down.";
  }

  // CHANGE NOTE: The identity tunnel-admin-state-auto below
  // has been added in this module revision
  // RFC Editor: remove the note above and this note
  identity tunnel-admin-state-auto {
    base tunnel-admin-state-type;
    description
      "Tunnel administrative auto state. The administrative status
      in state datastore transitions to 'tunnel-admin-up' when the
      tunnel used by the client layer, and to 'tunnel-admin-down'
      when it is not used by the client layer.";
  }

  identity tunnel-state-type {
    description
      "Base identity for TE tunnel states.";
  }

  identity tunnel-state-up {
    base tunnel-state-type;
    description
      "Tunnel's state is up.";
  }

  identity tunnel-state-down {
    base tunnel-state-type;
    description
      "Tunnel's state is down.";
  }

  identity lsp-state-type {
    description
      "Base identity for TE LSP states.";
  }

  identity lsp-path-computing {
    base lsp-state-type;
    description
      "State path computation is in progress.";
  }

  identity lsp-path-computation-ok {
    base lsp-state-type;
    description
      "State path computation was successful.";
  }

  identity lsp-path-computation-failed {
    base lsp-state-type;
    description
      "State path computation failed.";
  }

  identity lsp-state-setting-up {
    base lsp-state-type;
    description
      "State is being set up.";
  }

  identity lsp-state-setup-ok {
    base lsp-state-type;
    description
      "State setup was successful.";
  }

  identity lsp-state-setup-failed {
    base lsp-state-type;
    description
      "State setup failed.";
  }

  identity lsp-state-up {
    base lsp-state-type;
    description
      "State is up.";
  }

  identity lsp-state-tearing-down {
    base lsp-state-type;
    description
      "State is being torn down.";
  }

  identity lsp-state-down {
    base lsp-state-type;
    description
      "State is down.";
  }

  identity path-invalidation-action-type {
    description
      "Base identity for TE path invalidation action types.";
  }

  identity path-invalidation-action-drop {
    base path-invalidation-action-type;
    description
      "Upon invalidation of the TE tunnel path, the tunnel remains
       valid, but any packet mapped over the tunnel is dropped.";
    reference
      "RFC 3209: RSVP-TE: Extensions to RSVP for LSP Tunnels,
       Section 2.5";
  }

  identity path-invalidation-action-teardown {
    base path-invalidation-action-type;
    description
      "TE path invalidation action teardown.";
    reference
      "RFC 3209: RSVP-TE: Extensions to RSVP for LSP Tunnels,
       Section 2.5";
  }

  identity lsp-restoration-type {
    description
      "Base identity from which LSP restoration types are derived.";
  }

    // CHANGE NOTE: The identity lsp-restoration-restore-none 
    // below has been added in this module revision
    // RFC Editor: remove the note above and this note
    identity lsp-restoration-restore-none {
      base lsp-restoration-type;
      description
        "No LSP affected by a failure is restored.";
    }

  identity lsp-restoration-restore-any {
    base lsp-restoration-type;
    description
      "Any LSP affected by a failure is restored.";
  }

  identity lsp-restoration-restore-all {
    base lsp-restoration-type;
    description
      "Affected LSPs are restored after all LSPs of the tunnel are
       broken.";
  }

  identity restoration-scheme-type {
    description
      "Base identity for LSP restoration schemes.";
  }

  identity restoration-scheme-preconfigured {
    base restoration-scheme-type;
    description
      "Restoration LSP is preconfigured prior to the failure.";
    reference
      "RFC 4427: Recovery (Protection and Restoration) Terminology
       for Generalized Multi-Protocol Label Switching (GMPLS)";
  }

  identity restoration-scheme-precomputed {
    base restoration-scheme-type;
    description
      "Restoration LSP is precomputed prior to the failure.";
    reference
      "RFC 4427: Recovery (Protection and Restoration) Terminology
       for Generalized Multi-Protocol Label Switching (GMPLS)";
  }

  identity restoration-scheme-presignaled {
    base restoration-scheme-type;
    description
      "Restoration LSP is presignaled prior to the failure.";
    reference
      "RFC 4427: Recovery (Protection and Restoration) Terminology
       for Generalized Multi-Protocol Label Switching (GMPLS)";
  }

  identity lsp-protection-type {
    description
      "Base identity from which LSP protection types are derived.";
    reference
      "RFC 4872: RSVP-TE Extensions in Support of End-to-End
       Generalized Multi-Protocol Label Switching (GMPLS) Recovery";
  }

  identity lsp-protection-unprotected {
    base lsp-protection-type;
    description
      "'Unprotected' LSP protection type.";
    reference
      "RFC 4872: RSVP-TE Extensions in Support of End-to-End
       Generalized Multi-Protocol Label Switching (GMPLS) Recovery";
  }

  identity lsp-protection-reroute-extra {
    base lsp-protection-type;
    description
      "'(Full) Rerouting' LSP protection type.";
    reference
      "RFC 4872: RSVP-TE Extensions in Support of End-to-End
       Generalized Multi-Protocol Label Switching (GMPLS) Recovery";
  }

  identity lsp-protection-reroute {
    base lsp-protection-type;
    description
      "'Rerouting without Extra-Traffic' LSP protection type.";
    reference
      "RFC 4872: RSVP-TE Extensions in Support of End-to-End
       Generalized Multi-Protocol Label Switching (GMPLS) Recovery";
  }

  identity lsp-protection-1-for-n {
    base lsp-protection-type;
    description
      "'1:N Protection with Extra-Traffic' LSP protection type.";
    reference
      "RFC 4872: RSVP-TE Extensions in Support of End-to-End
       Generalized Multi-Protocol Label Switching (GMPLS) Recovery";
  }

  identity lsp-protection-1-for-1 {
    base lsp-protection-type;
    description
      "LSP protection '1:1 Protection Type'.";
    reference
      "RFC 4872: RSVP-TE Extensions in Support of End-to-End
       Generalized Multi-Protocol Label Switching (GMPLS) Recovery";
  }

  identity lsp-protection-unidir-1-plus-1 {
    base lsp-protection-type;
    description
      "'1+1 Unidirectional Protection' LSP protection type.";
    reference
      "RFC 4872: RSVP-TE Extensions in Support of End-to-End
       Generalized Multi-Protocol Label Switching (GMPLS) Recovery";
  }

  identity lsp-protection-bidir-1-plus-1 {
    base lsp-protection-type;
    description
      "'1+1 Bidirectional Protection' LSP protection type.";
    reference
      "RFC 4872: RSVP-TE Extensions in Support of End-to-End
       Generalized Multi-Protocol Label Switching (GMPLS) Recovery";
  }

  identity lsp-protection-extra-traffic {
    base lsp-protection-type;
    description
      "Extra-Traffic LSP protection type.";
    reference
      "RFC 4427: Recovery (Protection and Restoration) Terminology
       for Generalized Multi-Protocol Label Switching (GMPLS)";
  }

  identity lsp-protection-state {
    description
      "Base identity of protection states for reporting purposes.";
  }

  identity normal {
    base lsp-protection-state;
    description
      "Normal state.";
  }

  identity signal-fail-of-protection {
    base lsp-protection-state;
    description
      "The protection transport entity has a signal fail condition
       that is of higher priority than the forced switchover
       command.";
    reference
      "RFC 4427: Recovery (Protection and Restoration) Terminology
       for Generalized Multi-Protocol Label Switching (GMPLS)";
  }

  identity lockout-of-protection {
    base lsp-protection-state;
    description
      "A Loss of Protection (LoP) command is active.";
    reference
      "RFC 4427: Recovery (Protection and Restoration) Terminology
       for Generalized Multi-Protocol Label Switching (GMPLS)";
  }

  identity forced-switch {
    base lsp-protection-state;
    description
      "A forced switchover command is active.";
    reference
      "RFC 4427: Recovery (Protection and Restoration) Terminology
       for Generalized Multi-Protocol Label Switching (GMPLS)";
  }

  identity signal-fail {
    base lsp-protection-state;
    description
      "There is a signal fail condition on either the working path
       or the protection path.";
    reference
      "RFC 4427: Recovery (Protection and Restoration) Terminology
       for Generalized Multi-Protocol Label Switching (GMPLS)";
  }

  identity signal-degrade {
    base lsp-protection-state;
    description
      "There is a signal degrade condition on either the working
       path or the protection path.";
    reference
      "RFC 4427: Recovery (Protection and Restoration) Terminology
       for Generalized Multi-Protocol Label Switching (GMPLS)";
  }

  identity manual-switch {
    base lsp-protection-state;
    description
      "A manual switchover command is active.";
    reference
      "RFC 4427: Recovery (Protection and Restoration) Terminology
       for Generalized Multi-Protocol Label Switching (GMPLS)";
  }

  identity wait-to-restore {
    base lsp-protection-state;
    description
      "A WTR timer is running.";
    reference
      "RFC 4427: Recovery (Protection and Restoration) Terminology
       for Generalized Multi-Protocol Label Switching (GMPLS)";
  }

  identity do-not-revert {
    base lsp-protection-state;
    description
      "A Do Not Revert (DNR) condition is active because of
       non-revertive behavior.";
    reference
      "RFC 4427: Recovery (Protection and Restoration) Terminology
       for Generalized Multi-Protocol Label Switching (GMPLS)";
  }

  identity failure-of-protocol {
    base lsp-protection-state;
    description
      "LSP protection is not working because of a protocol failure
       condition.";
    reference
      "RFC 4427: Recovery (Protection and Restoration) Terminology
       for Generalized Multi-Protocol Label Switching (GMPLS)";
  }

  identity protection-external-commands {
    description
      "Base identity from which protection-related external commands
       used for troubleshooting purposes are derived.";
  }

  identity action-freeze {
    base protection-external-commands;
    description
      "A temporary configuration action initiated by an operator
       command that prevents any switchover action from being taken
       and, as such, freezes the current state.";
    reference
      "RFC 4427: Recovery (Protection and Restoration) Terminology
       for Generalized Multi-Protocol Label Switching (GMPLS)";
  }

  identity clear-freeze {
    base protection-external-commands;
    description
      "An action that clears the active freeze state.";
    reference
      "RFC 4427: Recovery (Protection and Restoration) Terminology
       for Generalized Multi-Protocol Label Switching (GMPLS)";
  }

  identity action-lockout-of-normal {
    base protection-external-commands;
    description
      "A temporary configuration action initiated by an operator
       command to ensure that the normal traffic is not allowed
       to use the protection transport entity.";
    reference
      "RFC 4427: Recovery (Protection and Restoration) Terminology
       for Generalized Multi-Protocol Label Switching (GMPLS)";
  }

  identity clear-lockout-of-normal {
    base protection-external-commands;
    description
      "An action that clears the active lockout of the
       normal state.";
    reference
      "RFC 4427: Recovery (Protection and Restoration) Terminology
       for Generalized Multi-Protocol Label Switching (GMPLS)";
  }

  identity action-lockout-of-protection {
    base protection-external-commands;
    description
      "A temporary configuration action initiated by an operator
       command to ensure that the protection transport entity is
       temporarily not available to transport a traffic signal
       (either normal or Extra-Traffic).";
    reference
      "RFC 4427: Recovery (Protection and Restoration) Terminology
       for Generalized Multi-Protocol Label Switching (GMPLS)";
  }

  identity action-forced-switch {
    base protection-external-commands;
    description
      "A switchover action initiated by an operator command to switch
       the Extra-Traffic signal, the normal traffic signal, or the
       null signal to the protection transport entity, unless a
       switchover command of equal or higher priority is in effect.";
    reference
      "RFC 4427: Recovery (Protection and Restoration) Terminology
       for Generalized Multi-Protocol Label Switching (GMPLS)";
  }

  identity action-manual-switch {
    base protection-external-commands;
    description
      "A switchover action initiated by an operator command to switch
       the Extra-Traffic signal, the normal traffic signal, or
       the null signal to the protection transport entity, unless
       a fault condition exists on other transport entities or a
       switchover command of equal or higher priority is in effect.";
    reference
      "RFC 4427: Recovery (Protection and Restoration) Terminology
       for Generalized Multi-Protocol Label Switching (GMPLS)";
  }

  // cCHANGE NOTE: The description and reference of the 
  // identity action-exercise have been updated in this module 
  // revision
  // RFC Editor: remove the note above and this note
  identity action-exercise {
    base protection-external-commands;
    description
      "An action that starts testing whether or not Automatic 
       Protection Switching (APS) communication is operating 
       correctly.  It is of lower priority than any
       other state or command.";
    reference
      "ITU-T G.808.1 v4.0 (05/2014): Generic protection switching - 
      Linear trail and subnetwork protection";
  }

  identity clear {
    base protection-external-commands;
    description
      "An action that clears the active near-end lockout of a
       protection, forced switchover, manual switchover, WTR state,
       or exercise command.";
    reference
      "RFC 4427: Recovery (Protection and Restoration) Terminology
       for Generalized Multi-Protocol Label Switching (GMPLS)";
  }

  identity switching-capabilities {
    description
      "Base identity for interface switching capabilities.";
    reference
      "RFC 3471: Generalized Multi-Protocol Label Switching (GMPLS)
       Signaling Functional Description";
  }

  identity switching-psc1 {
    base switching-capabilities;
    description
      "Packet-Switch Capable-1 (PSC-1).";
    reference
      "RFC 3471: Generalized Multi-Protocol Label Switching (GMPLS)
       Signaling Functional Description";
  }

  identity switching-evpl {
    base switching-capabilities;
    description
      "Ethernet Virtual Private Line (EVPL).";
    reference
      "RFC 6004: Generalized MPLS (GMPLS) Support for Metro Ethernet
       Forum and G.8011 Ethernet Service Switching";
  }

  identity switching-l2sc {
    base switching-capabilities;
    description
      "Layer-2 Switch Capable (L2SC).";
    reference
      "RFC 3471: Generalized Multi-Protocol Label Switching (GMPLS)
       Signaling Functional Description";
  }

  identity switching-tdm {
    base switching-capabilities;
    description
      "Time-Division-Multiplex Capable (TDM).";
    reference
      "RFC 3471: Generalized Multi-Protocol Label Switching (GMPLS)
       Signaling Functional Description";
  }

  identity switching-otn {
    base switching-capabilities;
    description
      "OTN-TDM capable.";
    reference
      "RFC 7138: Traffic Engineering Extensions to OSPF for GMPLS
       Control of Evolving G.709 Optical Transport Networks";
  }

  identity switching-dcsc {
    base switching-capabilities;
    description
      "Data Channel Switching Capable (DCSC).";
    reference
      "RFC 6002: Generalized MPLS (GMPLS) Data Channel
       Switching Capable (DCSC) and Channel Set Label Extensions";
  }

  identity switching-lsc {
    base switching-capabilities;
    description
      "Lambda-Switch Capable (LSC).";
    reference
      "RFC 3471: Generalized Multi-Protocol Label Switching (GMPLS)
       Signaling Functional Description";
  }

  identity switching-fsc {
    base switching-capabilities;
    description
      "Fiber-Switch Capable (FSC).";
    reference
      "RFC 3471: Generalized Multi-Protocol Label Switching (GMPLS)
       Signaling Functional Description";
  }

  identity lsp-encoding-types {
    description
      "Base identity for encoding types.";
    reference
      "RFC 3471: Generalized Multi-Protocol Label Switching (GMPLS)
       Signaling Functional Description";
  }

  identity lsp-encoding-packet {
    base lsp-encoding-types;
    description
      "Packet LSP encoding.";
    reference
      "RFC 3471: Generalized Multi-Protocol Label Switching (GMPLS)
       Signaling Functional Description";
  }

  identity lsp-encoding-ethernet {
    base lsp-encoding-types;
    description
      "Ethernet LSP encoding.";
    reference
      "RFC 3471: Generalized Multi-Protocol Label Switching (GMPLS)
       Signaling Functional Description";
  }

  identity lsp-encoding-pdh {
    base lsp-encoding-types;
    description
      "ANSI/ETSI PDH LSP encoding.";
    reference
      "RFC 3471: Generalized Multi-Protocol Label Switching (GMPLS)
       Signaling Functional Description";
  }

  identity lsp-encoding-sdh {
    base lsp-encoding-types;
    description
      "SDH ITU-T G.707 / SONET ANSI T1.105 LSP encoding.";
    reference
      "RFC 3471: Generalized Multi-Protocol Label Switching (GMPLS)
       Signaling Functional Description";
  }

  identity lsp-encoding-digital-wrapper {
    base lsp-encoding-types;
    description
      "Digital Wrapper LSP encoding.";
    reference
      "RFC 3471: Generalized Multi-Protocol Label Switching (GMPLS)
       Signaling Functional Description";
  }

  identity lsp-encoding-lambda {
    base lsp-encoding-types;
    description
      "Lambda (photonic) LSP encoding.";
    reference
      "RFC 3471: Generalized Multi-Protocol Label Switching (GMPLS)
       Signaling Functional Description";
  }

  identity lsp-encoding-fiber {
    base lsp-encoding-types;
    description
      "Fiber LSP encoding.";
    reference
      "RFC 3471: Generalized Multi-Protocol Label Switching (GMPLS)
       Signaling Functional Description";
  }

  identity lsp-encoding-fiber-channel {
    base lsp-encoding-types;
    description
      "FiberChannel LSP encoding.";
    reference
      "RFC 3471: Generalized Multi-Protocol Label Switching (GMPLS)
       Signaling Functional Description";
  }

  identity lsp-encoding-oduk {
    base lsp-encoding-types;
    description
      "G.709 ODUk (Digital Path) LSP encoding.";
    reference
      "RFC 4328: Generalized Multi-Protocol Label Switching (GMPLS)
       Signaling Extensions for G.709 Optical Transport Networks
       Control";
  }

  identity lsp-encoding-optical-channel {
    base lsp-encoding-types;
    description
      "G.709 Optical Channel LSP encoding.";
    reference
      "RFC 4328: Generalized Multi-Protocol Label Switching (GMPLS)
       Signaling Extensions for G.709 Optical Transport Networks
       Control";
  }

  identity lsp-encoding-line {
    base lsp-encoding-types;
    description
      "Line (e.g., 8B/10B) LSP encoding.";
    reference
      "RFC 6004: Generalized MPLS (GMPLS) Support for Metro
       Ethernet Forum and G.8011 Ethernet Service Switching";
  }

  identity path-signaling-type {
    description
      "Base identity from which specific LSP path setup types
       are derived.";
  }

  identity path-setup-static {
    base path-signaling-type;
    description
      "Static LSP provisioning path setup.";
  }

  identity path-setup-rsvp {
    base path-signaling-type;
    description
      "RSVP-TE signaling path setup.";
    reference
      "RFC 3209: RSVP-TE: Extensions to RSVP for LSP Tunnels";
  }

  identity path-setup-sr {
    base path-signaling-type;
    description
      "Segment-routing path setup.";
  }

  identity path-scope-type {
    description
      "Base identity from which specific path scope types are
       derived.";
  }

  identity path-scope-segment {
    base path-scope-type;
    description
      "Path scope segment.";
    reference
      "RFC 4873: GMPLS Segment Recovery";
  }

  identity path-scope-end-to-end {
    base path-scope-type;
    description
      "Path scope end to end.";
    reference
      "RFC 4873: GMPLS Segment Recovery";
  }

  identity route-usage-type {
    description
      "Base identity for route usage.";
  }

  identity route-include-object {
    base route-usage-type;
    description
      "'Include route' object.";
  }

  identity route-exclude-object {
    base route-usage-type;
    description
      "'Exclude route' object.";
    reference
      "RFC 4874: Exclude Routes - Extension to Resource ReserVation
       Protocol-Traffic Engineering (RSVP-TE)";
  }

  identity route-exclude-srlg {
    base route-usage-type;
    description
      "Excludes SRLGs.";
    reference
      "RFC 4874: Exclude Routes - Extension to Resource ReserVation
       Protocol-Traffic Engineering (RSVP-TE)";
  }

  identity path-metric-type {
    description
      "Base identity for the path metric type.";
  }

  identity path-metric-te {
    base path-metric-type;
    description
      "TE path metric.";
    reference
      "RFC 3785: Use of Interior Gateway Protocol (IGP) Metric as a
       second MPLS Traffic Engineering (TE) Metric";
  }

  identity path-metric-igp {
    base path-metric-type;
    description
      "IGP path metric.";
    reference
      "RFC 3785: Use of Interior Gateway Protocol (IGP) Metric as a
       second MPLS Traffic Engineering (TE) Metric";
  }

  identity path-metric-hop {
    base path-metric-type;
    description
      "Hop path metric.";
  }

  identity path-metric-delay-average {
    base path-metric-type;
    description
      "Average unidirectional link delay.";
    reference
      "RFC 7471: OSPF Traffic Engineering (TE) Metric Extensions";
  }

  identity path-metric-delay-minimum {
    base path-metric-type;
    description
      "Minimum unidirectional link delay.";
    reference
      "RFC 7471: OSPF Traffic Engineering (TE) Metric Extensions";
  }

  identity path-metric-residual-bandwidth {
    base path-metric-type;
    description
      "Unidirectional Residual Bandwidth, which is defined to be
       Maximum Bandwidth (RFC 3630) minus the bandwidth currently
       allocated to LSPs.";
    reference
      "RFC 3630: Traffic Engineering (TE) Extensions to OSPF
       Version 2
       RFC 7471: OSPF Traffic Engineering (TE) Metric Extensions";
  }

  identity path-metric-optimize-includes {
    base path-metric-type;
    description
      "A metric that optimizes the number of included resources
       specified in a set.";
  }

  identity path-metric-optimize-excludes {
    base path-metric-type;
    description
      "A metric that optimizes to a maximum the number of excluded
       resources specified in a set.";
  }

  identity path-tiebreaker-type {
    description
      "Base identity for the path tiebreaker type.";
  }

  identity path-tiebreaker-minfill {
    base path-tiebreaker-type;
    description
      "Min-Fill LSP path placement.";
  }

  identity path-tiebreaker-maxfill {
    base path-tiebreaker-type;
    description
      "Max-Fill LSP path placement.";
  }

  identity path-tiebreaker-random {
    base path-tiebreaker-type;
    description
      "Random LSP path placement.";
  }

  identity resource-affinities-type {
    description
      "Base identity for resource class affinities.";
    reference
      "RFC 2702: Requirements for Traffic Engineering Over MPLS";
  }

  identity resource-aff-include-all {
    base resource-affinities-type;
    description
      "The set of attribute filters associated with a
       tunnel, all of which must be present for a link
       to be acceptable.";
    reference
      "RFC 2702: Requirements for Traffic Engineering Over MPLS
       RFC 3209: RSVP-TE: Extensions to RSVP for LSP Tunnels";
  }

  identity resource-aff-include-any {
    base resource-affinities-type;
    description
      "The set of attribute filters associated with a
       tunnel, any of which must be present for a link
       to be acceptable.";
    reference
      "RFC 2702: Requirements for Traffic Engineering Over MPLS
       RFC 3209: RSVP-TE: Extensions to RSVP for LSP Tunnels";
  }

  identity resource-aff-exclude-any {
    base resource-affinities-type;
    description
      "The set of attribute filters associated with a
       tunnel, any of which renders a link unacceptable.";
    reference
      "RFC 2702: Requirements for Traffic Engineering Over MPLS
       RFC 3209: RSVP-TE: Extensions to RSVP for LSP Tunnels";
  }

  identity te-optimization-criterion {
    description
      "Base identity for the TE optimization criteria.";
    reference
      "RFC 3272: Overview and Principles of Internet Traffic
       Engineering";
  }

  identity not-optimized {
    base te-optimization-criterion;
    description
      "Optimization is not applied.";
  }

  identity cost {
    base te-optimization-criterion;
    description
      "Optimized on cost.";
    reference
      "RFC 5541: Encoding of Objective Functions in the Path
       Computation Element Communication Protocol (PCEP)";
  }

  identity delay {
    base te-optimization-criterion;
    description
      "Optimized on delay.";
    reference
      "RFC 5541: Encoding of Objective Functions in the Path
       Computation Element Communication Protocol (PCEP)";
  }

  identity path-computation-srlg-type {
    description
      "Base identity for SRLG path computation.";
  }

  identity srlg-ignore {
    base path-computation-srlg-type;
    description
      "Ignores SRLGs in the path computation.";
  }

  identity srlg-strict {
    base path-computation-srlg-type;
    description
      "Includes a strict SRLG check in the path computation.";
  }

  identity srlg-preferred {
    base path-computation-srlg-type;
    description
      "Includes a preferred SRLG check in the path computation.";
  }

  identity srlg-weighted {
    base path-computation-srlg-type;
    description
      "Includes a weighted SRLG check in the path computation.";
  }

  // CHANGE NOTE: The base identity path-computation-error-reason 
  // and its derived identities below have been
  // added in this module revision
  // RFC Editor: remove the note above and this note
  identity path-computation-error-reason {
    description
      "Base identity for path computation error reasons.";
  }

    identity path-computation-error-path-not-found {
      base path-computation-error-reason;
      description
        "Path computation has failed because of an unspecified 
        reason.";
      reference
        "Section 7.5 of RFC5440";
    }

    identity path-computation-error-no-topology {
      base path-computation-error-reason;
      description
        "Path computation has failed because there is no topology
        with the provided topology-identifier.";
    }

    identity path-computation-error-no-dependent-server {
      base path-computation-error-reason;
      description
        "Path computation has failed because one or more dependent
        path computation servers are unavailable.

        The dependent path computation server could be
        a Backward-Recursive Path Computation (BRPC) downstream
        PCE or a child PCE.";
      reference
        "RFC5441, RFC8685";
    }

    identity path-computation-error-pce-unavailable {
      base path-computation-error-reason;
      description
        "Path computation has failed because PCE is not available.
        
        It corresponds to bit 31 of the Flags field of the 
        NO-PATH-VECTOR TLV.";
      reference
        "RFC5440;
        
        https://www.iana.org/assignments/pcep/pcep.xhtml";
    }

    identity path-computation-error-no-inclusion-hop {
      base path-computation-error-reason;
      description
        "Path computation has failed because there is no
        node or link provided by one or more inclusion hops.";
    }

    identity path-computation-error-destination-unknown-in-domain {
      base path-computation-error-reason;
      description
        "Path computation has failed because the destination node is
        unknown in indicated destination domain.
        
        It corresponds to bit 19 of the Flags field of the 
        NO-PATH-VECTOR TLV.";
      reference
        "RFC8685;
        
        https://www.iana.org/assignments/pcep/pcep.xhtml";
    }

    identity path-computation-error-no-resource {
      base path-computation-error-reason;
      description
        "Path computation has failed because there is no
        available resource in one or more domains.
        
        It corresponds to bit 20 of the Flags field of the 
        NO-PATH-VECTOR TLV.";
      reference
        "RFC8685;
        
        https://www.iana.org/assignments/pcep/pcep.xhtml";
    }

    identity path-computation-error-child-pce-unresponsive {
      base path-computation-error-no-dependent-server;
      description
        "Path computation has failed because child PCE is not
        responsive.
        
        It corresponds to bit 21 of the Flags field of the 
        NO-PATH-VECTOR TLV.";
      reference
        "RFC8685;
        
        https://www.iana.org/assignments/pcep/pcep.xhtml";
    }

    identity path-computation-error-destination-domain-unknown {
      base path-computation-error-reason;
      description
        "Path computation has failed because the destination domain
        was unknown.
        
        It corresponds to bit 22 of the Flags field of the 
        NO-PATH-VECTOR TLV.";
      reference
        "RFC8685;
        
        https://www.iana.org/assignments/pcep/pcep.xhtml";
    }

    identity path-computation-error-p2mp {
      base path-computation-error-reason;
      description
        "Path computation has failed because of P2MP reachability
        problem.
        
        It corresponds to bit 24 of the Flags field of the 
        NO-PATH-VECTOR TLV.";
      reference
        "RFC8306;
        
        https://www.iana.org/assignments/pcep/pcep.xhtml";
    }

    identity path-computation-error-no-gco-migration {
      base path-computation-error-reason;
      description
        "Path computation has failed because of no Global Concurrent
        Optimization (GCO) migration path found.
        
        It corresponds to bit 26 of the Flags field of the 
        NO-PATH-VECTOR TLV.";
      reference
        "RFC5557;
        
        https://www.iana.org/assignments/pcep/pcep.xhtml";
    }

    identity path-computation-error-no-gco-solution {
      base path-computation-error-reason;
      description
        "Path computation has failed because of no GCO solution
        found.
        
        It corresponds to bit 25 of the Flags field of the 
        NO-PATH-VECTOR TLV.";
      reference
        "RFC5557;
        
        https://www.iana.org/assignments/pcep/pcep.xhtml";
    }

    identity path-computation-error-pks-expansion {
      base path-computation-error-reason;
      description
        "Path computation has failed because of Path-Key Subobject
        (PKS)  expansion failure.
        
        It corresponds to bit 27 of the Flags field of the 
        NO-PATH-VECTOR TLV.";
      reference
        "RFC5520;
        
        https://www.iana.org/assignments/pcep/pcep.xhtml";
    }

    identity path-computation-error-brpc-chain-unavailable {
      base path-computation-error-no-dependent-server;
      description
        "Path computation has failed because PCE BRPC chain
        unavailable.
        
        It corresponds to bit 28 of the Flags field of the 
        NO-PATH-VECTOR TLV.";
      reference
        "RFC5441;
        
        https://www.iana.org/assignments/pcep/pcep.xhtml";
    }

    identity path-computation-error-source-unknown {
      base path-computation-error-reason;
      description
        "Path computation has failed because source node is 
        unknown.
        
        It corresponds to bit 29 of the Flags field of the 
        NO-PATH-VECTOR TLV.";
      reference
        "RFC5440;
        
        https://www.iana.org/assignments/pcep/pcep.xhtml";
    }

    identity path-computation-error-destination-unknown {
      base path-computation-error-reason;
      description
        "Path computation has failed because destination node is
        unknown.
        
        It corresponds to bit 30 of the Flags field of the 
        NO-PATH-VECTOR TLV.";
      reference
        "RFC5440;
        
        https://www.iana.org/assignments/pcep/pcep.xhtml";
    }

    identity path-computation-error-no-server {
      base path-computation-error-reason;
      description
        "Path computation has failed because path computation
        server is unavailable.";
      reference
        "RFC5440;
        
        https://www.iana.org/assignments/pcep/pcep.xhtml";
    }

  // CHANGE NOTE: The base identity protocol-origin-type and 
  // its derived identities below have been
  // added in this module revision
  // RFC Editor: remove the note above and this note
  identity protocol-origin-type {
    description
      "Base identity for protocol origin type.";
  }

    identity protocol-origin-api {
      base protocol-origin-type;
      description
        "Protocol origin is via Application Programmable Interface
        (API).";
    }

    identity protocol-origin-pcep {
      base protocol-origin-type;
      description
        "Protocol origin is Path Computation Engine Protocol 
        (PCEP).";
      reference "RFC5440";
    }

    identity protocol-origin-bgp {
      base protocol-origin-type;
      description
        "Protocol origin is Border Gateway Protocol (BGP).";
      reference "RFC9012";
    }

  // CHANGE NOTE: The base identity svec-objective-function-type 
  // and its derived identities below have been
  // added in this module revision
  // RFC Editor: remove the note above and this note
  identity svec-objective-function-type {
    description
      "Base identity for SVEC objective function type.";
    reference
      "RFC5541: Encoding of Objective Functions in the Path
       Computation Element Communication Protocol (PCEP).";
  }

    identity svec-of-minimize-agg-bandwidth-consumption {
      base svec-objective-function-type;
      description
        "Objective function for minimizing aggregate bandwidth 
        consumption (MBC).";
      reference
        "RFC5541: Encoding of Objective Functions in the Path
        Computation Element Communication Protocol (PCEP).";
    }

    identity svec-of-minimize-load-most-loaded-link {
      base svec-objective-function-type;
      description
        "Objective function for minimizing the load on the link that 
        is carrying the highest load (MLL).";
      reference
        "RFC5541: Encoding of Objective Functions in the Path
        Computation Element Communication Protocol (PCEP).";
    }

    identity svec-of-minimize-cost-path-set {
      base svec-objective-function-type;
      description
        "Objective function for minimizing the cost on a path set 
        (MCC).";
      reference
        "RFC5541: Encoding of Objective Functions in the Path
        Computation Element Communication Protocol (PCEP).";
    }

    identity svec-of-minimize-common-transit-domain {
      base svec-objective-function-type;
      description
        "Objective function for minimizing the number of common 
        transit domains (MCTD).";
      reference
        "RFC8685: Path Computation Element Communication Protocol 
        (PCEP) Extensions for the Hierarchical Path Computation 
        Element (H-PCE) Architecture.";
    }

    identity svec-of-minimize-shared-link {
      base svec-objective-function-type;
      description
        "Objective function for minimizing the number of shared 
        links (MSL).";
      reference
        "RFC8685: Path Computation Element Communication Protocol 
        (PCEP) Extensions for the Hierarchical Path Computation 
        Element (H-PCE) Architecture.";
    }

    identity svec-of-minimize-shared-srlg {
      base svec-objective-function-type;
      description
        "Objective function for minimizing the number of shared 
        Shared Risk Link Groups (SRLG) (MSS).";
      reference
        "RFC8685: Path Computation Element Communication Protocol 
        (PCEP) Extensions for the Hierarchical Path Computation 
        Element (H-PCE) Architecture.";
    }

    identity svec-of-minimize-shared-nodes {
      base svec-objective-function-type;
      description
        "Objective function for minimizing the number of shared 
        nodes (MSN).";
      reference
        "RFC8685: Path Computation Element Communication Protocol 
        (PCEP) Extensions for the Hierarchical Path Computation 
        Element (H-PCE) Architecture.";
    }

  // CHANGE NOTE: The base identity svec-metric-type and 
  // its derived identities below have been
  // added in this module revision
  // RFC Editor: remove the note above and this note
  identity svec-metric-type {
    description
      "Base identity for SVEC metric type.";
    reference
      "RFC5541: Encoding of Objective Functions in the Path
       Computation Element Communication Protocol (PCEP).";
  }

    identity svec-metric-cumul-te {
      base svec-metric-type;
      description
        "Cumulative TE cost.";
      reference
        "RFC5541: Encoding of Objective Functions in the Path
        Computation Element Communication Protocol (PCEP).";
    }

    identity svec-metric-cumul-igp {
      base svec-metric-type;
      description
        "Cumulative IGP cost.";
      reference
        "RFC5541: Encoding of Objective Functions in the Path
        Computation Element Communication Protocol (PCEP).";
    }

    identity svec-metric-cumul-hop {
      base svec-metric-type;
      description
        "Cumulative Hop path metric.";
      reference
        "RFC5541: Encoding of Objective Functions in the Path
        Computation Element Communication Protocol (PCEP).";
    }

    identity svec-metric-aggregate-bandwidth-consumption {
      base svec-metric-type;
      description
        "Aggregate bandwidth consumption.";
      reference
        "RFC5541: Encoding of Objective Functions in the Path
        Computation Element Communication Protocol (PCEP).";
    }

    identity svec-metric-load-of-the-most-loaded-link {
      base svec-metric-type;
      description
        "Load of the most loaded link.";
      reference
        "RFC5541: Encoding of Objective Functions in the Path
        Computation Element Communication Protocol (PCEP).";
    }

  /**
   * TE bandwidth groupings
   **/

  grouping te-bandwidth {
    description
      "This grouping defines the generic TE bandwidth.
       For some known data-plane technologies, specific modeling
       structures are specified.  The string-encoded 'te-bandwidth'
       type is used for unspecified technologies.
       The modeling structure can be augmented later for other
       technologies.";
    container te-bandwidth {
      description
        "Container that specifies TE bandwidth.  The choices
         can be augmented for specific data-plane technologies.";
      choice technology {
        default "generic";
        description
          "Data-plane technology type.";
        case generic {
          leaf generic {
            type te-bandwidth;
            description
              "Bandwidth specified in a generic format.";
          }
        }
      }
    }
  }

  /**
   * TE label groupings
   **/

  grouping te-label {
    description
      "This grouping defines the generic TE label.
       The modeling structure can be augmented for each technology.
       For unspecified technologies, 'rt-types:generalized-label'
       is used.";
    container te-label {
      description
        "Container that specifies the TE label.  The choices can
         be augmented for specific data-plane technologies.";
      choice technology {
        default "generic";
        description
          "Data-plane technology type.";
        case generic {
          leaf generic {
            type rt-types:generalized-label;
            description
              "TE label specified in a generic format.";
          }
        }
      }
      leaf direction {
        type te-label-direction;
        default "forward";
        description
          "Label direction.";
      }
    }
  }

  grouping te-topology-identifier {
    description
      "Augmentation for a TE topology.";
    container te-topology-identifier {
      description
        "TE topology identifier container.";
      leaf provider-id {
        type te-global-id;
        default "0";
        description
          "An identifier to uniquely identify a provider.
           If omitted, it assumes that the topology provider ID
           value = 0 (the default).";
      }
      leaf client-id {
        type te-global-id;
        default "0";
        description
          "An identifier to uniquely identify a client.
           If omitted, it assumes that the topology client ID
           value = 0 (the default).";
      }
      leaf topology-id {
        type te-topology-id;
        default "";
        description
          "When the datastore contains several topologies,
           'topology-id' distinguishes between them.  If omitted,
           the default (empty) string for this leaf is assumed.";
      }
    }
  }

  /**
   * TE performance metrics groupings
   **/

  grouping performance-metrics-one-way-delay-loss {
    description
      "Performance Metrics (PM) information in real time that can
       be applicable to links or connections.  PM defined in this
       grouping are applicable to generic TE PM as well as packet TE
       PM.";
    reference
      "RFC 7471: OSPF Traffic Engineering (TE) Metric Extensions
       RFC 7823: Performance-Based Path Selection for Explicitly
       Routed Label Switched Paths (LSPs) Using TE Metric
       Extensions
       RFC 8570: IS-IS Traffic Engineering (TE) Metric Extensions";
    leaf one-way-delay {
      type uint32 {
        range "0..16777215";
      }
      description
        "One-way delay or latency in microseconds.";
    }
    leaf one-way-delay-normality {
      type te-types:performance-metrics-normality;
      description
        "One-way delay normality.";
    }
  }

  grouping performance-metrics-two-way-delay-loss {
    description
      "PM information in real time that can be applicable to links or
       connections.  PM defined in this grouping are applicable to
       generic TE PM as well as packet TE PM.";
    reference
      "RFC 7471: OSPF Traffic Engineering (TE) Metric Extensions
       RFC 7823: Performance-Based Path Selection for Explicitly
       Routed Label Switched Paths (LSPs) Using TE Metric
       Extensions
       RFC 8570: IS-IS Traffic Engineering (TE) Metric Extensions";
    leaf two-way-delay {
      type uint32 {
        range "0..16777215";
      }
      description
        "Two-way delay or latency in microseconds.";
    }
    leaf two-way-delay-normality {
      type te-types:performance-metrics-normality;
      description
        "Two-way delay normality.";
    }
  }

  grouping performance-metrics-one-way-bandwidth {
    description
      "PM information in real time that can be applicable to links.
       PM defined in this grouping are applicable to generic TE PM
       as well as packet TE PM.";
    reference
      "RFC 7471: OSPF Traffic Engineering (TE) Metric Extensions
       RFC 7823: Performance-Based Path Selection for Explicitly
       Routed Label Switched Paths (LSPs) Using TE Metric
       Extensions
       RFC 8570: IS-IS Traffic Engineering (TE) Metric Extensions";
    leaf one-way-residual-bandwidth {
      type rt-types:bandwidth-ieee-float32;
      units "bytes per second";
      default "0x0p0";
      description
        "Residual bandwidth that subtracts tunnel reservations from
         Maximum Bandwidth (or link capacity) (RFC 3630) and
         provides an aggregated remainder across QoS classes.";
      reference
        "RFC 3630: Traffic Engineering (TE) Extensions to OSPF
         Version 2";
    }
    leaf one-way-residual-bandwidth-normality {
      type te-types:performance-metrics-normality;
      default "normal";
      description
        "Residual bandwidth normality.";
    }
    leaf one-way-available-bandwidth {
      type rt-types:bandwidth-ieee-float32;
      units "bytes per second";
      default "0x0p0";
      description
        "Available bandwidth that is defined to be residual
         bandwidth minus the measured bandwidth used for the
         actual forwarding of non-RSVP-TE LSP packets.  For a
         bundled link, available bandwidth is defined to be the
         sum of the component link available bandwidths.";
    }
    leaf one-way-available-bandwidth-normality {
      type te-types:performance-metrics-normality;
      default "normal";
      description
        "Available bandwidth normality.";
    }
    leaf one-way-utilized-bandwidth {
      type rt-types:bandwidth-ieee-float32;
      units "bytes per second";
      default "0x0p0";
      description
        "Bandwidth utilization that represents the actual
         utilization of the link (i.e., as measured in the router).
         For a bundled link, bandwidth utilization is defined to
         be the sum of the component link bandwidth utilizations.";
    }
    leaf one-way-utilized-bandwidth-normality {
      type te-types:performance-metrics-normality;
      default "normal";
      description
        "Bandwidth utilization normality.";
    }
  }

  grouping one-way-performance-metrics {
    description
      "One-way PM throttle grouping.";
    leaf one-way-delay {
      type uint32 {
        range "0..16777215";
      }
      default "0";
      description
        "One-way delay or latency in microseconds.";
    }
    leaf one-way-residual-bandwidth {
      type rt-types:bandwidth-ieee-float32;
      units "bytes per second";
      default "0x0p0";
      description
        "Residual bandwidth that subtracts tunnel reservations from
         Maximum Bandwidth (or link capacity) (RFC 3630) and
         provides an aggregated remainder across QoS classes.";
      reference
        "RFC 3630: Traffic Engineering (TE) Extensions to OSPF
         Version 2";
    }
    leaf one-way-available-bandwidth {
      type rt-types:bandwidth-ieee-float32;
      units "bytes per second";
      default "0x0p0";
      description
        "Available bandwidth that is defined to be residual
         bandwidth minus the measured bandwidth used for the
         actual forwarding of non-RSVP-TE LSP packets.  For a
         bundled link, available bandwidth is defined to be the
         sum of the component link available bandwidths.";
    }
    leaf one-way-utilized-bandwidth {
      type rt-types:bandwidth-ieee-float32;
      units "bytes per second";
      default "0x0p0";
      description
        "Bandwidth utilization that represents the actual
         utilization of the link (i.e., as measured in the router).
         For a bundled link, bandwidth utilization is defined to
         be the sum of the component link bandwidth utilizations.";
    }
  }

  grouping two-way-performance-metrics {
    description
      "Two-way PM throttle grouping.";
    leaf two-way-delay {
      type uint32 {
        range "0..16777215";
      }
      default "0";
      description
        "Two-way delay or latency in microseconds.";
    }
  }

  grouping performance-metrics-thresholds {
    description
      "Grouping for configurable thresholds for measured
       attributes.";
    uses one-way-performance-metrics;
    uses two-way-performance-metrics;
  }

  grouping performance-metrics-attributes {
    description
      "Contains PM attributes.";
    container performance-metrics-one-way {
      description
        "One-way link performance information in real time.";
      reference
        "RFC 7471: OSPF Traffic Engineering (TE) Metric Extensions
         RFC 7823: Performance-Based Path Selection for Explicitly
         Routed Label Switched Paths (LSPs) Using TE Metric
         Extensions
         RFC 8570: IS-IS Traffic Engineering (TE) Metric Extensions";
      uses performance-metrics-one-way-delay-loss;
      uses performance-metrics-one-way-bandwidth;
    }
    container performance-metrics-two-way {
      description
        "Two-way link performance information in real time.";
      reference
        "RFC 6374: Packet Loss and Delay Measurement for MPLS
         Networks";
      uses performance-metrics-two-way-delay-loss;
    }
  }

  grouping performance-metrics-throttle-container {
    description
      "Controls PM throttling.";
    container throttle {
      must 'suppression-interval >= measure-interval' {
        error-message "'suppression-interval' cannot be less than "
                    + "'measure-interval'.";
        description
          "Constraint on 'suppression-interval' and
           'measure-interval'.";
      }
      description
        "Link performance information in real time.";
      reference
        "RFC 7471: OSPF Traffic Engineering (TE) Metric Extensions
         RFC 7823: Performance-Based Path Selection for Explicitly
         Routed Label Switched Paths (LSPs) Using TE Metric
         Extensions
         RFC 8570: IS-IS Traffic Engineering (TE) Metric Extensions";
      leaf one-way-delay-offset {
        type uint32 {
          range "0..16777215";
        }
        default "0";
        description
          "Offset value to be added to the measured delay value.";
      }
      leaf measure-interval {
        type uint32;
        default "30";
        description
          "Interval, in seconds, to measure the extended metric
           values.";
      }
      leaf advertisement-interval {
        type uint32;
        default "0";
        description
          "Interval, in seconds, to advertise the extended metric
           values.";
      }
      leaf suppression-interval {
        type uint32 {
          range "1..max";
        }
        default "120";
        description
          "Interval, in seconds, to suppress advertisement of the
           extended metric values.";
        reference
          "RFC 8570: IS-IS Traffic Engineering (TE) Metric
           Extensions, Section 6";
      }
      container threshold-out {
        uses performance-metrics-thresholds;
        description
          "If the measured parameter falls outside an upper bound
           for all but the minimum-delay metric (or a lower bound
           for the minimum-delay metric only) and the advertised
           value is not already outside that bound, an 'anomalous'
           announcement (anomalous bit set) will be triggered.";
      }
      container threshold-in {
        uses performance-metrics-thresholds;
        description
          "If the measured parameter falls inside an upper bound
           for all but the minimum-delay metric (or a lower bound
           for the minimum-delay metric only) and the advertised
           value is not already inside that bound, a 'normal'
           announcement (anomalous bit cleared) will be triggered.";
      }
      container threshold-accelerated-advertisement {
        description
          "When the difference between the last advertised value and
           the current measured value exceeds this threshold, an
           'anomalous' announcement (anomalous bit set) will be
           triggered.";
        uses performance-metrics-thresholds;
      }
    }
  }

  /**
   * TE tunnel generic groupings
   **/

  grouping explicit-route-hop {
    description
      "The explicit route entry grouping.";
    choice type {
      description
        "The explicit route entry type.";
      case numbered-node-hop {
        container numbered-node-hop {
          must "node-id-uri or node-id" {
            description
              "At least one node identifier MUST be present.";
          }
          leaf node-id-uri {
            type nw:node-id;
            description
              "The identifier of a node in the topology.";
          }
          leaf node-id {
            type te-node-id;
            description
              "The identifier of a node in the TE topology.";
          }
          leaf hop-type {
            type te-hop-type;
            default "strict";
            description
              "Strict or loose hop.";
          }
          description
            "Numbered node route hop.";
          reference
            "RFC 3209: RSVP-TE: Extensions to RSVP for LSP Tunnels,
             Section 4.3, EXPLICIT_ROUTE in RSVP-TE
             RFC 3477: Signalling Unnumbered Links in Resource
             ReSerVation Protocol - Traffic Engineering (RSVP-TE)";
        }
      }
      case numbered-link-hop {
        container numbered-link-hop {
          leaf link-tp-id {
            type te-tp-id;
            mandatory true;
            description
              "TE Link Termination Point (LTP) identifier.";
          }
          leaf hop-type {
            type te-hop-type;
            default "strict";
            description
              "Strict or loose hop.";
          }
          leaf direction {
            type te-link-direction;
            default "outgoing";
            description
              "Link route object direction.";
          }
          description
            "Numbered link explicit route hop.";
          reference
            "RFC 3209: RSVP-TE: Extensions to RSVP for LSP Tunnels,
             Section 4.3, EXPLICIT_ROUTE in RSVP-TE
             RFC 3477: Signalling Unnumbered Links in Resource
             ReSerVation Protocol - Traffic Engineering (RSVP-TE)";
        }
      }
      case unnumbered-link-hop {
        container unnumbered-link-hop {
          must "(link-tp-id-uri or link-tp-id) and " +
                "(node-id-uri or node-id)" {
            description
              "At least one node identifier and at least one Link 
              Termination Point (LTP) identifier MUST be present.";
          }
          leaf link-tp-id-uri {
            type nt:tp-id;
            description
              "Link Termination Point (LTP) identifier.";
          }
          leaf link-tp-id {
            type te-tp-id;
            description
              "TE LTP identifier.  The combination of the TE link ID
               and the TE node ID is used to identify an unnumbered
               TE link.";
          }
          leaf node-id-uri {
            type nw:node-id;
            description
              "The identifier of a node in the topology.";
          }
          leaf node-id {
            type te-node-id;
            description
              "The identifier of a node in the TE topology.";
          }
          leaf hop-type {
            type te-hop-type;
            default "strict";
            description
              "Strict or loose hop.";
          }
          leaf direction {
            type te-link-direction;
            default "outgoing";
            description
              "Link route object direction.";
          }
          description
            "Unnumbered link explicit route hop.";
          reference
            "RFC 3209: RSVP-TE: Extensions to RSVP for LSP Tunnels,
             Section 4.3, EXPLICIT_ROUTE in RSVP-TE
             RFC 3477: Signalling Unnumbered Links in Resource
             ReSerVation Protocol - Traffic Engineering (RSVP-TE)";
        }
      }
      case as-number {
        container as-number-hop {
          leaf as-number {
            type inet:as-number;
            mandatory true;
            description
              "The Autonomous System (AS) number.";
          }
          leaf hop-type {
            type te-hop-type;
            default "strict";
            description
              "Strict or loose hop.";
          }
          description
            "AS explicit route hop.";
        }
      }
      case label {
        container label-hop {
          description
            "Label hop type.";
          uses te-label;
        }
        description
          "The label explicit route hop type.";
      }
    }
  }

  grouping record-route-state {
    description
      "The Record Route grouping.";
    leaf index {
      type uint32;
      description
        "Record Route hop index.  The index is used to
         identify an entry in the list.  The order of entries
         is defined by the user without relying on key values.";
    }
    choice type {
      description
        "The Record Route entry type.";
      case numbered-node-hop {
        container numbered-node-hop {
          must "node-id-uri or node-id" {
            description
              "At least one node identifier MUST be present.";
          }
          description
            "Numbered node route hop container.";
          leaf node-id-uri {
            type nw:node-id;
            description
              "The identifier of a node in the topology.";
          }
          leaf node-id {
            type te-node-id;
            description
              "The identifier of a node in the TE topology.";
          }
          leaf-list flags {
            type path-attribute-flags;
            description
              "Path attributes flags.";
            reference
              "RFC 3209: RSVP-TE: Extensions to RSVP for LSP Tunnels
               RFC 4090: Fast Reroute Extensions to RSVP-TE for LSP
               Tunnels
               RFC 4561: Definition of a Record Route Object (RRO)
               Node-Id Sub-Object";
          }
        }
        description
          "Numbered node route hop.";
      }
      case numbered-link-hop {
        container numbered-link-hop {
          description
            "Numbered link route hop container.";
          leaf link-tp-id {
            type te-tp-id;
            mandatory true;
            description
              "Numbered TE LTP identifier.";
          }
          leaf-list flags {
            type path-attribute-flags;
            description
              "Path attributes flags.";
            reference
              "RFC 3209: RSVP-TE: Extensions to RSVP for LSP Tunnels
               RFC 4090: Fast Reroute Extensions to RSVP-TE for LSP
               Tunnels
               RFC 4561: Definition of a Record Route Object (RRO)
               Node-Id Sub-Object";
          }
        }
        description
          "Numbered link route hop.";
      }
      case unnumbered-link-hop {
        container unnumbered-link-hop {
          must "(link-tp-id-uri or link-tp-id) and " +
              "(node-id-uri or node-id)" {
            description
              "At least one node identifier and at least one Link 
              Termination Point (LTP) identifier MUST be present.";
          }
          leaf link-tp-id-uri {
            type nt:tp-id;
            description
              "Link Termination Point (LTP) identifier.";
          }
          leaf link-tp-id {
            type te-tp-id;
            description
              "TE LTP identifier.  The combination of the TE link ID
               and the TE node ID is used to identify an unnumbered
               TE link.";
          }
          leaf node-id-uri {
            type nw:node-id;
            description
              "The identifier of a node in the topology.";
          }
          leaf node-id {
            type te-node-id;
            description
              "The identifier of a node in the TE topology.";
          }
          leaf-list flags {
            type path-attribute-flags;
            description
              "Path attributes flags.";
            reference
              "RFC 3209: RSVP-TE: Extensions to RSVP for LSP Tunnels
               RFC 4090: Fast Reroute Extensions to RSVP-TE for LSP
               Tunnels
               RFC 4561: Definition of a Record Route Object (RRO)
               Node-Id Sub-Object";
          }
          description
            "Unnumbered link Record Route hop.";
          reference
            "RFC 3477: Signalling Unnumbered Links in Resource
             ReSerVation Protocol - Traffic Engineering (RSVP-TE)";
        }
        description
          "Unnumbered link route hop.";
      }
      case label {
        container label-hop {
          description
            "Label route hop type.";
          uses te-label;
          leaf-list flags {
            type path-attribute-flags;
            description
              "Path attributes flags.";
            reference
              "RFC 3209: RSVP-TE: Extensions to RSVP for LSP Tunnels
               RFC 4090: Fast Reroute Extensions to RSVP-TE for LSP
               Tunnels
               RFC 4561: Definition of a Record Route Object (RRO)
               Node-Id Sub-Object";
          }
        }
        description
          "The label Record Route entry types.";
      }
    }
  }

  grouping label-restriction-info {
    description
      "Label set item information.";
    leaf restriction {
      type enumeration {
        enum inclusive {
          description
            "The label or label range is inclusive.";
        }
        enum exclusive {
          description
            "The label or label range is exclusive.";
        }
      }
      default "inclusive";
      description
        "Indicates whether the list item is inclusive or exclusive.";
    }
    leaf index {
      type uint32;
      description
        "The index of the label restriction list entry.";
    }
    container label-start {
      must "(not(../label-end/te-label/direction) and"
         + " not(te-label/direction))"
         + " or "
         + "(../label-end/te-label/direction = te-label/direction)"
         + " or "
         + "(not(te-label/direction) and"
         + " (../label-end/te-label/direction = 'forward'))"
         + " or "
         + "(not(../label-end/te-label/direction) and"
         + " (te-label/direction = 'forward'))" {
        error-message "'label-start' and 'label-end' must have the "
                    + "same direction.";
      }
      description
        "This is the starting label if a label range is specified.
         This is the label value if a single label is specified,
         in which case the 'label-end' attribute is not set.";
      uses te-label;
    }
    container label-end {
      must "(not(../label-start/te-label/direction) and"
         + " not(te-label/direction))"
         + " or "
         + "(../label-start/te-label/direction = te-label/direction)"
         + " or "
         + "(not(te-label/direction) and"
         + " (../label-start/te-label/direction = 'forward'))"
         + " or "
         + "(not(../label-start/te-label/direction) and"
         + " (te-label/direction = 'forward'))" {
        error-message "'label-start' and 'label-end' must have the "
                    + "same direction.";
      }
      description
        "This is the ending label if a label range is specified.
         This attribute is not set if a single label is specified.";
      uses te-label;
    }
    container label-step {
      description
        "The step increment between labels in the label range.
         The label start/end values will have to be consistent
         with the sign of label step.  For example,
         'label-start' < 'label-end' enforces 'label-step' > 0
         'label-start' > 'label-end' enforces 'label-step' < 0.";
      choice technology {
        default "generic";
        description
          "Data-plane technology type.";
        case generic {
          leaf generic {
            type int32;
            default "1";
            description
              "Label range step.";
          }
        }
      }
    }
    leaf range-bitmap {
      type yang:hex-string;
      description
        "When there are gaps between 'label-start' and 'label-end',
         this attribute is used to specify the positions
         of the used labels.  This is represented in big endian as
         'hex-string'.
         The most significant byte in the hex-string is the farthest
         to the left in the byte sequence.  Leading zero bytes in the
         configured value may be omitted for brevity.
         Each bit position in the 'range-bitmap' 'hex-string' maps
         to a label in the range derived from 'label-start'.

         For example, assuming that 'label-start' = 16000 and
         'range-bitmap' = 0x01000001, then:

         - bit position (0) is set, and the corresponding mapped
           label from the range is 16000 + (0 * 'label-step') or
           16000 for default 'label-step' = 1.
         - bit position (24) is set, and the corresponding mapped
           label from the range is 16000 + (24 * 'label-step') or
           16024 for default 'label-step' = 1.";
    }
  }

  grouping label-set-info {
    description
      "Grouping for the list of label restrictions specifying what
       labels may or may not be used.";
    container label-restrictions {
      description
        "The label restrictions container.";
      list label-restriction {
        key "index";
        description
          "The absence of the label restrictions container implies
           that all labels are acceptable; otherwise, only restricted
           labels are available.";
        reference
          "RFC 7579: General Network Element Constraint Encoding
           for GMPLS-Controlled Networks";
        uses label-restriction-info;
      }
    }
  }

  grouping optimization-metric-entry {
    description
      "Optimization metrics configuration grouping.";
    leaf metric-type {
      type identityref {
        base path-metric-type;
      }
      description
        "Identifies the 'metric-type' that the path computation
         process uses for optimization.";
    }
    leaf weight {
      type uint8;
      default "1";
      description
        "TE path metric normalization weight.";
    }
    container explicit-route-exclude-objects {
      when "../metric-type = "
         + "'te-types:path-metric-optimize-excludes'";
      description
        "Container for the 'exclude route' object list.";
      uses path-route-exclude-objects;
    }
    container explicit-route-include-objects {
      when "../metric-type = "
         + "'te-types:path-metric-optimize-includes'";
      description
        "Container for the 'include route' object list.";
      uses path-route-include-objects;
    }
  }

  grouping common-constraints {
    description
      "Common constraints grouping that can be set on
       a constraint set or directly on the tunnel.";
    uses te-bandwidth {
      description
        "A requested bandwidth to use for path computation.";
    }
    leaf link-protection {
      type identityref {
        base link-protection-type;
      }
      default "te-types:link-protection-unprotected";
      description
        "Link protection type required for the links included
         in the computed path.";
      reference
        "RFC 4202: Routing Extensions in Support of
         Generalized Multi-Protocol Label Switching (GMPLS)";
    }
    leaf setup-priority {
      type uint8 {
        range "0..7";
      }
      default "7";
      description
        "TE LSP requested setup priority.";
      reference
        "RFC 3209: RSVP-TE: Extensions to RSVP for LSP Tunnels";
    }
    leaf hold-priority {
      type uint8 {
        range "0..7";
      }
      default "7";
      description
        "TE LSP requested hold priority.";
      reference
        "RFC 3209: RSVP-TE: Extensions to RSVP for LSP Tunnels";
    }
    leaf signaling-type {
      type identityref {
        base path-signaling-type;
      }
      default "te-types:path-setup-rsvp";
      description
        "TE tunnel path signaling type.";
    }
  }

  grouping tunnel-constraints {
    description
      "Tunnel constraints grouping that can be set on
       a constraint set or directly on the tunnel.";
    leaf network-id {
      type nw:network-id;
      description
        "The network topology identifier.";
    }
    uses te-topology-identifier;
    uses common-constraints;
  }

  grouping path-constraints-route-objects {
    description
      "List of route entries to be included or excluded when
       performing the path computation.";
    container explicit-route-objects-always {
      description
        "Container for the 'exclude route' object list.";
      list route-object-exclude-always {
        key "index";
        ordered-by user;
        description
          "List of route objects to always exclude from the path
           computation.";
        leaf index {
          type uint32;
          description
            "Explicit Route Object index.  The index is used to
             identify an entry in the list.  The order of entries
             is defined by the user without relying on key values.";
        }
        uses explicit-route-hop;
      }
      list route-object-include-exclude {
        key "index";
        ordered-by user;
        description
          "List of route objects to include or exclude in the path
           computation.";
        leaf explicit-route-usage {
          type identityref {
            base route-usage-type;
          }
          default "te-types:route-include-object";
          description
            "Indicates whether to include or exclude the
             route object.  The default is to include it.";
        }
        leaf index {
          type uint32;
          description
            "Route object include-exclude index.  The index is used
             to identify an entry in the list.  The order of entries
             is defined by the user without relying on key values.";
        }
        uses explicit-route-hop {
          augment "type" {
            case srlg {
              container srlg {
                description
                  "SRLG container.";
                leaf srlg {
                  type uint32;
                  description
                    "SRLG value.";
                }
              }
              description
                "An SRLG value to be included or excluded.";
            }
            description
              "Augmentation for a generic explicit route for SRLG
               exclusion.";
          }
        }
      }
    }
  }

  grouping path-route-include-objects {
    description
      "List of route objects to be included when performing
       the path computation.";
    list route-object-include-object {
      key "index";
      ordered-by user;
      description
        "List of Explicit Route Objects to be included in the
         path computation.";
      leaf index {
        type uint32;
        description
          "Route object entry index.  The index is used to
           identify an entry in the list.  The order of entries
           is defined by the user without relying on key values.";
      }
      uses explicit-route-hop;
    }
  }

  grouping path-route-exclude-objects {
    description
      "List of route objects to be excluded when performing
       the path computation.";
    list route-object-exclude-object {
      key "index";
      ordered-by user;
      description
        "List of Explicit Route Objects to be excluded in the
         path computation.";
      leaf index {
        type uint32;
        description
          "Route object entry index.  The index is used to
           identify an entry in the list.  The order of entries
           is defined by the user without relying on key values.";
      }
      uses explicit-route-hop {
        augment "type" {
          case srlg {
            container srlg {
              description
                "SRLG container.";
              leaf srlg {
                type uint32;
                description
                  "SRLG value.";
              }
            }
            description
              "An SRLG value to be included or excluded.";
          }
          description
            "Augmentation for a generic explicit route for SRLG
             exclusion.";
        }
      }
    }
  }

  grouping generic-path-metric-bounds {
    description
      "TE path metric bounds grouping.";
    container path-metric-bounds {
      description
        "TE path metric bounds container.";
      list path-metric-bound {
        key "metric-type";
        description
          "List of TE path metric bounds.";
        leaf metric-type {
          type identityref {
            base path-metric-type;
          }
          description
            "Identifies an entry in the list of 'metric-type' items
             bound for the TE path.";
        }
        leaf upper-bound {
          type uint64;
          default "0";
          description
            "Upper bound on the end-to-end TE path metric.  A zero
             indicates an unbounded upper limit for the specific
             'metric-type'.";
        }
      }
    }
  }

  grouping generic-path-optimization {
    description
      "TE generic path optimization grouping.";
    container optimizations {
      description
        "The objective function container that includes
         attributes to impose when computing a TE path.";
      choice algorithm {
        description
          "Optimizations algorithm.";
        case metric {
          if-feature "path-optimization-metric";
          /* Optimize by metric */
          list optimization-metric {
            key "metric-type";
            description
              "TE path metric type.";
            uses optimization-metric-entry;
          }
          /* Tiebreakers */
          container tiebreakers {
            description
              "Container for the list of tiebreakers.";
            list tiebreaker {
              key "tiebreaker-type";
              description
                "The list of tiebreaker criteria to apply on an
                 equally favored set of paths, in order to pick
                 the best.";
              leaf tiebreaker-type {
                type identityref {
                  base path-metric-type;
                }
                description
                  "Identifies an entry in the list of tiebreakers.";
              }
            }
          }
        }
        case objective-function {
          if-feature "path-optimization-objective-function";
          /* Objective functions */
          container objective-function {
            description
              "The objective function container that includes
               attributes to impose when computing a TE path.";
            leaf objective-function-type {
              type identityref {
                base objective-function-type;
              }
              default "te-types:of-minimize-cost-path";
              description
                "Objective function entry.";
            }
          }
        }
      }
    }
  }

  grouping generic-path-affinities {
    description
      "Path affinities grouping.";
    container path-affinities-values {
      description
        "Path affinities represented as values.";
      list path-affinities-value {
        key "usage";
        description
          "List of named affinity constraints.";
        leaf usage {
          type identityref {
            base resource-affinities-type;
          }
          description
            "Identifies an entry in the list of value affinity
             constraints.";
        }
        leaf value {
          type admin-groups;
          default "";
          description
            "The affinity value.  The default is empty.";
        }
      }
    }
    container path-affinity-names {
      description
        "Path affinities represented as names.";
      list path-affinity-name {
        key "usage";
        description
          "List of named affinity constraints.";
        leaf usage {
          type identityref {
            base resource-affinities-type;
          }
          description
            "Identifies an entry in the list of named affinity
             constraints.";
        }
        list affinity-name {
          key "name";
          leaf name {
            type string;
            description
              "Identifies a named affinity entry.";
          }
          description
            "List of named affinities.";
        }
      }
    }
  }

  grouping generic-path-srlgs {
    description
      "Path SRLG grouping.";
    container path-srlgs-lists {
      description
        "Path SRLG properties container.";
      list path-srlgs-list {
        key "usage";
        description
          "List of SRLG values to be included or excluded.";
        leaf usage {
          type identityref {
            base route-usage-type;
          }
          description
            "Identifies an entry in a list of SRLGs to either
             include or exclude.";
        }
        leaf-list values {
          type srlg;
          description
            "List of SRLG values.";
        }
      }
    }
    container path-srlgs-names {
      description
        "Container for the list of named SRLGs.";
      list path-srlgs-name {
        key "usage";
        description
          "List of named SRLGs to be included or excluded.";
        leaf usage {
          type identityref {
            base route-usage-type;
          }
          description
            "Identifies an entry in a list of named SRLGs to either
             include or exclude.";
        }
        leaf-list names {
          type string;
          description
            "List of named SRLGs.";
        }
      }
    }
  }

  grouping generic-path-disjointness {
    description
      "Path disjointness grouping.";
    leaf disjointness {
      type te-path-disjointness;
      description
        "The type of resource disjointness.
         When configured for a primary path, the disjointness level
         applies to all secondary LSPs.  When configured for a
         secondary path, the disjointness level overrides the level
         configured for the primary path.";
    }
  }

  grouping common-path-constraints-attributes {
    description
      "Common path constraints configuration grouping.";
    uses common-constraints;
    uses generic-path-metric-bounds;
    uses generic-path-affinities;
    uses generic-path-srlgs;
  }

  grouping generic-path-constraints {
    description
      "Global named path constraints configuration grouping.";
    container path-constraints {
      description
        "TE named path constraints container.";
      uses common-path-constraints-attributes;
      uses generic-path-disjointness;
    }
  }

  grouping generic-path-properties {
    description
      "TE generic path properties grouping.";
    container path-properties {
      config false;
      description
        "The TE path properties.";
      list path-metric {
        key "metric-type";
        description
          "TE path metric type.";
        leaf metric-type {
          type identityref {
            base path-metric-type;
          }
          description
            "TE path metric type.";
        }
        leaf accumulative-value {
          type uint64;
          description
            "TE path metric accumulative value.";
        }
      }
      uses generic-path-affinities;
      uses generic-path-srlgs;
      container path-route-objects {
        description
          "Container for the list of route objects either returned by
           the computation engine or actually used by an LSP.";
        list path-route-object {
          key "index";
          ordered-by user;
          description
            "List of route objects either returned by the computation
             engine or actually used by an LSP.";
          leaf index {
            type uint32;
            description
              "Route object entry index.  The index is used to
               identify an entry in the list.  The order of entries
               is defined by the user without relying on key
               values.";
          }
          uses explicit-route-hop;
        }
      }
    }
  }

  // NOTE: The grouping encoding-and-switching-type below has been
  // added in this module revision
  // RFC Editor: remove the note above and this note
  grouping encoding-and-switching-type {
    description
      "Common grouping to define the LSP encoding and
      switching types";
    leaf encoding {
      type identityref {
        base te-types:lsp-encoding-types;
      }
      description
        "LSP encoding type.";
      reference
        "RFC3945";
    }
    leaf switching-type {
      type identityref {
        base te-types:switching-capabilities;
      }
      description
        "LSP switching type.";
      reference
        "RFC3945";
    }
  }
}
]]></sourcecode></figure>

</section>
<section anchor="pkt-yang-code"><name>Packet TE Types YANG Module</name>

<t>The "ietf-te-packet-types" module imports from the "ietf-te-types" module defined in <xref target="te-yang-code"/> of this document.</t>

<t>CHANGE NOTE: Please focus your review only on the updates to the YANG model: see also <xref target="te-yang-diff"/>.</t>

<t>RFC Editor: remove the CHANGE NOTE above and this note</t>

<figure title="Packet TE Types YANG module" anchor="fig-pkt-yang"><sourcecode type="yang" markers="true" name="ietf-te-packet-types@2023-07-10.yang"><![CDATA[
module ietf-te-packet-types {
  yang-version 1.1;
  namespace "urn:ietf:params:xml:ns:yang:ietf-te-packet-types";
  prefix te-packet-types;

  /* Import TE generic types */

  import ietf-te-types {
    prefix te-types;
    reference
      "RFCXXXX: Updated Common YANG Data Types for Traffic 
      Engineering";
  }
  // RFC Editor: replace XXXX with actual RFC number
  // and remove this note

  organization
    "IETF Traffic Engineering Architecture and Signaling (TEAS)
     Working Group";
  contact
    "WG Web:   <https://datatracker.ietf.org/wg/teas/>
     WG List:  <mailto:teas@ietf.org>

     Editor:   Tarek Saad
               <mailto:tsaad.net@gmail.com>

     Editor:   Rakesh Gandhi
               <mailto:rgandhi@cisco.com>

     Editor:   Vishnu Pavan Beeram
               <mailto:vbeeram@juniper.net>

     Editor:   Xufeng Liu
               <mailto:xufeng.liu.ietf@gmail.com>

     Editor:   Igor Bryskin
               <mailto:i_bryskin@yahoo.com>";
  description
    "This YANG module contains a collection of generally useful YANG
     data type definitions specific to MPLS TE.  The model fully
     conforms to the Network Management Datastore Architecture
     (NMDA).

     Copyright (c) 2023 IETF Trust and the persons identified as
     authors of the code.  All rights reserved.

     Redistribution and use in source and binary forms, with or
     without modification, is permitted pursuant to, and subject to
     the license terms contained in, the Revised BSD License set
     forth in Section 4.c of the IETF Trust's Legal Provisions
     Relating to IETF Documents
     (https://trustee.ietf.org/license-info).

     This version of this YANG module is part of RFC XXXX
     (https://www.rfc-editor.org/info/rfcXXXX); see the RFC itself
     for full legal notices.";

  revision 2023-07-10 {
    description
      "Added common TE packet identities:
       - bandwidth-profile-type.

       Added common TE packet groupings:
       - te-packet-path-bandwidth;
       - te-packet-link-bandwidth.";
    reference
      "RFC XXXX: Updated Common YANG Data Types for Traffic
      Engineering";
  }
  // RFC Editor: replace XXXX with actual RFC number, update date
  // information and remove this note

  revision 2020-06-10 {
    description
      "Latest revision of TE MPLS types.";
    reference
      "RFC 8776: Common YANG Data Types for Traffic Engineering";
  }

  /*
   * Identities
   */

  // CHANGE NOTE: The base identity bandwidth-profile-type and 
  // its derived identities below have been
  // added in this module revision
  // RFC Editor: remove the note above and this note
  identity bandwidth-profile-type {
    description
      "Bandwidth Profile Types";
  }

    identity mef-10-bwp {
      base bandwidth-profile-type;
      description
        "MEF 10 Bandwidth Profile";
      reference
        "MEF 10.3: Ethernet Services Attributes Phase 3";
    }

    identity rfc-2697-bwp {
      base bandwidth-profile-type;
      description
        "RFC 2697 Bandwidth Profile";
      reference
        "RFC2697: A Single Rate Three Color Marker";
    }

    identity rfc-2698-bwp {
      base bandwidth-profile-type;
      description
        "RFC 2698 Bandwidth Profile";
      reference
        "RFC2698: A Two Rate Three Color Marker";
    }

    identity rfc-4115-bwp {
      base bandwidth-profile-type;
      description
        "RFC 4115 Bandwidth Profile";
      reference
        "RFC4115: A Differentiated Service Two-Rate, Three-Color 
        Marker with Efficient Handling of in-Profile Traffic";
    }

  /*
   * Typedefs
   */

  typedef te-bandwidth-requested-type {
    type enumeration {
      enum specified {
        description
          "Bandwidth is explicitly specified.";
      }
      enum auto {
        description
          "Bandwidth is automatically computed.";
      }
    }
    description
      "Enumerated type for specifying whether bandwidth is
       explicitly specified or automatically computed.";
  }

  typedef te-class-type {
    type uint8;
    description
      "Diffserv-TE Class-Type.  Defines a set of Traffic Trunks
       crossing a link that is governed by a specific set of
       bandwidth constraints.  Class-Type is used for the purposes
       of link bandwidth allocation, constraint-based routing, and
       admission control.";
    reference
      "RFC 4124: Protocol Extensions for Support of Diffserv-aware
       MPLS Traffic Engineering";
  }

  typedef bc-type {
    type uint8 {
      range "0..7";
    }
    description
      "Diffserv-TE bandwidth constraints as defined in RFC 4124.";
    reference
      "RFC 4124: Protocol Extensions for Support of Diffserv-aware
       MPLS Traffic Engineering";
  }

  typedef bandwidth-kbps {
    type uint64;
    units "Kbps";
    description
      "Bandwidth values, expressed in kilobits per second.";
  }

  typedef bandwidth-mbps {
    type uint64;
    units "Mbps";
    description
      "Bandwidth values, expressed in megabits per second.";
  }

  typedef bandwidth-gbps {
    type uint64;
    units "Gbps";
    description
      "Bandwidth values, expressed in gigabits per second.";
  }

  identity backup-protection-type {
    description
      "Base identity for the backup protection type.";
  }

  identity backup-protection-link {
    base backup-protection-type;
    description
      "Backup provides link protection only.";
  }

  identity backup-protection-node-link {
    base backup-protection-type;
    description
      "Backup offers node (preferred) or link protection.";
  }

  identity bc-model-type {
    description
      "Base identity for the Diffserv-TE Bandwidth Constraints
       Model type.";
    reference
      "RFC 4124: Protocol Extensions for Support of Diffserv-aware
       MPLS Traffic Engineering";
  }

  identity bc-model-rdm {
    base bc-model-type;
    description
      "Russian Dolls Bandwidth Constraints Model type.";
    reference
      "RFC 4127: Russian Dolls Bandwidth Constraints Model for
                 Diffserv-aware MPLS Traffic Engineering";
  }

  identity bc-model-mam {
    base bc-model-type;
    description
      "Maximum Allocation Bandwidth Constraints Model type.";
    reference
      "RFC 4125: Maximum Allocation Bandwidth Constraints Model for
                 Diffserv-aware MPLS Traffic Engineering";
  }

  identity bc-model-mar {
    base bc-model-type;
    description
      "Maximum Allocation with Reservation Bandwidth Constraints
       Model type.";
    reference
      "RFC 4126: Max Allocation with Reservation Bandwidth
       Constraints Model for Diffserv-aware MPLS Traffic Engineering
       & Performance Comparisons";
  }

  /*
   * Groupings
   */

  grouping performance-metrics-attributes-packet {
    description
      "Contains PM attributes.";
    uses te-types:performance-metrics-attributes {
      augment "performance-metrics-one-way" {
        leaf one-way-min-delay {
          type uint32 {
            range "0..16777215";
          }
          description
            "One-way minimum delay or latency in microseconds.";
        }
        leaf one-way-min-delay-normality {
          type te-types:performance-metrics-normality;
          default "normal";
          description
            "One-way minimum delay or latency normality.";
        }
        leaf one-way-max-delay {
          type uint32 {
            range "0..16777215";
          }
          description
            "One-way maximum delay or latency in microseconds.";
        }
        leaf one-way-max-delay-normality {
          type te-types:performance-metrics-normality;
          default "normal";
          description
            "One-way maximum delay or latency normality.";
        }
        leaf one-way-delay-variation {
          type uint32 {
            range "0..16777215";
          }
          description
            "One-way delay variation in microseconds.";
          reference
            "RFC 5481: Packet Delay Variation Applicability
             Statement, Section 4.2";
        }
        leaf one-way-delay-variation-normality {
          type te-types:performance-metrics-normality;
          default "normal";
          description
            "One-way delay variation normality.";
          reference
            "RFC 7471: OSPF Traffic Engineering (TE) Metric
             Extensions
             RFC 7823: Performance-Based Path Selection for
             Explicitly Routed Label Switched Paths (LSPs) Using
             TE Metric Extensions
             RFC 8570: IS-IS Traffic Engineering (TE) Metric
             Extensions";
        }
        leaf one-way-packet-loss {
          type decimal64 {
            fraction-digits 6;
            range "0..50.331642";
          }
          description
            "One-way packet loss as a percentage of the total traffic
             sent over a configurable interval.  The finest precision
             is 0.000003%, where the maximum is 50.331642%.";
          reference
            "RFC 8570: IS-IS Traffic Engineering (TE) Metric
             Extensions, Section 4.4";
        }
        leaf one-way-packet-loss-normality {
          type te-types:performance-metrics-normality;
          default "normal";
          description
            "Packet loss normality.";
          reference
            "RFC 7471: OSPF Traffic Engineering (TE) Metric
             Extensions
             RFC 7823: Performance-Based Path Selection for
             Explicitly Routed Label Switched Paths (LSPs) Using
             TE Metric Extensions
             RFC 8570: IS-IS Traffic Engineering (TE) Metric
             Extensions";
        }
        description
          "PM one-way packet-specific augmentation for a generic PM
           grouping.";
      }
      augment "performance-metrics-two-way" {
        leaf two-way-min-delay {
          type uint32 {
            range "0..16777215";
          }
          default "0";
          description
            "Two-way minimum delay or latency in microseconds.";
        }
        leaf two-way-min-delay-normality {
          type te-types:performance-metrics-normality;
          default "normal";
          description
            "Two-way minimum delay or latency normality.";
          reference
            "RFC 7471: OSPF Traffic Engineering (TE) Metric
             Extensions
             RFC 7823: Performance-Based Path Selection for
             Explicitly Routed Label Switched Paths (LSPs) Using
             TE Metric Extensions
             RFC 8570: IS-IS Traffic Engineering (TE) Metric
             Extensions";
        }
        leaf two-way-max-delay {
          type uint32 {
            range "0..16777215";
          }
          default "0";
          description
            "Two-way maximum delay or latency in microseconds.";
        }
        leaf two-way-max-delay-normality {
          type te-types:performance-metrics-normality;
          default "normal";
          description
            "Two-way maximum delay or latency normality.";
          reference
            "RFC 7471: OSPF Traffic Engineering (TE) Metric
             Extensions
             RFC 7823: Performance-Based Path Selection for
             Explicitly Routed Label Switched Paths (LSPs) Using
             TE Metric Extensions
             RFC 8570: IS-IS Traffic Engineering (TE) Metric
             Extensions";
        }
        leaf two-way-delay-variation {
          type uint32 {
            range "0..16777215";
          }
          default "0";
          description
            "Two-way delay variation in microseconds.";
          reference
            "RFC 5481: Packet Delay Variation Applicability
             Statement, Section 4.2";
        }
        leaf two-way-delay-variation-normality {
          type te-types:performance-metrics-normality;
          default "normal";
          description
            "Two-way delay variation normality.";
          reference
            "RFC 7471: OSPF Traffic Engineering (TE) Metric
             Extensions
             RFC 7823: Performance-Based Path Selection for
             Explicitly Routed Label Switched Paths (LSPs) Using
             TE Metric Extensions
             RFC 8570: IS-IS Traffic Engineering (TE) Metric
             Extensions";
        }
        leaf two-way-packet-loss {
          type decimal64 {
            fraction-digits 6;
            range "0..50.331642";
          }
          default "0";
          description
            "Two-way packet loss as a percentage of the total traffic
             sent over a configurable interval.  The finest precision
             is 0.000003%.";
        }
        leaf two-way-packet-loss-normality {
          type te-types:performance-metrics-normality;
          default "normal";
          description
            "Two-way packet loss normality.";
        }
        description
          "PM two-way packet-specific augmentation for a generic PM
           grouping.";
        reference
          "RFC 7471: OSPF Traffic Engineering (TE) Metric Extensions
           RFC 7823: Performance-Based Path Selection for
           Explicitly Routed Label Switched Paths (LSPs) Using
           TE Metric Extensions
           RFC 8570: IS-IS Traffic Engineering (TE) Metric
           Extensions";
      }
    }
  }

  grouping one-way-performance-metrics-packet {
    description
      "One-way packet PM throttle grouping.";
    leaf one-way-min-delay {
      type uint32 {
        range "0..16777215";
      }
      default "0";
      description
        "One-way minimum delay or latency in microseconds.";
    }
    leaf one-way-max-delay {
      type uint32 {
        range "0..16777215";
      }
      default "0";
      description
        "One-way maximum delay or latency in microseconds.";
    }
    leaf one-way-delay-variation {
      type uint32 {
        range "0..16777215";
      }
      default "0";
      description
        "One-way delay variation in microseconds.";
    }
    leaf one-way-packet-loss {
      type decimal64 {
        fraction-digits 6;
        range "0..50.331642";
      }
      default "0";
      description
        "One-way packet loss as a percentage of the total traffic
         sent over a configurable interval.  The finest precision is
         0.000003%.";
    }
  }

  grouping two-way-performance-metrics-packet {
    description
      "Two-way packet PM throttle grouping.";
    leaf two-way-min-delay {
      type uint32 {
        range "0..16777215";
      }
      default "0";
      description
        "Two-way minimum delay or latency in microseconds.";
    }
    leaf two-way-max-delay {
      type uint32 {
        range "0..16777215";
      }
      default "0";
      description
        "Two-way maximum delay or latency in microseconds.";
    }
    leaf two-way-delay-variation {
      type uint32 {
        range "0..16777215";
      }
      default "0";
      description
        "Two-way delay variation in microseconds.";
    }
    leaf two-way-packet-loss {
      type decimal64 {
        fraction-digits 6;
        range "0..50.331642";
      }
      default "0";
      description
        "Two-way packet loss as a percentage of the total traffic
         sent over a configurable interval.  The finest precision is
         0.000003%.";
    }
  }

  grouping performance-metrics-throttle-container-packet {
    description
      "Packet PM threshold grouping.";
    uses te-types:performance-metrics-throttle-container {
      augment "throttle/threshold-out" {
        uses one-way-performance-metrics-packet;
        uses two-way-performance-metrics-packet;
        description
          "PM threshold-out packet augmentation for a
           generic grouping.";
      }
      augment "throttle/threshold-in" {
        uses one-way-performance-metrics-packet;
        uses two-way-performance-metrics-packet;
        description
          "PM threshold-in packet augmentation for a
           generic grouping.";
      }
      augment "throttle/threshold-accelerated-advertisement" {
        uses one-way-performance-metrics-packet;
        uses two-way-performance-metrics-packet;
        description
          "PM accelerated advertisement packet augmentation for a
           generic grouping.";
      }
    }
  }

  // CHANGE NOTE: The te-packet-path-bandwidth below has been
  // added in this module revision
  // RFC Editor: remove the note above and this note
  grouping te-packet-path-bandwidth {
    description
      "Path bandwidth for Packet. ";
    leaf bandwidth-profile-name {
      type string;
      description "Name of Bandwidth Profile.";
    }
    leaf bandwidth-profile-type {
      type identityref {
        base bandwidth-profile-type;
      }
      description "Type of Bandwidth Profile.";
    }
    leaf cir {
      type uint64;
      units "bits/second";
      mandatory true;
      description
        "Committed Information Rate (CIR).";
    }
    leaf cbs {
      type uint64;
      units "bits/second";
      mandatory true;
      description
        "Committed Burst Size (CBS).";
    }
    leaf eir {
      type uint64;
      units "bits/second";
      description
        "Excess Information Rate (EIR).";
    }
    leaf ebs {
      type uint64;
      units "bytes";
      description
        "Excess Burst Size (EBS).";
    }
    leaf pir {
      type uint64;
      units "bits/second";
      description
        "Peak Information Rate (PIR).";
    }
    leaf pbs {
      type uint64;
      units "bytes";
      description
        "Peak Burst Size (PBS).";
    }
  }

  // CHANGE NOTE: The te-packet-path-bandwidth below has been
  // added in this module revision
  // RFC Editor: remove the note above and this note
  grouping te-packet-link-bandwidth {
    description
      "Link Bandwidth for Packet. ";
    leaf packet-bandwidth {
      type uint64;
      units "bits/second";
      description
        "Available bandwith value.";
    }
  }
}
]]></sourcecode></figure>

</section>
<section anchor="iana-considerations"><name>IANA Considerations</name>

<t>For the following URIs in the "IETF XML Registry" <xref target="RFC3688"/>, IANA has updated the reference field to refer to this document:</t>

<figure><artwork><![CDATA[
      URI: urn:ietf:params:xml:ns:yang:ietf-te-types
      Registrant Contact:  The IESG.
      XML: N/A, the requested URI is an XML namespace.

      URI: urn:ietf:params:xml:ns:yang:ietf-te-packet-types
      Registrant Contact:  The IESG.
      XML: N/A, the requested URI is an XML namespace.
]]></artwork></figure>

<t>This document also adds updated YANG modules to the "YANG Module
Names" registry <xref target="RFC7950"/>:</t>

<figure><artwork><![CDATA[
      name:      ietf-te-types
      namespace: urn:ietf:params:xml:ns:yang:ietf-te-types
      prefix:    te-types
      reference: RFC XXXX

      name:      ietf-te-packet-types
      namespace: urn:ietf:params:xml:ns:yang:ietf-te-packet-types
      prefix:    te-packet-types
      reference: RFC XXXX
]]></artwork></figure>

<t>RFC Editor: Please replace XXXX with the RFC number assigned to this document.</t>

</section>
<section anchor="security-considerations"><name>Security Considerations</name>

<t>The YANG module specified in this document defines a schema for data
   that is designed to be accessed via network management protocols such
   as NETCONF <xref target="RFC6241"/> or RESTCONF <xref target="RFC8040"/>.  The lowest NETCONF layer
   is the secure transport layer, and the mandatory-to-implement secure
   transport is Secure Shell (SSH) <xref target="RFC6242"/>.  The lowest RESTCONF layer
   is HTTPS, and the mandatory-to-implement secure transport is TLS
   <xref target="RFC8446"/>.</t>

<t>The Network Configuration Access Control Model (NACM) <xref target="RFC8341"/>
   provides the means to restrict access for particular NETCONF or
   RESTCONF users to a preconfigured subset of all available NETCONF or
   RESTCONF protocol operations and content.</t>

<t>The YANG module in this document defines common TE type definitions
   (e.g., typedef, identity, and grouping statements) in YANG data
   modeling language to be imported and used by other TE modules.  When
   imported and used, the resultant schema will have data nodes that can
   be writable or readable.  Access to such data nodes may be considered
   sensitive or vulnerable in some network environments.  Write
   operations (e.g., edit-config) to these data nodes without proper
   protection can have a negative effect on network operations.</t>

<t>The security considerations spelled out in the YANG 1.1 specification
   <xref target="RFC7950"/> apply for this document as well.</t>

</section>


  </middle>

  <back>


    <references title='Normative References'>

<reference anchor="ITU_G.808.1" >
  <front>
    <title>Generic protection switching - Linear trail and subnetwork protection</title>
    <author >
      <organization>ITU-T Recommendation G.808.1</organization>
    </author>
    <date year="2014" month="May"/>
  </front>
  <seriesInfo name="ITU-T G.808.1" value=""/>
</reference>


<reference anchor='RFC6020' target='https://www.rfc-editor.org/info/rfc6020'>
  <front>
    <title>YANG - A Data Modeling Language for the Network Configuration Protocol (NETCONF)</title>
    <author fullname='M. Bjorklund' initials='M.' role='editor' surname='Bjorklund'/>
    <date month='October' year='2010'/>
    <abstract>
      <t>YANG is a data modeling language used to model configuration and state data manipulated by the Network Configuration Protocol (NETCONF), NETCONF remote procedure calls, and NETCONF notifications. [STANDARDS-TRACK]</t>
    </abstract>
  </front>
  <seriesInfo name='RFC' value='6020'/>
  <seriesInfo name='DOI' value='10.17487/RFC6020'/>
</reference>

<reference anchor='RFC7950' target='https://www.rfc-editor.org/info/rfc7950'>
  <front>
    <title>The YANG 1.1 Data Modeling Language</title>
    <author fullname='M. Bjorklund' initials='M.' role='editor' surname='Bjorklund'/>
    <date month='August' year='2016'/>
    <abstract>
      <t>YANG is a data modeling language used to model configuration data, state data, Remote Procedure Calls, and notifications for network management protocols. This document describes the syntax and semantics of version 1.1 of the YANG language. YANG version 1.1 is a maintenance release of the YANG language, addressing ambiguities and defects in the original specification. There are a small number of backward incompatibilities from YANG version 1. This document also specifies the YANG mappings to the Network Configuration Protocol (NETCONF).</t>
    </abstract>
  </front>
  <seriesInfo name='RFC' value='7950'/>
  <seriesInfo name='DOI' value='10.17487/RFC7950'/>
</reference>

<reference anchor='RFC6241' target='https://www.rfc-editor.org/info/rfc6241'>
  <front>
    <title>Network Configuration Protocol (NETCONF)</title>
    <author fullname='R. Enns' initials='R.' role='editor' surname='Enns'/>
    <author fullname='M. Bjorklund' initials='M.' role='editor' surname='Bjorklund'/>
    <author fullname='J. Schoenwaelder' initials='J.' role='editor' surname='Schoenwaelder'/>
    <author fullname='A. Bierman' initials='A.' role='editor' surname='Bierman'/>
    <date month='June' year='2011'/>
    <abstract>
      <t>The Network Configuration Protocol (NETCONF) defined in this document provides mechanisms to install, manipulate, and delete the configuration of network devices. It uses an Extensible Markup Language (XML)-based data encoding for the configuration data as well as the protocol messages. The NETCONF protocol operations are realized as remote procedure calls (RPCs). This document obsoletes RFC 4741. [STANDARDS-TRACK]</t>
    </abstract>
  </front>
  <seriesInfo name='RFC' value='6241'/>
  <seriesInfo name='DOI' value='10.17487/RFC6241'/>
</reference>

<reference anchor='RFC8776' target='https://www.rfc-editor.org/info/rfc8776'>
  <front>
    <title>Common YANG Data Types for Traffic Engineering</title>
    <author fullname='T. Saad' initials='T.' surname='Saad'/>
    <author fullname='R. Gandhi' initials='R.' surname='Gandhi'/>
    <author fullname='X. Liu' initials='X.' surname='Liu'/>
    <author fullname='V. Beeram' initials='V.' surname='Beeram'/>
    <author fullname='I. Bryskin' initials='I.' surname='Bryskin'/>
    <date month='June' year='2020'/>
    <abstract>
      <t>This document defines a collection of common data types and groupings in YANG data modeling language. These derived common types and groupings are intended to be imported by modules that model Traffic Engineering (TE) configuration and state capabilities.</t>
    </abstract>
  </front>
  <seriesInfo name='RFC' value='8776'/>
  <seriesInfo name='DOI' value='10.17487/RFC8776'/>
</reference>

<reference anchor='RFC2119' target='https://www.rfc-editor.org/info/rfc2119'>
  <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='RFC8174' target='https://www.rfc-editor.org/info/rfc8174'>
  <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='RFC6991' target='https://www.rfc-editor.org/info/rfc6991'>
  <front>
    <title>Common YANG Data Types</title>
    <author fullname='J. Schoenwaelder' initials='J.' role='editor' surname='Schoenwaelder'/>
    <date month='July' year='2013'/>
    <abstract>
      <t>This document introduces a collection of common data types to be used with the YANG data modeling language. This document obsoletes RFC 6021.</t>
    </abstract>
  </front>
  <seriesInfo name='RFC' value='6991'/>
  <seriesInfo name='DOI' value='10.17487/RFC6991'/>
</reference>

<reference anchor='RFC8294' target='https://www.rfc-editor.org/info/rfc8294'>
  <front>
    <title>Common YANG Data Types for the Routing Area</title>
    <author fullname='X. Liu' initials='X.' surname='Liu'/>
    <author fullname='Y. Qu' initials='Y.' surname='Qu'/>
    <author fullname='A. Lindem' initials='A.' surname='Lindem'/>
    <author fullname='C. Hopps' initials='C.' surname='Hopps'/>
    <author fullname='L. Berger' initials='L.' surname='Berger'/>
    <date month='December' year='2017'/>
    <abstract>
      <t>This document defines a collection of common data types using the YANG data modeling language. These derived common types are designed to be imported by other modules defined in the routing area.</t>
    </abstract>
  </front>
  <seriesInfo name='RFC' value='8294'/>
  <seriesInfo name='DOI' value='10.17487/RFC8294'/>
</reference>

<reference anchor='RFC8345' target='https://www.rfc-editor.org/info/rfc8345'>
  <front>
    <title>A YANG Data Model for Network Topologies</title>
    <author fullname='A. Clemm' initials='A.' surname='Clemm'/>
    <author fullname='J. Medved' initials='J.' surname='Medved'/>
    <author fullname='R. Varga' initials='R.' surname='Varga'/>
    <author fullname='N. Bahadur' initials='N.' surname='Bahadur'/>
    <author fullname='H. Ananthakrishnan' initials='H.' surname='Ananthakrishnan'/>
    <author fullname='X. Liu' initials='X.' surname='Liu'/>
    <date month='March' year='2018'/>
    <abstract>
      <t>This document defines an abstract (generic, or base) YANG data model for network/service topologies and inventories. The data model serves as a base model that is augmented with technology-specific details in other, more specific topology and inventory data models.</t>
    </abstract>
  </front>
  <seriesInfo name='RFC' value='8345'/>
  <seriesInfo name='DOI' value='10.17487/RFC8345'/>
</reference>

<reference anchor='RFC8800' target='https://www.rfc-editor.org/info/rfc8800'>
  <front>
    <title>Path Computation Element Communication Protocol (PCEP) Extension for Label Switched Path (LSP) Diversity Constraint Signaling</title>
    <author fullname='S. Litkowski' initials='S.' surname='Litkowski'/>
    <author fullname='S. Sivabalan' initials='S.' surname='Sivabalan'/>
    <author fullname='C. Barth' initials='C.' surname='Barth'/>
    <author fullname='M. Negi' initials='M.' surname='Negi'/>
    <date month='July' year='2020'/>
    <abstract>
      <t>This document introduces a simple mechanism to associate a group of Label Switched Paths (LSPs) via an extension to the Path Computation Element Communication Protocol (PCEP) with the purpose of computing diverse (disjointed) paths for those LSPs. The proposed extension allows a Path Computation Client (PCC) to advertise to a Path Computation Element (PCE) that a particular LSP belongs to a particular Disjoint Association Group; thus, the PCE knows that the LSPs in the same group need to be disjoint from each other.</t>
    </abstract>
  </front>
  <seriesInfo name='RFC' value='8800'/>
  <seriesInfo name='DOI' value='10.17487/RFC8800'/>
</reference>

<reference anchor='RFC5541' target='https://www.rfc-editor.org/info/rfc5541'>
  <front>
    <title>Encoding of Objective Functions in the Path Computation Element Communication Protocol (PCEP)</title>
    <author fullname='JL. Le Roux' initials='JL.' surname='Le Roux'/>
    <author fullname='JP. Vasseur' initials='JP.' surname='Vasseur'/>
    <author fullname='Y. Lee' initials='Y.' surname='Lee'/>
    <date month='June' year='2009'/>
    <abstract>
      <t>The computation of one or a set of Traffic Engineering Label Switched Paths (TE LSPs) in MultiProtocol Label Switching (MPLS) and Generalized MPLS (GMPLS) networks is subject to a set of one or more specific optimization criteria, referred to as objective functions (e.g., minimum cost path, widest path, etc.).</t>
      <t>In the Path Computation Element (PCE) architecture, a Path Computation Client (PCC) may want a path to be computed for one or more TE LSPs according to a specific objective function. Thus, the PCC needs to instruct the PCE to use the correct objective function. Furthermore, it is possible that not all PCEs support the same set of objective functions; therefore, it is useful for the PCC to be able to automatically discover the set of objective functions supported by each PCE.</t>
      <t>This document defines extensions to the PCE communication Protocol (PCEP) to allow a PCE to indicate the set of objective functions it supports. Extensions are also defined so that a PCC can indicate in a path computation request the required objective function, and a PCE can report in a path computation reply the objective function that was used for path computation.</t>
      <t>This document defines objective function code types for six objective functions previously listed in the PCE requirements work, and provides the definition of four new metric types that apply to a set of synchronized requests. [STANDARDS-TRACK]</t>
    </abstract>
  </front>
  <seriesInfo name='RFC' value='5541'/>
  <seriesInfo name='DOI' value='10.17487/RFC5541'/>
</reference>

<reference anchor='RFC8685' target='https://www.rfc-editor.org/info/rfc8685'>
  <front>
    <title>Path Computation Element Communication Protocol (PCEP) Extensions for the Hierarchical Path Computation Element (H-PCE) Architecture</title>
    <author fullname='F. Zhang' initials='F.' surname='Zhang'/>
    <author fullname='Q. Zhao' initials='Q.' surname='Zhao'/>
    <author fullname='O. Gonzalez de Dios' initials='O.' surname='Gonzalez de Dios'/>
    <author fullname='R. Casellas' initials='R.' surname='Casellas'/>
    <author fullname='D. King' initials='D.' surname='King'/>
    <date month='December' year='2019'/>
    <abstract>
      <t>The Hierarchical Path Computation Element (H-PCE) architecture is defined in RFC 6805. It provides a mechanism to derive an optimum end-to-end path in a multi-domain environment by using a hierarchical relationship between domains to select the optimum sequence of domains and optimum paths across those domains.</t>
      <t>This document defines extensions to the Path Computation Element Communication Protocol (PCEP) to support H-PCE procedures.</t>
    </abstract>
  </front>
  <seriesInfo name='RFC' value='8685'/>
  <seriesInfo name='DOI' value='10.17487/RFC8685'/>
</reference>

<reference anchor='RFC5440' target='https://www.rfc-editor.org/info/rfc5440'>
  <front>
    <title>Path Computation Element (PCE) Communication Protocol (PCEP)</title>
    <author fullname='JP. Vasseur' initials='JP.' role='editor' surname='Vasseur'/>
    <author fullname='JL. Le Roux' initials='JL.' role='editor' surname='Le Roux'/>
    <date month='March' year='2009'/>
    <abstract>
      <t>This document specifies the Path Computation Element (PCE) Communication Protocol (PCEP) for communications between a Path Computation Client (PCC) and a PCE, or between two PCEs. Such interactions include path computation requests and path computation replies as well as notifications of specific states related to the use of a PCE in the context of Multiprotocol Label Switching (MPLS) and Generalized MPLS (GMPLS) Traffic Engineering. PCEP is designed to be flexible and extensible so as to easily allow for the addition of further messages and objects, should further requirements be expressed in the future. [STANDARDS-TRACK]</t>
    </abstract>
  </front>
  <seriesInfo name='RFC' value='5440'/>
  <seriesInfo name='DOI' value='10.17487/RFC5440'/>
</reference>

<reference anchor='RFC5441' target='https://www.rfc-editor.org/info/rfc5441'>
  <front>
    <title>A Backward-Recursive PCE-Based Computation (BRPC) Procedure to Compute Shortest Constrained Inter-Domain Traffic Engineering Label Switched Paths</title>
    <author fullname='JP. Vasseur' initials='JP.' role='editor' surname='Vasseur'/>
    <author fullname='R. Zhang' initials='R.' surname='Zhang'/>
    <author fullname='N. Bitar' initials='N.' surname='Bitar'/>
    <author fullname='JL. Le Roux' initials='JL.' surname='Le Roux'/>
    <date month='April' year='2009'/>
    <abstract>
      <t>The ability to compute shortest constrained Traffic Engineering Label Switched Paths (TE LSPs) in Multiprotocol Label Switching (MPLS) and Generalized MPLS (GMPLS) networks across multiple domains has been identified as a key requirement. In this context, a domain is a collection of network elements within a common sphere of address management or path computational responsibility such as an IGP area or an Autonomous Systems. This document specifies a procedure relying on the use of multiple Path Computation Elements (PCEs) to compute such inter-domain shortest constrained paths across a predetermined sequence of domains, using a backward-recursive path computation technique. This technique preserves confidentiality across domains, which is sometimes required when domains are managed by different service providers. [STANDARDS-TRACK]</t>
    </abstract>
  </front>
  <seriesInfo name='RFC' value='5441'/>
  <seriesInfo name='DOI' value='10.17487/RFC5441'/>
</reference>

<reference anchor='RFC5520' target='https://www.rfc-editor.org/info/rfc5520'>
  <front>
    <title>Preserving Topology Confidentiality in Inter-Domain Path Computation Using a Path-Key-Based Mechanism</title>
    <author fullname='R. Bradford' initials='R.' role='editor' surname='Bradford'/>
    <author fullname='JP. Vasseur' initials='JP.' surname='Vasseur'/>
    <author fullname='A. Farrel' initials='A.' surname='Farrel'/>
    <date month='April' year='2009'/>
    <abstract>
      <t>Multiprotocol Label Switching (MPLS) and Generalized MPLS (GMPLS) Traffic Engineering (TE) Label Switched Paths (LSPs) may be computed by Path Computation Elements (PCEs). Where the TE LSP crosses multiple domains, such as Autonomous Systems (ASes), the path may be computed by multiple PCEs that cooperate, with each responsible for computing a segment of the path. However, in some cases (e.g., when ASes are administered by separate Service Providers), it would break confidentiality rules for a PCE to supply a path segment to a PCE in another domain, thus disclosing AS-internal topology information. This issue may be circumvented by returning a loose hop and by invoking a new path computation from the domain boundary Label Switching Router (LSR) during TE LSP setup as the signaling message enters the second domain, but this technique has several issues including the problem of maintaining path diversity.</t>
      <t>This document defines a mechanism to hide the contents of a segment of a path, called the Confidential Path Segment (CPS). The CPS may be replaced by a path-key that can be conveyed in the PCE Communication Protocol (PCEP) and signaled within in a Resource Reservation Protocol TE (RSVP-TE) explicit route object. [STANDARDS-TRACK]</t>
    </abstract>
  </front>
  <seriesInfo name='RFC' value='5520'/>
  <seriesInfo name='DOI' value='10.17487/RFC5520'/>
</reference>

<reference anchor='RFC5557' target='https://www.rfc-editor.org/info/rfc5557'>
  <front>
    <title>Path Computation Element Communication Protocol (PCEP) Requirements and Protocol Extensions in Support of Global Concurrent Optimization</title>
    <author fullname='Y. Lee' initials='Y.' surname='Lee'/>
    <author fullname='JL. Le Roux' initials='JL.' surname='Le Roux'/>
    <author fullname='D. King' initials='D.' surname='King'/>
    <author fullname='E. Oki' initials='E.' surname='Oki'/>
    <date month='July' year='2009'/>
    <abstract>
      <t>The Path Computation Element Communication Protocol (PCEP) allows Path Computation Clients (PCCs) to request path computations from Path Computation Elements (PCEs), and lets the PCEs return responses. When computing or reoptimizing the routes of a set of Traffic Engineering Label Switched Paths (TE LSPs) through a network, it may be advantageous to perform bulk path computations in order to avoid blocking problems and to achieve more optimal network-wide solutions. Such bulk optimization is termed Global Concurrent Optimization (GCO). A GCO is able to simultaneously consider the entire topology of the network and the complete set of existing TE LSPs, and their respective constraints, and look to optimize or reoptimize the entire network to satisfy all constraints for all TE LSPs. A GCO may also be applied to some subset of the TE LSPs in a network. The GCO application is primarily a Network Management System (NMS) solution.</t>
      <t>This document provides application-specific requirements and the PCEP extensions in support of GCO applications. [STANDARDS-TRACK]</t>
    </abstract>
  </front>
  <seriesInfo name='RFC' value='5557'/>
  <seriesInfo name='DOI' value='10.17487/RFC5557'/>
</reference>

<reference anchor='RFC8306' target='https://www.rfc-editor.org/info/rfc8306'>
  <front>
    <title>Extensions to the Path Computation Element Communication Protocol (PCEP) for Point-to-Multipoint Traffic Engineering Label Switched Paths</title>
    <author fullname='Q. Zhao' initials='Q.' surname='Zhao'/>
    <author fullname='D. Dhody' initials='D.' role='editor' surname='Dhody'/>
    <author fullname='R. Palleti' initials='R.' surname='Palleti'/>
    <author fullname='D. King' initials='D.' surname='King'/>
    <date month='November' year='2017'/>
    <abstract>
      <t>Point-to-point Multiprotocol Label Switching (MPLS) and Generalized MPLS (GMPLS) Traffic Engineering Label Switched Paths (TE LSPs) may be established using signaling techniques, but their paths may first need to be determined. The Path Computation Element (PCE) has been identified as an appropriate technology for the determination of the paths of point-to-multipoint (P2MP) TE LSPs.</t>
      <t>This document describes extensions to the PCE Communication Protocol (PCEP) to handle requests and responses for the computation of paths for P2MP TE LSPs.</t>
      <t>This document obsoletes RFC 6006.</t>
    </abstract>
  </front>
  <seriesInfo name='RFC' value='8306'/>
  <seriesInfo name='DOI' value='10.17487/RFC8306'/>
</reference>

<reference anchor='RFC9012' target='https://www.rfc-editor.org/info/rfc9012'>
  <front>
    <title>The BGP Tunnel Encapsulation Attribute</title>
    <author fullname='K. Patel' initials='K.' surname='Patel'/>
    <author fullname='G. Van de Velde' initials='G.' surname='Van de Velde'/>
    <author fullname='S. Sangli' initials='S.' surname='Sangli'/>
    <author fullname='J. Scudder' initials='J.' surname='Scudder'/>
    <date month='April' year='2021'/>
    <abstract>
      <t>This document defines a BGP path attribute known as the "Tunnel Encapsulation attribute", which can be used with BGP UPDATEs of various Subsequent Address Family Identifiers (SAFIs) to provide information needed to create tunnels and their corresponding encapsulation headers. It provides encodings for a number of tunnel types, along with procedures for choosing between alternate tunnels and routing packets into tunnels.</t>
      <t>This document obsoletes RFC 5512, which provided an earlier definition of the Tunnel Encapsulation attribute. RFC 5512 was never deployed in production. Since RFC 5566 relies on RFC 5512, it is likewise obsoleted. This document updates RFC 5640 by indicating that the Load-Balancing Block sub-TLV may be included in any Tunnel Encapsulation attribute where load balancing is desired.</t>
    </abstract>
  </front>
  <seriesInfo name='RFC' value='9012'/>
  <seriesInfo name='DOI' value='10.17487/RFC9012'/>
</reference>

<reference anchor='RFC8040' target='https://www.rfc-editor.org/info/rfc8040'>
  <front>
    <title>RESTCONF Protocol</title>
    <author fullname='A. Bierman' initials='A.' surname='Bierman'/>
    <author fullname='M. Bjorklund' initials='M.' surname='Bjorklund'/>
    <author fullname='K. Watsen' initials='K.' surname='Watsen'/>
    <date month='January' year='2017'/>
    <abstract>
      <t>This document describes an HTTP-based protocol that provides a programmatic interface for accessing data defined in YANG, using the datastore concepts defined in the Network Configuration Protocol (NETCONF).</t>
    </abstract>
  </front>
  <seriesInfo name='RFC' value='8040'/>
  <seriesInfo name='DOI' value='10.17487/RFC8040'/>
</reference>

<reference anchor='RFC6242' target='https://www.rfc-editor.org/info/rfc6242'>
  <front>
    <title>Using the NETCONF Protocol over Secure Shell (SSH)</title>
    <author fullname='M. Wasserman' initials='M.' surname='Wasserman'/>
    <date month='June' year='2011'/>
    <abstract>
      <t>This document describes a method for invoking and running the Network Configuration Protocol (NETCONF) within a Secure Shell (SSH) session as an SSH subsystem. This document obsoletes RFC 4742. [STANDARDS-TRACK]</t>
    </abstract>
  </front>
  <seriesInfo name='RFC' value='6242'/>
  <seriesInfo name='DOI' value='10.17487/RFC6242'/>
</reference>

<reference anchor='RFC8446' target='https://www.rfc-editor.org/info/rfc8446'>
  <front>
    <title>The Transport Layer Security (TLS) Protocol Version 1.3</title>
    <author fullname='E. Rescorla' initials='E.' surname='Rescorla'/>
    <date month='August' year='2018'/>
    <abstract>
      <t>This document specifies version 1.3 of the Transport Layer Security (TLS) protocol. TLS allows client/server applications to communicate over the Internet in a way that is designed to prevent eavesdropping, tampering, and message forgery.</t>
      <t>This document updates RFCs 5705 and 6066, and obsoletes RFCs 5077, 5246, and 6961. This document also specifies new requirements for TLS 1.2 implementations.</t>
    </abstract>
  </front>
  <seriesInfo name='RFC' value='8446'/>
  <seriesInfo name='DOI' value='10.17487/RFC8446'/>
</reference>

<reference anchor='RFC8341' target='https://www.rfc-editor.org/info/rfc8341'>
  <front>
    <title>Network Configuration Access Control Model</title>
    <author fullname='A. Bierman' initials='A.' surname='Bierman'/>
    <author fullname='M. Bjorklund' initials='M.' surname='Bjorklund'/>
    <date month='March' year='2018'/>
    <abstract>
      <t>The standardization of network configuration interfaces for use with the Network Configuration Protocol (NETCONF) or the RESTCONF protocol requires a structured and secure operating environment that promotes human usability and multi-vendor interoperability. There is a need for standard mechanisms to restrict NETCONF or RESTCONF protocol access for particular users to a preconfigured subset of all available NETCONF or RESTCONF protocol operations and content. This document defines such an access control model.</t>
      <t>This document obsoletes RFC 6536.</t>
    </abstract>
  </front>
  <seriesInfo name='STD' value='91'/>
  <seriesInfo name='RFC' value='8341'/>
  <seriesInfo name='DOI' value='10.17487/RFC8341'/>
</reference>




    </references>

    <references title='Informative References'>

<reference anchor="MEF_10.3" >
  <front>
    <title>Ethernet Services Attributes Phase 3</title>
    <author >
      <organization>MEF</organization>
    </author>
    <date year="2013" month="October"/>
  </front>
  <seriesInfo name="MEF 10.3" value=""/>
</reference>
<reference anchor="ITU-T_G.709" >
  <front>
    <title>Interfaces for the optical transport network</title>
    <author >
      <organization>International Telecommunication Union</organization>
    </author>
    <date year="2020" month="June"/>
  </front>
  <seriesInfo name="ITU-T G.709" value=""/>
</reference>



<reference anchor='I-D.ietf-teas-yang-te' target='https://datatracker.ietf.org/doc/html/draft-ietf-teas-yang-te-33'>
   <front>
      <title>A YANG Data Model for Traffic Engineering Tunnels, Label Switched Paths and Interfaces</title>
      <author fullname='Tarek Saad' initials='T.' surname='Saad'>
         <organization>Cisco Systems Inc</organization>
      </author>
      <author fullname='Rakesh Gandhi' initials='R.' surname='Gandhi'>
         <organization>Cisco Systems Inc</organization>
      </author>
      <author fullname='Xufeng Liu' initials='X.' surname='Liu'>
         <organization>Alef Edge</organization>
      </author>
      <author fullname='Vishnu Pavan Beeram' initials='V. P.' surname='Beeram'>
         <organization>Juniper Networks</organization>
      </author>
      <author fullname='Igor Bryskin' initials='I.' surname='Bryskin'>
         <organization>Individual</organization>
      </author>
      <author fullname='Oscar Gonzalez de Dios' initials='O. G.' surname='de Dios'>
         <organization>Telefonica</organization>
      </author>
      <date day='4' month='July' year='2023'/>
      <abstract>
	 <t>   This document defines a YANG data model for the provisioning and
   management of Traffic Engineering (TE) tunnels, Label Switched Paths
   (LSPs), and interfaces.  The model covers data that is independent of
   any technology or dataplane encapsulation and is divided into two
   YANG modules that cover device-specific, and device independent data.

   This model covers data for configuration, operational state, remote
   procedural calls, and event notifications.

	 </t>
      </abstract>
   </front>
   <seriesInfo name='Internet-Draft' value='draft-ietf-teas-yang-te-33'/>
   
</reference>


<reference anchor='I-D.ietf-teas-yang-path-computation' target='https://datatracker.ietf.org/doc/html/draft-ietf-teas-yang-path-computation-21'>
   <front>
      <title>A YANG Data Model for requesting path computation</title>
      <author fullname='Italo Busi' initials='I.' surname='Busi'>
         <organization>Huawei Technologies</organization>
      </author>
      <author fullname='Sergio Belotti' initials='S.' surname='Belotti'>
         <organization>Nokia</organization>
      </author>
      <author fullname='Oscar Gonzalez de Dios' initials='O. G.' surname='de Dios'>
         <organization>Telefonica</organization>
      </author>
      <author fullname='Anurag Sharma' initials='A.' surname='Sharma'>
         <organization>Google</organization>
      </author>
      <author fullname='Yan Shi' initials='Y.' surname='Shi'>
         <organization>China Unicom</organization>
      </author>
      <date day='7' month='July' year='2023'/>
      <abstract>
	 <t>   There are scenarios, typically in a hierarchical Software-Defined
   Networking (SDN) context, where the topology information provided by
   a Traffic Engineering (TE) network provider may be insufficient for
   its client to perform multi-domain path computation.  In these cases
   the client would need to request the TE network provider to compute
   some intra-domain paths to be used by the client to choose the
   optimal multi-domain paths.

   This document provides a mechanism to request path computation by
   augmenting the Remote Procedure Calls (RPCs) defined in RFC YYYY.

   [RFC EDITOR NOTE: Please replace RFC YYYY with the RFC number of
   draft-ietf-teas-yang-te once it has been published.

   Moreover, this document describes some use cases where the path
   computation request, via YANG-based protocols (e.g., NETCONF or
   RESTCONF), can be needed.

	 </t>
      </abstract>
   </front>
   <seriesInfo name='Internet-Draft' value='draft-ietf-teas-yang-path-computation-21'/>
   
</reference>


<reference anchor='I-D.ietf-teas-yang-l3-te-topo' target='https://datatracker.ietf.org/doc/html/draft-ietf-teas-yang-l3-te-topo-14'>
   <front>
      <title>YANG Data Model for Layer 3 TE Topologies</title>
      <author fullname='Xufeng Liu' initials='X.' surname='Liu'>
         <organization>IBM Corporation</organization>
      </author>
      <author fullname='Igor Bryskin' initials='I.' surname='Bryskin'>
         <organization>Individual</organization>
      </author>
      <author fullname='Vishnu Pavan Beeram' initials='V. P.' surname='Beeram'>
         <organization>Juniper Networks</organization>
      </author>
      <author fullname='Tarek Saad' initials='T.' surname='Saad'>
         <organization>Cisco Systems Inc</organization>
      </author>
      <author fullname='Himanshu C. Shah' initials='H. C.' surname='Shah'>
         <organization>Ciena</organization>
      </author>
      <author fullname='Oscar Gonzalez de Dios' initials='O. G.' surname='de Dios'>
         <organization>Telefonica</organization>
      </author>
      <date day='12' month='March' year='2023'/>
      <abstract>
	 <t>   This document defines a YANG data model for layer 3 traffic
   engineering topologies.

	 </t>
      </abstract>
   </front>
   <seriesInfo name='Internet-Draft' value='draft-ietf-teas-yang-l3-te-topo-14'/>
   
</reference>

<reference anchor='RFC7471' target='https://www.rfc-editor.org/info/rfc7471'>
  <front>
    <title>OSPF Traffic Engineering (TE) Metric Extensions</title>
    <author fullname='S. Giacalone' initials='S.' surname='Giacalone'/>
    <author fullname='D. Ward' initials='D.' surname='Ward'/>
    <author fullname='J. Drake' initials='J.' surname='Drake'/>
    <author fullname='A. Atlas' initials='A.' surname='Atlas'/>
    <author fullname='S. Previdi' initials='S.' surname='Previdi'/>
    <date month='March' year='2015'/>
    <abstract>
      <t>In certain networks, such as, but not limited to, financial information networks (e.g., stock market data providers), network performance information (e.g., link propagation delay) is becoming critical to data path selection.</t>
      <t>This document describes common extensions to RFC 3630 "Traffic Engineering (TE) Extensions to OSPF Version 2" and RFC 5329 "Traffic Engineering Extensions to OSPF Version 3" to enable network performance information to be distributed in a scalable fashion. The information distributed using OSPF TE Metric Extensions can then be used to make path selection decisions based on network performance.</t>
      <t>Note that this document only covers the mechanisms by which network performance information is distributed. The mechanisms for measuring network performance information or using that information, once distributed, are outside the scope of this document.</t>
    </abstract>
  </front>
  <seriesInfo name='RFC' value='7471'/>
  <seriesInfo name='DOI' value='10.17487/RFC7471'/>
</reference>

<reference anchor='RFC8570' target='https://www.rfc-editor.org/info/rfc8570'>
  <front>
    <title>IS-IS Traffic Engineering (TE) Metric Extensions</title>
    <author fullname='L. Ginsberg' initials='L.' role='editor' surname='Ginsberg'/>
    <author fullname='S. Previdi' initials='S.' role='editor' surname='Previdi'/>
    <author fullname='S. Giacalone' initials='S.' surname='Giacalone'/>
    <author fullname='D. Ward' initials='D.' surname='Ward'/>
    <author fullname='J. Drake' initials='J.' surname='Drake'/>
    <author fullname='Q. Wu' initials='Q.' surname='Wu'/>
    <date month='March' year='2019'/>
    <abstract>
      <t>In certain networks, such as, but not limited to, financial information networks (e.g., stock market data providers), network-performance criteria (e.g., latency) are becoming as critical to data-path selection as other metrics.</t>
      <t>This document describes extensions to IS-IS Traffic Engineering Extensions (RFC 5305). These extensions provide a way to distribute and collect network-performance information in a scalable fashion. The information distributed using IS-IS TE Metric Extensions can then be used to make path-selection decisions based on network performance.</t>
      <t>Note that this document only covers the mechanisms with which network-performance information is distributed. The mechanisms for measuring network performance or acting on that information, once distributed, are outside the scope of this document.</t>
      <t>This document obsoletes RFC 7810.</t>
    </abstract>
  </front>
  <seriesInfo name='RFC' value='8570'/>
  <seriesInfo name='DOI' value='10.17487/RFC8570'/>
</reference>

<reference anchor='RFC7823' target='https://www.rfc-editor.org/info/rfc7823'>
  <front>
    <title>Performance-Based Path Selection for Explicitly Routed Label Switched Paths (LSPs) Using TE Metric Extensions</title>
    <author fullname='A. Atlas' initials='A.' surname='Atlas'/>
    <author fullname='J. Drake' initials='J.' surname='Drake'/>
    <author fullname='S. Giacalone' initials='S.' surname='Giacalone'/>
    <author fullname='S. Previdi' initials='S.' surname='Previdi'/>
    <date month='May' year='2016'/>
    <abstract>
      <t>In certain networks, it is critical to consider network performance criteria when selecting the path for an explicitly routed RSVP-TE Label Switched Path (LSP). Such performance criteria can include latency, jitter, and loss or other indications such as the conformance to link performance objectives and non-RSVP TE traffic load. This specification describes how a path computation function may use network performance data, such as is advertised via the OSPF and IS-IS TE metric extensions (defined outside the scope of this document) to perform such path selections.</t>
    </abstract>
  </front>
  <seriesInfo name='RFC' value='7823'/>
  <seriesInfo name='DOI' value='10.17487/RFC7823'/>
</reference>

<reference anchor='RFC4124' target='https://www.rfc-editor.org/info/rfc4124'>
  <front>
    <title>Protocol Extensions for Support of Diffserv-aware MPLS Traffic Engineering</title>
    <author fullname='F. Le Faucheur' initials='F.' role='editor' surname='Le Faucheur'/>
    <date month='June' year='2005'/>
    <abstract>
      <t>This document specifies the protocol extensions for support of Diffserv-aware MPLS Traffic Engineering (DS-TE). This includes generalization of the semantics of a number of Interior Gateway Protocol (IGP) extensions already defined for existing MPLS Traffic Engineering in RFC 3630, RFC 3784, and additional IGP extensions beyond those. This also includes extensions to RSVP-TE signaling beyond those already specified in RFC 3209 for existing MPLS Traffic Engineering. These extensions address the requirements for DS-TE spelled out in RFC 3564. [STANDARDS-TRACK]</t>
    </abstract>
  </front>
  <seriesInfo name='RFC' value='4124'/>
  <seriesInfo name='DOI' value='10.17487/RFC4124'/>
</reference>

<reference anchor='RFC6370' target='https://www.rfc-editor.org/info/rfc6370'>
  <front>
    <title>MPLS Transport Profile (MPLS-TP) Identifiers</title>
    <author fullname='M. Bocci' initials='M.' surname='Bocci'/>
    <author fullname='G. Swallow' initials='G.' surname='Swallow'/>
    <author fullname='E. Gray' initials='E.' surname='Gray'/>
    <date month='September' year='2011'/>
    <abstract>
      <t>This document specifies an initial set of identifiers to be used in the Transport Profile of Multiprotocol Label Switching (MPLS-TP). The MPLS-TP requirements (RFC 5654) require that the elements and objects in an MPLS-TP environment are able to be configured and managed without a control plane. In such an environment, many conventions for defining identifiers are possible. This document defines identifiers for MPLS-TP management and Operations, Administration, and Maintenance (OAM) functions compatible with IP/ MPLS conventions.</t>
      <t>This document is a product of a joint Internet Engineering Task Force (IETF) / International Telecommunication Union Telecommunication Standardization Sector (ITU-T) effort to include an MPLS Transport Profile within the IETF MPLS and Pseudowire Emulation Edge-to-Edge (PWE3) architectures to support the capabilities and functionalities of a packet transport network as defined by the ITU-T. [STANDARDS-TRACK]</t>
    </abstract>
  </front>
  <seriesInfo name='RFC' value='6370'/>
  <seriesInfo name='DOI' value='10.17487/RFC6370'/>
</reference>

<reference anchor='RFC5003' target='https://www.rfc-editor.org/info/rfc5003'>
  <front>
    <title>Attachment Individual Identifier (AII) Types for Aggregation</title>
    <author fullname='C. Metz' initials='C.' surname='Metz'/>
    <author fullname='L. Martini' initials='L.' surname='Martini'/>
    <author fullname='F. Balus' initials='F.' surname='Balus'/>
    <author fullname='J. Sugimoto' initials='J.' surname='Sugimoto'/>
    <date month='September' year='2007'/>
    <abstract>
      <t>The signaling protocols used to establish point-to-point pseudowires include type-length-value (TLV) fields that identify pseudowire endpoints called attachment individual identifiers (AIIs). This document defines AII structures in the form of new AII TLV fields that support AII aggregation for improved scalability and Virtual Private Network (VPN) auto-discovery. It is envisioned that this would be useful in large inter-domain virtual private wire service networks where pseudowires are established between selected local and remote provider edge (PE) nodes based on customer need. [STANDARDS-TRACK]</t>
    </abstract>
  </front>
  <seriesInfo name='RFC' value='5003'/>
  <seriesInfo name='DOI' value='10.17487/RFC5003'/>
</reference>

<reference anchor='RFC3630' target='https://www.rfc-editor.org/info/rfc3630'>
  <front>
    <title>Traffic Engineering (TE) Extensions to OSPF Version 2</title>
    <author fullname='D. Katz' initials='D.' surname='Katz'/>
    <author fullname='K. Kompella' initials='K.' surname='Kompella'/>
    <author fullname='D. Yeung' initials='D.' surname='Yeung'/>
    <date month='September' year='2003'/>
    <abstract>
      <t>This document describes extensions to the OSPF protocol version 2 to support intra-area Traffic Engineering (TE), using Opaque Link State Advertisements.</t>
    </abstract>
  </front>
  <seriesInfo name='RFC' value='3630'/>
  <seriesInfo name='DOI' value='10.17487/RFC3630'/>
</reference>

<reference anchor='RFC6827' target='https://www.rfc-editor.org/info/rfc6827'>
  <front>
    <title>Automatically Switched Optical Network (ASON) Routing for OSPFv2 Protocols</title>
    <author fullname='A. Malis' initials='A.' role='editor' surname='Malis'/>
    <author fullname='A. Lindem' initials='A.' role='editor' surname='Lindem'/>
    <author fullname='D. Papadimitriou' initials='D.' role='editor' surname='Papadimitriou'/>
    <date month='January' year='2013'/>
    <abstract>
      <t>The ITU-T has defined an architecture and requirements for operating an Automatically Switched Optical Network (ASON).</t>
      <t>The Generalized Multiprotocol Label Switching (GMPLS) protocol suite is designed to provide a control plane for a range of network technologies. These include optical networks such as time division multiplexing (TDM) networks including the Synchronous Optical Network/Synchronous Digital Hierarchy (SONET/SDH), Optical Transport Networks (OTNs), and lambda switching optical networks.</t>
      <t>The requirements for GMPLS routing to satisfy the requirements of ASON routing and an evaluation of existing GMPLS routing protocols are provided in other documents. This document defines extensions to the OSPFv2 Link State Routing Protocol to meet the requirements for routing in an ASON.</t>
      <t>Note that this work is scoped to the requirements and evaluation expressed in RFC 4258 and RFC 4652 and the ITU-T Recommendations that were current when those documents were written. Future extensions or revisions of this work may be necessary if the ITU-T Recommendations are revised or if new requirements are introduced into a revision of RFC 4258. This document obsoletes RFC 5787 and updates RFC 5786. [STANDARDS-TRACK]</t>
    </abstract>
  </front>
  <seriesInfo name='RFC' value='6827'/>
  <seriesInfo name='DOI' value='10.17487/RFC6827'/>
</reference>

<reference anchor='RFC5305' target='https://www.rfc-editor.org/info/rfc5305'>
  <front>
    <title>IS-IS Extensions for Traffic Engineering</title>
    <author fullname='T. Li' initials='T.' surname='Li'/>
    <author fullname='H. Smit' initials='H.' surname='Smit'/>
    <date month='October' year='2008'/>
    <abstract>
      <t>This document describes extensions to the Intermediate System to Intermediate System (IS-IS) protocol to support Traffic Engineering (TE). This document extends the IS-IS protocol by specifying new information that an Intermediate System (router) can place in Link State Protocol Data Units (LSP). This information describes additional details regarding the state of the network that are useful for traffic engineering computations. [STANDARDS-TRACK]</t>
    </abstract>
  </front>
  <seriesInfo name='RFC' value='5305'/>
  <seriesInfo name='DOI' value='10.17487/RFC5305'/>
</reference>

<reference anchor='RFC6119' target='https://www.rfc-editor.org/info/rfc6119'>
  <front>
    <title>IPv6 Traffic Engineering in IS-IS</title>
    <author fullname='J. Harrison' initials='J.' surname='Harrison'/>
    <author fullname='J. Berger' initials='J.' surname='Berger'/>
    <author fullname='M. Bartlett' initials='M.' surname='Bartlett'/>
    <date month='February' year='2011'/>
    <abstract>
      <t>This document specifies a method for exchanging IPv6 traffic engineering information using the IS-IS routing protocol. This information enables routers in an IS-IS network to calculate traffic-engineered routes using IPv6 addresses. [STANDARDS-TRACK]</t>
    </abstract>
  </front>
  <seriesInfo name='RFC' value='6119'/>
  <seriesInfo name='DOI' value='10.17487/RFC6119'/>
</reference>

<reference anchor='RFC4872' target='https://www.rfc-editor.org/info/rfc4872'>
  <front>
    <title>RSVP-TE Extensions in Support of End-to-End Generalized Multi-Protocol Label Switching (GMPLS) Recovery</title>
    <author fullname='J.P. Lang' initials='J.P.' role='editor' surname='Lang'/>
    <author fullname='Y. Rekhter' initials='Y.' role='editor' surname='Rekhter'/>
    <author fullname='D. Papadimitriou' initials='D.' role='editor' surname='Papadimitriou'/>
    <date month='May' year='2007'/>
    <abstract>
      <t>This document describes protocol-specific procedures and extensions for Generalized Multi-Protocol Label Switching (GMPLS) Resource ReSerVation Protocol - Traffic Engineering (RSVP-TE) signaling to support end-to-end Label Switched Path (LSP) recovery that denotes protection and restoration. A generic functional description of GMPLS recovery can be found in a companion document, RFC 4426. [STANDARDS-TRACK]</t>
    </abstract>
  </front>
  <seriesInfo name='RFC' value='4872'/>
  <seriesInfo name='DOI' value='10.17487/RFC4872'/>
</reference>

<reference anchor='RFC7308' target='https://www.rfc-editor.org/info/rfc7308'>
  <front>
    <title>Extended Administrative Groups in MPLS Traffic Engineering (MPLS-TE)</title>
    <author fullname='E. Osborne' initials='E.' surname='Osborne'/>
    <date month='July' year='2014'/>
    <abstract>
      <t>MPLS Traffic Engineering (MPLS-TE) advertises 32 administrative groups (commonly referred to as "colors" or "link colors") using the Administrative Group sub-TLV. This is defined for OSPFv2 (RFC 3630), OSPFv3 (RFC 5329) and IS-IS (RFC 5305).</t>
      <t>This document adds a sub-TLV to the IGP TE extensions, "Extended Administrative Group". This sub-TLV provides for additional administrative groups (link colors) beyond the current limit of 32.</t>
    </abstract>
  </front>
  <seriesInfo name='RFC' value='7308'/>
  <seriesInfo name='DOI' value='10.17487/RFC7308'/>
</reference>

<reference anchor='RFC4203' target='https://www.rfc-editor.org/info/rfc4203'>
  <front>
    <title>OSPF Extensions in Support of Generalized Multi-Protocol Label Switching (GMPLS)</title>
    <author fullname='K. Kompella' initials='K.' role='editor' surname='Kompella'/>
    <author fullname='Y. Rekhter' initials='Y.' role='editor' surname='Rekhter'/>
    <date month='October' year='2005'/>
    <abstract>
      <t>This document specifies encoding of extensions to the OSPF routing protocol in support of Generalized Multi-Protocol Label Switching (GMPLS). [STANDARDS-TRACK]</t>
    </abstract>
  </front>
  <seriesInfo name='RFC' value='4203'/>
  <seriesInfo name='DOI' value='10.17487/RFC4203'/>
</reference>

<reference anchor='RFC5307' target='https://www.rfc-editor.org/info/rfc5307'>
  <front>
    <title>IS-IS Extensions in Support of Generalized Multi-Protocol Label Switching (GMPLS)</title>
    <author fullname='K. Kompella' initials='K.' role='editor' surname='Kompella'/>
    <author fullname='Y. Rekhter' initials='Y.' role='editor' surname='Rekhter'/>
    <date month='October' year='2008'/>
    <abstract>
      <t>This document specifies encoding of extensions to the IS-IS routing protocol in support of Generalized Multi-Protocol Label Switching (GMPLS). [STANDARDS-TRACK]</t>
    </abstract>
  </front>
  <seriesInfo name='RFC' value='5307'/>
  <seriesInfo name='DOI' value='10.17487/RFC5307'/>
</reference>

<reference anchor='RFC3785' target='https://www.rfc-editor.org/info/rfc3785'>
  <front>
    <title>Use of Interior Gateway Protocol (IGP) Metric as a second MPLS Traffic Engineering (TE) Metric</title>
    <author fullname='F. Le Faucheur' initials='F.' surname='Le Faucheur'/>
    <author fullname='R. Uppili' initials='R.' surname='Uppili'/>
    <author fullname='A. Vedrenne' initials='A.' surname='Vedrenne'/>
    <author fullname='P. Merckx' initials='P.' surname='Merckx'/>
    <author fullname='T. Telkamp' initials='T.' surname='Telkamp'/>
    <date month='May' year='2004'/>
    <abstract>
      <t>This document describes a common practice on how the existing metric of Interior Gateway Protocols (IGP) can be used as an alternative metric to the Traffic Engineering (TE) metric for Constraint Based Routing of MultiProtocol Label Switching (MPLS) Traffic Engineering tunnels. This effectively results in the ability to perform Constraint Based Routing with optimization of one metric (e.g., link bandwidth) for some Traffic Engineering tunnels (e.g., Data Trunks) while optimizing another metric (e.g., propagation delay) for some other tunnels with different requirements (e.g., Voice Trunks). No protocol extensions or modifications are required. This text documents current router implementations and deployment practices. 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='87'/>
  <seriesInfo name='RFC' value='3785'/>
  <seriesInfo name='DOI' value='10.17487/RFC3785'/>
</reference>

<reference anchor='RFC4427' target='https://www.rfc-editor.org/info/rfc4427'>
  <front>
    <title>Recovery (Protection and Restoration) Terminology for Generalized Multi-Protocol Label Switching (GMPLS)</title>
    <author fullname='E. Mannie' initials='E.' role='editor' surname='Mannie'/>
    <author fullname='D. Papadimitriou' initials='D.' role='editor' surname='Papadimitriou'/>
    <date month='March' year='2006'/>
    <abstract>
      <t>This document defines a common terminology for Generalized Multi-Protocol Label Switching (GMPLS)-based recovery mechanisms (i.e., protection and restoration). The terminology is independent of the underlying transport technologies covered by GMPLS. This memo provides information for the Internet community.</t>
    </abstract>
  </front>
  <seriesInfo name='RFC' value='4427'/>
  <seriesInfo name='DOI' value='10.17487/RFC4427'/>
</reference>

<reference anchor='RFC6378' target='https://www.rfc-editor.org/info/rfc6378'>
  <front>
    <title>MPLS Transport Profile (MPLS-TP) Linear Protection</title>
    <author fullname='Y. Weingarten' initials='Y.' role='editor' surname='Weingarten'/>
    <author fullname='S. Bryant' initials='S.' surname='Bryant'/>
    <author fullname='E. Osborne' initials='E.' surname='Osborne'/>
    <author fullname='N. Sprecher' initials='N.' surname='Sprecher'/>
    <author fullname='A. Fulignoli' initials='A.' role='editor' surname='Fulignoli'/>
    <date month='October' year='2011'/>
    <abstract>
      <t>This document is a product of a joint Internet Engineering Task Force (IETF) / International Telecommunications Union Telecommunications Standardization Sector (ITU-T) effort to include an MPLS Transport Profile within the IETF MPLS and Pseudowire Emulation Edge-to-Edge (PWE3) architectures to support the capabilities and functionalities of a packet transport network as defined by the ITU-T.</t>
      <t>This document addresses the functionality described in the MPLS-TP Survivability Framework document (RFC 6372) and defines a protocol that may be used to fulfill the function of the Protection State Coordination for linear protection, as described in that document. [STANDARDS-TRACK]</t>
    </abstract>
  </front>
  <seriesInfo name='RFC' value='6378'/>
  <seriesInfo name='DOI' value='10.17487/RFC6378'/>
</reference>

<reference anchor='RFC3209' target='https://www.rfc-editor.org/info/rfc3209'>
  <front>
    <title>RSVP-TE: Extensions to RSVP for LSP Tunnels</title>
    <author fullname='D. Awduche' initials='D.' surname='Awduche'/>
    <author fullname='L. Berger' initials='L.' surname='Berger'/>
    <author fullname='D. Gan' initials='D.' surname='Gan'/>
    <author fullname='T. Li' initials='T.' surname='Li'/>
    <author fullname='V. Srinivasan' initials='V.' surname='Srinivasan'/>
    <author fullname='G. Swallow' initials='G.' surname='Swallow'/>
    <date month='December' year='2001'/>
    <abstract>
      <t>This document describes the use of RSVP (Resource Reservation Protocol), including all the necessary extensions, to establish label-switched paths (LSPs) in MPLS (Multi-Protocol Label Switching). Since the flow along an LSP is completely identified by the label applied at the ingress node of the path, these paths may be treated as tunnels. A key application of LSP tunnels is traffic engineering with MPLS as specified in RFC 2702. [STANDARDS-TRACK]</t>
    </abstract>
  </front>
  <seriesInfo name='RFC' value='3209'/>
  <seriesInfo name='DOI' value='10.17487/RFC3209'/>
</reference>

<reference anchor='RFC4090' target='https://www.rfc-editor.org/info/rfc4090'>
  <front>
    <title>Fast Reroute Extensions to RSVP-TE for LSP Tunnels</title>
    <author fullname='P. Pan' initials='P.' role='editor' surname='Pan'/>
    <author fullname='G. Swallow' initials='G.' role='editor' surname='Swallow'/>
    <author fullname='A. Atlas' initials='A.' role='editor' surname='Atlas'/>
    <date month='May' year='2005'/>
    <abstract>
      <t>This document defines RSVP-TE extensions to establish backup label-switched path (LSP) tunnels for local repair of LSP tunnels. These mechanisms enable the re-direction of traffic onto backup LSP tunnels in 10s of milliseconds, in the event of a failure.</t>
      <t>Two methods are defined here. The one-to-one backup method creates detour LSPs for each protected LSP at each potential point of local repair. The facility backup method creates a bypass tunnel to protect a potential failure point; by taking advantage of MPLS label stacking, this bypass tunnel can protect a set of LSPs that have similar backup constraints. Both methods can be used to protect links and nodes during network failure. The described behavior and extensions to RSVP allow nodes to implement either method or both and to interoperate in a mixed network. [STANDARDS-TRACK]</t>
    </abstract>
  </front>
  <seriesInfo name='RFC' value='4090'/>
  <seriesInfo name='DOI' value='10.17487/RFC4090'/>
</reference>

<reference anchor='RFC4736' target='https://www.rfc-editor.org/info/rfc4736'>
  <front>
    <title>Reoptimization of Multiprotocol Label Switching (MPLS) Traffic Engineering (TE) Loosely Routed Label Switched Path (LSP)</title>
    <author fullname='JP. Vasseur' initials='JP.' role='editor' surname='Vasseur'/>
    <author fullname='Y. Ikejiri' initials='Y.' surname='Ikejiri'/>
    <author fullname='R. Zhang' initials='R.' surname='Zhang'/>
    <date month='November' year='2006'/>
    <abstract>
      <t>This document defines a mechanism for the reoptimization of loosely routed MPLS and GMPLS (Generalized Multiprotocol Label Switching) Traffic Engineering (TE) Label Switched Paths (LSPs) signaled with Resource Reservation Protocol Traffic Engineering (RSVP-TE). This document proposes a mechanism that allows a TE LSP head-end Label Switching Router (LSR) to trigger a new path re-evaluation on every hop that has a next hop defined as a loose or abstract hop and a mid-point LSR to signal to the head-end LSR that a better path exists (compared to the current path) or that the TE LSP must be reoptimized (because of maintenance required on the TE LSP path). The proposed mechanism applies to the cases of intra- and inter-domain (Interior Gateway Protocol area (IGP area) or Autonomous System) packet and non-packet TE LSPs following a loosely routed path. This memo provides information for the Internet community.</t>
    </abstract>
  </front>
  <seriesInfo name='RFC' value='4736'/>
  <seriesInfo name='DOI' value='10.17487/RFC4736'/>
</reference>

<reference anchor='RFC5712' target='https://www.rfc-editor.org/info/rfc5712'>
  <front>
    <title>MPLS Traffic Engineering Soft Preemption</title>
    <author fullname='M. Meyer' initials='M.' role='editor' surname='Meyer'/>
    <author fullname='JP. Vasseur' initials='JP.' role='editor' surname='Vasseur'/>
    <date month='January' year='2010'/>
    <abstract>
      <t>This document specifies Multiprotocol Label Switching (MPLS) Traffic Engineering Soft Preemption, a suite of protocol modifications extending the concept of preemption with the goal of reducing or eliminating traffic disruption of preempted Traffic Engineering Label Switched Paths (TE LSPs). Initially, MPLS RSVP-TE was defined with support for only immediate TE LSP displacement upon preemption. The utilization of a reroute request notification helps more gracefully mitigate the reroute process of preempted TE LSP. For the brief period soft preemption is activated, reservations (though not necessarily traffic levels) are in effect under-provisioned until the TE LSP(s) can be rerouted. For this reason, the feature is primarily, but not exclusively, interesting in MPLS-enabled IP networks with Differentiated Services and Traffic Engineering capabilities. [STANDARDS-TRACK]</t>
    </abstract>
  </front>
  <seriesInfo name='RFC' value='5712'/>
  <seriesInfo name='DOI' value='10.17487/RFC5712'/>
</reference>

<reference anchor='RFC4920' target='https://www.rfc-editor.org/info/rfc4920'>
  <front>
    <title>Crankback Signaling Extensions for MPLS and GMPLS RSVP-TE</title>
    <author fullname='A. Farrel' initials='A.' role='editor' surname='Farrel'/>
    <author fullname='A. Satyanarayana' initials='A.' surname='Satyanarayana'/>
    <author fullname='A. Iwata' initials='A.' surname='Iwata'/>
    <author fullname='N. Fujita' initials='N.' surname='Fujita'/>
    <author fullname='G. Ash' initials='G.' surname='Ash'/>
    <date month='July' year='2007'/>
    <abstract>
      <t>In a distributed, constraint-based routing environment, the information used to compute a path may be out of date. This means that Multiprotocol Label Switching (MPLS) and Generalized MPLS (GMPLS) Traffic Engineered (TE) Label Switched Path (LSP) setup requests may be blocked by links or nodes without sufficient resources. Crankback is a scheme whereby setup failure information is returned from the point of failure to allow new setup attempts to be made avoiding the blocked resources. Crankback can also be applied to LSP recovery to indicate the location of the failed link or node.</t>
      <t>This document specifies crankback signaling extensions for use in MPLS signaling using RSVP-TE as defined in "RSVP-TE: Extensions to RSVP for LSP Tunnels", RFC 3209, and GMPLS signaling as defined in "Generalized Multi-Protocol Label Switching (GMPLS) Signaling Functional Description", RFC 3473. These extensions mean that the LSP setup request can be retried on an alternate path that detours around blocked links or nodes. This offers significant improvements in the successful setup and recovery ratios for LSPs, especially in situations where a large number of setup requests are triggered at the same time. [STANDARDS-TRACK]</t>
    </abstract>
  </front>
  <seriesInfo name='RFC' value='4920'/>
  <seriesInfo name='DOI' value='10.17487/RFC4920'/>
</reference>

<reference anchor='RFC5420' target='https://www.rfc-editor.org/info/rfc5420'>
  <front>
    <title>Encoding of Attributes for MPLS LSP Establishment Using Resource Reservation Protocol Traffic Engineering (RSVP-TE)</title>
    <author fullname='A. Farrel' initials='A.' role='editor' surname='Farrel'/>
    <author fullname='D. Papadimitriou' initials='D.' surname='Papadimitriou'/>
    <author fullname='JP. Vasseur' initials='JP.' surname='Vasseur'/>
    <author fullname='A. Ayyangar' initials='A.' surname='Ayyangar'/>
    <date month='February' year='2009'/>
    <abstract>
      <t>Multiprotocol Label Switching (MPLS) Label Switched Paths (LSPs) may be established using the Resource Reservation Protocol Traffic Engineering (RSVP-TE) extensions. This protocol includes an object (the SESSION_ATTRIBUTE object) that carries a Flags field used to indicate options and attributes of the LSP. That Flags field has eight bits, allowing for eight options to be set. Recent proposals in many documents that extend RSVP-TE have suggested uses for each of the previously unused bits.</t>
      <t>This document defines a new object for RSVP-TE messages that allows the signaling of further attribute bits and also the carriage of arbitrary attribute parameters to make RSVP-TE easily extensible to support new requirements. Additionally, this document defines a way to record the attributes applied to the LSP on a hop-by-hop basis.</t>
      <t>The object mechanisms defined in this document are equally applicable to Generalized MPLS (GMPLS) Packet Switch Capable (PSC) LSPs and to GMPLS non-PSC LSPs.</t>
      <t>This document replaces and obsoletes the previous version of this work, published as RFC 4420. The only change is in the encoding of the Type-Length-Variable (TLV) data structures. [STANDARDS-TRACK]</t>
    </abstract>
  </front>
  <seriesInfo name='RFC' value='5420'/>
  <seriesInfo name='DOI' value='10.17487/RFC5420'/>
</reference>

<reference anchor='RFC7570' target='https://www.rfc-editor.org/info/rfc7570'>
  <front>
    <title>Label Switched Path (LSP) Attribute in the Explicit Route Object (ERO)</title>
    <author fullname='C. Margaria' initials='C.' role='editor' surname='Margaria'/>
    <author fullname='G. Martinelli' initials='G.' surname='Martinelli'/>
    <author fullname='S. Balls' initials='S.' surname='Balls'/>
    <author fullname='B. Wright' initials='B.' surname='Wright'/>
    <date month='July' year='2015'/>
    <abstract>
      <t>RFC 5420 extends RSVP-TE to specify or record generic attributes that apply to the whole of the path of a Label Switched Path (LSP). This document defines an extension to the RSVP Explicit Route Object (ERO) and Record Route Object (RRO) to allow them to specify or record generic attributes that apply to a given hop.</t>
    </abstract>
  </front>
  <seriesInfo name='RFC' value='7570'/>
  <seriesInfo name='DOI' value='10.17487/RFC7570'/>
</reference>

<reference anchor='RFC4875' target='https://www.rfc-editor.org/info/rfc4875'>
  <front>
    <title>Extensions to Resource Reservation Protocol - Traffic Engineering (RSVP-TE) for Point-to-Multipoint TE Label Switched Paths (LSPs)</title>
    <author fullname='R. Aggarwal' initials='R.' role='editor' surname='Aggarwal'/>
    <author fullname='D. Papadimitriou' initials='D.' role='editor' surname='Papadimitriou'/>
    <author fullname='S. Yasukawa' initials='S.' role='editor' surname='Yasukawa'/>
    <date month='May' year='2007'/>
    <abstract>
      <t>This document describes extensions to Resource Reservation Protocol - Traffic Engineering (RSVP-TE) for the set up of Traffic Engineered (TE) point-to-multipoint (P2MP) Label Switched Paths (LSPs) in Multi- Protocol Label Switching (MPLS) and Generalized MPLS (GMPLS) networks. The solution relies on RSVP-TE without requiring a multicast routing protocol in the Service Provider core. Protocol elements and procedures for this solution are described.</t>
      <t>There can be various applications for P2MP TE LSPs such as IP multicast. Specification of how such applications will use a P2MP TE LSP is outside the scope of this document. [STANDARDS-TRACK]</t>
    </abstract>
  </front>
  <seriesInfo name='RFC' value='4875'/>
  <seriesInfo name='DOI' value='10.17487/RFC4875'/>
</reference>

<reference anchor='RFC5151' target='https://www.rfc-editor.org/info/rfc5151'>
  <front>
    <title>Inter-Domain MPLS and GMPLS Traffic Engineering -- Resource Reservation Protocol-Traffic Engineering (RSVP-TE) Extensions</title>
    <author fullname='A. Farrel' initials='A.' role='editor' surname='Farrel'/>
    <author fullname='A. Ayyangar' initials='A.' surname='Ayyangar'/>
    <author fullname='JP. Vasseur' initials='JP.' surname='Vasseur'/>
    <date month='February' year='2008'/>
    <abstract>
      <t>This document describes procedures and protocol extensions for the use of Resource Reservation Protocol-Traffic Engineering (RSVP-TE) signaling in Multiprotocol Label Switching-Traffic Engineering (MPLS-TE) packet networks and Generalized MPLS (GMPLS) packet and non-packet networks to support the establishment and maintenance of Label Switched Paths that cross domain boundaries.</t>
      <t>For the purpose of this document, a domain is considered to be any collection of network elements within a common realm of address space or path computation responsibility. Examples of such domains include Autonomous Systems, Interior Gateway Protocol (IGP) routing areas, and GMPLS overlay networks. [STANDARDS-TRACK]</t>
    </abstract>
  </front>
  <seriesInfo name='RFC' value='5151'/>
  <seriesInfo name='DOI' value='10.17487/RFC5151'/>
</reference>

<reference anchor='RFC5150' target='https://www.rfc-editor.org/info/rfc5150'>
  <front>
    <title>Label Switched Path Stitching with Generalized Multiprotocol Label Switching Traffic Engineering (GMPLS TE)</title>
    <author fullname='A. Ayyangar' initials='A.' surname='Ayyangar'/>
    <author fullname='K. Kompella' initials='K.' surname='Kompella'/>
    <author fullname='JP. Vasseur' initials='JP.' surname='Vasseur'/>
    <author fullname='A. Farrel' initials='A.' surname='Farrel'/>
    <date month='February' year='2008'/>
    <abstract>
      <t>In certain scenarios, there may be a need to combine several Generalized Multiprotocol Label Switching (GMPLS) Label Switched Paths (LSPs) such that a single end-to-end (e2e) LSP is realized and all traffic from one constituent LSP is switched onto the next LSP. We will refer to this as "LSP stitching", the key requirement being that a constituent LSP not be allocated to more than one e2e LSP. The constituent LSPs will be referred to as "LSP segments" (S-LSPs).</t>
      <t>This document describes extensions to the existing GMPLS signaling protocol (Resource Reservation Protocol-Traffic Engineering (RSVP-TE)) to establish e2e LSPs created from S-LSPs, and describes how the LSPs can be managed using the GMPLS signaling and routing protocols.</t>
      <t>It may be possible to configure a GMPLS node to switch the traffic from an LSP for which it is the egress, to another LSP for which it is the ingress, without requiring any signaling or routing extensions whatsoever and such that the operation is completely transparent to other nodes. This will also result in LSP stitching in the data plane. However, this document does not cover this scenario of LSP stitching. [STANDARDS-TRACK]</t>
    </abstract>
  </front>
  <seriesInfo name='RFC' value='5150'/>
  <seriesInfo name='DOI' value='10.17487/RFC5150'/>
</reference>

<reference anchor='RFC6001' target='https://www.rfc-editor.org/info/rfc6001'>
  <front>
    <title>Generalized MPLS (GMPLS) Protocol Extensions for Multi-Layer and Multi-Region Networks (MLN/MRN)</title>
    <author fullname='D. Papadimitriou' initials='D.' surname='Papadimitriou'/>
    <author fullname='M. Vigoureux' initials='M.' surname='Vigoureux'/>
    <author fullname='K. Shiomoto' initials='K.' surname='Shiomoto'/>
    <author fullname='D. Brungard' initials='D.' surname='Brungard'/>
    <author fullname='JL. Le Roux' initials='JL.' surname='Le Roux'/>
    <date month='October' year='2010'/>
    <abstract>
      <t>There are specific requirements for the support of networks comprising Label Switching Routers (LSRs) participating in different data plane switching layers controlled by a single Generalized Multi-Protocol Label Switching (GMPLS) control plane instance, referred to as GMPLS Multi-Layer Networks / Multi-Region Networks (MLN/MRN).</t>
      <t>This document defines extensions to GMPLS routing and signaling protocols so as to support the operation of GMPLS Multi-Layer / Multi-Region Networks. It covers the elements of a single GMPLS control plane instance controlling multiple Label Switched Path (LSP) regions or layers within a single Traffic Engineering (TE) domain. [STANDARDS-TRACK]</t>
    </abstract>
  </front>
  <seriesInfo name='RFC' value='6001'/>
  <seriesInfo name='DOI' value='10.17487/RFC6001'/>
</reference>

<reference anchor='RFC6790' target='https://www.rfc-editor.org/info/rfc6790'>
  <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='RFC7260' target='https://www.rfc-editor.org/info/rfc7260'>
  <front>
    <title>GMPLS RSVP-TE Extensions for Operations, Administration, and Maintenance (OAM) Configuration</title>
    <author fullname='A. Takacs' initials='A.' surname='Takacs'/>
    <author fullname='D. Fedyk' initials='D.' surname='Fedyk'/>
    <author fullname='J. He' initials='J.' surname='He'/>
    <date month='June' year='2014'/>
    <abstract>
      <t>Operations, Administration, and Maintenance (OAM) is an integral part of transport connections; hence, it is required that OAM functions be activated/deactivated in sync with connection commissioning/ decommissioning, in order to avoid spurious alarms and ensure consistent operation. In certain technologies, OAM entities are inherently established once the connection is set up, while other technologies require extra configuration to establish and configure OAM entities. This document specifies extensions to Resource Reservation Protocol - Traffic Engineering (RSVP-TE) to support the establishment and configuration of OAM entities along with Label Switched Path signaling.</t>
    </abstract>
  </front>
  <seriesInfo name='RFC' value='7260'/>
  <seriesInfo name='DOI' value='10.17487/RFC7260'/>
</reference>

<reference anchor='RFC8001' target='https://www.rfc-editor.org/info/rfc8001'>
  <front>
    <title>RSVP-TE Extensions for Collecting Shared Risk Link Group (SRLG) Information</title>
    <author fullname='F. Zhang' initials='F.' role='editor' surname='Zhang'/>
    <author fullname='O. Gonzalez de Dios' initials='O.' role='editor' surname='Gonzalez de Dios'/>
    <author fullname='C. Margaria' initials='C.' surname='Margaria'/>
    <author fullname='M. Hartley' initials='M.' surname='Hartley'/>
    <author fullname='Z. Ali' initials='Z.' surname='Ali'/>
    <date month='January' year='2017'/>
    <abstract>
      <t>This document provides extensions for Resource Reservation Protocol - Traffic Engineering (RSVP-TE), including GMPLS, to support automatic collection of Shared Risk Link Group (SRLG) information for the TE link formed by a Label Switched Path (LSP).</t>
    </abstract>
  </front>
  <seriesInfo name='RFC' value='8001'/>
  <seriesInfo name='DOI' value='10.17487/RFC8001'/>
</reference>

<reference anchor='RFC8149' target='https://www.rfc-editor.org/info/rfc8149'>
  <front>
    <title>RSVP Extensions for Reoptimization of Loosely Routed Point-to-Multipoint Traffic Engineering Label Switched Paths (LSPs)</title>
    <author fullname='T. Saad' initials='T.' role='editor' surname='Saad'/>
    <author fullname='R. Gandhi' initials='R.' role='editor' surname='Gandhi'/>
    <author fullname='Z. Ali' initials='Z.' surname='Ali'/>
    <author fullname='R. Venator' initials='R.' surname='Venator'/>
    <author fullname='Y. Kamite' initials='Y.' surname='Kamite'/>
    <date month='April' year='2017'/>
    <abstract>
      <t>The reoptimization of a Point-to-Multipoint (P2MP) Traffic Engineering (TE) Label Switched Path (LSP) may be triggered based on the need to reoptimize an individual source-to-leaf (S2L) sub-LSP or a set of S2L sub-LSPs, both using the Sub-Group-based reoptimization method, or the entire P2MP-TE LSP tree using the Make-Before-Break (MBB) method. This document discusses the application of the existing mechanisms for path reoptimization of loosely routed Point-to-Point (P2P) TE LSPs to the P2MP-TE LSPs, identifies issues in doing so, and defines procedures to address them. When reoptimizing a large number of S2L sub-LSPs in a tree using the Sub-Group-based reoptimization method, the S2L sub-LSP descriptor list may need to be semantically fragmented. This document defines the notion of a fragment identifier to help recipient nodes unambiguously reconstruct the fragmented S2L sub-LSP descriptor list.</t>
    </abstract>
  </front>
  <seriesInfo name='RFC' value='8149'/>
  <seriesInfo name='DOI' value='10.17487/RFC8149'/>
</reference>

<reference anchor='RFC8169' target='https://www.rfc-editor.org/info/rfc8169'>
  <front>
    <title>Residence Time Measurement in MPLS Networks</title>
    <author fullname='G. Mirsky' initials='G.' surname='Mirsky'/>
    <author fullname='S. Ruffini' initials='S.' surname='Ruffini'/>
    <author fullname='E. Gray' initials='E.' surname='Gray'/>
    <author fullname='J. Drake' initials='J.' surname='Drake'/>
    <author fullname='S. Bryant' initials='S.' surname='Bryant'/>
    <author fullname='A. Vainshtein' initials='A.' surname='Vainshtein'/>
    <date month='May' year='2017'/>
    <abstract>
      <t>This document specifies a new Generic Associated Channel (G-ACh) for Residence Time Measurement (RTM) and describes how it can be used by time synchronization protocols within an MPLS domain.</t>
      <t>Residence time is the variable part of the propagation delay of timing and synchronization messages; knowing this delay for each message allows for a more accurate determination of the delay to be taken into account when applying the value included in a Precision Time Protocol event message.</t>
    </abstract>
  </front>
  <seriesInfo name='RFC' value='8169'/>
  <seriesInfo name='DOI' value='10.17487/RFC8169'/>
</reference>

<reference anchor='RFC6780' target='https://www.rfc-editor.org/info/rfc6780'>
  <front>
    <title>RSVP ASSOCIATION Object Extensions</title>
    <author fullname='L. Berger' initials='L.' surname='Berger'/>
    <author fullname='F. Le Faucheur' initials='F.' surname='Le Faucheur'/>
    <author fullname='A. Narayanan' initials='A.' surname='Narayanan'/>
    <date month='October' year='2012'/>
    <abstract>
      <t>The RSVP ASSOCIATION object was defined in the context of GMPLS-controlled Label Switched Paths (LSPs). In this context, the object is used to associate recovery LSPs with the LSP they are protecting. This object also has broader applicability as a mechanism to associate RSVP state. This document defines how the ASSOCIATION object can be more generally applied. This document also defines Extended ASSOCIATION objects that, in particular, can be used in the context of the MPLS Transport Profile (MPLS-TP). This document updates RFC 2205, RFC 3209, and RFC 3473. It also generalizes the definition of the Association ID field defined in RFC 4872. [STANDARDS-TRACK]</t>
    </abstract>
  </front>
  <seriesInfo name='RFC' value='6780'/>
  <seriesInfo name='DOI' value='10.17487/RFC6780'/>
</reference>

<reference anchor='RFC4873' target='https://www.rfc-editor.org/info/rfc4873'>
  <front>
    <title>GMPLS Segment Recovery</title>
    <author fullname='L. Berger' initials='L.' surname='Berger'/>
    <author fullname='I. Bryskin' initials='I.' surname='Bryskin'/>
    <author fullname='D. Papadimitriou' initials='D.' surname='Papadimitriou'/>
    <author fullname='A. Farrel' initials='A.' surname='Farrel'/>
    <date month='May' year='2007'/>
    <abstract>
      <t>This document describes protocol specific procedures for GMPLS (Generalized Multi-Protocol Label Switching) RSVP-TE (Resource ReserVation Protocol - Traffic Engineering) signaling extensions to support label switched path (LSP) segment protection and restoration. These extensions are intended to complement and be consistent with the RSVP-TE Extensions for End-to-End GMPLS Recovery (RFC 4872). Implications and interactions with fast reroute are also addressed. This document also updates the handling of NOTIFY_REQUEST objects. [STANDARDS-TRACK]</t>
    </abstract>
  </front>
  <seriesInfo name='RFC' value='4873'/>
  <seriesInfo name='DOI' value='10.17487/RFC4873'/>
</reference>

<reference anchor='RFC3471' target='https://www.rfc-editor.org/info/rfc3471'>
  <front>
    <title>Generalized Multi-Protocol Label Switching (GMPLS) Signaling Functional Description</title>
    <author fullname='L. Berger' initials='L.' role='editor' surname='Berger'/>
    <date month='January' year='2003'/>
    <abstract>
      <t>This document describes extensions to Multi-Protocol Label Switching (MPLS) signaling required to support Generalized MPLS. Generalized MPLS extends the MPLS control plane to encompass time-division (e.g., Synchronous Optical Network and Synchronous Digital Hierarchy, SONET/SDH), wavelength (optical lambdas) and spatial switching (e.g., incoming port or fiber to outgoing port or fiber). This document presents a functional description of the extensions. Protocol specific formats and mechanisms, and technology specific details are specified in separate documents. [STANDARDS-TRACK]</t>
    </abstract>
  </front>
  <seriesInfo name='RFC' value='3471'/>
  <seriesInfo name='DOI' value='10.17487/RFC3471'/>
</reference>

<reference anchor='RFC2702' target='https://www.rfc-editor.org/info/rfc2702'>
  <front>
    <title>Requirements for Traffic Engineering Over MPLS</title>
    <author fullname='D. Awduche' initials='D.' surname='Awduche'/>
    <author fullname='J. Malcolm' initials='J.' surname='Malcolm'/>
    <author fullname='J. Agogbua' initials='J.' surname='Agogbua'/>
    <author fullname='M. O&apos;Dell' initials='M.' surname='O&apos;Dell'/>
    <author fullname='J. McManus' initials='J.' surname='McManus'/>
    <date month='September' year='1999'/>
    <abstract>
      <t>This document presents a set of requirements for Traffic Engineering over Multiprotocol Label Switching (MPLS). It identifies the functional capabilities required to implement policies that facilitate efficient and reliable network operations in an MPLS domain. This memo provides information for the Internet community.</t>
    </abstract>
  </front>
  <seriesInfo name='RFC' value='2702'/>
  <seriesInfo name='DOI' value='10.17487/RFC2702'/>
</reference>

<reference anchor='RFC3477' target='https://www.rfc-editor.org/info/rfc3477'>
  <front>
    <title>Signalling Unnumbered Links in Resource ReSerVation Protocol - Traffic Engineering (RSVP-TE)</title>
    <author fullname='K. Kompella' initials='K.' surname='Kompella'/>
    <author fullname='Y. Rekhter' initials='Y.' surname='Rekhter'/>
    <date month='January' year='2003'/>
    <abstract>
      <t>Current signalling used by Multi-Protocol Label Switching Traffic Engineering (MPLS TE) does not provide support for unnumbered links. This document defines procedures and extensions to Resource ReSerVation Protocol (RSVP) for Label Switched Path (LSP) Tunnels (RSVP-TE), one of the MPLS TE signalling protocols, that are needed in order to support unnumbered links. [STANDARDS-TRACK]</t>
    </abstract>
  </front>
  <seriesInfo name='RFC' value='3477'/>
  <seriesInfo name='DOI' value='10.17487/RFC3477'/>
</reference>

<reference anchor='RFC4125' target='https://www.rfc-editor.org/info/rfc4125'>
  <front>
    <title>Maximum Allocation Bandwidth Constraints Model for Diffserv-aware MPLS Traffic Engineering</title>
    <author fullname='F. Le Faucheur' initials='F.' surname='Le Faucheur'/>
    <author fullname='W. Lai' initials='W.' surname='Lai'/>
    <date month='June' year='2005'/>
    <abstract>
      <t>This document provides specifications for one Bandwidth Constraints Model for Diffserv-aware MPLS Traffic Engineering, which is referred to as the Maximum Allocation Model. This memo defines an Experimental Protocol for the Internet community.</t>
    </abstract>
  </front>
  <seriesInfo name='RFC' value='4125'/>
  <seriesInfo name='DOI' value='10.17487/RFC4125'/>
</reference>

<reference anchor='RFC4126' target='https://www.rfc-editor.org/info/rfc4126'>
  <front>
    <title>Max Allocation with Reservation Bandwidth Constraints Model for Diffserv-aware MPLS Traffic Engineering &amp; Performance Comparisons</title>
    <author fullname='J. Ash' initials='J.' surname='Ash'/>
    <date month='June' year='2005'/>
    <abstract>
      <t>This document complements the Diffserv-aware MPLS Traffic Engineering (DS-TE) requirements document by giving a functional specification for the Maximum Allocation with Reservation (MAR) Bandwidth Constraints Model. Assumptions, applicability, and examples of the operation of the MAR Bandwidth Constraints Model are presented. MAR performance is analyzed relative to the criteria for selecting a Bandwidth Constraints Model, in order to provide guidance to user implementation of the model in their networks. This memo defines an Experimental Protocol for the Internet community.</t>
    </abstract>
  </front>
  <seriesInfo name='RFC' value='4126'/>
  <seriesInfo name='DOI' value='10.17487/RFC4126'/>
</reference>

<reference anchor='RFC4127' target='https://www.rfc-editor.org/info/rfc4127'>
  <front>
    <title>Russian Dolls Bandwidth Constraints Model for Diffserv-aware MPLS Traffic Engineering</title>
    <author fullname='F. Le Faucheur' initials='F.' role='editor' surname='Le Faucheur'/>
    <date month='June' year='2005'/>
    <abstract>
      <t>This document provides specifications for one Bandwidth Constraints Model for Diffserv-aware MPLS Traffic Engineering, which is referred to as the Russian Dolls Model. This memo defines an Experimental Protocol for the Internet community.</t>
    </abstract>
  </front>
  <seriesInfo name='RFC' value='4127'/>
  <seriesInfo name='DOI' value='10.17487/RFC4127'/>
</reference>

<reference anchor='RFC2697' target='https://www.rfc-editor.org/info/rfc2697'>
  <front>
    <title>A Single Rate Three Color Marker</title>
    <author fullname='J. Heinanen' initials='J.' surname='Heinanen'/>
    <author fullname='R. Guerin' initials='R.' surname='Guerin'/>
    <date month='September' year='1999'/>
    <abstract>
      <t>This document defines a Single Rate Three Color Marker (srTCM), which can be used as component in a Diffserv traffic conditioner. This memo provides information for the Internet community.</t>
    </abstract>
  </front>
  <seriesInfo name='RFC' value='2697'/>
  <seriesInfo name='DOI' value='10.17487/RFC2697'/>
</reference>

<reference anchor='RFC2698' target='https://www.rfc-editor.org/info/rfc2698'>
  <front>
    <title>A Two Rate Three Color Marker</title>
    <author fullname='J. Heinanen' initials='J.' surname='Heinanen'/>
    <author fullname='R. Guerin' initials='R.' surname='Guerin'/>
    <date month='September' year='1999'/>
    <abstract>
      <t>This document defines a Two Rate Three Color Marker (trTCM), which can be used as a component in a Diffserv traffic conditioner. This memo provides information for the Internet community.</t>
    </abstract>
  </front>
  <seriesInfo name='RFC' value='2698'/>
  <seriesInfo name='DOI' value='10.17487/RFC2698'/>
</reference>

<reference anchor='RFC4115' target='https://www.rfc-editor.org/info/rfc4115'>
  <front>
    <title>A Differentiated Service Two-Rate, Three-Color Marker with Efficient Handling of in-Profile Traffic</title>
    <author fullname='O. Aboul-Magd' initials='O.' surname='Aboul-Magd'/>
    <author fullname='S. Rabie' initials='S.' surname='Rabie'/>
    <date month='July' year='2005'/>
    <abstract>
      <t>This document describes a two-rate, three-color marker that has been in use for data services including Frame Relay services. This marker can be used for metering per-flow traffic in the emerging IP and L2 VPN services. The marker defined here is different from previously defined markers in the handling of the in-profile traffic. Furthermore, this marker doesn't impose peak-rate shaping requirements on customer edge (CE) devices. This memo provides information for the Internet community.</t>
    </abstract>
  </front>
  <seriesInfo name='RFC' value='4115'/>
  <seriesInfo name='DOI' value='10.17487/RFC4115'/>
</reference>


<reference anchor='I-D.ietf-teas-yang-te-mpls' target='https://datatracker.ietf.org/doc/html/draft-ietf-teas-yang-te-mpls-04'>
   <front>
      <title>A YANG Data Model for MPLS Traffic Engineering Tunnels</title>
      <author fullname='Tarek Saad' initials='T.' surname='Saad'>
         <organization>Cisco Systems Inc</organization>
      </author>
      <author fullname='Rakesh Gandhi' initials='R.' surname='Gandhi'>
         <organization>Cisco Systems Inc</organization>
      </author>
      <author fullname='Xufeng Liu' initials='X.' surname='Liu'>
         <organization>IBM Corporation</organization>
      </author>
      <author fullname='Vishnu Pavan Beeram' initials='V. P.' surname='Beeram'>
         <organization>Juniper Networks</organization>
      </author>
      <author fullname='Igor Bryskin' initials='I.' surname='Bryskin'>
         <organization>Individual</organization>
      </author>
      <date day='26' month='May' year='2023'/>
      <abstract>
	 <t>   This document defines a YANG data model for the configuration and
   management of Multiprotocol Label Switching (MPLS) Traffic
   Engineering (TE) tunnels, Label Switched Paths (LSPs) and interfaces.
   The model augments the TE generic YANG model for MPLS packet
   dataplane technology.

   This model covers data for configuration, operational state, remote
   procedural calls, and event notifications.

	 </t>
      </abstract>
   </front>
   <seriesInfo name='Internet-Draft' value='draft-ietf-teas-yang-te-mpls-04'/>
   
</reference>

<reference anchor='RFC3272' target='https://www.rfc-editor.org/info/rfc3272'>
  <front>
    <title>Overview and Principles of Internet Traffic Engineering</title>
    <author fullname='D. Awduche' initials='D.' surname='Awduche'/>
    <author fullname='A. Chiu' initials='A.' surname='Chiu'/>
    <author fullname='A. Elwalid' initials='A.' surname='Elwalid'/>
    <author fullname='I. Widjaja' initials='I.' surname='Widjaja'/>
    <author fullname='X. Xiao' initials='X.' surname='Xiao'/>
    <date month='May' year='2002'/>
    <abstract>
      <t>This memo describes the principles of Traffic Engineering (TE) in the Internet. The document is intended to promote better understanding of the issues surrounding traffic engineering in IP networks, and to provide a common basis for the development of traffic engineering capabilities for the Internet. The principles, architectures, and methodologies for performance evaluation and performance optimization of operational IP networks are discussed throughout this document. This memo provides information for the Internet community.</t>
    </abstract>
  </front>
  <seriesInfo name='RFC' value='3272'/>
  <seriesInfo name='DOI' value='10.17487/RFC3272'/>
</reference>

<reference anchor='RFC4202' target='https://www.rfc-editor.org/info/rfc4202'>
  <front>
    <title>Routing Extensions in Support of Generalized Multi-Protocol Label Switching (GMPLS)</title>
    <author fullname='K. Kompella' initials='K.' role='editor' surname='Kompella'/>
    <author fullname='Y. Rekhter' initials='Y.' role='editor' surname='Rekhter'/>
    <date month='October' year='2005'/>
    <abstract>
      <t>This document specifies routing extensions in support of carrying link state information for Generalized Multi-Protocol Label Switching (GMPLS). This document enhances the routing extensions required to support MPLS Traffic Engineering (TE). [STANDARDS-TRACK]</t>
    </abstract>
  </front>
  <seriesInfo name='RFC' value='4202'/>
  <seriesInfo name='DOI' value='10.17487/RFC4202'/>
</reference>

<reference anchor='RFC4328' target='https://www.rfc-editor.org/info/rfc4328'>
  <front>
    <title>Generalized Multi-Protocol Label Switching (GMPLS) Signaling Extensions for G.709 Optical Transport Networks Control</title>
    <author fullname='D. Papadimitriou' initials='D.' role='editor' surname='Papadimitriou'/>
    <date month='January' year='2006'/>
    <abstract>
      <t>This document is a companion to the Generalized Multi-Protocol Label Switching (GMPLS) signaling documents. It describes the technology-specific information needed to extend GMPLS signaling to control Optical Transport Networks (OTN); it also includes the so-called pre-OTN developments. [STANDARDS-TRACK]</t>
    </abstract>
  </front>
  <seriesInfo name='RFC' value='4328'/>
  <seriesInfo name='DOI' value='10.17487/RFC4328'/>
</reference>

<reference anchor='RFC4561' target='https://www.rfc-editor.org/info/rfc4561'>
  <front>
    <title>Definition of a Record Route Object (RRO) Node-Id Sub-Object</title>
    <author fullname='J.-P. Vasseur' initials='J.-P.' role='editor' surname='Vasseur'/>
    <author fullname='Z. Ali' initials='Z.' surname='Ali'/>
    <author fullname='S. Sivabalan' initials='S.' surname='Sivabalan'/>
    <date month='June' year='2006'/>
    <abstract>
      <t>In the context of MPLS TE Fast Reroute, the Merge Point (MP) address is required at the Point of Local Repair (PLR) in order to select a backup tunnel intersecting a fast reroutable Traffic Engineering Label Switched Path (TE LSP) on a downstream Label Switching Router (LSR). However, existing protocol mechanisms are not sufficient to find an MP address in multi-domain routing networks where a domain is defined as an Interior Gateway Protocol (IGP) area or an Autonomous System (AS). Hence, the current MPLS Fast Reroute mechanism cannot be used in order to protect inter-domain TE LSPs from a failure of an Area Border Router (ABR) or Autonomous System Border Router (ASBR). This document specifies the use of existing Record Route Object (RRO) IPv4 and IPv6 sub-objects (with a new flag defined) thus defining the node-id sub-object in order to solve this issue. The MPLS Fast Reroute mechanism mentioned in this document refers to the "Facility backup" MPLS TE Fast Reroute method. [STANDARDS-TRACK]</t>
    </abstract>
  </front>
  <seriesInfo name='RFC' value='4561'/>
  <seriesInfo name='DOI' value='10.17487/RFC4561'/>
</reference>

<reference anchor='RFC4657' target='https://www.rfc-editor.org/info/rfc4657'>
  <front>
    <title>Path Computation Element (PCE) Communication Protocol Generic Requirements</title>
    <author fullname='J. Ash' initials='J.' role='editor' surname='Ash'/>
    <author fullname='J.L. Le Roux' initials='J.L.' role='editor' surname='Le Roux'/>
    <date month='September' year='2006'/>
    <abstract>
      <t>The PCE model is described in the "PCE Architecture" document and facilitates path computation requests from Path Computation Clients (PCCs) to Path Computation Elements (PCEs). This document specifies generic requirements for a communication protocol between PCCs and PCEs, and also between PCEs where cooperation between PCEs is desirable. Subsequent documents will specify application-specific requirements for the PCE communication protocol. This memo provides information for the Internet community.</t>
    </abstract>
  </front>
  <seriesInfo name='RFC' value='4657'/>
  <seriesInfo name='DOI' value='10.17487/RFC4657'/>
</reference>

<reference anchor='RFC6004' target='https://www.rfc-editor.org/info/rfc6004'>
  <front>
    <title>Generalized MPLS (GMPLS) Support for Metro Ethernet Forum and G.8011 Ethernet Service Switching</title>
    <author fullname='L. Berger' initials='L.' surname='Berger'/>
    <author fullname='D. Fedyk' initials='D.' surname='Fedyk'/>
    <date month='October' year='2010'/>
  </front>
  <seriesInfo name='RFC' value='6004'/>
  <seriesInfo name='DOI' value='10.17487/RFC6004'/>
</reference>

<reference anchor='RFC6511' target='https://www.rfc-editor.org/info/rfc6511'>
  <front>
    <title>Non-Penultimate Hop Popping Behavior and Out-of-Band Mapping for RSVP-TE Label Switched Paths</title>
    <author fullname='Z. Ali' initials='Z.' surname='Ali'/>
    <author fullname='G. Swallow' initials='G.' surname='Swallow'/>
    <author fullname='R. Aggarwal' initials='R.' surname='Aggarwal'/>
    <date month='February' year='2012'/>
    <abstract>
      <t>There are many deployment scenarios that require an egress Label Switching Router (LSR) to receive binding of the Resource Reservation Protocol - Traffic Engineering (RSVP-TE) Label Switched Path (LSP) to an application and a payload identifier using some "out-of-band" (OOB) mechanism. This document defines protocol mechanisms to address this requirement. The procedures described in this document are equally applicable for point-to-point (P2P) and point-to-multipoint (P2MP) LSPs. [STANDARDS-TRACK]</t>
    </abstract>
  </front>
  <seriesInfo name='RFC' value='6511'/>
  <seriesInfo name='DOI' value='10.17487/RFC6511'/>
</reference>

<reference anchor='RFC7139' target='https://www.rfc-editor.org/info/rfc7139'>
  <front>
    <title>GMPLS Signaling Extensions for Control of Evolving G.709 Optical Transport Networks</title>
    <author fullname='F. Zhang' initials='F.' role='editor' surname='Zhang'/>
    <author fullname='G. Zhang' initials='G.' surname='Zhang'/>
    <author fullname='S. Belotti' initials='S.' surname='Belotti'/>
    <author fullname='D. Ceccarelli' initials='D.' surname='Ceccarelli'/>
    <author fullname='K. Pithewan' initials='K.' surname='Pithewan'/>
    <date month='March' year='2014'/>
    <abstract>
      <t>ITU-T Recommendation G.709 [G709-2012] introduced new Optical channel Data Unit (ODU) containers (ODU0, ODU4, ODU2e, and ODUflex) and enhanced Optical Transport Network (OTN) flexibility.</t>
      <t>This document updates the ODU-related portions of RFC 4328 to provide extensions to GMPLS signaling to control the full set of OTN features, including ODU0, ODU4, ODU2e, and ODUflex.</t>
    </abstract>
  </front>
  <seriesInfo name='RFC' value='7139'/>
  <seriesInfo name='DOI' value='10.17487/RFC7139'/>
</reference>

<reference anchor='RFC7551' target='https://www.rfc-editor.org/info/rfc7551'>
  <front>
    <title>RSVP-TE Extensions for Associated Bidirectional Label Switched Paths (LSPs)</title>
    <author fullname='F. Zhang' initials='F.' role='editor' surname='Zhang'/>
    <author fullname='R. Jing' initials='R.' surname='Jing'/>
    <author fullname='R. Gandhi' initials='R.' role='editor' surname='Gandhi'/>
    <date month='May' year='2015'/>
    <abstract>
      <t>This document describes Resource Reservation Protocol (RSVP) extensions to bind two point-to-point unidirectional Label Switched Paths (LSPs) into an associated bidirectional LSP. The association is achieved by defining new Association Types for use in ASSOCIATION and in Extended ASSOCIATION Objects. One of these types enables independent provisioning of the associated bidirectional LSPs on both sides, while the other enables single-sided provisioning. The REVERSE_LSP Object is also defined to enable a single endpoint to trigger creation of the reverse LSP and to specify parameters of the reverse LSP in the single-sided provisioning case.</t>
    </abstract>
  </front>
  <seriesInfo name='RFC' value='7551'/>
  <seriesInfo name='DOI' value='10.17487/RFC7551'/>
</reference>

<reference anchor='RFC7571' target='https://www.rfc-editor.org/info/rfc7571'>
  <front>
    <title>GMPLS RSVP-TE Extensions for Lock Instruct and Loopback</title>
    <author fullname='J. Dong' initials='J.' surname='Dong'/>
    <author fullname='M. Chen' initials='M.' surname='Chen'/>
    <author fullname='Z. Li' initials='Z.' surname='Li'/>
    <author fullname='D. Ceccarelli' initials='D.' surname='Ceccarelli'/>
    <date month='July' year='2015'/>
    <abstract>
      <t>This document specifies extensions to Resource Reservation Protocol - Traffic Engineering (RSVP-TE) to support Lock Instruct (LI) and Loopback (LB) mechanisms for Label Switched Paths (LSPs). These mechanisms are applicable to technologies that use Generalized MPLS (GMPLS) for the control plane.</t>
    </abstract>
  </front>
  <seriesInfo name='RFC' value='7571'/>
  <seriesInfo name='DOI' value='10.17487/RFC7571'/>
</reference>

<reference anchor='RFC7579' target='https://www.rfc-editor.org/info/rfc7579'>
  <front>
    <title>General Network Element Constraint Encoding for GMPLS-Controlled Networks</title>
    <author fullname='G. Bernstein' initials='G.' role='editor' surname='Bernstein'/>
    <author fullname='Y. Lee' initials='Y.' role='editor' surname='Lee'/>
    <author fullname='D. Li' initials='D.' surname='Li'/>
    <author fullname='W. Imajuku' initials='W.' surname='Imajuku'/>
    <author fullname='J. Han' initials='J.' surname='Han'/>
    <date month='June' year='2015'/>
    <abstract>
      <t>Generalized Multiprotocol Label Switching (GMPLS) can be used to control a wide variety of technologies. In some of these technologies, network elements and links may impose additional routing constraints such as asymmetric switch connectivity, non-local label assignment, and label range limitations on links.</t>
      <t>This document provides efficient, protocol-agnostic encodings for general information elements representing connectivity and label constraints as well as label availability. It is intended that protocol-specific documents will reference this memo to describe how information is carried for specific uses.</t>
    </abstract>
  </front>
  <seriesInfo name='RFC' value='7579'/>
  <seriesInfo name='DOI' value='10.17487/RFC7579'/>
</reference>

<reference anchor='RFC3688' target='https://www.rfc-editor.org/info/rfc3688'>
  <front>
    <title>The IETF XML Registry</title>
    <author fullname='M. Mealling' initials='M.' surname='Mealling'/>
    <date month='January' year='2004'/>
    <abstract>
      <t>This document describes an IANA maintained registry for IETF standards which use Extensible Markup Language (XML) related items such as Namespaces, Document Type Declarations (DTDs), Schemas, and Resource Description Framework (RDF) Schemas.</t>
    </abstract>
  </front>
  <seriesInfo name='BCP' value='81'/>
  <seriesInfo name='RFC' value='3688'/>
  <seriesInfo name='DOI' value='10.17487/RFC3688'/>
</reference>

<reference anchor='RFC9314' target='https://www.rfc-editor.org/info/rfc9314'>
  <front>
    <title>YANG Data Model for Bidirectional Forwarding Detection (BFD)</title>
    <author fullname='M. Jethanandani' initials='M.' role='editor' surname='Jethanandani'/>
    <author fullname='R. Rahman' initials='R.' role='editor' surname='Rahman'/>
    <author fullname='L. Zheng' initials='L.' role='editor' surname='Zheng'/>
    <author fullname='S. Pallagatti' initials='S.' surname='Pallagatti'/>
    <author fullname='G. Mirsky' initials='G.' surname='Mirsky'/>
    <date month='September' year='2022'/>
    <abstract>
      <t>This document defines a YANG data model that can be used to configure and manage Bidirectional Forwarding Detection (BFD).</t>
      <t>The YANG modules in this document conform to the Network Management Datastore Architecture (NMDA) (RFC 8342). This document updates "YANG Data Model for Bidirectional Forwarding Detection (BFD)" (RFC 9127).</t>
    </abstract>
  </front>
  <seriesInfo name='RFC' value='9314'/>
  <seriesInfo name='DOI' value='10.17487/RFC9314'/>
</reference>




    </references>


<section anchor="changes-bis"><name>Changes from RFC 8776</name>

<t>To be added in a future revision of this draft.</t>

<section anchor="te-yang-diff"><name>TE Types YANG Diffs</name>

<t>RFC Editor: please remove this appendix before publication.</t>

<t>This section provides the diff between the YANG module in section 3.1 of <xref target="RFC8776"/> and the YANG model revision in <xref target="te-yang-code"/>.</t>

<t>The intention of this appendix is to facilitate focusing the review of the YANG model in <xref target="te-yang-code"/> to the changes compared with the YANG model in <xref target="RFC8776"/>.</t>

<t>This diff has been generated using the following UNIX commands to compare the YANG module revisions in section 3.1 of <xref target="RFC8776"/> and in <xref target="te-yang-code"/>:</t>

<figure><artwork><![CDATA[
diff ietf-te-types@2020-06-10.yang ietf-te-types.yang 
     > model-diff.txt
sed 's/^/    /' model-diff.txt > model-diff-spaces.txt
sed 's/^    >   /    >   /' model-diff-spaces.txt 
    > model-updates.txt
]]></artwork></figure>

<t>The output (model-updates.txt) is reported here:</t>

<figure><artwork><![CDATA[
21a22,31
>   import ietf-network {
>     prefix "nw";
>     reference "RFC 8345: A YANG Data Model for Network Topologies";
>   }
> 
>   import ietf-network-topology {
>     prefix "nt";
>     reference "RFC 8345: A YANG Data Model for Network Topologies";
>   }
> 
30c40
<                <mailto:tsaad@juniper.net>
---
>                <mailto:tsaad.net@gmail.com>
55c65
<      Copyright (c) 2020 IETF Trust and the persons identified as
---
>      Copyright (c) 2023 IETF Trust and the persons identified as
60c70
<      the license terms contained in, the Simplified BSD License set
---
>      the license terms contained in, the Revised BSD License set
65,66c75,108
<      This version of this YANG module is part of RFC 8776; see the
<      RFC itself for full legal notices.";
---
>      This version of this YANG module is part of RFC XXXX
>      (https://www.rfc-editor.org/info/rfcXXXX); see the RFC itself
>      for full legal notices.";
> 
>   revision 2023-06-27 {
>     description
>       "Added:
>       - base identity lsp-provisioning-error-reason;
>       - identity association-type-diversity;
>       - identity tunnel-admin-state-auto;
>       - identity lsp-restoration-restore-none;
>       - base identity path-computation-error-reason and
>         its derived identities;
>       - base identity protocol-origin-type and
>         its derived identities;
>       - base identity svec-objective-function-type and its derived
>         identities;
>       - base identity svec-metric-type and its derived identities;
>       - grouping encoding-and-switching-type.
>       
>       Updated:
>       - description of the base identity objective-function-type;
>       - description and reference of identity action-exercise.
>       
>       Obsoleted:
>       - identity of-minimize-agg-bandwidth-consumption
>       - identity of-minimize-load-most-loaded-link
>       - identity of-minimize-cost-path-set";
>     reference
>       "RFC XXXX: Updated Common YANG Data Types for Traffic
>       Engineering";
>   }
>   // RFC Editor: replace XXXX with actual RFC number, update date
>   // information and remove this note
545a588,615
>   // CHANGE NOTE: The typedef path-type below has been
>   // added in this module revision
>   // RFC Editor: remove the note above and this note
>   typedef path-type {
>     type enumeration {
>       enum primary-path {
>         description
>           "Indicates that the TE path is a primary path.";
>       }
>       enum secondary-path {
>         description
>           "Indicates that the TE path is a secondary path.";
>       }
>       enum primary-reverse-path {
>         description
>           "Indicates that the TE path is a primary reverse path.";
>       }
>       enum secondary-reverse-path {
>         description
>           "Indicates that the TE path is a secondary reverse path.";
>       }
>     }
>     description
>       "The type of TE path, indicating whether a path is a primary, 
>       or a reverse primary, or a secondary, or a reverse secondary 
>       path.";
>   }
> 
606a677,684
>   // CHANGE NOTE: The base identity lsp-provisioning-error-reason 
>   // has been added in this module revision
>   // RFC Editor: remove the note above and this note
>   identity lsp-provisioning-error-reason {
>     description
>       "Base identity for LSP provisioning errors.";
>   }
> 
982a1061,1078
>   // CHANGE NOTE: The identity association-type-diversity below has 
>   // been added in this module revision
>   // RFC Editor: remove the note above and this note
>   identity association-type-diversity {
>     base association-type;
>     description
>       "Association Type diversity used to associate LSPs whose 
>       paths are to be diverse from each other.";
>     reference
>       "RFC8800: Path Computation Element Communication Protocol 
>       (PCEP) Extension for Label Switched Path (LSP) Diversity 
>       Constraint Signaling";
>   }
> 
>   // CHANGE NOTE: The description of the base identity 
>   // objective-function-type has been updated 
>   // in this module revision
>   // RFC Editor: remove the note above and this note
985c1081
<       "Base objective function type.";
---
>       "Base identity for path objective function type.";
1015a1112,1114
>   // CHANGE NOTE: The identity of-minimize-agg-bandwidth-consumption
>   // below has been obsoleted in this module revision
>   // RFC Editor: remove the note above and this note
1017a1117
>     status obsolete;
1020c1120
<        consumption.";
---
>       consumption.";
1023c1123
<        Computation Element Communication Protocol (PCEP)";
---
>       Computation Element Communication Protocol (PCEP)";
1025a1126,1128
>   // CHANGE NOTE: The identity of-minimize-load-most-loaded-link
>   // below has been obsoleted in this module revision
>   // RFC Editor: remove the note above and this note
1027a1131
>     status obsolete;
1030c1134
<        is carrying the highest load.";
---
>       is carrying the highest load.";
1033c1137
<        Computation Element Communication Protocol (PCEP)";
---
>       Computation Element Communication Protocol (PCEP)";
1035a1140,1142
>   // CHANGE NOTE: The identity of-minimize-cost-path-set
>   // below has been obsoleted in this module revision
>   // RFC Editor: remove the note above and this note
1037a1145
>     status obsolete;
1216a1325,1336
>   // CHANGE NOTE: The identity tunnel-admin-state-auto below
>   // has been added in this module revision
>   // RFC Editor: remove the note above and this note
>   identity tunnel-admin-state-auto {
>     base tunnel-admin-state-type;
>     description
>       "Tunnel administrative auto state. The administrative status
>       in state datastore transitions to 'tunnel-admin-up' when the
>       tunnel used by the client layer, and to 'tunnel-admin-down'
>       when it is not used by the client layer.";
>   }
> 
1321a1442,1450
>     // CHANGE NOTE: The identity lsp-restoration-restore-none 
>     // below has been added in this module revision
>     // RFC Editor: remove the note above and this note
>     identity lsp-restoration-restore-none {
>       base lsp-restoration-type;
>       description
>         "No LSP affected by a failure is restored.";
>     }
> 
1628a1758,1761
>   // cCHANGE NOTE: The description and reference of the 
>   // identity action-exercise have been updated in this module 
>   // revision
>   // RFC Editor: remove the note above and this note
1632,1633c1765,1767
<       "An action that starts testing whether or not APS communication
<        is operating correctly.  It is of lower priority than any
---
>       "An action that starts testing whether or not Automatic 
>        Protection Switching (APS) communication is operating 
>        correctly.  It is of lower priority than any
1636,1637c1770,1771
<       "RFC 4427: Recovery (Protection and Restoration) Terminology
<        for Generalized Multi-Protocol Label Switching (GMPLS)";
---
>       "ITU-T G.808.1 v4.0 (05/2014): Generic protection switching - 
>       Linear trail and subnetwork protection";
2110a2245,2641
>   // CHANGE NOTE: The base identity path-computation-error-reason 
>   // and its derived identities below have been
>   // added in this module revision
>   // RFC Editor: remove the note above and this note
>   identity path-computation-error-reason {
>     description
>       "Base identity for path computation error reasons.";
>   }
> 
>     identity path-computation-error-path-not-found {
>       base path-computation-error-reason;
>       description
>         "Path computation has failed because of an unspecified 
>         reason.";
>       reference
>         "Section 7.5 of RFC5440";
>     }
> 
>     identity path-computation-error-no-topology {
>       base path-computation-error-reason;
>       description
>         "Path computation has failed because there is no topology
>         with the provided topology-identifier.";
>     }
> 
>     identity path-computation-error-no-dependent-server {
>       base path-computation-error-reason;
>       description
>         "Path computation has failed because one or more dependent
>         path computation servers are unavailable.
> 
>         The dependent path computation server could be
>         a Backward-Recursive Path Computation (BRPC) downstream
>         PCE or a child PCE.";
>       reference
>         "RFC5441, RFC8685";
>     }
> 
>     identity path-computation-error-pce-unavailable {
>       base path-computation-error-reason;
>       description
>         "Path computation has failed because PCE is not available.
>         
>         It corresponds to bit 31 of the Flags field of the 
>         NO-PATH-VECTOR TLV.";
>       reference
>         "RFC5440;
>         
>         https://www.iana.org/assignments/pcep/pcep.xhtml";
>     }
> 
>     identity path-computation-error-no-inclusion-hop {
>       base path-computation-error-reason;
>       description
>         "Path computation has failed because there is no
>         node or link provided by one or more inclusion hops.";
>     }
> 
>     identity path-computation-error-destination-unknown-in-domain {
>       base path-computation-error-reason;
>       description
>         "Path computation has failed because the destination node is
>         unknown in indicated destination domain.
>         
>         It corresponds to bit 19 of the Flags field of the 
>         NO-PATH-VECTOR TLV.";
>       reference
>         "RFC8685;
>         
>         https://www.iana.org/assignments/pcep/pcep.xhtml";
>     }
> 
>     identity path-computation-error-no-resource {
>       base path-computation-error-reason;
>       description
>         "Path computation has failed because there is no
>         available resource in one or more domains.
>         
>         It corresponds to bit 20 of the Flags field of the 
>         NO-PATH-VECTOR TLV.";
>       reference
>         "RFC8685;
>         
>         https://www.iana.org/assignments/pcep/pcep.xhtml";
>     }
> 
>     identity path-computation-error-child-pce-unresponsive {
>       base path-computation-error-no-dependent-server;
>       description
>         "Path computation has failed because child PCE is not
>         responsive.
>         
>         It corresponds to bit 21 of the Flags field of the 
>         NO-PATH-VECTOR TLV.";
>       reference
>         "RFC8685;
>         
>         https://www.iana.org/assignments/pcep/pcep.xhtml";
>     }
> 
>     identity path-computation-error-destination-domain-unknown {
>       base path-computation-error-reason;
>       description
>         "Path computation has failed because the destination domain
>         was unknown.
>         
>         It corresponds to bit 22 of the Flags field of the 
>         NO-PATH-VECTOR TLV.";
>       reference
>         "RFC8685;
>         
>         https://www.iana.org/assignments/pcep/pcep.xhtml";
>     }
> 
>     identity path-computation-error-p2mp {
>       base path-computation-error-reason;
>       description
>         "Path computation has failed because of P2MP reachability
>         problem.
>         
>         It corresponds to bit 24 of the Flags field of the 
>         NO-PATH-VECTOR TLV.";
>       reference
>         "RFC8306;
>         
>         https://www.iana.org/assignments/pcep/pcep.xhtml";
>     }
> 
>     identity path-computation-error-no-gco-migration {
>       base path-computation-error-reason;
>       description
>         "Path computation has failed because of no Global Concurrent
>         Optimization (GCO) migration path found.
>         
>         It corresponds to bit 26 of the Flags field of the 
>         NO-PATH-VECTOR TLV.";
>       reference
>         "RFC5557;
>         
>         https://www.iana.org/assignments/pcep/pcep.xhtml";
>     }
> 
>     identity path-computation-error-no-gco-solution {
>       base path-computation-error-reason;
>       description
>         "Path computation has failed because of no GCO solution
>         found.
>         
>         It corresponds to bit 25 of the Flags field of the 
>         NO-PATH-VECTOR TLV.";
>       reference
>         "RFC5557;
>         
>         https://www.iana.org/assignments/pcep/pcep.xhtml";
>     }
> 
>     identity path-computation-error-pks-expansion {
>       base path-computation-error-reason;
>       description
>         "Path computation has failed because of Path-Key Subobject
>         (PKS)  expansion failure.
>         
>         It corresponds to bit 27 of the Flags field of the 
>         NO-PATH-VECTOR TLV.";
>       reference
>         "RFC5520;
>         
>         https://www.iana.org/assignments/pcep/pcep.xhtml";
>     }
> 
>     identity path-computation-error-brpc-chain-unavailable {
>       base path-computation-error-no-dependent-server;
>       description
>         "Path computation has failed because PCE BRPC chain
>         unavailable.
>         
>         It corresponds to bit 28 of the Flags field of the 
>         NO-PATH-VECTOR TLV.";
>       reference
>         "RFC5441;
>         
>         https://www.iana.org/assignments/pcep/pcep.xhtml";
>     }
> 
>     identity path-computation-error-source-unknown {
>       base path-computation-error-reason;
>       description
>         "Path computation has failed because source node is 
>         unknown.
>         
>         It corresponds to bit 29 of the Flags field of the 
>         NO-PATH-VECTOR TLV.";
>       reference
>         "RFC5440;
>         
>         https://www.iana.org/assignments/pcep/pcep.xhtml";
>     }
> 
>     identity path-computation-error-destination-unknown {
>       base path-computation-error-reason;
>       description
>         "Path computation has failed because destination node is
>         unknown.
>         
>         It corresponds to bit 30 of the Flags field of the 
>         NO-PATH-VECTOR TLV.";
>       reference
>         "RFC5440;
>         
>         https://www.iana.org/assignments/pcep/pcep.xhtml";
>     }
> 
>     identity path-computation-error-no-server {
>       base path-computation-error-reason;
>       description
>         "Path computation has failed because path computation
>         server is unavailable.";
>       reference
>         "RFC5440;
>         
>         https://www.iana.org/assignments/pcep/pcep.xhtml";
>     }
> 
>   // CHANGE NOTE: The base identity protocol-origin-type and 
>   // its derived identities below have been
>   // added in this module revision
>   // RFC Editor: remove the note above and this note
>   identity protocol-origin-type {
>     description
>       "Base identity for protocol origin type.";
>   }
> 
>     identity protocol-origin-api {
>       base protocol-origin-type;
>       description
>         "Protocol origin is via Application Programmable Interface
>         (API).";
>     }
> 
>     identity protocol-origin-pcep {
>       base protocol-origin-type;
>       description
>         "Protocol origin is Path Computation Engine Protocol 
>         (PCEP).";
>       reference "RFC5440";
>     }
> 
>     identity protocol-origin-bgp {
>       base protocol-origin-type;
>       description
>         "Protocol origin is Border Gateway Protocol (BGP).";
>       reference "RFC9012";
>     }
> 
>   // CHANGE NOTE: The base identity svec-objective-function-type 
>   // and its derived identities below have been
>   // added in this module revision
>   // RFC Editor: remove the note above and this note
>   identity svec-objective-function-type {
>     description
>       "Base identity for SVEC objective function type.";
>     reference
>       "RFC5541: Encoding of Objective Functions in the Path
>        Computation Element Communication Protocol (PCEP).";
>   }
> 
>     identity svec-of-minimize-agg-bandwidth-consumption {
>       base svec-objective-function-type;
>       description
>         "Objective function for minimizing aggregate bandwidth 
>         consumption (MBC).";
>       reference
>         "RFC5541: Encoding of Objective Functions in the Path
>         Computation Element Communication Protocol (PCEP).";
>     }
> 
>     identity svec-of-minimize-load-most-loaded-link {
>       base svec-objective-function-type;
>       description
>         "Objective function for minimizing the load on the link that 
>         is carrying the highest load (MLL).";
>       reference
>         "RFC5541: Encoding of Objective Functions in the Path
>         Computation Element Communication Protocol (PCEP).";
>     }
> 
>     identity svec-of-minimize-cost-path-set {
>       base svec-objective-function-type;
>       description
>         "Objective function for minimizing the cost on a path set 
>         (MCC).";
>       reference
>         "RFC5541: Encoding of Objective Functions in the Path
>         Computation Element Communication Protocol (PCEP).";
>     }
> 
>     identity svec-of-minimize-common-transit-domain {
>       base svec-objective-function-type;
>       description
>         "Objective function for minimizing the number of common 
>         transit domains (MCTD).";
>       reference
>         "RFC8685: Path Computation Element Communication Protocol 
>         (PCEP) Extensions for the Hierarchical Path Computation 
>         Element (H-PCE) Architecture.";
>     }
> 
>     identity svec-of-minimize-shared-link {
>       base svec-objective-function-type;
>       description
>         "Objective function for minimizing the number of shared 
>         links (MSL).";
>       reference
>         "RFC8685: Path Computation Element Communication Protocol 
>         (PCEP) Extensions for the Hierarchical Path Computation 
>         Element (H-PCE) Architecture.";
>     }
> 
>     identity svec-of-minimize-shared-srlg {
>       base svec-objective-function-type;
>       description
>         "Objective function for minimizing the number of shared 
>         Shared Risk Link Groups (SRLG) (MSS).";
>       reference
>         "RFC8685: Path Computation Element Communication Protocol 
>         (PCEP) Extensions for the Hierarchical Path Computation 
>         Element (H-PCE) Architecture.";
>     }
> 
>     identity svec-of-minimize-shared-nodes {
>       base svec-objective-function-type;
>       description
>         "Objective function for minimizing the number of shared 
>         nodes (MSN).";
>       reference
>         "RFC8685: Path Computation Element Communication Protocol 
>         (PCEP) Extensions for the Hierarchical Path Computation 
>         Element (H-PCE) Architecture.";
>     }
> 
>   // CHANGE NOTE: The base identity svec-metric-type and 
>   // its derived identities below have been
>   // added in this module revision
>   // RFC Editor: remove the note above and this note
>   identity svec-metric-type {
>     description
>       "Base identity for SVEC metric type.";
>     reference
>       "RFC5541: Encoding of Objective Functions in the Path
>        Computation Element Communication Protocol (PCEP).";
>   }
> 
>     identity svec-metric-cumul-te {
>       base svec-metric-type;
>       description
>         "Cumulative TE cost.";
>       reference
>         "RFC5541: Encoding of Objective Functions in the Path
>         Computation Element Communication Protocol (PCEP).";
>     }
> 
>     identity svec-metric-cumul-igp {
>       base svec-metric-type;
>       description
>         "Cumulative IGP cost.";
>       reference
>         "RFC5541: Encoding of Objective Functions in the Path
>         Computation Element Communication Protocol (PCEP).";
>     }
> 
>     identity svec-metric-cumul-hop {
>       base svec-metric-type;
>       description
>         "Cumulative Hop path metric.";
>       reference
>         "RFC5541: Encoding of Objective Functions in the Path
>         Computation Element Communication Protocol (PCEP).";
>     }
> 
>     identity svec-metric-aggregate-bandwidth-consumption {
>       base svec-metric-type;
>       description
>         "Aggregate bandwidth consumption.";
>       reference
>         "RFC5541: Encoding of Objective Functions in the Path
>         Computation Element Communication Protocol (PCEP).";
>     }
> 
>     identity svec-metric-load-of-the-most-loaded-link {
>       base svec-metric-type;
>       description
>         "Load of the most loaded link.";
>       reference
>         "RFC5541: Encoding of Objective Functions in the Path
>         Computation Element Communication Protocol (PCEP).";
>     }
> 
2514a3046,3054
>           must "node-id-uri or node-id" {
>             description
>               "At least one node identifier MUST be present.";
>           }
>           leaf node-id-uri {
>             type nw:node-id;
>             description
>               "The identifier of a node in the topology.";
>           }
2517d3056
<             mandatory true;
2566a3106,3116
>           must "(link-tp-id-uri or link-tp-id) and " +
>                 "(node-id-uri or node-id)" {
>             description
>               "At least one node identifier and at least one Link 
>               Termination Point (LTP) identifier MUST be present.";
>           }
>           leaf link-tp-id-uri {
>             type nt:tp-id;
>             description
>               "Link Termination Point (LTP) identifier.";
>           }
2569d3118
<             mandatory true;
2574a3124,3128
>           leaf node-id-uri {
>             type nw:node-id;
>             description
>               "The identifier of a node in the topology.";
>           }
2577d3130
<             mandatory true;
2646a3200,3203
>           must "node-id-uri or node-id" {
>             description
>               "At least one node identifier MUST be present.";
>           }
2648a3206,3210
>           leaf node-id-uri {
>             type nw:node-id;
>             description
>               "The identifier of a node in the topology.";
>           }
2651d3212
<             mandatory true;
2696a3258,3268
>           must "(link-tp-id-uri or link-tp-id) and " +
>               "(node-id-uri or node-id)" {
>             description
>               "At least one node identifier and at least one Link 
>               Termination Point (LTP) identifier MUST be present.";
>           }
>           leaf link-tp-id-uri {
>             type nt:tp-id;
>             description
>               "Link Termination Point (LTP) identifier.";
>           }
2699d3270
<             mandatory true;
2704a3276,3280
>           leaf node-id-uri {
>             type nw:node-id;
>             description
>               "The identifier of a node in the topology.";
>           }
2968a3545,3549
>     leaf network-id {
>       type nw:network-id;
>       description
>         "The network topology identifier.";
>     }
3379c3960,3987
< }
\ No newline at end of file
---
> 
>   // NOTE: The grouping encoding-and-switching-type below has been
>   // added in this module revision
>   // RFC Editor: remove the note above and this note
>   grouping encoding-and-switching-type {
>     description
>       "Common grouping to define the LSP encoding and
>       switching types";
>     leaf encoding {
>       type identityref {
>         base te-types:lsp-encoding-types;
>       }
>       description
>         "LSP encoding type.";
>       reference
>         "RFC3945";
>     }
>     leaf switching-type {
>       type identityref {
>         base te-types:switching-capabilities;
>       }
>       description
>         "LSP switching type.";
>       reference
>         "RFC3945";
>     }
>   }
> }
]]></artwork></figure>

</section>
<section anchor="packet-te-types-yang-diffs"><name>Packet TE Types YANG Diffs</name>

<t>RFC Editor: please remove this appendix before publication.</t>

<t>This section provides the diff between the YANG module in section 3.2 of <xref target="RFC8776"/> and the YANG model revision in <xref target="pkt-yang-code"/>.</t>

<t>The intention of this appendix is to facilitate focusing the review of the YANG model in <xref target="pkt-yang-code"/> to the changes compared with the YANG model in <xref target="RFC8776"/>.</t>

<t>This diff has been generated using the following UNIX commands to compare the YANG module revisions in section 3.2 of <xref target="RFC8776"/> and in <xref target="pkt-yang-code"/>:</t>

<figure><artwork><![CDATA[
diff ietf-te-packet-types@2020-06-10.yang ietf-te-packet-types.yang 
     > model-diff.txt
sed 's/^/    /' model-diff.txt > model-diff-spaces.txt
sed 's/^    >   /    >   /' model-diff-spaces.txt 
    > model-updates.txt
]]></artwork></figure>

<t>The output (model-updates.txt) is reported here:</t>

<figure><artwork><![CDATA[
11c11,12
<       "RFC 8776: Common YANG Data Types for Traffic Engineering";
---
>       "RFCXXXX: Updated Common YANG Data Types for Traffic 
>       Engineering";
12a14,15
>   // RFC Editor: replace XXXX with actual RFC number
>   // and remove this note
22c25
<                <mailto:tsaad@juniper.net>
---
>                <mailto:tsaad.net@gmail.com>
41c44
<      Copyright (c) 2020 IETF Trust and the persons identified as
---
>      Copyright (c) 2023 IETF Trust and the persons identified as
46c49
<      the license terms contained in, the Simplified BSD License set
---
>      the license terms contained in, the Revised BSD License set
51,52c54,71
<      This version of this YANG module is part of RFC 8776; see the
<      RFC itself for full legal notices.";
---
>      This version of this YANG module is part of RFC XXXX
>      (https://www.rfc-editor.org/info/rfcXXXX); see the RFC itself
>      for full legal notices.";
> 
>   revision 2023-07-10 {
>     description
>       "Added common TE packet identities:
>        - bandwidth-profile-type.
> 
>        Added common TE packet groupings:
>        - te-packet-path-bandwidth;
>        - te-packet-link-bandwidth.";
>     reference
>       "RFC XXXX: Updated Common YANG Data Types for Traffic
>       Engineering";
>   }
>   // RFC Editor: replace XXXX with actual RFC number, update date
>   // information and remove this note
61c80,126
<   /**
---
>   /*
>    * Identities
>    */
> 
>   // CHANGE NOTE: The base identity bandwidth-profile-type and 
>   // its derived identities below have been
>   // added in this module revision
>   // RFC Editor: remove the note above and this note
>   identity bandwidth-profile-type {
>     description
>       "Bandwidth Profile Types";
>   }
> 
>     identity mef-10-bwp {
>       base bandwidth-profile-type;
>       description
>         "MEF 10 Bandwidth Profile";
>       reference
>         "MEF 10.3: Ethernet Services Attributes Phase 3";
>     }
> 
>     identity rfc-2697-bwp {
>       base bandwidth-profile-type;
>       description
>         "RFC 2697 Bandwidth Profile";
>       reference
>         "RFC2697: A Single Rate Three Color Marker";
>     }
> 
>     identity rfc-2698-bwp {
>       base bandwidth-profile-type;
>       description
>         "RFC 2698 Bandwidth Profile";
>       reference
>         "RFC2698: A Two Rate Three Color Marker";
>     }
> 
>     identity rfc-4115-bwp {
>       base bandwidth-profile-type;
>       description
>         "RFC 4115 Bandwidth Profile";
>       reference
>         "RFC4115: A Differentiated Service Two-Rate, Three-Color 
>         Marker with Efficient Handling of in-Profile Traffic";
>     }
> 
>   /*
180a246,249
>   /*
>    * Groupings
>    */
> 
472a542,611
>     }
>   }
> 
>   // CHANGE NOTE: The te-packet-path-bandwidth below has been
>   // added in this module revision
>   // RFC Editor: remove the note above and this note
>   grouping te-packet-path-bandwidth {
>     description
>       "Path bandwidth for Packet. ";
>     leaf bandwidth-profile-name {
>       type string;
>       description "Name of Bandwidth Profile.";
>     }
>     leaf bandwidth-profile-type {
>       type identityref {
>         base bandwidth-profile-type;
>       }
>       description "Type of Bandwidth Profile.";
>     }
>     leaf cir {
>       type uint64;
>       units "bits/second";
>       mandatory true;
>       description
>         "Committed Information Rate (CIR).";
>     }
>     leaf cbs {
>       type uint64;
>       units "bits/second";
>       mandatory true;
>       description
>         "Committed Burst Size (CBS).";
>     }
>     leaf eir {
>       type uint64;
>       units "bits/second";
>       description
>         "Excess Information Rate (EIR).";
>     }
>     leaf ebs {
>       type uint64;
>       units "bytes";
>       description
>         "Excess Burst Size (EBS).";
>     }
>     leaf pir {
>       type uint64;
>       units "bits/second";
>       description
>         "Peak Information Rate (PIR).";
>     }
>     leaf pbs {
>       type uint64;
>       units "bytes";
>       description
>         "Peak Burst Size (PBS).";
>     }
>   }
> 
>   // CHANGE NOTE: The te-packet-path-bandwidth below has been
>   // added in this module revision
>   // RFC Editor: remove the note above and this note
>   grouping te-packet-link-bandwidth {
>     description
>       "Link Bandwidth for Packet. ";
>     leaf packet-bandwidth {
>       type uint64;
>       units "bits/second";
>       description
>         "Available bandwith value.";
]]></artwork></figure>

</section>
</section>
<section anchor="options"><name>Option Considered for updating RFC8776</name>

<t>RFC Editor: please remove this appendix before publication.</t>

<t>The concern is how to be able to update the ietf-te-types YANG module published in <xref target="RFC8776"/> without delaying too much the progress of the mature WG documents.</t>

<t>Three possible options have been identified to address this concern.</t>

<t>One option is to keep these definitions in the YANG modules where they have initially been defined: other YANG modules can still import them. The drawback of this approach is that it defeating the value of common YANG modules like ietf-te-types since common definitions will be spread around multiple specific YANG modules.</t>

<t>A second option is to define them in a new common YANG module (e.g., ietf-te-types-ext). The drawback of this approach is that it will increase the number of YANG modules providing tiny updates to the ietf-te-types YANG module.</t>

<t>A third option is to develop a revision of the ietf-te-types YANG module within an RFC8776-bis. The drawback of this approach is that the process for developing a big RFC8776-bis just for a tiny update is too high. Moreover, as suggested during IETF 113 Netmod WG discussion, a new revision of the ietf-te-packet-types YANG module, which is also defined in <xref target="RFC8776"/> but it does not need to be revised, needs to be published just to change its reference to RFC8776-bis (see <xref target="RFC9314"/>).</t>

<t>A fourth option, considered in the -00 WG version, was to:</t>

<t><list style="symbols">
  <t>describe within the document only the updates to the ietf-te-types YANG module proposed by this document;</t>
  <t>include the whole updated YANG model within the main body;</t>
  <t>add some notes, to be removed before publication, within updated YANG model to focus the review only to the updates to the ietf-te-types YANG module proposed by this document.</t>
</list></t>

<t>Based on the feedbacks from IETF 114 discussion, this version has been restructured to become an RFC8776-bis, with some notes, to be removed before publication, to focus the review only to the updates to the ietf-te-types YANG module proposed by this document.</t>

<t>During the Netmod WG session at IETF 114, an alternative process has been introduced:</t>

<t>https://datatracker.ietf.org/meeting/114/materials/slides-114-netmod-ad-topic-managing-the-evolution-of-ietf-yang-modules-00.pdf</t>

<t>Future updates of this document could align with the proposed approach.</t>

</section>
<section numbered="false" anchor="acknowledgements"><name>Acknowledgements</name>

<t>The authors would like to thank 
Robert Wilton, Lou Berger, Mahesh Jethanandani and Jeff Haas
for their valuable input to the discussion
about the process to follow to provide tiny updates to a YANG module already published as an RFC.</t>

<t>This document was prepared using kramdown.</t>

</section>

    <section anchor="contributors" numbered="false" toc="include" removeInRFC="false">
        <name>Contributors</name>
    <contact initials="R." surname="Gandhi" fullname="Rakesh Gandhi">
      <organization>Cisco Systems, Inc.</organization>
      <address>
        <email>rgandhi@cisco.com</email>
      </address>
    </contact>
    </section>

  </back>

<!-- ##markdown-source:
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
+O5er++8RBESSAPGs5c4V0EDfeP83XoJxltkgZMh3pzl8ou109Zia5ju03wI
p11b70zLJf3I7j+FY9k8/bqC/nNXkM2xtSvoafjJvnrJvnrJ7L+vXrIidl+V
sK9byOJbyCz+t6JJO4v37Sn4wOp3yeJIp++Ty3es1Po88K/OvfJ11X2Rq24m
r1iNf6UiLLjSLcbsCMoJOSM5VPg6bnKNMT9ivHiAPlYjS8D2jRkwCx4yH5aT
X7wg3aGfAdwgzFMsot1yeWhKxGJxifjlINXAqp2hokv/4xK7VMCm+F+V31jh
qN+vdqadREMsDw4r7G7kY/Vp5fcTE2GMFxErY2Imwc7tudQOSplgygQwZptw
IlYs+Q4LYjDNvMQIzRRGQRRna53OJr/iR8NNKdo21ZER2QZmzs33YChgu4pX
14vvAXEKP03rzvmTUwG4BdwalKqwb4HDqki7Xm01pnnJWIFwoW9r1RZSpoyJ
pfwkZ1UhsMoTTBe0IOfU50yl3thvqthbz5y4Cjg5mlBQIs4JUFwXFquuL29g
YsLg90XEMwLAhKFQ/m5CMM8DQVm5GwWDEesCCMekgdoqZQw1iFJjhFV7ec3q
AXDNa4dI8Jirp67Dx10/DVgssIJmIubvZA1Bh/OuoCo2n7KG5lsFaWbeHVy/
adF7sEOKdFgZ2E9A1EUdxvDsEclHzAW48vh0jOPveToocQ7vW4H9D7ow2uMB
GwslsHFw45TA/IkokuF/9MaT0DfFiM0Gf7SYwEetCwvcr2oirDo/ON3a9j+0
aP9Hp/tlV7wvpuRZmPZmClcx+Jymabq2/sliU9aBsb17FWRjb1JQtu7hUX/k
f3S5LPUUrUumpmCxSvj/jTfRpbAbxYXJUFlpXUoPGS9BPhGexCkZOKYZJFQ9
ep0XTEdvlKooCVcVuQpuSG5grR8Txqoe7GpxbdH1O7g28DIGD1fnfaYcTLqd
FEvXMFK8qtYcG2eqhv51JtsRjNT/Z45mJ+D7xvdImv0LbEOHi7XwmwYYWflC
peyMvXtc1aLIOFmOV3h5XHZvjuEYL87AlBxJPInDqskBqxYNAPQktUcgxaus
zULcJy+6w4pM9lx35MVJ9GdKEa5pzlcMelmBQ/7k9Pa63W4hcamA6Z+c7sdu
r4t/vQ3EJupbvbn2cNe66yTK/WxDOWPBLgW+mMS8hwDUScHpyoOlcenhAhRG
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

-->

</rfc>

