<?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.9 (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-00" category="std" consensus="true" submissionType="IETF" updates="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="July" day="11"/>

    
    <workgroup>TEAS Working Group</workgroup>
    

    <abstract>


<t>This document defines few additional common data types and groupings
   in YANG data modeling language to be imported by modules that model Traffic
   Engineering (TE) configuration and state capabilities.</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 pubblication of <xref target="RFC8776"/>, the need to add a new typedef and a new grouping to ietf-te-types YANG module has arisen.</t>

<t>These definitions have been developed in <xref target="I-D.ietf-teas-yang-te"/> and <xref target="I-D.ietf-teas-yang-l3-te-topo"/> and are quite mature: <xref target="I-D.ietf-teas-yang-te"/> in particular is ready from WG Last Call.</t>

<t>However, these defintions have broader applicability than the I-D where they have originated, so it makes sense to move them within the ietf-te-types YANG module.</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,
added to the ietf-te-types YANG module do not need to be prefixed.</t>

<t>The revision of the ietf-te-types YANG module uses the prefixes defined in section 1.2 of <xref target="RFC8776"/>.</t>

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

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

<dl>
  <dt>bandwidth-scientific-notation</dt>
  <dd>
    <t>This types represents the bandwidth in
bit-per-second, using the scientific notation (e.g., 10e3).</t>
  </dd>
  <dt>encoding-and-switching-type</dt>
  <dd>
    <t>This is a common grouping to define the LSP encoding and switching types.</t>
  </dd>
</dl>

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

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

<t>NOTE: Only the typedef bandwidth-scientific-notation and 
the grouping encoding-and-switching-type have been added
in this module revision. Please focus your review on this part.</t>

<t>RFC Editor: remove the 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-03-25.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@juniper.net>

     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 Simplified 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; see the
     RFC itself for full legal notices.";

  revision 2022-03-25 {
    description
      "Added:
      - typedef bandwidth-scientific-notation;
      - grouping encoding-and-switching-type.";
    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
   */

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

  identity objective-function-type {
    description
      "Base 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)";
  }

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

  identity of-minimize-load-most-loaded-link {
    base objective-function-type;
    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)";
  }

  identity of-minimize-cost-path-set {
    base objective-function-type;
    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.";
  }

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

  /**
   * 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="iana-considerations"><name>IANA Considerations</name>

<t>This document updates the ietf-te-types YANG module registered by <xref target="RFC8776"/>.</t>

<t>Therefore this document does not require any IANA actions.</t>

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

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




    </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'>
	 <organization>Juniper Networks</organization>
      </author>
      <author fullname='Rakesh Gandhi'>
	 <organization>Cisco Systems Inc</organization>
      </author>
      <author fullname='Xufeng Liu'>
	 <organization>Volta Networks</organization>
      </author>
      <author fullname='Vishnu Pavan Beeram'>
	 <organization>Juniper Networks</organization>
      </author>
      <author fullname='Igor Bryskin'>
	 <organization>Individual</organization>
      </author>
      <author fullname='Oscar Gonzalez de Dios'>
	 <organization>Telefonica</organization>
      </author>
      <date day='7' month='February' 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 is divided into YANG modules that
   classify data into generic, device-specific, technology agnostic, and
   technology-specific elements.

   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-29'/>
   <format target='https://www.ietf.org/archive/id/draft-ietf-teas-yang-te-29.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'>
	 <organization>IBM Corporation</organization>
      </author>
      <author fullname='Igor Bryskin'>
	 <organization>Individual</organization>
      </author>
      <author fullname='Vishnu Pavan Beeram'>
	 <organization>Juniper Networks</organization>
      </author>
      <author fullname='Tarek Saad'>
	 <organization>Juniper Networks</organization>
      </author>
      <author fullname='Himanshu Shah'>
	 <organization>Ciena</organization>
      </author>
      <author fullname='Oscar Gonzalez 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>




    </references>


<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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
gz/ayIVHaI842DMlw8ARRbVOZBGhAkTBXyiU322A70qvq9Kz1MN3tXeras9P
PdW+rlbZma8b1Fzt6/jD/QYime2YR25TlHfzLAa3D52+03mayalY2z3tK2Pr
7gtwsyTsni5i/oaFLlWT24vMlcWVBW5Ggo8P8IVKZbY+wJaVmmonTlofazi7
1HhW51geqq1MGXRNnIyVX8139y7wrE/oDT4eaciEwKSsj7UZEAuyGBzYOBOC
pDZohlrsshY97P2WvXK1V4VBmqnXAbDqPAkPBE7XCysP5XxO78EQCXUHwxhs
IsM5JzGKD3Jejhvr893lQgnOTD93IGFpR7e2Gtws7501RzxkBzEJ/Yu0Fnlq
yGNSOzx6cAlM6WTRyiWh9wdl3dew3950x60YldRAffh8uCNeY7zxRPKqViFh
tp0CVrVM24A/ebqxI/YkN+Nja9l3GZq7csHuevKuX4HxFvnjYCxO83OPH2xc
tg6KcHGo5nPEIro6nR0l6gu7QAbHqi/0XYL+cyXI5dhGCfru/t8F9//7liq+
K4TaZeseOyib48tEDr4F/71Z55Vnuljr3b5T2Oiv4U+Ta/hd6u6k1C3l0Tf4
hjWZWrUuPbNjIjn0wtlbk7jNrWd+xBS+AONDVuKm69dbMEvevQRxwrSJUgwV
P+ZbK1Js0dtRPApKxEq4VEpZkBbA6gM5akhqJX5bQxpgC2JHJuZlcCyerw8E
HERj7D4MEnZ9SZd9m5iFWghrvohYFRO7LunGUZciuKJrfpgA1moTTsSKlbhH
SQ2mmZ9Y2TKUTP1gLYqztcHgET8io/EjrdoemXA3JQ7ZadA/iAeYI7RW82i/
/BwQp/TRouHEj6IGcAe4DSjVYd8Bh56qhOt1mtNNyViDcGlsR2pLWezWwlLK
uOgZBHq8wJf+FaebNqexp/5UtjVRbGZOlAKuVyMUjIoTAarrkrAWLX8tTGwY
/LxKQkMAmMMd6s9tCPZZBhgrfBsA2QIIx6ZBcceASmsrrqzBn7q9vEF6rHse
62WHSPAlpadpwC8rPy1YrCBBSxHzDyJDMOBNJaiOzRfI0M2kIM2kZUs3b1r0
HOyQqkJJ51oSENPc3pqeOyP9FXMBSh5H9jklkpeDahkAvRT2PxjCep+uDiGl
BD4ObpwamJypumX50Z/OQmmrEZcN/sthAolWF/Yc7hVE6Ik/i2Hj+3/u8P5/
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

-->

</rfc>

