<?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.7.19 (Ruby 3.2.3) -->


<!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-14" 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="I." surname="Bryskin" fullname="Igor Bryskin">
      <organization>Individual</organization>
      <address>
        <email>i_bryskin@yahoo.com</email>
      </address>
    </author>

    <date year="2024" month="November" day="05"/>

    
    <workgroup>TEAS Working Group</workgroup>
    

    <abstract>


<?line 67?>

<t>This document defines a collection of common data types, identities, and groupings in YANG data modeling language. These derived common data types, identities and groupings are intended to be imported by other modules, e.g., those which model the Traffic Engineering (TE) configuration and state capabilities.</t>

<t>This document obsoletes RFC 8776.</t>



    </abstract>



  </front>

  <middle>


<?line 73?>

<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"/> or RESTCONF <xref target="RFC8040"/>. 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 data types, identities, and groupings are mainly designed to be the common definitions applicable for modeling Traffic Engineering (TE) features in model(s) defined outside of this document. Nevertheless, these common definitions can be used by any other module per the guidance in <xref section="4.12" sectionFormat="of" target="I-D.ietf-netmod-rfc8407bis"/>.</t>

<t>This document adds new 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"/>. For further details, refer to <xref target="changes-bis"/>.</t>

<section anchor="terminology"><name>Terminology</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.
<?line -6?></t>

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

</section>
<section anchor="tree-diagrams"><name>Tree Diagrams</name>

<t>Tree diagrams used in this document follow the notation defined in <xref target="RFC8340"/>.</t>

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

<t>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 section="3" sectionFormat="of" target="RFC6991"/></c>
      <c>inet</c>
      <c>ietf-inet-types</c>
      <c><xref section="4" sectionFormat="of" 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>

<ul empty="true"><li>
  <t>RFC Editor: Please replace XXXX through this document with the RFC number assigned to this document. Please remove this note.</t>
</li></ul>

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

<dl>
  <dt>APS:</dt>
  <dd>
    <t>Automatic Protection Switching</t>
  </dd>
  <dt>DS-TE:</dt>
  <dd>
    <t>Differentiated Services Traffic Engineering</t>
  </dd>
  <dt>GMPLS:</dt>
  <dd>
    <t>Generalized Multiprotocol Label Switching</t>
  </dd>
  <dt>LER:</dt>
  <dd>
    <t>Label Edge Router</t>
  </dd>
  <dt>LSP:</dt>
  <dd>
    <t>Label Switched Path</t>
  </dd>
  <dt>LSR:</dt>
  <dd>
    <t>Label Switching Router</t>
  </dd>
  <dt>MPLS:</dt>
  <dd>
    <t>Multiprotocol Label Switching</t>
  </dd>
  <dt>NBMA:</dt>
  <dd>
    <t>Non-Broadcast Multi-Access</t>
  </dd>
  <dt>PM:</dt>
  <dd>
    <t>Performance Metrics</t>
  </dd>
  <dt>RSVP:</dt>
  <dd>
    <t>Resource Reservation Protocol</t>
  </dd>
  <dt>SD:</dt>
  <dd>
    <t>Signal Degrade</t>
  </dd>
  <dt>SF:</dt>
  <dd>
    <t>Signal Fail</t>
  </dd>
  <dt>SRLG:</dt>
  <dd>
    <t>Shared Risk Link Group</t>
  </dd>
  <dt>TE:</dt>
  <dd>
    <t>Traffic Engineering</t>
  </dd>
  <dt>WTR:</dt>
  <dd>
    <t>Wait-to-Restore</t>
  </dd>
</dl>

</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 groupings:</t>

<dl>
  <dt>te-bandwidth:</dt>
  <dd>
    <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>
  </dd>
  <dt>te-label:</dt>
  <dd>
    <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>
  </dd>
  <dt>performance-metrics-attributes:</dt>
  <dd>
    <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>
  </dd>
  <dt>performance-metrics-throttle-container:</dt>
  <dd>
    <t>A YANG grouping that defines configurable thresholds for advertisement suppression and measurement intervals.</t>
  </dd>
</dl>

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

<dl>
  <dt>te-ds-class:</dt>
  <dd>
    <t>A type representing the Differentiated Services (DS) Class-Type of traffic as defined in <xref target="RFC4124"/>.</t>
  </dd>
  <dt>te-label-direction:</dt>
  <dd>
    <t>An enumerated type for specifying the forward or reverse direction of a label.</t>
  </dd>
  <dt>te-hop-type:</dt>
  <dd>
    <t>An enumerated type for specifying that a hop is loose or strict.</t>
  </dd>
  <dt>te-global-id:</dt>
  <dd>
    <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 section="3" sectionFormat="of" target="RFC6370"/> and <xref section="3" sectionFormat="of" target="RFC5003"/>. This attribute type is used solely to provide a globally unique context for TE topologies.</t>
  </dd>
  <dt>te-node-id:</dt>
  <dd>
    <t>A type representing the identifier for a node in a TE topology. The identifier is represented either as 4 octets in dotted-quad notation or as 16 octets in full, mixed, shortened, or shortened-mixed IPv6 address notation.</t>
  </dd>
  <dt/>
  <dd>
    <t>This attribute MAY be mapped to the Router Address TLV described in <xref section="2.4.1" sectionFormat="of" target="RFC3630"/>, the TE Router ID described in <xref section="6.2" sectionFormat="of" target="RFC6827"/>, the Traffic Engineering Router ID TLV described in <xref section="4.3" sectionFormat="of" target="RFC5305"/>, or the TE Router ID TLV described in <xref section="3.2.1" sectionFormat="of" target="RFC6119"/>.</t>
  </dd>
  <dt/>
  <dd>
    <t>The reachability of such a TE node MAY be achieved by a mechanism such as that described in <xref section="6.2" sectionFormat="of" target="RFC6827"/>.</t>
  </dd>
  <dt>te-topology-id:</dt>
  <dd>
    <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>
  </dd>
  <dt>te-tp-id:</dt>
  <dd>
    <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>
  </dd>
  <dt>te-path-disjointness:</dt>
  <dd>
    <t>A type representing the different resource disjointness options for a TE tunnel path as defined in <xref target="RFC4872"/>.</t>
  </dd>
  <dt>admin-groups:</dt>
  <dd>
    <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>
  </dd>
  <dt>srlg:</dt>
  <dd>
    <t>A type representing the Shared Risk Link Group (SRLG) as defined in <xref target="RFC4203"/> and <xref target="RFC5307"/>.</t>
  </dd>
  <dt>te-metric:</dt>
  <dd>
    <t>A type representing the TE metric as defined in <xref target="RFC3785"/>.</t>
  </dd>
  <dt>te-recovery-status:</dt>
  <dd>
    <t>An enumerated type for the different statuses of a recovery action as defined in <xref target="RFC6378"/> and <xref target="RFC4427"/>.</t>
  </dd>
</dl>

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

<dl>
  <dt>path-attribute-flags:</dt>
  <dd>
    <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>
  </dd>
  <dt>link-protection-type:</dt>
  <dd>
    <t>A base YANG identity for supported link protection types as defined in <xref target="RFC4872"/>.</t>
  </dd>
  <dt>restoration-scheme-type:</dt>
  <dd>
    <t>A base YANG identity for supported LSP restoration schemes as defined in <xref target="RFC4872"/>.</t>
  </dd>
  <dt>protection-external-commands:</dt>
  <dd>
    <t>A base YANG identity for supported protection-related external commands used for troubleshooting purposes, as defined in <xref target="RFC4872"/>, <xref target="RFC6368"/>, <xref target="RFC7271"/> and <xref target="RFC4427"/>.</t>
  </dd>
  <dt>association-type:</dt>
  <dd>
    <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>
  </dd>
  <dt>objective-function-type:</dt>
  <dd>
    <t>A base YANG identity for supported path objective functions as defined in <xref target="RFC5541"/>.</t>
  </dd>
  <dt>te-tunnel-type:</dt>
  <dd>
    <t>A base YANG identity for supported TE tunnel types as defined in <xref target="RFC3209"/> and <xref target="RFC4875"/>.</t>
  </dd>
  <dt>lsp-encoding-types:</dt>
  <dd>
    <t>A base YANG identity for supported LSP encoding types as defined in <xref target="RFC3471"/>.</t>
  </dd>
  <dt>lsp-protection-type:</dt>
  <dd>
    <t>A base YANG identity for supported LSP protection types as defined in <xref target="RFC4872"/> and <xref target="RFC4873"/>.</t>
  </dd>
  <dt>switching-capabilities:</dt>
  <dd>
    <t>A base YANG identity for supported interface switching capabilities as defined in <xref target="RFC3471"/>.</t>
  </dd>
  <dt>resource-affinities-type:</dt>
  <dd>
    <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="RFC3209"/> and <xref target="RFC2702"/>.</t>
  </dd>
  <dt>path-metric-type:</dt>
  <dd>
    <t>A base YANG identity for supported path metric types as defined in <xref target="RFC3630"/>, <xref target="RFC3785"/>, <xref target="RFC5440"/>, <xref target="RFC7471"/>, <xref target="RFC8233"/>, <xref target="RFC8570"/> and <xref target="I-D.ietf-pce-sid-algo-14"/>.</t>
  </dd>
  <dt/>
  <dd>
    <t>The unit of the path metric value is interpreted in the context of the path metric type. The derived identities SHOULD describe the unit and maximum value of the path metric types they define.</t>
  </dd>
  <dt/>
  <dd>
    <t>For example, the bound of the 'path-metric-loss', defined in 'ietf-te-packet-types', is defined in multiples of the basic unit 0.000003% as described in <xref target="RFC7471"/> and <xref target="RFC8570"/>.</t>
  </dd>
  <dt>explicit-route-hop:</dt>
  <dd>
    <t>A YANG grouping that defines supported explicit routes as defined in <xref target="RFC3209"/> and <xref target="RFC3477"/>.</t>
  </dd>
  <dt>te-link-access-type:</dt>
  <dd>
    <t>An enumerated type for the different TE link access types as defined in <xref target="RFC3630"/>.</t>
  </dd>
  <dt>lsp-provisioning-error-reason:</dt>
  <dd>
    <t>A base YANG identity for reporting LSP provisioning error reasons. No standard LPS provisioning error reasons are defined in this document.</t>
  </dd>
  <dt>path-computation-error-reason:</dt>
  <dd>
    <t>A base YANG identity for reporting path computation error reasons as defined in <xref target="pc-error"/>.</t>
  </dd>
  <dt>protocol-origin-type:</dt>
  <dd>
    <t>A base YANG identity for the type of protocol origin as defined in <xref target="protocol-origin"/>.</t>
  </dd>
  <dt>svec-objective-function-type:</dt>
  <dd>
    <t>A base YANG identity for supported SVEC objective functions as defined in <xref target="RFC5541"/> and <xref target="RFC8685"/>.</t>
  </dd>
  <dt>svec-metric-type:</dt>
  <dd>
    <t>A base YANG identity for supported SVEC objective functions as defined in <xref target="RFC5541"/>.</t>
  </dd>
  <dt>encoding-and-switching-type:</dt>
  <dd>
    <t>This is a common grouping to define the LSP encoding and switching types.</t>
  </dd>
</dl>

<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>

<dl>
  <dt>path-computation-error-no-topology:</dt>
  <dd>
    <t>A YANG identity for reporting path computation error when there is no topology with the provided topology identifier.</t>
  </dd>
  <dt>path-computation-error-no-dependent-server:</dt>
  <dd>
    <t>A YANG identity for reporting path computation error when one or more dependent path computation servers are unavailable.</t>
  </dd>
  <dt/>
  <dd>
    <t>The dependent path computation server could be a Backward-Recursive Path Computation (BRPC) downstream PCE or a child PCE.</t>
  </dd>
</dl>

<t>The derived identities are defined in the "ietf-te-types" module because there are error reasons which are:</t>

<t><list style="numbers" type="1">
  <t>applicable only to the TE YANG models and not to PCEP environments (e.g., path-computation-error-no-topology);</t>
  <t>technology-specific (e.g., No RWA constraints met) which are better defined in technology-specific YANG models;</t>
  <t>match more than one PCEP numbers in order to hide the details of the underlay PCE architecture (e.g.,  path-computation-error-no-dependent-server).</t>
</list></t>

</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>

<dl>
  <dt>protocol-origin-api:</dt>
  <dd>
    <t>A YANG identity to be used when  the type of protocol origin is an Application Programmable Interface (API).</t>
  </dd>
</dl>

</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>

<dl>
  <dt>backup-protection-type:</dt>
  <dd>
    <t>A base YANG identity for supported protection types that a backup or bypass tunnel can provide as defined in <xref target="RFC4090"/>.</t>
  </dd>
  <dt>te-class-type:</dt>
  <dd>
    <t>A type that represents the Diffserv-TE Class-Type as defined in <xref target="RFC4124"/>.</t>
  </dd>
  <dt>bc-type:</dt>
  <dd>
    <t>A type that represents Diffserv-TE Bandwidth Constraints (BCs) as defined in <xref target="RFC4124"/>.</t>
  </dd>
  <dt>bc-model-type:</dt>
  <dd>
    <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>
  </dd>
  <dt>te-bandwidth-requested-type:</dt>
  <dd>
    <t>An enumerated type for the different options to request bandwidth for a specific tunnel.</t>
  </dd>
  <dt>performance-metrics-attributes-packet:</dt>
  <dd>
    <t>A YANG grouping that contains the generic performance metrics and additional packet-specific metrics.</t>
  </dd>
  <dt>bandwidth-profile-type:</dt>
  <dd>
    <t>A base YANG identity for various bandwidth profiles specified in <xref target="MEF_10.3"/>, <xref target="RFC2697"/> and <xref target="RFC2698"/> that may be used to limit bandwidth utilization of packet flows (e.g., MPLS-TE LSPs).</t>
  </dd>
  <dt>bandwidth-profile-parameters:</dt>
  <dd>
    <t>A YANG grouping that defines common parameters for bandwidth profiles in packet networks.</t>
  </dd>
  <dt>te-packet-path-bandwidth:</dt>
  <dd>
    <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>
  </dd>
  <dt/>
  <dd>
    <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>
  </dd>
  <dt>te-packet-link-bandwidth:</dt>
  <dd>
    <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>
  </dd>
  <dt/>
  <dd>
    <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>
  </dd>
</dl>

</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="RFC9522"/>, <xref target="RFC4090"/>, <xref target="RFC4202"/>, <xref target="RFC4328"/>, <xref target="RFC4561"/>, <xref target="RFC4657"/>, <xref target="RFC4736"/>, <xref target="RFC6004"/>, <xref target="RFC6378"/>, <xref target="RFC6511"/>, <xref target="RFC7139"/>, <xref target="RFC7271"/>, <xref target="RFC7308"/>, <xref target="RFC7551"/>, <xref target="RFC7571"/>, <xref target="RFC7579"/>, and <xref target="ITU-T_G.709"/>.</t>

<figure title="TE Types YANG module" anchor="fig-te-yang"><sourcecode type="yang" markers="true" name="ietf-te-types@2024-10-24.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) 2024 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 2024-10-30 {
    description
      "This revision adds the following new identities:
      - lsp-provisioning-error-reason;
      - association-type-diversity;
      - tunnel-admin-state-auto;
      - lsp-restoration-restore-none;
      - restoration-scheme-rerouting;
      - path-metric-optimization-type;
      - link-path-metric-type;
      - link-metric-type and its derived identities;
      - path-computation-error-reason and its derived identities;
      - protocol-origin-type and its derived identities;
      - svec-objective-function-type and its derived identities;
      - svec-metric-type and its derived identities.

      This revision adds the following new data types:
      - path-type.

      This revision adds the following new groupings:
      - encoding-and-switching-type;
      - te-generic-node-id.

      This revision updates the following identities:
      - objective-function-type;
      - action-exercise;
      - path-metric-type;
      - path-metric-te;
      - path-metric-igp;
      - path-metric-hop;
      - path-metric-delay-average;
      - path-metric-delay-minimum;
      - path-metric-residual-bandwidth;
      - path-metric-optimize-includes;
      - path-metric-optimize-excludes;
      - te-optimization-criterion.

      This revision updates the following data types:
      - te-node-id.

      This revision updates the following groupings:
      - explicit-route-hop:
        - adds the following leaves:
          - node-id-uri;
          - link-tp-id-uri;
        - updates the following leaves:
          - node-id;
          - link-tp-id;
      - record-route-state:
        - adds the following leaves:
          - node-id-uri;
          - link-tp-id-uri;
        - updates the following leaves:
          - node-id;
          - link-tp-id;
      - optimization-metric-entry:
        - updates the following leaves:
          - metric-type;
      - tunnel-constraints;
        - adds the following leaves:
          - network-id;
      - path-constraints-route-objects:
        - updates the following containers:
          - explicit-route-objects-always;
      - generic-path-metric-bounds:
        - updates the following leaves:
          - metric-type;
      - generic-path-optimization
        - adds the following leaves:
          - tiebreaker;
        - deprecate the following containers:
          - tiebreakers.

      This revision obsoletes the following identities:
      - of-minimize-agg-bandwidth-consumption;
      - of-minimize-load-most-loaded-link;
      - of-minimize-cost-path-set;
      - lsp-protection-reroute-extra;
      - lsp-protection-reroute.

      This revision provides also few editorial changes.";
    reference
      "RFC XXXX: 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
      "Initial Version 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 G.709: Interfaces for the optical transport network -
                    Edition 6.0 (06/2020)";
  }

  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 union {
      type yang:dotted-quad;
      type inet:ipv6-address-no-zone;
    }
    description
      "A type representing the identifier for a node in a TE
       topology.

       The identifier is represented either as 4 octets in
       dotted-quad notation, or as 16 octets in full, mixed,
       shortened, or shortened-mixed IPv6 address 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, the TE
       Router ID TLV described in Section 3.2.1 of RFC 6119, or the
       IPv6 TE Router ID TLV described in Section 4.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 6378: MPLS Transport Profile (MPLS-TP) Linear Protection
       RFC 4427: Recovery (Protection and Restoration) Terminology
                 for Generalized Multi-Protocol Label Switching
                 (GMPLS)";
  }

  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";
  }

  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
   */

  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 4872: RSVP-TE Extensions in Support of End-to-End
                   Generalized Multi-Protocol Label Switching (GMPLS)
                   Recovery";
    }

    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)";
    }

    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
        "RFC 8800: Path Computation Element Communication Protocol
                   (PCEP) Extension for Label Switched Path (LSP)
                   Diversity Constraint Signaling";
    }

  identity objective-function-type {
    description
      "Base identity for path objective function types.";
  }

    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)";
    }

    identity of-minimize-agg-bandwidth-consumption {
      base objective-function-type;
      status obsolete;
      description
        "Objective function for minimizing aggregate bandwidth
         consumption.
        
         This identity has been obsoleted: the
         'svec-of-minimize-agg-bandwidth-consumption' identity SHOULD
         be used instead.";
      reference
        "RFC 5541: Encoding of Objective Functions in the Path
                   Computation Element Communication Protocol
                   (PCEP)";
    }

    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.
        
         This identity has been obsoleted: the
         'svec-of-minimize-load-most-loaded-link' identity SHOULD
         be used instead.";
      reference
        "RFC 5541: Encoding of Objective Functions in the Path
                   Computation Element Communication Protocol
                   (PCEP)";
    }

    identity of-minimize-cost-path-set {
      base objective-function-type;
      status obsolete;
      description
        "Objective function for minimizing the cost on a path set.
        
         This identity has been obsoleted: the
         'svec-of-minimize-cost-path-set' identity SHOULD
         be used instead.";
      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 9522: Overview and Principles of Internet Traffic
                   Engineering, Section 4.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 9522: 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 9522: 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.";
    }

    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.";
  }

    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-rerouting {
      base restoration-scheme-type;
      description
        "Restoration LSP is computed after the failure detection.
        
         This restoration scheme is also known as
         'Full LSP Re-routing.'";
      reference
        "RFC 4872: RSVP-TE Extensions in Support of End-to-End
                   Generalized Multi-Protocol Label Switching (GMPLS)
                   Recovery";
    }

    identity restoration-scheme-preconfigured {
      base restoration-scheme-type;
      description
        "Restoration LSP is preconfigured prior to the failure.";
      reference
        "RFC 4872: RSVP-TE Extensions in Support of End-to-End
                  Generalized Multi-Protocol Label Switching (GMPLS)
                  Recovery";
    }

    identity restoration-scheme-precomputed {
      base restoration-scheme-type;
      description
        "Restoration LSP is precomputed prior to the failure.";
      reference
        "RFC 4872: RSVP-TE Extensions in Support of End-to-End
                  Generalized Multi-Protocol Label Switching (GMPLS)
                  Recovery";
    }

    identity restoration-scheme-presignaled {
      base restoration-scheme-type;
      description
        "Restoration LSP is presignaled prior to the failure.";
      reference
        "RFC 4872: RSVP-TE Extensions in Support of End-to-End
                  Generalized Multi-Protocol Label Switching (GMPLS)
                  Recovery";
    }

  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;
      status obsolete;
      description
        "'(Full) Rerouting' LSP protection type.
        
         This identity has been obsoleted: the
         'restoration-scheme-rerouting' identity SHOULD be used
         instead.";
      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;
      status obsolete;
      description
        "'Rerouting without Extra-Traffic' LSP protection type.
        
         This identity has been obsoleted: the
         'restoration-scheme-rerouting' identity SHOULD be used
         instead.";
      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 4872: RSVP-TE Extensions in Support of End-to-End
                   Generalized Multi-Protocol Label Switching (GMPLS)
                   Recovery";
    }

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

    identity normal {
      base lsp-protection-state;
      description
        "Normal state.";
      reference
        "RFC 6378: MPLS Transport Profile (MPLS-TP) Linear Protection
         RFC 4427: Recovery (Protection and Restoration) Terminology
                   for Generalized Multi-Protocol Label Switching
                   (GMPLS)";
    }

    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 6378: MPLS Transport Profile (MPLS-TP) Linear Protection
         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 6378: MPLS Transport Profile (MPLS-TP) Linear Protection
         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 6378: MPLS Transport Profile (MPLS-TP) Linear Protection
         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 6378: MPLS Transport Profile (MPLS-TP) Linear Protection
         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 6378: MPLS Transport Profile (MPLS-TP) Linear Protection
         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 6378: MPLS Transport Profile (MPLS-TP) Linear Protection
         RFC 4427: Recovery (Protection and Restoration) Terminology
                   for Generalized Multi-Protocol Label Switching
                   (GMPLS)";
    }

    identity wait-to-restore {
      base lsp-protection-state;
      description
        "A Wait-to-Restore (WTR) timer is running.";
      reference
        "RFC 6378: MPLS Transport Profile (MPLS-TP) Linear Protection
         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 6378: MPLS Transport Profile (MPLS-TP) Linear Protection
         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 7271: MPLS Transport Profile (MPLS-TP) Linear Protection
                   to Match the Operational Expectations of
                   Synchronous Digital Hierarchy, Optical Transport
                   Network, and Ethernet Transport Network Operators
         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 7271: MPLS Transport Profile (MPLS-TP) Linear Protection
                   to Match the Operational Expectations of
                   Synchronous Digital Hierarchy, Optical Transport
                   Network, and Ethernet Transport Network Operators
         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 7271: MPLS Transport Profile (MPLS-TP) Linear Protection
                   to Match the Operational Expectations of
                   Synchronous Digital Hierarchy, Optical Transport
                   Network, and Ethernet Transport Network Operators
         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 4872: RSVP-TE Extensions in Support of End-to-End
                   Generalized Multi-Protocol Label Switching (GMPLS)
                   Recovery
         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 4872: RSVP-TE Extensions in Support of End-to-End
                   Generalized Multi-Protocol Label Switching (GMPLS)
                   Recovery
         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 4872: RSVP-TE Extensions in Support of End-to-End
                   Generalized Multi-Protocol Label Switching (GMPLS)
                   Recovery
         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 4872: RSVP-TE Extensions in Support of End-to-End
                   Generalized Multi-Protocol Label Switching (GMPLS)
                   Recovery
         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 4872: RSVP-TE Extensions in Support of End-to-End
                   Generalized Multi-Protocol Label Switching (GMPLS)
                   Recovery
         RFC 4427: Recovery (Protection and Restoration) Terminology
                  for Generalized Multi-Protocol Label Switching
                  (GMPLS)";
    }

    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
        "RFC 7271: MPLS Transport Profile (MPLS-TP) Linear Protection
                   to Match the Operational Expectations of
                   Synchronous Digital Hierarchy, Optical Transport
                   Network, and Ethernet Transport Network Operators
         RFC 4427: Recovery (Protection and Restoration) Terminology
                   for Generalized Multi-Protocol Label Switching
                   (GMPLS)";
    }

    identity clear {
      base protection-external-commands;
      description
        "An action that clears the active near-end lockout of a
         protection, forced switchover, manual switchover,
         Wait-to-Restore (WTR) state, or exercise command.";
      reference
        "RFC 6378: MPLS Transport Profile (MPLS-TP) Linear Protection
         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-optimization-type {
    description
      "Base identity used to define the path metric optimization
       types.";
  }

  identity link-path-metric-type {
    description
      "Base identity used to define the link and the path metric
       types.
      
       The unit of the path metric value is interpreted in the
       context of the path metric type and the derived identities
       SHOULD describe the unit of the path metric types they
       define.";
  }

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

      identity link-metric-te {
        base link-metric-type;
        description
          "Traffic Engineering (TE) Link Metric.";
        reference
          "RFC 3630: Traffic Engineering (TE) Extensions to OSPF
                     Version 2, Section 2.5.5
           RFC 5305: IS-IS Extensions for Traffic Engineering,
                     Section 3.7";
      }

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

      identity link-metric-delay-average {
        base link-metric-type;
        description
          "Unidirectional Link Delay, measured in units of
           microseconds.";
        reference
          "RFC 7471: OSPF Traffic Engineering (TE) Metric
                     Extensions, Section 4.1        
           RFC 8570: IS-IS Traffic Engineering (TE) Metric
                     Extensions, Section 4.1";
      }

      identity link-metric-delay-minimum {
        base link-metric-type;
        description
          "Minimum unidirectional Link Delay, measured in units of
           microseconds.";
        reference
          "RFC 7471: OSPF Traffic Engineering (TE) Metric
                     Extensions, Section 4.2
           RFC 8570: IS-IS Traffic Engineering (TE) Metric
                     Extensions, Section 4.2";
      }

      identity link-metric-delay-maximum {
        base link-metric-type;
        description
          "Maximum unidirectional Link Delay, measured in units of
           microseconds.";
        reference
          "RFC 7471: OSPF Traffic Engineering (TE) Metric
                     Extensions, Section 4.2
           RFC 8570: IS-IS Traffic Engineering (TE) Metric
                     Extensions, Section 4.2";
      }

      identity link-metric-residual-bandwidth {
        base link-metric-type;
        description
          "Unidirectional Residual Bandwidth, measured in units of
           bytes per second.
          
           It is defined to be Maximum Bandwidth minus the bandwidth
           currently allocated to LSPs.";
        reference
          "RFC 7471: OSPF Traffic Engineering (TE) Metric
                     Extensions, Section 4.5
           RFC 8570: IS-IS Traffic Engineering (TE) Metric
                     Extensions, Section 4.5";
      }

    identity path-metric-type {
      base link-path-metric-type;
      base path-metric-optimization-type;
      description
        "Base identity for the path metric types.";
    }

      identity path-metric-te {
        base path-metric-type;
        description
          "Traffic Engineering (TE) Path Metric.";
        reference
          "RFC 5440: Path Computation Element (PCE) Communication
                     Protocol (PCEP), Section 7.8";
      }

      identity path-metric-igp {
        base path-metric-type;
        description
          "Interior Gateway Protocol (IGP) Path Metric.";
        reference
          "RFC 5440: Path Computation Element (PCE) Communication
                     Protocol (PCEP), section 7.8";
      }

      identity path-metric-hop {
        base path-metric-type;
        description
          "Hop Count Path Metric.";
        reference
          "RFC 5440: Path Computation Element (PCE) Communication
                     Protocol (PCEP), Section 7.8";
      }

      identity path-metric-delay-average {
        base path-metric-type;
        description
          "The Path Delay Metric, measured in units of
           microseconds.";
        reference
          "RFC8233: Extensions to the Path Computation Element
                    Communication Protocol (PCEP) to Compute
                    Service-Aware Label Switched Paths (LSPs),
                    Section 3.1.1";
      }

      identity path-metric-delay-minimum {
        base path-metric-type;
        description
          "The Path Min Delay Metric, measured in units of
           microseconds.";
        reference
          "I-D.ietf-pce-sid-algo: Carrying SR-Algorithm information
                                  in PCE-based Networks,
                                  draft-ietf-pce-sid-algo-14,
                                  Sections 3.5.1 and 3.5.2";
      }

      identity path-metric-residual-bandwidth {
        base path-metric-type;
        description
          "The Path Residual Bandwidth, defined as the minimum Link
           Residual Bandwidth all the links along the path.

           The Path Residual Bandwidth can be seen as the path
           metric associated with the Maximum residual Bandwidth Path
           (MBP) objective function.";
        reference
          "RFC 5541: Encoding of Objective Functions in the Path
                     Computation Element Communication Protocol
                     (PCEP)";
      }

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

    identity path-metric-optimize-excludes {
      base path-metric-optimization-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: selects the path with the most
         available bandwidth (load balance LSPs over more links).";
    }

    identity path-tiebreaker-maxfill {
      base path-tiebreaker-type;
      description
        "Max-Fill LSP path placement: selects the path with the least
         available bandwidth (packing more LSPs over few links).";
    }

    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 3209: RSVP-TE: Extensions to RSVP for LSP Tunnels
       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 3209: RSVP-TE: Extensions to RSVP for LSP Tunnels
         RFC 2702: Requirements for Traffic Engineering Over MPLS";
    }

    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 3209: RSVP-TE: Extensions to RSVP for LSP Tunnels
         RFC 2702: Requirements for Traffic Engineering Over MPLS";
    }

    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 3209: RSVP-TE: Extensions to RSVP for LSP Tunnels
         RFC 2702: Requirements for Traffic Engineering Over MPLS";
    }

  identity te-optimization-criterion {
    description
      "Base identity for the TE optimization criteria.";
    reference
      "RFC 9522: 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.";
    }

  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
        "RFC 5440: Path Computation Element (PCE) Communication
                   Protocol (PCEP), Section 7.5";
    }

    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
        "RFC 5441: A Backward-Recursive PCE-Based Computation (BRPC)
                   Procedure to Compute Shortest Constrained
                   Inter-Domain Traffic Engineering Label Switched
                   Paths
         RFC 8685: Path Computation Element Communication Protocol
                   (PCEP) Extensions for the Hierarchical Path
                   Computation Element (H-PCE) Architecture";
    }

    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
        "RFC 5440: Path Computation Element (PCE) Communication
                   Protocol (PCEP)
         
         https://www.iana.org/assignments/pcep
         /pcep.xhtml#no-path-vector-tlv";
    }

    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
        "RFC 8685: Path Computation Element Communication Protocol
                   (PCEP) Extensions for the Hierarchical Path
                   Computation Element (H-PCE) Architecture
         
         https://www.iana.org/assignments/pcep
         /pcep.xhtml#no-path-vector-tlv";
    }

    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
        "RFC 8685: Path Computation Element Communication Protocol
                   (PCEP) Extensions for the Hierarchical Path
                   Computation Element (H-PCE) Architecture
        
         https://www.iana.org/assignments/pcep
         /pcep.xhtml#no-path-vector-tlv";
    }

    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
        "RFC 8685: Path Computation Element Communication Protocol
                   (PCEP) Extensions for the Hierarchical Path
                   Computation Element (H-PCE) Architecture
        
         https://www.iana.org/assignments/pcep
         /pcep.xhtml#no-path-vector-tlv";
    }

    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
        "RFC 8685: Path Computation Element Communication Protocol
                   (PCEP) Extensions for the Hierarchical Path
                   Computation Element (H-PCE) Architecture
        
         https://www.iana.org/assignments/pcep
         /pcep.xhtml#no-path-vector-tlv";
    }

    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
        "RFC 8306: Extensions to the Path Computation Element
                   Communication Protocol (PCEP) for
                   Point-to-Multipoint Traffic Engineering Label
                   Switched Paths
        
         https://www.iana.org/assignments/pcep
         /pcep.xhtml#no-path-vector-tlv";
    }

    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
        "RFC 5557: Path Computation Element Communication Protocol
                   (PCEP) Requirements and Protocol Extensions in
                   Support of Global Concurrent Optimization
        
         https://www.iana.org/assignments/pcep
         /pcep.xhtml#no-path-vector-tlv";
    }

    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
        "RFC 5557: Path Computation Element Communication Protocol
                   (PCEP) Requirements and Protocol Extensions in
                   Support of Global Concurrent Optimization
        
         https://www.iana.org/assignments/pcep
         /pcep.xhtml#no-path-vector-tlv";
    }

    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
        "RFC 5520: Preserving Topology Confidentiality in
                   Inter-Domain Path Computation Using a
                   Path-Key-Based Mechanism
        
         https://www.iana.org/assignments/pcep
         /pcep.xhtml#no-path-vector-tlv";
    }

    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
        "RFC 5441: A Backward-Recursive PCE-Based Computation (BRPC)
                   Procedure to Compute Shortest Constrained
                   Inter-Domain Traffic Engineering Label Switched
                   Paths
        
         https://www.iana.org/assignments/pcep
         /pcep.xhtml#no-path-vector-tlv";
    }

    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
        "RFC 5440: Path Computation Element (PCE) Communication
                   Protocol (PCEP);
        
         https://www.iana.org/assignments/pcep
         /pcep.xhtml#no-path-vector-tlv";
    }

    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
        "RFC 5440: Path Computation Element (PCE) Communication
        Protocol (PCEP);
        
         https://www.iana.org/assignments/pcep
         /pcep.xhtml#no-path-vector-tlv";
    }

    identity path-computation-error-no-server {
      base path-computation-error-reason;
      description
        "Path computation has failed because path computation
         server is unavailable.";
      reference
        "RFC 5440: Path Computation Element (PCE) Communication
                   Protocol (PCEP);
        
         https://www.iana.org/assignments/pcep
         /pcep.xhtml#no-path-vector-tlv";
    }

  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 Programming Interface
         (API).";
    }

    identity protocol-origin-pcep {
      base protocol-origin-type;
      description
        "Protocol origin is Path Computation Engine Protocol 
         (PCEP).";
      reference
        "RFC 5440: Path Computation Element (PCE) Communication
                   Protocol (PCEP)";
    }

    identity protocol-origin-bgp {
      base protocol-origin-type;
      description
        "Protocol origin is Border Gateway Protocol (BGP).";
      reference
        "RFC 9012: The BGP Tunnel Encapsulation Attribute";
    }

  identity svec-objective-function-type {
    description
      "Base identity for SVEC objective function type.";
    reference
      "RFC 5541: 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
        "RFC 5541: 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
        "RFC 5541: 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
        "RFC 5541: 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
        "RFC 8685: 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
        "RFC 8685: 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
        "RFC 8685: 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
        "RFC 8685: Path Computation Element Communication Protocol
                   (PCEP) Extensions for the Hierarchical Path
                   Computation Element (H-PCE) Architecture.";
    }

  identity svec-metric-type {
    description
      "Base identity for SVEC metric type.";
    reference
      "RFC 5541: Encoding of Objective Functions in the Path
                 Computation Element Communication Protocol (PCEP)";
  }

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

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

    identity svec-metric-cumulative-hop {
      base svec-metric-type;
      description
        "Cumulative Hop path metric.";
      reference
        "RFC 5541: 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
        "RFC 5541: 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
        "RFC 5541: 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 8570: IS-IS Traffic Engineering (TE) Metric Extensions
       RFC 7823: Performance-Based Path Selection for Explicitly
                 Routed Label Switched Paths (LSPs) Using 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 8570: IS-IS Traffic Engineering (TE) Metric Extensions
       RFC 7823: Performance-Based Path Selection for Explicitly
                 Routed Label Switched Paths (LSPs) Using 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 8570: IS-IS Traffic Engineering (TE) Metric Extensions
       RFC 7823: Performance-Based Path Selection for Explicitly
                 Routed Label Switched Paths (LSPs) Using 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 8570: IS-IS Traffic Engineering (TE) Metric Extensions
         RFC 7823: Performance-Based Path Selection for Explicitly
                   Routed Label Switched Paths (LSPs) Using 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 8570: IS-IS Traffic Engineering (TE) Metric Extensions
         RFC 7823: Performance-Based Path Selection for Explicitly
                   Routed Label Switched Paths (LSPs) Using 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'.

         In case the restriction is 'inclusive', the bit-position is
         set if the corresponding mapped label is available.
         In this case, if the range-bitmap is not present, all the
         labels in the range are available.

         In case the restriction is 'exclusive', the bit-position is
         set if the corresponding mapped label is not available.
         In this case, if the range-bitmap is not present, all the
         labels in the range are not available.

         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-optimization-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 {
      description
        "Container for the explicit route object lists.";
      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
        "Top-level container for the list of path metric bounds.";
      list path-metric-bound {
        key "metric-type";
        description
          "List of path metric bounds, which can apply to link and
           path metrics.
          
           TE paths which have at least one path metric which
           exceeds the specified bounds MUST NOT be selected.
          
           TE paths that traverse TE links which have at least one
           link metric which exceeds the specified bounds MUST NOT
           be selected.";
        leaf metric-type {
          type identityref {
            base link-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 specified 'metric-type'.
            
             A zero indicates an unbounded upper limit for the
             specificied 'metric-type'.
            
             The unit of is interpreted in the context of the
             'metric-type' identity.";
        }
      }
    }
  }

  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 {
            status deprecated;
            description
              "Container for the list of tiebreakers.
              
               This container has been deprecated by the tiebreaker
               leaf.";
            list tiebreaker {
              key "tiebreaker-type";
              status deprecated;
              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;
                }
                status deprecated;
                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.";
            }
          }
        }
      }
    }
    leaf tiebreaker {
      type identityref {
        base path-tiebreaker-type;
      }
      default "te-types:path-tiebreaker-random";
      description
        "The tiebreaker criteria to apply on an equally favored set
         of paths, in order to pick the best.";
    }
  }

  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;
        }
      }
    }
  }

  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
        "RFC 3945: Generalized Multi-Protocol Label Switching (GMPLS)
                   Architecture";
    }
    leaf switching-type {
      type identityref {
        base te-types:switching-capabilities;
      }
      description
        "LSP switching type.";
      reference
        "RFC 3945: Generalized Multi-Protocol Label Switching (GMPLS)
                   Architecture";
    }
  }

  grouping te-generic-node-id {
    description
      "A reusable grouping for a TE generic node identifier.";
    leaf id {
      type union {
        type te-node-id;
        type inet:ip-address;
        type nw:node-id;
      }
      description
        "The identifier of the node.
         
         It can be represented as IP address or dotted quad address
         or as an URI.
         
         The type data node disambiguates the union type.";
    }
    leaf type {
      type enumeration {
        enum ip {
          description
            "IP address representation of the node identifier.";
        }
        enum te-id {
          description
            "TE identifier of the node";
        }
        enum node-id {
          description
            "URI representation of the node identifier.";
        }
      }
      description
        "Type of node identifier representation.";
    }
  }
}
]]></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>

<figure title="Packet TE Types YANG module" anchor="fig-pkt-yang"><sourcecode type="yang" markers="true" name="ietf-te-packet-types@2024-10-17.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 ietf-yang-types {
    prefix yang;
    reference
      "RFC 6991: Common YANG Data Types";
  }

  import ietf-te-types {
    prefix te-types;
    reference
      "RFC XXXX: 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 Packet Traffic Enginnering
     (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) 2024 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 2024-10-30 {
    description
      "This revision adds the following new identities:
       - bandwidth-profile-type;
       - link-metric-delay-variation;
       - link-metric-loss;
       - path-metric-delay-variation;
       - path-metric-loss.

      This revision adds the following new groupings:
       - bandwidth-profile-parameters;
       - te-packet-path-bandwidth;
       - te-packet-link-bandwidth.
       
      This revision provides also few editorial changes.";
    reference
      "RFC XXXX: 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
   */

  identity bandwidth-profile-type {
    description
      "Bandwidth Profile Types";
  }

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

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

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

  // Derived identities from te-types:link-metric-type

    identity link-metric-delay-variation {
      base te-types:link-metric-type;
      description
        "The Unidirectional Delay Variation Metric,
         measured in units of microseconds.";
      reference
        "RFC 7471: OSPF Traffic Engineering (TE) Metric Extensions,
                   Section 4.3
         RFC 8570: IS-IS Traffic Engineering (TE) Metric Extensions,
                   Section 4.3";
    }

    identity link-metric-loss {
      base te-types:link-metric-type;
      description
        "The Unidirectional Link Loss Metric,
         measured in units of 0.000003%.";
      reference
        "RFC 7471: OSPF Traffic Engineering (TE) Metric Extensions,
                   Section 4.4
         RFC 8570: IS-IS Traffic Engineering (TE) Metric Extensions,
                   Section 4.4";
    }

  // Derived identities from te-types:link-metric-type

    identity path-metric-delay-variation {
      base te-types:path-metric-type;
      description
        "The Path Delay Variation Metric,
         measured in units of microseconds.";
      reference
        "RFC 8233: Extensions to the Path Computation Element
                   Communication Protocol (PCEP) to Compute
                   Service-Aware Label Switched Paths (LSPs),
                   Section 3.1.2";
    }

    identity path-metric-loss {
      base te-types:path-metric-type;
      description
        "The Path Loss Metric, measured in units of 0.000003%.";
      reference
        "RFC 8233: Extensions to the Path Computation Element
                   Communication Protocol (PCEP) to Compute
                   Service-Aware Label Switched Paths (LSPs),
                   Section 3.1.3";
    }

  /*
   * Typedefs
   */

  typedef te-bandwidth-requested-type {
    type enumeration {
      enum specified-value {
        description
          "Bandwidth value is explicitly specified.";
      }
      enum specified-profile {
        description
          "Bandwidth profile 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 8570: IS-IS Traffic Engineering (TE) Metric
                       Extensions
             RFC 7823: Performance-Based Path Selection for
                       Explicitly Routed Label Switched Paths (LSPs)
                       Using 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 8570: IS-IS Traffic Engineering (TE) Metric
                       Extensions
             RFC 7823: Performance-Based Path Selection for
                       Explicitly Routed Label Switched Paths (LSPs)
                       Using 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 8570: IS-IS Traffic Engineering (TE) Metric
                       Extensions
             RFC 7823: Performance-Based Path Selection for
                       Explicitly Routed Label Switched Paths (LSPs)
                       Using 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 8570: IS-IS Traffic Engineering (TE) Metric
                       Extensions
             RFC 7823: Performance-Based Path Selection for
                       Explicitly Routed Label Switched Paths (LSPs)
                       Using 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 8570: IS-IS Traffic Engineering (TE) Metric
                       Extensions
             RFC 7823: Performance-Based Path Selection for
                       Explicitly Routed Label Switched Paths (LSPs)
                       Using 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 8570: IS-IS Traffic Engineering (TE) Metric Extensions
           RFC 7823: Performance-Based Path Selection for Explicitly
                     Routed Label Switched Paths (LSPs) Using 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 one-way-performance-metrics-gauge-packet {
    description
      "One-way packet PM throttle grouping.

       This grouping is used to report the same metrics defined in
       the one-way-performance-metrics-packet grouping, using gauges
       instead of uint32 data types and referencing IPPM RFCs
       instead of IGP-TE RFCs.";
    leaf one-way-min-delay {
      type yang:gauge64;
      description
        "One-way minimum delay or latency in microseconds.";
    }
    leaf one-way-max-delay {
      type yang:gauge64;
      description
        "One-way maximum delay or latency in microseconds.";
      reference
        "RFC 7679: A One-Way Delay Metric for IP Performance
                   Metrics (IPPM)";
    }
    leaf one-way-delay-variation {
      type yang:gauge64;
      description
        "One-way delay variation in microseconds.";
      reference
        "RFC 3393: IP Packet Delay Variation Metric for IP
                   Performance Metrics (IPPM)";
    }
    leaf one-way-packet-loss {
      type decimal64 {
        fraction-digits 5;
        range "0..100";
      }
      description
        "The ratio of packets dropped to packets transmitted between
         two endpoints.";
      reference
        "RFC 7680: A One-Way Loss Metric for IP Performance
                   Metrics (IPPM)";
    }
  }

  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 two-way-performance-metrics-gauge-packet {
    description
      "Two-way packet PM throttle grouping.

       This grouping is used to report the same metrics defined in
       the two-way-performance-metrics-packet grouping, using gauges
       instead of uint32 data types and referencing IPPM RFCs
       instead of IGP-TE RFCs.";
    leaf two-way-min-delay {
      type yang:gauge64;
      description
        "Two-way minimum delay or latency in microseconds.";
      reference
        "RFC 2681: A Round-trip Delay Metric for IPPM";
    }
    leaf two-way-max-delay {
      type yang:gauge64;
      description
        "Two-way maximum delay or latency in microseconds.";
      reference
        "RFC 2681: A Round-trip Delay Metric for IPPM";
    }
    leaf two-way-delay-variation {
      type yang:gauge64;
      description
        "Two-way delay variation in microseconds.";
      reference
        "RFC 5481: Packet Delay Variation Applicability Statement";
    }
    leaf two-way-packet-loss {
      type decimal64 {
        fraction-digits 5;
        range "0..100";
      }
      description
        "The ratio of packets dropped to packets transmitted between
         two endpoints.";
    }
  }

  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.";
      }
    }
  }

  grouping bandwidth-profile-parameters {
    description
      "Common parameters to define bandwidth profiles in packet
       networks.";
    leaf cir {
      type uint64;
      units "bits/second";
      description
        "Committed Information Rate (CIR).";
    }
    leaf cbs {
      type uint64;
      units "bytes";
      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).";
    }
  }

  grouping te-packet-path-bandwidth {
    description
      "Bandwidth attributes for TE Packet paths.";
    container packet-bandwidth {
      description
        "Bandwidth attributes for TE Packet paths.";
      leaf specification-type {
        type te-bandwidth-requested-type;
        description
          "The bandwidth specification type, either explicitly
           specified or automatically computed.";
      }
      leaf set-bandwidth {
        when "../specification-type = 'specified-value'" {
          description
            "When the bandwidth value is explicitly specified.";
        }
        type bandwidth-kbps;
        description
          "Set the bandwidth value explicitly, e.g., using offline
           calculation.";
      }
      container bandwidth-profile {
        when "../specification-type = 'specified-profile'" {
          description
            "When the bandwidth profile is explicitly specified.";
        }
        description
          "Set the bandwidth profile attributes explicitly.";
        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.";
        }
        uses bandwidth-profile-parameters;
      }
      leaf class-type {
        type te-types:te-ds-class;
        description
          "The Class-Type of traffic transported by the LSP.";
        reference
          "RFC 4124: Protocol Extensions for Support of
                     Diffserv-aware MPLS Traffic Engineering,
                     Section 4.3.1";
      }
      leaf signaled-bandwidth {
        type te-packet-types:bandwidth-kbps;
        config false;
        description
          "The currently signaled bandwidth of the LSP.

           In the case where the bandwidth is specified
           explicitly, then this will match the value of the
           set-bandwidth leaf.

           In the cases where the bandwidth is dynamically
           computed by the system, the current value of the
           bandwidth should be reflected.";
      }
    }
  }

  grouping te-packet-link-bandwidth {
    description
      "Bandwidth attributes for Packet TE links.";
    leaf packet-bandwidth {
      type uint64;
      units "bits/second";
      description
        "Bandwidth value for Packet TE links.";
    }
  }
}
]]></sourcecode></figure>

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

<t>This document requests IANA to update the following URIs in the "IETF XML Registry" <xref target="RFC3688"/> 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 requests IANA to register the following YANG modules in the "YANG Module Names" registry <xref target="RFC6020"/> within the "YANG Parameters" registry group.</t>

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

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

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

<t>This section is modeled after the template described in Section 3.7
of <xref target="I-D.ietf-netmod-rfc8407bis"/>.</t>

<t>The "ietf-te-types" and the "ietf-te-packet-types" YANG modules define data models that are
designed to be accessed via YANG-based management protocols, such as
NETCONF <xref target="RFC6241"/> and RESTCONF <xref target="RFC8040"/>. These protocols have to
use a secure transport layer (e.g., SSH <xref target="RFC4252"/>, TLS <xref target="RFC8446"/>, and
QUIC <xref target="RFC9000"/>) and have to use mutual authentication.</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 modules define a set of identities, types, and
groupings. These nodes are intended to be reused by other YANG
modules. The modules by themselves do not expose any data nodes that
are writable, data nodes that contain read-only state, or RPCs.
As such, there are no additional security issues related to
the YANG module that need to be considered.</t>

<t>Modules that use the groupings that are defined in this document
should identify the corresponding security considerations. For
example, reusing some of these groupings will expose privacy-related
information (e.g., 'node-example').</t>

</section>


  </middle>

  <back>


<references title='References' anchor="sec-combined-references">

    <references title='Normative References' anchor="sec-normative-references">

<reference anchor="ITU-T_G.709" target="https://www.itu.int/rec/T-REC-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="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">
  <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="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">
  <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">
  <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">
  <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">
  <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="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">
  <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="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">
  <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">
  <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">
  <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">
  <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">
  <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">
  <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="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="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">
  <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">
  <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">
  <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">
  <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="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">
  <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">
  <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="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">
  <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">
  <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">
  <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">
  <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">
  <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">
  <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">
  <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">
  <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">
  <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">
  <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">
  <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">
  <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="RFC6368">
  <front>
    <title>Internal BGP as the Provider/Customer Edge Protocol for BGP/MPLS IP Virtual Private Networks (VPNs)</title>
    <author fullname="P. Marques" initials="P." surname="Marques"/>
    <author fullname="R. Raszuk" initials="R." surname="Raszuk"/>
    <author fullname="K. Patel" initials="K." surname="Patel"/>
    <author fullname="K. Kumaki" initials="K." surname="Kumaki"/>
    <author fullname="T. Yamagata" initials="T." surname="Yamagata"/>
    <date month="September" year="2011"/>
    <abstract>
      <t>This document defines protocol extensions and procedures for BGP Provider/Customer Edge router iteration in BGP/MPLS IP VPNs. These extensions and procedures have the objective of making the usage of the BGP/MPLS IP VPN transparent to the customer network, as far as routing information is concerned. [STANDARDS-TRACK]</t>
    </abstract>
  </front>
  <seriesInfo name="RFC" value="6368"/>
  <seriesInfo name="DOI" value="10.17487/RFC6368"/>
</reference>

<reference anchor="RFC7271">
  <front>
    <title>MPLS Transport Profile (MPLS-TP) Linear Protection to Match the Operational Expectations of Synchronous Digital Hierarchy, Optical Transport Network, and Ethernet Transport Network Operators</title>
    <author fullname="J. Ryoo" initials="J." role="editor" surname="Ryoo"/>
    <author fullname="E. Gray" initials="E." role="editor" surname="Gray"/>
    <author fullname="H. van Helvoort" initials="H." surname="van Helvoort"/>
    <author fullname="A. D'Alessandro" initials="A." surname="D'Alessandro"/>
    <author fullname="T. Cheung" initials="T." surname="Cheung"/>
    <author fullname="E. Osborne" initials="E." surname="Osborne"/>
    <date month="June" year="2014"/>
    <abstract>
      <t>This document describes alternate mechanisms to perform some of the functions of MPLS Transport Profile (MPLS-TP) linear protection defined in RFC 6378, and also defines additional mechanisms. The purpose of these alternate and additional mechanisms is to provide operator control and experience that more closely models the behavior of linear protection seen in other transport networks.</t>
      <t>This document also introduces capabilities and modes for linear protection. A capability is an individual behavior, and a mode is a particular combination of capabilities. Two modes are defined in this document: Protection State Coordination (PSC) mode and Automatic Protection Switching (APS) mode.</t>
      <t>This document describes the behavior of the PSC protocol including priority logic and state machine when all the capabilities associated with the APS mode are enabled.</t>
      <t>This document updates RFC 6378 in that the capability advertisement method defined here is an addition to that document.</t>
    </abstract>
  </front>
  <seriesInfo name="RFC" value="7271"/>
  <seriesInfo name="DOI" value="10.17487/RFC7271"/>
</reference>

<reference anchor="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">
  <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="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">
  <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="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="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="RFC8233">
  <front>
    <title>Extensions to the Path Computation Element Communication Protocol (PCEP) to Compute Service-Aware Label Switched Paths (LSPs)</title>
    <author fullname="D. Dhody" initials="D." surname="Dhody"/>
    <author fullname="Q. Wu" initials="Q." surname="Wu"/>
    <author fullname="V. Manral" initials="V." surname="Manral"/>
    <author fullname="Z. Ali" initials="Z." surname="Ali"/>
    <author fullname="K. Kumaki" initials="K." surname="Kumaki"/>
    <date month="September" year="2017"/>
    <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 and constraints. These metrics are associated with the Service Level Agreement (SLA) between customers and service providers. The link bandwidth utilization (the total bandwidth of a link in actual use for the forwarding) is another important factor to consider during path computation.</t>
      <t>IGP Traffic Engineering (TE) Metric Extensions describe mechanisms with which network performance information is distributed via OSPF and IS-IS, respectively. The Path Computation Element Communication Protocol (PCEP) provides mechanisms for Path Computation Elements (PCEs) to perform path computations in response to Path Computation Client (PCC) requests. This document describes the extension to PCEP to carry latency, delay variation, packet loss, and link bandwidth utilization as constraints for end-to-end path computation.</t>
    </abstract>
  </front>
  <seriesInfo name="RFC" value="8233"/>
  <seriesInfo name="DOI" value="10.17487/RFC8233"/>
</reference>

<reference anchor="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="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="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">
  <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">
  <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">
  <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">
  <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="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">
  <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">
  <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="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">
  <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">
  <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">
  <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">
  <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">
  <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="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' anchor="sec-informative-references">

<reference anchor="MEF_10.3" target="https://www.mef.net/Assets/Technical_Specifications/PDF/MEF_10.pdf">
  <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="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="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="I-D.ietf-netmod-rfc8407bis">
   <front>
      <title>Guidelines for Authors and Reviewers of Documents Containing YANG Data Models</title>
      <author fullname="Andy Bierman" initials="A." surname="Bierman">
         <organization>YumaWorks</organization>
      </author>
      <author fullname="Mohamed Boucadair" initials="M." surname="Boucadair">
         <organization>Orange</organization>
      </author>
      <author fullname="Qin Wu" initials="Q." surname="Wu">
         <organization>Huawei</organization>
      </author>
      <date day="21" month="October" year="2024"/>
      <abstract>
	 <t>   This memo provides guidelines for authors and reviewers of
   specifications containing YANG modules, including IANA-maintained
   modules.  Recommendations and procedures are defined, which are
   intended to increase interoperability and usability of Network
   Configuration Protocol (NETCONF) and RESTCONF protocol
   implementations that utilize YANG modules.  This document obsoletes
   RFC 8407.

   Also, this document updates RFC 8126 by providing additional
   guidelines for writing the IANA considerations for RFCs that specify
   IANA-maintained modules.  The document also updates RFC 6020 by
   clarifying how modules and their revisions are handled by IANA.

	 </t>
      </abstract>
   </front>
   <seriesInfo name="Internet-Draft" value="draft-ietf-netmod-rfc8407bis-20"/>
   
</reference>

<reference anchor="RFC8340">
  <front>
    <title>YANG Tree Diagrams</title>
    <author fullname="M. Bjorklund" initials="M." surname="Bjorklund"/>
    <author fullname="L. Berger" initials="L." role="editor" surname="Berger"/>
    <date month="March" year="2018"/>
    <abstract>
      <t>This document captures the current syntax used in YANG module tree diagrams. The purpose of this document is to provide a single location for this definition. This syntax may be updated from time to time based on the evolution of the YANG language.</t>
    </abstract>
  </front>
  <seriesInfo name="BCP" value="215"/>
  <seriesInfo name="RFC" value="8340"/>
  <seriesInfo name="DOI" value="10.17487/RFC8340"/>
</reference>

<reference anchor="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="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="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="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'Dell" initials="M." surname="O'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="I-D.ietf-pce-sid-algo-14">
   <front>
      <title>Carrying SR-Algorithm Information in PCE-based Networks.</title>
      <author fullname="Samuel Sidor" initials="S." surname="Sidor">
         <organization>Cisco Systems, Inc.</organization>
      </author>
      <author fullname="Alex Tokar" initials="A." surname="Tokar">
         <organization>Cisco Systems, Inc.</organization>
      </author>
      <author fullname="Shaofu Peng" initials="S." surname="Peng">
         <organization>ZTE Corporation</organization>
      </author>
      <author fullname="Shuping Peng" initials="S." surname="Peng">
         <organization>Huawei Technologies</organization>
      </author>
      <author fullname="Andrew Stone" initials="A." surname="Stone">
         <organization>Nokia</organization>
      </author>
      <date day="25" month="September" year="2024"/>
      <abstract>
	 <t>   The SR-Algorithm associated with a Segment-ID (SID) defines the path
   computation algorithm used by Interior Gateway Protocols (IGPs).
   This information is available to controllers, such as the Path
   Computation Element (PCE), via topology learning.  This document
   proposes an approach for informing headend routers regarding the SR-
   Algorithm associated with each SID used in PCE-computed paths, as
   well as signaling a specific SR-Algorithm as a constraint to the PCE.


	 </t>
      </abstract>
   </front>
   <seriesInfo name="Internet-Draft" value="draft-ietf-pce-sid-algo-14"/>
   
</reference>

<reference anchor="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">
  <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">
  <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">
  <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">
  <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="RFC9522">
  <front>
    <title>Overview and Principles of Internet Traffic Engineering</title>
    <author fullname="A. Farrel" initials="A." role="editor" surname="Farrel"/>
    <date month="January" year="2024"/>
    <abstract>
      <t>This document 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 the networks that support IP networking 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 networks are also discussed.</t>
      <t>This work was first published as RFC 3272 in May 2002. This document obsoletes RFC 3272 by making a complete update to bring the text in line with best current practices for Internet traffic engineering and to include references to the latest relevant work in the IETF.</t>
    </abstract>
  </front>
  <seriesInfo name="RFC" value="9522"/>
  <seriesInfo name="DOI" value="10.17487/RFC9522"/>
</reference>

<reference anchor="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="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="RFC4252">
  <front>
    <title>The Secure Shell (SSH) Authentication Protocol</title>
    <author fullname="T. Ylonen" initials="T." surname="Ylonen"/>
    <author fullname="C. Lonvick" initials="C." role="editor" surname="Lonvick"/>
    <date month="January" year="2006"/>
    <abstract>
      <t>The Secure Shell Protocol (SSH) is a protocol for secure remote login and other secure network services over an insecure network. This document describes the SSH authentication protocol framework and public key, password, and host-based client authentication methods. Additional authentication methods are described in separate documents. The SSH authentication protocol runs on top of the SSH transport layer protocol and provides a single authenticated tunnel for the SSH connection protocol. [STANDARDS-TRACK]</t>
    </abstract>
  </front>
  <seriesInfo name="RFC" value="4252"/>
  <seriesInfo name="DOI" value="10.17487/RFC4252"/>
</reference>

<reference anchor="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="RFC9000">
  <front>
    <title>QUIC: A UDP-Based Multiplexed and Secure Transport</title>
    <author fullname="J. Iyengar" initials="J." role="editor" surname="Iyengar"/>
    <author fullname="M. Thomson" initials="M." role="editor" surname="Thomson"/>
    <date month="May" year="2021"/>
    <abstract>
      <t>This document defines the core of the QUIC transport protocol. QUIC provides applications with flow-controlled streams for structured communication, low-latency connection establishment, and network path migration. QUIC includes security measures that ensure confidentiality, integrity, and availability in a range of deployment circumstances. Accompanying documents describe the integration of TLS for key negotiation, loss detection, and an exemplary congestion control algorithm.</t>
    </abstract>
  </front>
  <seriesInfo name="RFC" value="9000"/>
  <seriesInfo name="DOI" value="10.17487/RFC9000"/>
</reference>




    </references>

</references>


<?line 5643?>

<section anchor="the-complete-schema-trees"><name>The Complete Schema Trees</name>

<t>This appendix presents the complete tree of the TE and Packet TE types data
model.
See <xref target="RFC8340"/> for an explanation of the symbols used.
The data type of every leaf node is shown near the right end of the corresponding line.</t>

<ul empty="true"><li>
  <t>Editors' Note: The YANG trees have been generated by pyang and have some bugs to be fixed before publication. Please manually fix the YANG tree before sending the document to the RFC EDITOR.</t>
</li></ul>

<section anchor="te-types-schema-tree"><name>TE Types Schema Tree</name>

<figure><artwork type="ascii-art"><![CDATA[
=============== NOTE: '\' line wrapping per RFC 8792 ================

module: ietf-te-types

  grouping te-bandwidth:
    +-- te-bandwidth
       +-- (technology)?
          +--:(generic)
             +-- generic?   te-bandwidth
  grouping te-label:
    +-- te-label
       +-- (technology)?
       |  +--:(generic)
       |     +-- generic?   rt-types:generalized-label
       +-- direction?       te-label-direction
  grouping te-topology-identifier:
    +-- te-topology-identifier
       +-- provider-id?   te-global-id
       +-- client-id?     te-global-id
       +-- topology-id?   te-topology-id
  grouping performance-metrics-one-way-delay-loss:
    +-- one-way-delay?             uint32
    +-- one-way-delay-normality?
            te-types:performance-metrics-normality
  grouping performance-metrics-two-way-delay-loss:
    +-- two-way-delay?             uint32
    +-- two-way-delay-normality?
            te-types:performance-metrics-normality
  grouping performance-metrics-one-way-bandwidth:
    +-- one-way-residual-bandwidth?
    |       rt-types:bandwidth-ieee-float32
    +-- one-way-residual-bandwidth-normality?
    |       te-types:performance-metrics-normality
    +-- one-way-available-bandwidth?
    |       rt-types:bandwidth-ieee-float32
    +-- one-way-available-bandwidth-normality?
    |       te-types:performance-metrics-normality
    +-- one-way-utilized-bandwidth?
    |       rt-types:bandwidth-ieee-float32
    +-- one-way-utilized-bandwidth-normality?
            te-types:performance-metrics-normality
  grouping one-way-performance-metrics:
    +-- one-way-delay?                 uint32
    +-- one-way-residual-bandwidth?
    |       rt-types:bandwidth-ieee-float32
    +-- one-way-available-bandwidth?
    |       rt-types:bandwidth-ieee-float32
    +-- one-way-utilized-bandwidth?
            rt-types:bandwidth-ieee-float32
  grouping two-way-performance-metrics:
    +-- two-way-delay?   uint32
  grouping performance-metrics-thresholds:
    +-- one-way-delay?                 uint32
    +-- one-way-residual-bandwidth?
    |       rt-types:bandwidth-ieee-float32
    +-- one-way-available-bandwidth?
    |       rt-types:bandwidth-ieee-float32
    +-- one-way-utilized-bandwidth?
    |       rt-types:bandwidth-ieee-float32
    +-- two-way-delay?                 uint32
  grouping performance-metrics-attributes:
    +-- performance-metrics-one-way
    |  +-- one-way-delay?                           uint32
    |  +-- one-way-delay-normality?
    |  |       te-types:performance-metrics-normality
    |  +-- one-way-residual-bandwidth?
    |  |       rt-types:bandwidth-ieee-float32
    |  +-- one-way-residual-bandwidth-normality?
    |  |       te-types:performance-metrics-normality
    |  +-- one-way-available-bandwidth?
    |  |       rt-types:bandwidth-ieee-float32
    |  +-- one-way-available-bandwidth-normality?
    |  |       te-types:performance-metrics-normality
    |  +-- one-way-utilized-bandwidth?
    |  |       rt-types:bandwidth-ieee-float32
    |  +-- one-way-utilized-bandwidth-normality?
    |          te-types:performance-metrics-normality
    +-- performance-metrics-two-way
       +-- two-way-delay?             uint32
       +-- two-way-delay-normality?
               te-types:performance-metrics-normality
  grouping performance-metrics-throttle-container:
    +-- throttle
       +-- one-way-delay-offset?                  uint32
       +-- measure-interval?                      uint32
       +-- advertisement-interval?                uint32
       +-- suppression-interval?                  uint32
       +-- threshold-out
       |  +-- one-way-delay?                 uint32
       |  +-- one-way-residual-bandwidth?
       |  |       rt-types:bandwidth-ieee-float32
       |  +-- one-way-available-bandwidth?
       |  |       rt-types:bandwidth-ieee-float32
       |  +-- one-way-utilized-bandwidth?
       |  |       rt-types:bandwidth-ieee-float32
       |  +-- two-way-delay?                 uint32
       +-- threshold-in
       |  +-- one-way-delay?                 uint32
       |  +-- one-way-residual-bandwidth?
       |  |       rt-types:bandwidth-ieee-float32
       |  +-- one-way-available-bandwidth?
       |  |       rt-types:bandwidth-ieee-float32
       |  +-- one-way-utilized-bandwidth?
       |  |       rt-types:bandwidth-ieee-float32
       |  +-- two-way-delay?                 uint32
       +-- threshold-accelerated-advertisement
          +-- one-way-delay?                 uint32
          +-- one-way-residual-bandwidth?
          |       rt-types:bandwidth-ieee-float32
          +-- one-way-available-bandwidth?
          |       rt-types:bandwidth-ieee-float32
          +-- one-way-utilized-bandwidth?
          |       rt-types:bandwidth-ieee-float32
          +-- two-way-delay?                 uint32
  grouping explicit-route-hop:
    +-- (type)?
       +--:(numbered-node-hop)
       |  +-- numbered-node-hop
       |     +-- node-id-uri?   nw:node-id
       |     +-- node-id?       te-node-id
       |     +-- hop-type?      te-hop-type
       +--:(numbered-link-hop)
       |  +-- numbered-link-hop
       |     +-- link-tp-id    te-tp-id
       |     +-- hop-type?     te-hop-type
       |     +-- direction?    te-link-direction
       +--:(unnumbered-link-hop)
       |  +-- unnumbered-link-hop
       |     +-- link-tp-id-uri?   nt:tp-id
       |     +-- link-tp-id?       te-tp-id
       |     +-- node-id-uri?      nw:node-id
       |     +-- node-id?          te-node-id
       |     +-- hop-type?         te-hop-type
       |     +-- direction?        te-link-direction
       +--:(as-number)
       |  +-- as-number-hop
       |     +-- as-number    inet:as-number
       |     +-- hop-type?    te-hop-type
       +--:(label)
          +-- label-hop
             +-- te-label
                +-- (technology)?
                |  +--:(generic)
                |     +-- generic?   rt-types:generalized-label
                +-- direction?       te-label-direction
  grouping record-route-state:
    +-- index?                       uint32
    +-- (type)?
       +--:(numbered-node-hop)
       |  +-- numbered-node-hop
       |     +-- node-id-uri?   nw:node-id
       |     +-- node-id?       te-node-id
       |     +-- flags*         path-attribute-flags
       +--:(numbered-link-hop)
       |  +-- numbered-link-hop
       |     +-- link-tp-id    te-tp-id
       |     +-- flags*        path-attribute-flags
       +--:(unnumbered-link-hop)
       |  +-- unnumbered-link-hop
       |     +-- link-tp-id-uri?   nt:tp-id
       |     +-- link-tp-id?       te-tp-id
       |     +-- node-id-uri?      nw:node-id
       |     +-- node-id?          te-node-id
       |     +-- flags*            path-attribute-flags
       +--:(label)
          +-- label-hop
             +-- te-label
             |  +-- (technology)?
             |  |  +--:(generic)
             |  |     +-- generic?   rt-types:generalized-label
             |  +-- direction?       te-label-direction
             +-- flags*      path-attribute-flags
  grouping label-restriction-info:
    +-- restriction?    enumeration
    +-- index?          uint32
    +-- label-start
    |  +-- te-label
    |     +-- (technology)?
    |     |  +--:(generic)
    |     |     +-- generic?   rt-types:generalized-label
    |     +-- direction?       te-label-direction
    +-- label-end
    |  +-- te-label
    |     +-- (technology)?
    |     |  +--:(generic)
    |     |     +-- generic?   rt-types:generalized-label
    |     +-- direction?       te-label-direction
    +-- label-step
    |  +-- (technology)?
    |     +--:(generic)
    |        +-- generic?   int32
    +-- range-bitmap?   yang:hex-string
  grouping label-set-info:
    +-- label-restrictions
       +-- label-restriction* [index]
          +-- restriction?    enumeration
          +-- index?          uint32
          +-- label-start
          |  +-- te-label
          |     +-- (technology)?
          |     |  +--:(generic)
          |     |     +-- generic?   rt-types:generalized-label
          |     +-- direction?       te-label-direction
          +-- label-end
          |  +-- te-label
          |     +-- (technology)?
          |     |  +--:(generic)
          |     |     +-- generic?   rt-types:generalized-label
          |     +-- direction?       te-label-direction
          +-- label-step
          |  +-- (technology)?
          |     +--:(generic)
          |        +-- generic?   int32
          +-- range-bitmap?   yang:hex-string
  grouping optimization-metric-entry:
    +-- metric-type?                      identityref
    +-- weight?                           uint8
    +-- explicit-route-exclude-objects
    |  +-- route-object-exclude-object* [index]
    |     +-- index?                       uint32
    |     +-- (type)?
    |        +--:(numbered-node-hop)
    |        |  +-- numbered-node-hop
    |        |     +-- node-id-uri?   nw:node-id
    |        |     +-- node-id?       te-node-id
    |        |     +-- hop-type?      te-hop-type
    |        +--:(numbered-link-hop)
    |        |  +-- numbered-link-hop
    |        |     +-- link-tp-id    te-tp-id
    |        |     +-- hop-type?     te-hop-type
    |        |     +-- direction?    te-link-direction
    |        +--:(unnumbered-link-hop)
    |        |  +-- unnumbered-link-hop
    |        |     +-- link-tp-id-uri?   nt:tp-id
    |        |     +-- link-tp-id?       te-tp-id
    |        |     +-- node-id-uri?      nw:node-id
    |        |     +-- node-id?          te-node-id
    |        |     +-- hop-type?         te-hop-type
    |        |     +-- direction?        te-link-direction
    |        +--:(as-number)
    |        |  +-- as-number-hop
    |        |     +-- as-number    inet:as-number
    |        |     +-- hop-type?    te-hop-type
    |        +--:(label)
    |        |  +-- label-hop
    |        |     +-- te-label
    |        |        +-- (technology)?
    |        |        |  +--:(generic)
    |        |        |     +-- generic?   rt-types:generalized-label
    |        |        +-- direction?       te-label-direction
    |        +--:(srlg)
    |           +-- srlg
    |              +-- srlg?   uint32
    +-- explicit-route-include-objects
       +-- route-object-include-object* [index]
          +-- index?                       uint32
          +-- (type)?
             +--:(numbered-node-hop)
             |  +-- numbered-node-hop
             |     +-- node-id-uri?   nw:node-id
             |     +-- node-id?       te-node-id
             |     +-- hop-type?      te-hop-type
             +--:(numbered-link-hop)
             |  +-- numbered-link-hop
             |     +-- link-tp-id    te-tp-id
             |     +-- hop-type?     te-hop-type
             |     +-- direction?    te-link-direction
             +--:(unnumbered-link-hop)
             |  +-- unnumbered-link-hop
             |     +-- link-tp-id-uri?   nt:tp-id
             |     +-- link-tp-id?       te-tp-id
             |     +-- node-id-uri?      nw:node-id
             |     +-- node-id?          te-node-id
             |     +-- hop-type?         te-hop-type
             |     +-- direction?        te-link-direction
             +--:(as-number)
             |  +-- as-number-hop
             |     +-- as-number    inet:as-number
             |     +-- hop-type?    te-hop-type
             +--:(label)
                +-- label-hop
                   +-- te-label
                      +-- (technology)?
                      |  +--:(generic)
                      |     +-- generic?   rt-types:generalized-label
                      +-- direction?       te-label-direction
  grouping common-constraints:
    +-- te-bandwidth
    |  +-- (technology)?
    |     +--:(generic)
    |        +-- generic?   te-bandwidth
    +-- link-protection?   identityref
    +-- setup-priority?    uint8
    +-- hold-priority?     uint8
    +-- signaling-type?    identityref
  grouping tunnel-constraints:
    +-- network-id?               nw:network-id
    +-- te-topology-identifier
    |  +-- provider-id?   te-global-id
    |  +-- client-id?     te-global-id
    |  +-- topology-id?   te-topology-id
    +-- te-bandwidth
    |  +-- (technology)?
    |     +--:(generic)
    |        +-- generic?   te-bandwidth
    +-- link-protection?          identityref
    +-- setup-priority?           uint8
    +-- hold-priority?            uint8
    +-- signaling-type?           identityref
  grouping path-constraints-route-objects:
    +-- explicit-route-objects
       +-- route-object-exclude-always* [index]
       |  +-- index?                       uint32
       |  +-- (type)?
       |     +--:(numbered-node-hop)
       |     |  +-- numbered-node-hop
       |     |     +-- node-id-uri?   nw:node-id
       |     |     +-- node-id?       te-node-id
       |     |     +-- hop-type?      te-hop-type
       |     +--:(numbered-link-hop)
       |     |  +-- numbered-link-hop
       |     |     +-- link-tp-id    te-tp-id
       |     |     +-- hop-type?     te-hop-type
       |     |     +-- direction?    te-link-direction
       |     +--:(unnumbered-link-hop)
       |     |  +-- unnumbered-link-hop
       |     |     +-- link-tp-id-uri?   nt:tp-id
       |     |     +-- link-tp-id?       te-tp-id
       |     |     +-- node-id-uri?      nw:node-id
       |     |     +-- node-id?          te-node-id
       |     |     +-- hop-type?         te-hop-type
       |     |     +-- direction?        te-link-direction
       |     +--:(as-number)
       |     |  +-- as-number-hop
       |     |     +-- as-number    inet:as-number
       |     |     +-- hop-type?    te-hop-type
       |     +--:(label)
       |        +-- label-hop
       |           +-- te-label
       |              +-- (technology)?
       |              |  +--:(generic)
       |              |     +-- generic?   rt-types:generalized-label
       |              +-- direction?       te-label-direction
       +-- route-object-include-exclude* [index]
          +-- explicit-route-usage?        identityref
          +-- index?                       uint32
          +-- (type)?
             +--:(numbered-node-hop)
             |  +-- numbered-node-hop
             |     +-- node-id-uri?   nw:node-id
             |     +-- node-id?       te-node-id
             |     +-- hop-type?      te-hop-type
             +--:(numbered-link-hop)
             |  +-- numbered-link-hop
             |     +-- link-tp-id    te-tp-id
             |     +-- hop-type?     te-hop-type
             |     +-- direction?    te-link-direction
             +--:(unnumbered-link-hop)
             |  +-- unnumbered-link-hop
             |     +-- link-tp-id-uri?   nt:tp-id
             |     +-- link-tp-id?       te-tp-id
             |     +-- node-id-uri?      nw:node-id
             |     +-- node-id?          te-node-id
             |     +-- hop-type?         te-hop-type
             |     +-- direction?        te-link-direction
             +--:(as-number)
             |  +-- as-number-hop
             |     +-- as-number    inet:as-number
             |     +-- hop-type?    te-hop-type
             +--:(label)
             |  +-- label-hop
             |     +-- te-label
             |        +-- (technology)?
             |        |  +--:(generic)
             |        |     +-- generic?   rt-types:generalized-label
             |        +-- direction?       te-label-direction
             +--:(srlg)
                +-- srlg
                   +-- srlg?   uint32
  grouping path-route-include-objects:
    +-- route-object-include-object* [index]
       +-- index?                       uint32
       +-- (type)?
          +--:(numbered-node-hop)
          |  +-- numbered-node-hop
          |     +-- node-id-uri?   nw:node-id
          |     +-- node-id?       te-node-id
          |     +-- hop-type?      te-hop-type
          +--:(numbered-link-hop)
          |  +-- numbered-link-hop
          |     +-- link-tp-id    te-tp-id
          |     +-- hop-type?     te-hop-type
          |     +-- direction?    te-link-direction
          +--:(unnumbered-link-hop)
          |  +-- unnumbered-link-hop
          |     +-- link-tp-id-uri?   nt:tp-id
          |     +-- link-tp-id?       te-tp-id
          |     +-- node-id-uri?      nw:node-id
          |     +-- node-id?          te-node-id
          |     +-- hop-type?         te-hop-type
          |     +-- direction?        te-link-direction
          +--:(as-number)
          |  +-- as-number-hop
          |     +-- as-number    inet:as-number
          |     +-- hop-type?    te-hop-type
          +--:(label)
             +-- label-hop
                +-- te-label
                   +-- (technology)?
                   |  +--:(generic)
                   |     +-- generic?   rt-types:generalized-label
                   +-- direction?       te-label-direction
  grouping path-route-exclude-objects:
    +-- route-object-exclude-object* [index]
       +-- index?                       uint32
       +-- (type)?
          +--:(numbered-node-hop)
          |  +-- numbered-node-hop
          |     +-- node-id-uri?   nw:node-id
          |     +-- node-id?       te-node-id
          |     +-- hop-type?      te-hop-type
          +--:(numbered-link-hop)
          |  +-- numbered-link-hop
          |     +-- link-tp-id    te-tp-id
          |     +-- hop-type?     te-hop-type
          |     +-- direction?    te-link-direction
          +--:(unnumbered-link-hop)
          |  +-- unnumbered-link-hop
          |     +-- link-tp-id-uri?   nt:tp-id
          |     +-- link-tp-id?       te-tp-id
          |     +-- node-id-uri?      nw:node-id
          |     +-- node-id?          te-node-id
          |     +-- hop-type?         te-hop-type
          |     +-- direction?        te-link-direction
          +--:(as-number)
          |  +-- as-number-hop
          |     +-- as-number    inet:as-number
          |     +-- hop-type?    te-hop-type
          +--:(label)
          |  +-- label-hop
          |     +-- te-label
          |        +-- (technology)?
          |        |  +--:(generic)
          |        |     +-- generic?   rt-types:generalized-label
          |        +-- direction?       te-label-direction
          +--:(srlg)
             +-- srlg
                +-- srlg?   uint32
  grouping generic-path-metric-bounds:
    +-- path-metric-bounds
       +-- path-metric-bound* [metric-type]
          +-- metric-type?   identityref
          +-- upper-bound?   uint64
  grouping generic-path-optimization:
    +-- optimizations
    |  +-- (algorithm)?
    |     +--:(metric) {path-optimization-metric}?
    |     |  +-- optimization-metric* [metric-type]
    |     |  |  +-- metric-type?                      identityref
    |     |  |  +-- weight?                           uint8
    |     |  |  +-- explicit-route-exclude-objects
    |     |  |  |  +-- route-object-exclude-object* [index]
    |     |  |  |     +-- index?                       uint32
    |     |  |  |     +-- (type)?
    |     |  |  |        +--:(numbered-node-hop)
    |     |  |  |        |  +-- numbered-node-hop
    |     |  |  |        |     +-- node-id-uri?   nw:node-id
    |     |  |  |        |     +-- node-id?       te-node-id
    |     |  |  |        |     +-- hop-type?      te-hop-type
    |     |  |  |        +--:(numbered-link-hop)
    |     |  |  |        |  +-- numbered-link-hop
    |     |  |  |        |     +-- link-tp-id    te-tp-id
    |     |  |  |        |     +-- hop-type?     te-hop-type
    |     |  |  |        |     +-- direction?    te-link-direction
    |     |  |  |        +--:(unnumbered-link-hop)
    |     |  |  |        |  +-- unnumbered-link-hop
    |     |  |  |        |     +-- link-tp-id-uri?   nt:tp-id
    |     |  |  |        |     +-- link-tp-id?       te-tp-id
    |     |  |  |        |     +-- node-id-uri?      nw:node-id
    |     |  |  |        |     +-- node-id?          te-node-id
    |     |  |  |        |     +-- hop-type?         te-hop-type
    |     |  |  |        |     +-- direction?
    |     |  |  |        |             te-link-direction
    |     |  |  |        +--:(as-number)
    |     |  |  |        |  +-- as-number-hop
    |     |  |  |        |     +-- as-number    inet:as-number
    |     |  |  |        |     +-- hop-type?    te-hop-type
    |     |  |  |        +--:(label)
    |     |  |  |        |  +-- label-hop
    |     |  |  |        |     +-- te-label
    |     |  |  |        |        +-- (technology)?
    |     |  |  |        |        |  +--:(generic)
    |     |  |  |        |        |     +-- generic?
    |     |  |  |        |        |             rt-types:generalized\
-label
    |     |  |  |        |        +-- direction?
    |     |  |  |        |                te-label-direction
    |     |  |  |        +--:(srlg)
    |     |  |  |           +-- srlg
    |     |  |  |              +-- srlg?   uint32
    |     |  |  +-- explicit-route-include-objects
    |     |  |     +-- route-object-include-object* [index]
    |     |  |        +-- index?                       uint32
    |     |  |        +-- (type)?
    |     |  |           +--:(numbered-node-hop)
    |     |  |           |  +-- numbered-node-hop
    |     |  |           |     +-- node-id-uri?   nw:node-id
    |     |  |           |     +-- node-id?       te-node-id
    |     |  |           |     +-- hop-type?      te-hop-type
    |     |  |           +--:(numbered-link-hop)
    |     |  |           |  +-- numbered-link-hop
    |     |  |           |     +-- link-tp-id    te-tp-id
    |     |  |           |     +-- hop-type?     te-hop-type
    |     |  |           |     +-- direction?    te-link-direction
    |     |  |           +--:(unnumbered-link-hop)
    |     |  |           |  +-- unnumbered-link-hop
    |     |  |           |     +-- link-tp-id-uri?   nt:tp-id
    |     |  |           |     +-- link-tp-id?       te-tp-id
    |     |  |           |     +-- node-id-uri?      nw:node-id
    |     |  |           |     +-- node-id?          te-node-id
    |     |  |           |     +-- hop-type?         te-hop-type
    |     |  |           |     +-- direction?
    |     |  |           |             te-link-direction
    |     |  |           +--:(as-number)
    |     |  |           |  +-- as-number-hop
    |     |  |           |     +-- as-number    inet:as-number
    |     |  |           |     +-- hop-type?    te-hop-type
    |     |  |           +--:(label)
    |     |  |              +-- label-hop
    |     |  |                 +-- te-label
    |     |  |                    +-- (technology)?
    |     |  |                    |  +--:(generic)
    |     |  |                    |     +-- generic?
    |     |  |                    |             rt-types:generalized\
-label
    |     |  |                    +-- direction?
    |     |  |                            te-label-direction
    |     |  x-- tiebreakers
    |     |     x-- tiebreaker* [tiebreaker-type]
    |     |        x-- tiebreaker-type?   identityref
    |     +--:(objective-function)
    |              {path-optimization-objective-function}?
    |        +-- objective-function
    |           +-- objective-function-type?   identityref
    +-- tiebreaker?      identityref
  grouping generic-path-affinities:
    +-- path-affinities-values
    |  +-- path-affinities-value* [usage]
    |     +-- usage?   identityref
    |     +-- value?   admin-groups
    +-- path-affinity-names
       +-- path-affinity-name* [usage]
          +-- usage?           identityref
          +-- affinity-name* [name]
             +-- name?   string
  grouping generic-path-srlgs:
    +-- path-srlgs-lists
    |  +-- path-srlgs-list* [usage]
    |     +-- usage?    identityref
    |     +-- values*   srlg
    +-- path-srlgs-names
       +-- path-srlgs-name* [usage]
          +-- usage?   identityref
          +-- names*   string
  grouping generic-path-disjointness:
    +-- disjointness?   te-path-disjointness
  grouping common-path-constraints-attributes:
    +-- te-bandwidth
    |  +-- (technology)?
    |     +--:(generic)
    |        +-- generic?   te-bandwidth
    +-- link-protection?          identityref
    +-- setup-priority?           uint8
    +-- hold-priority?            uint8
    +-- signaling-type?           identityref
    +-- path-metric-bounds
    |  +-- path-metric-bound* [metric-type]
    |     +-- metric-type?   identityref
    |     +-- upper-bound?   uint64
    +-- path-affinities-values
    |  +-- path-affinities-value* [usage]
    |     +-- usage?   identityref
    |     +-- value?   admin-groups
    +-- path-affinity-names
    |  +-- path-affinity-name* [usage]
    |     +-- usage?           identityref
    |     +-- affinity-name* [name]
    |        +-- name?   string
    +-- path-srlgs-lists
    |  +-- path-srlgs-list* [usage]
    |     +-- usage?    identityref
    |     +-- values*   srlg
    +-- path-srlgs-names
       +-- path-srlgs-name* [usage]
          +-- usage?   identityref
          +-- names*   string
  grouping generic-path-constraints:
    +-- path-constraints
       +-- te-bandwidth
       |  +-- (technology)?
       |     +--:(generic)
       |        +-- generic?   te-bandwidth
       +-- link-protection?          identityref
       +-- setup-priority?           uint8
       +-- hold-priority?            uint8
       +-- signaling-type?           identityref
       +-- path-metric-bounds
       |  +-- path-metric-bound* [metric-type]
       |     +-- metric-type?   identityref
       |     +-- upper-bound?   uint64
       +-- path-affinities-values
       |  +-- path-affinities-value* [usage]
       |     +-- usage?   identityref
       |     +-- value?   admin-groups
       +-- path-affinity-names
       |  +-- path-affinity-name* [usage]
       |     +-- usage?           identityref
       |     +-- affinity-name* [name]
       |        +-- name?   string
       +-- path-srlgs-lists
       |  +-- path-srlgs-list* [usage]
       |     +-- usage?    identityref
       |     +-- values*   srlg
       +-- path-srlgs-names
       |  +-- path-srlgs-name* [usage]
       |     +-- usage?   identityref
       |     +-- names*   string
       +-- disjointness?             te-path-disjointness
  grouping generic-path-properties:
    +--ro path-properties
       +--ro path-metric* [metric-type]
       |  +--ro metric-type?          identityref
       |  +--ro accumulative-value?   uint64
       +--ro path-affinities-values
       |  +--ro path-affinities-value* [usage]
       |     +--ro usage?   identityref
       |     +--ro value?   admin-groups
       +--ro path-affinity-names
       |  +--ro path-affinity-name* [usage]
       |     +--ro usage?           identityref
       |     +--ro affinity-name* [name]
       |        +--ro name?   string
       +--ro path-srlgs-lists
       |  +--ro path-srlgs-list* [usage]
       |     +--ro usage?    identityref
       |     +--ro values*   srlg
       +--ro path-srlgs-names
       |  +--ro path-srlgs-name* [usage]
       |     +--ro usage?   identityref
       |     +--ro names*   string
       +--ro path-route-objects
          +--ro path-route-object* [index]
             +--ro index?                       uint32
             +--ro (type)?
                +--:(numbered-node-hop)
                |  +--ro numbered-node-hop
                |     +--ro node-id-uri?   nw:node-id
                |     +--ro node-id?       te-node-id
                |     +--ro hop-type?      te-hop-type
                +--:(numbered-link-hop)
                |  +--ro numbered-link-hop
                |     +--ro link-tp-id    te-tp-id
                |     +--ro hop-type?     te-hop-type
                |     +--ro direction?    te-link-direction
                +--:(unnumbered-link-hop)
                |  +--ro unnumbered-link-hop
                |     +--ro link-tp-id-uri?   nt:tp-id
                |     +--ro link-tp-id?       te-tp-id
                |     +--ro node-id-uri?      nw:node-id
                |     +--ro node-id?          te-node-id
                |     +--ro hop-type?         te-hop-type
                |     +--ro direction?        te-link-direction
                +--:(as-number)
                |  +--ro as-number-hop
                |     +--ro as-number    inet:as-number
                |     +--ro hop-type?    te-hop-type
                +--:(label)
                   +--ro label-hop
                      +--ro te-label
                         +--ro (technology)?
                         |  +--:(generic)
                         |     +--ro generic?
                         |             rt-types:generalized-label
                         +--ro direction?       te-label-direction
  grouping encoding-and-switching-type:
    +-- encoding?         identityref
    +-- switching-type?   identityref
  grouping te-generic-node-id:
    +-- id?     union
    +-- type?   enumeration
]]></artwork></figure>

</section>
<section anchor="packet-te-types-schema-tree"><name>Packet TE Types Schema Tree</name>

<figure><artwork type="ascii-art"><![CDATA[
module: ietf-te-packet-types

  grouping performance-metrics-attributes-packet:
    +-- performance-metrics-one-way
    |  +-- one-way-delay?                           uint32
    |  +-- one-way-delay-normality?
    |  |       te-types:performance-metrics-normality
    |  +-- one-way-residual-bandwidth?
    |  |       rt-types:bandwidth-ieee-float32
    |  +-- one-way-residual-bandwidth-normality?
    |  |       te-types:performance-metrics-normality
    |  +-- one-way-available-bandwidth?
    |  |       rt-types:bandwidth-ieee-float32
    |  +-- one-way-available-bandwidth-normality?
    |  |       te-types:performance-metrics-normality
    |  +-- one-way-utilized-bandwidth?
    |  |       rt-types:bandwidth-ieee-float32
    |  +-- one-way-utilized-bandwidth-normality?
    |  |       te-types:performance-metrics-normality
    |  +-- one-way-min-delay?                       uint32
    |  +-- one-way-min-delay-normality?
    |  |       te-types:performance-metrics-normality
    |  +-- one-way-max-delay?                       uint32
    |  +-- one-way-max-delay-normality?
    |  |       te-types:performance-metrics-normality
    |  +-- one-way-delay-variation?                 uint32
    |  +-- one-way-delay-variation-normality?
    |  |       te-types:performance-metrics-normality
    |  +-- one-way-packet-loss?                     decimal64
    |  +-- one-way-packet-loss-normality?
    |          te-types:performance-metrics-normality
    +-- performance-metrics-two-way
       +-- two-way-delay?                       uint32
       +-- two-way-delay-normality?
       |       te-types:performance-metrics-normality
       +-- two-way-min-delay?                   uint32
       +-- two-way-min-delay-normality?
       |       te-types:performance-metrics-normality
       +-- two-way-max-delay?                   uint32
       +-- two-way-max-delay-normality?
       |       te-types:performance-metrics-normality
       +-- two-way-delay-variation?             uint32
       +-- two-way-delay-variation-normality?
       |       te-types:performance-metrics-normality
       +-- two-way-packet-loss?                 decimal64
       +-- two-way-packet-loss-normality?
               te-types:performance-metrics-normality
  grouping one-way-performance-metrics-packet:
    +-- one-way-min-delay?         uint32
    +-- one-way-max-delay?         uint32
    +-- one-way-delay-variation?   uint32
    +-- one-way-packet-loss?       decimal64
  grouping one-way-performance-metrics-gauge-packet:
    +-- one-way-min-delay?         yang:gauge64
    +-- one-way-max-delay?         yang:gauge64
    +-- one-way-delay-variation?   yang:gauge64
    +-- one-way-packet-loss?       decimal64
  grouping two-way-performance-metrics-packet:
    +-- two-way-min-delay?         uint32
    +-- two-way-max-delay?         uint32
    +-- two-way-delay-variation?   uint32
    +-- two-way-packet-loss?       decimal64
  grouping two-way-performance-metrics-gauge-packet:
    +-- two-way-min-delay?         yang:gauge64
    +-- two-way-max-delay?         yang:gauge64
    +-- two-way-delay-variation?   yang:gauge64
    +-- two-way-packet-loss?       decimal64
  grouping performance-metrics-throttle-container-packet:
    +-- throttle
       +-- one-way-delay-offset?                  uint32
       +-- measure-interval?                      uint32
       +-- advertisement-interval?                uint32
       +-- suppression-interval?                  uint32
       +-- threshold-out
       |  +-- one-way-delay?                 uint32
       |  +-- one-way-residual-bandwidth?
       |  |       rt-types:bandwidth-ieee-float32
       |  +-- one-way-available-bandwidth?
       |  |       rt-types:bandwidth-ieee-float32
       |  +-- one-way-utilized-bandwidth?
       |  |       rt-types:bandwidth-ieee-float32
       |  +-- two-way-delay?                 uint32
       |  +-- one-way-min-delay?             uint32
       |  +-- one-way-max-delay?             uint32
       |  +-- one-way-delay-variation?       uint32
       |  +-- one-way-packet-loss?           decimal64
       |  +-- two-way-min-delay?             uint32
       |  +-- two-way-max-delay?             uint32
       |  +-- two-way-delay-variation?       uint32
       |  +-- two-way-packet-loss?           decimal64
       +-- threshold-in
       |  +-- one-way-delay?                 uint32
       |  +-- one-way-residual-bandwidth?
       |  |       rt-types:bandwidth-ieee-float32
       |  +-- one-way-available-bandwidth?
       |  |       rt-types:bandwidth-ieee-float32
       |  +-- one-way-utilized-bandwidth?
       |  |       rt-types:bandwidth-ieee-float32
       |  +-- two-way-delay?                 uint32
       |  +-- one-way-min-delay?             uint32
       |  +-- one-way-max-delay?             uint32
       |  +-- one-way-delay-variation?       uint32
       |  +-- one-way-packet-loss?           decimal64
       |  +-- two-way-min-delay?             uint32
       |  +-- two-way-max-delay?             uint32
       |  +-- two-way-delay-variation?       uint32
       |  +-- two-way-packet-loss?           decimal64
       +-- threshold-accelerated-advertisement
          +-- one-way-delay?                 uint32
          +-- one-way-residual-bandwidth?
          |       rt-types:bandwidth-ieee-float32
          +-- one-way-available-bandwidth?
          |       rt-types:bandwidth-ieee-float32
          +-- one-way-utilized-bandwidth?
          |       rt-types:bandwidth-ieee-float32
          +-- two-way-delay?                 uint32
          +-- one-way-min-delay?             uint32
          +-- one-way-max-delay?             uint32
          +-- one-way-delay-variation?       uint32
          +-- one-way-packet-loss?           decimal64
          +-- two-way-min-delay?             uint32
          +-- two-way-max-delay?             uint32
          +-- two-way-delay-variation?       uint32
          +-- two-way-packet-loss?           decimal64
  grouping bandwidth-profile-parameters:
    +-- cir?   uint64
    +-- cbs?   uint64
    +-- eir?   uint64
    +-- ebs?   uint64
    +-- pir?   uint64
    +-- pbs?   uint64
  grouping te-packet-path-bandwidth:
    +-- packet-bandwidth
       +-- specification-type?   te-bandwidth-requested-type
       +-- set-bandwidth?        bandwidth-kbps
       +-- bandwidth-profile
       |  +-- bandwidth-profile-name?   string
       |  +-- bandwidth-profile-type?   identityref
       |  +-- cir?                      uint64
       |  +-- cbs?                      uint64
       |  +-- eir?                      uint64
       |  +-- ebs?                      uint64
       |  +-- pir?                      uint64
       |  +-- pbs?                      uint64
       +-- class-type?           te-types:te-ds-class
       +--ro signaled-bandwidth?   te-packet-types:bandwidth-kbps
  grouping te-packet-link-bandwidth:
    +-- packet-bandwidth?   uint64
]]></artwork></figure>

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

<t>This version adds new common data types, identities, and groupings to the YANG modules. It also updates some of the existing data types, identities, and groupings in the YANG modules and fixes few bugs in <xref target="RFC8776"/>.</t>

<t>The following new identities have been added to the 'ietf-te-types' module:</t>

<t><list style="symbols">
  <t>lsp-provisioning-error-reason;</t>
  <t>association-type-diversity;</t>
  <t>tunnel-admin-state-auto;</t>
  <t>lsp-restoration-restore-none;</t>
  <t>restoration-scheme-rerouting;</t>
  <t>path-metric-optimization-type;</t>
  <t>link-path-metric-type;</t>
  <t>link-metric-type and its derived identities;</t>
  <t>path-computation-error-reason and its derived identities;</t>
  <t>protocol-origin-type and its derived identities;</t>
  <t>svec-objective-function-type and its derived identities;</t>
  <t>svec-metric-type and its derived identities.</t>
</list></t>

<t>The following new data types have been added to the 'ietf-te-types' module:</t>

<t><list style="symbols">
  <t>path-type;</t>
  <t>te-gen-node-id.</t>
</list></t>

<t>The following new groupings have been added to the 'ietf-te-types' module:</t>

<t><list style="symbols">
  <t>encoding-and-switching-type;</t>
  <t>te-generic-node-id.</t>
</list></t>

<t>The following new identities have been added to the 'ietf-te-packet-types' module:</t>

<t><list style="symbols">
  <t>bandwidth-profile-type;</t>
  <t>link-metric-delay-variation;</t>
  <t>link-metric-loss;</t>
  <t>path-metric-delay-variation;</t>
  <t>path-metric-loss.</t>
</list></t>

<t>The following new groupings have been added to the 'ietf-te-packet-types' module:</t>

<t><list style="symbols">
  <t>te-packet-path-bandwidth;</t>
  <t>te-packet-link-bandwidth.</t>
</list></t>

<t>The following identities, already defined in <xref target="RFC8776"/>, have been updated in the 'ietf-te-types' module:</t>

<t><list style="symbols">
  <t>objective-function-type (editorial);</t>
  <t>action-exercise (bug fix);</t>
  <t>path-metric-type:  <vspace blankLines='1'/>
new base identities have been added;</t>
  <t>path-metric-te (bug fix);</t>
  <t>path-metric-igp (bug fix);</t>
  <t>path-metric-hop (bug fix);</t>
  <t>path-metric-delay-average (bug fix);</t>
  <t>path-metric-delay-minimum (bug fix);</t>
  <t>path-metric-residual-bandwidth (bug fix);</t>
  <t>path-metric-optimize-includes (bug fix);</t>
  <t>path-metric-optimize-excludes (bug fix);</t>
  <t>te-optimization-criterion (editorial).</t>
</list></t>

<t>The following data type, already defined in <xref target="RFC8776"/>, has been updated in the 'ietf-te-types' module:</t>

<t><list style="symbols">
  <t>te-node-id;  <vspace blankLines='1'/>
The data type has been changed to be a union.</t>
</list></t>

<t>The following groupings, already defined in <xref target="RFC8776"/>, have been updated in the 'ietf-te-types' module:</t>

<t><list style="symbols">
  <t>explicit-route-hop  <vspace blankLines='1'/>
The following new leaves have been added to the 'explicit-route-hop' grouping:  <list style="symbols">
      <t>node-id-uri;</t>
      <t>link-tp-id-uri;</t>
    </list>
The following leaves, already defined in <xref target="RFC8776"/>, have been updated in the 'explicit-route-hop':  <list style="symbols">
      <t>node-id;</t>
      <t>link-tp-id.      <vspace blankLines='1'/>
The mandatory true statements for the node-id and link-tp-id have been replaced by must statements that requires at least the presence of:      <list style="symbols">
          <t>node-id or node-id-uri;</t>
          <t>link-tp-id or link-tp-id-uri.</t>
        </list></t>
    </list></t>
  <t>explicit-route-hop  <vspace blankLines='1'/>
The following new leaves have been added to the 'explicit-route-hop' grouping:  <list style="symbols">
      <t>node-id-uri;</t>
      <t>link-tp-id-uri;</t>
    </list>
The following leaves, already defined in <xref target="RFC8776"/>, have been updated in the 'explicit-route-hop':  <list style="symbols">
      <t>node-id;</t>
      <t>link-tp-id.      <vspace blankLines='1'/>
The mandatory true statements for the node-id and link-tp-id have been replaced by must statements that requires at least the presence of:      <list style="symbols">
          <t>node-id or node-id-uri;</t>
          <t>link-tp-id or link-tp-id-uri.</t>
        </list></t>
    </list></t>
  <t>optimization-metric-entry:  <vspace blankLines='1'/>
The following leaves, already defined in <xref target="RFC8776"/>, have been updated in the 'optimization-metric-entry':  <list style="symbols">
      <t>metric-type;      <vspace blankLines='1'/>
The base identity has been updated without impacting the set of derived identities that are allowed.</t>
    </list></t>
  <t>tunnel-constraints;  <vspace blankLines='1'/>
The following new leaf have been added to the 'tunnel-constraints' grouping:  <list style="symbols">
      <t>network-id;</t>
    </list></t>
  <t>path-constraints-route-objects:  <vspace blankLines='1'/>
The following container, already defined in <xref target="RFC8776"/>, has been updated in the 'path-constraints-route-objects':  <list style="symbols">
      <t>explicit-route-objects-always;      <vspace blankLines='1'/>
The container has been renamed as 'explicit-route-objects'. This change is not affecting any IETF standard YANG models since this grouping has not yet been used by any YANG model defined in existing IETF RFCs.</t>
    </list></t>
  <t>generic-path-metric-bounds:  <vspace blankLines='1'/>
The following leaves, already defined in <xref target="RFC8776"/>, have been updated in the 'optimization-metric-entry':  <list style="symbols">
      <t>metric-type;      <vspace blankLines='1'/>
The base identity has been updated to:      <list style="symbols">
          <t>increase the set of derived identities that are allowed and;</t>
          <t>remove from this set the 'path-metric-optimize-includes' and the 'path-metric-optimize-excludes' identities (bug fixing)</t>
        </list></t>
    </list></t>
  <t>generic-path-optimization  <vspace blankLines='1'/>
The following new leaf have been added to the 'generic-path-optimization' grouping:  <list style="symbols">
      <t>tiebreaker;</t>
    </list>
The following container, already defined in <xref target="RFC8776"/>, has been deprecated:  <list style="symbols">
      <t>tiebreakers.</t>
    </list></t>
</list></t>

<t>The following identities, already defined in <xref target="RFC8776"/>, have been obsoletes in the 'ietf-te-types' module for bug fixing:</t>

<t><list style="symbols">
  <t>of-minimize-agg-bandwidth-consumption;</t>
  <t>of-minimize-load-most-loaded-link;</t>
  <t>of-minimize-cost-path-set;</t>
  <t>lsp-protection-reroute-extra;</t>
  <t>lsp-protection-reroute.</t>
</list></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>The authors would like to thank
Mohamed Boucadair
and
Sergio Belotti
for their valuable comments and suggestions on this document.</t>

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

</section>

    <section anchor="contributors" numbered="false" toc="include" removeInRFC="false">
        <name>Contributors</name>
    <contact initials="V. P." surname="Beeram" fullname="Vishnu Pavan Beeram">
      <organization>Juniper Networks</organization>
      <address>
        <email>vbeeram@juniper.net</email>
      </address>
    </contact>
    <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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
yjvEYgC8UWERGFJP77BDgJm5jWZ5FbSm9fHwldFuKdQvgsWFbCF5b5L0Bwxv
E+pC3ZKlCcwKktRSl0qOK39YObrTRKFhelc0q9KVQL3GrcaGV20v3mquAqXW
m6AVpWIvyZWh1bg5qkHABqbKaaUlsQQesh8hXgXWLghj/Hy+EuYwa34hjugo
rIoZDI0FOLAiyrekNx5MqHpRWQs9hOOwC0VNO6uCv7LBa9UerbcguvXCYMQW
3HInUaYFeQFpBc04h9ZfUtqQGCVxkfG1CDeQ5N0cNaSOHk89Nvt3b+hZGImP
Nb9004Je36Cq1ljqeu4N3/uZaCtG3aS115H+MIn5R6xkL68yt3q7Dfc3VjqC
8Ftk7yF0r5UMPtznQB5jFSaqP+rybhleUFsAWsCbWESBt9Z1I4yFLKuFIrYN
HHkTs0LZ4zHLPwNrVHUwprtTGq1JOdsQxDXxYPwOeQ35R0EwLB6wl0FQIEZ+
ed6ogzACnLFEAo6iZUXJs6kRwXqTxO/9auWs45QOp/5sGeO0KIIMULUytgyq
CrqadKvAr4F0WuNhEWMgY0EY7ZBegtescXZQG/RYnh61mcMohPcRqjKjB/36
q5zxxrmEqbGJ9dZbeaE/v5S0avG3MGeOCXgyCeWReGkOMk+w4Ba/MuU8/Vjp
f6sh9fKUtgZbrZbOfIjfL5VZUbpHpbIc4qulsnkCX7oyiWn2FLKxbVZPTXfM
B1NsJQQz6VXhsWhVVqVM2AZZXNfKqqzbCPqlJlE3+H8UkXj/IFZoZQF6LhYx
vd5Bc6DLuz/BJOzErjY+FomPrrOtStHRIiZaA9A+OvqrYP3jMV1ym0o9Y4FS
o/7Okwx8ehlglWxsLrAFFeng4A0FhnBWUm3vFtz+fdC3VNhmYfoWaAfkHujk
xmzq9a+emHmE+e6V1YKWENo/DJx3kVGYQBH19ymwN49A4pdPFG5b0m5hApsV
7b5eelZRk907tz4+xWOdPuwumRfsEeWn5nkyj9Ma312EFWZt3s0iWo3uYYLD
4i2aubS3vf9M9X6MUmILkHgchL7oRH/RxZq4vpdoq0yjMjF7Z2v/QFLZ6Wi7
CIZZaKfzrnPtJ7MgisN4Yi9pioRrz3YrCC4K1auHOQboUhSTHjXuPZgBlNak
rRZJVc3O9DgC5IrAFLxRUCAqhe8F5IKm1N+EuTAo2mLqsahLIBQWY2NBfkh4
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
gd/fN8XprD6Ds9b/A/M5mCV8jAMA

-->

</rfc>

