<?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.5.26 (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-01" 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="March" day="07"/>

    
    <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="options-considered"><name>Options considered</name>

<t>The concern is how to be able to update the ietf-te-types YANG module published in <xref target="RFC8776"/> without delaying too much the progress of the mature WG documents.</t>

<t>Three possible options have been identified to address this concern.</t>

<t>One option is to keep these definitions in the YANG modules where they have initially been defined: other YANG modules can still import them. The drawback of this approach is that it defeating the value of common YANG modules like ietf-te-types since common definitions will be spread around multiple specific YANG modules.</t>

<t>A second option is to define them in a new common YANG module (e.g., ietf-te-types-ext). The drawback of this approach is that it will increase the number of YANG modules providing thiny updates to the ietf-te-types YANG module.</t>

<t>A third option is to develop a revision of the ietf-te-types YANG module within an RFC8776-bis. The drawback of this approach is that the process for developing a big RFC8776-bis just for a thiny update is too high. Moreover, it is not clear what could be done with the ietf-te-packet-types YANG module which is also defined in <xref target="RFC8776"/> but it does not need to be revised.</t>

<t>This document explores an alternative option to just update <xref target="RFC8776"/> with a new revision of the module ietf-te-types.</t>

<t>In order to focus the review process of this document only to the changes proposed by this document:
- <xref target="overview"/> describes only the updates to the ietf-te-types YANG module proposed by this document;
- <xref target="yang-update"/> defines only the diff between the revision of the ietf-te-types YANG module proposed in this document and the revision of the ietf-te-types YANG module published in <xref target="RFC8776"/>.</t>

<t>In order to allow all the YANG toolchain to keep working by extracting the revision of the ietf-te-types YANG module proposed in this document, this revision is provided by <xref target="yang-code"/>. This text is intended not to be subject to the review of this document.</t>

</section>
<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-update"><name>TE Types YANG Update</name>

<t>This section provides the diff between the YANG module in section 3.1 of <xref target="RFC8776"/> and the YANG module revision in <xref target="yang-code"/>.</t>

<t>Note - This diff has been generated using the following UNIX commands to compare the YANG module revisions in section 3.1 of <xref target="RFC8776"/> and in <xref target="yang-code"/>:</t>

<figure><artwork><![CDATA[
diff ietf-te-types@2020-06-10.yang ietf-te-types.yang > model-diff.txt
sed 's/^/    /' model-diff.txt > model-diff-spaces.txt
sed 's/^    >   /    >   /' model-diff-spaces.txt > model-updates.txt
]]></artwork></figure>

<t>The output (model-updates.txt) is reported here:</t>

<figure><artwork><![CDATA[
55c55
<      Copyright (c) 2020 IETF Trust and the persons identified as
---
>      Copyright (c) 2022 IETF Trust and the persons identified as
65c65
<      This version of this YANG module is part of RFC 8776; see the
---
>      This version of this YANG module is part of RFC XXXX; see the
67a68,74
>   revision 2022-03-07 {
>     description
>       "Latest revision of TE types.";
>     reference
>       "RFC XXXX: Updated Common YANG Data Types for Traffic
>       Engineering";
>   }
545a553,583
>   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.";
>   }
> 
3376a3415,3438
>     }
>   }
> 
>   grouping encoding-and-switching-type {
>     description
>       "Common grouping to define the LSP encoding and
>       switching types";
>     leaf encoding {
>       type identityref {
>         base te-types:lsp-encoding-types;
>       }
>       description
>         "LSP encoding type.";
>       reference
>         "RFC3945";
>     }
>     leaf switching-type {
>       type identityref {
>         base te-types:switching-capabilities;
>       }
>       description
>         "LSP switching type.";
>       reference
>         "RFC3945";
]]></artwork></figure>

</section>
<section anchor="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 anchor="yang-code"><name>TE Types YANG Module</name>

<figure><artwork><![CDATA[
<CODE BEGINS> file "ietf-te-types@2022-03-07.yang"
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-07 {
    description
      "Latest revision of TE types.";
    reference
      "RFC XXXX: Updated Common YANG Data Types for Traffic
      Engineering";
  }
  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";
  }

  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;
        }
      }
    }
  }

  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";
    }
  }
}
<CODE ENDS>
]]></artwork></figure>

</section>
<section numbered="false" anchor="acknowledgements"><name>Acknowledgements</name>

<t>This document was prepared using kramdown.</t>

</section>


  </back>

<!-- ##markdown-source:
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
FCZppXMdqUdrGUx9/G5NKENSfneu9sTzH8NGhICnEJjfOexWNw06U6bixy84
Yxz/s044oxNYvJhq8W3dfXe+vPFLxFRpdj2dSxpZKEl6Q4/lRChqGk3RO90U
KRPl8ynSmstWrAeqW8CzyuzkPW36CbnJuNtk3fmedEdMDWfIN1NfCHOTtjpt
wt9xo1UTlgWvTJWmK91aNnOJnR9EN8FsjptyS5uDfBZ7NHMBqztog/dCabrY
QG5GWbhz3RqXnor8GEng4RTO2m+dWrc8MrEq9NMi6R7raWks98BoOdVU/Vjc
c+tuWc34s1xmM0FYIrsZf0xgj2SjWgZd1jZVDlCWl1qLz8UCyko04mRfhtiV
CUozLujkocIT9Roaf/i6YfNupSbCTfcpq+o64/VBJ96rOeCupUmp+4jnEFLy
mMIrdAgb5vWcckfC89aucyozUaMMuXMpZfN9pTLkkEnePwc8APR6UOImOgXA
O0FLn9tav/brttg+UZuvDK1PZOYfNlPqgTeubrfR1fil1krm5+NK+99t4PFu
LgO9ZbMtD+wO0nI2UnPfmzqQKdXkqCt9y0jK7JLmMr6GmyNdg6TNZ59rjFia
06YPefrG8lAItRkgzVuAFGbFPzX6v0H7N3h/jH/tLluZSPmcown7Bv3V0P6q
dktyNJfSOd32/GW11XK6SnFZ617fynz14bIFmc+xfpdmPhelz8p8eiLfmG9p
5rPI0bJFNm2Qc7bH1v1j3tbYtjG2botdtuSGLdHdm7rvVLfaCruV1i65CdZu
gfO2PTmCbweYqVdXW7TBPRuQj1d6M5lutk2wu509yFeaDvgq0Mv+kRVhn3/M
p7RSLQ4V36buHAl/urg0TedJnfnFOluqUzc4C/e8CdNyS5Y5E0xFKOSkW5wS
6kBXIbMlpY+3XdekprtlW1GGaXCnAlAiHvl5QmmH7pqAOt2nNIySr6G9Nio+
Ilggmtw6LwonYa6nq66mdgE4NLu1KNnndK2SpEScZua81SxQ9mMdTst5K8M0
7HERc5zf7pQXaOfQYg6rQgJdwMkUWwaQNcGbLl0kV2UYmdgVRJcY972aOHld
9b1jnbnoFyuZW1IQbaYLx/5YBHTL+oMK0aVoOXz36KEnh8PEHgXy4SPrEZac
KpySBLcolua5qiW3FUu1MkY1sm86DW/SEzC581BcpCJ4L9LMnZW13NYjv3XF
uRrLVArGAleeBT1ivq9s7URC830dGeeYFee1iHjwQg4iFVAUczrlWHZQYyCI
X4sggq/HwXWS8iENgsLlyaj7LJtqAGYaDt9X36f8MJHlDQZNaW5Ntk3zNsE/
czcL/ik79HONow7bR8vqthlQdSVCJMNaEflaEXWX5+rLFdmu6LlGMZiDydwa
0tuoVP65pWLlH+77XcG9nr86cNdF/arUslg1YlQOtSZjnxrIYm7CMMly2gkX
E+nqErrVO3XIdI/xODs01lhigVzbFR5cLGgenGPjmid9mb7dujeXodsJsEFW
ce+MtVsep2zxUpy8u60bBxMckYHO7FPEisF7y+i9rH61Ef9UJq9swisn43JY
w8xKNm6ZpHKOwQiY2ycOcKpNtRx0M3Epj1CRmn3TyhGBmEzzWbvp2cR7Mx9X
cznGIwgtfMdjfGM6w3TuZBZlOgTSRFpJXPzU4S/ujVB+VlLGLQNon15pguV1
qdG+nYhWu8xh/bFOJ3WN4aF5mpoiM3N0NMGhAvMuQkIQp2kyxR7fYk4QwoBe
UjZMhKktteGu5KTz0epi8hFo6cDp0EREiMeoLvtVD1SbVTPTtrS16nki+Tup
4BoyL6hseaU7aNpmz4kFg0jTzEt3pmf1Etx3XipN5244yl1IPdmqGu2o7kqr
uqCmG4XZv7GFdYyJ3+0Kz3m0NtO9BpjpnlMZrvXABo0UejMZ683VgW8VzPzE
Do0uhOJw9jQNJwGsKI67Jm9WsNCLxLWw7o9E310md2HRBF8Fg6/jnUvrDWOY
183zbcN5ybVIU7r5lUu/HBRK0OnYzJpDc/KeTIGrZLl1uzeQsqLlCZfJ6Guv
a2jJvJNfNof6mx4y23bTE6SmnrXzc6cMxldRchFEUn4WnHpJOVfHaz5naB6v
vM3b9G1ZVufxRrFuYhvnBcvs6BxAtt6ZQ6UKdMXteOtMJuZqAhXHNHCaz2WW
OpGZEzD98ucwcxAseZfBcFhMiiiggEuDq1l3kNJtcBt69eSz3PJlvsS3yjz+
lLiqLou3ZW2bzSM3q4G3edh18iLlw3GbCqYGIZARI+ybhfs/X0kczfis/oLO
5WH3cPhH86qNe9UDK2dZtuRZdrAT5k2vPCfXwllogo3phC1n6y3O4hLZEfiz
fDLhglkS5Zer9r4r5nOydOfbckJWT/pBPPIzVZti66bmPd8k7SdyijQ9rHtQ
YK2yaw2cm2nZZp9+2jH5WsogTClRNvX1FOijZyvuxOuzeWwUXRVYX/Kx9XR7
xzKfVBJIHb0WwN68PwymwUUYObps7gxcii44hY8rH1f+/OLNwaF3+Prg7PuV
/4GflZWV3/Z0t9y/PKC99QEwzJ+8/eH7OLmJxOiSCnAzqo+nXgijBJQ4pufc
BBnsr2KKF6ABYyJe79NgMkpu4vWV/w/mRG24G7kBAA==

-->

</rfc>

