<?xml version="1.0" encoding="utf-8"?>
  <?xml-stylesheet type="text/xsl" href="rfc2629.xslt" ?>
  <!-- generated by https://github.com/cabo/kramdown-rfc2629 version 1.6.5 (Ruby 2.7.2) -->


<!DOCTYPE rfc  [
  <!ENTITY nbsp    "&#160;">
  <!ENTITY zwsp   "&#8203;">
  <!ENTITY nbhy   "&#8209;">
  <!ENTITY wj     "&#8288;">

]>

<?rfc comments="yes"?>

<rfc ipr="trust200902" docName="draft-busi-teas-te-types-update-02" category="std" consensus="true" 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="April" day="04"/>

    
    <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>Volta Networks</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='24' month='October' year='2021'/>
      <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-12'/>
   <format target='https://www.ietf.org/archive/id/draft-ietf-teas-yang-l3-te-topo-12.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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
f8eNVk9YFbwyVequdGvYzBV2juvfuIsWN+WWNgf5LPZo2QWs+UFrvBdK08UG
cgvKwm11a/L01OTHSAIPp3E2fuvcuuWRiVWinxHJ/LGekcZiD4yGU03djyV/
bt0tqxl/VstsJggrZDfjTxbYI9kol0EXtU2ZA7Tlpdfic7GAthIzcbIvQ+zK
BIUZp3TyUOKJag2NP3zdcPZuqSYin+5TVNVVxuuDTrxXccBdSZNC9xGRI6Ti
MY2XlyOsl1Rzyh0Jz6ld51RkoloZys+lkM33lcpQjkzq/jngAaDXgwI30SkA
3gla+NzW+pVfN8X2idp8ZWh1IjP/sJlSDbx2dbuNrscvtFbKfj6uNf/dBB7v
5sqgN2y2xYHzgzScjVTc96YPZAo1OfpK3yKSKrukvoyv5ubIvEHS5LO3GiOW
5rTpQ55+ZnlohJoMkPotQAmz5p8K/V+j/Wu8P8a/cpctTaR4zlGHfY3+qml/
Vbkl5TSX1jnd9vxVtdVqukpzWeNe38h81eGyJZkvZ/2uzHx5lD4r85mJfGO+
lZnPIkfDFlm3QbZsj437R9vW2LQxNm6LXbbkmi0xvzd136lutRV2K61dcROs
3ALbtj01gmMHmKlXV1O0IX82oB4v9WbKutnWwe529qBeqTvgK0Ev+kdWhL39
mE9rpUocSr5N1TkS/nRxaerOkzrzi3W2VKVucBb58yZMyy1Y5kwwHaFQk25w
SqgDXYnMlpQ+eZR3TSq6WzYVZWQN7nQASgYTJwkp7TC/JqBO9ygNo+BrGK+N
io8IFogmt87zvZmXmOnqq6nzAHI0u7Uo2ed0jZKkRZxmlnurXqDsxzqclvNW
hmnY0zTgOL/dKc81zqHFHFaFBLqAszm2DCBrgjddukiuzDAqscv1LzHuezXL
5XVV947NzcW8WMrcUoJoM503dabSpVvWH5SIrkQrx3ebD4UaDhN7NMiHm9Yj
LDllOAUJblAs9XPVS24rlnJljG5kX3caXqcnYHLnnryIpPteRnF+VtZyW4/8
1hXncixTKxgLXHEW9Ej2fWlrJxJm31eRscWsOK9ERMALCYiUS1HM+Zxj2W6F
gSB/TV0fvp6612HEhzQICpcnpu6zbKoBmLk3fl9+n/LDZJzUGDSFudXZNvXb
BP+0bhb8U3ToW42jDttHw+o2GVBVJUIkw0YROUYRdZfn8ssl2S7puVoxaMGk
tYb0NiqVf26pWPmH+36XcK/mrw7cdVG9KpUsVo4YFUOt4dShBrKYmzAO44R2
wuVEuryE+eqdKmS6x3hyOzTWWGKBXNMVHlwsmD3YYuNmTzoqfbtxby5CtxNg
3bjk3mXWbnGcosVLcfLutm7gznBEBrqwTxFLBu8to/eq+tVG/FOZvKoJr5pM
nsNqZlawcYskVXN0J8DcDnFArtrUyEE3E5fyCDWp2TctHRHI2TxZNJuedby3
cHA1V2M8gtDAdzzGN6bLmC4/mWWZDoHUkVYRFz/N8Rf3Rig+qyiTLwNonl5h
gsV1qdC+nYhWucxe9bFOJ3WN4aE2TU2RmRYdTXCowLyLkBDEeRTOsce3bAlC
ZKBXlI0swtSU2nBXctL5aHU5+XCNdOB0aCLSw2PUPPuVD1TrVTPTtrC1mnki
+Tup4AoyL6lseaU7aNp6z4kFg0hTz0t3pmfNEtx3XipM5244Kr+QZrJlNdpR
3RVWdUlNN/Hif2EL6wATv5sVXu7Rykz3CmBZ95zScI0HNmik0Jvh1GyuOfhW
wcxP7NCYQigOZ88jb+bCiuK4G+pmBQs9X15L6/5I9N1VchcWTfBVMPg63rk0
qBkjez17vmk4EV7LKKKbX7n0K4dCATodm1lzqE/eUylwpSy3bvcGUla0OuHK
Mvqa6xoaMu/Ul/Wh/rqHsm277glSU8+b+blTBuNrP7xwfSU/S069oJzL49Wf
M9SPV9zmbfo2LGvu8VqxrmOb3AuW2dE5gGy900KlEnTN7XjrTCxbNYGOY2Zw
6s9lVjqRaQmYfvlzmBYEC96lOx6ns9R3KeBS42pWHaR0G9yGXj75LLZ8aZf4
RpnHnwJXVWXxNqxtvXmUz2rgbR52nSSN+HDcpkJWg+CqiBH2zcL9n68k9hd8
Vn9B5/Kwe+T4x/CqjXvZAytmWTbkWXawE9qmV5xT3sJZaoK16YQNZ+sNzuIK
2RH4s3oy4ZJZEsWXy/Z+XsxbsnRrbbnNTfHmLdYu4AyyW49UKaXjBhMn1oUq
rKgupB/eiCsX6+8pRx1A8LWJRBKY5SycpD5GMq69mJcCHsFyiYOJl4TRLl5P
H6r2HEGYYIEq/skVydwRQ+YvYWpAp80eyQoKQkV+GhdrMjRYqyTcAOdGX7ZJ
ap7OmaMNJRpZmVM8d8wU6KPna/lFqc40slHMq+fqcpTtZ48eW6adTlCpotcS
2Gfvj925e+H5OT3bOoM8RZecwse1j2v/Bz9rv+2KP8Em78zHDnaNEIC0L7/H
beQckRT/2HvzWvHdgzW28cfYEA5sXjwG+v4B9hp9IKxv0IT6/oEnk6mjp/rX
reHWljPcdrYeD3CUByAhfxKHe2/2qMwYiMWWXLy2Rs0fJiHsWpiPlM4ndHSP
jJWDaOMFM77EFigRy/9vv/0XzPfpzs6Tjx8HCBC+gN1EsggY0JNQcosYVd0G
vLpglFw+KhogjmdynFLBVBlPrJ5RX45zXxplxPdV0ha0g+rLxsz2ZjCRTcu0
riWvne2gSKN/pXTr3ARmI2+IF2B8vpXZXMCmO1lYcGw01/KYcQMDRTXPIpWH
ld6TdEzXuVLrA9cvTB7QcxwHOH38fg2ZSzec/P4BmZG88nvj90F448vJJdWa
K3K6KejrKBY3Yepjg8r3ktF2g/di7TQEMIn4yfOTMNgQR2EqXsjoUkYb4ti9
kvGV+G+Jj2IP3MCjOfy3nE7Fj64bryljwotI29Nt8l4wx9sRQ+0GjlO66HQN
NKa6NVGXWsMz09BH1YwHv1F4TXcYesAthjuxz4bNkPrCw3l6AdvYFUfRYYMD
GnOHjfwK3sC380jO8V5D2G9QpN9H7mwS3gSDtf8PdIQyjcuoAQA=

-->

</rfc>

