<?xml version="1.0" encoding="UTF-8"?>

<!-- [rfced] updated by Chris /11/07/19 -->

<!DOCTYPE rfc SYSTEM "rfc2629-xhtml.ent">

<rfc xmlns:xi="http://www.w3.org/2001/XInclude" submissionType="IETF" category="std" consensus="true" docName="draft-ietf-pce-stateful-pce-auto-bandwidth-12" number="0000" ipr="trust200902" obsoletes="" updates="" xml:lang="en" sortRefs="true" symRefs="true" tocInclude="true" version="3">

  <!-- xml2rfc v2v3 conversion 2.34.0 -->
  <!-- Generated by id2xml 1.5.0 on 2019-10-29T21:33:17Z -->
  <front>
    <title abbrev="PCEP Extensions for MPLS-TE LSP Automati">PCEP Extensions for MPLS-TE LSP Automatic Bandwidth Adjustment with Stateful PCE</title>
<seriesInfo name="RFC" value="0000"/>

    <author fullname="Dhruv Dhody" initials="D." role="editor" surname="Dhody">
      <organization>Huawei Technologies</organization>
      <address>
        <postal>
<!-- [rfced] SG: should Divyashree Techno Park appear as <extaddr>?  If yes,
then what do we want to show for <street>? 
see
https://www.emporis.com/buildings/327639/divyasree-technopark-huawei-building-bangalore-india
          <extaddr>Divyashree Techno Park</extaddr>
-->
          <street>Divyashree Techno Park, Whitefield</street>
	  <city>Bangalore</city><region>Karnataka</region><code>560066</code>
          <country>India</country>
        </postal>
        <email>dhruv.ietf@gmail.com</email>
      </address>
    </author>

    <author fullname="Rakesh Gandhi" initials="R." role="editor" surname="Gandhi">
      <organization>Cisco Systems, Inc.</organization>
      <address>
        <postal>
          <country>Canada</country>
        </postal>
        <email>rgandhi@cisco.com</email>
      </address>
    </author>

    <author fullname="Udayasree Palle" initials="U." surname="Palle">
      <organization>Individual Contributor</organization>
      <address>
        <email>udayasreereddy@gmail.com</email>
      </address>
    </author>

    <author fullname="Ravi Singh" initials="R." surname="Singh">
      <organization>Individual Contributor</organization>
      <address>
        <email>ravi.singh.ietf@gmail.com</email>
      </address>
    </author>

    <author fullname="Luyuan Fang" initials="L." surname="Fang">
      <organization>Expedia, Inc.</organization>
      <address>
        <postal>
          <country>USA</country>
        </postal>
        <email>luyuanf@gmail.com</email>
      </address>
    </author>

    <date month="October" year="2019"/>
    <workgroup>PCE Working Group</workgroup>

<!-- [rfced] Please insert any keywords (beyond those that appear in
the title) for use on https://www.rfc-editor.org/search. -->

<keyword>example</keyword>

    <abstract>
      <t>
   The Path Computation Element Communication Protocol (PCEP) provides
   mechanisms for Path Computation Elements (PCEs) to perform path
   computations in response to Path Computation Clients (PCCs) requests.
   The Stateful PCE extensions allow stateful control of Multi-Protocol
   Label Switching (MPLS) Traffic Engineering Label Switched Paths (TE
   LSPs) using PCEP.</t>
      <t>
   The automatic bandwidth feature allows automatic and dynamic
   adjustment of the TE LSP bandwidth reservation based on the volume of
   traffic flowing through the LSP.  This document describes PCEP
   extensions for automatic bandwidth adjustment when employing an
   Active Stateful PCE for both PCE-Initiated and PCC-Initiated LSPs.</t>
    </abstract>
  </front>
  <middle>
    <section anchor="sect-1" numbered="true" toc="default">
      <name>Introduction</name>
      <t>
   <xref target="RFC5440" format="default"/> describes the Path Computation Element Protocol (PCEP) as a
   communication mechanism between a Path Computation Client (PCC) and a
   Path Computation Element (PCE), or between PCE and PCE, that enables
   computation of Multi-Protocol Label Switching (MPLS) Traffic
   Engineering Label Switched Paths (TE LSPs).</t>
      <t>
   <xref target="RFC8231" format="default"/> specifies extensions to PCEP to enable stateful control of
   MPLS TE LSPs.  It describes two mode of operations - Passive stateful
   PCE and Active stateful PCE.  Further, <xref target="RFC8281" format="default"/> describes the setup,
   maintenance and teardown of PCE-Initiated LSPs for the stateful PCE
   model.  In this document, the focus is on Active stateful PCE where
   the LSPs are controlled by the PCE.</t>
      <t>
   Over time, based on the varying traffic pattern, an LSP established with a
   certain bandwidth may require adjustment of the bandwidth reserved in the
   network dynamically.  The head-end Label Switch Router (LSR) monitors the
   actual bandwidth demand of the established LSP and periodically computes
   new bandwidth.  The head-end LSR adjusts the bandwidth reservation of the
   LSP based on the computed bandwidth automatically.  This feature, when
   available in the head-end Label Switching Router (LSR) implementation, is
   common referred to as Auto-Bandwidth.  The Auto-Bandwidth feature is
   described in detail in Section 4 of this document.</t>
      <t>
   In the model considered in this document, the PCC (head-end of the LSP)
   collects the traffic rate samples flowing through the LSP and calculates
   the new adjusted bandwidth.  The PCC reports the calculated bandwidth to be
   adjusted to the PCE.  This is similar to the Passive stateful PCE model:
   while the Passive stateful PCE uses a path request/reply mechanism, the
   Active stateful PCE uses a report/update mechanism.  In case of
   PCE-Initiated LSP, the PCC is requested during the LSP initiation to
   monitor and calculate the new adjusted bandwidth.  <xref target="RFC8051" format="default"/>
   describes the use-case for Auto-Bandwidth adjustment for Passive and Active
   stateful PCE.</t>
      <t>
   Another approach would be to send the measured values itself to the
   PCE, which is considered out of scope for this document.</t>
      <t>
   This document defines the PCEP extensions needed to support an
   Auto-Bandwidth feature in an Active stateful PCE model where the LSP
   bandwidth to be adjusted is calculated on the PCC (head-end of the
   LSP). The use of PCE to calculate the bandwidth to be adjusted is out of
   scope of this document.</t>
    </section>
    <section anchor="sect-2" numbered="true" toc="default">
      <name>Conventions Used in This Document</name>
      <section anchor="sect-2.1" numbered="true" toc="default">
        <name>Requirements Language</name>
        <t>
   The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
   "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and
   "OPTIONAL" in this document are to be interpreted as described in BCP
   14 <xref target="RFC2119" format="default"/> <xref target="RFC8174" format="default"/> when, and only when, they appear in all
   capitals, as shown here.</t>
      </section>
      <section anchor="sect-2.2" numbered="true" toc="default">
        <name>Abbreviations</name>
        <dl newline="false" spacing="normal" indent="3">
          <dt>PCC:</dt>
          <dd> Path Computation Client.</dd>
          <dt>PCE:</dt>
          <dd> Path Computation Element.</dd>
          <dt>PCEP:</dt>
          <dd> Path Computation Element Communication Protocol.</dd>
          <dt>TE LSP:</dt>
          <dd> Traffic Engineering Label Switched Path.</dd>
        </dl>
      </section>
      <section anchor="sect-2.3" numbered="true" toc="default">
        <name>Terminology</name>
        <t>
   The reader is assumed to be familiar with the terminology defined in
   <xref target="RFC5440" format="default"/>, <xref target="RFC8231" format="default"/>, and <xref target="RFC8281" format="default"/>.</t>
        <t>
   In this document, the PCC is considered to be the head end LSR of the
   LSP. Other types of PCC are not in scope.</t>
        <t>
   The following auto-bandwidth terminology is defined in this document.</t>
        <dl newline="false" spacing="normal" indent="3">
          <dt>Maximum Average Bandwidth (MaxAvgBw):</dt>
          <dd>The maximum
	average bandwidthrepresents the current 'measured' traffic bandwidth
	demand of the LSP during a time interval.  This is the maximum value
	of the traffic bandwidth rate samples (Bandwidth-Samples) in a given
	time interval.
	</dd>
          <dt>Adjusted Bandwidth:</dt>
          <dd>This is the Auto-Bandwidth
	'computed' bandwidth that is used to adjust the bandwidth reservation
	of the LSP.
	</dd>
          <dt>Sample-Interval:</dt>
          <dd>The periodic time interval at which the
	measured traffic rate of the LSP is collected as a Bandwidth-Sample.
	</dd>
          <dt>Bandwidth-Sample:</dt>
          <dd>The bandwidth sample of the measured
	traffic rate of the LSP collected at every Sample-Interval.
	</dd>
          <dt>Maximum-Bandwidth:</dt>
          <dd>The maximum bandwidth that can be
	reserved for the LSP.
	</dd>
          <dt>Minimum-Bandwidth:</dt>
          <dd>The minimum bandwidth that can be
	reserved for the LSP.
	</dd>
          <dt>Up-Adjustment-Interval:</dt>
          <dd>The periodic time interval at
	which the bandwidth adjustment should be made using the MaxAvgBw, when
	MaxAvgBw is greater than the current bandwidth reservation of the LSP.
	</dd>
          <dt>Down-Adjustment-Interval:</dt>
          <dd>The periodic time interval at
	which the bandwidth adjustment should be made using the MaxAvgBw, when
	MaxAvgBw is less than the current bandwidth reservation of the LSP.
	</dd>
          <dt>Up-Adjustment-Threshold:</dt>
          <dd>This parameter is used to
	decide when the LSP bandwidth should be adjusted.  If the percentage
	or absolute difference between the current MaxAvgBw and the current
	bandwidth reservation is greater than or equal to the threshold value,
	the LSP bandwidth is adjusted (upsized) to the current bandwidth
	demand (Adjusted Bandwidth) at the Up-Adjustment-Interval expiry.
	</dd>
          <dt>Down-Adjustment-Threshold:</dt>
          <dd>This parameter is used to
	decide when the LSP bandwidth should be adjusted.  If the percentage
	or absolute difference between the current bandwidth reservation and
	the current MaxAvgBw is greater than or equal to the threshold value,
	the LSP bandwidth is adjusted (downsized) to the current bandwidth
	demand (Adjusted Bandwidth) at the Down-Adjustment-Interval expiry.
	</dd>
          <dt>Overflow-Count:</dt>
          <dd>This parameter is used to decide when
	the LSP bandwidth should be adjusted when there is a sudden increase
	in traffic demand.  This value indicates how many times,
	consecutively, the percentage or absolute difference between the
	current MaxAvgBw and the current bandwidth reservation of the LSP
	needs to be greater than or equal to the Overflow-Threshold value in
	order to meet the overflow condition.
	</dd>
          <dt>Overflow-Threshold:</dt>
          <dd>This parameter is used to decide
	when the LSP bandwidth should be adjusted when there is a sudden
	increase in traffic demand.  If the percentage or absolute difference
	between the current MaxAvgBw and the current bandwidth reservation of
	the LSP is greater than or equal to the threshold value, the overflow
	condition is said to be met.  The LSP bandwidth is adjusted to the
	current bandwidth demand bypassing the Up-Adjustment-Interval if the
	overflow condition is met consecutively for the Overflow-Count. The
	Overflow-Threshold needs to be greater than or equal to the
	Up-Adjustment-Threshold.
	</dd>
          <dt>Underflow-Count:</dt>
          <dd>This parameter is used to decide when
	the LSP bandwidth should be adjusted when there is a sudden decrease
	in traffic demand.  This value indicates how many times consecutively,
	the percentage or absolute difference between the current MaxAvgBw and
	the current bandwidth reservation of the LSP needs to be greater than
	or equal to the Underflow-Threshold value in order to meet the
	underflow condition.
	</dd>
          <dt>Underflow-Threshold:</dt>
          <dd>This parameter is used to decide
	when the LSP bandwidth should be adjusted when there is a sudden
	decrease in traffic demand.  If the percentage or absolute difference
	between the current MaxAvgBw and the current bandwidth reservation of
	the LSP is greater than or equal to the threshold value, the underflow
	condition is said to be met.  The LSP bandwidth is adjusted to the
	current bandwidth demand bypassing the Down-Adjustment-Interval if the
	underflow condition is met consecutively for the Underflow-Count. The
	Underflow-Threshold needs to be greater than or equal to the
	Down-Adjustment-Threshold.
	</dd>
          <dt>Minimum-Threshold:</dt>
          <dd>When percentage-based thresholds are
	in use, they are accompanied by this minimum threshold, which is used
	to enforce that the magnitude of deviation of calculated LSP bandwidth
	to be adjusted from the current bandwidth reservations exceeds a
	specific non-percentage-based criterion (represented as an absolute
	bandwidth value) before any adjustments are made. This serves to
	suppress unnecessary auto-bandwidth adjustments and re-signaling of
	the LSP at low bandwidth values.
	</dd>
        </dl>
      </section>
    </section>
    <section anchor="sect-3" numbered="true" toc="default">
      <name>Requirements for PCEP Extensions</name>
      <t>
   The PCEP extensions required for auto-bandwidth are summarized in the
   following table as well as in Figure 1.</t>
<!-- [rfced] SG: This table is ill formatted and seems unnecessary.  Just make
it text?  Not sure how to fix the column width.  -->
      <table anchor="tab-requirements-for-auto-bandwidth-pcep-extensions" align="center">
        <name>Requirements for Auto-Bandwidth PCEP extensions</name>
        <thead>
          <tr>
            <th align="center"> PCC Initiated</th>
            <th align="center"> PCE Initiated</th>
          </tr>
        </thead>
        <tbody>
          <tr>
            <td align="left"><t>PCC monitors the traffic and reports the
	    calculated bandwidth to be adjusted to the PCE.</t>
	    <t>Extension is needed for PCC to pass on the adjustment
	    parameters at the time of LSP Delegation.</t></td>

            <td align="left">At the time of initiation, PCE request PCC to
	    monitor the traffic and report the calculated bandwidth to be
	    adjusted to the PCE. Extension is needed for PCE to pass on the adjustment
	    parameters at the time of LSP Initiation.</td>
          </tr>
        </tbody>
      </table>
      <figure anchor="ure-overview-of-auto-bandwidth-pcep-extensions">
        <name>Overview of Auto-Bandwidth PCEP extensions</name>
        <artwork name="" type="" align="left" alt=""><![CDATA[
                          ----------
                         |          |
                         |   PCE    |
                         |          |
                          ----------
                            |    ^
 AUTO-BANDWIDTH CAPABILITY  |    |  AUTO-BANDWIDTH CAPABILITY
                            |    |
 AUTO-BANDWIDTH ATTRIBUTES  |    |  AUTO-BANDWIDTH ATTRIBUTES
                            |    |  (For Delegated LSPs)
                            |    |
                            |    |  REQUESTED BANDWIDTH
                            v    |
                          ----------
                         |          |
                         |   PCC    |
                         |          |
                          ----------
]]></artwork>
      </figure>
      <t>
   A PCEP speaker supporting this document must have a mechanism to advertise
   the automatic bandwidth adjustment capability for both PCC-Initiated and
   PCE-Initiated LSPs.</t>
      <t>
   Auto-bandwidth deployment considerations for PCEP extensions are
   summarized below:</t>
      <ul spacing="normal">
        <li>It is necessary to identify and inform the
	PCC which LSPs have enabled the Auto-Bandwidth feature.  Not all LSPs
	in some deployments would like their bandwidth to be dependent on the
	real-time bandwidth usage; for some LSPs leaving the bandwidth
	constant as set by the operator is preferred.</li>
        <li>In addition, an operator should be able to specify the
	auto-bandwidth adjustment parameters (i.e. configuration knobs) to
	control this feature (e.g. minimum/ maximum bandwidth range).  The PCC
	should be informed about these adjustment parameters.</li>
      </ul>
    </section>
    <section anchor="sect-4" numbered="true" toc="default">
      <name>Architectural Overview</name>
      <section anchor="sect-4.1" numbered="true" toc="default">
        <name>Auto-Bandwidth Overview</name>
        <t>
   The Auto-Bandwidth feature allows automatic and dynamic adjustment of
   the reserved bandwidth of an LSP over time (i.e., without network
   operator intervention) to accommodate the varying traffic demand of
   the LSP.  If the traffic flowing through the LSP is lower than the
   configured or current reserved bandwidth of the LSP, the extra
   bandwidth is being reserved needlessly and being wasted.  Conversely,
   if the actual traffic flowing through the LSP is higher than the
   configured or current reserved bandwidth of the LSP, it can
   potentially cause congestion or packet loss in the network.  The
   initial LSP bandwidth can be set to an arbitrary value (including
   zero).  In practice, it can be set to an expected value based on
   design and planning.  The head-end Label Switch Router (LSR) monitors
   the actual traffic flowing through the LSP and uses that information
   to adjust the bandwidth reservation of the LSP in the network.</t>
        <t>
   Bandwidth adjustment must not cause disruption to the traffic flow
   carried by the LSP.  One way to achieve this is to use the
   make-before-break signaling method <xref target="RFC3209" format="default"/>.</t>
      </section>
      <section anchor="sect-4.2" numbered="true" toc="default">
        <name>Auto-bandwidth Theory of Operation</name>
        <t>
   This section describes the Auto-Bandwidth feature in a general way.
   When the Auto-Bandwidth feature is enabled, the measured traffic rate
   is periodically sampled at each Sample-Interval by the PCC, when the
   PCC is the head-end node of the LSP.  The sample interval can be
   configured by an operator, with a default value of 5 minutes. A very
   low Sample-Interval could have some undesirable interactions with
   transport protocols (see <xref target="sect-6.6" format="default"/>).</t>
        <t>
   The traffic rate samples are accumulated over the Adjustment-Interval
   period (in the Up or Down direction).  The period can be configured
   by an operator, with a default value of 24 hours. The PCC in-charge
   of calculating the bandwidth to be adjusted can decide to adjust the
   bandwidth of the LSP to the highest traffic rate sample (MaxAvgBw)
   amongst the set of bandwidth samples collected over the
   Adjustment-Interval period (in the Up or Down direction) depending on
   the operator policy.</t>
        <t>
   Note that the highest traffic rate sample could be higher or lower
   than the current LSP bandwidth.  Only if the difference between the
   current bandwidth demand (MaxAvgBw) and the current bandwidth
   reservation is greater than or equal to the Adjustment-Threshold the
   LSP bandwidth is adjusted (upsized) to the current bandwidth demand
   (MaxAvgBw). The Adjustment-Threshold could be an absolute value or a
   percentage. The threshold can be configured by an operator, with a
   default value of 5 percentage. Similarly, if the difference between
   the current bandwidth reservation and the current bandwidth demand
   (MaxAvgBw) is greater than or equal to the Down-Adjustment-Threshold
   (percentage or absolute value), the LSP bandwidth is adjusted
   (downsized) to the current bandwidth demand (MaxAvgBw).  Some LSPs
   are less eventful while other LSPs may encounter a lot of changes in
   the traffic pattern.  The thresholds and intervals for bandwidth
   adjustment are configured based on the traffic pattern of the LSP.</t>
        <t>
   In order to avoid frequent re-signaling, an operator may set a longer
   adjustment-interval value (Up and/or Down).  However, a longer
   Adjustment-Interval can result in an undesirable effect of masking
   sudden changes in traffic demands of an LSP.  To avoid this, the
   Auto-Bandwidth feature may prematurely expire the adjustment interval
   and adjust the LSP bandwidth to accommodate the sudden bursts of
   increase in traffic demand as an overflow condition or decrease in
   traffic demand as an underflow condition.  An operator needs to
   configure appropriate values for the Overflow-Threshold and/or
   Underflow-Threshold parameters and they do not have default values
   defined in this document.</t>
        <t>
   All thresholds in this document could be represented in both absolute
   value and percentage, and could be used together.  This is provided
   to accommodate the cases where the LSP bandwidth reservation may
   become very large or very small over time.  For example, an operator
   may use the percentage threshold to handle small to large bandwidth
   values and absolute values to handle very large bandwidth values.
   The auto-bandwidth adjustment is made when either one of the two
   thresholds, the absolute or percentage, is crossed.</t>
        <t>
   When using the (adjustment/overflow/underflow) percentage thresholds,
   if the LSP bandwidth changes rapidly at very low values, it may
   trigger frequent auto-bandwidth adjustments due to the crossing of
   the percentage thresholds.  This can lead to unnecessary re-signaling
   of the LSPs in the network.  This is suppressed by setting the
   minimum-threshold parameters along with the percentage thresholds.
   The auto-bandwidth adjustment is only made if the LSP bandwidth
   crosses both the percentage threshold and the minimum-threshold
   parameters.</t>
      </section>
      <section anchor="sect-4.3" numbered="true" toc="default">
        <name>Scaling Considerations</name>
        <t>
   It should be noted that any bandwidth change requires re-signaling of
   an LSP, which can further trigger preemption of lower priority LSPs
   in the network.  When deployed under scale, this can lead to a
   signaling churn in the network.  The Auto-bandwidth application
   algorithm is thus advised to take this into consideration before
   adjusting the LSP bandwidth.  Operators are advised to set the values
   of various auto-bandwidth adjustment parameters appropriate for the
   deployed LSP scale.</t>
        <t>
   If a PCE gets overwhelmed, it can notify the PCC to temporarily
   suspend the reporting of the new LSP bandwidth to be adjusted (see
   Section 5.7 of this document).  Similarly, if a PCC gets overwhelmed
   due to signaling churn, it can notify the PCE to temporarily suspend
   new LSP setup requests (see Section 5.7 of this document).</t>
      </section>
    </section>
    <section anchor="sect-5" numbered="true" toc="default">
      <name>PCEP Extensions</name>
      <section anchor="sect-5.1" numbered="true" toc="default">
        <name>Capability Advertisement</name>
        <t>
   During PCEP Initialization Phase, PCEP speakers (PCE or PCC)
   advertise their support of Automatic Bandwidth adjustment feature.  A
   PCEP speaker includes the AUTO-BANDWIDTH-CAPABILITY TLV, in the OPEN
   Object to advertise its support for PCEP Auto-Bandwidth extensions.
   The presence of the AUTO-BANDWIDTH-CAPABILITY TLV in the OPEN Object
   indicates that the Automatic Bandwidth feature is supported as
   described in this document.</t>
        <ul spacing="normal">
          <li>The PCEP protocol extensions for Auto-Bandwidth adjustments MUST
      NOT be used if one or both PCEP speakers have not included the
      AUTO-BANDWIDTH-CAPABILITY TLV in their respective OPEN message.</li>
          <li>A PCEP speaker that does not recognize the extensions defined in
      this document would simply ignore the TLVs as per <xref target="RFC5440" format="default"/>.</li>
          <li>If a PCEP speaker that supports the extensions defined in this
      document but did not advertise this capability, then upon receipt
      of AUTO-BANDWIDTH-ATTRIBUTES TLV in the LSP Attributes (LSPA)
      object, it SHOULD generate a PCErr with error-type 19 (Invalid
      Operation), error-value TBD4 (Auto-Bandwidth capability was not
      advertised) and ignore the AUTO-BANDWIDTH-ATTRIBUTES TLV.</li>
        </ul>
        <section anchor="sect-5.1.1" numbered="true" toc="default">
          <name>AUTO-BANDWIDTH-CAPABILITY TLV</name>
          <t>
   The AUTO-BANDWIDTH-CAPABILITY TLV is an optional TLV for use in the
   OPEN Object for Automatic Bandwidth Adjustment via PCEP capability
   advertisement.  Its format is shown in the following figure:</t>
          <artwork name="" type="" align="left" alt=""><![CDATA[
 0                   1                   2                   3
 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|               Type=TBD2       |            Length=4           |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                             Flags                             |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

                 AUTO-BANDWIDTH-CAPABILITY TLV format
]]></artwork>
          <t>   
   The Type of the TLV is (TBD2) and it has a fixed Length of 4 octets.</t>
          <t>
   The value comprises a single field - Flags (32 bits).  No flags are
   defined for this TLV in this document.</t>
          <t>
   Unassigned bits are considered reserved.  They MUST be set to 0 on
   transmission and MUST be ignored on receipt.</t>
          <t>
   Advertisement of the AUTO-BANDWIDTH-CAPABILITY TLV implies support of
   auto-bandwidth adjustment, as well as the objects, TLVs and
   procedures defined in this document.</t>
        </section>
      </section>
      <section anchor="sect-5.2" numbered="true" toc="default">
        <name>AUTO-BANDWIDTH-ATTRIBUTES TLV</name>
        <t>
   The AUTO-BANDWIDTH-ATTRIBUTES TLV provides the 'configurable knobs'
   of the feature and it can be included as an optional TLV in the LSPA
   Object (as described in <xref target="RFC5440" format="default"/>).</t>
        <t>
   For PCE-Initiated LSP <xref target="RFC8281" format="default"/>, this TLV is included in the LSPA
   Object with the PCInitiate message.  For the PCC-Initiated delegated
   LSPs, this TLV is carried in the PCRpt message in LSPA Object.  This
   TLV is also carried in the LSPA object with the PCUpd message to
   direct the PCC (LSP head-end) to make updates to auto-bandwidth
   attributes such as Adjustment-Interval.</t>
        <t>
   The TLV is encoded in all PCEP messages for the LSP while the
   auto-bandwidth adjustment feature is enabled, the absence of the TLV
   indicates the PCEP speaker wishes to disable the feature.  This TLV
   includes multiple AUTO-BANDWIDTH-ATTRIBUTES sub-TLVs.  The
   AUTO-BANDWIDTH-ATTRIBUTES sub-TLVs are included if there is a change since
   the last information sent in the PCEP message.  The default values for
   missing sub-TLVs apply for the first PCEP message for the LSP.</t>
        <t>
   The format of the AUTO-BANDWIDTH-ATTRIBUTES TLV is shown in the
   following figure:</t>
        <artwork name="" type="" align="left" alt=""><![CDATA[
 0                   1                   2                   3
 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|           Type=TBD1           |           Length              |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                                                               |
//                            sub-TLVs                          //
|                                                               |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

                 AUTO-BANDWIDTH-ATTRIBUTES TLV format
]]></artwork>
        <dl newline="false" spacing="normal" indent="3">
          <dt>Type:</dt>
          <dd>TBD1</dd>
          <dt>Length:</dt>
          <dd> The Length field defines the length of the value
   portion in octets as per <xref target="RFC5440" format="default"/>.</dd>
          <dt>Value:</dt>
          <dd> This comprises one or more sub-TLVs.</dd>
        </dl>
        <t>
   Following sub-TLVs are defined in this document:</t>
        <artwork name="" type="" align="left" alt=""><![CDATA[
Type Len Name
-------------------------------------------------------------------
 1   4   Sample-Interval sub-TLV
 2   4   Adjustment-Interval sub-TLV
 3   4   Down-Adjustment-Interval sub-TLV
 4   4   Adjustment-Threshold sub-TLV
 5   8   Adjustment-Threshold-Percentage sub-TLV
 6   4   Down-Adjustment-Threshold sub-TLV
 7   8   Down-Adjustment-Threshold-Percentage sub-TLV
 8   4   Minimum-Bandwidth sub-TLV
 9   4   Maximum-Bandwidth sub-TLV
10   8   Overflow-Threshold sub-TLV
11   8   Overflow-Threshold-Percentage sub-TLV
12   8   Underflow-Threshold sub-TLV
13   8   Underflow-Threshold-Percentage sub-TLV
]]></artwork>
        <t>
   Future specifications can define additional sub-TLVs.</t>
        <t>
   The sub-TLVs are encoded to inform the PCEP peer of the various
   sampling and adjustment parameters.  In case of a missing sub-TLV, as
   per the local policy, either the default value (as specified in this
   document) or some other operator configured value is used.</t>
        <t>
   All sub-TLVs are optional and any unrecognized sub-TLV MUST be
   ignored.  If a sub-TLV of the same type appears more than once, only
   the first occurrence is processed and all others MUST be ignored.</t>
        <t>
   The following sub-sections describe the sub-TLVs which are currently
   defined to be carried within the AUTO-BANDWIDTH-ATTRIBUTES TLV.</t>
        <section anchor="sect-5.2.1" numbered="true" toc="default">
          <name>Sample-Interval sub-TLV</name>
          <t>
   The Sample-Interval sub-TLV specifies a time interval in seconds at
   which traffic samples are collected at the PCC.</t>
          <artwork name="" type="" align="left" alt=""><![CDATA[
 0                   1                   2                   3
 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|           Type=1              |           Length=4            |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                         Sample-Interval                       |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

                   Sample-Interval sub-TLV format
]]></artwork>
          <t>
      The Type is 1, Length is 4 octets, and the value comprises of - </t>
          <dl newline="false" spacing="normal" indent="3">
            <dt>Sample-Interval:</dt>
            <dd> The 4-octet time interval for
	bandwidth sample collection.  The valid range is from 1 to 604800 (7
	days), in seconds.  The default value is 300 seconds.  Due care needs
	to be taken in case of a very low Sample-Interval, as it can have some
	undesirable interactions with transport protocols (see <xref target="sect-6.6" format="default"/>). The sample-interval parameter MUST NOT be
	greater than the (down) adjustment-interval. In case of an invalid
	value, the Sub-TLV MUST be ignored and the previous value is
	maintained.</dd>
          </dl>
        </section>
        <section anchor="sect-5.2.2" numbered="true" toc="default">
          <name>Adjustment Intervals</name>
          <t> The
	sub-TLVs in this section are encoded to inform the PCEP peer the
	adjustment interval parameters.  The Adjustment-Interval sub-TLV
	specifies the time interval for both upward (Up-Adjustment-Interval)
	and downward (Down-Adjustment-Interval) trends. An implementation MAY
	require to set a different adjustment interval values for when the
	bandwidth usage trend is downwards from when it is moving upwards. In
	that case, the operator could use the Down-Adjustment-Interval sub-TLV
	which overrides the Adjustment-Interval value for
	Down-Adjustment-Interval.</t>
          <section anchor="sect-5.2.2.1" numbered="true" toc="default">
            <name>Adjustment-Interval sub-TLV</name>
            <t>
	The Adjustment-Interval sub-TLV specifies a time interval in seconds
	at which bandwidth adjustment should be made in upward or downward
	direction. This sub-TLV specify the value for Up-Adjustment-Interval
	and Down-Adjustment-Interval when they are the same and the
	Down-Adjustment-Interval sub-TLV is not included.</t>
            <artwork name="" type="" align="left" alt=""><![CDATA[
 0                   1                   2                   3
 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|           Type=2              |           Length=4            |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                     Adjustment-Interval                       |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

                 Adjustment-Interval sub-TLV format
]]></artwork>
            <t>The Type is 2, Length is 4 octets, and the value comprises of - </t>
            <dl newline="false" spacing="normal" indent="3">
              <dt>Adjustment-Interval:</dt>
              <dd> The 4-octet time interval for
      bandwidth adjustments.  The valid range is from 1 to 604800 (7 days), in
      seconds.  The default value is 86400 seconds (1 day).  The
      adjustment-interval parameter MUST NOT be less than the sample-interval,
      otherwise the Sub-TLV MUST be ignored and the previous value is
      maintained.</dd>
            </dl>
          </section>
          <section anchor="sect-5.2.2.2" numbered="true" toc="default">
            <name>Down-Adjustment-Interval sub-TLV</name>
            <t>
   The Down-Adjustment-Interval sub-TLV specifies a time interval in
   seconds at which bandwidth adjustment should be made when MaxAvgBw is
   less than the current bandwidth reservation of the LSP.  This
   parameter overrides the Adjustment-Interval for the downward trend.
   This sub-TLV is used only when there is a need for different
   adjustment intervals in the upward and downward directions.</t>
            <artwork name="" type="" align="left" alt=""><![CDATA[
 0                   1                   2                   3
 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|           Type=3              |           Length=4            |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                  Down-Adjustment-Interval                     |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

               Down-Adjustment-Interval sub-TLV format
]]></artwork>
            <t>The Type is 3, Length is 4 octets, and the value comprises of - </t>
            <dl newline="false" spacing="normal" indent="3">
              <dt>Down-Adjustment-Interval:</dt>
              <dd> The 4-octet time
	interval for downward bandwidth adjustments. The valid range is from
	1 to 604800 (7 days), in seconds.  The default value equals the
	adjustment-interval.  The down-adjustment-interval parameter MUST NOT
	be less than the sample-interval, otherwise the Sub-TLV MUST be
	ignored and the previous value is maintained.</dd>
            </dl>
          </section>
        </section>
        <section anchor="sect-5.2.3" numbered="true" toc="default">
          <name>Adjustment Thresholds</name>
          <t> The
	sub-TLVs in this section are encoded to inform the PCEP peer of the
	adjustment threshold parameters.  An implementation MAY include both
	sub-TLVs for the absolute value and the percentage, in which case the
	bandwidth is adjusted when either of the adjustment threshold
	conditions are met.  The Adjustment-Threshold sub-TLV specifies the
	threshold for both upward (Up-Adjustment-Threshold) and downward
	(Down-Adjustment-Threshold) trend.  If the operator would like to use
	a different adjustment threshold during the downward trend, the
	Down-Adjustment-Threshold sub-TLV is included.  Similarly, the
	Adjustment-Threshold-Percentage sub-TLV specifies the threshold
	percentage for both upward and downward trend.  If the operator would
	like to use a different adjustment threshold percentage during the
	downward trend, the Down-Adjustment-Threshold-Percentage sub-TLV is
	included.  It is worth noting that regardless of how the threshold are
	set, the adjustment will not be made until at least one
	sample-interval simply because no sample will be made on which to base
	a comparison with a threshold.</t>
          <section anchor="sect-5.2.3.1" numbered="true" toc="default">
            <name>Adjustment-Threshold sub-TLV</name>
            <t> The Adjustment-Threshold sub-TLV is used to
	decide when the LSP bandwidth should be adjusted in upward or downward
	direction. This sub-TLV specify the absolute value for
	Up-Adjustment-Threshold and Down-Adjustment-Threshold when they are
	the same and the Down-Adjustment-Threshold sub-TLV is not
	included.</t>
            <artwork name="" type="" align="left" alt=""><![CDATA[
 0                   1                   2                   3
 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|           Type=4              |           Length=4            |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                     Adjustment-Threshold                      |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

                 Adjustment-Threshold sub-TLV format
]]></artwork>
            <t> The Type is 4, Length is 4 octets, and the value comprises of - </t>
            <dl newline="false" spacing="normal" indent="3">
              <dt>Adjustment-Threshold:</dt>
              <dd> The absolute Adjustment-Threshold
      bandwidth difference value, encoded in IEEE floating point format (see
      [<xref target="IEEE.754.1985" format="default"/>]), expressed in bytes per second.  The
      default adjustment-threshold value is not set.  Refer to Section 3.1.2
      of <xref target="RFC3471" format="default"/> for a table of commonly used values.</dd>
            </dl>
            <t>
   If the modulus of difference between the current MaxAvgBw and the
   current bandwidth reservation is greater than or equal to the
   threshold value, the LSP bandwidth is adjusted to the current
   bandwidth demand (MaxAvgBw).</t>
            <t>
   In case of an invalid value, the Sub-TLV MUST be ignored and the
   previous value is maintained.</t>
          </section>
          <section anchor="sect-5.2.3.2" numbered="true" toc="default">
            <name>Adjustment-Threshold-Percentage sub-TLV</name>
            <t> The Adjustment-Threshold-Percentage sub-TLV
	is used to decide when the LSP bandwidth should be adjusted in upward
	or downward direction.  This sub-TLV specify the percentage value for
	Up-Adjustment-Threshold and Down-Adjustment-Threshold when they are
	the same and the Down-Adjustment-Threshold-Percentage sub-TLV is not
	included.</t>
            <artwork name="" type="" align="left" alt=""><![CDATA[
 0                   1                   2                   3
 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|           Type=5              |           Length=8            |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                  Reserved                       |  Percentage |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                        Minimum-Threshold                      |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

          Adjustment-Threshold-Percentage sub-TLV format
]]></artwork>
            <t>The Type is 5, Length is 8 octets, and the value comprises of - </t>
            <dl newline="false" spacing="normal" indent="3">
              <dt>Reserved:</dt>
              <dd> MUST be set to zero on transmission and MUST be
      ignored on receipt.</dd>
              <dt>Percentage:</dt>
              <dd> The Adjustment-Threshold value (7 bits),
      encoded in percentage (an integer from 1 to 100).  The value 0 is
      considered to be invalid.  The default value is 5 percent.</dd>
              <dt>Minimum-Threshold:</dt>
              <dd> The absolute Minimum-Threshold
      bandwidth value, encoded in IEEE floating point format (see [<xref target="IEEE.754.1985" format="default"/>]), expressed in bytes per second.  The increase
      or decrease of the LSP bandwidth MUST be at least or above the
      minimum-threshold before the bandwidth adjustment is made.  The default
      value is 0.</dd>
            </dl>
            <t>
   If the percentage absolute difference between the current MaxAvgBw
   and the current bandwidth reservation is greater than or equal to the
   threshold percentage, and the difference in the bandwidth is at least
   or above the Minimum-Threshold, the LSP bandwidth is adjusted to the
   current bandwidth demand (MaxAvgBw).</t>
            <t>
   In case of an invalid value, the Sub-TLV MUST be ignored and the
   previous value is maintained.</t>
          </section>
          <section anchor="sect-5.2.3.3" numbered="true" toc="default">
            <name>Down-Adjustment-Threshold sub-TLV</name>
            <t> The Down-Adjustment-Threshold sub-TLV is
	used to decide when the LSP bandwidth should be adjusted when MaxAvgBw
	is lesser than the current bandwidth reservation.  This parameter
	overrides the Adjustment-Threshold for the downward trend. This
	sub-TLV is used only when there is a need for different threshold in
	the upward and downward directions.</t>
            <artwork name="" type="" align="left" alt=""><![CDATA[
 0                   1                   2                   3
 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|           Type=6              |           Length=4            |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                    Down-Adjustment-Threshold                  |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

             Down-Adjustment-Threshold sub-TLV format
]]></artwork>
            <t>The Type is 6, Length is 4 octets, and the value comprises of - </t>
            <dl newline="false" spacing="normal" indent="3">
              <dt>Down-Adjustment-Threshold:</dt>
              <dd> The absolute
      Down-Adjustment-Threshold bandwidth value, encoded in IEEE floating
      point format (see [<xref target="IEEE.754.1985" format="default"/>]), expressed in bytes
      per second.  The default value equals the adjustment-threshold.  Refer
      to Section 3.1.2 of <xref target="RFC3471" format="default"/> for a table of commonly
      used values.
	</dd>
            </dl>
            <t>
   If the difference between current bandwidth reservation and the
   current MaxAvgBw is greater than or equal to the threshold value, the
   LSP bandwidth is adjusted to the current bandwidth demand (MaxAvgBw).</t>
            <t>
   In case of an invalid value, the Sub-TLV MUST be ignored and the
   previous value is maintained.</t>
          </section>
          <section anchor="sect-5.2.3.4" numbered="true" toc="default">
            <name>Down-Adjustment-Threshold-Percentage sub-TLV</name>
            <t>
   The Down-Adjustment-Threshold-Percentage sub-TLV is used to decide
   when the LSP bandwidth should be adjusted when MaxAvgBw is lesser
   than the current bandwidth reservation.  This parameter overrides the
   Adjustment-Threshold-Percentage for the downward trend. This sub-TLV
   is used only when there is a need for different threshold percentage
   in the upward and downward directions.</t>
            <artwork name="" type="" align="left" alt=""><![CDATA[
 0                   1                   2                   3
 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|           Type=7              |           Length=8            |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                  Reserved                       |  Percentage |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                        Minimum-Threshold                      |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

         Down-Adjustment-Threshold-Percentage sub-TLV format
]]></artwork>
            <t>The Type is 7, Length is 8 octets, and the value comprises of -</t>
            <dl newline="false" spacing="normal" indent="3">
              <dt>Reserved:</dt>
              <dd> MUST be set to zero on transmission and MUST
      be ignored on receipt.</dd>
              <dt>Percentage:</dt>
              <dd> The Down-Adjustment-Threshold value (7 bits),
      encoded in percentage (an integer from 1 to 100).  The value 0 is
      considered to be invalid.  The default value equals the
      adjustment-threshold-percentage.</dd>
              <dt>Minimum-Threshold:</dt>
              <dd> The absolute Minimum-Threshold
      bandwidth value, encoded in IEEE floating point format (see [<xref target="IEEE.754.1985" format="default"/>]), expressed in bytes per second.  The decrease
      of the LSP bandwidth MUST be at least or above the minimum-threshold
      before the bandwidth adjustment is made.  The default value equals the
      minimum-threshold for the adjustment-threshold-percentage.</dd>
            </dl>
            <t>
   If the percentage difference between the current bandwidth
   reservation and the current MaxAvgBw is greater than or equal to the
   threshold percentage, and the difference in the bandwidth is at least
   or above the Minimum-Threshold, the LSP bandwidth is adjusted to the
   current bandwidth demand (MaxAvgBw).</t>
            <t>
   In case of an invalid value, the Sub-TLV MUST be ignored and the
   previous value is maintained.</t>
          </section>
        </section>
        <section anchor="sect-5.2.4" numbered="true" toc="default">
          <name>Minimum and Maximum Bandwidth Values</name>
          <section anchor="sect-5.2.4.1" numbered="true" toc="default">
            <name>Minimum-Bandwidth sub-TLV</name>
            <t>
   The Minimum-Bandwidth sub-TLV specify the minimum bandwidth allowed
   for the LSP, and is expressed in bytes per second.  The LSP bandwidth
   cannot be adjusted below the minimum bandwidth value.</t>
            <artwork name="" type="" align="left" alt=""><![CDATA[
 0                   1                   2                   3
 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|           Type=8              |           Length=4            |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                        Minimum-Bandwidth                      |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

                 Minimum-Bandwidth sub-TLV format
]]></artwork>
            <t>The Type is 8, Length is 4 octets, and the value comprises of - </t>
            <dl newline="false" spacing="normal" indent="3">
              <dt>Minimum-Bandwidth:</dt>
              <dd> The 4-octet bandwidth value encoded in
    IEEE floating point format (see [<xref target="IEEE.754.1985" format="default"/>]),
    expressed in bytes per second.  The default minimum-bandwidth value is set
    to 0.  Refer to Section 3.1.2 of <xref target="RFC3471" format="default"/> for a table of
    commonly used values.</dd>
            </dl>
            <t>
   In case of an invalid value, the Sub-TLV MUST be ignored and the
   previous value is maintained.</t>
          </section>
          <section anchor="sect-5.2.4.2" numbered="true" toc="default">
            <name>Maximum-Bandwidth sub-TLV</name>
            <t>
   The Maximum-Bandwidth sub-TLV specify the maximum bandwidth allowed
   for the LSP, and is expressed in bytes per second.  The LSP bandwidth
   cannot be adjusted above the maximum bandwidth value.</t>
            <artwork name="" type="" align="left" alt=""><![CDATA[
 0                   1                   2                   3
 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|           Type=9              |           Length=4            |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                        Maximum-Bandwidth                      |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

                 Maximum-Bandwidth sub-TLV format
]]></artwork>
            <t>The Type is 9, Length is 4 octets, and the value comprises of - </t>
            <dl newline="false" spacing="normal" indent="3">
              <dt>Maximum-Bandwidth:</dt>
              <dd> The 4-octet bandwidth value encoded in
      IEEE floating point format (see [<xref target="IEEE.754.1985" format="default"/>]),
      expressed in bytes per second.  The default maximum-bandwidth value is
      not set.  Refer to Section 3.1.2 of <xref target="RFC3471" format="default"/> for a table
      of commonly used values.</dd>
            </dl>
            <t>
   In case of an invalid value, the Sub-TLV MUST be ignored and the
   previous value is maintained.</t>
          </section>
        </section>
        <section anchor="sect-5.2.5" numbered="true" toc="default">
          <name>Overflow and Underflow Conditions</name>
          <t>
   The sub-TLVs in this section are encoded to inform the PCEP peer the
   overflow and underflow threshold parameters.  An implementation MAY
   include sub-TLVs for an absolute value and/or a percentage for the
   threshold, in which case the bandwidth is immediately adjusted when
   either of the threshold conditions is met consecutively for the given
   count (as long as the difference in the bandwidth is at least or
   above the Minimum-Threshold).  By default, the threshold values for
   overflow and underflow conditions are not set.</t>
          <section anchor="sect-5.2.5.1" numbered="true" toc="default">
            <name>Overflow-Threshold sub-TLV</name>
            <t>
   The Overflow-Threshold sub-TLV is used to decide if the LSP bandwidth
   should be adjusted immediately.</t>
            <artwork name="" type="" align="left" alt=""><![CDATA[
 0                   1                   2                   3
 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|           Type=10             |           Length=8            |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                       Reserved                      |  Count  |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                       Overflow-Threshold                      |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

                Overflow-Threshold sub-TLV format
]]></artwork>
            <t>The Type is 10, Length is 8 octets, and the value comprises of - </t>
            <dl newline="false" spacing="normal" indent="3">
              <dt>Reserved:</dt>
              <dd> MUST be set to zero on transmission and MUST
       be ignored on receipt.</dd>
              <dt>Count:</dt>
              <dd> The Overflow-Count value (5 bits), encoded in
       integer.  The value 0 is considered to be invalid.  The number of
       consecutive samples for which the overflow condition MUST be met for
       the LSP bandwidth to be immediately adjusted to the current bandwidth
       demand, bypassing the (up) adjustment-interval.</dd>
              <dt>Overflow-Threshold:</dt>
              <dd> The absolute Overflow-Threshold
       bandwidth value, encoded in IEEE floating point format (see [<xref target="IEEE.754.1985" format="default"/>]), expressed in bytes per second.  Refer to
       Section 3.1.2 of <xref target="RFC3471" format="default"/> for a table of commonly used
       values.  If the difference of the current MaxAvgBw from the current
       bandwidth reservation is greater than or equal to the threshold value,
       the overflow condition is met.</dd>
            </dl>
            <t>
   In case of an invalid value, the Sub-TLV MUST be ignored and the
   previous value is maintained.</t>
          </section>
          <section anchor="sect-5.2.5.2" numbered="true" toc="default">
            <name>Overflow-Threshold-Percentage sub-TLV</name>
            <t>
   The Overflow-Threshold-Percentage sub-TLV is used to decide if the
   LSP bandwidth should be adjusted immediately.</t>
            <artwork name="" type="" align="left" alt=""><![CDATA[
 0                   1                   2                   3
 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|           Type=11             |           Length=8            |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|  Percentage |             Reserved                  |  Count  |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                        Minimum-Threshold                      |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

            Overflow-Threshold-Percentage sub-TLV format
]]></artwork>
            <t>The Type is 11, Length is 8 octets, and the value comprises of -</t>
            <dl newline="false" spacing="normal" indent="3">
              <dt>Percentage:</dt>
              <dd> The Overflow-Threshold value (7 bits), encoded
     in percentage (an integer from 1 to 100).  The value 0 is considered to
     be invalid.  If the percentage increase of the current MaxAvgBw from the
     current bandwidth reservation is greater than or equal to the threshold
     percentage, the overflow condition is met.</dd>
              <dt>Reserved:</dt>
              <dd> MUST be set to zero on transmission and MUST be
     ignored on receipt.</dd>
              <dt>Count:</dt>
              <dd> The Overflow-Count value (5 bits), encoded in
     integer.  The value 0 is considered to be invalid.  The number of
     consecutive samples for which the overflow condition MUST be met for the
     LSP bandwidth to be immediately adjusted to the current bandwidth demand,
     bypassing the (up) adjustment-interval.</dd>
              <dt>Minimum-Threshold:</dt>
              <dd> The absolute Minimum-Threshold
     bandwidth value, encoded in IEEE floating point format (see [<xref target="IEEE.754.1985" format="default"/>]), expressed in bytes per second.  The increase
     of the LSP bandwidth MUST be at least or above the minimum-threshold
     before the bandwidth adjustment is made.</dd>
            </dl>
            <t>
   In case of an invalid value, the Sub-TLV MUST be ignored and the
   previous value is maintained.</t>
          </section>
          <section anchor="sect-5.2.5.3" numbered="true" toc="default">
            <name>Underflow-Threshold sub-TLV</name>
            <t>
   The Underflow-Threshold sub-TLV is used to decide if the LSP
   bandwidth should be adjusted immediately.</t>
            <artwork name="" type="" align="left" alt=""><![CDATA[
 0                   1                   2                   3
 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|           Type=12             |           Length=8            |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                      Reserved                       |  Count  |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                      Underflow-Threshold                      |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

                 Underflow-Threshold sub-TLV format

]]></artwork>
            <t>The Type is 12, Length is 8 octets, and the value comprises of - </t>
            <dl newline="false" spacing="normal" indent="3">
              <dt>Reserved:</dt>
              <dd> MUST be set to zero on transmission and MUST be
      ignored on receipt.</dd>
              <dt>Count:</dt>
              <dd> The Underflow-Count value (5 bits), encoded in integer.
      The value 0 is considered to be invalid.  The number of
      consecutive samples for which the underflow condition MUST be met
      for the LSP bandwidth to be immediately adjusted to the current
      bandwidth demand, bypassing the down-adjustment-interval.</dd>
              <dt>Underflow-Threshold:</dt>
              <dd> The absolute Underflow-Threshold
      bandwidth value, encoded in IEEE floating point format (see [<xref target="IEEE.754.1985" format="default"/>]), expressed in bytes per second.  Refer to
      Section 3.1.2 of <xref target="RFC3471" format="default"/> for a table of commonly used
      values.  If the difference of the current MaxAvgBw from the current
      bandwidth reservation is greater than or equal to the threshold value,
      the underflow condition is met.</dd>
            </dl>
            <t>
   In case of an invalid value, the Sub-TLV MUST be ignored and the
   previous value is maintained.</t>
          </section>
          <section anchor="sect-5.2.5.4" numbered="true" toc="default">
            <name>Underflow-Threshold-Percentage sub-TLV</name>
            <t>
   The Underflow-Threshold-Percentage sub-TLV is used to decide if the
   LSP bandwidth should be adjusted immediately.</t>
            <artwork name="" type="" align="left" alt=""><![CDATA[
 0                   1                   2                   3
 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|           Type=13             |           Length=8            |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|  Percentage |             Reserved                  |  Count  |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|                        Minimum-Threshold                      |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

            Underflow-Threshold-Percentage sub-TLV format
]]></artwork>
            <t>The Type is 13, Length is 8 octets, and the value comprises of -</t>
            <dl newline="false" spacing="normal" indent="3">
              <dt>Percentage:</dt>
              <dd> The Underflow-Threshold value (7 bits),
      encoded in percentage (an integer from 1 to 100).  The value 0 is
      considered to be invalid.  If the percentage decrease of the current
      MaxAvgBw from the current bandwidth reservation is greater than or equal
      to the threshold percentage, the underflow condition is met.</dd>
              <dt>Reserved:</dt>
              <dd> MUST be set to zero on transmission and MUST be
      ignored on receipt.</dd>
              <dt>Count:</dt>
              <dd> The Underflow-Count value (5 bits), encoded in
      integer.  The value 0 is considered to be invalid.  The number of
      consecutive samples for which the underflow condition MUST be met for
      the LSP bandwidth to be immediately adjusted to the current bandwidth
      demand, bypassing the down-adjustment-interval.</dd>
              <dt>Minimum-Threshold:</dt>
              <dd> The absolute Minimum-Threshold
      bandwidth value, encoded in IEEE floating point format (see [<xref target="IEEE.754.1985" format="default"/>]), expressed in bytes per second.  The decrease
      of the LSP bandwidth MUST be at least or above the minimum-threshold
      before the bandwidth adjustment is made.</dd>
            </dl>
            <t>
   In case of an invalid value, the Sub-TLV MUST be ignored and the
   previous value is maintained.</t>
          </section>
        </section>
      </section>
      <section anchor="sect-5.3" numbered="true" toc="default">
        <name>BANDWIDTH Object</name>
        <t>
   As per <xref target="RFC5440" format="default"/>, the BANDWIDTH object (Object-Class value 5) is
   defined with two Object-Type values as following:</t>
        <dl newline="false" spacing="normal" indent="3">
          <dt>Requested Bandwidth:</dt>
          <dd> BANDWIDTH Object-Type value is
      1.</dd>
          <dt>Re-optimization Bandwidth:</dt>
          <dd> Bandwidth of an existing TE
      LSP for which a re-optimization is requested.  BANDWIDTH Object-Type
      value is 2.</dd>
        </dl>
        <t>
   The PCC reports the calculated bandwidth to be adjusted (MaxAvgBw) to
   the Stateful PCE using the existing 'Requested Bandwidth' with
   BANDWIDTH Object-Type as 1.  The reporting of the 're-optimization
   bandwidth' with BANDWIDTH Object-Type as 2 is not required as the
   Stateful PCE is aware of the existing LSP bandwidth.</t>
      </section>
      <section anchor="sect-5.4" numbered="true" toc="default">
        <name>The PCInitiate Message</name>
        <t>
   A PCInitiate message is a PCEP message sent by a PCE to a PCC to
   trigger LSP instantiation or deletion <xref target="RFC8281" format="default"/>.</t>
        <t>
   For the PCE-Initiated LSP with Auto-Bandwidth feature enabled,
   AUTO-BANDWIDTH-ATTRIBUTES TLV MUST be included in the LSPA object with the
   PCInitiate message.</t>
        <t>
   The Routing Backus-Naur Format (RBNF) definition of the PCInitiate
   message <xref target="RFC8281" format="default"/> is unchanged by this document.</t>
      </section>
      <section anchor="sect-5.5" numbered="true" toc="default">
        <name>The PCUpd Message</name>
        <t>
   A PCUpd message is a PCEP message sent by a PCE to a PCC to update
   the LSP parameters <xref target="RFC8231" format="default"/>.</t>
        <t>
   For PCE-Initiated LSPs with Auto-Bandwidth feature enabled,
   AUTO-BANDWIDTH-ATTRIBUTES TLV MUST be included in the LSPA object with the
   PCUpd message.  The PCE can send this TLV to direct the PCC to change the
   auto-bandwidth parameters.</t>
        <t>
   The RBNF definition of the PCUpd message <xref target="RFC8231" format="default"/> is unchanged by
   this document.</t>
      </section>
      <section anchor="sect-5.6" numbered="true" toc="default">
        <name>The PCRpt Message</name>
        <t>
   The PCRpt message <xref target="RFC8231" format="default"/> is a PCEP message sent by a PCC to a PCE
   to report the status of one or more LSPs.</t>
        <t>
   For PCE-Initiated LSPs <xref target="RFC8281" format="default"/>, the PCC creates the LSP using the
   attributes communicated by the PCE, and using the local values for
   the unspecified parameters.  After the successful instantiation of
   the LSP, PCC automatically delegates the LSP to the PCE and generates
   a PCRpt message to provide the status report for the LSP.</t>
        <t>
   For both PCE-Initiated and PCC-Initiated LSPs, when the LSP is
   delegated to a PCE for the very first time as well as after the
   successful delegation, the BANDWIDTH object of type 1 is used to
   specify the requested bandwidth in the PCRpt message.</t>
        <t>
   The RBNF definition of the PCRpt message <xref target="RFC8231" format="default"/> is unchanged by
   this document.</t>
      </section>
      <section anchor="sect-5.7" numbered="true" toc="default">
        <name>The PCNtf Message</name>
        <t>
   As per <xref target="RFC5440" format="default"/>, the PCEP Notification message (PCNtf) can be sent
   by a PCEP speaker to notify its peer of a specific event.</t>
        <t>
   A PCEP speaker (PCE or PCC) SHOULD notify its PCEP peer (PCC or PCE)
   when it is in overwhelmed state due to the auto-bandwidth feature.
   An implementation needs to make an attempt to send this notification
   (when overwhelmed by auto-bandwidth adjustments) unless sending this
   notification would only serve to increase the load further. Note that
   when the notification is not received the PCEP speaker would continue
   to request bandwidth adjustments even when they could not be handled
   in a timely fashion.</t>
        <t>
   Upon receipt of auto-bandwidth overwhelm notification, the peer
   SHOULD NOT send any PCEP messages related to auto-bandwidth
   adjustment.  If a PCEP message related to auto-bandwidth adjustment
   is received during in overwhelmed state, it MUST be ignored.</t>
        <ul spacing="normal">
          <li>When a PCEP speaker is overwhelmed, it
	SHOULD notify its peer by sending a PCNtf message with
	Notification-Type = TBD3 (Auto-bandwidth Overwhelm State) and
	Notification-Value = 1 (Entering auto-bandwidth overwhelm state).
	Optionally, OVERLOADED-DURATION TLV <xref target="RFC5440" format="default"/> MAY be
	included that specifies the time period during which no further PCEP
	messages related to auto-bandwidth adjustment should be sent.</li>
          <li>When the PCEP speaker is no longer in the overwhelm state and is
      available to process the auto-bandwidth adjustments, it SHOULD
      notify its peers by sending a PCNtf message with Notification Type
      = TBD3 (Auto-bandwidth Overwhelm State) and Notification Value = 2
      (Clearing auto-bandwidth overwhelm state). A PCEP speaker SHOULD
      send such notification to all peers to with a Notification message
      (Notification-Type=TBD3, Notification-Value=1) was sent earlier
      unless an OVERLOADED-DURATION TLV was included and the PCEP
      speakers wishes for the peer to wait for the expiration of that
      period of time before receiving further PCEP messages related to
      auto-bandwidth adjustment.</li>
        </ul>
        <t>
   When Auto-Bandwidth feature is deployed, a PCE can send this
   notification to PCC when a PCC is reporting frequent auto-bandwidth
   adjustments.  If a PCC is overwhelmed with re-signaling, it can also
   notify the PCE to not adjust the LSP bandwidth while in overwhelm
   state.</t>
        <t>
   Some dampening notification procedure (as per <xref target="RFC5440" format="default"/>) to avoid
   oscillations of the overwhelm state is RECOMMENDED. On receipt of an
   auto-bandwidth overwhelm notification from the PCE, a PCC should
   consider the impact on the entire network. Moving the delegations of
   auto-bandwidth enabled LSP to another PCE could cause further
   overloading.</t>
      </section>
    </section>
    <section anchor="sect-6" numbered="true" toc="default">
      <name>Manageability Considerations</name>
      <section anchor="sect-6.1" numbered="true" toc="default">
        <name>Control of Function and Policy</name>
        <t>
   The Auto-Bandwidth feature SHOULD be controlled per LSP (at PCC
   (head-end of the LSP) or PCE) and the values for auto-bandwidth
   parameters e.g. sample-interval, adjustment-interval (up/down),
   minimum-bandwidth, maximum-bandwidth, adjustment-threshold (up/down)
   SHOULD be configurable by an operator.</t>
        <t>
   The Maximum-Bandwidth (and Minimum-Bandwidth) should be set to
   acceptable limit to avoid impact on the rest of the MPLS-TE domain.</t>
        <t>
   The operator should make sure that the Overflow-Threshold is greater
   than or at least equal to the Up-Adjustment-Threshold. And similarly,
   make sure that the Underflow-Threshold is greater than or at least
   equal to the Down-Adjustment-Threshold.</t>
      </section>
      <section anchor="sect-6.2" numbered="true" toc="default">
        <name>Information and Data Models</name>
        <t>
   A MIB module for gathering operational information about PCEP is
   defined in <xref target="RFC7420" format="default"/>.  Additionally, the YANG module defined in
   <xref target="I-D.ietf-pce-pcep-yang" format="default"/> provides for both configuration of PCEP as
   well as operational management.  These could be enhanced to provide
   controls and indicators for support of auto-bandwidth feature.
   Support for various configuration knobs as well as counters of
   messages sent/received containing the TLVs defined in this document
   could be added.</t>
      </section>
      <section anchor="sect-6.3" numbered="true" toc="default">
        <name>Liveness Detection and Monitoring</name>
        <t>
   The mechanisms defined in this document do not imply any new liveness
   detection and monitoring requirements in addition to those already
   listed in <xref target="RFC5440" format="default"/>.</t>
      </section>
      <section anchor="sect-6.4" numbered="true" toc="default">
        <name>Verify Correct Operations</name>
        <t>
   The mechanisms defined in this document do not imply any new
   operation verification requirements in addition to those already
   listed in <xref target="RFC5440" format="default"/>.</t>
        <t>
   In case of an invalid value, the Sub-TLV would get ignored and the
   previous value would be maintained. In such case the implementation
   SHOULD log the event.</t>
      </section>
      <section anchor="sect-6.5" numbered="true" toc="default">
        <name>Requirements On Other Protocols</name>
        <t>
   The mechanisms defined in this document do not add any new
   requirements on other protocols.</t>
      </section>
      <section anchor="sect-6.6" numbered="true" toc="default">
        <name>Impact On Network Operations</name>
        <t>
   In order to avoid any unacceptable impact on network operations, an
   implementation SHOULD allow a limit to be placed on the number of
   LSPs that can be enabled with auto-bandwidth feature.  For each LSP
   enabled with auto-bandwidth feature there is an extra load on PCC, as
   it needs to monitor the traffic and report the calculated bandwidth
   to be adjusted to the PCE. The PCE further re-compute paths based on
   the requested bandwidth and update the path to the PCC, which in
   turns triggers the re-signaling of the path. All these steps adds
   extra load and churn in the network and thus operator needs to take
   due care while enabling this features on a number of LSPs.</t>
        <t>
   An implementation MAY allow a limit to be placed on the rate of
   auto-bandwidth related messages sent by a PCEP speaker and received by a
   peer.  An implementation SHOULD also allow sending a notification when a
   PCEP speaker is overwhelmed or the rate of messages reach a threshold.</t>
        <t>
   Due care is required by the operator if a Sample-Interval value
   significantly smaller than the default (5 minute) is used, as a small
   Sample-Interval values, e.g., 1 minute or less, could cause
   undesirable interactions with transport protocols. These undesirable
   interactions result from providing insufficient time for transport
   protocol reactions to a prior bandwidth adjustment to settle out
   before bandwidth samples are taken for the next bandwidth adjustment.</t>
      </section>
    </section>
    <section anchor="sect-7" numbered="true" toc="default">
      <name>Security Considerations</name>
      <t> This
	document defines AUTO-BANDWIDTH-CAPABILITY TLV and
	AUTO-BANDWIDTH-ATTRIBUTES sub-TLVs which do not add any substantial
	new security concerns beyond those already discussed in <xref target="RFC8231" format="default"/> and <xref target="RFC8281" format="default"/> for stateful PCE
	operations.  As per <xref target="RFC8231" format="default"/>, it is RECOMMENDED that
	these PCEP extensions only be activated on authenticated and encrypted
	sessions across PCEs and PCCs belonging to the same administrative
	authority, using Transport Layer Security (TLS) <xref target="RFC8253" format="default"/>, as per the recommendations and best current
	practices in BCP 195 <xref target="RFC7525" format="default"/> (unless explicitly set
	aside in <xref target="RFC8253" format="default"/>).</t>
      <t>
   Incorrect auto-bandwidth parameters in the AUTO-BANDWIDTH-ATTRIBUTES
   sub-TLVs could have an adverse effect on the LSP as well as on the
   network.</t>
    </section>
    <section anchor="sect-8" numbered="true" toc="default">
      <name>IANA Considerations</name>
      <section anchor="sect-8.1" numbered="true" toc="default">
        <name>PCEP TLV Type Indicators</name>
        <t>
   This document defines the following new PCEP TLVs; IANA is requested
   to make the following allocations from the "PCEP TLV Type Indicators"
   sub-registry of the PCEP Numbers registry, as follows:</t>
        <artwork name="" type="" align="left" alt=""><![CDATA[
Value   Name                                      Reference
-----------------------------------------------------------------
TBD2    AUTO-BANDWIDTH-CAPABILITY                 [This document]
TBD1    AUTO-BANDWIDTH-ATTRIBUTES                 [This document]
]]></artwork>
      </section>
      <section anchor="sect-8.2" numbered="true" toc="default">
        <name>AUTO-BANDWIDTH-CAPABILITY TLV Flag Field</name>
        <t>
   IANA is requested to create a sub-registry to manage the Flag field
   of the AUTO-BANDWIDTH-CAPABILITY TLV within the "Path Computation Element Protocol (PCEP) Numbers" registry.</t>
        <t>
   New bit numbers are to be assigned by Standards Action <xref target="RFC8126" format="default"/>.
   Each bit should be tracked with the following qualities:</t>
        <ul spacing="normal">
          <li>Bit number (counting from bit 0 as the most significant bit)</li>
          <li>Capability description</li>
          <li>Defining RFC</li>
        </ul>
        <t>
   The initial contents of the sub-registry are empty, with all bits
   marked unassigned</t>
      </section>
      <section anchor="sect-8.3" numbered="true" toc="default">
        <name>AUTO-BANDWIDTH-ATTRIBUTES Sub-TLV</name>
        <t>
   This document specifies the AUTO-BANDWIDTH-ATTRIBUTES Sub-TLVs.  IANA
   is requested to create an "AUTO-BANDWIDTH-ATTRIBUTES Sub-TLV Types"
   sub-registry within the "Path Computation Element Protocol (PCEP) Numbers" registry to manage the type indicator space for sub-TLVs of
   the AUTO-BANDWIDTH-ATTRIBUTES TLV.  The valid range of values in the
   registry is 0-65535.  IANA is requested to initialize the registry
   with the following values.  All other values in the registry should
   be marked as "Unassigned".</t>
        <t>
   IANA is requested to set the registration procedure for this registry
   to read as follows:</t>
        <artwork name="" type="" align="left" alt=""><![CDATA[

      0-65503 IETF Review

      65504-65535        Experimental Use

   This document defines the following types:


Type Name                                         Reference
-----------------------------------------------------------------
 0   Reserved                                     [This document]
 1   Sample-Interval sub-TLV                      [This document]
 2   Adjustment-Interval sub-TLV                  [This document]
 3   Down-Adjustment-Interval sub-TLV             [This document]
 4   Adjustment-Threshold sub-TLV                 [This document]
 5   Adjustment-Threshold-Percentage sub-TLV      [This document]
 6   Down-Adjustment-Threshold sub-TLV            [This document]
 7   Down-Adjustment-Threshold-Percentage sub-TLV [This document]
 8   Minimum-Bandwidth sub-TLV                    [This document]
 9   Maximum-Bandwidth sub-TLV                    [This document]
10   Overflow-Threshold sub-TLV                   [This document]
11   Overflow-Threshold-Percentage sub-TLV        [This document]
12   Underflow-Threshold sub-TLV                  [This document]
13   Underflow-Threshold-Percentage sub-TLV       [This document]
14-  Unassigned                                   [This document]
65503
]]></artwork>
      </section>
      <section anchor="sect-8.4" numbered="true" toc="default">
        <name>Error Object</name>
        <t> This document
	defines a new Error-Value for PCErr message of Error-Type 19 (Invalid
	Operation) <xref target="RFC8231" format="default"/>.  IANA is requested to allocate
	new error-value within the "PCEP-ERROR Object Error Types and Values"
	subregistry of the PCEP Numbers registry, as follows:</t>
        <artwork name="" type="" align="left" alt=""><![CDATA[
Error-Type  Meaning & error values                Reference
-----------------------------------------------------------------
19          Invalid Operations

            Error-Value = TBD4:                   [This document]
            Auto-Bandwidth Capability
            was not Advertised
]]></artwork>
      </section>
      <section anchor="sect-8.5" numbered="true" toc="default">
        <name>Notification Object</name>
        <t>
   IANA is requested to allocate new Notification Type and Notification
   Values within the "Notification Object" sub-registry of the PCEP
   Numbers registry, as follows:</t>
        <artwork name="" type="" align="left" alt=""><![CDATA[
Type        Meaning                               Reference
-----------------------------------------------------------------
TBD3        Auto-Bandwidth Overwhelm State        [This document]

            Notification-value=1:    Entering Auto-Bandwidth
                                     overwhelm state
            Notification-value=2:    Clearing Auto-Bandwidth
                                     overwhelm state
]]></artwork>
      </section>
    </section>
  </middle>
  <back>

<displayreference target="I-D.ietf-pce-pcep-yang" to="PCE-PCEP-YANG"/>

    <references>
      <name>References</name>
      <references>
        <name>Normative References</name>
        <xi:include href="https://xml2rfc.tools.ietf.org/public/rfc/bibxml/reference.RFC.2119.xml"/>
        <xi:include href="https://xml2rfc.tools.ietf.org/public/rfc/bibxml/reference.RFC.5440.xml"/>
        <xi:include href="https://xml2rfc.tools.ietf.org/public/rfc/bibxml/reference.RFC.7525.xml"/>
        <xi:include href="https://xml2rfc.tools.ietf.org/public/rfc/bibxml/reference.RFC.8126.xml"/>
        <xi:include href="https://xml2rfc.tools.ietf.org/public/rfc/bibxml/reference.RFC.8174.xml"/>
        <xi:include href="https://xml2rfc.tools.ietf.org/public/rfc/bibxml/reference.RFC.8231.xml"/>
        <xi:include href="https://xml2rfc.tools.ietf.org/public/rfc/bibxml/reference.RFC.8253.xml"/>
        <xi:include href="https://xml2rfc.tools.ietf.org/public/rfc/bibxml/reference.RFC.8281.xml"/>

<!-- [rfced] [IEEE.754.1985]  DOI: 10.1109/IEEESTD.1985.82928  URL https://ieeexplore.ieee.org/document/30711-->
        <reference anchor="IEEE.754.1985">
          <front>
            <title>Standard for Binary Floating-Point Arithmetic</title>
            <seriesInfo name="IEEE" value="Standard 754"/>
            <author>
              <organization>Institute of Electrical and Electronics Engineers</organization>
            </author>
            <date month="August" year="1985"/>
          </front>
        </reference>
      </references>
      <references>
        <name>Informative References</name>
        <xi:include href="https://xml2rfc.tools.ietf.org/public/rfc/bibxml/reference.RFC.3209.xml"/>
        <xi:include href="https://xml2rfc.tools.ietf.org/public/rfc/bibxml/reference.RFC.3471.xml"/>
        <xi:include href="https://xml2rfc.tools.ietf.org/public/rfc/bibxml/reference.RFC.7420.xml"/>
        <xi:include href="https://xml2rfc.tools.ietf.org/public/rfc/bibxml/reference.RFC.8051.xml"/>

<!-- reference.I-D.draft-ietf-pce-pcep-yang; I-D Exists -->

        <xi:include href="https://xml2rfc.tools.ietf.org/public/rfc/bibxml3/reference.I-D.draft-ietf-pce-pcep-yang-12.xml"/>

      </references>
    </references>
    <section numbered="false" anchor="acknowledgments" toc="default">
      <name>Acknowledgments</name>
      <t>
   Authors would like to thank Robert Varga, Venugopal Reddy, Reeja
   Paul, Sandeep Boina, Avantika, JP Vasseur, Himanshu Shah, Jonathan
   Hardwick and Adrian Farrel for their useful comments and suggestions.</t>
      <t>
   Thanks to Daniel Franke, Joe Clarke, David Black, and Erik Kline for
   the directorate reviews.</t>
      <t>
   Thanks to Mirja Kuhlewind, Barry Leiba, Benjamin Kaduk, and Roman
   Danyliw for the IESG review.</t>
    </section>
    <section numbered="false" anchor="contributors" toc="default">
      <name>Contributors</name>
      <artwork name="" type="" align="left" alt=""><![CDATA[
He Zekun
Tencent Holdings Ltd,
Shenzhen P.R.China

Email: kinghe@tencent.com

Xian Zhang
Huawei Technologies
Research Area F3-1B,
Huawei Industrial Base,
Shenzhen, 518129
China

Phone: +86-755-28972645
Email: zhang.xian@huawei.com

Young Lee
SKKU

Email: younglee.tx@gmail.com
]]></artwork>
    </section>
  </back>
</rfc>
