<?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.8 -->

<!DOCTYPE rfc SYSTEM "rfc2629.dtd" [
]>

<?rfc toc="yes"?>
<?rfc sortrefs="yes"?>
<?rfc symrefs="yes"?>
<?rfc comments="yes"?>

<rfc ipr="trust200902" docName="draft-ietf-teas-yang-te-29" category="std">

  <front>
    <title abbrev="TE YANG Data Model">A YANG Data Model for Traffic Engineering Tunnels, Label Switched Paths and Interfaces</title>

    <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="X." surname="Liu" fullname="Xufeng Liu">
      <organization>Volta Networks</organization>
      <address>
        <email>xufeng.liu.ietf@gmail.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>
    <author initials="O." surname="Gonzalez de Dios" fullname="Oscar Gonzalez de Dios">
      <organization>Telefonica</organization>
      <address>
        <email>oscar.gonzalezdedios@telefonica.com</email>
      </address>
    </author>

    <date year="2022" month="February" day="07"/>

    
    <workgroup>TEAS Working Group</workgroup>
    <keyword>Internet-Draft</keyword>

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

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



    </abstract>


  </front>

  <middle>


<section anchor="introduction" title="Introduction">

<t>YANG <xref target="RFC6020"/> and <xref target="RFC7950"/> is a data modeling language that was
introduced to define the contents of a conceptual data store that allows
networked devices to be managed using NETCONF <xref target="RFC6241"/>. YANG has proved
relevant beyond its initial confines, as bindings to other interfaces (e.g.
RESTCONF <xref target="RFC8040"/>) and encoding other than XML (e.g. JSON) are being defined.
Furthermore, YANG data models can be used as the basis of implementation for
other interfaces, such as CLI and programmatic APIs.</t>

<t>This document describes YANG data model for Traffic Engineering (TE) tunnels,
Label Switched Paths (LSPs), and interfaces. The model covers data applicable
to generic or device-independent, device-specific, and Multiprotocol Label
Switching (MPLS) technology specific.</t>

<t>The document describes a high-level relationship between the modules defined in
this document, as well as other external protocol YANG modules.  The TE generic
YANG data model does not include any data specific to a signaling protocol.  It
is expected other data plane technology model(s) will augment the TE generic
YANG data model.</t>

<t>Also, it is expected other YANG module(s) that model TE signaling protocols,
such as RSVP-TE (<xref target="RFC3209"/>, <xref target="RFC3473"/>), or Segment-Routing TE (SR-TE) 
<xref target="I-D.ietf-spring-segment-routing-policy"/> will augment the generic TE YANG  module.</t>

</section>
<section anchor="requirements-language" title="Requirements Language">

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

<t>The following terms are defined in <xref target="RFC6241"/> and are used in this specification:</t>

<t><list style="symbols">
  <t>client</t>
  <t>configuration data</t>
  <t>state data</t>
</list></t>

<t>This document also makes use of the following terminology introduced in the
YANG Data Modeling Language <xref target="RFC7950"/>:</t>

<t><list style="symbols">
  <t>augment</t>
  <t>data model</t>
  <t>data node</t>
</list></t>

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

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

<texttable title="Prefixes and corresponding YANG modules" anchor="tab1">
      <ttcol align='left'>Prefix</ttcol>
      <ttcol align='left'>YANG module</ttcol>
      <ttcol align='left'>Reference</ttcol>
      <c>yang</c>
      <c>ietf-yang-types</c>
      <c><xref target="RFC6991"/></c>
      <c>inet</c>
      <c>ietf-inet-types</c>
      <c><xref target="RFC6991"/></c>
      <c>rt-types</c>
      <c>ietf-routing-types</c>
      <c><xref target="RFC8294"/></c>
      <c>te-types</c>
      <c>ietf-te-types</c>
      <c><xref target="RFC8776"/></c>
      <c>te-packet-types</c>
      <c>ietf-te-packet-types</c>
      <c><xref target="RFC8776"/></c>
      <c>te</c>
      <c>ietf-te</c>
      <c>this document</c>
      <c>te-dev</c>
      <c>ietf-te-device</c>
      <c>this document</c>
</texttable>

</section>
<section anchor="model-tree-diagrams" title="Model Tree Diagrams">

<t>The tree diagrams extracted from the module(s) defined in this document are given in
subsequent sections as per the syntax defined in <xref target="RFC8340"/>.</t>

</section>
</section>
<section anchor="design-considerations" title="Design Considerations">

<t>This document describes a generic TE YANG data model that is independent of
any dataplane technology.  One of the design objectives is to allow specific
data plane technology models to reuse the TE generic data model and possibly
augment it with technology specific data.</t>

<t>The elements of the generic TE YANG data model, including TE Tunnels, LSPs, and
interfaces have leaf(s) that identify the technology layer where they reside.
For example, the LSP encoding type can identify the technology associated with a
TE Tunnel or LSP.</t>

<t>Also, the generic TE YANG data model does not cover signaling protocol data.
The signaling protocol used to instantiate TE LSPs are outside the scope of this
document and expected to be covered by augmentations defined in other document(s).</t>

<t>The following other design considerations are taken into account with respect data
organization:</t>

<t><list style="symbols">
  <t>The generic TE YANG data model ‘ietf-te’ contains device independent data and
can be used to model data off a device (e.g. on a TE controller).  The
device-specific TE data is defined in module ‘ietf-te-device’ as
shown in <xref target="figctrl"/>,</t>
  <t>In general, minimal elements in the model are designated as “mandatory” to
allow freedom to vendors to adapt the data model to their specific product
implementation.</t>
  <t>Suitable defaults are specified for all configurable elements.</t>
  <t>The model declares a number of TE functions as features that can be
optionally supported.</t>
</list></t>

<section anchor="state-data-organization" title="State Data Organization">

<t>The Network Management Datastore Architecture (NMDA) <xref target="RFC8342"/> addresses
modeling state data for ephemeral objects.  This document adopts the NMDA model
for configuration and state data representation as per IETF guidelines for new
IETF YANG models.</t>

</section>
</section>
<section anchor="model-overview" title="Model Overview">

<t>The data models defined in this document cover the core TE features that are
commonly supported by different vendor implementations. The support of extended
or vendor specific TE feature(s) is expected to be in either augmentations, or
deviations to the model defined in this document.</t>

<section anchor="module-relationship" title="Module Relationship">

<t>The generic TE YANG data model that is defined in “ietf-te.yang” covers the
building blocks that are device independent and agnostic of any specific
technology or control plane instances. The TE device model defined in
“ietf-te-device.yang” augments the generic TE YANG data model and covers data
that is specific to a device –  for example, attributes of TE interfaces, or
TE timers that are local to a TE node.</t>

<t>The TE data model for specific instances of data plane technology exist in a
separate YANG module(s) that augment the generic TE YANG data model. For
example, the MPLS-TE module “ietf-te-mpls.yang” is defined in another document
and augments the TE generic model as shown in <xref target="figctrl"/>.</t>

<t>The TE data model for specific instances of signaling protocol are outside the
scope of this document and are defined in other documents. For example, the
RSVP-TE YANG model augmentation of the TE model is covered in
<xref target="I-D.ietf-teas-yang-rsvp"/>.</t>

<figure title="Relationship of TE module(s) with signaling protocol modules" anchor="figctrl"><artwork><![CDATA[
  TE generic     +---------+         o: augment
  module         | ietf-te |o-------------+        
                 +---------+               \
                        o                   \
                        |\                   \
                        | \                   \
                        |  +----------------+  \
                        |  | ietf-te-device | TE device module
                        |  +----------------+    \
                        |       o        o        \
                        |     /           \        \
                        |   /              \        \
                 +--------------+           +---------------+ 
  RSVP-TE module | ietf-rsvp-te |o .        | ietf-te-mpls^ |
                 +--------------+   \       +---------------+
                    |                \
                    |                 \
                    |                  \
                    |                   \
                    |                    \
                    o                 +-------------------+  
                 +-----------+        | ietf-rsvp-otn-te^ |  
  RSVP module    | ietf-rsvp |        +-------------------+  
                 +-----------+           RSVP-TE with OTN
                                         extensions

                        ^ shown for illustration
                          (not in this document)

]]></artwork></figure>

</section>
</section>
<section anchor="te-yang-model" title="TE YANG Model">

<t>The generic TE YANG module (‘ietf-te’) is meant to manage and operate a TE network.
This includes creating, modifying and retrieving TE Tunnels, LSPs, and interfaces
and their associated attributes (e.g. Administrative-Groups, SRLGs, etc.).</t>

<t>The detailed tree structure is provided in <xref target="fig-highlevel"/>.</t>

<section anchor="module-structure" title="Module Structure">

<t>The ‘ietf-te’ uses three main containers grouped under the main ‘te’ container
(see <xref target="fig-highlevel"/>). The ‘te’ container is the top level container in the
data model. The presence of the ‘te’ container enables TE function system wide.
Below provides further descriptions of containers that exist under the ‘te’ top
level container.</t>

<t>globals:</t>

<t><list style='empty'>
  <t>The ‘globals’ container maintains the set of global TE attributes that can be
applicable to TE Tunnel(s) and interface(s).</t>
</list></t>

<t>tunnels:</t>

<t><list style='empty'>
  <t>The ‘tunnels’ container includes the list of TE Tunnels that are instantiated. Refer to
<xref target="TE_TUNNELS"/> for further details on the properties of a TE Tunnel.</t>
</list></t>

<t>lsps:</t>

<t><list style='empty'>
  <t>The ‘lsps’ container includes the list of TE LSP(s) that are instantiated for
TE Tunnels. Refer to <xref target="TE_LSPS"/> for further details on the properties of a TE LSP.</t>
</list></t>

<t>tunnels-path-compute:</t>

<t><list style='empty'>
  <t>A Remote Procedure Call (RPC) to request path computation for a specific TE Tunnel.
The RPC allows requesting path computation using atomic and stateless operation.
A tunnel may also be configured in ‘compute-only’ mode to provide stateful path updates
- see <xref target="TE_TUNNELS"/> for further details.</t>
</list></t>

<t>tunnels-action:</t>

<t><list style='empty'>
  <t>An RPC to request a specific action (e.g. reoptimize, or tear-and-setup) to be taken
on a specific tunnel or all tunnels.</t>
</list></t>

<figure title="TE Tunnel model high-level YANG tree view" anchor="fig-highlevel"><artwork><![CDATA[
module: ietf-te
   +--rw te!
      +--rw globals
         .
         .

      +--rw tunnels
         .
         .

      +-- lsps

rpcs:
   +---x tunnels-path-compute
   +---x tunnels-action
]]></artwork></figure>

<section anchor="te-globals" title="TE Globals">

<t>The ‘globals’ container covers properties that control TE features behavior
system-wide, and its respective state (see <xref target="fig-globals"/>).
The TE globals configuration include:</t>

<figure title="TE globals YANG subtree high-level structure" anchor="fig-globals"><artwork><![CDATA[
     +--rw globals
     |  +--rw named-admin-groups
     |  |  +--rw named-admin-group* [name]
     ..
     |  +--rw named-srlgs
     |  |  +--rw named-srlg* [name] {te-types:named-srlg-groups}?
     ..
     |  +--rw named-path-constraints
     |  |  +--rw named-path-constraint* [name]
     ..
]]></artwork></figure>

<t>named-admin-groups:</t>

<t><list style='empty'>
  <t>A YANG container for the list of named (extended) administrative groups that may be applied
to TE links.</t>
</list></t>

<t>named-srlgs:</t>

<t><list style='empty'>
  <t>A YANG container for the list named Shared Risk Link Groups (SRLGs) that may be
applied to TE links.</t>
</list></t>

<t>named-path-constraints:</t>

<t><list style='empty'>
  <t>A YANG container for a list of named path constraints. Each named path constraint is
composed of a set of constraints that can be applied during path computation.
A named path constraint can be applied to multiple TE Tunnels. Path constraints may also
be specified directly under the TE Tunnel. The path constraint specified under
the TE Tunnel take precedence over the path constraints 
derived from the referenced named path constraint. A named path constraint entry can be
formed up of the following path constraints:</t>
</list></t>

<figure title="Named path constraints YANG subtree" anchor="fig-named-constraints"><artwork><![CDATA[


     |  +--rw named-path-constraints
     |     +--rw named-path-constraint* [name]
     |        +--rw name                             string
     |        +--rw te-bandwidth
     // ...
     |        +--rw link-protection?                 identityref
     |        +--rw setup-priority?                  uint8
     |        +--rw hold-priority?                   uint8
     |        +--rw signaling-type?                  identityref
     |        +--rw path-metric-bounds
     // ...
     |        +--rw path-affinities-values
     // ...
     |        +--rw path-affinity-names
     // ...
     |        +--rw path-srlgs-lists
     // ...
     |        +--rw path-srlgs-names
     // ...
     |        +--rw disjointness?
     |        |       te-path-disjointness
     // ...
     |        +--rw explicit-route-objects-always
     // ...
     |        |  +--rw route-object-exclude-always* [index]

     |        |  +--rw route-object-include-exclude* [index]
]]></artwork></figure>

<t><list style='empty'>
  <t><list style='empty'>

    <t><list style="symbols">
      <t>te-bandwidth: A YANG container that holds the technology agnostic TE bandwidth constraint.</t>
      <t>link-protection: A YANG leaf that holds the link protection type constraint required for the links to be included in the computed path.</t>
      <t>setup/hold priority: A YANG leaf that holds the LSP setup and hold admission priority as defined in <xref target="RFC3209"/>.</t>
      <t>signaling-type: A YANG leaf that holds the LSP setup type, such as RSVP-TE or SR.</t>
      <t>path-metric-bounds: A YANG container that holds the set of metric bounds applicable on the
computed TE tunnel path.</t>
      <t>path-affinities-values: A YANG container that holds the set of affinity values and
mask to be used during path computation.</t>
      <t>path-affinity-names: A YANG container that holds the set of named affinity constraints and
corresponding inclusion or exclusions instruction for each to be used during path computation.</t>
      <t>path-srlgs-lists: A YANG container that holds the set of SRLG values and
corresponding inclusion or exclusions instruction to be used during path computation.</t>
      <t>path-srlgs-names: A YANG container that holds the set of named SRLG constraints and
corresponding inclusion or exclusions instruction for each to be used during path computation.</t>
      <t>disjointness: The level of resource disjointness constraint that the secondary path
of a TE tunnel has to adhere to.</t>
      <t>explicit-route-objects-always: A YANG container that contains two route objects lists:      <list style="symbols">
          <t>‘route-object-exclude-always’: a list of route entries to always exclude from the path computation.</t>
          <t>‘route-object-include-exclude’: a list of route entries to include or exclude in the path computation.</t>
        </list></t>
    </list></t>
  </list></t>
</list></t>

<t><list style='empty'>
  <t><list style='empty'>
    <t>The ‘route-object-include-exclude’ is used to configure constraints on which route objects (e.g., nodes, links) are included or excluded in the path computation.</t>
  </list></t>
</list></t>

<t><list style='empty'>
  <t><list style='empty'>
    <t>The interpretation of an empty ‘route-object-include-exclude’ list depends on the TE Tunnel (end-to-end or Tunnel Segment) and on the specific path, according to the following rules:</t>
  </list></t>
</list></t>

<t><list style='empty'>
  <t><list style='empty'>
    <t><list style="numbers">
      <t>An empty ‘route-object-include-exclude’ list for the primary path of an end-to-end TE Tunnel indicates that there are no route objects to be included or excluded in the path computation.</t>
      <t>An empty ‘route-object-include-exclude’ list for the primary path of a TE Tunnel Segment indicates that no primary LSP is required for that TE Tunnel.</t>
      <t>An empty ‘route-object-include-exclude’ list for a reverse path means it always follows the forward path (i.e., the TE Tunnel is co-routed). When the ‘route-object-include-exclude’ list is not empty, the reverse path is routed independently of the forward path.</t>
      <t>An empty ‘route-object-include-exclude’ list for the secondary (forward) path indicates that the secondary path has the same endpoints as the primary path.</t>
    </list></t>
  </list></t>
</list></t>

</section>
<section anchor="TE_TUNNELS" title="TE Tunnels">

<t>The ‘tunnels’ container holds the list of TE Tunnels that are provisioned on
devices in the network (see <xref target="fig-te-tunnel"/>).</t>

<t>A TE Tunnel in the list is uniquely identified by a name.
When the model is used to manage a specific device, the ‘tunnels’ list contains
the TE Tunnels originating from the specific device. When the model is used to
manage a TE controller, the ‘tunnels’ list contains all TE Tunnels and TE
tunnel segments originating from device(s) that the TE controller manages.</t>

<t>The TE Tunnel model allows the configuration and management of the following TE
tunnel related objected:</t>

<t>TE Tunnel:</t>

<t><list style='empty'>
  <t>A YANG container of one or more LSPs established between the source and destination
TE Tunnel termination points. A TE Tunnel LSP is a connection-oriented service
provided by the network layer for the delivery of client data between a source and
the destination of the TE Tunnel termination points.</t>
</list></t>

<t>TE Tunnel Segment:</t>

<t><list style='empty'>
  <t>A part of a multi-domain TE Tunnel that is within a specific network domain.</t>
</list></t>

<figure title="TE Tunnel list YANG subtree structure" anchor="fig-te-tunnel"><artwork><![CDATA[
     +--rw tunnels
     |  +--rw tunnel* [name]
     |     +--rw name                                string
     |     +--rw alias?                              string
     |     +--rw identifier?                         uint32
     |     +--rw color?                              uint32
     |     +--rw description?                        string
     |     +--ro operational-state?              identityref
     |     +--rw encoding?                       identityref
     |     +--rw switching-type?                 identityref
     |     +--rw admin-state?                    identityref
     |     +--rw reoptimize-timer?               uint16
     |     +--rw source?                         te-types:te-node-id
     |     +--rw destination?                    te-types:te-node-id
     |     +--rw src-tunnel-tp-id?               binary
     |     +--rw dst-tunnel-tp-id?               binary
     |     +--rw controller
     |     |  +--rw protocol-origin?             identityref
     |     |  +--rw controller-entity-id?        string
     |     +--rw bidirectional?                  boolean
     |     +--rw association-objects
     |     |  +--rw association-object* [association-key]
     // ..
     |     |
     |     +--rw protection
     // ..
     |     +--rw restoration
     // ..
     |     +--rw te-topology-identifier
     // ..
     |     +--rw hierarchy
     // ..

]]></artwork></figure>

<t>The TE Tunnel has a number of attributes that are set directly under the
tunnel (see <xref target="fig-te-tunnel"/>). The main attributes of a TE Tunnel are described below:</t>

<t>operational-state:</t>

<t><list style='empty'>
  <t>A YANG leaf that holds the operational state of the tunnel.</t>
</list></t>

<t>name:</t>

<t><list style='empty'>
  <t>A YANG leaf that holds the name of a TE Tunnel.  The name of the
TE Tunnel uniquely identifies the tunnel within the TE tunnel list.  The name
of the TE Tunnel can be formatted as a Uniform Resource Indicator (URI) by
including the namespace to ensure uniqueness of the name amongst all the TE
Tunnels present on devices and controllers.</t>
</list></t>

<t>alias:</t>

<t><list style='empty'>
  <t>A YANG leaf that holds an alternate name to the TE tunnel. Unlike the TE tunnel
name, the alias can be modified at any time during the lifetime of the TE tunnel.</t>
</list></t>

<t>identifier:</t>

<t><list style='empty'>
  <t>A YANG leaf that holds an identifier of the tunnel. This identifier is unique amongst tunnels
originated from the same ingress device.</t>
</list></t>

<t>color:</t>

<t><list style='empty'>
  <t>A YANG leaf that holds the color associated with the TE tunnel. The color is used
to map or steer services that carry matching color on to the TE tunnel as described in
<xref target="RFC9012"/>.</t>
</list></t>

<t>encoding/switching:</t>

<t><list style='empty'>
  <t>The ‘encoding’ and ‘switching-type’ are YANG leafs that define the specific
technology in which the tunnel operates in as described in <xref target="RFC3945"/>.</t>
</list></t>

<t>reoptimize-timer:</t>

<t><list style='empty'>
  <t>A YANG leaf to set the inteval period for tunnel reoptimization.</t>
</list></t>

<t>source/destination:</t>

<t><list style='empty'>
  <t>YANG leafs that define the tunnel source and destination node endpoints.</t>
</list></t>

<t>src-tunnel-tp-id/dst-tunnel-tp-id:</t>

<t><list style='empty'>
  <t>YANG leafs that hold the identifiers of source and destination TE Tunnel
 Termination Points (TTPs) <xref target="RFC8795"/> residing on the source and
 destination nodes. The TTP identifiers are optional on nodes that have a
 single TTP per node. For example, TTP identifiers are optional for packet
 (IP/MPLS) routers.</t>
</list></t>

<t>controller:</t>

<t><list style='empty'>
  <t>A YANG container that holds tunnel data relevant to an optional external TE controller that
may initiate or control a tunnel. This target node may be augmented by external module(s), for example, to add data for PCEP initiated and/or
delegated tunnels.</t>
</list></t>

<t>bidirectional:</t>

<t><list style='empty'>
  <t>A YANG leaf that when present indicates the LSPs of a TE Tunnel are bidirectional and co-routed.</t>
</list></t>

<t>association-objects:</t>

<t><list style='empty'>
  <t>A YANG container that holds the set of associations of the TE Tunnel to other
TE Tunnels. Associations at the TE Tunnel level apply to all paths of the TE
Tunnel. The TE tunnel associations can be overridden by associations
configured directly under the TE Tunnel path.</t>
</list></t>

<t>protection:</t>

<t><list style='empty'>
  <t>A YANG container that holds the TE Tunnel protection properties.</t>
</list></t>

<t>restoration:</t>

<t><list style='empty'>
  <t>A YANG container that holds the TE Tunnel restoration properties.</t>
</list></t>

<t>te-topology-identifier:</t>

<t><list style='empty'>
  <t>A YANG container that holds the topology identifier associated with the topology where paths for the TE tunnel are computed.</t>
</list></t>

<figure title="TE Tunnel hierarchy YANG subtree" anchor="fig-hierarchy"><artwork><![CDATA[
    +--rw hierarchy
    |  +--rw dependency-tunnels
    |  |  +--rw dependency-tunnel* [name]
    |  |     +--rw name
    |  |     |       -> ../../../../../../tunnels/tunnel/name
    |  |     +--rw encoding?         identityref
    |  |     +--rw switching-type?   identityref
    |  +--rw hierarchical-link
    |     +--rw local-te-node-id?         te-types:te-node-id
    |     +--rw local-te-link-tp-id?      te-types:te-tp-id
    |     +--rw remote-te-node-id?        te-types:te-node-id
    |     +--rw te-topology-identifier
    |        +--rw provider-id?   te-global-id
    |        +--rw client-id?     te-global-id
    |        +--rw topology-id?   te-topology-id
]]></artwork></figure>

<t>hierarchy:</t>

<t><list style='empty'>
  <t>A YANG container that holds hierarchy related properties of the TE Tunnel (see <xref target="fig-hierarchy"/>. A TE LSP
  can be set up in MPLS or Generalized MPLS (GMPLS) networks to be used as
  a TE links to carry traffic in other (client) networks <xref target="RFC6107"/>.  In this
  case, the model introduces the TE Tunnel hierarchical link endpoint parameters
  to identify the specific link in the client layer that the underlying TE Tunnel is
  associated with. The hierarchy container includes the following:</t>
</list></t>

<t><list style='empty'>
  <t><list style='empty'>

    <t><list style="symbols">
      <t>dependency-tunnels: A set of hierarchical TE Tunnels provisioned or to be
provisioned in the immediate lower layer that this TE tunnel depends on for
multi-layer path computation. A dependency TE Tunnel is provisioned if and
only if it is used (selected by path computation) at least by one client
layer TE Tunnel. The TE link in the client layer network topology supported
by a dependent TE Tunnel is dynamically created only when the dependency TE
Tunnel is actually provisioned.</t>
      <t>hierarchical-link: A YANG container that holds the identity of the
hierarchical link (in the client layer) that is supported by this TE Tunnel.
The endpoints of the hierarchical link are defined by TE tunnel source and
destination node endpoints. The hierarchical link can be identified by its source
and destination link termination point identifiers.</t>
    </list></t>
  </list></t>
</list></t>

<section anchor="te-tunnel-paths" title="TE Tunnel Paths">

<t>The TE Tunnel can be configured with a set of paths that define the tunnel
forward and reverse paths as described in <xref target="fig-tunnel-paths"/>. Moreover, a primary
path can be specified a set of candidate secondary paths that can be visited to
support path protection. The following describe further the list of paths associated with a
TE Tunnel.</t>

<figure title="TE Tunnel paths YANG tree structure" anchor="fig-tunnel-paths"><artwork><![CDATA[
     |     +--rw primary-paths
     |     |  +--rw primary-path* [name]
     |     |     +--rw name                             string
     // ..
     |     |     +
     |     |     +--rw primary-reverse-path
     |     |     |  +--rw name?                                string
     // ..
     |     |     |  |
     |     |     |  +--rw candidate-secondary-reverse-paths
     |     |     |     +--rw candidate-secondary-reverse-path*
     |     |     |             [secondary-path]
     |     |     |        +--rw secondary-path    leafref
     |     |     +--rw candidate-secondary-paths
     |     |        +--rw candidate-secondary-path* [secondary-path]
     |     |           +--rw secondary-path    leafref
     |     |           +--ro active?           boolean

     |     +--rw secondary-paths
     |     |  +--rw secondary-path* [name]
     |     |     +--rw name                             string
     // ..
     |     |
     |     +--rw secondary-reverse-paths
     |     |  +--rw secondary-reverse-path* [name]
     |     |     +--rw name                             string

]]></artwork></figure>

<t>primary-paths:</t>

<t><list style='empty'>
  <t>A YANG container that holds the list of primary paths.
A primary path is identified by ‘name’. A primary path is selected from the list
to instantiate a primary forwarding LSP for the tunnel.  The list of primary
paths is visited by order of preference. A primary path has the following
attributes:</t>
</list></t>

<t><list style='empty'>

  <t><list style="symbols">
    <t>primary-reverse-path: A YANG container that holds properties of the
primary reverse path. The reverse path is applicable to
bidirectional TE Tunnels.</t>
  </list></t>
</list></t>

<t><list style='empty'>

  <t><list style="symbols">
    <t>candidate-secondary-paths: A YANG container that holds a list of candidate
secondary paths which may be used for the primary path to support path
protection. The candidate secondary path(s) reference path(s)  from the
tunnel secondary paths list.  The preference of the secondary paths is
specified within the list and dictates the order of visiting the secondary
path from the list. The attributes of a secondary path can be defined
separately from the primary path. The attributes of a secondary path will be
inherited from the associated ‘active’ primary when not explicitly defined
for the secondary path.</t>
  </list></t>
</list></t>

<t><list style='empty'>
<t></t></list></t>

<t>secondary-paths:</t>

<t><list style='empty'>
  <t>A YANG container that holds the set of secondary paths. A secondary path is
 identified by ‘name’. A secondary path can be referenced from the TE Tunnel’s
‘candidate-secondary-path’ list. A secondary path contains attributes similar to a primary path.</t>
</list></t>

<t>secondary-reverse-paths:</t>

<t><list style='empty'>
  <t>A YANG container that holds teh set of secondary reverse paths. A secondary reverse
path is identified by ‘name’. A secondary reverse path can be referenced from the
TE Tunnel’s ‘candidate-secondary-reverse-paths’ list. A secondary reverse path contains
attributes similar to a primary path.</t>
</list></t>

<t>The following set common path attributes are shared for primary forward and reverse primary and secondary paths:</t>

<t>compute-only:</t>

<t><list style='empty'>
  <t>A path of TE Tunnel is, by default, provisioned so that it can is instantiated
  in forwarding to carry traffic as soon as a valid path is computed. In some cases,
  a TE path may be provisioned for the only purpose of computing a path
  and reporting it without the need to instantiate the LSP or commit any
  resources. In such a case, the path is configured in ‘compute-only’ mode to
  distinguish it from the default behavior. A ‘compute-only’ path is configured
  as a usual with the associated per path constraint(s) and properties on a
  device or TE controller. The device or TE controller computes the feasible path(s) subject
  to configured constraints.  A client may query the
  ‘compute-only’ computed path properties ‘on-demand’, or alternatively, can subscribe
  to be notified of computed path(s) and whenever the path properties change.</t>
</list></t>

<t>use-path-computation:</t>

<t><list style='empty'>
  <t>A YANG leaf that indicates whether or not path computation is to
  be used for a specified path.</t>
</list></t>

<t>lockdown:</t>

<t><list style='empty'>
  <t>A YANG leaf that when set indicates the existing path should not be reoptimized
  after a failure on any of its traversed links.</t>
</list></t>

<t>te-topology-identifier:</t>

<t><list style='empty'>
  <t>A YANG container that holds the topology identifier
  associated with the tunnel.</t>
</list></t>

<t>optimizations:</t>

<t><list style='empty'>
  <t>a YANG container that holds the optimization objectives
  that path computation will use to select a path.</t>
</list></t>

<t>computed-paths-properties:
&gt; A YANG container that holds properties for the list of computed paths.</t>

<t>computed-path-error-infos:</t>

<t><list style='empty'>
  <t>A YANG container that holds a list of errors related to the path.</t>
</list></t>

<t>lsps:</t>

<t><list style='empty'>
  <t>a YANG container that holds a list of LSPs that are instantiated for this specific path.</t>
</list></t>

</section>
</section>
<section anchor="TE_LSPS" title="TE LSPs">

<t>The ‘lsps’ container includes the set of TE LSP(s) that are instantiated.
A TE LSP is identified by a 3-tuple (‘tunnel-name’, ‘node’, ‘lsp-id’).</t>

<t>When the model is used to manage a specific device, the ‘lsps’ list contains all TE
LSP(s) that traverse the device (including ingressing, transiting and egressing the device).</t>

<t>When the model is used to manage a TE controller, the ‘lsps’ list contains all
TE LSP(s) that traverse all network devices (including ingressing, transiting and
egressing the device) that the TE controller manages.</t>

</section>
</section>
<section anchor="tree-diagram" title="Tree Diagram">

<t><xref target="fig-te-tree"/> shows the tree diagram of the generic TE YANG model defined in
modules ‘ietf-te.yang’.</t>

<figure title="TE Tunnel generic model YANG tree diagram" anchor="fig-te-tree"><artwork><![CDATA[
module: ietf-te
  +--rw te!
     +--rw globals
     |  +--rw named-admin-groups
     |  |  +--rw named-admin-group* [name]
     |  |          {te-types:extended-admin-groups,te-types:named-extend
ed-admin-groups}?
     |  |     +--rw name            string
     |  |     +--rw bit-position?   uint32
     |  +--rw named-srlgs
     |  |  +--rw named-srlg* [name] {te-types:named-srlg-groups}?
     |  |     +--rw name     string
     |  |     +--rw value?   te-types:srlg
     |  |     +--rw cost?    uint32
     |  +--rw named-path-constraints
     |     +--rw named-path-constraint* [name]
     |             {te-types:named-path-constraints}?
     |        +--rw name                             string
     |        +--rw te-bandwidth
     |        |  +--rw (technology)?
     |        |     +--:(generic)
     |        |        +--rw generic?   te-bandwidth
     |        +--rw link-protection?                 identityref
     |        +--rw setup-priority?                  uint8
     |        +--rw hold-priority?                   uint8
     |        +--rw signaling-type?                  identityref
     |        +--rw path-metric-bounds
     |        |  +--rw path-metric-bound* [metric-type]
     |        |     +--rw metric-type    identityref
     |        |     +--rw upper-bound?   uint64
     |        +--rw path-affinities-values
     |        |  +--rw path-affinities-value* [usage]
     |        |     +--rw usage    identityref
     |        |     +--rw value?   admin-groups
     |        +--rw path-affinity-names
     |        |  +--rw path-affinity-name* [usage]
     |        |     +--rw usage            identityref
     |        |     +--rw affinity-name* [name]
     |        |        +--rw name    string
     |        +--rw path-srlgs-lists
     |        |  +--rw path-srlgs-list* [usage]
     |        |     +--rw usage     identityref
     |        |     +--rw values*   srlg
     |        +--rw path-srlgs-names
     |        |  +--rw path-srlgs-name* [usage]
     |        |     +--rw usage    identityref
     |        |     +--rw names*   string
     |        +--rw disjointness?
     |        |       te-path-disjointness
     |        +--rw explicit-route-objects-always
     |        |  +--rw route-object-exclude-always* [index]
     |        |  |  +--rw index                        uint32
     |        |  |  +--rw (type)?
     |        |  |     +--:(numbered-node-hop)
     |        |  |     |  +--rw numbered-node-hop
     |        |  |     |     +--rw node-id     te-node-id
     |        |  |     |     +--rw hop-type?   te-hop-type
     |        |  |     +--:(numbered-link-hop)
     |        |  |     |  +--rw numbered-link-hop
     |        |  |     |     +--rw link-tp-id    te-tp-id
     |        |  |     |     +--rw hop-type?     te-hop-type
     |        |  |     |     +--rw direction?    te-link-direction
     |        |  |     +--:(unnumbered-link-hop)
     |        |  |     |  +--rw unnumbered-link-hop
     |        |  |     |     +--rw link-tp-id    te-tp-id
     |        |  |     |     +--rw node-id       te-node-id
     |        |  |     |     +--rw hop-type?     te-hop-type
     |        |  |     |     +--rw direction?    te-link-direction
     |        |  |     +--:(as-number)
     |        |  |     |  +--rw as-number-hop
     |        |  |     |     +--rw as-number    inet:as-number
     |        |  |     |     +--rw hop-type?    te-hop-type
     |        |  |     +--:(label)
     |        |  |        +--rw label-hop
     |        |  |           +--rw te-label
     |        |  |              +--rw (technology)?
     |        |  |              |  +--:(generic)
     |        |  |              |     +--rw generic?
     |        |  |              |             rt-types:generalized-label
     |        |  |              +--rw direction?
     |        |  |                      te-label-direction
     |        |  +--rw route-object-include-exclude* [index]
     |        |     +--rw explicit-route-usage?        identityref
     |        |     +--rw index                        uint32
     |        |     +--rw (type)?
     |        |        +--:(numbered-node-hop)
     |        |        |  +--rw numbered-node-hop
     |        |        |     +--rw node-id     te-node-id
     |        |        |     +--rw hop-type?   te-hop-type
     |        |        +--:(numbered-link-hop)
     |        |        |  +--rw numbered-link-hop
     |        |        |     +--rw link-tp-id    te-tp-id
     |        |        |     +--rw hop-type?     te-hop-type
     |        |        |     +--rw direction?    te-link-direction
     |        |        +--:(unnumbered-link-hop)
     |        |        |  +--rw unnumbered-link-hop
     |        |        |     +--rw link-tp-id    te-tp-id
     |        |        |     +--rw node-id       te-node-id
     |        |        |     +--rw hop-type?     te-hop-type
     |        |        |     +--rw direction?    te-link-direction
     |        |        +--:(as-number)
     |        |        |  +--rw as-number-hop
     |        |        |     +--rw as-number    inet:as-number
     |        |        |     +--rw hop-type?    te-hop-type
     |        |        +--:(label)
     |        |        |  +--rw label-hop
     |        |        |     +--rw te-label
     |        |        |        +--rw (technology)?
     |        |        |        |  +--:(generic)
     |        |        |        |     +--rw generic?
     |        |        |        |             rt-types:generalized-label
     |        |        |        +--rw direction?
     |        |        |                te-label-direction
     |        |        +--:(srlg)
     |        |           +--rw srlg
     |        |              +--rw srlg?   uint32
     |        +--rw path-in-segment!
     |        |  +--rw label-restrictions
     |        |     +--rw label-restriction* [index]
     |        |        +--rw restriction?    enumeration
     |        |        +--rw index           uint32
     |        |        +--rw label-start
     |        |        |  +--rw te-label
     |        |        |     +--rw (technology)?
     |        |        |     |  +--:(generic)
     |        |        |     |     +--rw generic?
     |        |        |     |             rt-types:generalized-label
     |        |        |     +--rw direction?
     |        |        |             te-label-direction
     |        |        +--rw label-end
     |        |        |  +--rw te-label
     |        |        |     +--rw (technology)?
     |        |        |     |  +--:(generic)
     |        |        |     |     +--rw generic?
     |        |        |     |             rt-types:generalized-label
     |        |        |     +--rw direction?
     |        |        |             te-label-direction
     |        |        +--rw label-step
     |        |        |  +--rw (technology)?
     |        |        |     +--:(generic)
     |        |        |        +--rw generic?   int32
     |        |        +--rw range-bitmap?   yang:hex-string
     |        +--rw path-out-segment!
     |           +--rw label-restrictions
     |              +--rw label-restriction* [index]
     |                 +--rw restriction?    enumeration
     |                 +--rw index           uint32
     |                 +--rw label-start
     |                 |  +--rw te-label
     |                 |     +--rw (technology)?
     |                 |     |  +--:(generic)
     |                 |     |     +--rw generic?
     |                 |     |             rt-types:generalized-label
     |                 |     +--rw direction?
     |                 |             te-label-direction
     |                 +--rw label-end
     |                 |  +--rw te-label
     |                 |     +--rw (technology)?
     |                 |     |  +--:(generic)
     |                 |     |     +--rw generic?
     |                 |     |             rt-types:generalized-label
     |                 |     +--rw direction?
     |                 |             te-label-direction
     |                 +--rw label-step
     |                 |  +--rw (technology)?
     |                 |     +--:(generic)
     |                 |        +--rw generic?   int32
     |                 +--rw range-bitmap?   yang:hex-string
     +--rw tunnels
     |  +--rw tunnel* [name]
     |     +--rw name                            string
     |     +--rw alias?                          string
     |     +--rw identifier?                     uint32
     |     +--rw color?                          uint32
     |     +--rw description?                    string
     |     +--rw admin-state?                    identityref
     |     +--ro operational-state?              identityref
     |     +--rw encoding?                       identityref
     |     +--rw switching-type?                 identityref
     |     +--rw source?                         te-types:te-node-id
     |     +--rw destination?                    te-types:te-node-id
     |     +--rw src-tunnel-tp-id?               binary
     |     +--rw dst-tunnel-tp-id?               binary
     |     +--rw bidirectional?                  boolean
     |     +--rw controller
     |     |  +--rw protocol-origin?        identityref
     |     |  +--rw controller-entity-id?   string
     |     +--rw reoptimize-timer?               uint16
     |     +--rw association-objects
     |     |  +--rw association-object* [association-key]
     |     |  |  +--rw association-key    string
     |     |  |  +--rw type?              identityref
     |     |  |  +--rw id?                uint16
     |     |  |  +--rw source
     |     |  |     +--rw id?     te-gen-node-id
     |     |  |     +--rw type?   enumeration
     |     |  +--rw association-object-extended* [association-key]
     |     |     +--rw association-key    string
     |     |     +--rw type?              identityref
     |     |     +--rw id?                uint16
     |     |     +--rw source
     |     |     |  +--rw id?     te-gen-node-id
     |     |     |  +--rw type?   enumeration
     |     |     +--rw global-source?     uint32
     |     |     +--rw extended-id?       yang:hex-string
     |     +--rw protection
     |     |  +--rw enable?                         boolean
     |     |  +--rw protection-type?                identityref
     |     |  +--rw protection-reversion-disable?   boolean
     |     |  +--rw hold-off-time?                  uint32
     |     |  +--rw wait-to-revert?                 uint16
     |     |  +--rw aps-signal-id?                  uint8
     |     +--rw restoration
     |     |  +--rw enable?                          boolean
     |     |  +--rw restoration-type?                identityref
     |     |  +--rw restoration-scheme?              identityref
     |     |  +--rw restoration-reversion-disable?   boolean
     |     |  +--rw hold-off-time?                   uint32
     |     |  +--rw wait-to-restore?                 uint16
     |     |  +--rw wait-to-revert?                  uint16
     |     +--rw te-topology-identifier
     |     |  +--rw provider-id?   te-global-id
     |     |  +--rw client-id?     te-global-id
     |     |  +--rw topology-id?   te-topology-id
     |     +--rw te-bandwidth
     |     |  +--rw (technology)?
     |     |     +--:(generic)
     |     |        +--rw generic?   te-bandwidth
     |     +--rw link-protection?                identityref
     |     +--rw setup-priority?                 uint8
     |     +--rw hold-priority?                  uint8
     |     +--rw signaling-type?                 identityref
     |     +--rw hierarchy
     |     |  +--rw dependency-tunnels
     |     |  |  +--rw dependency-tunnel* [name]
     |     |  |     +--rw name
     |     |  |     |       -> /te/tunnels/tunnel/name
     |     |  |     +--rw encoding?         identityref
     |     |  |     +--rw switching-type?   identityref
     |     |  +--rw hierarchical-link
     |     |     +--rw local-te-node-id?         te-types:te-node-id
     |     |     +--rw local-te-link-tp-id?      te-types:te-tp-id
     |     |     +--rw remote-te-node-id?        te-types:te-node-id
     |     |     +--rw te-topology-identifier
     |     |        +--rw provider-id?   te-global-id
     |     |        +--rw client-id?     te-global-id
     |     |        +--rw topology-id?   te-topology-id
     |     +--rw primary-paths
     |     |  +--rw primary-path* [name]
     |     |     +--rw name                             string
     |     |     +--rw path-computation-method?         identityref
     |     |     +--rw path-computation-server
     |     |     |  +--rw id?     te-gen-node-id
     |     |     |  +--rw type?   enumeration
     |     |     +--rw compute-only?                    empty
     |     |     +--rw use-path-computation?            boolean
     |     |     +--rw lockdown?                        empty
     |     |     +--ro path-scope?                      identityref
     |     |     +--rw preference?                      uint8
     |     |     +--rw k-requested-paths?               uint8
     |     |     +--rw association-objects
     |     |     |  +--rw association-object* [association-key]
     |     |     |  |  +--rw association-key    string
     |     |     |  |  +--rw type?              identityref
     |     |     |  |  +--rw id?                uint16
     |     |     |  |  +--rw source
     |     |     |  |     +--rw id?     te-gen-node-id
     |     |     |  |     +--rw type?   enumeration
     |     |     |  +--rw association-object-extended*
     |     |     |          [association-key]
     |     |     |     +--rw association-key    string
     |     |     |     +--rw type?              identityref
     |     |     |     +--rw id?                uint16
     |     |     |     +--rw source
     |     |     |     |  +--rw id?     te-gen-node-id
     |     |     |     |  +--rw type?   enumeration
     |     |     |     +--rw global-source?     uint32
     |     |     |     +--rw extended-id?       yang:hex-string
     |     |     +--rw optimizations
     |     |     |  +--rw (algorithm)?
     |     |     |     +--:(metric) {path-optimization-metric}?
     |     |     |     |  +--rw optimization-metric* [metric-type]
     |     |     |     |  |  +--rw metric-type
     |     |     |     |  |  |       identityref
     |     |     |     |  |  +--rw weight?
     |     |     |     |  |  |       uint8
     |     |     |     |  |  +--rw explicit-route-exclude-objects
     |     |     |     |  |  |  +--rw route-object-exclude-object*
     |     |     |     |  |  |          [index]
     |     |     |     |  |  |     +--rw index
     |     |     |     |  |  |     |       uint32
     |     |     |     |  |  |     +--rw (type)?
     |     |     |     |  |  |        +--:(numbered-node-hop)
     |     |     |     |  |  |        |  +--rw numbered-node-hop
     |     |     |     |  |  |        |     +--rw node-id
     |     |     |     |  |  |        |     |       te-node-id
     |     |     |     |  |  |        |     +--rw hop-type?
     |     |     |     |  |  |        |             te-hop-type
     |     |     |     |  |  |        +--:(numbered-link-hop)
     |     |     |     |  |  |        |  +--rw numbered-link-hop
     |     |     |     |  |  |        |     +--rw link-tp-id
     |     |     |     |  |  |        |     |       te-tp-id
     |     |     |     |  |  |        |     +--rw hop-type?
     |     |     |     |  |  |        |     |       te-hop-type
     |     |     |     |  |  |        |     +--rw direction?
     |     |     |     |  |  |        |             te-link-direction
     |     |     |     |  |  |        +--:(unnumbered-link-hop)
     |     |     |     |  |  |        |  +--rw unnumbered-link-hop
     |     |     |     |  |  |        |     +--rw link-tp-id
     |     |     |     |  |  |        |     |       te-tp-id
     |     |     |     |  |  |        |     +--rw node-id
     |     |     |     |  |  |        |     |       te-node-id
     |     |     |     |  |  |        |     +--rw hop-type?
     |     |     |     |  |  |        |     |       te-hop-type
     |     |     |     |  |  |        |     +--rw direction?
     |     |     |     |  |  |        |             te-link-direction
     |     |     |     |  |  |        +--:(as-number)
     |     |     |     |  |  |        |  +--rw as-number-hop
     |     |     |     |  |  |        |     +--rw as-number
     |     |     |     |  |  |        |     |       inet:as-number
     |     |     |     |  |  |        |     +--rw hop-type?
     |     |     |     |  |  |        |             te-hop-type
     |     |     |     |  |  |        +--:(label)
     |     |     |     |  |  |        |  +--rw label-hop
     |     |     |     |  |  |        |     +--rw te-label
     |     |     |     |  |  |        |        +--rw (technology)?
     |     |     |     |  |  |        |        |  +--:(generic)
     |     |     |     |  |  |        |        |     +--rw generic?
     |     |     |     |  |  |        |        |             rt-types:ge
neralized-label
     |     |     |     |  |  |        |        +--rw direction?
     |     |     |     |  |  |        |                te-label-directio
n
     |     |     |     |  |  |        +--:(srlg)
     |     |     |     |  |  |           +--rw srlg
     |     |     |     |  |  |              +--rw srlg?   uint32
     |     |     |     |  |  +--rw explicit-route-include-objects
     |     |     |     |  |     +--rw route-object-include-object*
     |     |     |     |  |             [index]
     |     |     |     |  |        +--rw index
     |     |     |     |  |        |       uint32
     |     |     |     |  |        +--rw (type)?
     |     |     |     |  |           +--:(numbered-node-hop)
     |     |     |     |  |           |  +--rw numbered-node-hop
     |     |     |     |  |           |     +--rw node-id
     |     |     |     |  |           |     |       te-node-id
     |     |     |     |  |           |     +--rw hop-type?
     |     |     |     |  |           |             te-hop-type
     |     |     |     |  |           +--:(numbered-link-hop)
     |     |     |     |  |           |  +--rw numbered-link-hop
     |     |     |     |  |           |     +--rw link-tp-id
     |     |     |     |  |           |     |       te-tp-id
     |     |     |     |  |           |     +--rw hop-type?
     |     |     |     |  |           |     |       te-hop-type
     |     |     |     |  |           |     +--rw direction?
     |     |     |     |  |           |             te-link-direction
     |     |     |     |  |           +--:(unnumbered-link-hop)
     |     |     |     |  |           |  +--rw unnumbered-link-hop
     |     |     |     |  |           |     +--rw link-tp-id
     |     |     |     |  |           |     |       te-tp-id
     |     |     |     |  |           |     +--rw node-id
     |     |     |     |  |           |     |       te-node-id
     |     |     |     |  |           |     +--rw hop-type?
     |     |     |     |  |           |     |       te-hop-type
     |     |     |     |  |           |     +--rw direction?
     |     |     |     |  |           |             te-link-direction
     |     |     |     |  |           +--:(as-number)
     |     |     |     |  |           |  +--rw as-number-hop
     |     |     |     |  |           |     +--rw as-number
     |     |     |     |  |           |     |       inet:as-number
     |     |     |     |  |           |     +--rw hop-type?
     |     |     |     |  |           |             te-hop-type
     |     |     |     |  |           +--:(label)
     |     |     |     |  |              +--rw label-hop
     |     |     |     |  |                 +--rw te-label
     |     |     |     |  |                    +--rw (technology)?
     |     |     |     |  |                    |  +--:(generic)
     |     |     |     |  |                    |     +--rw generic?
     |     |     |     |  |                    |             rt-types:ge
neralized-label
     |     |     |     |  |                    +--rw direction?
     |     |     |     |  |                            te-label-directio
n
     |     |     |     |  +--rw tiebreakers
     |     |     |     |     +--rw tiebreaker* [tiebreaker-type]
     |     |     |     |        +--rw tiebreaker-type    identityref
     |     |     |     +--:(objective-function)
     |     |     |              {path-optimization-objective-function}?
     |     |     |        +--rw objective-function
     |     |     |           +--rw objective-function-type?
     |     |     |                   identityref
     |     |     +--rw named-path-constraint?           leafref
     |     |     |       {te-types:named-path-constraints}?
     |     |     +--rw te-bandwidth
     |     |     |  +--rw (technology)?
     |     |     |     +--:(generic)
     |     |     |        +--rw generic?   te-bandwidth
     |     |     +--rw link-protection?                 identityref
     |     |     +--rw setup-priority?                  uint8
     |     |     +--rw hold-priority?                   uint8
     |     |     +--rw signaling-type?                  identityref
     |     |     +--rw path-metric-bounds
     |     |     |  +--rw path-metric-bound* [metric-type]
     |     |     |     +--rw metric-type    identityref
     |     |     |     +--rw upper-bound?   uint64
     |     |     +--rw path-affinities-values
     |     |     |  +--rw path-affinities-value* [usage]
     |     |     |     +--rw usage    identityref
     |     |     |     +--rw value?   admin-groups
     |     |     +--rw path-affinity-names
     |     |     |  +--rw path-affinity-name* [usage]
     |     |     |     +--rw usage            identityref
     |     |     |     +--rw affinity-name* [name]
     |     |     |        +--rw name    string
     |     |     +--rw path-srlgs-lists
     |     |     |  +--rw path-srlgs-list* [usage]
     |     |     |     +--rw usage     identityref
     |     |     |     +--rw values*   srlg
     |     |     +--rw path-srlgs-names
     |     |     |  +--rw path-srlgs-name* [usage]
     |     |     |     +--rw usage    identityref
     |     |     |     +--rw names*   string
     |     |     +--rw disjointness?
     |     |     |       te-path-disjointness
     |     |     +--rw explicit-route-objects-always
     |     |     |  +--rw route-object-exclude-always* [index]
     |     |     |  |  +--rw index                        uint32
     |     |     |  |  +--rw (type)?
     |     |     |  |     +--:(numbered-node-hop)
     |     |     |  |     |  +--rw numbered-node-hop
     |     |     |  |     |     +--rw node-id     te-node-id
     |     |     |  |     |     +--rw hop-type?   te-hop-type
     |     |     |  |     +--:(numbered-link-hop)
     |     |     |  |     |  +--rw numbered-link-hop
     |     |     |  |     |     +--rw link-tp-id    te-tp-id
     |     |     |  |     |     +--rw hop-type?     te-hop-type
     |     |     |  |     |     +--rw direction?    te-link-direction
     |     |     |  |     +--:(unnumbered-link-hop)
     |     |     |  |     |  +--rw unnumbered-link-hop
     |     |     |  |     |     +--rw link-tp-id    te-tp-id
     |     |     |  |     |     +--rw node-id       te-node-id
     |     |     |  |     |     +--rw hop-type?     te-hop-type
     |     |     |  |     |     +--rw direction?    te-link-direction
     |     |     |  |     +--:(as-number)
     |     |     |  |     |  +--rw as-number-hop
     |     |     |  |     |     +--rw as-number    inet:as-number
     |     |     |  |     |     +--rw hop-type?    te-hop-type
     |     |     |  |     +--:(label)
     |     |     |  |        +--rw label-hop
     |     |     |  |           +--rw te-label
     |     |     |  |              +--rw (technology)?
     |     |     |  |              |  +--:(generic)
     |     |     |  |              |     +--rw generic?
     |     |     |  |              |             rt-types:generalized-la
bel
     |     |     |  |              +--rw direction?
     |     |     |  |                      te-label-direction
     |     |     |  +--rw route-object-include-exclude* [index]
     |     |     |     +--rw explicit-route-usage?        identityref
     |     |     |     +--rw index                        uint32
     |     |     |     +--rw (type)?
     |     |     |        +--:(numbered-node-hop)
     |     |     |        |  +--rw numbered-node-hop
     |     |     |        |     +--rw node-id     te-node-id
     |     |     |        |     +--rw hop-type?   te-hop-type
     |     |     |        +--:(numbered-link-hop)
     |     |     |        |  +--rw numbered-link-hop
     |     |     |        |     +--rw link-tp-id    te-tp-id
     |     |     |        |     +--rw hop-type?     te-hop-type
     |     |     |        |     +--rw direction?    te-link-direction
     |     |     |        +--:(unnumbered-link-hop)
     |     |     |        |  +--rw unnumbered-link-hop
     |     |     |        |     +--rw link-tp-id    te-tp-id
     |     |     |        |     +--rw node-id       te-node-id
     |     |     |        |     +--rw hop-type?     te-hop-type
     |     |     |        |     +--rw direction?    te-link-direction
     |     |     |        +--:(as-number)
     |     |     |        |  +--rw as-number-hop
     |     |     |        |     +--rw as-number    inet:as-number
     |     |     |        |     +--rw hop-type?    te-hop-type
     |     |     |        +--:(label)
     |     |     |        |  +--rw label-hop
     |     |     |        |     +--rw te-label
     |     |     |        |        +--rw (technology)?
     |     |     |        |        |  +--:(generic)
     |     |     |        |        |     +--rw generic?
     |     |     |        |        |             rt-types:generalized-la
bel
     |     |     |        |        +--rw direction?
     |     |     |        |                te-label-direction
     |     |     |        +--:(srlg)
     |     |     |           +--rw srlg
     |     |     |              +--rw srlg?   uint32
     |     |     +--rw path-in-segment!
     |     |     |  +--rw label-restrictions
     |     |     |     +--rw label-restriction* [index]
     |     |     |        +--rw restriction?    enumeration
     |     |     |        +--rw index           uint32
     |     |     |        +--rw label-start
     |     |     |        |  +--rw te-label
     |     |     |        |     +--rw (technology)?
     |     |     |        |     |  +--:(generic)
     |     |     |        |     |     +--rw generic?
     |     |     |        |     |             rt-types:generalized-label
     |     |     |        |     +--rw direction?
     |     |     |        |             te-label-direction
     |     |     |        +--rw label-end
     |     |     |        |  +--rw te-label
     |     |     |        |     +--rw (technology)?
     |     |     |        |     |  +--:(generic)
     |     |     |        |     |     +--rw generic?
     |     |     |        |     |             rt-types:generalized-label
     |     |     |        |     +--rw direction?
     |     |     |        |             te-label-direction
     |     |     |        +--rw label-step
     |     |     |        |  +--rw (technology)?
     |     |     |        |     +--:(generic)
     |     |     |        |        +--rw generic?   int32
     |     |     |        +--rw range-bitmap?   yang:hex-string
     |     |     +--rw path-out-segment!
     |     |     |  +--rw label-restrictions
     |     |     |     +--rw label-restriction* [index]
     |     |     |        +--rw restriction?    enumeration
     |     |     |        +--rw index           uint32
     |     |     |        +--rw label-start
     |     |     |        |  +--rw te-label
     |     |     |        |     +--rw (technology)?
     |     |     |        |     |  +--:(generic)
     |     |     |        |     |     +--rw generic?
     |     |     |        |     |             rt-types:generalized-label
     |     |     |        |     +--rw direction?
     |     |     |        |             te-label-direction
     |     |     |        +--rw label-end
     |     |     |        |  +--rw te-label
     |     |     |        |     +--rw (technology)?
     |     |     |        |     |  +--:(generic)
     |     |     |        |     |     +--rw generic?
     |     |     |        |     |             rt-types:generalized-label
     |     |     |        |     +--rw direction?
     |     |     |        |             te-label-direction
     |     |     |        +--rw label-step
     |     |     |        |  +--rw (technology)?
     |     |     |        |     +--:(generic)
     |     |     |        |        +--rw generic?   int32
     |     |     |        +--rw range-bitmap?   yang:hex-string
     |     |     +--ro computed-paths-properties
     |     |     |  +--ro computed-path-properties* [k-index]
     |     |     |     +--ro k-index            uint8
     |     |     |     +--ro path-properties
     |     |     |        +--ro path-metric* [metric-type]
     |     |     |        |  +--ro metric-type           identityref
     |     |     |        |  +--ro accumulative-value?   uint64
     |     |     |        +--ro path-affinities-values
     |     |     |        |  +--ro path-affinities-value* [usage]
     |     |     |        |     +--ro usage    identityref
     |     |     |        |     +--ro value?   admin-groups
     |     |     |        +--ro path-affinity-names
     |     |     |        |  +--ro path-affinity-name* [usage]
     |     |     |        |     +--ro usage            identityref
     |     |     |        |     +--ro affinity-name* [name]
     |     |     |        |        +--ro name    string
     |     |     |        +--ro path-srlgs-lists
     |     |     |        |  +--ro path-srlgs-list* [usage]
     |     |     |        |     +--ro usage     identityref
     |     |     |        |     +--ro values*   srlg
     |     |     |        +--ro path-srlgs-names
     |     |     |        |  +--ro path-srlgs-name* [usage]
     |     |     |        |     +--ro usage    identityref
     |     |     |        |     +--ro names*   string
     |     |     |        +--ro path-route-objects
     |     |     |        |  +--ro path-route-object* [index]
     |     |     |        |     +--ro index
     |     |     |        |     |       uint32
     |     |     |        |     +--ro (type)?
     |     |     |        |        +--:(numbered-node-hop)
     |     |     |        |        |  +--ro numbered-node-hop
     |     |     |        |        |     +--ro node-id     te-node-id
     |     |     |        |        |     +--ro hop-type?
     |     |     |        |        |             te-hop-type
     |     |     |        |        +--:(numbered-link-hop)
     |     |     |        |        |  +--ro numbered-link-hop
     |     |     |        |        |     +--ro link-tp-id    te-tp-id
     |     |     |        |        |     +--ro hop-type?
     |     |     |        |        |     |       te-hop-type
     |     |     |        |        |     +--ro direction?
     |     |     |        |        |             te-link-direction
     |     |     |        |        +--:(unnumbered-link-hop)
     |     |     |        |        |  +--ro unnumbered-link-hop
     |     |     |        |        |     +--ro link-tp-id    te-tp-id
     |     |     |        |        |     +--ro node-id
     |     |     |        |        |     |       te-node-id
     |     |     |        |        |     +--ro hop-type?
     |     |     |        |        |     |       te-hop-type
     |     |     |        |        |     +--ro direction?
     |     |     |        |        |             te-link-direction
     |     |     |        |        +--:(as-number)
     |     |     |        |        |  +--ro as-number-hop
     |     |     |        |        |     +--ro as-number
     |     |     |        |        |     |       inet:as-number
     |     |     |        |        |     +--ro hop-type?
     |     |     |        |        |             te-hop-type
     |     |     |        |        +--:(label)
     |     |     |        |           +--ro label-hop
     |     |     |        |              +--ro te-label
     |     |     |        |                 +--ro (technology)?
     |     |     |        |                 |  +--:(generic)
     |     |     |        |                 |     +--ro generic?
     |     |     |        |                 |             rt-types:gener
alized-label
     |     |     |        |                 +--ro direction?
     |     |     |        |                         te-label-direction
     |     |     |        +--ro te-bandwidth
     |     |     |        |  +--ro (technology)?
     |     |     |        |     +--:(generic)
     |     |     |        |        +--ro generic?   te-bandwidth
     |     |     |        +--ro disjointness-type?
     |     |     |                te-types:te-path-disjointness
     |     |     +--ro computed-path-error-infos
     |     |     |  +--ro computed-path-error-info* []
     |     |     |     +--ro error-description?   string
     |     |     |     +--ro error-timestamp?     yang:date-and-time
     |     |     |     +--ro error-reason?        identityref
     |     |     +--ro lsp-provisioning-error-infos
     |     |     |  +--ro lsp-provisioning-error-info* []
     |     |     |     +--ro error-description?   string
     |     |     |     +--ro error-timestamp?     yang:date-and-time
     |     |     |     +--ro error-node-id?       te-types:te-node-id
     |     |     |     +--ro error-link-id?       te-types:te-tp-id
     |     |     |     +--ro lsp-id?              uint16
     |     |     +--ro lsps
     |     |     |  +--ro lsp* [node lsp-id]
     |     |     |     +--ro tunnel-name?
     |     |     |     |       -> /te/lsps/lsp/tunnel-name
     |     |     |     +--ro node           -> /te/lsps/lsp/node
     |     |     |     +--ro lsp-id         -> /te/lsps/lsp/lsp-id
     |     |     +--rw primary-reverse-path
     |     |     |  +--rw name?                                string
     |     |     |  +--rw path-computation-method?
     |     |     |  |       identityref
     |     |     |  +--rw path-computation-server
     |     |     |  |  +--rw id?     te-gen-node-id
     |     |     |  |  +--rw type?   enumeration
     |     |     |  +--rw compute-only?                        empty
     |     |     |  +--rw use-path-computation?
     |     |     |  |       boolean
     |     |     |  +--rw lockdown?                            empty
     |     |     |  +--ro path-scope?
     |     |     |  |       identityref
     |     |     |  +--rw association-objects
     |     |     |  |  +--rw association-object* [association-key]
     |     |     |  |  |  +--rw association-key    string
     |     |     |  |  |  +--rw type?              identityref
     |     |     |  |  |  +--rw id?                uint16
     |     |     |  |  |  +--rw source
     |     |     |  |  |     +--rw id?     te-gen-node-id
     |     |     |  |  |     +--rw type?   enumeration
     |     |     |  |  +--rw association-object-extended*
     |     |     |  |          [association-key]
     |     |     |  |     +--rw association-key    string
     |     |     |  |     +--rw type?              identityref
     |     |     |  |     +--rw id?                uint16
     |     |     |  |     +--rw source
     |     |     |  |     |  +--rw id?     te-gen-node-id
     |     |     |  |     |  +--rw type?   enumeration
     |     |     |  |     +--rw global-source?     uint32
     |     |     |  |     +--rw extended-id?       yang:hex-string
     |     |     |  +--rw optimizations
     |     |     |  |  +--rw (algorithm)?
     |     |     |  |     +--:(metric) {path-optimization-metric}?
     |     |     |  |     |  +--rw optimization-metric* [metric-type]
     |     |     |  |     |  |  +--rw metric-type
     |     |     |  |     |  |  |       identityref
     |     |     |  |     |  |  +--rw weight?
     |     |     |  |     |  |  |       uint8
     |     |     |  |     |  |  +--rw explicit-route-exclude-objects
     |     |     |  |     |  |  |  +--rw route-object-exclude-object*
     |     |     |  |     |  |  |          [index]
     |     |     |  |     |  |  |     +--rw index
     |     |     |  |     |  |  |     |       uint32
     |     |     |  |     |  |  |     +--rw (type)?
     |     |     |  |     |  |  |        +--:(numbered-node-hop)
     |     |     |  |     |  |  |        |  +--rw numbered-node-hop
     |     |     |  |     |  |  |        |     +--rw node-id
     |     |     |  |     |  |  |        |     |       te-node-id
     |     |     |  |     |  |  |        |     +--rw hop-type?
     |     |     |  |     |  |  |        |             te-hop-type
     |     |     |  |     |  |  |        +--:(numbered-link-hop)
     |     |     |  |     |  |  |        |  +--rw numbered-link-hop
     |     |     |  |     |  |  |        |     +--rw link-tp-id
     |     |     |  |     |  |  |        |     |       te-tp-id
     |     |     |  |     |  |  |        |     +--rw hop-type?
     |     |     |  |     |  |  |        |     |       te-hop-type
     |     |     |  |     |  |  |        |     +--rw direction?
     |     |     |  |     |  |  |        |             te-link-direction
     |     |     |  |     |  |  |        +--:(unnumbered-link-hop)
     |     |     |  |     |  |  |        |  +--rw unnumbered-link-hop
     |     |     |  |     |  |  |        |     +--rw link-tp-id
     |     |     |  |     |  |  |        |     |       te-tp-id
     |     |     |  |     |  |  |        |     +--rw node-id
     |     |     |  |     |  |  |        |     |       te-node-id
     |     |     |  |     |  |  |        |     +--rw hop-type?
     |     |     |  |     |  |  |        |     |       te-hop-type
     |     |     |  |     |  |  |        |     +--rw direction?
     |     |     |  |     |  |  |        |             te-link-direction
     |     |     |  |     |  |  |        +--:(as-number)
     |     |     |  |     |  |  |        |  +--rw as-number-hop
     |     |     |  |     |  |  |        |     +--rw as-number
     |     |     |  |     |  |  |        |     |       inet:as-number
     |     |     |  |     |  |  |        |     +--rw hop-type?
     |     |     |  |     |  |  |        |             te-hop-type
     |     |     |  |     |  |  |        +--:(label)
     |     |     |  |     |  |  |        |  +--rw label-hop
     |     |     |  |     |  |  |        |     +--rw te-label
     |     |     |  |     |  |  |        |        +--rw (technology)?
     |     |     |  |     |  |  |        |        |  +--:(generic)
     |     |     |  |     |  |  |        |        |     +--rw generic?
     |     |     |  |     |  |  |        |        |             rt-types
:generalized-label
     |     |     |  |     |  |  |        |        +--rw direction?
     |     |     |  |     |  |  |        |                te-label-direc
tion
     |     |     |  |     |  |  |        +--:(srlg)
     |     |     |  |     |  |  |           +--rw srlg
     |     |     |  |     |  |  |              +--rw srlg?   uint32
     |     |     |  |     |  |  +--rw explicit-route-include-objects
     |     |     |  |     |  |     +--rw route-object-include-object*
     |     |     |  |     |  |             [index]
     |     |     |  |     |  |        +--rw index
     |     |     |  |     |  |        |       uint32
     |     |     |  |     |  |        +--rw (type)?
     |     |     |  |     |  |           +--:(numbered-node-hop)
     |     |     |  |     |  |           |  +--rw numbered-node-hop
     |     |     |  |     |  |           |     +--rw node-id
     |     |     |  |     |  |           |     |       te-node-id
     |     |     |  |     |  |           |     +--rw hop-type?
     |     |     |  |     |  |           |             te-hop-type
     |     |     |  |     |  |           +--:(numbered-link-hop)
     |     |     |  |     |  |           |  +--rw numbered-link-hop
     |     |     |  |     |  |           |     +--rw link-tp-id
     |     |     |  |     |  |           |     |       te-tp-id
     |     |     |  |     |  |           |     +--rw hop-type?
     |     |     |  |     |  |           |     |       te-hop-type
     |     |     |  |     |  |           |     +--rw direction?
     |     |     |  |     |  |           |             te-link-direction
     |     |     |  |     |  |           +--:(unnumbered-link-hop)
     |     |     |  |     |  |           |  +--rw unnumbered-link-hop
     |     |     |  |     |  |           |     +--rw link-tp-id
     |     |     |  |     |  |           |     |       te-tp-id
     |     |     |  |     |  |           |     +--rw node-id
     |     |     |  |     |  |           |     |       te-node-id
     |     |     |  |     |  |           |     +--rw hop-type?
     |     |     |  |     |  |           |     |       te-hop-type
     |     |     |  |     |  |           |     +--rw direction?
     |     |     |  |     |  |           |             te-link-direction
     |     |     |  |     |  |           +--:(as-number)
     |     |     |  |     |  |           |  +--rw as-number-hop
     |     |     |  |     |  |           |     +--rw as-number
     |     |     |  |     |  |           |     |       inet:as-number
     |     |     |  |     |  |           |     +--rw hop-type?
     |     |     |  |     |  |           |             te-hop-type
     |     |     |  |     |  |           +--:(label)
     |     |     |  |     |  |              +--rw label-hop
     |     |     |  |     |  |                 +--rw te-label
     |     |     |  |     |  |                    +--rw (technology)?
     |     |     |  |     |  |                    |  +--:(generic)
     |     |     |  |     |  |                    |     +--rw generic?
     |     |     |  |     |  |                    |             rt-types
:generalized-label
     |     |     |  |     |  |                    +--rw direction?
     |     |     |  |     |  |                            te-label-direc
tion
     |     |     |  |     |  +--rw tiebreakers
     |     |     |  |     |     +--rw tiebreaker* [tiebreaker-type]
     |     |     |  |     |        +--rw tiebreaker-type
     |     |     |  |     |                identityref
     |     |     |  |     +--:(objective-function)
     |     |     |  |              {path-optimization-objective-function
}?
     |     |     |  |        +--rw objective-function
     |     |     |  |           +--rw objective-function-type?
     |     |     |  |                   identityref
     |     |     |  +--rw named-path-constraint?               leafref
     |     |     |  |       {te-types:named-path-constraints}?
     |     |     |  +--rw te-bandwidth
     |     |     |  |  +--rw (technology)?
     |     |     |  |     +--:(generic)
     |     |     |  |        +--rw generic?   te-bandwidth
     |     |     |  +--rw link-protection?
     |     |     |  |       identityref
     |     |     |  +--rw setup-priority?                      uint8
     |     |     |  +--rw hold-priority?                       uint8
     |     |     |  +--rw signaling-type?
     |     |     |  |       identityref
     |     |     |  +--rw path-metric-bounds
     |     |     |  |  +--rw path-metric-bound* [metric-type]
     |     |     |  |     +--rw metric-type    identityref
     |     |     |  |     +--rw upper-bound?   uint64
     |     |     |  +--rw path-affinities-values
     |     |     |  |  +--rw path-affinities-value* [usage]
     |     |     |  |     +--rw usage    identityref
     |     |     |  |     +--rw value?   admin-groups
     |     |     |  +--rw path-affinity-names
     |     |     |  |  +--rw path-affinity-name* [usage]
     |     |     |  |     +--rw usage            identityref
     |     |     |  |     +--rw affinity-name* [name]
     |     |     |  |        +--rw name    string
     |     |     |  +--rw path-srlgs-lists
     |     |     |  |  +--rw path-srlgs-list* [usage]
     |     |     |  |     +--rw usage     identityref
     |     |     |  |     +--rw values*   srlg
     |     |     |  +--rw path-srlgs-names
     |     |     |  |  +--rw path-srlgs-name* [usage]
     |     |     |  |     +--rw usage    identityref
     |     |     |  |     +--rw names*   string
     |     |     |  +--rw disjointness?
     |     |     |  |       te-path-disjointness
     |     |     |  +--rw explicit-route-objects-always
     |     |     |  |  +--rw route-object-exclude-always* [index]
     |     |     |  |  |  +--rw index                        uint32
     |     |     |  |  |  +--rw (type)?
     |     |     |  |  |     +--:(numbered-node-hop)
     |     |     |  |  |     |  +--rw numbered-node-hop
     |     |     |  |  |     |     +--rw node-id     te-node-id
     |     |     |  |  |     |     +--rw hop-type?   te-hop-type
     |     |     |  |  |     +--:(numbered-link-hop)
     |     |     |  |  |     |  +--rw numbered-link-hop
     |     |     |  |  |     |     +--rw link-tp-id    te-tp-id
     |     |     |  |  |     |     +--rw hop-type?     te-hop-type
     |     |     |  |  |     |     +--rw direction?
     |     |     |  |  |     |             te-link-direction
     |     |     |  |  |     +--:(unnumbered-link-hop)
     |     |     |  |  |     |  +--rw unnumbered-link-hop
     |     |     |  |  |     |     +--rw link-tp-id    te-tp-id
     |     |     |  |  |     |     +--rw node-id       te-node-id
     |     |     |  |  |     |     +--rw hop-type?     te-hop-type
     |     |     |  |  |     |     +--rw direction?
     |     |     |  |  |     |             te-link-direction
     |     |     |  |  |     +--:(as-number)
     |     |     |  |  |     |  +--rw as-number-hop
     |     |     |  |  |     |     +--rw as-number    inet:as-number
     |     |     |  |  |     |     +--rw hop-type?    te-hop-type
     |     |     |  |  |     +--:(label)
     |     |     |  |  |        +--rw label-hop
     |     |     |  |  |           +--rw te-label
     |     |     |  |  |              +--rw (technology)?
     |     |     |  |  |              |  +--:(generic)
     |     |     |  |  |              |     +--rw generic?
     |     |     |  |  |              |             rt-types:generalized
-label
     |     |     |  |  |              +--rw direction?
     |     |     |  |  |                      te-label-direction
     |     |     |  |  +--rw route-object-include-exclude* [index]
     |     |     |  |     +--rw explicit-route-usage?
     |     |     |  |     |       identityref
     |     |     |  |     +--rw index                        uint32
     |     |     |  |     +--rw (type)?
     |     |     |  |        +--:(numbered-node-hop)
     |     |     |  |        |  +--rw numbered-node-hop
     |     |     |  |        |     +--rw node-id     te-node-id
     |     |     |  |        |     +--rw hop-type?   te-hop-type
     |     |     |  |        +--:(numbered-link-hop)
     |     |     |  |        |  +--rw numbered-link-hop
     |     |     |  |        |     +--rw link-tp-id    te-tp-id
     |     |     |  |        |     +--rw hop-type?     te-hop-type
     |     |     |  |        |     +--rw direction?
     |     |     |  |        |             te-link-direction
     |     |     |  |        +--:(unnumbered-link-hop)
     |     |     |  |        |  +--rw unnumbered-link-hop
     |     |     |  |        |     +--rw link-tp-id    te-tp-id
     |     |     |  |        |     +--rw node-id       te-node-id
     |     |     |  |        |     +--rw hop-type?     te-hop-type
     |     |     |  |        |     +--rw direction?
     |     |     |  |        |             te-link-direction
     |     |     |  |        +--:(as-number)
     |     |     |  |        |  +--rw as-number-hop
     |     |     |  |        |     +--rw as-number    inet:as-number
     |     |     |  |        |     +--rw hop-type?    te-hop-type
     |     |     |  |        +--:(label)
     |     |     |  |        |  +--rw label-hop
     |     |     |  |        |     +--rw te-label
     |     |     |  |        |        +--rw (technology)?
     |     |     |  |        |        |  +--:(generic)
     |     |     |  |        |        |     +--rw generic?
     |     |     |  |        |        |             rt-types:generalized
-label
     |     |     |  |        |        +--rw direction?
     |     |     |  |        |                te-label-direction
     |     |     |  |        +--:(srlg)
     |     |     |  |           +--rw srlg
     |     |     |  |              +--rw srlg?   uint32
     |     |     |  +--rw path-in-segment!
     |     |     |  |  +--rw label-restrictions
     |     |     |  |     +--rw label-restriction* [index]
     |     |     |  |        +--rw restriction?    enumeration
     |     |     |  |        +--rw index           uint32
     |     |     |  |        +--rw label-start
     |     |     |  |        |  +--rw te-label
     |     |     |  |        |     +--rw (technology)?
     |     |     |  |        |     |  +--:(generic)
     |     |     |  |        |     |     +--rw generic?
     |     |     |  |        |     |             rt-types:generalized-la
bel
     |     |     |  |        |     +--rw direction?
     |     |     |  |        |             te-label-direction
     |     |     |  |        +--rw label-end
     |     |     |  |        |  +--rw te-label
     |     |     |  |        |     +--rw (technology)?
     |     |     |  |        |     |  +--:(generic)
     |     |     |  |        |     |     +--rw generic?
     |     |     |  |        |     |             rt-types:generalized-la
bel
     |     |     |  |        |     +--rw direction?
     |     |     |  |        |             te-label-direction
     |     |     |  |        +--rw label-step
     |     |     |  |        |  +--rw (technology)?
     |     |     |  |        |     +--:(generic)
     |     |     |  |        |        +--rw generic?   int32
     |     |     |  |        +--rw range-bitmap?   yang:hex-string
     |     |     |  +--rw path-out-segment!
     |     |     |  |  +--rw label-restrictions
     |     |     |  |     +--rw label-restriction* [index]
     |     |     |  |        +--rw restriction?    enumeration
     |     |     |  |        +--rw index           uint32
     |     |     |  |        +--rw label-start
     |     |     |  |        |  +--rw te-label
     |     |     |  |        |     +--rw (technology)?
     |     |     |  |        |     |  +--:(generic)
     |     |     |  |        |     |     +--rw generic?
     |     |     |  |        |     |             rt-types:generalized-la
bel
     |     |     |  |        |     +--rw direction?
     |     |     |  |        |             te-label-direction
     |     |     |  |        +--rw label-end
     |     |     |  |        |  +--rw te-label
     |     |     |  |        |     +--rw (technology)?
     |     |     |  |        |     |  +--:(generic)
     |     |     |  |        |     |     +--rw generic?
     |     |     |  |        |     |             rt-types:generalized-la
bel
     |     |     |  |        |     +--rw direction?
     |     |     |  |        |             te-label-direction
     |     |     |  |        +--rw label-step
     |     |     |  |        |  +--rw (technology)?
     |     |     |  |        |     +--:(generic)
     |     |     |  |        |        +--rw generic?   int32
     |     |     |  |        +--rw range-bitmap?   yang:hex-string
     |     |     |  +--ro computed-paths-properties
     |     |     |  |  +--ro computed-path-properties* [k-index]
     |     |     |  |     +--ro k-index            uint8
     |     |     |  |     +--ro path-properties
     |     |     |  |        +--ro path-metric* [metric-type]
     |     |     |  |        |  +--ro metric-type
     |     |     |  |        |  |       identityref
     |     |     |  |        |  +--ro accumulative-value?   uint64
     |     |     |  |        +--ro path-affinities-values
     |     |     |  |        |  +--ro path-affinities-value* [usage]
     |     |     |  |        |     +--ro usage    identityref
     |     |     |  |        |     +--ro value?   admin-groups
     |     |     |  |        +--ro path-affinity-names
     |     |     |  |        |  +--ro path-affinity-name* [usage]
     |     |     |  |        |     +--ro usage            identityref
     |     |     |  |        |     +--ro affinity-name* [name]
     |     |     |  |        |        +--ro name    string
     |     |     |  |        +--ro path-srlgs-lists
     |     |     |  |        |  +--ro path-srlgs-list* [usage]
     |     |     |  |        |     +--ro usage     identityref
     |     |     |  |        |     +--ro values*   srlg
     |     |     |  |        +--ro path-srlgs-names
     |     |     |  |        |  +--ro path-srlgs-name* [usage]
     |     |     |  |        |     +--ro usage    identityref
     |     |     |  |        |     +--ro names*   string
     |     |     |  |        +--ro path-route-objects
     |     |     |  |        |  +--ro path-route-object* [index]
     |     |     |  |        |     +--ro index
     |     |     |  |        |     |       uint32
     |     |     |  |        |     +--ro (type)?
     |     |     |  |        |        +--:(numbered-node-hop)
     |     |     |  |        |        |  +--ro numbered-node-hop
     |     |     |  |        |        |     +--ro node-id
     |     |     |  |        |        |     |       te-node-id
     |     |     |  |        |        |     +--ro hop-type?
     |     |     |  |        |        |             te-hop-type
     |     |     |  |        |        +--:(numbered-link-hop)
     |     |     |  |        |        |  +--ro numbered-link-hop
     |     |     |  |        |        |     +--ro link-tp-id
     |     |     |  |        |        |     |       te-tp-id
     |     |     |  |        |        |     +--ro hop-type?
     |     |     |  |        |        |     |       te-hop-type
     |     |     |  |        |        |     +--ro direction?
     |     |     |  |        |        |             te-link-direction
     |     |     |  |        |        +--:(unnumbered-link-hop)
     |     |     |  |        |        |  +--ro unnumbered-link-hop
     |     |     |  |        |        |     +--ro link-tp-id
     |     |     |  |        |        |     |       te-tp-id
     |     |     |  |        |        |     +--ro node-id
     |     |     |  |        |        |     |       te-node-id
     |     |     |  |        |        |     +--ro hop-type?
     |     |     |  |        |        |     |       te-hop-type
     |     |     |  |        |        |     +--ro direction?
     |     |     |  |        |        |             te-link-direction
     |     |     |  |        |        +--:(as-number)
     |     |     |  |        |        |  +--ro as-number-hop
     |     |     |  |        |        |     +--ro as-number
     |     |     |  |        |        |     |       inet:as-number
     |     |     |  |        |        |     +--ro hop-type?
     |     |     |  |        |        |             te-hop-type
     |     |     |  |        |        +--:(label)
     |     |     |  |        |           +--ro label-hop
     |     |     |  |        |              +--ro te-label
     |     |     |  |        |                 +--ro (technology)?
     |     |     |  |        |                 |  +--:(generic)
     |     |     |  |        |                 |     +--ro generic?
     |     |     |  |        |                 |             rt-types:ge
neralized-label
     |     |     |  |        |                 +--ro direction?
     |     |     |  |        |                         te-label-directio
n
     |     |     |  |        +--ro te-bandwidth
     |     |     |  |        |  +--ro (technology)?
     |     |     |  |        |     +--:(generic)
     |     |     |  |        |        +--ro generic?   te-bandwidth
     |     |     |  |        +--ro disjointness-type?
     |     |     |  |                te-types:te-path-disjointness
     |     |     |  +--ro computed-path-error-infos
     |     |     |  |  +--ro computed-path-error-info* []
     |     |     |  |     +--ro error-description?   string
     |     |     |  |     +--ro error-timestamp?
     |     |     |  |     |       yang:date-and-time
     |     |     |  |     +--ro error-reason?        identityref
     |     |     |  +--ro lsp-provisioning-error-infos
     |     |     |  |  +--ro lsp-provisioning-error-info* []
     |     |     |  |     +--ro error-description?   string
     |     |     |  |     +--ro error-timestamp?
     |     |     |  |     |       yang:date-and-time
     |     |     |  |     +--ro error-node-id?
     |     |     |  |     |       te-types:te-node-id
     |     |     |  |     +--ro error-link-id?
     |     |     |  |     |       te-types:te-tp-id
     |     |     |  |     +--ro lsp-id?              uint16
     |     |     |  +--ro lsps
     |     |     |  |  +--ro lsp* [node lsp-id]
     |     |     |  |     +--ro tunnel-name?
     |     |     |  |     |       -> /te/lsps/lsp/tunnel-name
     |     |     |  |     +--ro node           -> /te/lsps/lsp/node
     |     |     |  |     +--ro lsp-id         -> /te/lsps/lsp/lsp-id
     |     |     |  +--rw candidate-secondary-reverse-paths
     |     |     |     +--rw candidate-secondary-reverse-path*
     |     |     |             [secondary-path]
     |     |     |        +--rw secondary-path    leafref
     |     |     +--rw candidate-secondary-paths
     |     |        +--rw candidate-secondary-path* [secondary-path]
     |     |           +--rw secondary-path    leafref
     |     |           +--ro active?           boolean
     |     +--rw secondary-paths
     |     |  +--rw secondary-path* [name]
     |     |     +--rw name                             string
     |     |     +--rw path-computation-method?         identityref
     |     |     +--rw path-computation-server
     |     |     |  +--rw id?     te-gen-node-id
     |     |     |  +--rw type?   enumeration
     |     |     +--rw compute-only?                    empty
     |     |     +--rw use-path-computation?            boolean
     |     |     +--rw lockdown?                        empty
     |     |     +--ro path-scope?                      identityref
     |     |     +--rw preference?                      uint8
     |     |     +--rw association-objects
     |     |     |  +--rw association-object* [association-key]
     |     |     |  |  +--rw association-key    string
     |     |     |  |  +--rw type?              identityref
     |     |     |  |  +--rw id?                uint16
     |     |     |  |  +--rw source
     |     |     |  |     +--rw id?     te-gen-node-id
     |     |     |  |     +--rw type?   enumeration
     |     |     |  +--rw association-object-extended*
     |     |     |          [association-key]
     |     |     |     +--rw association-key    string
     |     |     |     +--rw type?              identityref
     |     |     |     +--rw id?                uint16
     |     |     |     +--rw source
     |     |     |     |  +--rw id?     te-gen-node-id
     |     |     |     |  +--rw type?   enumeration
     |     |     |     +--rw global-source?     uint32
     |     |     |     +--rw extended-id?       yang:hex-string
     |     |     +--rw optimizations
     |     |     |  +--rw (algorithm)?
     |     |     |     +--:(metric) {path-optimization-metric}?
     |     |     |     |  +--rw optimization-metric* [metric-type]
     |     |     |     |  |  +--rw metric-type
     |     |     |     |  |  |       identityref
     |     |     |     |  |  +--rw weight?
     |     |     |     |  |  |       uint8
     |     |     |     |  |  +--rw explicit-route-exclude-objects
     |     |     |     |  |  |  +--rw route-object-exclude-object*
     |     |     |     |  |  |          [index]
     |     |     |     |  |  |     +--rw index
     |     |     |     |  |  |     |       uint32
     |     |     |     |  |  |     +--rw (type)?
     |     |     |     |  |  |        +--:(numbered-node-hop)
     |     |     |     |  |  |        |  +--rw numbered-node-hop
     |     |     |     |  |  |        |     +--rw node-id
     |     |     |     |  |  |        |     |       te-node-id
     |     |     |     |  |  |        |     +--rw hop-type?
     |     |     |     |  |  |        |             te-hop-type
     |     |     |     |  |  |        +--:(numbered-link-hop)
     |     |     |     |  |  |        |  +--rw numbered-link-hop
     |     |     |     |  |  |        |     +--rw link-tp-id
     |     |     |     |  |  |        |     |       te-tp-id
     |     |     |     |  |  |        |     +--rw hop-type?
     |     |     |     |  |  |        |     |       te-hop-type
     |     |     |     |  |  |        |     +--rw direction?
     |     |     |     |  |  |        |             te-link-direction
     |     |     |     |  |  |        +--:(unnumbered-link-hop)
     |     |     |     |  |  |        |  +--rw unnumbered-link-hop
     |     |     |     |  |  |        |     +--rw link-tp-id
     |     |     |     |  |  |        |     |       te-tp-id
     |     |     |     |  |  |        |     +--rw node-id
     |     |     |     |  |  |        |     |       te-node-id
     |     |     |     |  |  |        |     +--rw hop-type?
     |     |     |     |  |  |        |     |       te-hop-type
     |     |     |     |  |  |        |     +--rw direction?
     |     |     |     |  |  |        |             te-link-direction
     |     |     |     |  |  |        +--:(as-number)
     |     |     |     |  |  |        |  +--rw as-number-hop
     |     |     |     |  |  |        |     +--rw as-number
     |     |     |     |  |  |        |     |       inet:as-number
     |     |     |     |  |  |        |     +--rw hop-type?
     |     |     |     |  |  |        |             te-hop-type
     |     |     |     |  |  |        +--:(label)
     |     |     |     |  |  |        |  +--rw label-hop
     |     |     |     |  |  |        |     +--rw te-label
     |     |     |     |  |  |        |        +--rw (technology)?
     |     |     |     |  |  |        |        |  +--:(generic)
     |     |     |     |  |  |        |        |     +--rw generic?
     |     |     |     |  |  |        |        |             rt-types:ge
neralized-label
     |     |     |     |  |  |        |        +--rw direction?
     |     |     |     |  |  |        |                te-label-directio
n
     |     |     |     |  |  |        +--:(srlg)
     |     |     |     |  |  |           +--rw srlg
     |     |     |     |  |  |              +--rw srlg?   uint32
     |     |     |     |  |  +--rw explicit-route-include-objects
     |     |     |     |  |     +--rw route-object-include-object*
     |     |     |     |  |             [index]
     |     |     |     |  |        +--rw index
     |     |     |     |  |        |       uint32
     |     |     |     |  |        +--rw (type)?
     |     |     |     |  |           +--:(numbered-node-hop)
     |     |     |     |  |           |  +--rw numbered-node-hop
     |     |     |     |  |           |     +--rw node-id
     |     |     |     |  |           |     |       te-node-id
     |     |     |     |  |           |     +--rw hop-type?
     |     |     |     |  |           |             te-hop-type
     |     |     |     |  |           +--:(numbered-link-hop)
     |     |     |     |  |           |  +--rw numbered-link-hop
     |     |     |     |  |           |     +--rw link-tp-id
     |     |     |     |  |           |     |       te-tp-id
     |     |     |     |  |           |     +--rw hop-type?
     |     |     |     |  |           |     |       te-hop-type
     |     |     |     |  |           |     +--rw direction?
     |     |     |     |  |           |             te-link-direction
     |     |     |     |  |           +--:(unnumbered-link-hop)
     |     |     |     |  |           |  +--rw unnumbered-link-hop
     |     |     |     |  |           |     +--rw link-tp-id
     |     |     |     |  |           |     |       te-tp-id
     |     |     |     |  |           |     +--rw node-id
     |     |     |     |  |           |     |       te-node-id
     |     |     |     |  |           |     +--rw hop-type?
     |     |     |     |  |           |     |       te-hop-type
     |     |     |     |  |           |     +--rw direction?
     |     |     |     |  |           |             te-link-direction
     |     |     |     |  |           +--:(as-number)
     |     |     |     |  |           |  +--rw as-number-hop
     |     |     |     |  |           |     +--rw as-number
     |     |     |     |  |           |     |       inet:as-number
     |     |     |     |  |           |     +--rw hop-type?
     |     |     |     |  |           |             te-hop-type
     |     |     |     |  |           +--:(label)
     |     |     |     |  |              +--rw label-hop
     |     |     |     |  |                 +--rw te-label
     |     |     |     |  |                    +--rw (technology)?
     |     |     |     |  |                    |  +--:(generic)
     |     |     |     |  |                    |     +--rw generic?
     |     |     |     |  |                    |             rt-types:ge
neralized-label
     |     |     |     |  |                    +--rw direction?
     |     |     |     |  |                            te-label-directio
n
     |     |     |     |  +--rw tiebreakers
     |     |     |     |     +--rw tiebreaker* [tiebreaker-type]
     |     |     |     |        +--rw tiebreaker-type    identityref
     |     |     |     +--:(objective-function)
     |     |     |              {path-optimization-objective-function}?
     |     |     |        +--rw objective-function
     |     |     |           +--rw objective-function-type?
     |     |     |                   identityref
     |     |     +--rw named-path-constraint?           leafref
     |     |     |       {te-types:named-path-constraints}?
     |     |     +--rw te-bandwidth
     |     |     |  +--rw (technology)?
     |     |     |     +--:(generic)
     |     |     |        +--rw generic?   te-bandwidth
     |     |     +--rw link-protection?                 identityref
     |     |     +--rw setup-priority?                  uint8
     |     |     +--rw hold-priority?                   uint8
     |     |     +--rw signaling-type?                  identityref
     |     |     +--rw path-metric-bounds
     |     |     |  +--rw path-metric-bound* [metric-type]
     |     |     |     +--rw metric-type    identityref
     |     |     |     +--rw upper-bound?   uint64
     |     |     +--rw path-affinities-values
     |     |     |  +--rw path-affinities-value* [usage]
     |     |     |     +--rw usage    identityref
     |     |     |     +--rw value?   admin-groups
     |     |     +--rw path-affinity-names
     |     |     |  +--rw path-affinity-name* [usage]
     |     |     |     +--rw usage            identityref
     |     |     |     +--rw affinity-name* [name]
     |     |     |        +--rw name    string
     |     |     +--rw path-srlgs-lists
     |     |     |  +--rw path-srlgs-list* [usage]
     |     |     |     +--rw usage     identityref
     |     |     |     +--rw values*   srlg
     |     |     +--rw path-srlgs-names
     |     |     |  +--rw path-srlgs-name* [usage]
     |     |     |     +--rw usage    identityref
     |     |     |     +--rw names*   string
     |     |     +--rw disjointness?
     |     |     |       te-path-disjointness
     |     |     +--rw explicit-route-objects-always
     |     |     |  +--rw route-object-exclude-always* [index]
     |     |     |  |  +--rw index                        uint32
     |     |     |  |  +--rw (type)?
     |     |     |  |     +--:(numbered-node-hop)
     |     |     |  |     |  +--rw numbered-node-hop
     |     |     |  |     |     +--rw node-id     te-node-id
     |     |     |  |     |     +--rw hop-type?   te-hop-type
     |     |     |  |     +--:(numbered-link-hop)
     |     |     |  |     |  +--rw numbered-link-hop
     |     |     |  |     |     +--rw link-tp-id    te-tp-id
     |     |     |  |     |     +--rw hop-type?     te-hop-type
     |     |     |  |     |     +--rw direction?    te-link-direction
     |     |     |  |     +--:(unnumbered-link-hop)
     |     |     |  |     |  +--rw unnumbered-link-hop
     |     |     |  |     |     +--rw link-tp-id    te-tp-id
     |     |     |  |     |     +--rw node-id       te-node-id
     |     |     |  |     |     +--rw hop-type?     te-hop-type
     |     |     |  |     |     +--rw direction?    te-link-direction
     |     |     |  |     +--:(as-number)
     |     |     |  |     |  +--rw as-number-hop
     |     |     |  |     |     +--rw as-number    inet:as-number
     |     |     |  |     |     +--rw hop-type?    te-hop-type
     |     |     |  |     +--:(label)
     |     |     |  |        +--rw label-hop
     |     |     |  |           +--rw te-label
     |     |     |  |              +--rw (technology)?
     |     |     |  |              |  +--:(generic)
     |     |     |  |              |     +--rw generic?
     |     |     |  |              |             rt-types:generalized-la
bel
     |     |     |  |              +--rw direction?
     |     |     |  |                      te-label-direction
     |     |     |  +--rw route-object-include-exclude* [index]
     |     |     |     +--rw explicit-route-usage?        identityref
     |     |     |     +--rw index                        uint32
     |     |     |     +--rw (type)?
     |     |     |        +--:(numbered-node-hop)
     |     |     |        |  +--rw numbered-node-hop
     |     |     |        |     +--rw node-id     te-node-id
     |     |     |        |     +--rw hop-type?   te-hop-type
     |     |     |        +--:(numbered-link-hop)
     |     |     |        |  +--rw numbered-link-hop
     |     |     |        |     +--rw link-tp-id    te-tp-id
     |     |     |        |     +--rw hop-type?     te-hop-type
     |     |     |        |     +--rw direction?    te-link-direction
     |     |     |        +--:(unnumbered-link-hop)
     |     |     |        |  +--rw unnumbered-link-hop
     |     |     |        |     +--rw link-tp-id    te-tp-id
     |     |     |        |     +--rw node-id       te-node-id
     |     |     |        |     +--rw hop-type?     te-hop-type
     |     |     |        |     +--rw direction?    te-link-direction
     |     |     |        +--:(as-number)
     |     |     |        |  +--rw as-number-hop
     |     |     |        |     +--rw as-number    inet:as-number
     |     |     |        |     +--rw hop-type?    te-hop-type
     |     |     |        +--:(label)
     |     |     |        |  +--rw label-hop
     |     |     |        |     +--rw te-label
     |     |     |        |        +--rw (technology)?
     |     |     |        |        |  +--:(generic)
     |     |     |        |        |     +--rw generic?
     |     |     |        |        |             rt-types:generalized-la
bel
     |     |     |        |        +--rw direction?
     |     |     |        |                te-label-direction
     |     |     |        +--:(srlg)
     |     |     |           +--rw srlg
     |     |     |              +--rw srlg?   uint32
     |     |     +--rw path-in-segment!
     |     |     |  +--rw label-restrictions
     |     |     |     +--rw label-restriction* [index]
     |     |     |        +--rw restriction?    enumeration
     |     |     |        +--rw index           uint32
     |     |     |        +--rw label-start
     |     |     |        |  +--rw te-label
     |     |     |        |     +--rw (technology)?
     |     |     |        |     |  +--:(generic)
     |     |     |        |     |     +--rw generic?
     |     |     |        |     |             rt-types:generalized-label
     |     |     |        |     +--rw direction?
     |     |     |        |             te-label-direction
     |     |     |        +--rw label-end
     |     |     |        |  +--rw te-label
     |     |     |        |     +--rw (technology)?
     |     |     |        |     |  +--:(generic)
     |     |     |        |     |     +--rw generic?
     |     |     |        |     |             rt-types:generalized-label
     |     |     |        |     +--rw direction?
     |     |     |        |             te-label-direction
     |     |     |        +--rw label-step
     |     |     |        |  +--rw (technology)?
     |     |     |        |     +--:(generic)
     |     |     |        |        +--rw generic?   int32
     |     |     |        +--rw range-bitmap?   yang:hex-string
     |     |     +--rw path-out-segment!
     |     |     |  +--rw label-restrictions
     |     |     |     +--rw label-restriction* [index]
     |     |     |        +--rw restriction?    enumeration
     |     |     |        +--rw index           uint32
     |     |     |        +--rw label-start
     |     |     |        |  +--rw te-label
     |     |     |        |     +--rw (technology)?
     |     |     |        |     |  +--:(generic)
     |     |     |        |     |     +--rw generic?
     |     |     |        |     |             rt-types:generalized-label
     |     |     |        |     +--rw direction?
     |     |     |        |             te-label-direction
     |     |     |        +--rw label-end
     |     |     |        |  +--rw te-label
     |     |     |        |     +--rw (technology)?
     |     |     |        |     |  +--:(generic)
     |     |     |        |     |     +--rw generic?
     |     |     |        |     |             rt-types:generalized-label
     |     |     |        |     +--rw direction?
     |     |     |        |             te-label-direction
     |     |     |        +--rw label-step
     |     |     |        |  +--rw (technology)?
     |     |     |        |     +--:(generic)
     |     |     |        |        +--rw generic?   int32
     |     |     |        +--rw range-bitmap?   yang:hex-string
     |     |     +--rw protection
     |     |     |  +--rw enable?                         boolean
     |     |     |  +--rw protection-type?                identityref
     |     |     |  +--rw protection-reversion-disable?   boolean
     |     |     |  +--rw hold-off-time?                  uint32
     |     |     |  +--rw wait-to-revert?                 uint16
     |     |     |  +--rw aps-signal-id?                  uint8
     |     |     +--rw restoration
     |     |     |  +--rw enable?                          boolean
     |     |     |  +--rw restoration-type?
     |     |     |  |       identityref
     |     |     |  +--rw restoration-scheme?
     |     |     |  |       identityref
     |     |     |  +--rw restoration-reversion-disable?   boolean
     |     |     |  +--rw hold-off-time?                   uint32
     |     |     |  +--rw wait-to-restore?                 uint16
     |     |     |  +--rw wait-to-revert?                  uint16
     |     |     +--ro computed-paths-properties
     |     |     |  +--ro computed-path-properties* [k-index]
     |     |     |     +--ro k-index            uint8
     |     |     |     +--ro path-properties
     |     |     |        +--ro path-metric* [metric-type]
     |     |     |        |  +--ro metric-type           identityref
     |     |     |        |  +--ro accumulative-value?   uint64
     |     |     |        +--ro path-affinities-values
     |     |     |        |  +--ro path-affinities-value* [usage]
     |     |     |        |     +--ro usage    identityref
     |     |     |        |     +--ro value?   admin-groups
     |     |     |        +--ro path-affinity-names
     |     |     |        |  +--ro path-affinity-name* [usage]
     |     |     |        |     +--ro usage            identityref
     |     |     |        |     +--ro affinity-name* [name]
     |     |     |        |        +--ro name    string
     |     |     |        +--ro path-srlgs-lists
     |     |     |        |  +--ro path-srlgs-list* [usage]
     |     |     |        |     +--ro usage     identityref
     |     |     |        |     +--ro values*   srlg
     |     |     |        +--ro path-srlgs-names
     |     |     |        |  +--ro path-srlgs-name* [usage]
     |     |     |        |     +--ro usage    identityref
     |     |     |        |     +--ro names*   string
     |     |     |        +--ro path-route-objects
     |     |     |        |  +--ro path-route-object* [index]
     |     |     |        |     +--ro index
     |     |     |        |     |       uint32
     |     |     |        |     +--ro (type)?
     |     |     |        |        +--:(numbered-node-hop)
     |     |     |        |        |  +--ro numbered-node-hop
     |     |     |        |        |     +--ro node-id     te-node-id
     |     |     |        |        |     +--ro hop-type?
     |     |     |        |        |             te-hop-type
     |     |     |        |        +--:(numbered-link-hop)
     |     |     |        |        |  +--ro numbered-link-hop
     |     |     |        |        |     +--ro link-tp-id    te-tp-id
     |     |     |        |        |     +--ro hop-type?
     |     |     |        |        |     |       te-hop-type
     |     |     |        |        |     +--ro direction?
     |     |     |        |        |             te-link-direction
     |     |     |        |        +--:(unnumbered-link-hop)
     |     |     |        |        |  +--ro unnumbered-link-hop
     |     |     |        |        |     +--ro link-tp-id    te-tp-id
     |     |     |        |        |     +--ro node-id
     |     |     |        |        |     |       te-node-id
     |     |     |        |        |     +--ro hop-type?
     |     |     |        |        |     |       te-hop-type
     |     |     |        |        |     +--ro direction?
     |     |     |        |        |             te-link-direction
     |     |     |        |        +--:(as-number)
     |     |     |        |        |  +--ro as-number-hop
     |     |     |        |        |     +--ro as-number
     |     |     |        |        |     |       inet:as-number
     |     |     |        |        |     +--ro hop-type?
     |     |     |        |        |             te-hop-type
     |     |     |        |        +--:(label)
     |     |     |        |           +--ro label-hop
     |     |     |        |              +--ro te-label
     |     |     |        |                 +--ro (technology)?
     |     |     |        |                 |  +--:(generic)
     |     |     |        |                 |     +--ro generic?
     |     |     |        |                 |             rt-types:gener
alized-label
     |     |     |        |                 +--ro direction?
     |     |     |        |                         te-label-direction
     |     |     |        +--ro te-bandwidth
     |     |     |        |  +--ro (technology)?
     |     |     |        |     +--:(generic)
     |     |     |        |        +--ro generic?   te-bandwidth
     |     |     |        +--ro disjointness-type?
     |     |     |                te-types:te-path-disjointness
     |     |     +--ro computed-path-error-infos
     |     |     |  +--ro computed-path-error-info* []
     |     |     |     +--ro error-description?   string
     |     |     |     +--ro error-timestamp?     yang:date-and-time
     |     |     |     +--ro error-reason?        identityref
     |     |     +--ro lsp-provisioning-error-infos
     |     |     |  +--ro lsp-provisioning-error-info* []
     |     |     |     +--ro error-description?   string
     |     |     |     +--ro error-timestamp?     yang:date-and-time
     |     |     |     +--ro error-node-id?       te-types:te-node-id
     |     |     |     +--ro error-link-id?       te-types:te-tp-id
     |     |     |     +--ro lsp-id?              uint16
     |     |     +--ro lsps
     |     |        +--ro lsp* [node lsp-id]
     |     |           +--ro tunnel-name?
     |     |           |       -> /te/lsps/lsp/tunnel-name
     |     |           +--ro node           -> /te/lsps/lsp/node
     |     |           +--ro lsp-id         -> /te/lsps/lsp/lsp-id
     |     +--rw secondary-reverse-paths
     |     |  +--rw secondary-reverse-path* [name]
     |     |     +--rw name                             string
     |     |     +--rw path-computation-method?         identityref
     |     |     +--rw path-computation-server
     |     |     |  +--rw id?     te-gen-node-id
     |     |     |  +--rw type?   enumeration
     |     |     +--rw compute-only?                    empty
     |     |     +--rw use-path-computation?            boolean
     |     |     +--rw lockdown?                        empty
     |     |     +--ro path-scope?                      identityref
     |     |     +--rw preference?                      uint8
     |     |     +--rw association-objects
     |     |     |  +--rw association-object* [association-key]
     |     |     |  |  +--rw association-key    string
     |     |     |  |  +--rw type?              identityref
     |     |     |  |  +--rw id?                uint16
     |     |     |  |  +--rw source
     |     |     |  |     +--rw id?     te-gen-node-id
     |     |     |  |     +--rw type?   enumeration
     |     |     |  +--rw association-object-extended*
     |     |     |          [association-key]
     |     |     |     +--rw association-key    string
     |     |     |     +--rw type?              identityref
     |     |     |     +--rw id?                uint16
     |     |     |     +--rw source
     |     |     |     |  +--rw id?     te-gen-node-id
     |     |     |     |  +--rw type?   enumeration
     |     |     |     +--rw global-source?     uint32
     |     |     |     +--rw extended-id?       yang:hex-string
     |     |     +--rw optimizations
     |     |     |  +--rw (algorithm)?
     |     |     |     +--:(metric) {path-optimization-metric}?
     |     |     |     |  +--rw optimization-metric* [metric-type]
     |     |     |     |  |  +--rw metric-type
     |     |     |     |  |  |       identityref
     |     |     |     |  |  +--rw weight?
     |     |     |     |  |  |       uint8
     |     |     |     |  |  +--rw explicit-route-exclude-objects
     |     |     |     |  |  |  +--rw route-object-exclude-object*
     |     |     |     |  |  |          [index]
     |     |     |     |  |  |     +--rw index
     |     |     |     |  |  |     |       uint32
     |     |     |     |  |  |     +--rw (type)?
     |     |     |     |  |  |        +--:(numbered-node-hop)
     |     |     |     |  |  |        |  +--rw numbered-node-hop
     |     |     |     |  |  |        |     +--rw node-id
     |     |     |     |  |  |        |     |       te-node-id
     |     |     |     |  |  |        |     +--rw hop-type?
     |     |     |     |  |  |        |             te-hop-type
     |     |     |     |  |  |        +--:(numbered-link-hop)
     |     |     |     |  |  |        |  +--rw numbered-link-hop
     |     |     |     |  |  |        |     +--rw link-tp-id
     |     |     |     |  |  |        |     |       te-tp-id
     |     |     |     |  |  |        |     +--rw hop-type?
     |     |     |     |  |  |        |     |       te-hop-type
     |     |     |     |  |  |        |     +--rw direction?
     |     |     |     |  |  |        |             te-link-direction
     |     |     |     |  |  |        +--:(unnumbered-link-hop)
     |     |     |     |  |  |        |  +--rw unnumbered-link-hop
     |     |     |     |  |  |        |     +--rw link-tp-id
     |     |     |     |  |  |        |     |       te-tp-id
     |     |     |     |  |  |        |     +--rw node-id
     |     |     |     |  |  |        |     |       te-node-id
     |     |     |     |  |  |        |     +--rw hop-type?
     |     |     |     |  |  |        |     |       te-hop-type
     |     |     |     |  |  |        |     +--rw direction?
     |     |     |     |  |  |        |             te-link-direction
     |     |     |     |  |  |        +--:(as-number)
     |     |     |     |  |  |        |  +--rw as-number-hop
     |     |     |     |  |  |        |     +--rw as-number
     |     |     |     |  |  |        |     |       inet:as-number
     |     |     |     |  |  |        |     +--rw hop-type?
     |     |     |     |  |  |        |             te-hop-type
     |     |     |     |  |  |        +--:(label)
     |     |     |     |  |  |        |  +--rw label-hop
     |     |     |     |  |  |        |     +--rw te-label
     |     |     |     |  |  |        |        +--rw (technology)?
     |     |     |     |  |  |        |        |  +--:(generic)
     |     |     |     |  |  |        |        |     +--rw generic?
     |     |     |     |  |  |        |        |             rt-types:ge
neralized-label
     |     |     |     |  |  |        |        +--rw direction?
     |     |     |     |  |  |        |                te-label-directio
n
     |     |     |     |  |  |        +--:(srlg)
     |     |     |     |  |  |           +--rw srlg
     |     |     |     |  |  |              +--rw srlg?   uint32
     |     |     |     |  |  +--rw explicit-route-include-objects
     |     |     |     |  |     +--rw route-object-include-object*
     |     |     |     |  |             [index]
     |     |     |     |  |        +--rw index
     |     |     |     |  |        |       uint32
     |     |     |     |  |        +--rw (type)?
     |     |     |     |  |           +--:(numbered-node-hop)
     |     |     |     |  |           |  +--rw numbered-node-hop
     |     |     |     |  |           |     +--rw node-id
     |     |     |     |  |           |     |       te-node-id
     |     |     |     |  |           |     +--rw hop-type?
     |     |     |     |  |           |             te-hop-type
     |     |     |     |  |           +--:(numbered-link-hop)
     |     |     |     |  |           |  +--rw numbered-link-hop
     |     |     |     |  |           |     +--rw link-tp-id
     |     |     |     |  |           |     |       te-tp-id
     |     |     |     |  |           |     +--rw hop-type?
     |     |     |     |  |           |     |       te-hop-type
     |     |     |     |  |           |     +--rw direction?
     |     |     |     |  |           |             te-link-direction
     |     |     |     |  |           +--:(unnumbered-link-hop)
     |     |     |     |  |           |  +--rw unnumbered-link-hop
     |     |     |     |  |           |     +--rw link-tp-id
     |     |     |     |  |           |     |       te-tp-id
     |     |     |     |  |           |     +--rw node-id
     |     |     |     |  |           |     |       te-node-id
     |     |     |     |  |           |     +--rw hop-type?
     |     |     |     |  |           |     |       te-hop-type
     |     |     |     |  |           |     +--rw direction?
     |     |     |     |  |           |             te-link-direction
     |     |     |     |  |           +--:(as-number)
     |     |     |     |  |           |  +--rw as-number-hop
     |     |     |     |  |           |     +--rw as-number
     |     |     |     |  |           |     |       inet:as-number
     |     |     |     |  |           |     +--rw hop-type?
     |     |     |     |  |           |             te-hop-type
     |     |     |     |  |           +--:(label)
     |     |     |     |  |              +--rw label-hop
     |     |     |     |  |                 +--rw te-label
     |     |     |     |  |                    +--rw (technology)?
     |     |     |     |  |                    |  +--:(generic)
     |     |     |     |  |                    |     +--rw generic?
     |     |     |     |  |                    |             rt-types:ge
neralized-label
     |     |     |     |  |                    +--rw direction?
     |     |     |     |  |                            te-label-directio
n
     |     |     |     |  +--rw tiebreakers
     |     |     |     |     +--rw tiebreaker* [tiebreaker-type]
     |     |     |     |        +--rw tiebreaker-type    identityref
     |     |     |     +--:(objective-function)
     |     |     |              {path-optimization-objective-function}?
     |     |     |        +--rw objective-function
     |     |     |           +--rw objective-function-type?
     |     |     |                   identityref
     |     |     +--rw named-path-constraint?           leafref
     |     |     |       {te-types:named-path-constraints}?
     |     |     +--rw te-bandwidth
     |     |     |  +--rw (technology)?
     |     |     |     +--:(generic)
     |     |     |        +--rw generic?   te-bandwidth
     |     |     +--rw link-protection?                 identityref
     |     |     +--rw setup-priority?                  uint8
     |     |     +--rw hold-priority?                   uint8
     |     |     +--rw signaling-type?                  identityref
     |     |     +--rw path-metric-bounds
     |     |     |  +--rw path-metric-bound* [metric-type]
     |     |     |     +--rw metric-type    identityref
     |     |     |     +--rw upper-bound?   uint64
     |     |     +--rw path-affinities-values
     |     |     |  +--rw path-affinities-value* [usage]
     |     |     |     +--rw usage    identityref
     |     |     |     +--rw value?   admin-groups
     |     |     +--rw path-affinity-names
     |     |     |  +--rw path-affinity-name* [usage]
     |     |     |     +--rw usage            identityref
     |     |     |     +--rw affinity-name* [name]
     |     |     |        +--rw name    string
     |     |     +--rw path-srlgs-lists
     |     |     |  +--rw path-srlgs-list* [usage]
     |     |     |     +--rw usage     identityref
     |     |     |     +--rw values*   srlg
     |     |     +--rw path-srlgs-names
     |     |     |  +--rw path-srlgs-name* [usage]
     |     |     |     +--rw usage    identityref
     |     |     |     +--rw names*   string
     |     |     +--rw disjointness?
     |     |     |       te-path-disjointness
     |     |     +--rw explicit-route-objects-always
     |     |     |  +--rw route-object-exclude-always* [index]
     |     |     |  |  +--rw index                        uint32
     |     |     |  |  +--rw (type)?
     |     |     |  |     +--:(numbered-node-hop)
     |     |     |  |     |  +--rw numbered-node-hop
     |     |     |  |     |     +--rw node-id     te-node-id
     |     |     |  |     |     +--rw hop-type?   te-hop-type
     |     |     |  |     +--:(numbered-link-hop)
     |     |     |  |     |  +--rw numbered-link-hop
     |     |     |  |     |     +--rw link-tp-id    te-tp-id
     |     |     |  |     |     +--rw hop-type?     te-hop-type
     |     |     |  |     |     +--rw direction?    te-link-direction
     |     |     |  |     +--:(unnumbered-link-hop)
     |     |     |  |     |  +--rw unnumbered-link-hop
     |     |     |  |     |     +--rw link-tp-id    te-tp-id
     |     |     |  |     |     +--rw node-id       te-node-id
     |     |     |  |     |     +--rw hop-type?     te-hop-type
     |     |     |  |     |     +--rw direction?    te-link-direction
     |     |     |  |     +--:(as-number)
     |     |     |  |     |  +--rw as-number-hop
     |     |     |  |     |     +--rw as-number    inet:as-number
     |     |     |  |     |     +--rw hop-type?    te-hop-type
     |     |     |  |     +--:(label)
     |     |     |  |        +--rw label-hop
     |     |     |  |           +--rw te-label
     |     |     |  |              +--rw (technology)?
     |     |     |  |              |  +--:(generic)
     |     |     |  |              |     +--rw generic?
     |     |     |  |              |             rt-types:generalized-la
bel
     |     |     |  |              +--rw direction?
     |     |     |  |                      te-label-direction
     |     |     |  +--rw route-object-include-exclude* [index]
     |     |     |     +--rw explicit-route-usage?        identityref
     |     |     |     +--rw index                        uint32
     |     |     |     +--rw (type)?
     |     |     |        +--:(numbered-node-hop)
     |     |     |        |  +--rw numbered-node-hop
     |     |     |        |     +--rw node-id     te-node-id
     |     |     |        |     +--rw hop-type?   te-hop-type
     |     |     |        +--:(numbered-link-hop)
     |     |     |        |  +--rw numbered-link-hop
     |     |     |        |     +--rw link-tp-id    te-tp-id
     |     |     |        |     +--rw hop-type?     te-hop-type
     |     |     |        |     +--rw direction?    te-link-direction
     |     |     |        +--:(unnumbered-link-hop)
     |     |     |        |  +--rw unnumbered-link-hop
     |     |     |        |     +--rw link-tp-id    te-tp-id
     |     |     |        |     +--rw node-id       te-node-id
     |     |     |        |     +--rw hop-type?     te-hop-type
     |     |     |        |     +--rw direction?    te-link-direction
     |     |     |        +--:(as-number)
     |     |     |        |  +--rw as-number-hop
     |     |     |        |     +--rw as-number    inet:as-number
     |     |     |        |     +--rw hop-type?    te-hop-type
     |     |     |        +--:(label)
     |     |     |        |  +--rw label-hop
     |     |     |        |     +--rw te-label
     |     |     |        |        +--rw (technology)?
     |     |     |        |        |  +--:(generic)
     |     |     |        |        |     +--rw generic?
     |     |     |        |        |             rt-types:generalized-la
bel
     |     |     |        |        +--rw direction?
     |     |     |        |                te-label-direction
     |     |     |        +--:(srlg)
     |     |     |           +--rw srlg
     |     |     |              +--rw srlg?   uint32
     |     |     +--rw path-in-segment!
     |     |     |  +--rw label-restrictions
     |     |     |     +--rw label-restriction* [index]
     |     |     |        +--rw restriction?    enumeration
     |     |     |        +--rw index           uint32
     |     |     |        +--rw label-start
     |     |     |        |  +--rw te-label
     |     |     |        |     +--rw (technology)?
     |     |     |        |     |  +--:(generic)
     |     |     |        |     |     +--rw generic?
     |     |     |        |     |             rt-types:generalized-label
     |     |     |        |     +--rw direction?
     |     |     |        |             te-label-direction
     |     |     |        +--rw label-end
     |     |     |        |  +--rw te-label
     |     |     |        |     +--rw (technology)?
     |     |     |        |     |  +--:(generic)
     |     |     |        |     |     +--rw generic?
     |     |     |        |     |             rt-types:generalized-label
     |     |     |        |     +--rw direction?
     |     |     |        |             te-label-direction
     |     |     |        +--rw label-step
     |     |     |        |  +--rw (technology)?
     |     |     |        |     +--:(generic)
     |     |     |        |        +--rw generic?   int32
     |     |     |        +--rw range-bitmap?   yang:hex-string
     |     |     +--rw path-out-segment!
     |     |     |  +--rw label-restrictions
     |     |     |     +--rw label-restriction* [index]
     |     |     |        +--rw restriction?    enumeration
     |     |     |        +--rw index           uint32
     |     |     |        +--rw label-start
     |     |     |        |  +--rw te-label
     |     |     |        |     +--rw (technology)?
     |     |     |        |     |  +--:(generic)
     |     |     |        |     |     +--rw generic?
     |     |     |        |     |             rt-types:generalized-label
     |     |     |        |     +--rw direction?
     |     |     |        |             te-label-direction
     |     |     |        +--rw label-end
     |     |     |        |  +--rw te-label
     |     |     |        |     +--rw (technology)?
     |     |     |        |     |  +--:(generic)
     |     |     |        |     |     +--rw generic?
     |     |     |        |     |             rt-types:generalized-label
     |     |     |        |     +--rw direction?
     |     |     |        |             te-label-direction
     |     |     |        +--rw label-step
     |     |     |        |  +--rw (technology)?
     |     |     |        |     +--:(generic)
     |     |     |        |        +--rw generic?   int32
     |     |     |        +--rw range-bitmap?   yang:hex-string
     |     |     +--rw protection
     |     |     |  +--rw enable?                         boolean
     |     |     |  +--rw protection-type?                identityref
     |     |     |  +--rw protection-reversion-disable?   boolean
     |     |     |  +--rw hold-off-time?                  uint32
     |     |     |  +--rw wait-to-revert?                 uint16
     |     |     |  +--rw aps-signal-id?                  uint8
     |     |     +--rw restoration
     |     |     |  +--rw enable?                          boolean
     |     |     |  +--rw restoration-type?
     |     |     |  |       identityref
     |     |     |  +--rw restoration-scheme?
     |     |     |  |       identityref
     |     |     |  +--rw restoration-reversion-disable?   boolean
     |     |     |  +--rw hold-off-time?                   uint32
     |     |     |  +--rw wait-to-restore?                 uint16
     |     |     |  +--rw wait-to-revert?                  uint16
     |     |     +--ro computed-paths-properties
     |     |     |  +--ro computed-path-properties* [k-index]
     |     |     |     +--ro k-index            uint8
     |     |     |     +--ro path-properties
     |     |     |        +--ro path-metric* [metric-type]
     |     |     |        |  +--ro metric-type           identityref
     |     |     |        |  +--ro accumulative-value?   uint64
     |     |     |        +--ro path-affinities-values
     |     |     |        |  +--ro path-affinities-value* [usage]
     |     |     |        |     +--ro usage    identityref
     |     |     |        |     +--ro value?   admin-groups
     |     |     |        +--ro path-affinity-names
     |     |     |        |  +--ro path-affinity-name* [usage]
     |     |     |        |     +--ro usage            identityref
     |     |     |        |     +--ro affinity-name* [name]
     |     |     |        |        +--ro name    string
     |     |     |        +--ro path-srlgs-lists
     |     |     |        |  +--ro path-srlgs-list* [usage]
     |     |     |        |     +--ro usage     identityref
     |     |     |        |     +--ro values*   srlg
     |     |     |        +--ro path-srlgs-names
     |     |     |        |  +--ro path-srlgs-name* [usage]
     |     |     |        |     +--ro usage    identityref
     |     |     |        |     +--ro names*   string
     |     |     |        +--ro path-route-objects
     |     |     |        |  +--ro path-route-object* [index]
     |     |     |        |     +--ro index
     |     |     |        |     |       uint32
     |     |     |        |     +--ro (type)?
     |     |     |        |        +--:(numbered-node-hop)
     |     |     |        |        |  +--ro numbered-node-hop
     |     |     |        |        |     +--ro node-id     te-node-id
     |     |     |        |        |     +--ro hop-type?
     |     |     |        |        |             te-hop-type
     |     |     |        |        +--:(numbered-link-hop)
     |     |     |        |        |  +--ro numbered-link-hop
     |     |     |        |        |     +--ro link-tp-id    te-tp-id
     |     |     |        |        |     +--ro hop-type?
     |     |     |        |        |     |       te-hop-type
     |     |     |        |        |     +--ro direction?
     |     |     |        |        |             te-link-direction
     |     |     |        |        +--:(unnumbered-link-hop)
     |     |     |        |        |  +--ro unnumbered-link-hop
     |     |     |        |        |     +--ro link-tp-id    te-tp-id
     |     |     |        |        |     +--ro node-id
     |     |     |        |        |     |       te-node-id
     |     |     |        |        |     +--ro hop-type?
     |     |     |        |        |     |       te-hop-type
     |     |     |        |        |     +--ro direction?
     |     |     |        |        |             te-link-direction
     |     |     |        |        +--:(as-number)
     |     |     |        |        |  +--ro as-number-hop
     |     |     |        |        |     +--ro as-number
     |     |     |        |        |     |       inet:as-number
     |     |     |        |        |     +--ro hop-type?
     |     |     |        |        |             te-hop-type
     |     |     |        |        +--:(label)
     |     |     |        |           +--ro label-hop
     |     |     |        |              +--ro te-label
     |     |     |        |                 +--ro (technology)?
     |     |     |        |                 |  +--:(generic)
     |     |     |        |                 |     +--ro generic?
     |     |     |        |                 |             rt-types:gener
alized-label
     |     |     |        |                 +--ro direction?
     |     |     |        |                         te-label-direction
     |     |     |        +--ro te-bandwidth
     |     |     |        |  +--ro (technology)?
     |     |     |        |     +--:(generic)
     |     |     |        |        +--ro generic?   te-bandwidth
     |     |     |        +--ro disjointness-type?
     |     |     |                te-types:te-path-disjointness
     |     |     +--ro computed-path-error-infos
     |     |     |  +--ro computed-path-error-info* []
     |     |     |     +--ro error-description?   string
     |     |     |     +--ro error-timestamp?     yang:date-and-time
     |     |     |     +--ro error-reason?        identityref
     |     |     +--ro lsp-provisioning-error-infos
     |     |     |  +--ro lsp-provisioning-error-info* []
     |     |     |     +--ro error-description?   string
     |     |     |     +--ro error-timestamp?     yang:date-and-time
     |     |     |     +--ro error-node-id?       te-types:te-node-id
     |     |     |     +--ro error-link-id?       te-types:te-tp-id
     |     |     |     +--ro lsp-id?              uint16
     |     |     +--ro lsps
     |     |        +--ro lsp* [node lsp-id]
     |     |           +--ro tunnel-name?
     |     |           |       -> /te/lsps/lsp/tunnel-name
     |     |           +--ro node           -> /te/lsps/lsp/node
     |     |           +--ro lsp-id         -> /te/lsps/lsp/lsp-id
     |     +---x tunnel-action
     |     |  +---w input
     |     |  |  +---w action-type?   identityref
     |     |  +--ro output
     |     |     +--ro action-result?   identityref
     |     +---x protection-external-commands
     |        +---w input
     |           +---w protection-external-command?
     |           |       identityref
     |           +---w protection-group-ingress-node-id?
     |           |       te-types:te-node-id
     |           +---w protection-group-egress-node-id?
     |           |       te-types:te-node-id
     |           +---w path-ref?                           path-ref
     |           +---w traffic-type?
     |           |       enumeration
     |           +---w extra-traffic-tunnel-ref?           tunnel-ref
     +--ro lsps
        +--ro lsp* [tunnel-name lsp-id node]
           +--ro tunnel-name                         string
           +--ro lsp-id                              uint16
           +--ro node
           |       te-types:te-node-id
           +--ro source?
           |       te-types:te-node-id
           +--ro destination?
           |       te-types:te-node-id
           +--ro tunnel-id?                          uint16
           +--ro extended-tunnel-id?                 yang:dotted-quad
           +--ro operational-state?                  identityref
           +--ro signaling-type?                     identityref
           +--ro origin-type?                        enumeration
           +--ro lsp-resource-status?                enumeration
           +--ro lockout-of-normal?                  boolean
           +--ro freeze?                             boolean
           +--ro lsp-protection-role?                enumeration
           +--ro lsp-protection-state?               identityref
           +--ro protection-group-ingress-node-id?
           |       te-types:te-node-id
           +--ro protection-group-egress-node-id?
           |       te-types:te-node-id
           +--ro lsp-record-route-information
              +--ro lsp-record-route-information* [index]
                 +--ro index                        uint32
                 +--ro (type)?
                    +--:(numbered-node-hop)
                    |  +--ro numbered-node-hop
                    |     +--ro node-id    te-node-id
                    |     +--ro flags*     path-attribute-flags
                    +--:(numbered-link-hop)
                    |  +--ro numbered-link-hop
                    |     +--ro link-tp-id    te-tp-id
                    |     +--ro flags*        path-attribute-flags
                    +--:(unnumbered-link-hop)
                    |  +--ro unnumbered-link-hop
                    |     +--ro link-tp-id    te-tp-id
                    |     +--ro node-id?      te-node-id
                    |     +--ro flags*        path-attribute-flags
                    +--:(label)
                       +--ro label-hop
                          +--ro te-label
                          |  +--ro (technology)?
                          |  |  +--:(generic)
                          |  |     +--ro generic?
                          |  |             rt-types:generalized-label
                          |  +--ro direction?
                          |          te-label-direction
                          +--ro flags*      path-attribute-flags

  rpcs:
    +---x tunnels-path-compute
    |  +---w input
    |  |  +---w path-compute-info
    |  +--ro output
    |     +--ro path-compute-result
    +---x tunnels-actions
       +---w input
       |  +---w tunnel-info
       |  |  +---w (filter-type)
       |  |     +--:(all-tunnels)
       |  |     |  +---w all       empty
       |  |     +--:(one-tunnel)
       |  |        +---w tunnel?   tunnel-ref
       |  +---w action-info
       |     +---w action?       identityref
       |     +---w disruptive?   empty
       +--ro output
          +--ro action-result?   identityref

]]></artwork></figure>

</section>
<section anchor="yang-module" title="YANG Module">

<t>The generic TE YANG module ‘ietf-te’ imports the following modules:</t>

<t><list style="symbols">
  <t>ietf-yang-types and ietf-inet-types defined in <xref target="RFC6991"/></t>
  <t>ietf-te-types defined in <xref target="RFC8776"/></t>
</list></t>

<t>This module references the following documents:
<xref target="RFC6991"/>, <xref target="RFC4875"/>, <xref target="RFC7551"/>, <xref target="RFC4206"/>, <xref target="RFC4427"/>,
<xref target="RFC4872"/>, <xref target="RFC3945"/>, <xref target="RFC3209"/>, <xref target="RFC6780"/>, <xref target="RFC8800"/>, and
<xref target="RFC7308"/>.</t>

<figure title="TE Tunnel data model YANG module" anchor="fig-basic-te"><artwork><![CDATA[
<CODE BEGINS> file "ietf-te@2021-10-22.yang"
module ietf-te {
  yang-version 1.1;
  namespace "urn:ietf:params:xml:ns:yang:ietf-te";

  /* Replace with IANA when assigned */

  prefix te;

  /* Import TE generic types */

  import ietf-te-types {
    prefix te-types;
    reference
      "RFC8776: Common YANG Data Types for Traffic Engineering.";
  }
  import ietf-inet-types {
    prefix inet;
    reference
      "RFC6991: Common YANG Data Types.";
  }
  import ietf-yang-types {
    prefix yang;
    reference
      "RFC6991: Common YANG Data Types.";
  }

  organization
    "IETF Traffic Engineering Architecture and Signaling (TEAS)
     Working Group.";
  contact
    "WG Web:   <http://tools.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:   Himanshu Shah
               <mailto:hshah@ciena.com>

     Editor:   Xufeng Liu
               <mailto: xufeng.liu.ietf@gmail.com>

     Editor:   Igor Bryskin
               <mailto:i_bryskin@yahoo.com>";
  description
    "YANG data module for TE configuration, state, and RPCs.
     The model fully conforms to the Network Management
     Datastore Architecture (NMDA).

     Copyright (c) 2019 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.";

  // RFC Ed.: replace XXXX with actual RFC number and remove this
  // note.
  // RFC Ed.: update the date below with the date of RFC publication
  // and remove this note.

  revision 2021-10-22 {
    description
      "Latest update to TE generic YANG module.";
    reference
      "RFCXXXX: A YANG Data Model for Traffic Engineering Tunnels
       and Interfaces.";
  }

  identity path-computation-error-reason {
    description
      "Base identity for path computation error reasons.";
  }

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

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

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

  identity path-computation-error-no-inclusion-hop {
    base path-computation-error-reason;
    description
      "Path computation has failed because there is no
       node or link provided by one or more inclusion hops.";
    reference
      "RFC8685";
  }

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

  identity path-computation-error-no-resource {
    base path-computation-error-reason;
    description
      "Path computation has failed because there is no
       available resource in one or more domains.";
    reference
      "RFC8685";
  }

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

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

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

  identity path-computation-error-no-gco-migration {
    base path-computation-error-reason;
    description
      "Path computation has failed because of no Global Concurrent
       Optimization (GCO) migration path found.";
    reference
      "RFC5557";
  }

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

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

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

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

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

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

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

  identity tunnel-actions-type {
    description
      "TE tunnel actions type.";
  }

  identity tunnel-action-reoptimize {
    base tunnel-actions-type;
    description
      "Reoptimize tunnel action type.";
  }

  identity tunnel-admin-auto {
    base te-types:tunnel-admin-state-type;
    description
      "Tunnel administrative auto state. The administrative status
       in state datastore transitions to 'tunnel-admin-up' when the
       tunnel used by the client layer, and to 'tunnel-admin-down'
       when it is not used by the client layer.";
  }

  identity association-type-diversity {
    base te-types:association-type;
    description
      "Association Type diversity used to associate LSPs whose paths
       are to be diverse from each other.";
    reference
      "RFC8800";
  }

  identity protocol-origin-type {
    description
      "Base identity for protocol origin type.";
  }
  identity protocol-origin-api {
    base protocol-origin-type;
    description
      "Protocol origin is via Application Programmable Interface
       (API).";
  }
  identity protocol-origin-pcep {
    base protocol-origin-type;
    description
      "Protocol origin is Path Computation Engine Protocol (PCEP).";
    reference "RFC5440";
  }
  identity protocol-origin-bgp {
    base protocol-origin-type;
    description
      "Protocol origin is Border Gateway Protocol (BGP).";
    reference "RFC5512";
  }

  typedef tunnel-ref {
    type leafref {
      path "/te:te/te:tunnels/te:tunnel/te:name";
    }
    description
      "This type is used by data models that need to reference
       configured TE tunnel.";
  }

  typedef path-ref {
    type union {
      type leafref {
        path "/te:te/te:tunnels/te:tunnel/"
           + "te:primary-paths/te:primary-path/te:name";
      }
      type leafref {
        path "/te:te/te:tunnels/te:tunnel/"
           + "te:secondary-paths/te:secondary-path/te:name";
      }
    }
    description
      "This type is used by data models that need to reference
       configured primary or secondary path of a TE tunnel.";
  }

  typedef te-gen-node-id {
    type union {
      type te-types:te-node-id;
      type inet:ip-address;
    }
    description
      "Generic type that identifies a node in a TE topology.";
  }

  /**
   * TE tunnel generic groupings
   */

  grouping te-generic-node-id {
    description
      "A reusable grouping for a TE generic node identifier.";
    leaf id {
      type te-gen-node-id;
      description
        "The identifier of the node. Can be represented as IP
         address or dotted quad address.";
    }
    leaf type {
      type enumeration {
        enum ip {
          description
            "IP address representation of the node identifier.";
        }
        enum dotted-quad {
          description
            "Dotted quad address representation of the node
             identifier.";
        }
      }
      description
        "Type of node identifier representation.";
    }
  }

  grouping primary-path {
    description
      "The tunnel primary path properties.";
    uses path-common-properties;
    uses path-preference;
    uses k-requested-paths;
    uses path-compute-info;
    uses path-state;
  }

  grouping primary-reverse-path {
    description
      "The tunnel primary reverse path properties.";
    reference
      "RFC7551";
    uses path-common-properties;
    uses path-compute-info;
    uses path-state;
  }

  grouping secondary-path {
    description
      "The tunnel secondary path properties.";
    uses path-common-properties;
    uses path-preference;
    uses path-compute-info;
    uses protection-restoration-properties;
    uses path-state;
  }

  grouping secondary-reverse-path {
    description
      "The tunnel secondary reverse path properties.";
    uses path-common-properties;
    uses path-preference;
    uses path-compute-info;
    uses protection-restoration-properties;
    uses path-state;
  }

  grouping path-common-properties {
    description
      "Common path attributes.";
    leaf name {
      type string;
      description
        "TE path name.";
    }
    leaf path-computation-method {
      type identityref {
        base te-types:path-computation-method;
      }
      default "te-types:path-locally-computed";
      description
        "The method used for computing the path, either
         locally computed, queried from a server or not
         computed at all (explicitly configured).";
    }
    container path-computation-server {
      when "derived-from-or-self(../path-computation-method, "
         + "'te-types:path-externally-queried')" {
        description
          "The path-computation server when the path is
           externally queried.";
      }
      uses te-generic-node-id;
      description
        "Address of the external path computation
         server.";
    }
    leaf compute-only {
      type empty;
      description
        "When set, the path is computed and updated whenever
         the topology is updated. No resources are committed
         or reserved in the network.";
    }
    leaf use-path-computation {
      when "derived-from-or-self(../path-computation-method, "
         + "'te-types:path-locally-computed')";
      type boolean;
      default "true";
      description
        "When 'true' indicates the path is dynamically computed
         and/or validated against the Traffic-Engineering Database
         (TED), and when 'false' indicates no validation against
         the TED is required.";
    }
    leaf lockdown {
      type empty;
      description
        "Indicates no reoptimization to be attempted for this path.";
    }
    leaf path-scope {
      type identityref {
        base te-types:path-scope-type;
      }
      default "te-types:path-scope-end-to-end";
      config false;
      description
        "Path scope if segment or an end-to-end path.";
    }
  }

  /* This grouping will be re-used in path-computation rpc */

  grouping path-compute-info {
    description
      "Attributes used for path computation request.";
    uses tunnel-associations-properties;
    uses te-types:generic-path-optimization;
    leaf named-path-constraint {
      if-feature "te-types:named-path-constraints";
      type leafref {
        path "/te:te/te:globals/te:named-path-constraints/"
           + "te:named-path-constraint/te:name";
      }
      description
        "Reference to a globally defined named path constraint set.";
    }
    uses path-constraints-common;
  }

  /* This grouping will be re-used in path-computation rpc */

  grouping path-preference {
    description
      "The path preference.";
    leaf preference {
      type uint8 {
        range "1..255";
      }
      default "1";
      description
        "Specifies a preference for this path. The lower the number
         higher the preference.";
    }
  }

  /* This grouping will be re-used in path-computation rpc */

  grouping k-requested-paths {
    description
      "The k-shortest paths requests.";
    leaf k-requested-paths {
      type uint8;
      default "1";
      description
        "The number of k-shortest-paths requested from the path
         computation server and returned sorted by its optimization
         objective. The value 0 all possible paths.";
    }
  }

  grouping path-properties {
    description
      "TE computed path properties grouping.";
    uses te-types:generic-path-properties {
      augment "path-properties" {
        description
          "additional path properties returned by path computation.";
        uses te-types:te-bandwidth;
        leaf disjointness-type {
          type te-types:te-path-disjointness;
          config false;
          description
            "The type of resource disjointness.
             When reported for a primary path, it represents the
             minimum level of disjointness of all the secondary
             paths.
             When reported for a secondary path, it represents the
             disjointness of the secondary path.";
        }
      }
    }
  }

  grouping path-state {
    description
      "TE per path state parameters.";
    uses path-computation-response;
    uses lsp-provisioning-error-info {
      augment "lsp-provisioning-error-infos/"
            + "lsp-provisioning-error-info" {
        description
          "Augmentation of LSP provisioning information under a
           specific path.";
        leaf lsp-id {
          type uint16;
          description
            "The LSP-ID for which path computation was performed.";
        }
      }
    }
    container lsps {
      config false;
      description
        "The TE LSPs container.";
      list lsp {
        key "node lsp-id";
        description
          "List of LSPs associated with the tunnel.";
        leaf tunnel-name {
          type leafref {
            path "/te:te/te:lsps/te:lsp/te:tunnel-name";
          }
          description "TE tunnel name.";
        }
        leaf node {
          type leafref {
            path "/te:te/te:lsps/te:lsp/te:node";
          }
          description "The node where the LSP state resides on.";
        }
        leaf lsp-id {
          type leafref {
            path "/te:te/te:lsps/te:lsp/te:lsp-id";
          }
          description "The TE LSP identifier.";
        }
      }
    }
  }

  /* This grouping will be re-used in path-computation rpc */

  grouping path-computation-response {
    description
      "Attributes reported by path computation response.";
    container computed-paths-properties {
      config false;
      description
        "Computed path properties container.";
      list computed-path-properties {
        key "k-index";
        description
          "List of computed paths.";
        leaf k-index {
          type uint8;
          description
            "The k-th path returned from the computation server.
             A lower k value path is more optimal than higher k
             value path(s)";
        }
        uses path-properties {
          description
            "The TE path computed properties.";
        }
      }
    }
    container computed-path-error-infos {
      config false;
      description
        "Path computation information container.";
      list computed-path-error-info {
        description
          "List of path computation info entries.";
        leaf error-description {
          type string;
          description
            "Textual representation of the error occurred during
             path computation.";
        }
        leaf error-timestamp {
          type yang:date-and-time;
          description
            "Timestamp of last path computation attempt.";
        }
        leaf error-reason {
          type identityref {
            base path-computation-error-reason;
          }
          description
            "Reason for the path computation error.";
        }
      }
    }
  }

  grouping lsp-provisioning-error-info {
    description
      "Grouping for LSP provisioning error information.";
    container lsp-provisioning-error-infos {
      config false;
      description
        "LSP provisioning error information.";
      list lsp-provisioning-error-info {
        description
          "List of LSP provisioning error info entries.";
        leaf error-description {
          type string;
          description
            "Textual representation of the error occurred during
             path computation.";
        }
        leaf error-timestamp {
          type yang:date-and-time;
          description
            "Timestamp of when the reported error occurred.";
        }
        leaf error-node-id {
          type te-types:te-node-id;
          default "0.0.0.0";
          description
            "Node identifier of node where error occurred.";
        }
        leaf error-link-id {
          type te-types:te-tp-id;
          default "0";
          description
            "Link ID where the error occurred.";
        }
      }
    }
  }

  grouping protection-restoration-properties-state {
    description
      "Protection parameters grouping.";
    leaf lockout-of-normal {
      type boolean;
      default "false";
      description
        "When set to 'True', it represents a lockout of normal
         traffic external command. When set to 'False', it
         represents a clear lockout of normal traffic external
         command. The lockout of normal traffic command applies
         to this Tunnel.";
      reference
        "RFC4427";
    }
    leaf freeze {
      type boolean;
      default "false";
      description
        "When set to 'True', it represents a freeze external command.
         When set to 'False', it represents a clear freeze external
         command. The freeze command applies to all the Tunnels which
         are sharing the protection resources with this Tunnel.";
      reference
        "RFC4427";
    }
    leaf lsp-protection-role {
      type enumeration {
        enum working {
          description
            "A working LSP must be a primary LSP whilst a protecting
             LSP can be either a primary or a secondary LSP. Also,
             known as protected LSPs when working LSPs are associated
             with protecting LSPs.";
        }
        enum protecting {
          description
            "A secondary LSP is an LSP that has been provisioned
             in the control plane only; e.g. resource allocation
             has not been committed at the data plane.";
        }
      }
      default "working";
      description
        "LSP role type.";
      reference
        "RFC4872, section 4.2.1";
    }
    leaf lsp-protection-state {
      type identityref {
        base te-types:lsp-protection-state;
      }
      default "te-types:normal";
      description
        "The state of the APS state machine controlling which
         tunnels is using the resources of the protecting LSP.";
    }
    leaf protection-group-ingress-node-id {
      type te-types:te-node-id;
      default "0.0.0.0";
      description
        "Indicates the te-node-id of the protection group
         ingress node when the APS state represents an external
         command (LoP, SF, MS) applied to it or a WTR timer
         running on it. If the external command is not applied to
         the ingress node or the WTR timer is not running on it,
         this attribute is not specified. A value 0.0.0.0 is used
         when the te-node-id of the protection group ingress node is
         unknown (e.g., because the ingress node is outside the scope
         of control of the server)";
    }
    leaf protection-group-egress-node-id {
      type te-types:te-node-id;
      default "0.0.0.0";
      description
        "Indicates the te-node-id of the protection group egress node
         when the APS state represents an external command (LoP, SF,
         MS) applied to it or a WTR timer running on it. If the
         external command is not applied to the ingress node or
         the WTR timer is not running on it, this attribute is not
         specified. A value 0.0.0.0 is used when the te-node-id of
         the protection group ingress node is unknown (e.g., because
         the ingress node is outside the scope of control of the
         server)";
    }
  }

  grouping protection-restoration-properties {
    description
      "Protection and restoration parameters.";
    container protection {
      description
        "Protection parameters.";
      leaf enable {
        type boolean;
        default "false";
        description
          "A flag to specify if LSP protection is enabled.";
        reference
          "RFC4427";
      }
      leaf protection-type {
        type identityref {
          base te-types:lsp-protection-type;
        }
        default "te-types:lsp-protection-unprotected";
        description
          "LSP protection type.";
      }
      leaf protection-reversion-disable {
        type boolean;
        default "false";
        description
          "Disable protection reversion to working path.";
      }
      leaf hold-off-time {
        type uint32;
        units "milli-seconds";
        default "0";
        description
          "The time between the declaration of an SF or SD condition
           and the initialization of the protection switching
           algorithm.";
        reference
          "RFC4427";
      }
      leaf wait-to-revert {
        type uint16;
        units "seconds";
        description
          "Time to wait before attempting LSP reversion.";
        reference
          "RFC4427";
      }
      leaf aps-signal-id {
        type uint8 {
          range "1..255";
        }
        default "1";
        description
          "The APS signal number used to reference the traffic of
           this tunnel. The default value for normal traffic is 1.
           The default value for extra-traffic is 255. If not
           specified, non-default values can be assigned by the
           server, if and only if, the server controls both
            endpoints.";
        reference
          "RFC4427";
      }
    }
    container restoration {
      description
        "Restoration parameters.";
      leaf enable {
        type boolean;
        default "false";
        description
          "A flag to specify if LSP restoration is enabled.";
        reference
          "RFC4427";
      }
      leaf restoration-type {
        type identityref {
          base te-types:lsp-restoration-type;
        }
        default "te-types:lsp-restoration-restore-any";
        description
          "LSP restoration type.";
      }
      leaf restoration-scheme {
        type identityref {
          base te-types:restoration-scheme-type;
        }
        default "te-types:restoration-scheme-preconfigured";
        description
          "LSP restoration scheme.";
      }
      leaf restoration-reversion-disable {
        type boolean;
        default "false";
        description
          "Disable restoration reversion to working path.";
      }
      leaf hold-off-time {
        type uint32;
        units "milli-seconds";
        description
          "The time between the declaration of an SF or SD condition
           and the initialization of the protection switching
           algorithm.";
        reference
          "RFC4427";
      }
      leaf wait-to-restore {
        type uint16;
        units "seconds";
        description
          "Time to wait before attempting LSP restoration.";
        reference
          "RFC4427";
      }
      leaf wait-to-revert {
        type uint16;
        units "seconds";
        description
          "Time to wait before attempting LSP reversion.";
        reference
          "RFC4427";
      }
    }
  }

  grouping tunnel-associations-properties {
    description
      "TE tunnel association grouping.";
    container association-objects {
      description
        "TE tunnel associations.";
      list association-object {
        key "association-key";
        unique "type id source/id source/type";
        description
          "List of association base objects.";
        reference
          "RFC4872";
        leaf association-key {
          type string;
          description
            "Association key used to identify a specific
             association in the list";
        }
        leaf type {
          type identityref {
            base te-types:association-type;
          }
          description
            "Association type.";
          reference
            "RFC4872";
        }
        leaf id {
          type uint16;
          description
            "Association identifier.";
          reference
            "RFC4872";
        }
        container source {
          uses te-generic-node-id;
          description
            "Association source.";
          reference
            "RFC4872";
        }
      }
      list association-object-extended {
        key "association-key";
        unique
          "type id source/id source/type global-source extended-id";
        description
          "List of extended association objects.";
        reference
          "RFC6780";
        leaf association-key {
          type string;
          description
            "Association key used to identify a specific
             association in the list";
        }
        leaf type {
          type identityref {
            base te-types:association-type;
          }
          description
            "Association type.";
          reference
            "RFC4872, RFC6780";
        }
        leaf id {
          type uint16;
          description
            "Association identifier.";
          reference
            "RFC4872, RFC6780";
        }
        container source {
          uses te-generic-node-id;
          description
            "Association source.";
          reference
            "RFC4872, RFC6780";
        }
        leaf global-source {
          type uint32;
          description
            "Association global source.";
          reference
            "RFC6780";
        }
        leaf extended-id {
          type yang:hex-string;
          description
            "Association extended identifier.";
          reference
            "RFC6780";
        }
      }
    }
  }

  /* TE tunnel configuration/state grouping */
  /* These grouping will be re-used in path-computation rpc */

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

  grouping tunnel-common-attributes {
    description
      "Common grouping to define the TE tunnel parameters";
    leaf source {
      type te-types:te-node-id;
      description
        "TE tunnel source node ID.";
    }
    leaf destination {
      type te-types:te-node-id;
      description
        "TE tunnel destination node identifier.";
    }
    leaf src-tunnel-tp-id {
      type binary;
      description
        "TE tunnel source termination point identifier.";
    }
    leaf dst-tunnel-tp-id {
      type binary;
      description
        "TE tunnel destination termination point identifier.";
    }
    leaf bidirectional {
      type boolean;
      default "false";
      description
        "Indicates a bidirectional co-routed LSP.";
    }
  }

  grouping tunnel-hierarchy-properties {
    description
      "A grouping for TE tunnel hierarchy information.";
    container hierarchy {
      description
        "Container for TE hierarchy related information.";
      container dependency-tunnels {
        description
          "List of tunnels that this tunnel can be potentially
           dependent on.";
        list dependency-tunnel {
          key "name";
          description
            "A tunnel entry that this tunnel can potentially depend
             on.";
          leaf name {
            type leafref {
              path "/te:te/te:tunnels/te:tunnel/te:name";
              require-instance false;
            }
            description
              "Dependency tunnel name. The tunnel may not have been
               instantiated yet.";
          }
          uses encoding-and-switching-type;
        }
      }
      container hierarchical-link {
        description
          "Identifies a hierarchical link (in client layer)
           that this tunnel is associated with.";
        reference
          "RFC4206";
        leaf local-te-node-id {
          type te-types:te-node-id;
          default "0.0.0.0";
          description
            "The local TE node identifier.";
        }
        leaf local-te-link-tp-id {
          type te-types:te-tp-id;
          default "0";
          description
            "The local TE link termination point identifier.";
        }
        leaf remote-te-node-id {
          type te-types:te-node-id;
          default "0.0.0.0";
          description
            "Remote TE node identifier.";
        }
        uses te-types:te-topology-identifier {
          description
            "The topology identifier where the hierarchical link
             supported by this TE tunnel is instantiated.";
        }
      }
    }
  }

  grouping tunnel-properties {
    description
      "Top level grouping for tunnel properties.";
    leaf name {
      type string;
      description
        "TE tunnel name.";
    }
    leaf alias {
      type string;
      description
        "An alternate name of the TE tunnel that can be modified
         anytime during its lifetime.";
    }
    leaf identifier {
      type uint32;
      description
        "TE tunnel Identifier.";
      reference
        "RFC3209";
    }
    leaf color {
      type uint32;
      description "The color associated with the TE tunnel.";
      reference "RFC9012";
    }
    leaf description {
      type string;
      default "None";
      description
        "Textual description for this TE tunnel.";
    }
    leaf admin-state {
      type identityref {
        base te-types:tunnel-admin-state-type;
      }
      default "te-types:tunnel-admin-state-up";
      description
        "TE tunnel administrative state.";
    }
    leaf operational-state {
      type identityref {
        base te-types:tunnel-state-type;
      }
      config false;
      description
        "TE tunnel operational state.";
    }
    uses encoding-and-switching-type;
    uses tunnel-common-attributes;
    container controller {
      description
        "Contains tunnel data relevant to external controller(s).
         This target node may be augmented by external module(s),
         for example, to add data for PCEP initiated and/or
         delegated tunnels.";
      leaf protocol-origin {
        type identityref {
          base protocol-origin-type;
        }
        description
          "The protocol origin for instantiating the tunnel."; 
      }
      leaf controller-entity-id {
        type string;
        description
          "An identifier unique within the scope of visibility that
           associated with the entity that controls the tunnel";
        reference "RFC8232";
      }
    }
    leaf reoptimize-timer {
      type uint16;
      units "seconds";
      description
        "Frequency of reoptimization of a traffic engineered LSP.";
    }
    uses tunnel-associations-properties;
    uses protection-restoration-properties;
    uses te-types:tunnel-constraints;
    uses tunnel-hierarchy-properties;
    container primary-paths {
      description
        "The set of primary paths.";
      list primary-path {
        key "name";
        description
          "List of primary paths for this tunnel.";
        uses primary-path;
        container primary-reverse-path {
          description
            "The reverse primary path properties.";
          uses primary-reverse-path;
          container candidate-secondary-reverse-paths {
            description
              "The set of referenced candidate reverse secondary
               paths from the full set of secondary reverse paths
               which may be used for this primary path.";
            list candidate-secondary-reverse-path {
              key "secondary-path";
              ordered-by user;
              description
                "List of candidate secondary reverse path(s)";
              leaf secondary-path {
                type leafref {
                  path "../../../../../../"
                     + "te:secondary-reverse-paths/"
                     + "te:secondary-reverse-path/te:name";
                }
                description
                  "A reference to the secondary reverse path that
                   should be utilised when the containing primary
                   reverse path option is in use.";
              }
            }
          }
        }
        container candidate-secondary-paths {
          description
            "The set of candidate secondary paths which may be used
             for this primary path. When secondary paths are
             specified in the list the path of the secondary LSP in
             use must be restricted to those path options referenced.
             The priority of the secondary paths is specified within
             the list. Higher priority values are less preferred -
             that is to say that a path with priority 0 is the most
             preferred path. In the case that the list is empty, any
             secondary path option may be utilised when the current
             primary path is in use.";
          list candidate-secondary-path {
            key "secondary-path";
            ordered-by user;
            description
              "List of candidate secondary paths for this tunnel.";
            leaf secondary-path {
              type leafref {
                path "../../../../../te:secondary-paths/"
                   + "te:secondary-path/te:name";
              }
              description
                "A reference to the secondary path that should be
                 utilised when the containing primary path option is
                 in use.";
            }
            leaf active {
              type boolean;
              config false;
              description
                "Indicates the current active path option that has
                 been selected of the candidate secondary paths.";
            }
          }
        }
      }
    }
    container secondary-paths {
      description
        "The set of secondary paths.";
      list secondary-path {
        key "name";
        description
          "List of secondary paths for this tunnel.";
        uses secondary-path;
      }
    }
    container secondary-reverse-paths {
      description
        "The set of secondary reverse paths.";
      list secondary-reverse-path {
        key "name";
        description
          "List of secondary paths for this tunnel.";
        uses secondary-reverse-path;
      }
    }
  }

  grouping tunnel-actions {
    description
      "Tunnel actions.";
    action tunnel-action {
      description
        "Tunnel action.";
      input {
        leaf action-type {
          type identityref {
            base tunnel-actions-type;
          }
          description
            "Tunnel action type.";
        }
      }
      output {
        leaf action-result {
          type identityref {
            base te-types:te-action-result;
          }
          description
            "The result of the tunnel action operation.";
        }
      }
    }
  }

  grouping tunnel-protection-actions {
    description
      "Protection external command actions.";
    action protection-external-commands {
      input {
        leaf protection-external-command {
          type identityref {
            base te-types:protection-external-commands;
          }
          description
            "Protection external command.";
        }
        leaf protection-group-ingress-node-id {
          type te-types:te-node-id;
          description
            "When specified, indicates whether the action is
             applied on ingress node.
             By default, if neither ingress nor egress node-id
             is set, the action applies to ingress node only.";
        }
        leaf protection-group-egress-node-id {
          type te-types:te-node-id;
          description
            "When specified, indicates whether the action is
             applied on egress node.
             By default, if neither ingress nor egress node-id
             is set, the action applies to ingress node only.";
        }
        leaf path-ref {
          type path-ref;
          description
            "Indicates to which path the external command applies
             to.";
        }
        leaf traffic-type {
          type enumeration {
            enum normal-traffic {
              description
                "The manual-switch or forced-switch command applies
                 to the normal traffic (this Tunnel).";
            }
            enum null-traffic {
              description
                "The manual-switch or forced-switch command applies
                 to the null traffic.";
            }
            enum extra-traffic {
              description
                "The manual-switch or forced-switch command applies
                 to the extra traffic (the extra-traffic Tunnel
                 sharing protection bandwidth with this Tunnel).";
            }
          }
          description
            "Indicates whether the manual-switch or forced-switch
             commands applies to the normal traffic, the null traffic
             or the extra-traffic.";
          reference
            "RFC4427";
        }
        leaf extra-traffic-tunnel-ref {
          type tunnel-ref;
          description
            "In case there are multiple extra-traffic tunnels sharing
             protection bandwidth with this Tunnel (m:n protection),
             represents which extra-traffic Tunnel the manual-switch
             or forced-switch to extra-traffic command applies to.";
        }
      }
    }
  }

  /*** End of TE tunnel groupings ***/
  /**
   * LSP related generic groupings
   */

  grouping lsp-record-route-information-state {
    description
      "LSP Recorded route information grouping.";
    container lsp-record-route-information {
      description
        "RSVP recorded route object information.";
      list lsp-record-route-information {
        when "../../origin-type = 'ingress'" {
          description
            "Applicable on ingress LSPs only.";
        }
        key "index";
        description
          "Record route list entry.";
        uses te-types:record-route-state;
      }
    }
  }

  grouping lsps-grouping {
    description
      "LSPs state operational data grouping.";
    container lsps {
      config false;
      description
        "TE LSPs state container.";
      list lsp {
        key "tunnel-name lsp-id node";
        unique "source destination tunnel-id lsp-id "
          + "extended-tunnel-id";
        description
          "List of LSPs associated with the tunnel.";
        leaf tunnel-name {
          type string;
          description "The TE tunnel name.";
        }
        leaf lsp-id {
          type uint16;
          description
            "Identifier used in the SENDER_TEMPLATE and the
             FILTER_SPEC that can be changed to allow a sender to
             share resources with itself.";
          reference
            "RFC3209";
        }
        leaf node {
          type te-types:te-node-id;
          description
            "The node where the TE LSP state resides on.";
        }
        uses lsp-properties-state;
        uses lsp-record-route-information-state;
      }
    }
  }

  /*** End of TE LSP groupings ***/
  /**
   * TE global generic groupings
   */
  /* Global named admin-groups configuration data */

  grouping named-admin-groups-properties {
    description
      "Global named administrative groups configuration
       grouping.";
    leaf name {
      type string;
      description
        "A string name that uniquely identifies a TE
         interface named admin-group.";
    }
    leaf bit-position {
      type uint32;
      description
        "Bit position representing the administrative group.";
      reference
        "RFC3209 and RFC7308";
    }
  }

  grouping named-admin-groups {
    description
      "Global named administrative groups configuration
       grouping.";
    container named-admin-groups {
      description
        "TE named admin groups container.";
      list named-admin-group {
        if-feature "te-types:extended-admin-groups";
        if-feature "te-types:named-extended-admin-groups";
        key "name";
        description
          "List of named TE admin-groups.";
        uses named-admin-groups-properties;
      }
    }
  }

  /* Global named admin-srlgs configuration data */

  grouping named-srlgs {
    description
      "Global named SRLGs configuration grouping.";
    container named-srlgs {
      description
        "TE named SRLGs container.";
      list named-srlg {
        if-feature "te-types:named-srlg-groups";
        key "name";
        description
          "A list of named SRLG groups.";
        leaf name {
          type string;
          description
            "A string name that uniquely identifies a TE
             interface named SRLG.";
        }
        leaf value {
          type te-types:srlg;
          description
            "An SRLG value.";
        }
        leaf cost {
          type uint32;
          description
            "SRLG associated cost. Used during path to append
             the path cost when traversing a link with this SRLG.";
        }
      }
    }
  }

  /* Global named paths constraints configuration data */

  grouping path-constraints-common {
    description
      "Global named path constraints configuration
       grouping.";
    uses te-types:common-path-constraints-attributes {
      description
        "The constraints applicable to the path. This includes:
         - The path bandwidth constraint
         - The path link protection type constraint
         - The path setup/hold priority constraint
         - path signaling type constraint
         - path metric bounds constraint. The unit of path metric
           bound is interpreted in the context of the metric-type.
           For example for metric-type 'path-metric-loss', the bound
           is multiples of the basic unit 0.000003% as described
           in RFC7471 for OSPF, and RFC8570 for ISIS.
         - path affinity constraints
         - path SRLG constraints";

    }
    uses te-types:generic-path-disjointness;
    uses te-types:path-constraints-route-objects;
    container path-in-segment {
      presence "The end-to-end tunnel starts in a previous domain;
                this tunnel is a segment in the current domain.";
      description
        "If an end-to-end tunnel crosses multiple domains using
         the same technology, some additional constraints have to be
         taken in consideration in each domain.
         This TE tunnel segment is stitched to the upstream TE tunnel
         segment.";
      uses te-types:label-set-info;
    }
    container path-out-segment {
      presence
        "The end-to-end tunnel is not terminated in this domain;
         this tunnel is a segment in the current domain.";
      description
        "If an end-to-end tunnel crosses multiple domains using
         the same technology, some additional constraints have to be
         taken in consideration in each domain.
         This TE tunnel segment is stitched to the downstream TE
         tunnel segment.";
      uses te-types:label-set-info;
    }
  }

  grouping named-path-constraints {
    description
      "Global named path constraints configuration
       grouping.";
    container named-path-constraints {
      description
        "TE named path constraints container.";
      list named-path-constraint {
        if-feature "te-types:named-path-constraints";
        key "name";
        leaf name {
          type string;
          description
            "A string name that uniquely identifies a
             path constraint set.";
        }
        uses path-constraints-common;
        description
          "A list of named path constraints.";
      }
    }
  }

  /* TE globals container data */

  grouping globals-grouping {
    description
      "Globals TE system-wide configuration data grouping.";
    container globals {
      description
        "Globals TE system-wide configuration data container.";
      uses named-admin-groups;
      uses named-srlgs;
      uses named-path-constraints;
    }
  }

  /* TE tunnels container data */

  grouping tunnels-grouping {
    description
      "Tunnels TE configuration data grouping.";
    container tunnels {
      description
        "Tunnels TE configuration data container.";
      list tunnel {
        key "name";
        description
          "The list of TE tunnels.";
        uses tunnel-properties;
        uses tunnel-actions;
        uses tunnel-protection-actions;
      }
    }
  }

  /* TE LSPs ephemeral state container data */

  grouping lsp-properties-state {
    description
      "LSPs state operational data grouping.";
    leaf source {
      type te-types:te-node-id;
      description
        "Tunnel sender address extracted from
         SENDER_TEMPLATE  object.";
      reference
        "RFC3209";
    }
    leaf destination {
      type te-types:te-node-id;
      description
        "The tunnel endpoint address extracted from SESSION object.";
      reference
        "RFC3209";
    }
    leaf tunnel-id {
      type uint16;
      description
        "The tunnel identifier used in the SESSION that remains
         constant over the life of the tunnel.";
      reference
        "RFC3209";
    }
    leaf extended-tunnel-id {
      type yang:dotted-quad;
      description
        "The LSP Extended Tunnel ID.";
      reference
        "RFC3209";
    }
    leaf operational-state {
      type identityref {
        base te-types:lsp-state-type;
      }
      description
        "The LSP operational state.";
    }
    leaf signaling-type {
      type identityref {
        base te-types:path-signaling-type;
      }
      description
        "The signaling protocol used to set up this LSP.";
    }
    leaf origin-type {
      type enumeration {
        enum ingress {
          description
            "Origin ingress.";
        }
        enum egress {
          description
            "Origin egress.";
        }
        enum transit {
          description
            "Origin transit.";
        }
      }
      default "ingress";
      description
        "The origin of the LSP relative to the location of the local
         switch in the path.";
    }
    leaf lsp-resource-status {
      type enumeration {
        enum primary {
          description
            "A primary LSP is a fully established LSP for which the
             resource allocation has been committed at the data
             plane.";
        }
        enum secondary {
          description
            "A secondary LSP is an LSP that has been provisioned
             in the control plane only; e.g. resource allocation
             has not been committed at the data plane.";
        }
      }
      default "primary";
      description
        "LSP resource allocation state.";
      reference
        "RFC4872, section 4.2.1";
    }
    uses protection-restoration-properties-state;
  }

  /*** End of TE global groupings ***/
  /**
   * TE container
   */

  container te {
    presence "Enable TE feature.";
    description
      "TE global container.";
    /* TE Global Data */
    uses globals-grouping;

    /* TE Tunnel Data */
    uses tunnels-grouping;

    /* TE LSPs Data */
    uses lsps-grouping;
  }

  /* TE Tunnel RPCs/execution Data */

  rpc tunnels-path-compute {
    description
      "TE tunnels RPC nodes.";
    input {
      container path-compute-info {
        /* 
         * An external path compute module may augment this
         * target.
         */
        description
          "RPC input information.";
      }
    }
    output {
      container path-compute-result {
        /* 
         * An external path compute module may augment this
         * target.
         */
        description
          "RPC output information.";
      }
    }
  }

  rpc tunnels-actions {
    description
      "TE tunnels actions RPC";
    input {
      container tunnel-info {
        description
          "TE tunnel information.";
        choice filter-type {
          mandatory true;
          description
            "Filter choice.";
          case all-tunnels {
            leaf all {
              type empty;
              mandatory true;
              description
                "Apply action on all TE tunnels.";
            }
          }
          case one-tunnel {
            leaf tunnel {
              type tunnel-ref;
              description
                "Apply action on the specific TE tunnel.";
            }
          }
        }
      }
      container action-info {
        description
          "TE tunnel action information.";
        leaf action {
          type identityref {
            base tunnel-actions-type;
          }
          description
            "The action type.";
        }
        leaf disruptive {
          when "derived-from-or-self(../action, "
             + "'te:tunnel-action-reoptimize')";
          type empty;
          description
            "Specifies whether or not the reoptimization action
             is allowed to be disruptive.";
        }
      }
    }
    output {
      leaf action-result {
        type identityref {
          base te-types:te-action-result;
        }
        description
          "The result of the tunnel action operation.";
      }
    }
  }
}
<CODE ENDS>
]]></artwork></figure>

</section>
</section>
<section anchor="te-device-yang-model" title="TE Device YANG Model">

<t>The device TE YANG module (‘ietf-te-device’) models data that is specific to
managing a TE device.  This module augments the generic TE YANG module.</t>

<section anchor="module-structure-1" title="Module Structure">

<section anchor="te-interfaces" title="TE Interfaces">

<t>This branch of the model manages TE interfaces that are present on a device. 
Examples of TE interface properties are:</t>

<t><list style="symbols">
  <t>Maximum reservable bandwidth, bandwidth constraints (BC)</t>
  <t>Flooding parameters
  <list style="symbols">
      <t>Flooding intervals and threshold values</t>
    </list></t>
  <t>interface attributes
  <list style="symbols">
      <t>(Extended) administrative groups</t>
      <t>SRLG values</t>
      <t>TE metric value</t>
    </list></t>
  <t>Fast reroute backup tunnel properties (such as static, auto-tunnel)</t>
</list></t>

<t>The derived state associated with interfaces is grouped under the interface
“state” sub-container as shown in <xref target="fig-if-te-state"/>.  This covers state data
such as:</t>

<t><list style="symbols">
  <t>Bandwidth information: maximum bandwidth, available bandwidth at different
priorities and for each class-type (CT)</t>
  <t>List of admitted LSPs
  <list style="symbols">
      <t>Name, bandwidth value and pool, time, priority</t>
    </list></t>
  <t>Statistics: state counters, flooding counters, admission counters
(accepted/rejected), preemption counters</t>
  <t>Adjacency information
  <list style="symbols">
      <t>Neighbor address</t>
      <t>Metric value</t>
    </list></t>
</list></t>

<figure title="TE interface state YANG subtree" anchor="fig-if-te-state"><artwork><![CDATA[
module: ietf-te-device
  augment /te:te:
      +--rw interfaces
         .
         +-- rw te-dev:te-attributes
                <<intended configuration>>
             .
             +-- ro state
                <<derived state associated with the TE interface>>
]]></artwork></figure>

</section>
</section>
<section anchor="tree-diagram-1" title="Tree Diagram">

<t><xref target="fig-te-dev-tree"/> shows the tree diagram of the device TE YANG model defined in
modules ‘ietf-te.yang’.</t>

<figure title="TE Tunnel device model YANG tree diagram" anchor="fig-te-dev-tree"><artwork><![CDATA[
module: ietf-te-device
  augment /te:te:
    +--rw interfaces
    |  +--rw threshold-type?            enumeration
    |  +--rw delta-percentage?          rt-types:percentage
    |  +--rw threshold-specification?   enumeration
    |  +--rw up-thresholds*             rt-types:percentage
    |  +--rw down-thresholds*           rt-types:percentage
    |  +--rw up-down-thresholds*        rt-types:percentage
    |  +--rw interface* [interface]
    |     +--rw interface                           if:interface-ref
    |     +--rw te-metric?
    |     |       te-types:te-metric
    |     +--rw (admin-group-type)?
    |     |  +--:(value-admin-groups)
    |     |  |  +--rw (value-admin-group-type)?
    |     |  |     +--:(admin-groups)
    |     |  |     |  +--rw admin-group?
    |     |  |     |          te-types:admin-group
    |     |  |     +--:(extended-admin-groups)
    |     |  |              {te-types:extended-admin-groups}?
    |     |  |        +--rw extended-admin-group?
    |     |  |                te-types:extended-admin-group
    |     |  +--:(named-admin-groups)
    |     |     +--rw named-admin-groups* [named-admin-group]
    |     |             {te-types:extended-admin-groups,te-types:named-
    extended-admin-groups}?
    |     |        +--rw named-admin-group    leafref
    |     +--rw (srlg-type)?
    |     |  +--:(value-srlgs)
    |     |  |  +--rw values* [value]
    |     |  |     +--rw value    uint32
    |     |  +--:(named-srlgs)
    |     |     +--rw named-srlgs* [named-srlg]
    |     |             {te-types:named-srlg-groups}?
    |     |        +--rw named-srlg    leafref
    |     +--rw threshold-type?                     enumeration
    |     +--rw delta-percentage?
    |     |       rt-types:percentage
    |     +--rw threshold-specification?            enumeration
    |     +--rw up-thresholds*
    |     |       rt-types:percentage
    |     +--rw down-thresholds*
    |     |       rt-types:percentage
    |     +--rw up-down-thresholds*
    |     |       rt-types:percentage
    |     +--rw switching-capabilities* [switching-capability]
    |     |  +--rw switching-capability    identityref
    |     |  +--rw encoding?               identityref
    |     +--ro state
    |        +--ro te-advertisements-state
    |           +--ro flood-interval?           uint32
    |           +--ro last-flooded-time?        uint32
    |           +--ro next-flooded-time?        uint32
    |           +--ro last-flooded-trigger?     enumeration
    |           +--ro advertised-level-areas* [level-area]
    |              +--ro level-area    uint32
    +--rw performance-thresholds
  augment /te:te/te:globals:
    +--rw lsp-install-interval?        uint32
    +--rw lsp-cleanup-interval?        uint32
    +--rw lsp-invalidation-interval?   uint32
  augment /te:te/te:tunnels/te:tunnel:
    +--rw path-invalidation-action?    identityref
    +--rw lsp-install-interval?        uint32
    +--rw lsp-cleanup-interval?        uint32
    +--rw lsp-invalidation-interval?   uint32
  augment /te:te/te:lsps/te:lsp:
    +--ro lsp-timers
    |  +--ro life-time?         uint32
    |  +--ro time-to-install?   uint32
    |  +--ro time-to-destroy?   uint32
    +--ro downstream-info
    |  +--ro nhop?                 te-types:te-tp-id
    |  +--ro outgoing-interface?   if:interface-ref
    |  +--ro neighbor
    |  |  +--ro id?     te-gen-node-id
    |  |  +--ro type?   enumeration
    |  +--ro label?                rt-types:generalized-label
    +--ro upstream-info
       +--ro phop?       te-types:te-tp-id
       +--ro neighbor
       |  +--ro id?     te-gen-node-id
       |  +--ro type?   enumeration
       +--ro label?      rt-types:generalized-label

  rpcs:
    +---x link-state-update
       +---w input
          +---w (filter-type)
             +--:(match-all)
             |  +---w all          empty
             +--:(match-one-interface)
                +---w interface?   if:interface-ref
]]></artwork></figure>

</section>
<section anchor="yang-module-1" title="YANG Module">

<t>The device TE YANG module ‘ietf-te-device’ imports the following module(s):</t>

<t><list style="symbols">
  <t>ietf-yang-types and ietf-inet-types defined in <xref target="RFC6991"/></t>
  <t>ietf-interfaces defined in <xref target="RFC8343"/></t>
  <t>ietf-routing-types defined in <xref target="RFC8294"/></t>
  <t>ietf-te-types defined in <xref target="RFC8776"/></t>
  <t>ietf-te defined in this document</t>
</list></t>

<figure title="TE device data model YANG module" anchor="fig-te-device-types"><artwork><![CDATA[
<CODE BEGINS> file "ietf-te-device@2021-10-22.yang"


module ietf-te-device {
  yang-version 1.1;
  namespace "urn:ietf:params:xml:ns:yang:ietf-te-device";

  /* Replace with IANA when assigned */

  prefix te-dev;

  /* Import TE module */

  import ietf-te {
    prefix te;
    reference
      "draft-ietf-teas-yang-te: A YANG Data Model for Traffic
       Engineering Tunnels and Interfaces";
  }

  /* Import TE types */

  import ietf-te-types {
    prefix te-types;
    reference
      "RFC8776: Common YANG Data Types for Traffic Engineering.";
  }
  import ietf-interfaces {
    prefix if;
    reference
      "RFC8343: A YANG Data Model for Interface Management";
  }
  import ietf-routing-types {
    prefix rt-types;
    reference
      "RFC8294: Common YANG Data Types for the Routing Area";
  }

  organization
    "IETF Traffic Engineering Architecture and Signaling (TEAS)
     Working Group";
  contact
    "WG Web:   <http://tools.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:   Himanshu Shah
               <mailto:hshah@ciena.com>

     Editor:   Xufeng Liu
               <mailto: xufeng.liu.ietf@gmail.com>

     Editor:   Igor Bryskin
               <mailto:i_bryskin@yahoo.com>";
  description
    "YANG data module for TE device configurations,
     state, and RPCs. The model fully conforms to the
     Network Management Datastore Architecture (NMDA).

     Copyright (c) 2019 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.";

  // RFC Ed.: replace XXXX with actual RFC number and remove this
  // note.
  // RFC Ed.: update the date below with the date of RFC publication
  // and remove this note.

  revision 2021-10-22 {
    description
      "Latest update to TE device YANG module.";
    reference
      "RFCXXXX: A YANG Data Model for Traffic Engineering Tunnels
       and Interfaces";
  }

  /**
   * TE LSP device state grouping
   */

  grouping lsps-device-info {
    description
      "TE LSP device state grouping.";
    container lsp-timers {
      when "../te:origin-type = 'ingress'" {
        description
          "Applicable to ingress LSPs only.";
      }
      description
        "Ingress LSP timers.";
      leaf life-time {
        type uint32;
        units "seconds";
        description
          "TE LSP lifetime.";
      }
      leaf time-to-install {
        type uint32;
        units "seconds";
        description
          "TE LSP installation delay time.";
      }
      leaf time-to-destroy {
        type uint32;
        units "seconds";
        description
          "TE LSP expiration delay time.";
      }
    }
    container downstream-info {
      when "../te:origin-type != 'egress'" {
        description
          "Downstream information of the LSP.";
      }
      description
        "downstream information.";
      leaf nhop {
        type te-types:te-tp-id;
        description
          "downstream next-hop address.";
      }
      leaf outgoing-interface {
        type if:interface-ref;
        description
          "downstream interface.";
      }
      container neighbor {
        uses te:te-generic-node-id;
        description
          "downstream neighbor address.";
      }
      leaf label {
        type rt-types:generalized-label;
        description
          "downstream label.";
      }
    }
    container upstream-info {
      when "../te:origin-type != 'ingress'" {
        description
          "Upstream information of the LSP.";
      }
      description
        "upstream information.";
      leaf phop {
        type te-types:te-tp-id;
        description
          "upstream next-hop or previous-hop address.";
      }
      container neighbor {
        uses te:te-generic-node-id;
        description
          "upstream neighbor address.";
      }
      leaf label {
        type rt-types:generalized-label;
        description
          "upstream label.";
      }
    }
  }

  /**
   * Device general groupings.
   */

  grouping lsp-device-timers {
    description
      "Device TE LSP timers configs.";
    leaf lsp-install-interval {
      type uint32;
      units "seconds";
      description
        "TE LSP installation delay time.";
    }
    leaf lsp-cleanup-interval {
      type uint32;
      units "seconds";
      description
        "TE LSP cleanup delay time.";
    }
    leaf lsp-invalidation-interval {
      type uint32;
      units "seconds";
      description
        "TE LSP path invalidation before taking action delay time.";
    }
  }

  /**
   * TE global device groupings
   */
  /* TE interface container data */

  grouping interfaces-grouping {
    description
      "TE interface configuration data grouping.";
    container interfaces {
      description
        "Configuration data model for TE interfaces.";
      uses te-all-attributes;
      list interface {
        key "interface";
        description
          "TE interfaces.";
        leaf interface {
          type if:interface-ref;
          description
            "TE interface name.";
        }
        /* TE interface parameters */
        uses te-attributes;
      }
    }
  }

  /**
   * TE interface device groupings
   */

  grouping te-admin-groups-config {
    description
      "TE interface affinities grouping.";
    choice admin-group-type {
      description
        "TE interface administrative groups
         representation type.";
      case value-admin-groups {
        choice value-admin-group-type {
          description
            "choice of admin-groups.";
          case admin-groups {
            description
              "Administrative group/Resource
               class/Color.";
            leaf admin-group {
              type te-types:admin-group;
              description
                "TE interface administrative group.";
            }
          }
          case extended-admin-groups {
            if-feature "te-types:extended-admin-groups";
            description
              "Extended administrative group/Resource
               class/Color.";
            leaf extended-admin-group {
              type te-types:extended-admin-group;
              description
                "TE interface extended administrative group.";
            }
          }
        }
      }
      case named-admin-groups {
        list named-admin-groups {
          if-feature "te-types:extended-admin-groups";
          if-feature "te-types:named-extended-admin-groups";
          key "named-admin-group";
          description
            "A list of named admin-group entries.";
          leaf named-admin-group {
            type leafref {
              path "../../../../te:globals/"
                 + "te:named-admin-groups/te:named-admin-group/"
                 + "te:name";
            }
            description
              "A named admin-group entry.";
          }
        }
      }
    }
  }

  /* TE interface SRLGs */

  grouping te-srlgs-config {
    description
      "TE interface SRLG grouping.";
    choice srlg-type {
      description
        "Choice of SRLG configuration.";
      case value-srlgs {
        list values {
          key "value";
          description
            "List of SRLG values that
             this link is part of.";
          leaf value {
            type uint32 {
              range "0..4294967295";
            }
            description
              "Value of the SRLG";
          }
        }
      }
      case named-srlgs {
        list named-srlgs {
          if-feature "te-types:named-srlg-groups";
          key "named-srlg";
          description
            "A list of named SRLG entries.";
          leaf named-srlg {
            type leafref {
              path "../../../../te:globals/"
                 + "te:named-srlgs/te:named-srlg/te:name";
            }
            description
              "A named SRLG entry.";
          }
        }
      }
    }
  }

  grouping te-igp-flooding-bandwidth-config {
    description
      "Configurable items for igp flooding bandwidth
       threshold configuration.";
    leaf threshold-type {
      type enumeration {
        enum delta {
          description
            "'delta' indicates that the local
             system should flood IGP updates when a
             change in reserved bandwidth >= the specified
             delta occurs on the interface.";
        }
        enum threshold-crossed {
          description
            "THRESHOLD-CROSSED indicates that
             the local system should trigger an update (and
             hence flood) the reserved bandwidth when the
             reserved bandwidth changes such that it crosses,
             or becomes equal to one of the threshold values.";
        }
      }
      description
        "The type of threshold that should be used to specify the
         values at which bandwidth is flooded. 'delta' indicates that
         the local system should flood IGP updates when a change in
         reserved bandwidth >= the specified delta occurs on the
         interface. Where 'threshold-crossed' is specified, the local
         system should trigger an update (and hence flood) the
         reserved bandwidth when the reserved bandwidth changes such
         that it crosses, or becomes equal to one of the threshold
         values.";
    }
    leaf delta-percentage {
      when "../threshold-type = 'delta'" {
        description
          "The percentage delta can only be specified when the
           threshold type is specified to be a percentage delta of
           the reserved bandwidth.";
      }
      type rt-types:percentage;
      description
        "The percentage of the maximum-reservable-bandwidth
         considered as the delta that results in an IGP update
         being flooded.";
    }
    leaf threshold-specification {
      when "../threshold-type = 'threshold-crossed'" {
        description
          "The selection of whether mirrored or separate threshold
           values are to be used requires user specified thresholds
           to be set.";
      }
      type enumeration {
        enum mirrored-up-down {
          description
            "mirrored-up-down indicates that a single set of
             threshold values should be used for both increasing
             and decreasing bandwidth when determining whether
             to trigger updated bandwidth values to be flooded
             in the IGP TE extensions.";
        }
        enum separate-up-down {
          description
            "separate-up-down indicates that a separate
             threshold values should be used for the increasing
             and decreasing bandwidth when determining whether
             to trigger updated bandwidth values to be flooded
             in the IGP TE extensions.";
        }
      }
      description
        "This value specifies whether a single set of threshold
         values should be used for both increasing and decreasing
         bandwidth when determining whether to trigger updated
         bandwidth values to be flooded in the IGP TE extensions.
         'mirrored-up-down' indicates that a single value (or set of
         values) should be used for both increasing and decreasing
         values, where 'separate-up-down' specifies that the
         increasing and decreasing values will be separately
         specified.";
    }
    leaf-list up-thresholds {
      when "../threshold-type = 'threshold-crossed'"
         + "and ../threshold-specification = 'separate-up-down'" {
        description
          "A list of up-thresholds can only be specified when the
           bandwidth update is triggered based on crossing a
           threshold and separate up and down thresholds are
           required.";
      }
      type rt-types:percentage;
      description
        "The thresholds (expressed as a percentage of the maximum
         reservable bandwidth) at which bandwidth updates are to be
         triggered when the bandwidth is increasing.";
    }
    leaf-list down-thresholds {
      when "../threshold-type = 'threshold-crossed'"
         + "and ../threshold-specification = 'separate-up-down'" {
        description
          "A list of down-thresholds can only be specified when the
           bandwidth update is triggered based on crossing a
           threshold and separate up and down thresholds are
           required.";
      }
      type rt-types:percentage;
      description
        "The thresholds (expressed as a percentage of the maximum
         reservable bandwidth) at which bandwidth updates are to be
         triggered when the bandwidth is decreasing.";
    }
    leaf-list up-down-thresholds {
      when "../threshold-type = 'threshold-crossed'"
         + "and ../threshold-specification = 'mirrored-up-down'" {
        description
          "A list of thresholds corresponding to both increasing
           and decreasing bandwidths can be specified only when an
           update is triggered based on crossing a threshold, and
           the same up and down thresholds are required.";
      }
      type rt-types:percentage;
      description
        "The thresholds (expressed as a percentage of the maximum
         reservable bandwidth of the interface) at which bandwidth
         updates are flooded - used both when the bandwidth is
         increasing and decreasing.";
    }
  }

  /* TE interface metric */

  grouping te-metric-config {
    description
      "TE interface metric grouping.";
    leaf te-metric {
      type te-types:te-metric;
      description
        "TE interface metric.";
    }
  }

  /* TE interface switching capabilities */

  grouping te-switching-cap-config {
    description
      "TE interface switching capabilities.";
    list switching-capabilities {
      key "switching-capability";
      description
        "List of interface capabilities for this interface.";
      leaf switching-capability {
        type identityref {
          base te-types:switching-capabilities;
        }
        description
          "Switching Capability for this interface.";
      }
      leaf encoding {
        type identityref {
          base te-types:lsp-encoding-types;
        }
        description
          "Encoding supported by this interface.";
      }
    }
  }

  grouping te-advertisements-state {
    description
      "TE interface advertisements state grouping.";
    container te-advertisements-state {
      description
        "TE interface advertisements state container.";
      leaf flood-interval {
        type uint32;
        description
          "The periodic flooding interval.";
      }
      leaf last-flooded-time {
        type uint32;
        units "seconds";
        description
          "Time elapsed since last flooding in seconds.";
      }
      leaf next-flooded-time {
        type uint32;
        units "seconds";
        description
          "Time remained for next flooding in seconds.";
      }
      leaf last-flooded-trigger {
        type enumeration {
          enum link-up {
            description
              "Link-up flooding trigger.";
          }
          enum link-down {
            description
              "Link-down flooding trigger.";
          }
          enum threshold-up {
            description
              "Bandwidth reservation up threshold.";
          }
          enum threshold-down {
            description
              "Bandwidth reservation down threshold.";
          }
          enum bandwidth-change {
            description
              "Bandwidth capacity change.";
          }
          enum user-initiated {
            description
              "Initiated by user.";
          }
          enum srlg-change {
            description
              "SRLG property change.";
          }
          enum periodic-timer {
            description
              "Periodic timer expired.";
          }
        }
        default "periodic-timer";
        description
          "Trigger for the last flood.";
      }
      list advertised-level-areas {
        key "level-area";
        description
          "List of level-areas that the TE interface is advertised
           in.";
        leaf level-area {
          type uint32;
          description
            "The IGP area or level where the TE interface link state
             is advertised in.";
        }
      }
    }
  }

  /* TE interface attributes grouping */

  grouping te-attributes {
    description
      "TE attributes configuration grouping.";
    uses te-metric-config;
    uses te-admin-groups-config;
    uses te-srlgs-config;
    uses te-igp-flooding-bandwidth-config;
    uses te-switching-cap-config;
    container state {
      config false;
      description
        "State parameters for interface TE metric.";
      uses te-advertisements-state;
    }
  }

  grouping te-all-attributes {
    description
      "TE attributes configuration grouping for all
       interfaces.";
    uses te-igp-flooding-bandwidth-config;
  }

  /*** End of TE interfaces device groupings ***/
  /**
   * TE device augmentations
   */

  augment "/te:te" {
    description
      "TE global container.";
    /* TE Interface Configuration Data */
    uses interfaces-grouping;
    container performance-thresholds {
      description
        "Performance parameters configurable thresholds.";
    }
  }

  /* TE globals device augmentation */

  augment "/te:te/te:globals" {
    description
      "Global TE device specific configuration parameters.";
    uses lsp-device-timers;
  }

  /* TE tunnels device configuration augmentation */

  augment "/te:te/te:tunnels/te:tunnel" {
    description
      "Tunnel device dependent augmentation.";
    leaf path-invalidation-action {
      type identityref {
        base te-types:path-invalidation-action-type;
      }
      description
        "Tunnel path invalidation action.";
    }
    uses lsp-device-timers;
  }

  /* TE LSPs device state augmentation */

  augment "/te:te/te:lsps/te:lsp" {
    description
      "TE LSP device dependent augmentation.";
    uses lsps-device-info;
  }

  /* TE interfaces RPCs/execution Data */

  rpc link-state-update {
    description
      "Triggers a link state update for the specific interface.";
    input {
      choice filter-type {
        mandatory true;
        description
          "Filter choice.";
        case match-all {
          leaf all {
            type empty;
            mandatory true;
            description
              "Match all TE interfaces.";
          }
        }
        case match-one-interface {
          leaf interface {
            type if:interface-ref;
            description
              "Match a specific TE interface.";
          }
        }
      }
    }
  }
}
<CODE ENDS>
]]></artwork></figure>

</section>
</section>
<section anchor="notifications" title="Notifications">

<t>Notifications are a key component of any topology data model.</t>

<t><xref target="RFC8639"/> and <xref target="RFC8641"/> define a subscription mechanism and a push
mechanism for YANG datastores.  These mechanisms currently allow the
user to:</t>

<t><list style="symbols">
  <t>Subscribe to notifications on a per-client basis.</t>
  <t>Specify subtree filters or XML Path Language (XPath) filters so
that only contents of interest will be sent.</t>
  <t>Specify either periodic or on-demand notifications.</t>
</list></t>

</section>
<section anchor="te-generic-and-helper-yang-modules" title="TE Generic and Helper YANG Modules">

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

<t>This document registers the following URIs in the IETF XML registry
<xref target="RFC3688"/>.
Following the format in <xref target="RFC3688"/>, the following registrations are
requested to be made.</t>

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

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

<t>This document registers two YANG modules in the YANG Module Names
registry <xref target="RFC6020"/>.</t>

<figure><artwork><![CDATA[
   Name:       ietf-te
   Namespace:  urn:ietf:params:xml:ns:yang:ietf-te
   Prefix:     te
   Reference:  RFCXXXX

   Name:       ietf-te-device
   Namespace:  urn:ietf:params:xml:ns:yang:ietf-te-device
   Prefix:     te-device
   Reference:  RFCXXXX
]]></artwork></figure>

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

<t>The YANG module specified in this document defines a schema for data that is
designed to be accessed via network management protocols such as NETCONF
<xref target="RFC6241"/> or RESTCONF <xref target="RFC8040"/>. The lowest NETCONF layer is the secure
transport layer, and the mandatory-to-implement secure transport is Secure
Shell (SSH) <xref target="RFC6242"/>. The lowest RESTCONF layer is HTTPS, and the
mandatory-to-implement secure transport is TLS <xref target="RFC8446"/>.</t>

<t>The Network Configuration Access Control Model (NACM) <xref target="RFC8341"/> provides the
means to restrict access for particular NETCONF or RESTCONF users to a
preconfigured subset of all available NETCONF or RESTCONF protocol operations
and content.</t>

<t>There are a number of data nodes defined in this YANG module that are
writable/creatable/deletable (i.e., config true, which is the default). These
data nodes may be considered sensitive or vulnerable in some network
environments. Write operations (e.g., edit-config) to these data nodes without
proper protection can have a negative effect on network operations. These are
the subtrees and data nodes and their sensitivity/vulnerability:</t>

<t>“/te/globals”:  This module specifies the global TE configurations on a device.
Unauthorized access to this container could cause the device to ignore packets
it should receive and process.</t>

<t>“/te/tunnels”:  This list specifies the configuration and state of TE Tunnels
present on the device or controller.  Unauthorized access to this list could
cause the device to ignore packets it should receive and process. An attacker
may also use state to derive information about the network topology,
and subsequently orchestrate further attacks.</t>

<t>“/te/interfaces”:  This list specifies the configuration and state TE interfaces
on a device. Unauthorized access to this list could cause the device to ignore packets it
should receive and process.</t>

<t>Some of the readable data nodes in this YANG module may be considered sensitive
or vulnerable in some network environments. It is thus important to control
read access (e.g., via get, get-config, or notification) to these data nodes.
These are the subtrees and data nodes and their sensitivity/vulnerability:</t>

<t>“/te/lsps”: this list contains information state about established LSPs in the network.
An attacker can use this information to derive information about the network topology,
and subsequently orchestrate further attacks.</t>

<t>Some of the RPC operations in this YANG module may be considered sensitive or
vulnerable in some network environments. It is thus important to control access
to these operations. These are the operations and their
sensitivity/vulnerability:</t>

<t>“/te/tunnels-actions”: using this RPC, an attacker can modify existing paths that
may be carrying live traffic, and hence result to interruption to services
carried over the network.</t>

<t>“/te/tunnels-path-compute”: using this RPC, an attacker can retrieve secured
information about the network provider which can be used to orchestrate further
attacks.</t>

<t>The security considerations spelled out in the YANG 1.1 specification
<xref target="RFC7950"/> apply for this document as well.</t>

</section>
<section anchor="acknowledgement" title="Acknowledgement">

<t>The authors would like to thank the  members of the multi-vendor YANG design
team who are involved in the definition of this model.</t>

<t>The authors would like to thank Tom Petch for reviewing and providing useful
feedback about the document. The authors would also like to thank Loa
Andersson, Lou Berger, Sergio Belotti, Italo Busi, Carlo Perocchio, Francesco
Lazzeri, Aihua Guo, Dhruv Dhody, and Raqib Jones for providing useful feedback on this
document.</t>

</section>
<section anchor="contributors" title="Contributors">

<figure><artwork><![CDATA[
   Himanshu Shah
   Ciena

   Email: hshah@ciena.com


   Xia Chen
   Huawei Technologies

   Email: jescia.chenxia@huawei.com


   Bin Wen
   Comcast

   Email: Bin_Wen@cable.comcast.com

]]></artwork></figure>

</section>
<section anchor="appendix-a-data-tree-examples" title="Appendix A: Data Tree Examples">

<t>This section contains examples of use of the model with RESTCONF <xref target="RFC8040"/> and JSON encoding.</t>

<t>For the example we will use a 4 node MPLS network were RSVP-TE MPLS Tunnels can be setup. The
loopbacks of each router are shown. The network in <xref target="AppFig-Topo"/> will be used in the examples
described in the following sections.</t>

<figure title="TE network used in data tree examples" anchor="AppFig-Topo"><artwork><![CDATA[
 10.0.0.1         10.0.0.2      10.0.0.4
 +-----+         +------+      +------+
 |     |         |      |      |      |
 |  A  +---------+  B   +------+  D   |
 +--+--+         +------+      +--+---+
    |                             |
    |            +-------+        |
    |            |       |        |
    +------------+   C   +--------+
                 |       |
                 +-------+
                 10.0.0.3
]]></artwork></figure>

<section anchor="TeTunnel" title="Basic Tunnel Setup">

<t>This example uses the TE Tunnel YANG data model defined in this document to create an
RSVP-TE signaled Tunnel of packet LSP encoding type. First, the TE Tunnel is created with no specific restrictions or constraints (e.g., protection or restoration).
The TE Tunnel ingresses on router A and egresses on router D.</t>

<t>In this case, the TE Tunnel is created without specifying additional information about the primary paths.</t>

<figure><artwork><![CDATA[
POST /restconf/data/ietf-te:te/tunnels HTTP/1.1
    Host: example.com
    Accept: application/yang-data+json
    Content-Type: application/yang-data+json
 
{
  "ietf-te:tunnel": [
    {
      "name": "Example_LSP_Tunnel_A_2",
      "encoding": "te-types:lsp-encoding-packet",
      "admin-state": "te-types:tunnel-state-up",
      "source": "10.0.0.1",
      "destination": "10.0.0.4",
      "bidirectional": "false",
      "signaling-type": "te-types:path-setup-rsvp"
    }
  ]
}
]]></artwork></figure>

</section>
<section anchor="global-named-path-constraints" title="Global Named Path Constraints">

<t>This example uses the YANG data model to create a ‘named path constraitnt’ that can be reference by TE Tunnels.
The path constraint, in this case, limits the TE Tunnel hops for the computed path.</t>

<figure><artwork><![CDATA[
POST /restconf/data/ietf-te:te/globals/named-path-constraints HTTP/1.1
    Host: example.com
    Accept: application/yang-data+json
    Content-Type: application/yang-data+json

{
  "ietf-te:named-path-constraint": {
          "name": "max-hop-3",
          "path-metric-bounds": {
            "path-metric-bound": {
              "metric-type": "te-types:path-metric-hop",
              "upper-bound": "3"
    }
   }
  }
}
]]></artwork></figure>

</section>
<section anchor="tunnel-with-global-path-constraint" title="Tunnel with Global Path Constraint">

<t>In this example, the previously created ‘named path constraint’ is applied to the TE Tunnel created in <xref target="TeTunnel"/>.</t>

<figure><artwork><![CDATA[
POST /restconf/data/ietf-te:te/tunnels HTTP/1.1
    Host: example.com
    Accept: application/yang-data+json
    Content-Type: application/yang-data+json

{
  "ietf-te:ietf-tunnel": [
    {
      "name": "Example_LSP_Tunnel_A_4_1",
      "encoding": "te-types:lsp-encoding-packet",
      "description": "Simple_LSP_with_named_path",
      "admin-state": "te-types:tunnel-state-up",
      "source": "10.0.0.1",
      "destination": "10.0.0.4",
      "signaling-type": "path-setup-rsvp",
      "bidirectional": "false",
      "primary-paths": [
        {
          "primary-path": {
            "name": "Simple_LSP_1",
            "use-path-computation": "true",
            "named-path-constraint": "max-hop-3"
          }
        }
      ]
    }
  ]
}
]]></artwork></figure>

</section>
<section anchor="tunnel-with-per-tunnel-path-constraint" title="Tunnel with Per-tunnel Path Constraint">

<t>In this example, the a per tunnel path constraint is explicitly indicated under the TE Tunnel created in <xref target="TeTunnel"/> to constrain the computed path for the tunnel.</t>

<figure><artwork><![CDATA[
POST /restconf/data/ietf-te:te/tunnels HTTP/1.1
    Host: example.com
    Accept: application/yang-data+json
    Content-Type: application/yang-data+json

{
  "ietf-te:tunnel": [
    {
      "name": "Example_LSP_Tunnel_A_4_2",
      "encoding": "te-types:lsp-encoding-packet",
      "admin-state": "te-types:tunnel-state-up",
      "source": "10.0.0.1",
      "destination": "10.0.0.4",
      "bidirectional": "false",
      "signaling-type": "te-types:path-setup-rsvp",
      "primary-paths": {
        "primary-path": [
          {
            "name": "path1",
            "path-metric-bounds": {
              "path-metric-bound": [ 
                {
                  "metric-type": "te-types:path-metric-hop",
                  "upper-bound": "3"
                }
              ]
            }
          }
        ]
      }
    }
  ]
}
]]></artwork></figure>

</section>
<section anchor="tunnel-state" title="Tunnel State">

<t>In this example, the ‘GET’ query is sent to return the state stored about the tunnel.</t>

<figure><artwork><![CDATA[
GET  /restconf/data/ietf-te:te/tunnels/tunnel="Example_LSP_Tunnel_A_4_1"
     /p2p-primary-paths/ HTTP/1.1
    Host: example.com
    Accept: application/yang-data+json
]]></artwork></figure>

<t>The request, with status code 200 would include, for example, the following json:</t>

<figure><artwork><![CDATA[
{
  "ietf-te:primary-paths": {
    "primary-path": [
      {
        "name": "path1",
        "path-computation-method": "te-types:path-locally-computed",
        "computed-paths-properties": {
          "computed-path-properties": [
            {
              "k-index": "1",
              "path-properties": {
                "path-route-objects": {
                  "path-route-object": [
                    {
                      "index": "1",
                      "numbered-node-hop": {
                        "node-id": "10.0.0.2"
                      }
                    },
                    {
                      "index": "2",
                      "numbered-node-hop": {
                        "node-id": "10.0.0.4"
                      }
                    }
                  ]
                }
              }
            }
          ]
        },
        "lsps": {
          "lsp": [
            {
              "tunnel-name": "Example_LSP_Tunnel_A_4_1",
              "node": "10.0.0.1 ",
              "lsp-id": "25356"
            }
          ]
        }
      }
    ]
  }
}
]]></artwork></figure>

</section>
</section>


  </middle>

  <back>

    <references title='Normative References'>





<reference anchor='RFC3209' target='https://www.rfc-editor.org/info/rfc3209'>
<front>
<title>RSVP-TE: Extensions to RSVP for LSP Tunnels</title>
<author fullname='D. Awduche' initials='D.' surname='Awduche'><organization/></author>
<author fullname='L. Berger' initials='L.' surname='Berger'><organization/></author>
<author fullname='D. Gan' initials='D.' surname='Gan'><organization/></author>
<author fullname='T. Li' initials='T.' surname='Li'><organization/></author>
<author fullname='V. Srinivasan' initials='V.' surname='Srinivasan'><organization/></author>
<author fullname='G. Swallow' initials='G.' surname='Swallow'><organization/></author>
<date month='December' year='2001'/>
<abstract><t>This document describes the use of RSVP (Resource Reservation Protocol), including all the necessary extensions, to establish label-switched paths (LSPs) in MPLS (Multi-Protocol Label Switching).  Since the flow along an LSP is completely identified by the label applied at the ingress node of the path, these paths may be treated as tunnels.  A key application of LSP tunnels is traffic engineering with MPLS as specified in RFC 2702.  [STANDARDS-TRACK]</t></abstract>
</front>
<seriesInfo name='RFC' value='3209'/>
<seriesInfo name='DOI' value='10.17487/RFC3209'/>
</reference>



<reference anchor='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='RFC6020' target='https://www.rfc-editor.org/info/rfc6020'>
<front>
<title>YANG - A Data Modeling Language for the Network Configuration Protocol (NETCONF)</title>
<author fullname='M. Bjorklund' initials='M.' role='editor' surname='Bjorklund'><organization/></author>
<date month='October' year='2010'/>
<abstract><t>YANG is a data modeling language used to model configuration and state data manipulated by the Network Configuration Protocol (NETCONF), NETCONF remote procedure calls, and NETCONF notifications. [STANDARDS-TRACK]</t></abstract>
</front>
<seriesInfo name='RFC' value='6020'/>
<seriesInfo name='DOI' value='10.17487/RFC6020'/>
</reference>



<reference anchor='RFC6241' target='https://www.rfc-editor.org/info/rfc6241'>
<front>
<title>Network Configuration Protocol (NETCONF)</title>
<author fullname='R. Enns' initials='R.' role='editor' surname='Enns'><organization/></author>
<author fullname='M. Bjorklund' initials='M.' role='editor' surname='Bjorklund'><organization/></author>
<author fullname='J. Schoenwaelder' initials='J.' role='editor' surname='Schoenwaelder'><organization/></author>
<author fullname='A. Bierman' initials='A.' role='editor' surname='Bierman'><organization/></author>
<date month='June' year='2011'/>
<abstract><t>The Network Configuration Protocol (NETCONF) defined in this document provides mechanisms to install, manipulate, and delete the configuration of network devices.  It uses an Extensible Markup Language (XML)-based data encoding for the configuration data as well as the protocol messages.  The NETCONF protocol operations are realized as remote procedure calls (RPCs).  This document obsoletes RFC 4741.  [STANDARDS-TRACK]</t></abstract>
</front>
<seriesInfo name='RFC' value='6241'/>
<seriesInfo name='DOI' value='10.17487/RFC6241'/>
</reference>



<reference anchor='RFC6991' target='https://www.rfc-editor.org/info/rfc6991'>
<front>
<title>Common YANG Data Types</title>
<author fullname='J. Schoenwaelder' initials='J.' role='editor' surname='Schoenwaelder'><organization/></author>
<date month='July' year='2013'/>
<abstract><t>This document introduces a collection of common data types to be used with the YANG data modeling language.  This document obsoletes RFC 6021.</t></abstract>
</front>
<seriesInfo name='RFC' value='6991'/>
<seriesInfo name='DOI' value='10.17487/RFC6991'/>
</reference>



<reference anchor='RFC6107' target='https://www.rfc-editor.org/info/rfc6107'>
<front>
<title>Procedures for Dynamically Signaled Hierarchical Label Switched Paths</title>
<author fullname='K. Shiomoto' initials='K.' role='editor' surname='Shiomoto'><organization/></author>
<author fullname='A. Farrel' initials='A.' role='editor' surname='Farrel'><organization/></author>
<date month='February' year='2011'/>
<abstract><t>Label Switched Paths (LSPs) set up in Multiprotocol Label Switching (MPLS) or Generalized MPLS (GMPLS) networks can be used to form links to carry traffic in those networks or in other (client) networks.</t><t>Protocol mechanisms already exist to facilitate the establishment of such LSPs and to bundle traffic engineering (TE) links to reduce the load on routing protocols.  This document defines extensions to those mechanisms to support identifying the use to which such LSPs are to be put and to enable the TE link endpoints to be assigned addresses or unnumbered identifiers during the signaling process.  [STANDARDS-TRACK]</t></abstract>
</front>
<seriesInfo name='RFC' value='6107'/>
<seriesInfo name='DOI' value='10.17487/RFC6107'/>
</reference>



<reference anchor='RFC8040' target='https://www.rfc-editor.org/info/rfc8040'>
<front>
<title>RESTCONF Protocol</title>
<author fullname='A. Bierman' initials='A.' surname='Bierman'><organization/></author>
<author fullname='M. Bjorklund' initials='M.' surname='Bjorklund'><organization/></author>
<author fullname='K. Watsen' initials='K.' surname='Watsen'><organization/></author>
<date month='January' year='2017'/>
<abstract><t>This document describes an HTTP-based protocol that provides a programmatic interface for accessing data defined in YANG, using the datastore concepts defined in the Network Configuration Protocol (NETCONF).</t></abstract>
</front>
<seriesInfo name='RFC' value='8040'/>
<seriesInfo name='DOI' value='10.17487/RFC8040'/>
</reference>



<reference anchor='RFC7950' target='https://www.rfc-editor.org/info/rfc7950'>
<front>
<title>The YANG 1.1 Data Modeling Language</title>
<author fullname='M. Bjorklund' initials='M.' role='editor' surname='Bjorklund'><organization/></author>
<date month='August' year='2016'/>
<abstract><t>YANG is a data modeling language used to model configuration data, state data, Remote Procedure Calls, and notifications for network management protocols.  This document describes the syntax and semantics of version 1.1 of the YANG language.  YANG version 1.1 is a maintenance release of the YANG language, addressing ambiguities and defects in the original specification.  There are a small number of backward incompatibilities from YANG version 1.  This document also specifies the YANG mappings to the Network Configuration Protocol (NETCONF).</t></abstract>
</front>
<seriesInfo name='RFC' value='7950'/>
<seriesInfo name='DOI' value='10.17487/RFC7950'/>
</reference>



<reference anchor='RFC3473' target='https://www.rfc-editor.org/info/rfc3473'>
<front>
<title>Generalized Multi-Protocol Label Switching (GMPLS) Signaling Resource ReserVation Protocol-Traffic Engineering (RSVP-TE) Extensions</title>
<author fullname='L. Berger' initials='L.' role='editor' surname='Berger'><organization/></author>
<date month='January' year='2003'/>
<abstract><t>This document describes extensions to Multi-Protocol Label Switching (MPLS) Resource ReserVation Protocol - Traffic Engineering (RSVP-TE) signaling required to support Generalized MPLS.  Generalized MPLS extends the MPLS control plane to encompass time-division (e.g., Synchronous Optical Network and Synchronous Digital Hierarchy, SONET/SDH), wavelength (optical lambdas) and spatial switching (e.g., incoming port or fiber to outgoing port or fiber).  This document presents a RSVP-TE specific description of the extensions.  A generic functional description can be found in separate documents.  [STANDARDS-TRACK]</t></abstract>
</front>
<seriesInfo name='RFC' value='3473'/>
<seriesInfo name='DOI' value='10.17487/RFC3473'/>
</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='RFC8294' target='https://www.rfc-editor.org/info/rfc8294'>
<front>
<title>Common YANG Data Types for the Routing Area</title>
<author fullname='X. Liu' initials='X.' surname='Liu'><organization/></author>
<author fullname='Y. Qu' initials='Y.' surname='Qu'><organization/></author>
<author fullname='A. Lindem' initials='A.' surname='Lindem'><organization/></author>
<author fullname='C. Hopps' initials='C.' surname='Hopps'><organization/></author>
<author fullname='L. Berger' initials='L.' surname='Berger'><organization/></author>
<date month='December' year='2017'/>
<abstract><t>This document defines a collection of common data types using the YANG data modeling language.  These derived common types are designed to be imported by other modules defined in the routing area.</t></abstract>
</front>
<seriesInfo name='RFC' value='8294'/>
<seriesInfo name='DOI' value='10.17487/RFC8294'/>
</reference>



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



<reference anchor='RFC8342' target='https://www.rfc-editor.org/info/rfc8342'>
<front>
<title>Network Management Datastore Architecture (NMDA)</title>
<author fullname='M. Bjorklund' initials='M.' surname='Bjorklund'><organization/></author>
<author fullname='J. Schoenwaelder' initials='J.' surname='Schoenwaelder'><organization/></author>
<author fullname='P. Shafer' initials='P.' surname='Shafer'><organization/></author>
<author fullname='K. Watsen' initials='K.' surname='Watsen'><organization/></author>
<author fullname='R. Wilton' initials='R.' surname='Wilton'><organization/></author>
<date month='March' year='2018'/>
<abstract><t>Datastores are a fundamental concept binding the data models written in the YANG data modeling language to network management protocols such as the Network Configuration Protocol (NETCONF) and RESTCONF. This document defines an architectural framework for datastores based on the experience gained with the initial simpler model, addressing requirements that were not well supported in the initial model.  This document updates RFC 7950.</t></abstract>
</front>
<seriesInfo name='RFC' value='8342'/>
<seriesInfo name='DOI' value='10.17487/RFC8342'/>
</reference>



<reference anchor='RFC3945' target='https://www.rfc-editor.org/info/rfc3945'>
<front>
<title>Generalized Multi-Protocol Label Switching (GMPLS) Architecture</title>
<author fullname='E. Mannie' initials='E.' role='editor' surname='Mannie'><organization/></author>
<date month='October' year='2004'/>
<abstract><t>Future data and transmission networks will consist of elements such as routers, switches, Dense Wavelength Division Multiplexing (DWDM) systems, Add-Drop Multiplexors (ADMs), photonic cross-connects (PXCs), optical cross-connects (OXCs), etc. that will use Generalized Multi-Protocol Label Switching (GMPLS) to dynamically provision resources and to provide network survivability using protection and restoration techniques. </t><t> This document describes the architecture of GMPLS.  GMPLS extends MPLS to encompass time-division (e.g., SONET/SDH, PDH, G.709), wavelength (lambdas), and spatial switching (e.g., incoming port or fiber to outgoing port or fiber).  The focus of GMPLS is on the control plane of these various layers since each of them can use physically diverse data or forwarding planes.  The intention is to cover both the signaling and the routing part of that control plane.  [STANDARDS-TRACK]</t></abstract>
</front>
<seriesInfo name='RFC' value='3945'/>
<seriesInfo name='DOI' value='10.17487/RFC3945'/>
</reference>



<reference anchor='RFC8795' target='https://www.rfc-editor.org/info/rfc8795'>
<front>
<title>YANG Data Model for Traffic Engineering (TE) Topologies</title>
<author fullname='X. Liu' initials='X.' surname='Liu'><organization/></author>
<author fullname='I. Bryskin' initials='I.' surname='Bryskin'><organization/></author>
<author fullname='V. Beeram' initials='V.' surname='Beeram'><organization/></author>
<author fullname='T. Saad' initials='T.' surname='Saad'><organization/></author>
<author fullname='H. Shah' initials='H.' surname='Shah'><organization/></author>
<author fullname='O. Gonzalez de Dios' initials='O.' surname='Gonzalez de Dios'><organization/></author>
<date month='August' year='2020'/>
<abstract><t>This document defines a YANG data model for representing, retrieving, and manipulating Traffic Engineering (TE) Topologies. The model serves as a base model that other technology-specific TE topology models can augment.</t></abstract>
</front>
<seriesInfo name='RFC' value='8795'/>
<seriesInfo name='DOI' value='10.17487/RFC8795'/>
</reference>



<reference anchor='RFC4875' target='https://www.rfc-editor.org/info/rfc4875'>
<front>
<title>Extensions to Resource Reservation Protocol - Traffic Engineering (RSVP-TE) for Point-to-Multipoint TE Label Switched Paths (LSPs)</title>
<author fullname='R. Aggarwal' initials='R.' role='editor' surname='Aggarwal'><organization/></author>
<author fullname='D. Papadimitriou' initials='D.' role='editor' surname='Papadimitriou'><organization/></author>
<author fullname='S. Yasukawa' initials='S.' role='editor' surname='Yasukawa'><organization/></author>
<date month='May' year='2007'/>
<abstract><t>This document describes extensions to Resource Reservation Protocol - Traffic Engineering (RSVP-TE) for the set up of Traffic Engineered (TE) point-to-multipoint (P2MP) Label Switched Paths (LSPs) in Multi- Protocol Label Switching (MPLS) and Generalized MPLS (GMPLS) networks.  The solution relies on RSVP-TE without requiring a multicast routing protocol in the Service Provider core.  Protocol elements and procedures for this solution are described.</t><t>There can be various applications for P2MP TE LSPs such as IP multicast.  Specification of how such applications will use a P2MP TE LSP is outside the scope of this document.  [STANDARDS-TRACK]</t></abstract>
</front>
<seriesInfo name='RFC' value='4875'/>
<seriesInfo name='DOI' value='10.17487/RFC4875'/>
</reference>



<reference anchor='RFC7551' target='https://www.rfc-editor.org/info/rfc7551'>
<front>
<title>RSVP-TE Extensions for Associated Bidirectional Label Switched Paths (LSPs)</title>
<author fullname='F. Zhang' initials='F.' role='editor' surname='Zhang'><organization/></author>
<author fullname='R. Jing' initials='R.' surname='Jing'><organization/></author>
<author fullname='R. Gandhi' initials='R.' role='editor' surname='Gandhi'><organization/></author>
<date month='May' year='2015'/>
<abstract><t>This document describes Resource Reservation Protocol (RSVP) extensions to bind two point-to-point unidirectional Label Switched Paths (LSPs) into an associated bidirectional LSP.  The association is achieved by defining new Association Types for use in ASSOCIATION and in Extended ASSOCIATION Objects. One of these types enables independent provisioning of the associated bidirectional LSPs on both sides, while the other enables single-sided provisioning.  The REVERSE_LSP Object is also defined to enable a single endpoint to trigger creation of the reverse LSP and to specify parameters of the reverse LSP in the single-sided provisioning case.</t></abstract>
</front>
<seriesInfo name='RFC' value='7551'/>
<seriesInfo name='DOI' value='10.17487/RFC7551'/>
</reference>



<reference anchor='RFC4206' target='https://www.rfc-editor.org/info/rfc4206'>
<front>
<title>Label Switched Paths (LSP) Hierarchy with Generalized Multi-Protocol Label Switching (GMPLS) Traffic Engineering (TE)</title>
<author fullname='K. Kompella' initials='K.' surname='Kompella'><organization/></author>
<author fullname='Y. Rekhter' initials='Y.' surname='Rekhter'><organization/></author>
<date month='October' year='2005'/>
<abstract><t>To improve scalability of Generalized Multi-Protocol Label Switching (GMPLS) it may be useful to aggregate Label Switched Paths (LSPs) by creating a hierarchy of such LSPs.  A way to create such a hierarchy is by (a) a Label Switching Router (LSR) creating a Traffic Engineering Label Switched Path (TE LSP), (b) the LSR forming a forwarding adjacency (FA) out of that LSP (by advertising this LSP as a Traffic Engineering (TE) link into the same instance of ISIS/OSPF as the one that was used to create the LSP), (c) allowing other LSRs to use FAs for their path computation, and (d) nesting of LSPs originated by other LSRs into that LSP (by using the label stack construct).</t><t>This document describes the mechanisms to accomplish this.  [PROPOSED STANDARD]</t></abstract>
</front>
<seriesInfo name='RFC' value='4206'/>
<seriesInfo name='DOI' value='10.17487/RFC4206'/>
</reference>



<reference anchor='RFC4872' target='https://www.rfc-editor.org/info/rfc4872'>
<front>
<title>RSVP-TE Extensions in Support of End-to-End Generalized Multi-Protocol Label Switching (GMPLS) Recovery</title>
<author fullname='J.P. Lang' initials='J.P.' role='editor' surname='Lang'><organization/></author>
<author fullname='Y. Rekhter' initials='Y.' role='editor' surname='Rekhter'><organization/></author>
<author fullname='D. Papadimitriou' initials='D.' role='editor' surname='Papadimitriou'><organization/></author>
<date month='May' year='2007'/>
<abstract><t>This document describes protocol-specific procedures and extensions for Generalized Multi-Protocol Label Switching (GMPLS) Resource ReSerVation Protocol - Traffic Engineering (RSVP-TE) signaling to support end-to-end Label Switched Path (LSP) recovery that denotes protection and restoration.  A generic functional description of GMPLS recovery can be found in a companion document, RFC 4426.  [STANDARDS-TRACK]</t></abstract>
</front>
<seriesInfo name='RFC' value='4872'/>
<seriesInfo name='DOI' value='10.17487/RFC4872'/>
</reference>



<reference anchor='RFC6780' target='https://www.rfc-editor.org/info/rfc6780'>
<front>
<title>RSVP ASSOCIATION Object Extensions</title>
<author fullname='L. Berger' initials='L.' surname='Berger'><organization/></author>
<author fullname='F. Le Faucheur' initials='F.' surname='Le Faucheur'><organization/></author>
<author fullname='A. Narayanan' initials='A.' surname='Narayanan'><organization/></author>
<date month='October' year='2012'/>
<abstract><t>The RSVP ASSOCIATION object was defined in the context of GMPLS-controlled Label Switched Paths (LSPs).  In this context, the object is used to associate recovery LSPs with the LSP they are protecting.  This object also has broader applicability as a mechanism to associate RSVP state.  This document defines how the ASSOCIATION object can be more generally applied.  This document also defines Extended ASSOCIATION objects that, in particular, can be used in the context of the MPLS Transport Profile (MPLS-TP).  This document updates RFC 2205, RFC 3209, and RFC 3473.  It also generalizes the definition of the Association ID field defined in RFC 4872.  [STANDARDS-TRACK]</t></abstract>
</front>
<seriesInfo name='RFC' value='6780'/>
<seriesInfo name='DOI' value='10.17487/RFC6780'/>
</reference>



<reference anchor='RFC7308' target='https://www.rfc-editor.org/info/rfc7308'>
<front>
<title>Extended Administrative Groups in MPLS Traffic Engineering (MPLS-TE)</title>
<author fullname='E. Osborne' initials='E.' surname='Osborne'><organization/></author>
<date month='July' year='2014'/>
<abstract><t>MPLS Traffic Engineering (MPLS-TE) advertises 32 administrative groups (commonly referred to as &quot;colors&quot; or &quot;link colors&quot;) using the Administrative Group sub-TLV.  This is defined for OSPFv2 (RFC 3630), OSPFv3 (RFC 5329) and IS-IS (RFC 5305).</t><t>This document adds a sub-TLV to the IGP TE extensions, &quot;Extended Administrative Group&quot;.  This sub-TLV provides for additional administrative groups (link colors) beyond the current limit of 32.</t></abstract>
</front>
<seriesInfo name='RFC' value='7308'/>
<seriesInfo name='DOI' value='10.17487/RFC7308'/>
</reference>



<reference anchor='RFC8343' target='https://www.rfc-editor.org/info/rfc8343'>
<front>
<title>A YANG Data Model for Interface Management</title>
<author fullname='M. Bjorklund' initials='M.' surname='Bjorklund'><organization/></author>
<date month='March' year='2018'/>
<abstract><t>This document defines a YANG data model for the management of network interfaces.  It is expected that interface-type-specific data models augment the generic interfaces data model defined in this document. The data model includes definitions for configuration and system state (status information and counters for the collection of statistics).</t><t>The YANG data model in this document conforms to the Network Management Datastore Architecture (NMDA) defined in RFC 8342.</t><t>This document obsoletes RFC 7223.</t></abstract>
</front>
<seriesInfo name='RFC' value='8343'/>
<seriesInfo name='DOI' value='10.17487/RFC8343'/>
</reference>



<reference anchor='RFC8639' target='https://www.rfc-editor.org/info/rfc8639'>
<front>
<title>Subscription to YANG Notifications</title>
<author fullname='E. Voit' initials='E.' surname='Voit'><organization/></author>
<author fullname='A. Clemm' initials='A.' surname='Clemm'><organization/></author>
<author fullname='A. Gonzalez Prieto' initials='A.' surname='Gonzalez Prieto'><organization/></author>
<author fullname='E. Nilsen-Nygaard' initials='E.' surname='Nilsen-Nygaard'><organization/></author>
<author fullname='A. Tripathy' initials='A.' surname='Tripathy'><organization/></author>
<date month='September' year='2019'/>
<abstract><t>This document defines a YANG data model and associated mechanisms enabling subscriber-specific subscriptions to a publisher's event streams.  Applying these elements allows a subscriber to request and receive a continuous, customized feed of publisher-generated information.</t></abstract>
</front>
<seriesInfo name='RFC' value='8639'/>
<seriesInfo name='DOI' value='10.17487/RFC8639'/>
</reference>



<reference anchor='RFC8641' target='https://www.rfc-editor.org/info/rfc8641'>
<front>
<title>Subscription to YANG Notifications for Datastore Updates</title>
<author fullname='A. Clemm' initials='A.' surname='Clemm'><organization/></author>
<author fullname='E. Voit' initials='E.' surname='Voit'><organization/></author>
<date month='September' year='2019'/>
<abstract><t>This document describes a mechanism that allows subscriber applications to request a continuous and customized stream of updates from a YANG datastore.  Providing such visibility into updates enables new capabilities based on the remote mirroring and monitoring of configuration and operational state.</t></abstract>
</front>
<seriesInfo name='RFC' value='8641'/>
<seriesInfo name='DOI' value='10.17487/RFC8641'/>
</reference>



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



<reference anchor='RFC6242' target='https://www.rfc-editor.org/info/rfc6242'>
<front>
<title>Using the NETCONF Protocol over Secure Shell (SSH)</title>
<author fullname='M. Wasserman' initials='M.' surname='Wasserman'><organization/></author>
<date month='June' year='2011'/>
<abstract><t>This document describes a method for invoking and running the Network Configuration Protocol (NETCONF) within a Secure Shell (SSH) session as an SSH subsystem.  This document obsoletes RFC 4742.  [STANDARDS-TRACK]</t></abstract>
</front>
<seriesInfo name='RFC' value='6242'/>
<seriesInfo name='DOI' value='10.17487/RFC6242'/>
</reference>



<reference anchor='RFC8446' target='https://www.rfc-editor.org/info/rfc8446'>
<front>
<title>The Transport Layer Security (TLS) Protocol Version 1.3</title>
<author fullname='E. Rescorla' initials='E.' surname='Rescorla'><organization/></author>
<date month='August' year='2018'/>
<abstract><t>This document specifies version 1.3 of the Transport Layer Security (TLS) protocol.  TLS allows client/server applications to communicate over the Internet in a way that is designed to prevent eavesdropping, tampering, and message forgery.</t><t>This document updates RFCs 5705 and 6066, and obsoletes RFCs 5077, 5246, and 6961.  This document also specifies new requirements for TLS 1.2 implementations.</t></abstract>
</front>
<seriesInfo name='RFC' value='8446'/>
<seriesInfo name='DOI' value='10.17487/RFC8446'/>
</reference>



<reference anchor='RFC8341' target='https://www.rfc-editor.org/info/rfc8341'>
<front>
<title>Network Configuration Access Control Model</title>
<author fullname='A. Bierman' initials='A.' surname='Bierman'><organization/></author>
<author fullname='M. Bjorklund' initials='M.' surname='Bjorklund'><organization/></author>
<date month='March' year='2018'/>
<abstract><t>The standardization of network configuration interfaces for use with the Network Configuration Protocol (NETCONF) or the RESTCONF protocol requires a structured and secure operating environment that promotes human usability and multi-vendor interoperability.  There is a need for standard mechanisms to restrict NETCONF or RESTCONF protocol access for particular users to a preconfigured subset of all available NETCONF or RESTCONF protocol operations and content.  This document defines such an access control model.</t><t>This document obsoletes RFC 6536.</t></abstract>
</front>
<seriesInfo name='STD' value='91'/>
<seriesInfo name='RFC' value='8341'/>
<seriesInfo name='DOI' value='10.17487/RFC8341'/>
</reference>




    </references>

    <references title='Informative References'>




<reference anchor='I-D.ietf-spring-segment-routing-policy'>
   <front>
      <title>Segment Routing Policy Architecture</title>
      <author fullname='Clarence Filsfils'>
	 <organization>Cisco Systems</organization>
      </author>
      <author fullname='Ketan Talaulikar'>
	 <organization>Cisco Systems</organization>
      </author>
      <author fullname='Daniel Voyer'>
	 <organization>Bell Canada</organization>
      </author>
      <author fullname='Alex Bogdanov'>
	 <organization>British Telecom</organization>
      </author>
      <author fullname='Paul Mattes'>
	 <organization>Microsoft</organization>
      </author>
      <date day='28' month='January' year='2022'/>
      <abstract>
	 <t>   Segment Routing (SR) allows a headend node to steer a packet flow
   along any path.  Intermediate per-path states are eliminated thanks
   to source routing.  The headend node steers a flow into an SR Policy.
   The packets steered into an SR Policy carry an ordered list of
   segments associated with that SR Policy.  This document details the
   concepts of SR Policy and steering into an SR Policy.

	 </t>
      </abstract>
   </front>
   <seriesInfo name='Internet-Draft' value='draft-ietf-spring-segment-routing-policy-16'/>
   <format target='https://www.ietf.org/archive/id/draft-ietf-spring-segment-routing-policy-16.txt' type='TXT'/>
</reference>


<reference anchor='I-D.ietf-teas-yang-rsvp'>
   <front>
      <title>A YANG Data Model for Resource Reservation Protocol (RSVP)</title>
      <author fullname='Vishnu Pavan Beeram'>
	 <organization>Juniper Networks</organization>
      </author>
      <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='Igor Bryskin'>
	 <organization>Individual</organization>
      </author>
      <date day='9' month='January' year='2022'/>
      <abstract>
	 <t>   This document defines a YANG data model for the configuration and
   management of the RSVP protocol.  The YANG data model covers the
   building blocks that may be augmented by other RSVP extension data
   models such as RSVP Traffic-Engineering (RSVP-TE).  It is divided
   into two modules that cover the basic and extended RSVP features.

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



<reference anchor='RFC9012' target='https://www.rfc-editor.org/info/rfc9012'>
<front>
<title>The BGP Tunnel Encapsulation Attribute</title>
<author fullname='K. Patel' initials='K.' surname='Patel'><organization/></author>
<author fullname='G. Van de Velde' initials='G.' surname='Van de Velde'><organization/></author>
<author fullname='S. Sangli' initials='S.' surname='Sangli'><organization/></author>
<author fullname='J. Scudder' initials='J.' surname='Scudder'><organization/></author>
<date month='April' year='2021'/>
<abstract><t>This document defines a BGP path attribute known as the &quot;Tunnel Encapsulation attribute&quot;, which can be used with BGP UPDATEs of various Subsequent Address Family Identifiers (SAFIs) to provide information needed to create tunnels and their corresponding encapsulation headers. It provides encodings for a number of tunnel types, along with procedures for choosing between alternate tunnels and routing packets into tunnels.</t><t>This document obsoletes RFC 5512, which provided an earlier definition of the Tunnel Encapsulation attribute. RFC 5512 was never deployed in production. Since RFC 5566 relies on RFC 5512, it is likewise obsoleted. This document updates RFC 5640 by indicating that the Load-Balancing Block sub-TLV may be included in any Tunnel Encapsulation attribute where load balancing is desired.</t></abstract>
</front>
<seriesInfo name='RFC' value='9012'/>
<seriesInfo name='DOI' value='10.17487/RFC9012'/>
</reference>



<reference anchor='RFC4427' target='https://www.rfc-editor.org/info/rfc4427'>
<front>
<title>Recovery (Protection and Restoration) Terminology for Generalized Multi-Protocol Label Switching (GMPLS)</title>
<author fullname='E. Mannie' initials='E.' role='editor' surname='Mannie'><organization/></author>
<author fullname='D. Papadimitriou' initials='D.' role='editor' surname='Papadimitriou'><organization/></author>
<date month='March' year='2006'/>
<abstract><t>This document defines a common terminology for Generalized Multi-Protocol Label Switching (GMPLS)-based recovery mechanisms (i.e., protection and restoration).  The terminology is independent of the underlying transport technologies covered by GMPLS.  This memo provides information for the Internet community.</t></abstract>
</front>
<seriesInfo name='RFC' value='4427'/>
<seriesInfo name='DOI' value='10.17487/RFC4427'/>
</reference>



<reference anchor='RFC8800' target='https://www.rfc-editor.org/info/rfc8800'>
<front>
<title>Path Computation Element Communication Protocol (PCEP) Extension for Label Switched Path (LSP) Diversity Constraint Signaling</title>
<author fullname='S. Litkowski' initials='S.' surname='Litkowski'><organization/></author>
<author fullname='S. Sivabalan' initials='S.' surname='Sivabalan'><organization/></author>
<author fullname='C. Barth' initials='C.' surname='Barth'><organization/></author>
<author fullname='M. Negi' initials='M.' surname='Negi'><organization/></author>
<date month='July' year='2020'/>
<abstract><t>This document introduces a simple mechanism to associate a group of Label Switched Paths (LSPs) via an extension to the Path Computation Element Communication Protocol (PCEP) with the purpose of computing diverse (disjointed) paths for those LSPs.  The proposed extension allows a Path Computation Client (PCC) to advertise to a Path Computation Element (PCE) that a particular LSP belongs to a particular Disjoint Association Group; thus, the PCE knows that the LSPs in the same group need to be disjoint from each other.</t></abstract>
</front>
<seriesInfo name='RFC' value='8800'/>
<seriesInfo name='DOI' value='10.17487/RFC8800'/>
</reference>




    </references>



  </back>

<!-- ##markdown-source:
H4sIAPcpAWIAA+y9a3ccx60o+n1+RW1m3UXS4YwetmObTmzLkqzoHFnWFZnH
Xnvn7NWcaZIdDacn0z2SuS3lt5zfcn/ZBVAv1LOrR7Js7bCTZQ2764FCoQAU
gEJNp9NJ3/TL+ljcE/9+7+kj8aDqK/F9u6iX4rzdiNNNdX7ezMXD1UWzqutN
s7oQp9vVql52R+JJdQbFTl41/fyyXohnVX/ZiWq1EI9Xfb05r+Z1N6nOzjb1
y2Nx+tBvf7Jo56vqCrpeQCf9tKn782lfV930ulpdwK/p3S8m86qvL9rN9bHo
+sWkWW+ORb/Zdv3d27e/uH138qrdvLjYtNs1dnDvRPwF/kYQH+G7yYv6Ggos
jiU8q7qfPsCeJpOuByj/q1q2K+j9GqBcN8fiP/p2fiS6dtNv6nMYXXd9JX/M
26uretV3f5tMqm1/2W6OJxMxnQh4mlUHPc/ESVUt6IUc0Gm1qV/Yl+3molo1
/131Tbs6Fv9ru2rW9UY8rXsEv6Mi9VXVLGFsHdT55u+yxAwgVh1RP89n4hHA
fdlMTEfPqxd1d8leu13db7p5K06uu76+6gAL84ntCgtCpW/mWGYGY5zwvv46
E0+are3or9vzGvCq3rm9/Lldwpzy4agufqRKs2WzneHkfnOBr4Ou/jwTz2bi
WyCu6sp2+Oemu1xtgaZeViv2cRiVqu+XZ1THwaUza4+hz811B+TCJu4x0Jrz
2u3v8WrRvGwW22rJJ635rzNZ45vr6rJ1cCm7+gEmrl39d7Ws/1ssavGgaTvW
5w/dvNrEC7i9n9bL+rxdNfOK995i9dmFqr6oF1D5m94UldCs2s0VtPKyPoaq
z7+7//Hd21+on3fv3NE/f3f77m398+4nd/TPL74wP+/c/kz9/Pz2J1B20qzO
bdOT6XQqqrOu31RzwPbpZdMJWORbXD0wrnPgIMAfJB9YIB+4Mnymv6zFetO+
bDoYKq5gZCNX1aq6qKl2ez6JsaKD04eHos/yo4MnJ8+6wyNqsDF8aQbQ1ap/
hBKntaYCrYQPPm2XAG5/WfVivqy6rjm/llBToYt6BSDMjyaL+mUzr6fdup43
AN6R6Ov55apdthfXorpYtV2PL7F3+8GUFjBPxFtmCl0Sonn7st50sjfEzrxd
nTcX2w0RwpFogaDpZ7UEtggc8khs6qu2JxTO6wUUXALnXCJOsOP6JaJw1fbY
JVXE/nCyrprFYllPJr9BFrmBIc/x62RCKPjpp39TRPHmDbUjX3z2xaf4osGp
tLOIs7EEvr2FGZNIe1V1QB6yVUAt4EySAM01jKjHccPEQjPw17xe97CuZItd
325UKzCK9lU3WckVDu1IfHfY3lmtSGQhth0C8PTh6f0fnn6nIQcafvNmJufz
suqIwOrFZANIB67SQ/3rFqkCwGhWTd9US4lpIFNAXCfOGljvqwvqqwWoN4yA
xEE9u5hNnj880V2qRfHmzaFE+mreYm1VEwazEn/9/omsJ/7XyQ9PoRyM8qzG
QhI1i9nku+0Gy18BAo78ldKJOTQCo952MOSqI0yeVV1DaGyu1pKYaIaRbiY+
0CDUtvNLrHn/yWOCElByAWwSV/Bc3Hv22BAiW7fdfNOcwYhj63ZwUU7GLEph
FyVfAtV6vQTCPQNKtSsPmKOihSlMU72u4T+r/kgE6xH7+H677EF5aEHEt0vJ
JyYSJAL4+2dPTg75wtW1CRt1DBmVuGwuLqdASQAsUJRcVpfNGuanf1XXK5oc
zUXU9MJYJz3HLpHZq3q5xH/lbNU/oq4CpGjA5fxoJghHoE0pNEz8WVm00B+s
dehrvtyCNKlWim8ZpgNIhL+aC+gFh687grYf9xOArv4RSvYAroSIKq9hcdcc
RdTbQXcoXjUI/vaCENRngZuJyeTesmuPYM2JsCM2UGyY1r8cFDQZwgvEpcn5
+cmfn02h0AEtQ5Rub94cKTbw8SeffQyL8ggJ5qQmMKfP221PqixUOXk+RYKd
/PTT14+nD0hTAepBSp52qvhGFp+uW6DDa2B+wZg1UWo1Vw1jhqz1ef2PbbOR
fB5oT/JISVigoQpUUTux9/2fTk73juS/4ukP9Pv5w//3T4+fP3yAv0/+eO/J
E/Njokqc/PGHPz15YH/Zmvd/+P77h08fyMrwVjivJnvf3/v3Pbk49n54dvr4
h6f3nuwBzQiHPolDSU5Ly3S9qXtiPRO9EpCmxbf3n/1///fOJwrhqFEAjuQf
n9/57BNE2GW9kr21q+W1+hMQdz2BxV1XyKSQ1QODWzd9tZT8t7tsX60EUAbi
kfB13qI4wJkDYEClRfDs2nL4PnWG34lZ6oHpNSBVqsnkI5DtDQwUf3AhS0QL
L0m8yj88vghAtiB+QP/GHpAB9wGAjVorTAwSIPXE2wthBU0ZjpglEBWhwS+7
lPQfK/gDiOw34hlsVpofaxRlsuGn8EU8BRWzm0wee/N6RLoniQ3Tity6sSUv
l1579ndYoxLVa9nHYiLFLQ6YtlLVZqG+wbR17bypkEqAv14qYb/Z1N26JWkq
1wcIK9hoQUuKr7H5pnnsqzOU3aBHv1YjE+Z5zRkFf/28PgdaAVWCvYQGpv4T
vkm/xgYEbkiF4F0Rl5D71Os1oE69VgQIGjMQoIUAxlT3kQbwdVkDG6ecaUAz
Jv1NN/D53S8+cRuA7XSsgfC1auCzz34XNLCu5i8MwLYB73W6AeE8pgH/tcuB
HAhAuEcamEqZn2/gp2PxG6QqQfaOP+yZ9YJUH6FQRZh7b2h1SYvI6abG3VmF
KlMnOVKPrxbqFQpv3PsA8Z9v2iumAqA8Y4wqZLIXsINC2geRdtaBwMD3XU3q
eIdrY13LTVJ3DQrejyHT+/xjVD1J3jyoUVaK+1ATNjWSn3Vpta4KhBdb/SSD
G2QqRsXCvZjWKXytAFSIH1aGGS4kIJKDwPg6bAmVD+SRhhVPMvoFFd/UyGBd
zYLDSHpsCxu0syWIEyWUQcGQ/CdU6qiu0uz0/kuDnEbFkVKolNpgjWCgyZJk
m7DNwWX1shbLujo3ekyDqMMtJPbCgFpW1zCzr1DIkTyE0eKswUagRV2wQqWe
JCV2ZDcVuNhoN5Bq1+fD1cQAjYoQNDbTulh+3FahJJU8oocpfCI6Ix9J/MIs
NisUFT2ChL0g2ojwgYPhgCVxz2FrK6ei6SZ2feB2SquKUhshWOCvs2stHSWZ
84WhRJlqBWZi5isRqoQk07mzXqTmA+J9Jff71XzebleKqJBXADRSL3CMNCiu
T/P43Fdca582wVVDQBP/4otMbnxWaEDkmz6ARM0Kfm/PcfesasuNJaguFfaK
bW9goPXmUO4ZoCFva4TFpEHDQZuSq/suc91HpU9wEQ3K0rzfLEHRhjGDgkFD
rmCdgNrTXMEGxqytxmyGcLVuNGOopCop9q5QhYAt//UejA86kfzhHDjrAplo
K4A1LtqN5B2Lai1Vbs6lWnzTbOwSX0tjBjTmbotnAOvJFlRM2EzioCvYGMq5
VlWRdcP6IF1UK4RY1hpqPmK71EU9X0JlZKKr7dUZEBMQL6D1fLuyrPu8rvrt
xtiSaDYBsHYtTTigDnfbtVSHZiRsTkjpJCXuB0ZcknqVrVN8b41jWFKaTO5t
YEcLXAD7EwdPv39w79DKh7uoFC8WAEkHOqGx2lgVl0Zery+hVZhIrfkR+Tji
agGgS+MD9qD00cBORcuWNb6pQUXsjH1CybTHD0+/ExfbhoABHGEzq/rVhN5r
QQyMliSblMI/wNJ/2UAZuTdn5pGkhJWsS+mixH/cSYE5nKCZnzYnZjaQuyya
c1Iqe0WEHj0pm4WqgrOP+3dYwgvgC7oKX3CqX5QLfAOs91iibognOUwNt65k
Z1SsSZK7IcH4mHHLJBUXXM3PmYVC4q1A6LOm9xQ3mKHOu6etM7iTOds2SxJJ
Z8t2/sLiM8bUaEumbKJk+VtZqTxhwkuSEvIvpRdI4WFMRMi4ZOs+DiZ7LttS
8Cp0dkOyTuqCxvI00ZhwTSeq7+lUyBWjpXTV96BSbXu5sYLmueUNphDe9M2V
RJxCEuCsWspW4Stuw5SQ0rzZmtoMDAYZZvsWKE/1j03X05560tXraoOLMGZd
yZkwuNkGlJGJo4ygxQwNLkpYGKxDiU7h3CWgauWK4wnRAp8Wptypyeii4mYk
giIqiad2TBy1Qzhqh2dgcMfQEWIcLW2iLVGWdTlrWeuZEnXS+aB1GaBeboOy
rtBN93JN4/7nP/8JO2KOKXx+azarvzV7o/bYWA2Ev1O2G6/XrbPXNdUnwn9i
fcjnP8PCGobIu3Tp1/85rrgYW56NwQ4lWyHYYL52OQ8gdWx/Az3SY/BmfgzV
ucXeGLTkK91yX+Vq/TYyivgn+IbeQbUEFNlpUwUQsaQ5MbOAcL7xf3CbX9D5
f6Y6jw74tf8ijpegWHG58oIjSiaKhksqIDKJpDwizRTyuWn7FczE/0Fw1CQy
xsEKWnjfrm9hKYU2VT+cPk1SbPCQltVJw0aqzP9R4gNlQ7NcbtEvTXp0utkD
6ThxBcGhZLxoQFJCSNuQuFalRL4VsDSoiPThhiUjbGVETFQxU5NwYPaNpDle
1ejBxO0g7QOk7Zb8wrXSJeQ+YSbtPsoZBMJmAwoowHOE7Tbn19rXvqlBdwHO
lrJuMF2GRLfcbzErA1N+5E703gI3ghLpL+spheRAWyfPnzyCf+p+PtMb8kUN
2+AlasFoTIMaW7mBaaTLVnnmpQ4wRbcbed2ktctouCe6mmzT7rJh34wKBjZ9
BbttvetGNYxCh9B7DOqp3B5QiX22Oa83k4OursPOD6Uq6pYlAxcaYtq1kK5B
9kla/rladUpRD7gpmhujmddgvcLtZ8c3laKjgB4gMNQWv61xs6zwBPsn6T9W
9r213DBA02zUpPlJDdEOnLoFsCce2IDji2V7Vi2748nkKzlk9YKDiXiTtgyy
49S0FZLlEHRGHHwTbB27SMmG7nD1OCQnbTfKpWzhUC8c/Gs6RzCWOES5LBVB
W8WbmaMWM+k5QOPDTz+dPvyv0z89ffrwyQlsl5F1WIwilXZoYVHRKrDc+qZW
MQymE4B02a0ZmPhXCYyw1qxi7oFI7vyv2EgszIJghsrjAZZWQIXG6brqL6ew
C17DPBH096APCit5psJKanEfDSMHz5/dP5SW2X9sa4AfawpZ0wQfiMrZ92rc
IEaguorr0C0Qg/QbkU6mqm+voAljTIDF0NkImNnkngo1ABK8lk45Mg9KQ4Rk
HPtqUFPc3u/T4kPo1ZqRzZ5vlxKC7RpWKDC5qZDLfogeGAKrubIBAupWNEqG
I4YOWU6xyU2NhqCr5r9r8lCD1r+ZwmCnsIa260NlGCBD5IRse3Yraoy5OCcK
BrlJ0I/yrh1rNWsiZfHmFXTzbxMjm+FvtaStaJzxn05R1dNgUYF0P5ls1vPu
WHU8/VHEiC38KjHkDEWJX8uCtRC2dm25o2JxGSQ/SaigvUi6ckjmPlLDnaT4
mTICsDUj+ZaySnAD0ll9Wb1sYHlKtjxFtqxEZt9pUzFIQGULY9JE9YuyRG9p
1SvPkqY4xrGZ3Elq6l7rt+jfXUwrlMFTEnO2QLrMR+I/8N3fZNHZLNpmt1le
JBvDj7oV8ZP2Lh7bjwqYN19n+1DUsULtAaRAsjuvXAC/TzwavZZ09BsilW57
RtTCSMhoI0g9kxCrilFSdUs+OqRRc3eqBwte2QZBvDnKkVREFI0hH4MlT7Kx
XkykYAQV8gUubjYFBT3Lbk8uK2SEz5vuhXgC7cjo6A4jX0AVO+S9TlSvItar
PylpACpv4Iq1m5oz8bCaX8Y/ggqFpth1i+4OElRKm2D1uRKhESVAPsXECEqI
eEdefdSlKUxsWTty9pkHvBE0kzPuNVg0G1jny2umU1mxJzU9r39bl6pMnCrE
8lE5BMEr1UNtwfaRKSZQGYiI+Zw3OhBiER86KOcJnMB2Z3Ot1TMM7UXo1mF0
iw+EZk2wRsYtaDFiQfONp6qR3srBA40ArNG6wJnOgEUDr+4vZYFbt4BhzKKF
cRlMcf8m/fFfBx1JJ2x/DXiPNkCyHFoAKQGlwvpiC2P9PFr1sl0ucjUzVc3e
k5hwpO4Q2DQZV7gxnE/PWiDSbhBVVAVDQjGetu6mL6slaD+jql1PKTaprA5x
wilym1EVynpYNN3fW0DvClTOr70S+gfFv0C7vOxgw/WPuO9pZGAhqKXS0Tat
lq+q61xts6h4vWn9I2kHqjosGXS5/Pi3SVFlpVroRmxtV3DK1emwYClCn0YZ
vCNOSXJ+9RVo1HzVHYeig7g6EnwXRDNopxHwR9MCZ2iyfW+hmi4wEsNvHcsK
W1ZFVFhOuJFRmwsmUVcvOuOoI2zpcD4lbxQiFDC06G9hh0Kv3yxAGN9BdUh3
pHqoJXRo5TItoFPEif352sS76m6dVV/YIxa1weHaLIcBs89VsyEvGJ5AJbhl
LSFrsWButTGdGOShf0wKP4bGOEcp7lwzFSHrUUjFVQWakJxICqpIag4BAIo3
FfcuhayBga8QBMQNOyOiotkmp5L6oyM7wEaezJD+RtSdxoHP2GQx7KgdcqyN
B3YXGHfBL0H6S+CWM/1j0vHkpgEgg77b7WZeO2U4f6EByaHA20UFahf2MtG2
GbUS8NwKhb3ICLFW9ZyVICn0mXij/lUrpYCJ7pWkQRLjI7GfES/7x0y7l22g
ztjUKrIPywhVxSqkIf5iPXmyKN+VPt6g53NRa2YcdobiR9risv2h9VZHWRkL
kkNYQCWvLhsgERd7ZMk5klHUR1JQHCoTnpITFspFBkwFpQm1Ny5j0MfrqzVw
kIEBELZkvIWx+9ktxQG8nvbttF4RQOqtOhNxqKLzJU2aOCoA8oiC3zYy7rD1
NgIb9GUcE+h3Zmj2KofTnvtrrjT568FaQC34eBoLzwN3Zu0AhhHLK5+aPSFd
hPy77wp6BrFCrQ/5qjW1UAQ3na9sQBlmMv14B8gw3AotWGqk6C3qMCZWLVA5
f52ay80rCuDHggfNrJ4deXRDMQqS0ywOZ+Ivl+p0UwkwjYwdJeiP1OaUAYZj
p3Z5nBBsos2G08I2m3yy4xRZDnugGjxUvQcU5XFjyX7xNe41Abp1KwVMF8z9
zBgXta/hp98w27EyNUZcFlwlTfsrzOFYpOfVRJ+CVOSsnH3cuIi2N2qEzIuT
e85Cst0hy1s1/9jWgHQVS9youFqSrrOJmW4TsGIiUZXrkUVWE1hHyqOkx0od
aeHjmjmAS22ai2ZFPkkrL7wGGc35QEwMEE7QaxYEMpgzECpiM8qML9Shrwhk
Ehjjo1EDsZ0qhHQ2QskxTFd2zYWBks5ZZ4/HWtjooCFSAJF9vQDGa3qJm+Og
sXZFUhKPlMqw67rD+Nemw/OY/LSi0lgQnAU5ZaS7nNmk6EyTBFquBLQk2e+K
m9GB3pXcV00BizAo6KnDqM15PTEu3bNrh3ZlJLxesxgPCnyCOIE8oiXDvTS8
FYN2og4baIhZkFUacIY5zacVBteVjOSspD1wumjJK8xaU1GB6OFvHJ+MHous
gooHd2EwC4DjRHntvo0ZvQotXiJm9JJ1YU9YdTEDUkFdwxg26QbQDvXx3bDu
HHbwmWrZusyJnWwhDnPLD8lPyfPitZAwfikDjTpnkeo1W7nTB4sTdrdsZelb
iAFcUNn6EqcUaOq3gHi+87sIxLSU0pNk/DjwA5XcabOITpZegNGWihrpNnMl
tqb9Gkr4LZ1BD5vrSOddv1M9y7z5N7MgddDOVMoCt9XEVLwO257Kghyu1FI7
a6QjgQg3gseztl2CMhchHBWKQzxX6sFRqMJywG/4yxf19d+YDdJpJOzWWtAS
dTRl4gGFarAcEkm7lkkyLNfJVrmEAtVmfnnNS0Vdx0YlCl3HpB84PkDH8eeK
c1QK+YEPP7qFjpPUfcQlpOV4Sk+TR0tQ2rix5HxToQ7QqNPXZxj+A4IrYHdc
HYgZ/4IkIlpq9jqKhdLTDLRCEsmLf5EpCvQXHLUFPtQ1O9aplqhKePd2blij
k0C6K0eezESjDhVV4k+rBt+I59oS81hq+6BgHPzp+eND0D8m9kifHky3ruYU
HVKvOtz9S4DJeKP6pYFVV+3qoutl6AUBM9HapDrlgltpraXLYwWaG6DuQdI4
h9wKz8NTJohedam23gYvMxjhsnlRu29p1qT2S31o5FC0X0NxenTsAuWDtm7J
zcB5Te8sdg0h2IU4ALEt6BGTPEHEPptth8Gk1oi01s39mbT7Akjx6JLeEkwm
pFkMESgVip5KZ4g8NQXVxmJCu5s1qs1dX+OpR6m8Gs/zBjRTIDaZP0RWlQZP
l3TJWm8TJUykvf6L23fuUvSiVjNuGZXBRo3pb/tEPfuuUrFPXMAMWoHF8uvE
TtU02njFFpwKGaWNpAesdi588cmnBKyvXISYb4nr9cqC9RJzmNSbplVWDb2D
Ua1om5dcnLeY9kANZ8am92nR3QoZ4exOHTvwVIpbvq5A/QUdkgOGxmKoVp4n
iXdruBG2dcq2G8+kxeDg9PRZZw7jffYF4FQe9aVzqP7+CxvxB6XPPp0+c0Ci
wyzqKKHQRdUQ8BRyhW1hJN1S1sVDd3TOyD27km0W50+e8sfGDh4/uyUz5pAN
hvjZxLK3+D6UL0s5f+pQoMrFhMbjle3RZMFxN9jYygTjL2S+pr7mR8Uql9v0
1eai7iU96JgaeSRG7j1NFyZk+8g9zkVm94U9Gfns/sNnpuMFTtMtOpe3rC/o
hQ3Bc5S4OIfCDChGVHA7lNqjR4S+06qSKcoqhxIl1P+GZ4L5yWz1LrJ/Vgmw
vBDUe7yStYhonYp8Iejvu1an/slQxprH5hgL5nyTNawkGAbAbJoF0ChZp1gJ
aIYFfOYCcbSljvmIS3DE6luHsY0NJOZo9NuRLbKabpNxVbiodV2PS9yYCDTl
ZP4BOTvaAsNmY2M93MymMUnp4K/tllBadOfXU27weJ0r4lg/Xof2D/e9jm6Y
fgVa/y3v/6pP9e+tsHZqs+/v7LwK4QY/UsFFDCzv5RQdQxMLtQouwhOgU7sn
tlCkNszR2hT6wLe+vDa9D+rKnIGxrkt6zuzU/LgbafDbqB6gogy6dFs1xaW1
z4AzVJwBoVpnb4IAUEOo4RbQfgqCV8ynwdVnG9GmWjfs3nPI8ZMlqiJmLLyn
gvNt8gfk0ts1amUoeVHqPZLpFkAdW8h3B4+kUFY2yI67sSl3Q2VCOsnBSTps
r/L3mbOtBxL9rBlKqYaZPxEyoTJJEWSd2mgom7xOcuVzOL4GZNiNVs/Q1AqL
EnUIaBCdujybibGqUh0daSNtwdJYbMzwxOqX187pJUFQemxPCho7S4lTGcb2
fqwil0JOhk52JTudATK/guOz2cj5AJD4azWq5uqqXpA+A90CMM7wmo7xYubc
xSMhQtmoZYXAqwkwWshdj54DxblKNUL5D+AvmZ6PSAdodClzFJxdBx0cotQH
pQb2b/AVHQ0qnZpQQ/BCYBUBRidT286NUDJ5GKA18kfZRALOSBbXwNkR9wA7
HW+rWZY55UxgOIDWbN1qjllHoSxDhwqxCFj3cFSKFgPa7iEitH8QGbvOEdS5
uSf01GtHsLSBWC+k4idhH/zU+tk1ox62wwg3GGzX5KwS265iRq6fEE85yHZx
uXnbIqoWeF/4TkP6TZnjVKYI9W1uqmum58m0RnoNSt0lvlWcaDeyPOho3c9d
ZM9LNjm5O6QiyPW+b2Hb+hK9ipX2+U7kUlDc2URy22h16KvBk0SeR9mNXUeS
k+k/JjqFCLVr1Uw5FdYXqKE1x5C441iPKZn6yRhGJ6EdVQ1MjjphDbclYk6q
Ua4qbgAPDc2ypVTjGhA1lwRQWNYJQR/wQBXB89qzgPv2fj3lUzPlDoQ+Ur1B
DVX/KFVdP/9h62H5yNQEYem8PL7H/WnozsiCmBjZYJ2PCuDdEVhbraWzdi+d
2dcelIjzKTuoWJmfeRXkQMxRVq7suwJ54jtXGM8MlWv52p7Hc7wrDucp2uAa
hscCcDo86eNEY3GTM4mqfRzcPmpFfjmj5BibM3Yx8fLWGe6vA5Mob+vJM7Nn
1gYoGQvqAjmROIDONNdHlWmzkMbytTmzE4CnY5CMEJhY5xBiCwNoIwwxr64E
2xJSTGWvXERK+ePHbDkHt1E9c0xTzEQkwUvyjTyMNvrTNAB9+fJU2rSVhY9U
1mhoHlqnmYiVergjZFMiGwN+zOyYN4ZScOeiI4dcyJjjyk6v1tr8wrRbsYoE
84QREkixaua9sRIayiFqMul4das4Phy2Q89ynL5r0Qt5U6qJ0h8J4TKDFGjJ
NqCXR76VtEoZs2n706xAbWmctcY0ln3JsPdND6TEUwihCnkGMCxsYYifsvB9
NZn4tDbCGupNzoz2es54cLpSzCWOUHYozwzcrJT9brKfWiX7au7Chk08m8V9
11w1y2ojU4p58YkJ4TGMmPoyRIyjR7vAqU+TISYcbyyDrwnDl4jiyxlYDHFu
TzomsRCBriqOKJFJA2VrrBGKAJDHbsl34koNdx+ivlGCA5fsjicTnrnAhKfJ
QGO+Bz6iVIUyneWRs7XvWrW3lHuOpnPSStBy5MIsMAxhErZWpmus8DRIszBC
wJiE0SjUtVc1mYS6I21qkpHHki9zkPSapT36ervBo77ygC+2RzkfNIuWiEKm
TYc4ZPrVdturwMEws6zyn0i30NVVQ85uaEgfx+gksHTQiVmw7JCG80bgzrmh
lBXbprtEoMxyVjNgUgIg6XmNhD2RkQqg2XZ4/4mxzTOeuLamHX0UQadI4WIc
s/3pJK8U389dZ5JJJz7qqVR6Rl1hLmUr6rot+ZOkiY6hyDnRDUNVJg2c8n9s
MXZTSkcPA85ZOT6A/XY1XdSYDHb/SKa1kPEPIA6W10dEvpgcm7a/EpazWt1q
I4+KOy1rDKH8qJ2z06zL+WW1uqDbBbaKaUyZdSvuubPOOmiatuCYsrSNZEGh
bNeoHTG9pGIyXnEVzJu5aF8luiP5h6zGdRJS/h5zNKmDRbFcEBTEObWnnojr
vEf3jzivmiVGtFDAMZmo0HID80d8aGEO+79jx1Nog3WjjHg4gBRF1UAnvAZL
Lo4kgQWDaSDVg1KIt0rPVwxmZvirPHjeTS1pHA+MlhGRn+zBIcPO72Rabzbt
ZooXZw1LXqsBU63OeBVUpImmIJ1vKIc62xY5mJNphoRzUYZ3toGq0sEGSjik
TjVkMxwpzWEgwdFsop0eocZQiY9he7mmJGhqm0k6xBHoEsCT8V+AAGh1H086
7HxeQY4idlJgwiHXK0ZxfJl72waSqTAlSrEGRVdKOacc5voLq1oIcexwQwLe
iYdpAy+OxQSoq8i0IsAnUcCt9yV1CAJJht2YMJnYiEd4/eYN5edTjINdo5DK
xR/k+tW3K+3z5MT7gymQvAxIP3MWndeOVcqmxNG5YJzWj7yMObLQxCv15muv
6bjlxgsxdqOM+ymoXY0O1vYC8H+2dD8piDOg0glk7dml1rHdaNF52/Vk6csM
x0sw8paJSLw5jXfxxs8d8XOkLwnTPBzY0L/DePYKKHd8oFbZYbSE6VCVUvOQ
6vsmXUosXUo4NUFJIC/1J/btUxmnTlYsDxOvtF2DriJ70qv9d5+kx5DI35IY
h18axrLtQALkRkEFyuE3PCDKiVPwO4lk8sDLoqMg10/ZCPx+YswkwR8ybMDP
7ZAdqi03bpwjpqj7COHl7DkB7fDE2HI/Az1R9x/lcft2yX+8xgoS/oR4KEry
E9Q11amASDzhiTuv9gFymJjcYKJDnoABiUcxYpftOiJEfFesXyVTw06XDEHT
KI8cHkvVhA4MN++pP/qzbFQkx8aNSlcpgc1G7Klx2Si9EaMqGhevbBw1X6vK
BId5m0UN7L3GIydS6edFDyeXtyGY94raCpgdoWkYoaZoKSpNBXyFdw4emzej
cVK6ipZ4x25yLKZtKpYbBy+MGKWre7NlhWVhWQXYq/N6UB8OK5iutHpcWEk/
+lbH4wsbzDlqiJbiBivoRyMxR5cR+ZPMExdUFgmhRzLaqNVlgnonGSYGZZhB
YZkM8/BSIMNCWEplWFizWIbFRpVh06lRpZl0CFspk86Pqmhcb8VoGWrKZJiH
nCIZ9i7RUy7DfkWozckwD6EDMiyEa5QMG8BJ6SpKyTBvLBkZFgKSlmEhBEVG
nBCkYZtOFLK0DEv9oGeMDIsOMSfDYh2KMhlmujg+wL1kEhcGjsi+NSpzsVzE
ZsqL0KYQ03jIvDL/lpKwchB4AgwQL4+yxQBIFM7LYFOP1SDqr2HV1DwVQ6qi
L3wz8tYDsuurTT+4bsqWwuh1MG4RjF8B74b8d6P9UYRvpqNe5eTGzWS818no
+jonKEZjeBzDD6z5BWt6gzES07Omv6rWWAW9bMeX9Y/TIcskqP0pFiiKWWC2
cIoFevXKWaBXsYgFRoGMsUDzDK06XlCU0IRXYWDVhaXFwKqL1tBP8aqLDiu5
6rzS+hlcdebJs0De/M1kvNfJiLBA3v5oDI9AryhkgR7cRSxQUdHPktlv16x+
u2b02zWb366Z/JLj2z0d3gebAvBfNxvfzsnvdkzjt2sGvxS17pp/8WfI3Wdq
RitDOREdB68QId00wl5bzhJMXDhsXsGcHfa+Cr9FzARRr2LU6lXQgCfUvAw6
pzoqaxiv0cnL4TUArwivARaG8CqyeBWRmcriVUQIIo1X07lK2cFZWSgaHHar
w+HsODP7DLusQ63jteXgeEAtzUcj3OR12HScgw9xDlZfHvTAX4um0xDl+qYY
pvb8nHhIIvopQKSs+qpqekycT332Yd0oxSgyXndTGQIVYdgiEjhlt1ZtZo0N
TUIWE6zx3aaBN9DNL+sAn2MaeOcTWTaTCECkdmYqh6ggKYdy2VdDAs8m9QlE
6UBWn4DXZNP6xCCPBiUObycGthDpbUOqS+b6yQRB5jXAgQDIxFocCn5MVBsK
fMyC6mXf9bCeSAAW0QLyecDict4k9PI/60mbfiVu9XUyD1i81eF0YPF6w1nB
Av4QTQ4WEY7jc4TlGilMFRZpYnzGsJj6U8JkBKtQzmp4rXKGw2uNZDu/YM6U
sLp/fA0jjC/bRQkdp9vAxLex2XkvWiQ/OBhVIegumFTt2JE+p5W47BZswdC5
vKTykum9VVGs8zYaSo5PyWyYM9CJNgKOzmu/mKq7x/Xxtth2NFl7eE8quPa4
w85UuBJgxD7qdYScSjH7OkK7Hk5ieypeLbOz4hgcsTIc/liyPjKIt3vYaDX9
lM2O2G12gsGMmJ0Af2WzIwpmhyNuxOzwaqWzY8AZsRN2tJBR+2Fe0zlQm6Gc
g2p5gZri5VVMITYtHh/IIyeH4ifp1GPNqzMsb5L1X8eAUrUyZ15SC4+VzxfX
dF5Aa7z9V3VzcdnnRsPaTnDPsFUvDlJH8ueYKu9MqV6xwwCK05bBC0/EWZoq
rxYJli8pzpGSJu2wg0iIZmYEvx2O2MzUNrjMBnDmGzCAD/OLsKb+M6cjD3Zs
ItlG1dVPIvStGOfRkMlROI/FTxYO3W5cdkX7+Mpvg3TW8Uik877jPtkxM54O
4Rya96Fg2ZKZH4id/dXP/Qe20j98oouHEZeQWjKquHDU0ZDiYoyno5J/1gnX
z46sPQxyLsF0NOa5cJixOJuSURYZcvNNvB609A7WN4DEonPK29APi9eZZAJ2
yvHzlitXRIJ6JqOWbxBtnalgoPaDr/N1nGrxWOywgagyro81FSnjptvoyagi
ZZw9Rco4H2yBMi7YmzKs8A6KlHHB6oxXxs3zOlAMy5Rx3oAYJaK9mvpNqYiO
dlzIsb26+inm2ObZSRnnve+kjEeHXqqQeZUZ2sdXfhuks45HIp33Xcpdvcr6
GakXmWdHZZxDsaMyHsXCLzf3H9hK//CJrlQZ532PVsajoy7UpL26+s0YZTza
/S/C2kuUceFWKlfGRaxumTIePqOV8fB5PUoZj9Y3gJQp46k29LOzMh4+O67c
4BmnjKs5beqzTV29kNcqpcqKsPhH4j/sH4NmeRFtYyg1ldf/8YHJ4Dk9364I
WUlKME/EFRE2k3ZLGLDDSvmuU7XynMJ9Cvy+0Txy3BmWvPpCdzguJ51DDelI
KsForGjlFy1v4a9hkY6t4oDummaOtzE+05wrIsYmm3P63jHfHG8jn3LOm7Ix
WefCrsoSz4X1BnPPBePJpp+LjakoA10EsoGkYWGNwTx0qbFEUtFlBpLJRpcZ
hX6KRzOYky66StNp6YLBJzLTxUY+kJwuN+xxsxdNUZeAvGjOBhLVvQuyy6Sr
48WSGevceRxKWsebLM5b52FmbOo6rgsxY5dIPBnDFhNQaWMWk06FBixvfGVG
q8hMDmYBylQuSASUHWHeaJAaYdZMkJDK2ZQ3hSMsHaO7AoqT18QwVWxg8XBV
alR5x9gqyRH060X2gGHBQ/GwMSEEsDBlUCmKRiy5zDZec+GirbspbMpnt+u8
uLB8cEhR96q9LtHbwzqmw+xWPFpPP4mz65NR4x3Ycnt19JM/yO4R4+jEeCFl
7ZIbL2xlVyEpSoSkQeoYLw9HU7FnxwNqhJAMK48RkrERDlrWoyMcsqV7QI5g
+/kRlo7xbfk2w9QYLwTH1QjPw7vE1igh+atD9rD1naO4yOLuAThWSA6gaMSS
y9u6+bgG7dseREM2bQ+UUmtWCFuRcSsK4pC9OvqDnrFCMjreYbt00K8oFpKm
o4FYEA5QLv4jUjQX88H25okUfOa/nLxSKajCpsuyUIXo2BQnoorWHc5FFa2W
SEeVWmvFa2eXhTN61ey0ZIrWS/kQd1grYxfKJpGm6maSfo2T5KevSs3SOLSP
FieB06SMH4zI5hfw01RCvxuGerNWf51r9YahfgCT9C/IUFuRvHk0yVi9OqwK
8MsX02GzUytUKT5r2WOMspbX2wBGWu5oLnQx80F6jmb1FNjEeCPVfL692i7p
8uCpcdumnM8x+Mu80F63u7mjPXSPcRB6VQsd1Jnx5jzVmcEWuqxTI9XP+BGP
dWJ7Qx/yZscwNeTWjqFphH87iaMdySHj8U6PbhwRjPCBp0Y3fnCDXvHY6Bw/
dvH4eK0S3ZSDmT21Efw5qIPypoet9xwF4834HirG2/M9eHc07HutDAbmRn/o
TovttwHSCq3dKaQVG7294e5o/X57pOk/RyKN9zpOiQzmqthW7s7YeA+F+aGY
0g6uCm/k72bWRq8QNmfvb3V9sIRS6l0xP5TKMcrN4o203LsSvB/pnfE6fs9s
s8S7I1gNXDPFbh6v4hh/j1d1tONHsDejd5jCfSNBGOMKEvE37m5/Mmq7z59d
FmPwjDYDtMMx56bPXWZtJ0NAWx6O7tXjcZXF5wJ4/sTC6EzfHFBvNu0G9vfn
bbkJwdYBtXbAdiDLeon8h3OA6YqYA7frq6u1dKWTlWRRwXABsfSxpJFNXXVt
Sf52U2/ZYXx/+7LBxL0YbF+Gpky1DwNTXoLOovycYSskWOOtZBUai8QgiVsu
aTlVGZgW3OPDAFTjAzOhLiHArWLuBBY9KlksQoD/ucXq5jshcOzjt4OfS/CU
bEB+TjpmVIJRmZ1aco+Mb4ZQIQaeDK0yb1Ak1Wi0ikbw0BY/0XQmA6mpNC7V
orL5j8qzOJiKFJ9EQlDTSDQjaRZnyRSlps3BLKXDgDnJSt/BFJamDs1UGJE9
NNpKUQLRgBTYU5BDNKA+9uTTiJqa+UyifJmPo3Bes5TOM7MxkFJUU4cozSrK
wRs9a8HAxs1agNHiWRNlsyZ25ku85ohZM3CNSzXKa+6SbdSAOpxw1BQdzDlq
gNo97WgGuhFOqRD2oeSj4forpUfeSy4FaayHtPsubHuHRKRRrjU6F2kMcJHP
gJTkg0lzeliD4yi7CMJuhk+PeaMZY2CPNmCwO/JsmdeGGUERrwkr6z9LjxOl
us+bmzLV9VN8ICk9C4WHuPKzUHaiK4WGgUw5ZROxU/23nAbW/fhp4BAUnccZ
ooTio2Uxehh/rC9KEaNP+f1aaeJD5Qz/g0iy9PBjlBBHnIVMYaDwIGR6DsYc
p3znhKCf3UXE4AHNFO5LzmtmhlxwfDM1Yq2XlJ3mTLXyusQcPtiEAafgrGe+
Gf1oD8akMGCxBFdvv8yF782Y7LDW02dgonUM+MmQnVQ1p+ZAVlT+I7o5KEmM
6v2IbA5KcqN6P/RTujngAy/bHAj2qRhJvJvSzYFg1XbaHJjndaCWFm8OeBti
rArgVdZvRqgA0e7LOb9XXT9jOL95dt0ccBh23RxE0TBCEfTqs4nYqf5bTgPr
fvw0cAhGsGivvn7Ga2Lm2X1zwGHZfXMQxcgvTRMfKmf4H0SSIzYHHIJdNgdR
DJSr9V51/Wbk5iAKxC8oIgo3B8KtN2pzIGLVizcH4bPL5iB8Xo/dHESbMOAU
bw5SzejnbTYH4bP7Mg+e0ZsDNdED+Vn5n36N0hSt7ooMmilL9MSeYs9aeUJX
r4+inK6TrNPHDLQwr6u39KMVB7nQODzZKIxsgld8ckledde75Hl9zRhOPqzt
9VjOUso+hM8jREGQHVOQWNrXbC9lszGYBRaftKNNC6yBZLAljXg5Yd/B2Aoz
xKbLlztLAzdpCZS8amGqWBfWsnN6+Tr5U0sOiKXnlXil8lN5IYy583iZCjuM
SD9jRlZ++s5b9wXn7tjQhk7cpUrvgoXRE5s/XxfAVTqdpWfq3po6S87RaZ1p
KMGsnuWyKGbT8Pg0s6bq22SaNY28RbLZ11ZEZo2CBuNjDIEemoqNf/yNs63X
k1MUPsbrj8w9GxvtoHklNdohg0oI7bi0qvnRjhgvb2J4f8Hf6KfYdMAQPMaC
5aF4hNXq3SN5bPraD3yahq063uQUWXLCEe2Q9XYAs+PWe956YvBYaDHheC+z
krgzNWb/4tV8XbidCauZbocsINGq+omlcJnsMPZSEg+ewoNcr6OieFRaXI6z
aGbcAkvFqNDf3eW9KJT3ZgZGOv4EQ+gYZ59woRudaN6rPz7XfDDaEndKdLQF
DhQP2tFp1DOjHTFe3kRp2ml3rY1xFYgd5L2H4nFeqneM5B3S1XstfFDTVOTF
EWxySj033oh2y3Kfw+y49V6S6/51sbwPQSvLeM9hGmGvFAGQpebLKKxlqe8T
RLaDvI+OfTcSF2PkveluOLqJQzYQ0RQpPRDFxMwlQ6l+PRIcTE7pcL5x+Sm9
+RibotKrPiJLpVdzKFFluDzHrLUdF9ouq2zXJTa8vopul+Dd7y4/Rq6szVAG
y5vZ+xBmL5naMpy+0ZOxi7QKvG7F3GR0mkuXPw+mDr5h0DdL/INc4jcMmp4P
dPZuGPTYVMTxaiOyEdsJH5mQmFcsyUnsIGh0WmKfANrCE+Du7zKzJO9ldOri
2DCLoyK8zncOjzBvZDsjPdFe7fKAiczYByInMgMvD6FIjVo/O41+h6AKDw0F
0RUxxBWEWcSwNi7eIomy3SklH4GRHulo+hgXk5Ea6U4DLYnSiI10OOFxYqzl
OY+j8A4dxfLel6nNvIMi/wvHyE6OGA8zO3lkPMBHmL0DJI2zmnsdl4TUh3X1
M9LcLnZ3B5kfHs7HuCy8oRedqgkrM7SPr/w2SGcdj0Q673u0Nh3M+Bivhzvv
O3mpzA/FMXdzV3lY+OXm/gNb6R8+0Y3wuZkfSuca63zzRj3K5+YV2MVt53X/
i7D2Qs+fYJUGszwnIFR1R/oCvdq7OAUFe7PLdl64byQgI92EIv6GGVwm5aei
og3vuHKDJzDETAosMQXpn8P1+t5sMePyQHtVC1NBBwgdmQ3aYGVcQujBaslM
x5yYxyY7DuvafMeZChpHhdmQw17GpI42mBmdPbqk5v8otOo80wV9lOagDjvR
aahHdjKkt9mZKs5Szed3mAJKclVzUAbTVbtjHZuxmne1a9LqEHPJNlJ5q19r
i/UcaK0houvqebta+GmsB64NHaoeTzfDnv+w9bD88G2jbnl8nzyjmQYxMbLB
Oh8VwLsjsLYamp/R8MyXQyQHdawHf0yxMmlrpiytDZfJp+CS2khaclN98MKA
cfnHlQO4PMmv8gOW5PZVxDCUdjyR2VvWjuYb57WT6cWVi2wot3imdyepeLx2
yWzAt3pTr+apNhLeIlm7NBF5qvSILORhE0XJrF2CKMXN6wj1eThJp7FW63Io
h/Vo2ubVxuXWH51wXD9lsyN2m51gMCNmJ8Bf2eyIgtnhiBsxO7xa6ewYcMYl
FjfVdskqLmsOpxRXLvmhfOJC7fx2TSbOO9sxk7hwF96QE9kU13ReQGu8/VwC
8aDt7OW/vNUdUofzzlSEwti84QG8Ip8X0Cv/WxufVVKcIyVN2mEHA9dweiMY
44kKaxtcFl/GGTZgAB/mF2FN/efwPUKZjgfvoovW1U/BdXRZnA9eCjmI86Fb
ITNDH/BGpCoztI+v/DZIZx2PRDrve/hKuaEZL7viMTbvY64DTc38iBtBf5Vz
/4Gt9A+f6IavFk2RWtHtoplRD14QmsV42R2j73zC9bMja89fNprC9OB9o5lh
Dl05mhql1hgK7q9MNfG6xJmRr28AGbp7NN+GfsZ6ogbx85YrV5R7osKmfps/
1RZWMFAnI9CidZxqA+fcTANRZbwkVbdg/UeU8ZI83SIyhCJlnA+2QBkX7E0Z
VngHRcq4YHXGK+PmeR0ohmXKOG9AjBLRXk39plRERzsu5NheXf0Uc2zz7KSM
8953UsajQy9VyLzKDO3jK78N0lnHI5HO+y7lrl5l/YzUi8yzozLOodhRGY9i
4Zeb+w9spX/4RFeqjPO+Ryvj0VEXatJeXf1mjDIe7f4XYe0lyrhwK5Ur4yJW
t0wZD5/Rynj4vB6ljEfrG0DKlPFUG/rZWRkPnx1XbvCMU8bVnA7kyBYu7sYn
yOaI89sozl4r1PSXprzmT1G+67RbwoBdmOtaDNXKcwr3KfDcDqa4zqW3lgja
Ibe1YQglqaSLVn7R8hb+GhZDwYJMCWHJrHdB9GD26qyLfDBtdba2l686rF0a
cDGcoTpRuNADF/jeBoHj9QoTUzMQy85fZirkD5hZyEoPlZkahWcrQ9By5ylT
pceOQj/Foyk/KylYraHzkWw4Q2cio0VHD3vc7GXOOwbgFM1Z6bnGEPJiwAfP
L2plYyjFND1lcdFRa1lBcumMt7owszQzdonEkz/vOGzMYtJp7M1yY4xWkZkc
m1rSFTdj80qOMRelRlh2JZcBcnSmw9QIR9xCJOwK2DBlYMxxqHEGFg9Xoy8w
ezfY2iEp5K8I2aU3dZUaE0IAd8vumETRiCVXcrqrZOtuCpvyZae4eI0Rp30E
w3npgR/B3hdsxaP19LNzGhw+3tKTWO5TmAYn4/4pStYsEoJVZmrWwJRHSO4o
JEWJkDRIHePl4Wgq9ux4QI0QkmHlMUIyNsJBy3p0hEO2dA/IEWw/P8LSMb4t
32aYGuOF4Lga4Xl4l9gaJSR/dcgetr5zFBdZ3D0AxwrJARSNWHJ5Wzcf16B9
24NoyKbtgVJqzQphKzJuRUEcsldHf9AzVkhGxztslw76FcVC0nQ0EAvCAcrF
f0SK5mI+2N58KLExJ6/BpJkiWX5Q5puqY9Nl8rojcmXyakOJMoWLjOK1s8vC
Gb1qdloyReulfIg7rJWxC2UzlA/TdHIzSb/8JCXTXppedkH7aHESOE3K+MHo
VJeMnw4mIr5hqGyabtbqL79WbxjqBzBJ/5oM1XiuM5y0XlVny9TxbZE5g/46
7CbuZi68Cdm2IrNE4K9F02nohuEgX3l7fk75URKO9uxNJa+qBmi6lf0H930P
Zh2Bne66m0qfe5iyRDeQdNajnGkHD2MPTVcBnlhH7+wea95mN7+s8xlSdmn1
ZyKKMVSBwETaGCSLIbpKtoDVx+b/jtQZkfzbdDoq87epVZL2W/jlR53V5oP0
4kXUU2Da5o2MzucdwF8WTOJ1u1tUiYfuMX5+r2p5Du/UeHMBJ5nBFkaepEaq
n/EjHhuL4g29IGl3gKmh6JQYmkaEqSRxtCM55BN1J0Y3jghGhLKkRjd+cCXJ
uYPRDWfmjo2vPC13CGb28FXw5+BWkjc97ITjKBjvjfNQMd4t58G7o3/Oa2Uw
vj76Q3da7IYJkFbotEohrdh35Q13RyfW2yNN/zkSabzXcXvBYK6KXV7ujI13
NJofiint4HH0Rv5uZm30CmFz9v5W1wdLKKVOUvNDqRyjvKXeSMudpMH7kU5W
r+P3zDZLnLSC1RhMUh0DTFUc47b1qo723wr2ZrShSLhvJAhjPLoi/sY12k1G
We34s8tiDJ7R1ryCXNSmz11mbSd73rgU1C76ivJPB0gbk3w6Zg4YypKcr5PM
j2x6G5sc2atoMyPTp8Lcx14jY/JJK6YyNpn0YLUPA1M6RXSEvgY0A96KzgEd
aSWr0FgkFid5NlXSaXrL0jvz8vnczsL5PSqxM+9kp6zO3qjGpXSWBsiy/M25
sjeZgcmHd5MZmJ6bzMAeQZTi5nWE+jyc3GQGzpPDTWbgm8zAN5mBbzIDs+Ic
KTeZgRM19Z83mYE/tOyw/6pJWm8yA39wK/3DJ7qbzMDvk7XfZAYeV98AcpMZ
OE5QN5mB803o5yYz8C7KOG9AjBLRXk395iYz8IeWHfZfNUnrTWbgD26lf/hE
d5MZ+H2y9pvMwOPqG0BuMgOzlXeTGfgmM/BNZuCbzMDelN1kBvYgu8kMfJMZ
OAf5TWbgm8zATg3T+E1m4BSQN5mBbzID32QGvskMfJMZOFZfJATrTWZgBtRN
ZuDiEd5kBh6qfJMZOA/gTWbgYmtWCNtNZuB07d/eZAYWAd5vElmOWzU7LZmi
9fLrzJF4k8jyA5ikf81EljeZgW8YKj0f1Fq9YagfwCT9azLUm8zA/LnJDBx0
dJMZ+CYzcLzTm8zAN5mB8+O9yQw8iKmbzMDx0d1kBo6BeZMZ2MB7kxn4JjPw
YE393GQGvskMnK2pn5vMwL9GtnmTGXigsgHhJjPwTWbgm8zAN5mBbzID32QG
jjYQzQw8/VEProrxWCyBjkpY694X87FyjfvptSSBhC1w2JgZQqVt/N122Wea
k5AzrwCmq9ygaR0Y01XlnUMTyYHwj5nWvg7r6N8JABMNkyUNlv/FBrm6Xlzp
1gfWW7aX+ufohMwY9XnGxWDKpNroN2hsm4cyzYUq4UnnLcE0baqpaU/SsQed
fTvRNR3+IFyewFarXk+Ikr9N3M5dnpBEBWfWXl98pUYfzuB4XcsHXHwlZ5FX
Vllgd64PwqhvVhXT6nZoRGEu6gQbGr1JS5tpREq6tkf15B/bKgIBuiBoEBUF
UvRFp18dPA6dnR1qoN00F03CJaqfYAXwBpCEYH3TfNIYtl3QUL6Bdv4C42na
c5ipzVW1jMDheNB45fNNXf93ztGYq6yUIuPQbSMuy8GxswaiM5jFfiFHls8o
2i7jwjs0LOd73m4WJnPYOU6bj6GiCp7xOaxcfLAjrOpYk8MSafOx9xiNIWEv
DosLziKtySyC0mit82V1QY4AJcKqHrj3GWKOvhQMyDMTDg7ItQpmQMuZActG
NHpQaetnalhJc+e7H5i7K9ltjkdjhJuiokVC21OmpGtsij45O0WqwuuonSJT
2gDk2o/yNfQzFOWVH5ZvIEqV1k/KIhR9wvmOzja0sFnPu+OJqmP2Qx2/fEMq
XJH9EN8I8fLEbFkld+PD0e7UkvueCCwVD2ON7GYYGFox0gB4UB6cN8teZck5
dAsIbc9eLpV61YUl7L5vuVTf2EUiflPtqlZNhS0JF2IykHnKerjN9IYl3M9a
CYgIf1540XSb7RpjOr72wQ83qex1dnc6+ad9Jj8di9+cN6AdwvBBVRJQaFn/
Ye/0oTilIerVJq6AcS3Fv997+khQwUVTXWyqq703k8nkN7+RH75vF9tlPZmc
XtamHrRE367om9hv6v4cetsXzdW63fSd6KHwebtctq9At1HFgMwnU0FFUUeW
a1fA/la+Q8eAereoz+EveL8SP/30b8+/u/+7L7648+aNrq01lrDc55999jso
B7A2nQbOXAPjQ7Vo51uM5Qa4eC9Hqq1PPv/sU/vXZ59+yr/dvf07+dfX+Ncn
dz+Dvyam3l1b8uMvPmGtfHz39hf2r9999vlt28rnn9+mvwAhqqXPPr79+Zs3
Mz63k9/f/+HBQ/Htw0ePn558JWA11WJPIeWbu7fv3pneuT29e3eGCN6bKAyo
7+KnidydTFW0mrgzu/MlvKMYhHU1h6a2m9UxFj9eV0AH3fGPV8vjVXdMexrV
zN6XyLZufSSe1+slVnrV9Jfi8b2n98Sry3qFV6XA9gRm5aNbWBCv4WmAldS6
2mMiESQhTU1yMmVxSUDePP9Ea8G0JN9+SS/N7Krlsqeo4Fjcb6+uYIxEpw+q
vhKn1BZooeJU7tnFwxXsguoad8mzPWzvjQcBo0kHBnyf7h/pKNV/vB+2Hpx+
8P3b9QP/aTcX1UrlCaPae48fnn4XQ4K4t5lfNriD2G5qWpkneqcpDk4f3jtR
bPQv7eYFvnuEewzZ07xd9cCgZPt/eST+Up8dw8/fX/b9+vjWrR52Y90MxzoD
cG69urjV11V36yvV3iPxpOl6qPD7qwoERHuMX7/Rxb+ayGIPF03fbrDZ02pT
vxAnVRXoXKaBDj5+8/ftqoHN9gymK2zkefWi7i7FIxjnZZNqB3EHn7+ZN928
nYGkDNv5c9NdrrbiWfWyWolvAZPVVaq1l2f0OQ/XH5uratVdbsXJZXWZaumy
g48AVb2q4lD9dXtewxQ9abapJsSPVGS2bLY0M99c4Id4a48vYNl8u7nuYN5T
7TX/dSYLfHNdXbYSWUQbzIcg6YNodYG0qjgULcqHSEQgtrZy430kaGdNDFE8
f3a/m8mOUQ5JuXW+XS6vqRLsLIG7t8Tgn9b9K6BP8X21qi5qZPCyHq4NipJ1
qfzg6fcP7h3O1Ijvt+vrDd6CIw7mh+Lu7TtfCLVYtl1PkGAXMHWd0YekFD5v
gONVIM62/WW76UR7TiXnAOhMiHugrVCzHcYN461wC93j8xr0AakVIkvGLrZd
jSJNWlfozVmzqjbXgsZ5JBluq3zn+AcoDIgSAGKuUAfiD4C8atAKJdbbTbet
Vj1gSGKz21IQmGxAoW3ZzOsVdAzaGeCSlrOSrUf0/QT41VIO89uTB0BXVFw2
0dU9wgZQAdgnUjkWn8zmGgsWhfudeFJfVEvxTLulOo0GDHMFggVwqPgDLZ3l
9wNkJB1yEmymri0vUYCTbnZoaAQQoKUcAQF/c40F8VMB94VvwEjFX+H5Eoah
xoMw4+um7+rlOVEn0ppYEuirtocuicOiRLtFRR8uZscwt1IiYnNyloAlbqEK
llDnzBH/m/qqfVkTVLIFaLKeeY1t1+guI1joB2w92leyVfNOgb/eni3V1MtG
vE5U+7jbqCXWhdUVlMTxFyks0yfQBVC9BqTlMpshUwqAuIhCTByLe0w6fS+X
blwKK/3U7DRwHI9XQJLn1dyRaVr1De9c5C7W9NC+rXCN6UYQGmxIsIak71DI
hsZ0vWqnfbum7bLq/ww7ywL6ZQrOZz5Ul8BjzoHfwjI8q+cVsgqghg1R9ApW
supZI9CQC7mBF1BLl5gavrUZN7hFvUYb+KpX11u+n0HCVg5YHlAcDNVAoEcZ
zJ2EDLgxlN6uQDA3SzyWMdMVUIaYVlLV4dV2iRAYahTfVvMXr6rNYvq8ngNT
hS2cIODvs8oH34KwOhR4+SXw9doqA8/uP8QhVAKkD7QLf+ZWzqeffHLnCFf3
57/7/NPyCVrP6ykb8fuZHByZ5DLC4jo/ttujaI6yDNEBm8t2/d5XlZ5AcpHD
DKLZ0C6os2uHOA2oGKvW5bAwbmKZ7wsm+MUKyAsTPCxa0L5W7w0l3AUn8dEY
Zq2gQh2gWS1QHkFdXl7C+u5QsmqND+oXowm70gwoMH6HW9Go3yElEPtQCx06
XYN4Qkb0XjBgWJda7xoNFo6fh+IlEjXh/zLkLmEwkhUqKHDe3ZDXd6/eE3sD
zfHZ3e+foX4zv6zOmmVjrZDA2oCgr7LD+vj270Yt1It5O71qLuTW7r0NETSi
R3QBLUjoFUjsDVMafmDp08XBo/s/HAoLIKkE55i1OSvHPv30s9FY6Nrl9r0j
4f4PQverx/+OR0evgSNMqd2fYXCrls2Ko52/O1Vj/aKb1j+uq1X3PicIi03/
d30tTrZnLduZw6732f8+ORTCgoSVt5u8cvXp3REjPtus5yBRJHP9BdRGVJYF
9W/ViFId8k75MFWkynuVH0odUFpSibAYR6wRjfD9DGxYB3ynyv/73Gb6W0E9
LgUDTePbbHGcaFcZWJ82Upw+VOWV668jT0lst+40C3hQV4M46zjSdRJVz20L
DgSDANCB7Wrbt07PJsKIlyLrbh4M5a2k8mgkpYPwgpqn2jPayHufZTSanji0
o2JRMjdL8y8UBGaqENqKfQeq7XpfurFA+9NtKBQAfdBuj+y6ywYtB8vqut5I
m2rQEhoA9o22iE02vd4lp5qKobbqunbe2JQY00VDls3+Oopjv3gSufdsQXIZ
Cdsugde3putaPDl51sEgWrVErIFuQ4bBM127Fueb9kqgUila3C5llcjPb0c5
wabt23m7nLIoxVGWPFVfRTk6NJvpplo3Do+JQJFmLV6XaH1uKnFvvdZ2WTR4
o2v9isSrsWkaQX/v2ePDAiBh17d+l1AG1itpjBWm6AEI6WeHwSz6PC4D8tnF
O4X423azAE78CKjyVXXNAP32URLOT+/ctXSGHS7qcxbtocAjOlNXC6lXyrS4
d6uvj/ua/isN1PYn/kIHuur5TZKXoR2eukAhota/9oFBi8ALql6sarny/OVi
XGPw2YiFWTgoHf3Oh7RdWWU2McqSce6ZsvD8VuzBl/Wmuao21zL5yy3vhYcY
jZp3C0FXA2IWDgzuqwQU72GaFC7QDmRAkoMElb/KziIw84t6pcMKB+YyEr/7
Jf9OB26bNUilBcYCD5DpIxaTIcdq/AQdQC3VvZWCX7kS2AhufUQ3AH9kh2c8
RhSQ3KxkjKMM9tCv1ICxmDfomNwCrG8py5Ktf052deaeknB6Hg55cZgwjVsE
Mmxr3IU9E3XwVrV7c0VO3vvVCuXgpl6ji3fVS3/w42eWaNUMIEXI8wECzwfo
1zOHgxCkTPIpWFlgOls6+FY0a/YmDj+N4fEzA4iBVTbIhhPBHV/Cqkt2yqGs
7wfhsDNAOHUHIHqTnTZEHVlCnJF5XfMJeOOQJ2drGXX90mjLeu1TBZtzSvcA
fKUzm5grUNRsEb/A2rAY9uUFsPh/bGEXphNvRZo1caD+N1KHv0yOUeYyq8eP
VVVMjTmmAGJQ3XiU7DA4VyYUDcvj2e9+ErNj4QkHbZ65dA+D4x49rXb8AxP7
IeAhDl4aDyqmjkZsYrY7R4rQyTuHN8vjdnn58VC2iZUj/D6wa1zV/WXriSsW
9cuYrrsJTDTka2Kga1TbZY+aFK+4bOfVcnmtJ2Wxlx8TxmNJOElfQlksa5Jk
v5SEcyTqBveDlqerXsxZ/iMQCyC7sQXcQlba5gLNMUeTMOVhYigK/EBfJqNi
waT6deiiV8czbUIcO+YltVPfgy0G7GcXUwRlivbDenl+MJvdSiD2SDDdFDTT
fReh+kAv4FSNcf9wj01eXF4SZv0ONVa0jULSU+McHLHdaZRaiamnnpZMqHZl
Z/qe1l+kiNbdJI1m2mwWoXS93tvV8trTcDAePgvGX3DoXd0f8fEzssAIOgpZ
WhCWkHtZiLCKCc9BFV+WnImnrfHgyrgRZBcUP2crk8dBhu+hEkx6iow2jAxx
q7itM3s/J5X5yxZozNkIqBORXwaLf7Ot80ucML6P5faNa79zsL+4BpbWuAua
Kb6rxS3A3ctq2ch5qS7QJd5TEyoMbMrDwDBSDDmabeLg9OGDQ2lpI9ztn1fL
zgFn1eoOENGqB3fioQ0EFpWnZmNXBZs0PJa6sIb0Ypp8zMEw9lcJirSPgRjB
ZhSDpKg8RF5KCnTz1tf9ixk/1WWGlUGGLyvUmJijxX8MNUh+KgjX2fGTHUnC
3JwLlSSfop1WwrYbjFjtGWW8ppHWrxpg67SVmpJEaVYhG9ys5/4mMlAkMntI
I9OtzAqiwJSO7eg52sJrbaddXBsxCNYMlqDjdOHpEsEl1WaOm/PpeV1RsLKd
t/i91u6CH7axXJBzvNNGkrDBmM0lWjJp7YmSy3Njn0Mrs5BgAOvQB3qoCz0j
BiHA893lwvVHA7LS8778WcjLarB5JVrpyrqwozkGbWjbDuYwZpNFmdXF3p3Z
7O6nn0bwqpbynTzvPlnXc229YT27TIj8KMv2Vb2RQo3lZsPnsrm4VJ/CMb3z
dRzsbvOofjHtLtsNRSrL0qq2q66nGuW4DyTjAGpPDapQJbJwTB04tEKrxaWv
yTpqnQzchrWOq6DD5sgA2fSgdTHewVQSihfAuCuaQ8qVK26TYrxuu65BMxmB
k7FuVE5i7Kw/0mhZ3mbQtOZyyygTDLoCBWErBcaeV6BASa4WC/LlaT2UtW4Q
eXYdcHduQ3Jh5WnSbBkioiApmmP1CqyxNBhe50tWOiZa08PUe3NlyDKxhrz1
mVNekNK2qdeSiKSFlNuljtAfaSxgHXd4yge9qlfbKxj6y3qJvfLOyIgNRIZU
bUwFbn1JdsNAuZaWQbB8KBwIHA0DH9c+mCB+6SHO0f1a7RyVM5lOR9aw/Ylb
QYzersIiubkjk5MtXA65vG+uaEbZnCldsJDuyU6NFfbJyTPBWxMsg4fYrtAJ
V3EIOilo5sEUSMVa5hwK1ovMtFO8AACo6eMHRDivLpv5Zai1YVwmzBaCyve9
MUrgZgFMyWSgK1Z7T2lTIb3jpi3bKWZKx5bZsF/U12KPpX5jACbmBU9Gqvno
rEd+YY92cDcSwzjPEBWgPVQN8fHVQ0reJv+1bripo+ZxzHqD4AEs3ODlVpEK
MCLk3QCJTRVCp30dryisu5fkpVY4rFzYbwGDWWXAThH1ToAH9DAAuqS7IrfI
z7nVchld0ZbL8P+IXNaR5IZa7BJN3jUyft3eT6kxqUWcurPEX9nqapLyVe0o
VF2wiPVVJ1G++Xkx23wx7RWrNDqR0UlDLdST2ffUzuCF0i61zYdON5BWWqEe
ADt9tU944da3tQ66w+hi4h6CCGYHBqeN6haVgY+Cdxfn/8kstOOJK4gz5IKz
jMAiOsEgJQUriaoDc9h4iCDCCrK7hiTm+jPy01D/SOdc475cGavdzikAfyEW
Wz8tYXiCL8N0vfSyIdxhqtmyMZgWAexl1UXOBSob3iBwzulTBlncgodPaVir
32lmPM8lEHKjH0a2SlDHqMrDmmssnoSHaAQqpaQMtj5Crp9TgcevzXIIrPY2
qK6XqG6pXm8W6G4L1Pi/jDLhDmIQPjfOiEGXiaeS4Cnj0O0Z/W+vCPanXuSJ
DkaRqudI0FU+6zzolMouDngZyE/wlCvstax2PAxmcpc95Mcf2oI/Mw2wvXdg
dDIuHCezqGvpS3nBiHcUuMEw1wXGep+iN8w3VlS6dznB2LtFqsoUbP2mKr3z
TDgNf0eOLWzZVnW6mAP8m7CjoH1b3XQkzbypiqqYqDBsuWYuZUoRAhrfqbfT
DMIfKaoH02GFXi2Zs/W9zoXqMsC3HVgC8TF8e40lkKtKeZgkL4cylqkMF9J8
YVtBj3N3WW1MzIQleOuWVlv+t5yJSAJcz92ZDjJ8pTI/FSnn90xxFIBXmEEH
HaHGColvAQ1LzKxjBuwLHiw0l6GVMoKENeCZD6HoTNxbdu2R24Q8GlWZcCIQ
Fuo8A8w+A1H6/a2JxW2FkG+hpAqZ2EhWshBZzkBwgwWjxl8UhYtnlc5qgNfo
ET58KiABNSeYUrFeVngIfbW8/lLUs4uZtRkDJbbzKoCAusDDKdSNiX7AMBuV
b6aSjebDL9USVmjNL2IcHZGfPaKBT4KYP//s7hEiiejyk9nd2Z1B2uZSZYQX
PdZK0v9mXbLETYddRhIopXrde3aiXlxV80s8eqEmkJKueUxChcTL0HTNKSx7
UE26NBoLMBjIP+0iLKMPJXWhgRgJslqa1ny4YXYJLDtuBZ9RmVYe6ji7XqVZ
tDh40j47EiffHYnvTw4Vc6Y4/kbGKoi/nD4XqI8y3+cGcI6oxA11PxOPvdgn
3bROf2LaZLOGQeN8BGpHZjrTlZ2ujngDyAy0/UyXVvZ2jF26p/1+chr00QXb
gsHZMNZdUHlgmT5jeoDs5MhJk+DVwQymaD6VvhmMCrGtkM1LsijjvEGj02EB
nda/RjIVtR17BONDVBoSp21kiErjxGnrD1NpjDhdyh2g0jhx2iaGqTRBnC4U
Q1SaIM7MIoxRaUicbCABlY7c4hRtbqT/31SPOBpZJKut9lOOoKN7J2bmoI3l
ih37N2vK08+TGnrap0gpsJHOJB1cY3SYsoZomGAiZO/OjjLUAQKV1spin1t4
rvms7S0r+XkMHdfwQuHvVdyujK5Z4AtwEeIqQ6kxBnfOv/PJe6DadbYiOqki
TKnWnF1/rwOvc8O9D6C8yMGCsV1hmMveVQO6z1Qqw91eBPzbw6BTrAR2eVb3
r2rFXhb1fFltjOELePDJd8hQTx7gopJRJFwj1tk+6Rp0zC7v2MwYVjrYGqDu
5uxcquVFu4Etw9XbUfWrqukxepIw38dQyL3nCoUx5MXxhDjCqYReAFfn6NFR
Rm69bTNT/nbjqNbdVF5b41quopFvqdi36BK8U0YOJIcJAB2zpU+526A4EkLK
GNI6F7eQlFOOdiGzB8rupUg7p0MKjjEFyt9xHGnxWs4lUlgJxkuC3JGiTI4e
wRdY87yhTm+QTeptmVrAqU/i6wj5L9I1xd0350dMAdOSD/aZbe/mHa5XizWG
3HQ70oDvbOMSLiu6nmdF4S8kuzj070p4cZXh7aSX31K5+OI15W800F+XyS+O
lIwA431088s6lAplIw3bGTHYSOU13lWkzw6NH7FspWDM709qc/B+WbH9LyOh
ZXqZX0JEm6n+F1c2wm1Z/sBGek/Gci+xPDm+w8mKNJ52R8Zkd3nRFu2Aizb0
HYet+gFHvAS82HOm5x9bPDIiuapKR3bL/sIP5YFKHA3Ei9Uoi2bq88/u+v5t
D/C38m7zVEbYltbslMP1Gr0EKjrVqegMStnPEe9pB2w86HsgrmMgN5PfUeFA
XSmbQn90ArxBvWVcLgcqHo24E2h2bTkpfuUzcHy1GF7Z9FvCanhofMlO9a2h
Y9cuX0XZVawOUKksh/aW0jHhxQZIviZGrHG8zOhmjf/Ca5wSxnsz8Wtb7HkY
f6WrvgCx7hqM4pirzYWgylZHQpwHlLGHEEyKzbqsf5zuuDQNGxlPHAmoIyHs
RnVyLgy6Jd0sRvX76JYqfll39VuHvAPI7QIDADFmzewnBpITqjwiVhtt1RFX
c9pAN0vXvslapnF5MZpCiTJ1qNJ63ka5tM0Q6JW/A0h66E2nJV56vO8u9ORF
8TUCelt/Xq1ltvJmxAhcjI4cQnQ/oXLJ2Nwwu9KApWVr3+Iz7rGTYVdndqvB
UxI/fhAJDeCpfd9Rn2G24IAzcErZzPXl6v06cPLKe7DGDRYvtNL9kxUzD8Ci
698VAHzkI6E4a8wts+8wgNG6tiuvh3krr+le+CEjUeq/BKCrzfzyumgrfc/N
02fxY5rJR4DbYtkN9X1TQfVi623wcjFi9ZEwb9uRvhFofq0voGUMaUB91hUo
WIt5C7Rpft32ON2Y5YALPnsJkWvzoK1EAI8jruVJQv8sXia+TLWBAefXcTgZ
kKpzV5V2YYwlwmJ0Gj8ENz6jqn1U3pYpJnapKImBf3jaVbHT2EA7qUGuc0ZR
sBRoV9U1RTxcVi9riorz2hASkF6ex7yuexc7HBTSXDMqRHpTGa4DTLNDMeDD
1PmY5+7k9eUdRgeg+/D008593QGFNMHx0yLbz111U4h8dIg2DIGFewRq6M8S
hK+in2H0wB2Ksly60LLr4rMAv3XovQMozVSJ+IiAjncAIkDvG9PPqd9iNAcJ
GCKX1DmQ55MkmPRetrI9xBCsAndRd9u1PZwqQ60fsgXAV/yYAxBKcBZZntu1
SrngiE2TbdM/2/hW2Qgjx7OZFlItm6ob3ey9FVSkwDMgAQJMOWRsf8RblGSU
F5e66cKuyTUkzyFR8pNlc17juwiQERKJbLgHEPA4QqGJ3cHd21+EQMyB4kr7
l1Qqa8TO83uZoR1QCIQvbt+5G4IQOyoWnTK1oJ+2qwF1UR8a4y2bvEEBlJxu
7AUP4/d62UsicvHXkYrb9cAIrRMmvEQiRmy4+CqpM7/l+NIjK88+YaBnYMVA
L9M+eIKzYH/rK+U6Sp2tupxWbpQIOkYA+nj9Ul5IzGNUdYsHnb7HFx+Zkb3a
XNS9lCaolmGwi8xXIjm1aUVeSQstsDBaGWdTXa2X9REdxVksJBz4Ae83UA5k
lT3yFg+BXdR46S9+UXqqF3ziXWfg+0yz0QzpqxA4OWRd6P5dF+d0rFTLKH1E
wCxU4ZGa4l0a8VMJbCRCy7cGpmJmuFFYeyCRsSnDu4myxSMs8tI5kgVcBsdY
or5lhsSGDlOyI4upofKGkbsfW4fNG38x23typjLCOeDf1iiecHZHaf47yvyF
O4uWdWLDGuxJPZXyMtx2j003OCZRss+JWO68kBHEtvo+L3CugRjwelO4mcxX
wHJR+X7vSMJ1fGJb3qGsCLwXK73CnDkKjbZf+ykcaSSbdg4aNXCTSDufHT4C
D++PF2L8GBgXJVedxnN+u/k0sjtjNkdmNS1sB2YYibRfQuNaJxihq9NVg/Gs
4p3fgsztpBi9ydAp8xUy5LkY05k0BjARGCSIqtwM8YHpgS6dqRfTM3I8bvzP
aWzyVC8Gg3EsuNlR1IjIJhrLXs+frL1Fz4jYm81uef/fi5QV4d0qDiHtUilp
0vENNkPIFPL+D5Y91E3/5uSq9yWLfrpLdbG32PYgg5wzKGpFsRsRYi043bRr
HQoKUm7b1T5V+mPkf9nfMRdojJTDxZzlOWrdxWhPthQsNRf2+LrTB6fdpqqN
l6rPBC1zx7vNRhIk76Nzr96k4xEzfXQYRdumoQO8NPOtOwUd41deDiOpKzUY
73cdTxpIpyotwFJpcRvRI5iJP8pER6ZFFYaNx4eXeMJIZklFuT71m6joEjiM
Kq6UQlPJMajzxapFOh6FHV61nUfEtnE5F48V5dIu41Id1yVMY3Qypq7GvNke
HftXEkka1mQQLgv37lwNCJNjCfJPsuQIKxtmxFk2nBFpORY8qBnQMAr48AAX
jvLgyBVWUfYau+0qyVR9lpqVTll2atio5ZkhdCVM1OOUYSNx1vkmnISKst3G
kR8ET8snlWp1EDfuUVC1BjQEfET6iH44LjpM38EmkriW4jxJMsyNPxQV8cMV
KVExpI8nQaElnKT9HXTyEWuPtGC379h2Ljb6uPZbjgVHQU1iI6FZvlesxHYH
Q/HQ6kLZtBXauXhWd65vgeWNDKCWt2PH0KzWWx7LbJZ2eP6lMP4udbstR0du
HnxYg9g73zHXbvv0GEBTQePk6FEwH4jT0vixyMwQCIRiOu5FvsZiuJsXQxsb
BumIHT4OTqPHiYu1rmtMVQ27jKP0k6m5+0zkwBk9KxlsZLx4xfk6zOAGnXoJ
+KRab48a2ttVQLb3+g6ASh/cdsWdzipAcbb2pL2niX97rU33dBhxpZL62Bob
nlABAHero5Kur/5RcLAkS24mg9XyegxWE9klfjVIrT8AnFbO9bMMefpLEcaY
3tXyPN/RzCtBtjLqs81AqcyvCUETz36FD+V1ksd8zYldXw/N6pPIlAHmLTqP
yAGDh9tAzsN+Vb/IjkqOTF7R4Z42PmBZwQ7zWrQcxXb5KxgDGgYVEAUwu0el
fymgCQqO99oDTE5CWF9nd2PHEs09E0Fmt+wcFomax1Euk0eCC7QRuowZhKR3
FEyl24pKduTgqDjynp/wi8Wx2yZ1zGaU+dhvhexHG1MwaASNOlfAWpv10p9q
HfSnptYdeNE8i4OrY67yHHqp61jOIMkHY7QWzmwwBS6tS7crayfMV1iUTP6j
j8TDFe1q2XXP+ppnAZ9lBL66Eloe8JSRmCWXQssz6fN2s5CxqVMWvjmULxT7
ek51oTOq7WThTp/jzHWa3+k8P/kzjs/pU53ZzKcXHuxOXxcoTUbMWSz+IPaV
eN7fc8g+HQaKMzynE+JMT6Pkh2nZTrvZwsT2Eutq/DRGCjgNtq/sND4bfiTV
XjQRdTc1f+VooNPJ9lh8BHn+swSwy0Ug6hIQ2d2Iq0D4LR3qOgnvBgt9jlff
+MODymVlqKOqctvhb8WeOeljCpabI97pdSPZw0Qmi3/ZXSHv4CaZxyxGobPe
iZOHTx88fP5fpw+/f/bkHsCj0gu4zPS7x09OodDJs4f3nTC2+SWmrFmoVK/t
K8pMSrfk8FyA+KC04GkbCbNNj5d/lgpGFoQWwVD8NpVdty+Ra1LU1SNlN6Xw
W4+cbM9fhkXy7D7BFzw5hJClhRAUUEfqUiKIzow9kmXkPYQyoozKde6RM8lM
PLkl70fklYriPsMubTharG+NvWgS7J3iQe+pQrI2EbdkPksWS4uR5KcPLYnA
qqs359W8DpEVPdfST9dt14RRigXhmt82vTCVjWakg5xiKCsJ5qRljpfRf3z7
cwbwm4E5/fkn0sqkZO9pacR6Z51GpVLQOuMd0btHjVjhELG1n7mwdKjqDnZz
OVJk16zJQN3ILsokY4nxgW6zvChnA7J0Ga2cPH/yyG95iCh4+0PUYNrPkAG2
NzT/tuRbTeA92a+ZQgRPhNMXP2Q0On3ALryNMODxN4Qyo53IzG5p4YtYKwN4
JRFCDWY6nLddxM8w4rQ59cIUPWxwJv7UmYtAlO2txd1hcCSMXS0DcEgP8Kai
LD54qFmeXrG73hT2Blae9IixQMWC9Ze4F7hwLXp3DxeybHdno4KoA0CCU8MZ
tyQHobJ7N2WK0Zf3UvDFfLmFZo7t/Exl2AuOxFogbIPRgjRfXjLSoTpd3W/X
tzBpmI1fiVeRxSkLoz6NnSt5VWO4jzhrt2iGsgXlKT0MyTUXX8minDaplgxL
gRUMykJvNX3kgSCKtGtMVqZZcyzr39nAcXLHsnJin6ZVvVm2sAOXljDqljeC
N6Up85FJ0X5WdTAuGsDt2W18Pv5/8IICSQZnbhAWwIzqySef3SEgfjh59t2R
Vlo+//Sz2/T28cnjk1mAQLTurNzp6IJCxADcS8SZ2pa5yDe82tYtHBC+1OtV
UhlfnlFplK/q8ni9NKSahwHdpxQJbi6T18e8+2rTU/ARXXD9smm3gMj2Clp1
Taj4+OcZzVX1jRPnpOpbThU/Tn3uXW+vj9JugBxqO+2qNZW0f8KAARFG4qie
X67ozNqR6Nor1GXNpcacAdBBVFj6PAqnr17UlNgGC4Ik04kpAbBqfqkHYsuf
umfazPjRdoHGQZsWHORwv6mrK1vatqKqWQS5M7+szvCIS93TJo7vArz5xot6
UhPuMsIQzSofuT4aqVd3E5n9m2kvn/ZF+2plJp516FQcO/Gx3ZTPHn5Wyezr
zYnOh1ToWOcZbdrrpUyx9kEb0K7fr37sclQPHagJZIxACY1s9EbBnwQ/i6mX
K0jae9hURdVFVarArvxItQdNd9ddX19NX+EtAhGNNE2EGqYs1ZV3FKHCxK43
8pm2kJH3/nR9GUOudoHlkatKFSBXX48FTY9CqJ+wIxOMlmo8tZSD3Bsj9rin
OhSb+8hC60RwPDz+XQVMJSt7UVnZVUH2/XqNeYs3+tTowCzGjLjvxv3y7lId
aSkl76dfLMi9Rc5OCsDFQ0l2fnyDv/LX7XYE/N2lTrLBejrxemIkMICTk8c/
PH0ruK0TKbDHWnfKEKBNyqMi4SN5sqlJHbLoJ96Cx4Dblyo8AY/5u/GKu40p
dHy5g5M3kLZ4v9n0H9tqeD7QqfBQp7ZTRGYTaI0D7h2cIceVmDsanxnFwFFx
uRL1Dn3HdG0kOdxGimG01gFztlmn+sQQ7e1aKvPxm824b9yBOnOlofaBc+0p
qSb9II9ZqzpxXUcGK41vtB5qE5Y+6Pr9qEZVnVwgs8mkoEaV3/3gHKnD5mqh
mriO5qUxTOkbBnUZymZjAVRxKIpL8KOcbDLVnQQkFYjat13xpOpjJ0Wouufc
SEn7Qzyzei3wuuEzEN+X8oA2GVpkGE7gFo7crmjvbIxepuhp0qmbFdWA7OmA
wiH9j7pNUs1PnjJVKvxgGhwut+vtkmWn7K2fOuaZ1o7nnHPaaGD0hvQvpuRq
rmZtYg/l5SdQU20n9UBjurUBIVB1pU6o9tkPlO5nxu3vjZSBUFZS0jCo5Ov8
TiVSDoMqTmAPwyLr5vmz+92t+sd6vqWJemDVVMzZqvtkCV0zGirbvkCzFORg
2K97wMCzWqmW/VvgAVC7Bj4S91iQP7s+vVY5SuiwpUpiQjKN15X5Tpj9RqEp
RfxIxDAECXU03Iwfl/KOriRGF5xh+eXHpwAfGOAbnxyGTztZStBlobsBUtC6
pUsEqY2gzSIWAx7avWwbTGnYYOqsMDQdwzMr4DjXING3ztGmpAz4jppSDbuR
RRTeWmEIeJDnEh+V/GvpvdZiF48U+6b1NHw5GAlODEm8NueSVtRxfK+MTyoQ
moYEciyWKtPZ6cQHFQ8RHg072XZVGvpYIq/cGNKZH9VRsLGUpo+UxAmOHVcL
LYfv47SdPW2SOmqnd9ZNt9mug2O/MigW9vnwYTHF/fC03UwxjO5gNrslmz4S
3nHq34q9fZNp1J6x04mA9t0UHHF6T7vS1SEfG3NP98JJlcdLBCS79pSuTsYO
yu3OWc1GnneaByw9exZxODNVwTnEovRUI08gchb+ZvL7+z88eCgePn1w8tXk
n+aZ/HQsfnPeXEzJhzrt8Rqpfln/Yc/qCKRcghCCn/9+7+kjJY/2QCz8Btfk
g/olclr69D2Wmkzk3Xz0GgqwSuJgv6n7c8ygKb/vH8qWO9mLzudg1nzfToAV
Vhcy+gEak9VmygOjWlViUZ4r14GIbs8zgPY3CB+WPwGmOkftDl/SIB7rsJQO
oYeWz2CjNzc5NeToCZKa7J0mjEWlKMYQVBVARzzXwDl5KB3enVJabfwLC2KE
2seTyUfi++rH5gp2J9jQ5iVpoibS4CgadNCJg2/vH0LV75atzCpv855LJdh8
oJ5fogFcBuJCJxRjIJNtQBMWNBtRIds40Laaw3gAnixl42s6o3+rkAN6i1BW
HRquZDT7WTV/gfYHPxOnOOi2gPpKmjvxSEy17VsliA41dRGbUgZRP66azQ5M
JcEIn7YyfJguOFPfJ3vUwJ7otmdTJiDwDApef4wZ6H7C1dEQzVLhN2809c3R
0KaNsrQHVYDTZH5rpotJjGMgIjnHbGKrl1WzdGcbN3aL5py2VhjIoQJBiFhW
Mn0TOSbnSxi7VG8O7p8iIZgLphZqi4h7A2IEH4mnQBmcjmR0FTa4btvlEd0g
d2SCTqCxE5yADuagOzYm7S0irzsS55qw7Cvss6OL8fQ76Pigms/rNUBya1P/
nfI2HGIfNV1UxouCCrz4O0wKZnpjKNOw183F5VlrrNDq9fecwBhf++dErvtj
4TIcqKaVaJkzWwf4/HY63bxilGN5L1OroZCAUrI14ubOSnGe3/8eGyMLp+Md
+eort6h3+JS6aCW2I23mCV9Fk5tRfPWVgxLN6xk1M3Zv17/8QtwTFkYPc0Xc
Hjgl/BQPmuoCeMxkIpeGRMYUS715Q+tG5RLEsgtZVvPRUChQXn+8vgGN3GrO
OqGlxAwty/szd2LHzWx0Xl/r94YN0hr6muOamcPcOgBzX02BWQGp9iAQWK1N
r0225muqPy3iqIOvc/1t11NTrfvIoYfB/jD6IFF7sC70m6o+WNfg+yPxH+b3
33SZcFp8QmdPc35siuGGImgEKECKma/Zp9eqNle9WFAbr3/AHLpU+NBrCIod
HxCHcXy/h24pM/awaLRVA8LxQb5VjldWMtqcHjYfOauThCAaSB4FxTw/5QPY
30ThM0iP1UnVCEYUqxyZstBdfxhQiIQmLAl0G7z8W4S+inBx5IWkUDtFWBM5
IPGTSpAVEjXFkw9QM4UqpMhYanKAB/rxtwTp6IL4p4ySTk5ErDdvcFTEoB7/
KsF5EEA/jEWKy8+gLyMXzBNh2CIpIyIAZZhoBI5AXhTB4cqOHYHwpcCOzUTk
yY4txe+vArqJfLj+W0CQ8RausQDbxseq6aTfPkHEq2Edrsk5lNgiO6sWeDNw
09W0fZ1GiprSpG5P9SaOAxAsO14N9gf9lOqi+x70+6+Lqq2AO+1Qze1t01xc
1BtZM06kvK7BxWJK9zVMYVdc4aTav/4WVLU9m0IekHLigJhoQ7ECHcLSX6Ay
4n+Vd4Zrj3RGFoMrlstwBoK+sPQcE+dRaqGS0s0KimAGO2mWtFVM6RDM4J4f
DrAK/matSisRgeET6693jOjAUv/a0bXUHGUYd5T5lsJdXGL1qFWtuwavt2/1
aL8eKIaBSJv2+utwYC0L7iVrstvA6rJdh5IjuNnGrdRu+4sW+ZLRebGJlA6s
F6vcGuu35kOz+Fr3eVGvpjxbES+mRVxiB4LL+qxeBkMxnJosbnhfPC5dLMow
pKPeLX7MpzXDTxwrIjpCUTZCUTBCERthZlwTcoRZ3jD9kU74mOsxFmzTjp9f
SW8X28fLtwfML+XcEqUUpqsKpNMUiNP7+Fo3gE4d85BFPdkKOnEM8XjtMTBz
1BazIbBtf8RkLPf5zGjMrQFoTEBrgjYZw2Y+ZzP2TcaiucI7haSV4bxFCz+a
ocxVFceTyVTaBtB6IOeSjFz0rlnVan6Z4UH89NO/4ZWpX3xx580bXZtZEYOS
n3/8yce2JNozzUWgkcJ3v/jEFtakHin32We/4+V4CXUQY75FFsntIcqu/+3D
R4+fnnyFDs9a7LkY++bu7bt3pnduT+/eJYPK3kTbUDwTCnkuCGl04rBdiTuz
O+hNQKW5W+M+fW+7WR1jrWMyNHfHP14tj1fdMYUAuq3Jg0+3PhLP6/US65KJ
6vG9p/ekr6nqMDgNhicDDjAPc/Ojsq3pqo9pqsmSLAGWZSUFGDyZKA7ZgPR/
+IEpe4tNdd5PVZ2qU9RRH4t7ktwo+IE8GPLKQzf90kN1uQSSmg58RqKynoM9
HmJhAZeTHYNb0YEHPb9ONhiDopJjoa5BtYCfUlsMcA7xTMHmQsAI3IGhOc/0
DoSfwphBhfiePCVIqtGO3fXi9K2ZbwYCWE3Z8SNbeC57EPdA9th5aTcX1Up5
DKnFvccPT7+LIQwqwvYAo5PwSAnO84kJpDw4fXjvRDHSv7SbF/juEe47qSPy
Iswly9/7yyPxl/rsGH7+/rLv18e3bvVtu+xmiIUZQHPr1cUtpMVbyiYM5dF+
DxV+f1WBiGiP8es3uvhXMuZHPFw0fbvBZk9B430hTqrKizdjDXTw8Zu/b1cN
6MAzYH5hI8+rF6AQi0cwzMsm1Q6iDj5/M2+6eTubt1dhO39uusvVVjyrXlYr
8S0gsrpKtfbyjD7n4fpjAwp7d7kVJ5fVZaqlyw4+AlT1qopD9dfteQ0z9KTZ
ppoQP1KR2bLZ0sx8c4Ef4q09vgAK+3Zz3b3w09nb9pr/OpMFvrmuLluJLKIN
37W7R+Sr/atbdSzWeDldv0GncpmRrqFOrD6738nDu1LSyjBLrAV7HZ1gTtZ6
WvevgFbZyqRlg1F3tUvsB0+/f3DvcKZGfr9dX8M+7rIXB/NDcff2nS+EWjN4
iYBK6YPbq67VsegmeH2BjrRq21+2G3NUd47pNoW4B/oLNdspZydeMSCrP68X
6F9Erwo59qELvLSg0ffM0xt5cbCgcR5JwaK1Q/wDVr+6CE/aS47QD7jGk43k
EltvN91WXpglEdltKeJfNqBjbmEGVp288NgeyEFhLE8mnwBHW8phfnvyAOiL
iqs5qnuEjXx/4sREQc41FiwK9zvxpL6oluKZDh3tNBqW6sapVhZ/oIS/+n6A
DKVDjoLN1LXlKQpw0rj1zV/kr9RCnYCAv7mShfipNuQ5BB4r/grPlzAMNR5i
qfBaplUiKqVraJYE+qrtoUsKLULhd4uKPlzMjjGrDEl+bE7OErBGvAMPS4Au
fobOVsA/XqyJ0c4yrA1agCbp7DhvTKrXOt4Vr5DFvFDG70XvFPjr7dmyMWG0
0IjXiWp/QlePENaF1ZEyZ3AwAWRvAGnZUuWhBntp4YWIGFA4YpqG5jRphcOG
vGLcrgJK+vF0BCiVCI4gdUpb4+FQ8ZC+ZMPxtH9yh26CYUzOPdC4CnLupc4u
OjkbMvn2sgcjHtt6QoLpXUNnLAl+mI+fCCRxj1kumgw79e/f9K6Q8ywUPxMQ
qnV1ZA/YzbUogEmZQ34mmOof181mCCL/6LtnhRkkuX8DmquLSe6BPcDNs0na
0xqFRLeItuMRHtqMfNRm7kJOgMy6IkMuNqrCJhKzG5qdggA3zygwBghTMeyd
HSTXAR62Y3UY/lhadyhTRpBqrwQFbuRIAgVk4fFHnbYFjYGAKgxRsWMpK6Lh
EXzzT+t3QcLbSCv+BZ7vhIBNR4Z8243JRpIn55+LoBhIvwg5mf6TxORqAios
U3VkT8nM4mqA1gIcqR3RAx4YE50Vnmqf4l6hHfMnhEdircgYcyNomQDzzr75
7op3DIxqfhiOqCPkHQMjrxBjHYGyfI47vb4ic4WKGY7DGmiU6pST0v2iCT6d
8LH8sXdrdSrJX+C1W57BIDBupW9U9hu9sio5j/QNk7Qgbft3OqssBzE5qvI+
qw9FOlGsd31Re6SHQVmdO0DAUZ1OGuxPto035oeODIYC7KT4ldNogtQ4GfVu
MNZU5ZYuoySVyAvDaQMKkgeH/OitPBG5jadCpOVjMq1WkcMadOwmDDVjU6zg
i8eYlZ1mVU2058kcn/pIUxyEXOO4R4uM/9ZzdZLUKywDmG/db5ftxgVAH7qI
5lGVj6tcsJKjzhwNzt2oI1PRqC4P8p2ywA4g3WRTiI1gZ+zHgBqYhliV3eej
zg1rx3NgOE2ZFMCpNL7uLO44h2+Ry5clynHK7BVxdz/pE59QvFEguDDb5MHK
TT5NfeqOzvCGThtdE7uWU17KGeL9VuxtvoEMYeRZVwI71y5ucndHsjPWloxl
quBQglG84zjRZdP6hkLLxHwOqDyG/+tclVYDiooiNyuyWiDqkt6ffAKl92VE
qc+qsJNDkVumyWBLiVStkTpCq2GqYEebDshzgxcMiL3bs9knd7/45IvffXb3
i093pZs/U99qP42jKSIXhxdFcRz/tEMeaYd5YJHduAZN1BC78HJem3n4OfgE
oeaW82fiHt/RPMCMdezi5wu8uVhP9UGpqTl4NbjizaYEDd1NX19Jzza0Zo9d
mdY0PPZIX3RFSyuuE9fs7joz+V8onLlMudynsvvsWj57ibabtQYfmYhPX4dM
YxOPHz1TLpZOBYq4deTVIOhZ065DdqTtqz/wQ+N+GhY5jnY+36JHcuUeBsyl
CjJok1lJF2W4OP3j84cnf/zhyYPp/ec/nJw8fOBhxedzCkUeVlQcLWacUZ6n
g8rPG35J6UsIf4fqeHSAGn2ftFszUlAiuBN0mlEeye11OlbvQi0gyrN63l5B
6fof6NjrW8waYI4oe6dM89lpUjnRkDhbRrveFdo2oRVN+rU7Rn2XfK9SDdlh
gjRRocozEada20pqblIUa4mUb/wGqTVGoLYBS6niL3R5zH5Al/vs9DRejhlL
FlVAXAE9ZUdhLiofoCWOTpeoiunIn9eIjc0/ehExpbtM8A969gvs6Kcy2EE3
LacLryxC7yPSop3K2HJjJEx2GjZXKkVBFTbfnrtNxPAcGqFde7NtNG8+dIen
T7/LI8tTeyx9GggfYTIny7APedpzqc/0y8wFMq34iq0XW/2sRqGmF2Q4rYmT
MCWzG66SwpmWF80rV4nOQXHVbDYtjrLF69HR/NVHCdSyno1KNy0Z1QYIvIHS
+NeGzz8/lmCnmyo6iYCdGc4IbQ3oVB28KZNZQS1PkFcC028v9Q3vvghz+b3P
pFGJOWvJNj3H0x3BLY/Iexa1/ubzmEUts5PjJzUdXv+tYWiSvhb+afdOYVQR
mltdZWlD8oQ9F23IKSInm0hOUsA4JAe1QiSrEuPxK3WaDx29A1oBRjPRnqsL
csR4BJqWHQXE6SGMcatBzEWQFasew1oaUbaFfX+dBhq3wYNE1AGxK3fJys4P
3wYRsokjdZvdvk/Y+2yC9D6AKzSJ9jVaXjXLpeR/stklO+ZgOGcoLKa0a3XO
Pu4oJ2x3sOtEGJ2KriT6Q2T4JSFNZo/tAlyuVVhqUioc3s4gSY9WaCcvPKdB
Ea7jKgkFQmqBtl3LKUHmxIACWcYrK1m2eIfqB+vsoP4RXSWdCiRNaya+durm
UjmMKf9aXTfCmSmnBnVGsXU2DZZqU5TnHXP9EGjPB/mG+n6l1GeZZIbv/SIE
GEikUQTIaa/dwO91u1qo+OeMypjSaDp9kawlXiJnuT131LFCsrUQUsy4vyej
K2jSdPthEKsubM8LRqjXNsHJWOsuU6lD0JRFKbhA/EeiUVx/ikorFjpU1AVi
ozwqqrHoJQqmSddUGmaVGYrK8bsbHKLJUCB4joOYD4mnMhg38ngfBgG4MuOp
Fgw2yKsQS6aQD1P6/8u71t+2jST+ff+KhfohCSzJj7i51ocD6rh5FY5rRO61
QBAYtLSJeZFFlZTsuFf/7zevfZFLik4b9A6XAk1E7mN2d2Z2dnb4G3vxE8T2
hK3zMcbmmot9s4yon4JvqMXa9UNkTI8vddxr0WATN4dHnpSuAURRghZQ4vOI
x3Ay20L42Vwvwp/Zrqv1Ej/NQ6G93UB18o4jBWLRNw4nqrrxs4LuzvrF5iQ6
TGWqwcWJITfqS1SPeO/2GOYw11N/eWMbbQ0eraF2bOr83uH22KaZZ0vU1aBy
YWqwz5BAgbxvi29tIIR8ERI5yYmcSbHLe1CYAiOpE5l2n4lvhz7tb8Q8dFwd
HksFR6P02naBGPbTcB5t7omq3LMvb7/dZ2Aey1KsBpowSh4izfXu9n7jTHcc
21cbug5uXflO5jM6x71hSok/qYkNPaJjd0TxheQi693fK1cFFDE2sqEfuuq/
76DoWlvAVnuOx6ovDg7v39WpVXtcj77tMa3LFW5YNk9F1HEPlSFCbt2gXqUl
VASaIGnMoWCEZN/4V5tJsJZN2Jy7AI+2IkSndt2HU5c3ccUDdKNw9pN6dgNG
ODoVqSGYI2pWXHcN+ijiJgFDGtFdI7ZnOFSQsdkZEonw3npe57Q1ERTrzvVu
Y5KjM0L8KhFRHBcIA7biN52RHrVGEhZ73dSJDRux6t9n86r7WDihakFMNoWN
uIl3iMyJWPaEYVU7okSLE4W+/7EFIiKhQTuMZtB770lO5YmJcFziuPJUyhgp
I2hU/Ok9vSQGtSBVA0apGnSOvDs9jIfLiL9BaORxSXwxUWeXNL5Zt2F86uuE
HDMNY498Wy0HVpt5MzFr6RkLgrs6Jk9S5/jlcIjwMQt5uiNWaXzQ9PeYapun
I4Wz0HMMDfy1LlaIUJFmZomBvpiGMOgpcju04bfFXojeueMSLd0ji5zgszc+
KeKGYi9kr9mnz7WjL8n7TXkAB9ctd8GX6t2T7dMkBR/B16gN1Ed3tqQGElgH
jWyooKfOb7PWEWmtF8fyjeN4LYVOV6qbtkQyLeZLa5IbilR1sGSRFdKS3qYt
uU1XapsOY/I19m2T2aQ/i0pbkwHlERRacwzpVz2+qepDeJTHJhlzuCm0dGMK
D4e8JcBKHpbNCkNrJg/1lT4pVs6dXykV/SQPb0bWMGalgnlccJKBBaxisaSk
60HrY8SGJ0SzJ4+/vbsj7659sL8LDxjYDCdlfeEmDkwTPI7k1RVVyPRyXV0q
/xDlwgHmEHBNRZkYDK6vLVXZ5POYRwih4ei6ikJtVgXlZdAT7vOCrl4W0TAp
dQfspaPpPMchYlKUasy1JLhQAPFF3Co0o395faxPUT0ew2FqjT73h7/g70eu
UEXQh3QOoFsI3LjJAWV9oAgr4i+7F6u4T5NTRIFzI0GfoMFnBkUpHsFYkrK8
kCQoWOClmUPNEG2vwlIExHYUpru3uU8szBycuT/AcQYHEEPt/fTmVeWCFBCb
BmeAC5e3svSPn3zzzd3dWD13tbgN/GycIe9coWGteWnJs57CyxOYIhcld5XN
jGQFwIkFeg50D2A6LPtGGofhHTFU1wExEQxk8oICLGAwB/pk+3AosXa2a+hF
Ej/icB0kHuMW9SXBJyv4EpRwfoTWRbwpQrl3SxhwBqUIqZRdS16lJzt7O7iU
br6x0IFoqmBqTywh8K7napwS6hu3ZddHUHPgoQDmqJY+g7m8Z9dBzZiCaHma
hPD8foWQTmtMkZKQnwgKKLh9rGM4ig5EE6CaXoIok34LsyAp2FQYIFFCQ6dT
vuG7zjO9EDyvK4/nZRP8SuB2VumTZ2dHP548F4l8ske6F3p582xCL6xS3tnH
9SXew3RZoIukpp5nt/gtNSuACkdtFOXAJTA/ejt0KGBuZyfsGsx6RHRxNe2r
QXMTbmpyaUDnPZxMXj7Sjsi9Gi2OWkfMy7Oz04nrV92j37PjiR30/v4TYmrs
yaKjxQexQ5pwEk5M2spITQ9PDo9eP/IwoDillPZ1RiFOQI2B/nDJUKmDDl7J
wtH64udL+XQ9z0o3xeF64D5FdTO1LI09lhgCKJNwNrSAfMKgVCMu0bNLCVYp
nCrZdHjIuJ/Tni4oXBgCgrxHWTt1HXg0ZGmb70rdgAQgEdt4bcv/ggky9C/9
MB+b8dA6LtDSG8o9cm6Dg8nJ92jMO7gKesdMlxcmDCiuMACOPvyEgV6v54hp
QZ/GICjclbHSoMziOi+LBbkwxvpnINAEs6AfYq7doTazfCU+g0eC9laZcPgC
IafYTRrkqaWggsvsmibOfOBvUc379/AWbQcrlL5LGR3NF4kQWw8MHRr0KKyc
l26ooF227UjpUhGMFzwLbdvD80GcAy2MszPW88AZcAMMwSg5mfppweh8CENi
uZTmI68C38KUggOnGaLwBUl8EH/rwwJBJUDvfjSrSuXuowzgXYNTQ6mlygIb
Hgv5cm525PMtc0R87Ti+sNmO2J1jIdGCdGsBVUVpkyzPTQnmYdcQqWsando8
Ot09Okzfmq1WWLZUlKp1XhUEXChplgrNqZsiBJ7sApEKsVvLOtaaHirBJaxw
1ydztihhnyC7CIyldcnBrtSlm1x/Lvqc+Y0OVipKY9dvGnswCUyj6mSSCcqz
hKGAXpmRnAeSklJJHQpDdSoMHSuMVyvWTutK4GoZI9JylEJ67OhFl+Be/MGs
hvg/0SlDSVPprPKkkhkrpxn0n6QZ0JEB6x4uCslwFfGceFyI82oZ2Z1FKNMz
VgFXk+7j5c3jFr84b4c8QXmLvUq/JzsgSuifxQ7CCcotblLtE9EBwW491cb1
rOVbhqVdV3yQyskXhRZQvDyEeQrnxU+YtI+SQWIkHH3KZiclK8tbwnzC2Vgx
5CSbUvzNl+QYJXRF0AWUL5XXGO9fEedTYRsUUHct+RQdu8R0h+mvexBf4s2E
ubZ25kx1c5MYXaWYFRLuZ78FTDCU8gx1Zq1ZutONbHjUlbB3zBASLzog7Y53
dRTzKGb13779egd9HJS62AX+ODMfzPAbaJAO5ofTj4viBhpni53psAC5N6QU
5/lHw+oiW3ykzvWVQQvNIehewfLko2uzmDl/CJ0T1ArRwW4uC+K6fHFdzK/9
twRk0eX2W6aVGA7kqtlExFlxpU8NOrFwdAjCZm5szB4vAv6CiX+/nqv3xsww
sWewYHYq2KiPe6JdMu7uuMhA7cB6VBUC9x4Xa/3UlB/woDGBv/MCfs6L1Sof
goBmc/gJjDXUR1kJ/z41sJFML/NiqJ9jBldTTQt1nP32G+inoT7ML9eZfrGG
t99flutr+H8xuxUs5ezX/EL/UCwk/qw+Mu1GVrDKUW5cuLR0SMBbLhibHJTx
ENmAsD5CoGp69QzRog90Db9a0btfYFc5AnmkJtbZjcn1mZleLlB95ui+8fX/
BUPMoSqU/pRn311Sad/SU1j/n7mho+JqmlWrsDK8PYe33xGiKlbCAlzZHnUP
l+hAzz/pwwMBWkfvl81qK86GyprHdsMxQdZb3DOiPLoE2RucQd0RlBbih8mP
Jy4ubqyVei7+cGkTxIldZdhupvdpn9SvT+FkZ1XDDR5v3kz+eToCk4beWMR+
GxRsVusl8aOaF8USl5VIpZyqlJ22JCmiLLDMt7Ztcl3BpDzPP4zOYEMDqq3j
bl15ebMToNgzfOHfeD+XzFrFnhVYl92dMf636xzC8mAv+rWvKGnHaLTlyvFv
+8D+Uo28ab8n/6Jyh64eN/Q0avZ7LgcPtjr73eJ+dSNLU+3P780yW6NRPKpE
md9rf0sZT7jUPwofbtU88mE7zVdb7bVk/h8r63QP2CBwtltOsezAPh2UGssU
NgHKU8y5bXOmTJAn9b+/OjP84E5ky7I934FzlIZUieDjo0yqtU0IjRY8pKOx
raxgVJTRAIpLa8V7MdIZideGhxJAmX6el9VqWOsfj4nUrKSfXRT+lsN6P/jU
WcY5q9l2Ds7VtLGgT58NZjKOw44Y6dTQ+VXk85C0hWm++B6VxiuZArz92UA2
7lMCHUDb2mxG+2Q2bzFnlyUo9fKWjSuR3dMfJ2d6G4eAZ4BtXJNt8TUeeIuI
HFfbYEgQb70sMNODLC8pXXx6SNmSD8ieEENjmzKVYJtb/6rkgumInTkjTHvR
XVjhZdbAEcN31Qf6LTVjL7oIGQaeDkSxnwMLnPN0nR+e7w0s7MPAsgWWTcch
Mw/5GhxTw3m2w0pMibsw9RUYqgzLWn3o3yH6dL6ggQYF9n2BC9izS2aqDIc5
oJiZoHGbxoOoiAgic5V2hlFZXS8H7urtnbpjBQ0iK4EJJwQRQ5c+R56x2yS2
LqeBOOoHjDZD1+tWRlaL1QP2s8l+5aDkMTLQ+0BYTKKqCxDSPOL9eX6Vr+qa
47JY+mQpYqIzEf0Y2sLzMOyOGPpewP8CPo/ZPEkXrHZ4set4/ir7hJjCo8eD
EN1kQLUlWAyEH4OWD2o3w80yjSL4ST2/TzOcvIT+B8N6xfUS7yJtu4PHniXd
lbDlS1lXUsPCozXu9DpRlmIo2oxRlfFWUpRiiiWRI/HKCReAT1gxQ9m6ZB65
Lezuv149xmzDf3+Oitw/3/0jSjKIH8BKlFuEe8AVPacFOccF+av0alNv1tVl
bxUs+ydJZ+WmOZzqRrGm4NnFCGZqtyZAA9C/oQ/CjQ5vI+pl2xRGoBw6AzXe
JXeLUCpPMTiHf/eTTIpEkFC1ujBqKoxcnaP7zH76P9NrPDn3k01xZXGLzY3A
bQ9Mwf+YJH+mEP9/WjqtoumFri6ObwNpaBFNLNmQyR6basu2+lY3TmT1elT3
c3dbqpzeccM/d7Un71TbW/9vW+auS0lQ6HaLKnjw4tnZA/3r2sCxg9wtfKYr
YQlLFl326lNU1Cw4q0SyC43ozbIrf/+jfZ/j0Wwv95ajiGG2/ySxt1EsLuRF
MnzhGNcVpRDTezs74kLMF9P5egYThfoqmjXvacFmD3gSIi2R5vc2Xg+koY3H
B/X9Bjnuspg1OZFQ2ea31j8+Cxuxz5iukXytk5u6rMQF43JvI75sSNjHEewZ
5hOplqbh2WyuKWpciM7co4LSp6XLpUo26Guj0zXRQa0rw6EMMBuU0wNlPE2P
Lc6ZPwLtupdAG6U/daGXp2lKNo9h7wuOYf+eY0g8fdd4Vi8V/w5/+brB7Azk
ZjLiXYzi3simsnX2Nr1dRZyYcGPVzSKUjIOmbu/rx18/GfQZU6TI3wVnsP8A
OXNtjdpvAwA=

-->

</rfc>

