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


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

]>

<?rfc comments="yes"?>

<rfc ipr="trust200902" docName="draft-ietf-teas-rfc8776-update-01" category="std" consensus="true" submissionType="IETF" obsoletes="8776" tocInclude="true" sortRefs="true" symRefs="true">
  <front>
    <title abbrev="Yang updates for TE Types">Updated 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>IBM Corporation</organization>
      <address>
        <email>xufeng.liu.ietf@gmail.com</email>
      </address>
    </author>
    <author initials="T." surname="Saad" fullname="Tarek Saad">
      <organization>Juniper Networks</organization>
      <address>
        <email>tsaad@juniper.net</email>
      </address>
    </author>
    <author initials="R." surname="Gandhi" fullname="Rakesh Gandhi">
      <organization>Cisco Systems, Inc.</organization>
      <address>
        <email>rgandhi@cisco.com</email>
      </address>
    </author>
    <author initials="V. P." surname="Beeram" fullname="Vishnu Pavan Beeram">
      <organization>Juniper Networks</organization>
      <address>
        <email>vbeeram@juniper.net</email>
      </address>
    </author>
    <author initials="I." surname="Bryskin" fullname="Igor Bryskin">
      <organization>Individual</organization>
      <address>
        <email>i_bryskin@yahoo.com</email>
      </address>
    </author>

    <date year="2022" month="October" day="24"/>

    
    <workgroup>TEAS Working Group</workgroup>
    

    <abstract>


<t>This document defines few additional common data types, identities, and groupings
   in YANG data modeling language to be imported by modules that model Traffic
   Engineering (TE) configuration and state capabilities.</t>

<t>Editors' note: Copy the text from <xref target="RFC8776"/> and merge it with the content of this section before WG LC if the RFC8876-bis approach is confirmed.</t>

<t>This document updates RFC 8776 with a new revision of the module
   ietf-te-types.</t>



    </abstract>



  </front>

  <middle>


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

<t>After the publication of <xref target="RFC8776"/>, few additional common data types, identities, and groupings have been defined. Given their broad applicability this document defines them as part of the revised ietf-te-types YANG model.</t>

<t>Editors' note: Copy the text from <xref target="RFC8776"/> and merge it with the content of this section before WG LC if the RFC8876-bis approach is confirmed.</t>

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

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

<section anchor="requirements-notation"><name>Requirements Notation</name>

<t>The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL
NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED",
"MAY", and "OPTIONAL" in this document are to be interpreted as
described in BCP 14 <xref target="RFC2119"/> <xref target="RFC8174"/> when, and only when, they
appear in all capitals, as shown here.</t>

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

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

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

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

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

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

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

<t>Editors' note: Copy the text from <xref target="RFC8776"/> before WG LC if the RFC8876-bis approach is confirmed.</t>

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

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

<t>Editors' note: Copy the text from <xref target="RFC8776"/> and merge it with the content of this section before WG LC if the RFC8876-bis approach is confirmed.</t>

<t>The module ietf-te-types updates the following YANG identities defined in <xref target="RFC8776"/>:</t>

<t>association-type:</t>

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

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

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

<t>CHANGE NOTE: The association-type-diversity identity, defined in <xref target="RFC8800"/> has been added to the association-type base identity. The of-minimize-agg-bandwidth-consumption, of-minimize-load-most-loaded-link and of-minimize-cost-path-set, defined in <xref target="RFC5541"/>, have been obsoleted because not applicable to paths but to Synchronization VECtor (SVEC) objects.</t>

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

<t>The module ietf-te-types has been updated to add the following YANG identities, types and groupings which can be reused by TE YANG models:</t>

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

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

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

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

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

<ul empty="true"><li>
  <t>A base YANG identity for reporting path computation error reasons, as defined in <xref target="RFC5440"/>, <xref target="RFC5441"/>, <xref target="RFC5520"/>, <xref target="RFC5557"/>, <xref target="RFC8306"/> and <xref target="RFC8685"/>.</t>
</li></ul>

<t>Editors' Note: how to describe the path computation error reasons defined in this document?</t>

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

<ul empty="true"><li>
  <t>A base YANG identity for tunnel actions.</t>
</li></ul>

<t>Editors' Note: check whether standard tunnel actions should be defined in this document or not.</t>

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

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

<t>Editors' Note: how to describe the protocol origin types defined in this document?</t>

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

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

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

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

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

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

<t>Editors' Note: how to describe the tunnel-admin-auto, which is defined in this document as derived from tunnel-admin-status-type base identity?</t>

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

<t>Editors' note: Copy the text from <xref target="RFC8776"/> before WG LC if the RFC8876-bis approach is confirmed.</t>

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

<t>Editors' note: Copy the text from <xref target="RFC8776"/> and merge it with the content of this section before WG LC if the RFC8876-bis approach is confirmed.</t>

<t>This section provides the updated revision of the "ietf-te-types"
YANG module.</t>

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

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

<figure title="TE Types YANG module" anchor="fig-pc-yang"><sourcecode type="yang" markers="true" name="ietf-te-types@2022-10-21.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";
  }

  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) 2022 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 2022-10-21 {
    description
      "Added:
      - typedef bandwidth-scientific-notation;
      - base identity lsp-provisioning-error-reason;
      - identity association-type-diversity;
      - identity tunnel-admin-auto;
      - base identity path-computation-error-reason and
        its derived identities;
      - base identity tunnel-actions-type and its derived 
        identities;
      - base identity protocol-origin-type and
        its derived identities;
      - base identity svec-objective-function-type and its derived
        identities;
      - base identity svec-metric-type and its derived identities;
      - grouping encoding-and-switching-type.
      
      Updated:
      - description of the base identity objective-function-type.
      
      Obsoleted:
      - identity of-minimize-agg-bandwidth-consumption
      - identity of-minimize-load-most-loaded-link
      - identity of-minimize-cost-path-set";
    reference
      "RFC XXXX: Updated Common YANG Data Types for Traffic
      Engineering";
  }
  // RFC Editor: replace XXXX with actual RFC number, update date
  // information and remove this note

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

  /**
   * Typedefs
   */

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  // NOTE: The typedef bandwidth-scientific-notation below has been
  // added in this module revision
  // RFC Editor: remove the note above and this note
  typedef bandwidth-scientific-notation {
    type string {
      pattern
        '0(\.0?)?([eE](\+)?0?)?|'
      + '[1-9](\.[0-9]{0,6})?[eE](\+)?(9[0-6]|[1-8][0-9]|0?[0-9])?';
    }
    units "bps";
    description
      "Bandwidth values, expressed using the scientific notation
      in bits per second.
      The encoding format is the external decimal-significant
      character sequences specified in IEEE 754 and ISO/IEC C99
      for 32-bit decimal floating-point numbers:
      (-1)**(S) * 10**(Exponent) * (Significant),
      where Significant uses 7 digits.
      An implementation for this representation may use decimal32
      or binary32. The range of the Exponent is from -95 to +96
      for decimal32, and from -38 to +38 for binary32.
      As a bandwidth value, the format is restricted to be
      normalized, non-negative, and non-fraction:
      n.dddddde{+}dd, N.DDDDDDE{+}DD, 0e0 or 0E0,
      where 'd' and 'D' are decimal digits; 'n' and 'N' are
      non-zeror decimal digits; 'e' and 'E' indicate a power of ten.
      Some examples are 0e0, 1e10, and 9.953e9.";
    reference
      "IEEE Std 754-2008: IEEE Standard for Floating-Point
      Arithmetic.
      ISO/IEC C99: Information technology - Programming
      Languages - C.";
  }

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  // NOTE: The identity tunnel-admin-auto below has been
  // added in this module revision
  // RFC Editor: remove the note above and this note
  identity tunnel-admin-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-any {
    base lsp-restoration-type;
    description
      "Any LSP affected by a failure is restored.";
  }

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  identity action-exercise {
    base protection-external-commands;
    description
      "An action that starts testing whether or not APS communication
       is operating correctly.  It is of lower priority than any
       other state or command.";
    reference
      "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, WTR state,
       or exercise command.";
    reference
      "RFC 4427: Recovery (Protection and Restoration) Terminology
       for Generalized Multi-Protocol Label Switching (GMPLS)";
  }

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    identity path-computation-error-no-dependent-server {
      base path-computation-error-reason;
      description
        "Path computation has failed because one or more dependent
        path computation servers are unavailable.
        The dependent path computation server could be
        a Backward-Recursive Path Computation (BRPC) downstream
        PCE or a child PCE.";
      reference
        "RFC5441, RFC8685";
    }

    identity path-computation-error-pce-unavailable {
      base path-computation-error-reason;
      description
        "Path computation has failed because PCE is not available.";
      reference
        "RFC5440";
    }

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

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

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

    identity path-computation-error-child-pce-unresponsive {
      base path-computation-error-reason;
      description
        "Path computation has failed because child PCE is not
        responsive.";
      reference
        "RFC8685";
    }

    identity path-computation-error-destination-domain-unknown {
      base path-computation-error-reason;
      description
        "Path computation has failed because the destination domain
        was unknown.";
      reference
        "RFC8685";
    }

    identity path-computation-error-p2mp {
      base path-computation-error-reason;
      description
        "Path computation has failed because of P2MP reachability
        problem.";
      reference
        "RFC8306";
    }

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

    identity path-computation-error-no-gco-solution {
      base path-computation-error-reason;
      description
        "Path computation has failed because of no GCO solution
        found.";
      reference
        "RFC5557";
    }

    identity path-computation-error-path-not-found {
      base path-computation-error-reason;
      description
        "Path computation no path found error reason.";
      reference
        "RFC5440";
    }

    identity path-computation-error-pks-expansion {
      base path-computation-error-reason;
      description
        "Path computation has failed because of Path-Key Subobject
        (PKS)  expansion failure.";
      reference
        "RFC5520";
    }

    identity path-computation-error-brpc-chain-unavailable {
      base path-computation-error-reason;
      description
        "Path computation has failed because PCE BRPC chain
        unavailable.";
      reference
        "RFC5441";
    }

    identity path-computation-error-source-unknown {
      base path-computation-error-reason;
      description
        "Path computation has failed because source node is 
        unknown.";
      reference
        "RFC5440";
    }

    identity path-computation-error-destination-unknown {
      base path-computation-error-reason;
      description
        "Path computation has failed because destination node is
        unknown.";
      reference
        "RFC5440";
    }

    identity path-computation-error-no-server {
      base path-computation-error-reason;
      description
        "Path computation has failed because path computation
        server is unavailable.";
      reference
        "RFC5440";
    }

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  /**
   * TE bandwidth groupings
   **/

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

  /**
   * TE label groupings
   **/

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

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

  /**
   * TE performance metrics groupings
   **/

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

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

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

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

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

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

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

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

  /**
   * TE tunnel generic groupings
   **/

  grouping explicit-route-hop {
    description
      "The explicit route entry grouping.";
    choice type {
      description
        "The explicit route entry type.";
      case numbered-node-hop {
        container numbered-node-hop {
          leaf node-id {
            type te-node-id;
            mandatory true;
            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 {
          leaf link-tp-id {
            type te-tp-id;
            mandatory true;
            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 {
            type te-node-id;
            mandatory true;
            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 {
          description
            "Numbered node route hop container.";
          leaf node-id {
            type te-node-id;
            mandatory true;
            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 {
          leaf link-tp-id {
            type te-tp-id;
            mandatory true;
            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 {
            type te-node-id;
            description
              "The identifier of a node in the TE topology.";
          }
          leaf-list flags {
            type path-attribute-flags;
            description
              "Path attributes flags.";
            reference
              "RFC 3209: RSVP-TE: Extensions to RSVP for LSP Tunnels
               RFC 4090: Fast Reroute Extensions to RSVP-TE for LSP
               Tunnels
               RFC 4561: Definition of a Record Route Object (RRO)
               Node-Id Sub-Object";
          }
          description
            "Unnumbered link Record Route hop.";
          reference
            "RFC 3477: Signalling Unnumbered Links in Resource
             ReSerVation Protocol - Traffic Engineering (RSVP-TE)";
        }
        description
          "Unnumbered link route hop.";
      }
      case label {
        container label-hop {
          description
            "Label route hop type.";
          uses te-label;
          leaf-list flags {
            type path-attribute-flags;
            description
              "Path attributes flags.";
            reference
              "RFC 3209: RSVP-TE: Extensions to RSVP for LSP Tunnels
               RFC 4090: Fast Reroute Extensions to RSVP-TE for LSP
               Tunnels
               RFC 4561: Definition of a Record Route Object (RRO)
               Node-Id Sub-Object";
          }
        }
        description
          "The label Record Route entry types.";
      }
    }
  }

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

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

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

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

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

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

  grouping tunnel-constraints {
    description
      "Tunnel constraints grouping that can be set on
       a constraint set or directly on the tunnel.";
    uses te-topology-identifier;
    uses common-constraints;
  }

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

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

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

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

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

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

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

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

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

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

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

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

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

<t>Editors' note: Copy the text from <xref target="RFC8776"/> before WG LC if the RFC8876-bis approach is confirmed.</t>

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

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

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

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

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

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

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

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

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

<t>Editors' note: Copy the text from <xref target="RFC8776"/> before WG LC if the RFC8876-bis approach is confirmed.</t>

<t>The security considerations defined in section 7 of <xref target="RFC8776"/> applies to the
revision of the ietf-te-types YANG module.</t>

<t>This document just adds new typedefs and groupings to the YANG modules defined in
<xref target="RFC8776"/> and therefore it does not introduce additional considerations.</t>

</section>


  </middle>

  <back>


    <references title='Normative References'>





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



<reference anchor='RFC2119' target='https://www.rfc-editor.org/info/rfc2119'>
<front>
<title>Key words for use in RFCs to Indicate Requirement Levels</title>
<author fullname='S. Bradner' initials='S.' surname='Bradner'><organization/></author>
<date month='March' year='1997'/>
<abstract><t>In many standards track documents several words are used to signify the requirements in the specification.  These words are often capitalized. This document defines these words as they should be interpreted in IETF documents.  This document specifies an Internet Best Current Practices for the Internet Community, and requests discussion and suggestions for improvements.</t></abstract>
</front>
<seriesInfo name='BCP' value='14'/>
<seriesInfo name='RFC' value='2119'/>
<seriesInfo name='DOI' value='10.17487/RFC2119'/>
</reference>



<reference anchor='RFC8174' target='https://www.rfc-editor.org/info/rfc8174'>
<front>
<title>Ambiguity of Uppercase vs Lowercase in RFC 2119 Key Words</title>
<author fullname='B. Leiba' initials='B.' surname='Leiba'><organization/></author>
<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='RFC7950' target='https://www.rfc-editor.org/info/rfc7950'>
<front>
<title>The YANG 1.1 Data Modeling Language</title>
<author fullname='M. Bjorklund' initials='M.' role='editor' surname='Bjorklund'><organization/></author>
<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='RFC6991' target='https://www.rfc-editor.org/info/rfc6991'>
<front>
<title>Common YANG Data Types</title>
<author fullname='J. Schoenwaelder' initials='J.' role='editor' surname='Schoenwaelder'><organization/></author>
<date month='July' year='2013'/>
<abstract><t>This document introduces a collection of common data types to be used with the YANG data modeling language.  This document obsoletes RFC 6021.</t></abstract>
</front>
<seriesInfo name='RFC' value='6991'/>
<seriesInfo name='DOI' value='10.17487/RFC6991'/>
</reference>



<reference anchor='RFC8294' target='https://www.rfc-editor.org/info/rfc8294'>
<front>
<title>Common YANG Data Types for the Routing Area</title>
<author fullname='X. Liu' initials='X.' surname='Liu'><organization/></author>
<author fullname='Y. Qu' initials='Y.' surname='Qu'><organization/></author>
<author fullname='A. Lindem' initials='A.' surname='Lindem'><organization/></author>
<author fullname='C. Hopps' initials='C.' surname='Hopps'><organization/></author>
<author fullname='L. Berger' initials='L.' surname='Berger'><organization/></author>
<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='RFC6780' target='https://www.rfc-editor.org/info/rfc6780'>
<front>
<title>RSVP ASSOCIATION Object Extensions</title>
<author fullname='L. Berger' initials='L.' surname='Berger'><organization/></author>
<author fullname='F. Le Faucheur' initials='F.' surname='Le Faucheur'><organization/></author>
<author fullname='A. Narayanan' initials='A.' surname='Narayanan'><organization/></author>
<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='RFC4872' target='https://www.rfc-editor.org/info/rfc4872'>
<front>
<title>RSVP-TE Extensions in Support of End-to-End Generalized Multi-Protocol Label Switching (GMPLS) Recovery</title>
<author fullname='J.P. Lang' initials='J.P.' role='editor' surname='Lang'><organization/></author>
<author fullname='Y. Rekhter' initials='Y.' role='editor' surname='Rekhter'><organization/></author>
<author fullname='D. Papadimitriou' initials='D.' role='editor' surname='Papadimitriou'><organization/></author>
<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='RFC4873' target='https://www.rfc-editor.org/info/rfc4873'>
<front>
<title>GMPLS Segment Recovery</title>
<author fullname='L. Berger' initials='L.' surname='Berger'><organization/></author>
<author fullname='I. Bryskin' initials='I.' surname='Bryskin'><organization/></author>
<author fullname='D. Papadimitriou' initials='D.' surname='Papadimitriou'><organization/></author>
<author fullname='A. Farrel' initials='A.' surname='Farrel'><organization/></author>
<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' target='https://www.rfc-editor.org/info/rfc8800'>
<front>
<title>Path Computation Element Communication Protocol (PCEP) Extension for Label Switched Path (LSP) Diversity Constraint Signaling</title>
<author fullname='S. Litkowski' initials='S.' surname='Litkowski'><organization/></author>
<author fullname='S. Sivabalan' initials='S.' surname='Sivabalan'><organization/></author>
<author fullname='C. Barth' initials='C.' surname='Barth'><organization/></author>
<author fullname='M. Negi' initials='M.' surname='Negi'><organization/></author>
<date month='July' year='2020'/>
<abstract><t>This document introduces a simple mechanism to associate a group of Label Switched Paths (LSPs) via an extension to the Path Computation Element Communication Protocol (PCEP) with the purpose of computing diverse (disjointed) paths for those LSPs.  The proposed extension allows a Path Computation Client (PCC) to advertise to a Path Computation Element (PCE) that a particular LSP belongs to a particular Disjoint Association Group; thus, the PCE knows that the LSPs in the same group need to be disjoint from each other.</t></abstract>
</front>
<seriesInfo name='RFC' value='8800'/>
<seriesInfo name='DOI' value='10.17487/RFC8800'/>
</reference>



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



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



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



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



<reference anchor='RFC8306' target='https://www.rfc-editor.org/info/rfc8306'>
<front>
<title>Extensions to the Path Computation Element Communication Protocol (PCEP) for Point-to-Multipoint Traffic Engineering Label Switched Paths</title>
<author fullname='Q. Zhao' initials='Q.' surname='Zhao'><organization/></author>
<author fullname='D. Dhody' initials='D.' role='editor' surname='Dhody'><organization/></author>
<author fullname='R. Palleti' initials='R.' surname='Palleti'><organization/></author>
<author fullname='D. King' initials='D.' surname='King'><organization/></author>
<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='RFC8685' target='https://www.rfc-editor.org/info/rfc8685'>
<front>
<title>Path Computation Element Communication Protocol (PCEP) Extensions for the Hierarchical Path Computation Element (H-PCE) Architecture</title>
<author fullname='F. Zhang' initials='F.' surname='Zhang'><organization/></author>
<author fullname='Q. Zhao' initials='Q.' surname='Zhao'><organization/></author>
<author fullname='O. Gonzalez de Dios' initials='O.' surname='Gonzalez de Dios'><organization/></author>
<author fullname='R. Casellas' initials='R.' surname='Casellas'><organization/></author>
<author fullname='D. King' initials='D.' surname='King'><organization/></author>
<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='RFC5512' target='https://www.rfc-editor.org/info/rfc5512'>
<front>
<title>The BGP Encapsulation Subsequent Address Family Identifier (SAFI) and the BGP Tunnel Encapsulation Attribute</title>
<author fullname='P. Mohapatra' initials='P.' surname='Mohapatra'><organization/></author>
<author fullname='E. Rosen' initials='E.' surname='Rosen'><organization/></author>
<date month='April' year='2009'/>
<abstract><t>In certain situations, transporting a packet from one Border Gateway Protocol (BGP) speaker to another (the BGP next hop) requires that the packet be encapsulated by the first BGP speaker and decapsulated by the second.  To support these situations, there needs to be some agreement between the two BGP speakers with regard to the &quot;encapsulation information&quot;, i.e., the format of the encapsulation header as well as the contents of various fields of the header.</t><t>The encapsulation information need not be signaled for all encapsulation types.  In cases where signaling is required (such as Layer Two Tunneling Protocol - Version 3 (L2TPv3) or Generic Routing Encapsulation (GRE) with key), this document specifies a method by which BGP speakers can signal encapsulation information to each other.  The signaling is done by sending BGP updates using the Encapsulation Subsequent Address Family Identifier (SAFI) and the IPv4 or IPv6 Address Family Identifier (AFI).  In cases where no encapsulation information needs to be signaled (such as GRE without key), this document specifies a BGP extended community that can be attached to BGP UPDATE messages that carry payload prefixes in order to indicate the encapsulation protocol type to be used.  [STANDARDS-TRACK]</t></abstract>
</front>
<seriesInfo name='RFC' value='5512'/>
<seriesInfo name='DOI' value='10.17487/RFC5512'/>
</reference>




    </references>

    <references title='Informative References'>




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

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

	 </t>
      </abstract>
   </front>
   <seriesInfo name='Internet-Draft' value='draft-ietf-teas-yang-te-31'/>
   <format target='https://www.ietf.org/archive/id/draft-ietf-teas-yang-te-31.txt' type='TXT'/>
</reference>


<reference anchor='I-D.ietf-teas-yang-path-computation'>
   <front>
      <title>A YANG Data Model for requesting path computation</title>
      <author fullname='Italo Busi' initials='I.' surname='Busi'>
         <organization>Huawei Technologies</organization>
      </author>
      <author fullname='Sergio Belotti' initials='S.' surname='Belotti'>
         <organization>Nokia</organization>
      </author>
      <author fullname='Oscar Gonzalez de Dios' initials='O. G.' surname='de Dios'>
         <organization>Telefonica</organization>
      </author>
      <author fullname='Anurag Sharma' initials='A.' surname='Sharma'>
         <organization>Google</organization>
      </author>
      <author fullname='Daniele Ceccarelli' initials='D.' surname='Ceccarelli'>
         <organization>Ericsson</organization>
      </author>
      <date day='22' month='March' year='2022'/>
      <abstract>
	 <t>   There are scenarios, typically in a hierarchical Software-Defined
   Networking (SDN) context, where the topology information provided by
   a Traffic Engineering (TE) network provider may be insufficient for
   its client to perform multi-domain path computation.  In these cases
   the client would need to request the TE network provider to compute
   some intra-domain paths.

   This document defines a YANG data model which contains Remote
   Procedure Calls (RPCs) to request path computation.  This model
   complements the solution, defined in RFC YYYY, to configure a TE
   tunnel path in &quot;compute-only&quot; mode.

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

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

	 </t>
      </abstract>
   </front>
   <seriesInfo name='Internet-Draft' value='draft-ietf-teas-yang-path-computation-18'/>
   <format target='https://www.ietf.org/archive/id/draft-ietf-teas-yang-path-computation-18.txt' type='TXT'/>
</reference>


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

	 </t>
      </abstract>
   </front>
   <seriesInfo name='Internet-Draft' value='draft-ietf-teas-yang-l3-te-topo-13'/>
   <format target='https://www.ietf.org/archive/id/draft-ietf-teas-yang-l3-te-topo-13.txt' type='TXT'/>
</reference>



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



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




    </references>


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

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

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

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

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

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

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

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

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

<figure><artwork><![CDATA[
30c30
<                <mailto:tsaad@juniper.net>
---
>                <mailto:tsaad.net@gmail.com>
55c55
<      Copyright (c) 2020 IETF Trust and the persons identified as
---
>      Copyright (c) 2022 IETF Trust and the persons identified as
60c60
<      the license terms contained in, the Simplified BSD License set
---
>      the license terms contained in, the Revised BSD License set
65,66c65,99
<      This version of this YANG module is part of RFC 8776; see the
<      RFC itself for full legal notices.";
---
>      This version of this YANG module is part of RFC XXXX
>      (https://www.rfc-editor.org/info/rfcXXXX); see the RFC itself
>      for full legal notices.";
> 
>   revision 2022-10-21 {
>     description
>       "Added:
>       - typedef bandwidth-scientific-notation;
>       - base identity lsp-provisioning-error-reason;
>       - identity association-type-diversity;
>       - identity tunnel-admin-auto;
>       - base identity path-computation-error-reason and
>         its derived identities;
>       - base identity tunnel-actions-type and its derived 
>         identities;
>       - base identity protocol-origin-type and
>         its derived identities;
>       - base identity svec-objective-function-type and its derived
>         identities;
>       - base identity svec-metric-type and its derived identities;
>       - grouping encoding-and-switching-type.
>       
>       Updated:
>       - description of the base identity objective-function-type.
>       
>       Obsoleted:
>       - identity of-minimize-agg-bandwidth-consumption
>       - identity of-minimize-load-most-loaded-link
>       - identity of-minimize-cost-path-set";
>     reference
>       "RFC XXXX: Updated Common YANG Data Types for Traffic
>       Engineering";
>   }
>   // RFC Editor: replace XXXX with actual RFC number, update date
>   // information and remove this note
545a579,612
>   // NOTE: The typedef bandwidth-scientific-notation below has been
>   // added in this module revision
>   // RFC Editor: remove the note above and this note
>   typedef bandwidth-scientific-notation {
>     type string {
>       pattern
>         '0(\.0?)?([eE](\+)?0?)?|'
>       + '[1-9](\.[0-9]{0,6})?[eE](\+)?(9[0-6]|[1-8][0-9]|0?[0-9])?';
>     }
>     units "bps";
>     description
>       "Bandwidth values, expressed using the scientific notation
>       in bits per second.
>       The encoding format is the external decimal-significant
>       character sequences specified in IEEE 754 and ISO/IEC C99
>       for 32-bit decimal floating-point numbers:
>       (-1)**(S) * 10**(Exponent) * (Significant),
>       where Significant uses 7 digits.
>       An implementation for this representation may use decimal32
>       or binary32. The range of the Exponent is from -95 to +96
>       for decimal32, and from -38 to +38 for binary32.
>       As a bandwidth value, the format is restricted to be
>       normalized, non-negative, and non-fraction:
>       n.dddddde{+}dd, N.DDDDDDE{+}DD, 0e0 or 0E0,
>       where 'd' and 'D' are decimal digits; 'n' and 'N' are
>       non-zeror decimal digits; 'e' and 'E' indicate a power of ten.
>       Some examples are 0e0, 1e10, and 9.953e9.";
>     reference
>       "IEEE Std 754-2008: IEEE Standard for Floating-Point
>       Arithmetic.
>       ISO/IEC C99: Information technology - Programming
>       Languages - C.";
>   }
> 
606a674,681
>   // NOTE: The base identity lsp-provisioning-error-reason has been
>   // added in this module revision
>   // RFC Editor: remove the note above and this note
>   identity lsp-provisioning-error-reason {
>     description
>       "Base identity for LSP provisioning errors.";
>   }
> 
982a1058,1073
>   // NOTE: The identity association-type-diversity below has been
>   // added in this module revision
>   // RFC Editor: remove the note above and this note
>   identity association-type-diversity {
>     base association-type;
>     description
>       "Association Type diversity used to associate LSPs whose 
>       paths are to be diverse from each other.";
>     reference
>       "RFC8800";
>   }
> 
>   // NOTE: The description of the base identity 
>   // objective-function-type has been updated 
>   // in this module revision
>   // RFC Editor: remove the note above and this note
985c1076
<       "Base objective function type.";
---
>       "Base identity for path objective function type.";
1015a1107,1109
>   // NOTE: The identity of-minimize-agg-bandwidth-consumption
>   // below has been obsoleted in this module revision
>   // RFC Editor: remove the note above and this note
1017a1112
>     status obsolete;
1020c1115
<        consumption.";
---
>       consumption.";
1023c1118
<        Computation Element Communication Protocol (PCEP)";
---
>       Computation Element Communication Protocol (PCEP)";
1025a1121,1123
>   // NOTE: The identity of-minimize-load-most-loaded-link
>   // below has been obsoleted in this module revision
>   // RFC Editor: remove the note above and this note
1027a1126
>     status obsolete;
1030c1129
<        is carrying the highest load.";
---
>       is carrying the highest load.";
1033c1132
<        Computation Element Communication Protocol (PCEP)";
---
>       Computation Element Communication Protocol (PCEP)";
1035a1135,1137
>   // NOTE: The identity of-minimize-cost-path-set
>   // below has been obsoleted in this module revision
>   // RFC Editor: remove the note above and this note
1037a1140
>     status obsolete;
1216a1320,1331
>   // NOTE: The identity tunnel-admin-auto below has been
>   // added in this module revision
>   // RFC Editor: remove the note above and this note
>   identity tunnel-admin-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.";
>   }
> 
2110a2226,2569
>   // NOTE: The base identity path-computation-error-reason and 
>   // its derived identities below have been
>   // added in this module revision
>   // RFC Editor: remove the note above and this note
>   identity path-computation-error-reason {
>     description
>       "Base identity for path computation error reasons.";
>   }
> 
>     identity path-computation-error-no-topology {
>       base path-computation-error-reason;
>       description
>         "Path computation has failed because there is no topology
>         with the provided topology-identifier.";
>     }
> 
>     identity path-computation-error-no-dependent-server {
>       base path-computation-error-reason;
>       description
>         "Path computation has failed because one or more dependent
>         path computation servers are unavailable.
>         The dependent path computation server could be
>         a Backward-Recursive Path Computation (BRPC) downstream
>         PCE or a child PCE.";
>       reference
>         "RFC5441, RFC8685";
>     }
> 
>     identity path-computation-error-pce-unavailable {
>       base path-computation-error-reason;
>       description
>         "Path computation has failed because PCE is not available.";
>       reference
>         "RFC5440";
>     }
> 
>     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.";
>       reference
>         "RFC8685";
>     }
> 
>     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.";
>       reference
>         "RFC8685";
>     }
> 
>     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.";
>       reference
>         "RFC8685";
>     }
> 
>     identity path-computation-error-child-pce-unresponsive {
>       base path-computation-error-reason;
>       description
>         "Path computation has failed because child PCE is not
>         responsive.";
>       reference
>         "RFC8685";
>     }
> 
>     identity path-computation-error-destination-domain-unknown {
>       base path-computation-error-reason;
>       description
>         "Path computation has failed because the destination domain
>         was unknown.";
>       reference
>         "RFC8685";
>     }
> 
>     identity path-computation-error-p2mp {
>       base path-computation-error-reason;
>       description
>         "Path computation has failed because of P2MP reachability
>         problem.";
>       reference
>         "RFC8306";
>     }
> 
>     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.";
>       reference
>         "RFC5557";
>     }
> 
>     identity path-computation-error-no-gco-solution {
>       base path-computation-error-reason;
>       description
>         "Path computation has failed because of no GCO solution
>         found.";
>       reference
>         "RFC5557";
>     }
> 
>     identity path-computation-error-path-not-found {
>       base path-computation-error-reason;
>       description
>         "Path computation no path found error reason.";
>       reference
>         "RFC5440";
>     }
> 
>     identity path-computation-error-pks-expansion {
>       base path-computation-error-reason;
>       description
>         "Path computation has failed because of Path-Key Subobject
>         (PKS)  expansion failure.";
>       reference
>         "RFC5520";
>     }
> 
>     identity path-computation-error-brpc-chain-unavailable {
>       base path-computation-error-reason;
>       description
>         "Path computation has failed because PCE BRPC chain
>         unavailable.";
>       reference
>         "RFC5441";
>     }
> 
>     identity path-computation-error-source-unknown {
>       base path-computation-error-reason;
>       description
>         "Path computation has failed because source node is 
>         unknown.";
>       reference
>         "RFC5440";
>     }
> 
>     identity path-computation-error-destination-unknown {
>       base path-computation-error-reason;
>       description
>         "Path computation has failed because destination node is
>         unknown.";
>       reference
>         "RFC5440";
>     }
> 
>     identity path-computation-error-no-server {
>       base path-computation-error-reason;
>       description
>         "Path computation has failed because path computation
>         server is unavailable.";
>       reference
>         "RFC5440";
>     }
> 
>   // NOTE: The base identity tunnel-actions-type and 
>   // its derived identities below have been
>   // added in this module revision
>   // RFC Editor: remove the note above and this note
>   identity tunnel-actions-type {
>     description
>       "TE tunnel actions type.";
>   }
> 
>   // NOTE: The base identity protocol-origin-type and 
>   // its derived identities below have been
>   // added in this module revision
>   // RFC Editor: remove the note above and this note
>   identity protocol-origin-type {
>     description
>       "Base identity for protocol origin type.";
>   }
> 
>     identity protocol-origin-api {
>       base protocol-origin-type;
>       description
>         "Protocol origin is via Application Programmable Interface
>         (API).";
>     }
> 
>     identity protocol-origin-pcep {
>       base protocol-origin-type;
>       description
>         "Protocol origin is Path Computation Engine Protocol 
>         (PCEP).";
>       reference "RFC5440";
>     }
> 
>     identity protocol-origin-bgp {
>       base protocol-origin-type;
>       description
>         "Protocol origin is Border Gateway Protocol (BGP).";
>       reference "RFC5512";
>     }
> 
>   // NOTE: The base identity svec-objective-function-type and 
>   // its derived identities below have been
>   // added in this module revision
>   // RFC Editor: remove the note above and this note
>   identity svec-objective-function-type {
>     description
>       "Base identity for SVEC objective function type.";
>     reference
>       "RFC5541: Encoding of Objective Functions in the Path
>        Computation Element Communication Protocol (PCEP).";
>   }
> 
>     identity svec-of-minimize-agg-bandwidth-consumption {
>       base svec-objective-function-type;
>       description
>         "Objective function for minimizing aggregate bandwidth 
>         consumption (MBC).";
>       reference
>         "RFC5541: Encoding of Objective Functions in the Path
>         Computation Element Communication Protocol (PCEP).";
>     }
> 
>     identity svec-of-minimize-load-most-loaded-link {
>       base svec-objective-function-type;
>       description
>         "Objective function for minimizing the load on the link that 
>         is carrying the highest load (MLL).";
>       reference
>         "RFC5541: Encoding of Objective Functions in the Path
>         Computation Element Communication Protocol (PCEP).";
>     }
> 
>     identity svec-of-minimize-cost-path-set {
>       base svec-objective-function-type;
>       description
>         "Objective function for minimizing the cost on a path set 
>         (MCC).";
>       reference
>         "RFC5541: Encoding of Objective Functions in the Path
>         Computation Element Communication Protocol (PCEP).";
>     }
> 
>     identity svec-of-minimize-common-transit-domain {
>       base svec-objective-function-type;
>       description
>         "Objective function for minimizing the number of common 
>         transit domains (MCTD).";
>       reference
>         "RFC8685: Path Computation Element Communication Protocol 
>         (PCEP) Extensions for the Hierarchical Path Computation 
>         Element (H-PCE) Architecture.";
>     }
> 
>     identity svec-of-minimize-shared-link {
>       base svec-objective-function-type;
>       description
>         "Objective function for minimizing the number of shared 
>         links (MSL).";
>       reference
>         "RFC8685: Path Computation Element Communication Protocol 
>         (PCEP) Extensions for the Hierarchical Path Computation 
>         Element (H-PCE) Architecture.";
>     }
> 
>     identity svec-of-minimize-shared-srlg {
>       base svec-objective-function-type;
>       description
>         "Objective function for minimizing the number of shared 
>         Shared Risk Link Groups (SRLG) (MSS).";
>       reference
>         "RFC8685: Path Computation Element Communication Protocol 
>         (PCEP) Extensions for the Hierarchical Path Computation 
>         Element (H-PCE) Architecture.";
>     }
> 
>     identity svec-of-minimize-shared-nodes {
>       base svec-objective-function-type;
>       description
>         "Objective function for minimizing the number of shared 
>         nodes (MSN).";
>       reference
>         "RFC8685: Path Computation Element Communication Protocol 
>         (PCEP) Extensions for the Hierarchical Path Computation 
>         Element (H-PCE) Architecture.";
>     }
> 
>   // NOTE: The base identity svec-metric-type and 
>   // its derived identities below have been
>   // added in this module revision
>   // RFC Editor: remove the note above and this note
>   identity svec-metric-type {
>     description
>       "Base identity for SVEC metric type.";
>     reference
>       "RFC5541: Encoding of Objective Functions in the Path
>        Computation Element Communication Protocol (PCEP).";
>   }
> 
>     identity svec-metric-cumul-te {
>       base svec-metric-type;
>       description
>         "Cumulative TE cost.";
>       reference
>         "RFC5541: Encoding of Objective Functions in the Path
>         Computation Element Communication Protocol (PCEP).";
>     }
> 
>     identity svec-metric-cumul-igp {
>       base svec-metric-type;
>       description
>         "Cumulative IGP cost.";
>       reference
>         "RFC5541: Encoding of Objective Functions in the Path
>         Computation Element Communication Protocol (PCEP).";
>     }
> 
>     identity svec-metric-cumul-hop {
>       base svec-metric-type;
>       description
>         "Cumulative Hop path metric.";
>       reference
>         "RFC5541: Encoding of Objective Functions in the Path
>         Computation Element Communication Protocol (PCEP).";
>     }
> 
>     identity svec-metric-aggregate-bandwidth-consumption {
>       base svec-metric-type;
>       description
>         "Aggregate bandwidth consumption.";
>       reference
>         "RFC5541: Encoding of Objective Functions in the Path
>         Computation Element Communication Protocol (PCEP).";
>     }
> 
>     identity svec-metric-load-of-the-most-loaded-link {
>       base svec-metric-type;
>       description
>         "Load of the most loaded link.";
>       reference
>         "RFC5541: Encoding of Objective Functions in the Path
>         Computation Element Communication Protocol (PCEP).";
>     }
> 
3379c3838,3865
< }
\ No newline at end of file
---
> 
>   // NOTE: The grouping encoding-and-switching-type below has been
>   // added in this module revision
>   // RFC Editor: remove the note above and this note
>   grouping encoding-and-switching-type {
>     description
>       "Common grouping to define the LSP encoding and
>       switching types";
>     leaf encoding {
>       type identityref {
>         base te-types:lsp-encoding-types;
>       }
>       description
>         "LSP encoding type.";
>       reference
>         "RFC3945";
>     }
>     leaf switching-type {
>       type identityref {
>         base te-types:switching-capabilities;
>       }
>       description
>         "LSP switching type.";
>       reference
>         "RFC3945";
>     }
>   }
> }
]]></artwork></figure>

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

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

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

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

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

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

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

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

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

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

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

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

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

<t>Therefore, in order to avoid useless editorial work, this version of the document has been structured to become an RFC8776-bis but not all the existing text in <xref target="RFC8776"/> has been copied: some editors' notes has been inserted instead. These editors' note will be removed and replaced by actual text copied from <xref target="RFC8776"/> before WG LC if the RFC8776-bis approach is confirmed.</t>

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

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

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

</section>


  </back>

<!-- ##markdown-source:
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

-->

</rfc>

