<?xml version='1.0' encoding='utf-8'?>
<!DOCTYPE rfc [
  <!ENTITY nbsp    "&#160;">
  <!ENTITY zwsp   "&#8203;">
  <!ENTITY nbhy   "&#8209;">
  <!ENTITY wj     "&#8288;">
]>
<?xml-stylesheet type="text/xsl" href="rfc2629.xslt" ?>
<!-- generated by https://github.com/cabo/kramdown-rfc version 1.7.17 (Ruby 3.3.1) -->
<rfc xmlns:xi="http://www.w3.org/2001/XInclude" ipr="trust200902" docName="draft-cwbgp-green-energy-saving-management-00" category="std" consensus="true" submissionType="IETF" tocInclude="true" sortRefs="true" symRefs="true" version="3">
  <!-- xml2rfc v2v3 conversion 3.21.0 -->
  <front>
    <title abbrev="Energy Saving Management">YANG Data Models for Energy Saving Management</title>
    <seriesInfo name="Internet-Draft" value="draft-cwbgp-green-energy-saving-management-00"/>
    <author fullname="Gen Chen">
      <organization>Huawei</organization>
      <address>
        <postal>
          <country>China</country>
        </postal>
        <email>chengen@huawei.com</email>
      </address>
    </author>
    <author fullname="Qin Wu" role="editor">
      <organization>Huawei</organization>
      <address>
        <postal>
          <country>China</country>
        </postal>
        <email>bill.wu@huawei.com</email>
      </address>
    </author>
    <author fullname="Mohamed Boucadair" role="editor">
      <organization>Orange</organization>
      <address>
        <postal>
          <country>France</country>
        </postal>
        <email>mohamed.boucadair@orange.com</email>
      </address>
    </author>
    <author fullname="Oscar Gonzales de Dios">
      <organization>Telefonica I+D</organization>
      <address>
        <postal>
          <country>Spain</country>
        </postal>
        <email>oscar.gonzalezdedios@telefonica.com</email>
      </address>
    </author>
    <author fullname="Carlos Pignataro">
      <organization>North Carolina State University</organization>
      <address>
        <postal>
          <country>United States of America</country>
        </postal>
        <email>cpignata@gmail.com, cmpignat@ncsu.edu</email>
      </address>
    </author>
    <date year="2024" month="June" day="25"/>
    <area>Operations and Management</area>
    <workgroup>Network Inventory YANG</workgroup>
    <keyword>energy efficiency</keyword>
    <keyword>energy saving</keyword>
    <keyword>energy management</keyword>
    <abstract>
      <?line 54?>

<t>This document defines YANG modules for energy saving management at both device and network levels. Also, the document specifies
   a common module that is used independent of the model layer.</t>
    </abstract>
    <note removeInRFC="true">
      <name>Discussion Venues</name>
      <t>Discussion of this document takes place on the
    Network Inventory YANG Working Group mailing list (inventory-yang@ietf.org),
    which is archived at <eref target="https://mailarchive.ietf.org/arch/browse/inventory-yang/"/>.</t>
      <t>Source for this draft and an issue tracker can be found at
    <eref target="https://github.com/boucadair/draft-cwbgp-energy-saving-management"/>.</t>
    </note>
  </front>
  <middle>
    <?line 59?>

<section anchor="introduction">
      <name>Introduction</name>
      <t>With the growth of networks and the increase of awareness about the
   environmental impact, it is important to ensure energy efficiency in
   the operation of network infrastructures.  Operators are thus seeking
   for more information to reflect the power consumption of a network
   and the contribution of involved nodes. As described in <xref section="3.4" sectionFormat="of" target="RFC6988"/>,
   monitoring energy, power can be required for purposes such as:</t>
      <ul spacing="normal">
        <li>
          <t>designing control loops for energy saving,</t>
        </li>
        <li>
          <t>investigating energy-saving potential,</t>
        </li>
        <li>
          <t>evaluating the effectiveness of energy-saving policies and  measures,</t>
        </li>
        <li>
          <t>accounting for the total power received and provided by an entity, a network, or a service,</t>
        </li>
        <li>
          <t>predicting an entity's reliability based on power usage, and</t>
        </li>
        <li>
          <t>planning for the next maintenance cycle for an entity</t>
        </li>
      </ul>
      <t>However, there are no standard mechanisms to report and control power
   usage or energy consumption of different networking equipment under
   different network configuration and conditions.  For example, in
   'tidal network' in which traffic volume undergoes significant
   fluctuations at different times, various energy management methods
   might be envisaged to optimize the energy efficiency at the network
   scale, e.g., by selectively disabling ports or cards on specific network
   nodes based on (forecast) traffic patterns.</t>
      <t>This document defines YANG modules for use in energy management within a newtork.
   The modules covers both network and device levels (<xref section="3.5.1" sectionFormat="of" target="I-D.ietf-netmod-rfc8407bis"/>).
   The modules can be used, e.g., for monitoring the energy
   consumption of network devices, such as (but are not limited to)
   routers, switches, security gateways, hosts, or servers.  Where
   applicable, device monitoring extends to the individual components of
   the device.</t>
      <t>The network model augments the "ietf-network" module <xref target="RFC8345"/>, while the inventory model augments
   the "ietf-network-inventory" module <xref target="I-D.ietf-ivy-network-inventory-yang"/> with the following rationale:</t>
      <ul spacing="normal">
        <li>
          <t>Parameters that reflect the saving modes and methods are considered
as capabilities, and are thus maintained in the inventory.</t>
        </li>
        <li>
          <t>Required parameters to control and adjust nodes and components behaviors
are added to the network topology as this allows operator to better assess
the implications on node-specific action on the overall network.</t>
        </li>
      </ul>
      <t>The document leverages types defined in <xref target="RFC3418"/> and <xref target="RFC6933"/>.</t>
      <section anchor="notes-to-the-rfc-editor">
        <name>Notes to the RFC Editor</name>
        <ul empty="true">
          <li>
            <t>Note to the RFC Editor: This section is to be removed prior to publication.</t>
          </li>
        </ul>
        <t>This document contains placeholder values that need to be replaced
   with finalized values at the time of publication.  This note
   summarizes all of the substitutions that are needed.</t>
        <t>Please apply the following replacements:</t>
        <ul spacing="normal">
          <li>
            <t>XXXX --&gt; the RFC number assigned to this I-D</t>
          </li>
          <li>
            <t>IIII --&gt; the RFC number assigned to <xref target="I-D.ietf-ivy-network-inventory-yang"/></t>
          </li>
          <li>
            <t>2024-01-23 --&gt; the actual date of the publication of this document</t>
          </li>
        </ul>
      </section>
    </section>
    <section anchor="conventions-and-definitions">
      <name>Conventions and Definitions</name>
      <t>The key words "<bcp14>MUST</bcp14>", "<bcp14>MUST NOT</bcp14>", "<bcp14>REQUIRED</bcp14>", "<bcp14>SHALL</bcp14>", "<bcp14>SHALL
NOT</bcp14>", "<bcp14>SHOULD</bcp14>", "<bcp14>SHOULD NOT</bcp14>", "<bcp14>RECOMMENDED</bcp14>", "<bcp14>NOT RECOMMENDED</bcp14>",
"<bcp14>MAY</bcp14>", and "<bcp14>OPTIONAL</bcp14>" 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>
      <?line -18?>

<t>The meanings of the symbols in the YANG tree diagrams are defined in
   <xref target="RFC8340"/>.</t>
      <t>The following terms are used in the document:</t>
      <dl>
        <dt>Network Inventory:</dt>
        <dd>
          <t>A collection of data for network devices and
their components managed by a specific management system
<xref target="I-D.ietf-ivy-network-inventory-yang"/>.</t>
        </dd>
        <dt>Chassis:</dt>
        <dd>
          <t>A physical container that allows installation of power
modules, fan modules, and various types of boards and cards
<xref target="I-D.ietf-ivy-network-inventory-yang"/>.</t>
        </dd>
        <dt>Network Element:</dt>
        <dd>
          <t>A manageable network entity that contains hardware
and software units, e.g., a network device installed on one or
several chassis <xref target="I-D.ietf-ivy-network-inventory-yang"/>.</t>
        </dd>
        <dt>Board and Card:</dt>
        <dd>
          <t>A pluggable equipment can be inserted into one or
 several slots/ sub-slots and can afford a specific transmission
 function independently <xref target="I-D.ietf-ivy-network-inventory-yang"/>. The
 core modular units for processing data.  Depending on functions,
 they can be classified into Main Processing Unit (MPU), Switch
 Fabric Unit (SFU), Line Processing Unit (LPU), and other types.
 MPU is responsible for system control, management, and monitoring.
 SFU is responsible for line-rate data switching on the data plane.
 LPU is responsible for data packet processing and traffic
 management.</t>
        </dd>
        <dt>Port and Interface:</dt>
        <dd>
          <t>A port is a physical entity that is used for
connections.  While an interface is a logical entity for
connections.</t>
        </dd>
      </dl>
    </section>
    <section anchor="yang-prefixes">
      <name>YANG Prefixes</name>
      <t>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="pref"/>.</t>
      <table anchor="pref">
        <name>Prefixes and Corresponding YANG modules</name>
        <thead>
          <tr>
            <th align="left">Prefix</th>
            <th align="left">YANG Module</th>
            <th align="left">Reference</th>
          </tr>
        </thead>
        <tbody>
          <tr>
            <td align="left">ianahw</td>
            <td align="left">iana-hardware</td>
            <td align="left">[IANA_YANG]</td>
          </tr>
          <tr>
            <td align="left">ni</td>
            <td align="left">ietf-network-inventory</td>
            <td align="left">
              <xref target="I-D.ietf-ivy-network-inventory-yang"/></td>
          </tr>
          <tr>
            <td align="left">yang</td>
            <td align="left">ietf-yang-types</td>
            <td align="left">
              <xref target="RFC6991"/></td>
          </tr>
        </tbody>
      </table>
    </section>
    <section anchor="energy-saving-management-data-model-overview">
      <name>Energy Saving Management Data Model Overview</name>
      <section anchor="overview">
        <name>Overview</name>
        <t>As described in <xref target="I-D.ietf-ivy-network-inventory-yang"/>, the Network
   Inventory YANG data model is used to maintain the base network
   inventory information.  This document defines the YANG module "ietf-ni-energy-saving",
   which augments network element of the
   network Inventory base model with energy saving modes, associated
   energy saving methods and augments the component of the network
   inventory base model with capability related power attributes.</t>
        <t>"ietf-ntw-energy-saving" augments the node of asbstract
   network model defined in <xref target="RFC8345"/> with energy consumption and
   power usage related attributes. At the network element level, the data model covers configuration of
   the energy saving mode and a set of related parameters to manage
   (e.g., retrieve or adjust) the status of power units, fans, boards,
   cards, ports, processors, and links.  For example, the adjustment
   methods include frequency tuning, shutdown, or sleep mode.  In
   addition, the methods also support the energy saving configuration
   for the 'tidal' traffic flow, where related components can be turned
   off, e.g., during "idle" hours to optimize the energy consumption and
   then woken up based on some triggered (e.g., busy hours or other
   scheduled events).</t>
        <t>The data model defines energy saving modes representing some energy
   consumption levels, which are basic, standard, or deep.  For each
   consumption level, there is a combination of methods to reach the energy
   saving target level.</t>
        <t>At the component level, the data model includes a set of monitoring
   statistics for energy consumption and energy saving operational
   state of each component within the network device. It also includes threshold
   related power parameters such as rated power, expected volts.</t>
        <t>In order to ease reuse of various paramters independent of the module layer,
   this document alos defines a common model: "ietf-energy-saving-common".</t>
        <t>The structure of each module is provided in the following subsections.</t>
      </section>
      <section anchor="common-energy-saving-management-module-structure">
        <name>Common Energy Saving Management Module Structure</name>
        <t><xref target="e-tree"/> shows the tree diagram of the YANG data model defined in <xref target="sec-module"/>.</t>
        <figure anchor="e-tree">
          <name>Common Energy Saving Management Tree Structure</name>
          <artwork><![CDATA[
module: ietf-energy-saving-common

  grouping energy-consumption-data:
    +-- average-power?    yang:gauge64
    +-- saved-power?      yang:gauge64
    +-- real-power?       yang:gauge64
    +-- actual-volts?     int32
    +-- actual-amperes?   int32
    +-- actual-celsius?   int32
  grouping energy-saving-modes:
    +-- energy-saving-mode* [mode]
       +-- mode?                   identityref
       +-- energy-saving-method*   identityref
  grouping power-parameters:
    +-- temperature-upper-bound?    int32
    +-- temperature-middle-bound?   int32
    +-- temperature-lower-bound?    int32
    +-- rated-power?                yang:gauge64
    +-- expected-volts?             int32
    +-- low-volts-bound?            int32
    +-- low-volts-fatal?            int32
    +-- high-volts-bound?           int32
    +-- high-volts-fatal?           int32
  grouping energy-power-consumption-stats:
    +-- total-energy-consumption?   yang:gauge64
    +-- saved-energy?               yang:gauge64
    +-- eer?                        decimal64
]]></artwork>
        </figure>
      </section>
      <section anchor="energy-saving-management-network-model">
        <name>Energy Saving Management Network Model</name>
        <t>The structure of the ESM Network Model is depicted in <xref target="ne-tree"/>.</t>
        <figure anchor="ne-tree">
          <name>ESM Network Model Tree Structure</name>
          <artwork><![CDATA[
module: ietf-ntw-energy-saving
  augment /nw:networks/nw:network/nw:node:
    +--ro energy-power-consumption {esm-common:energy-saving}?
    |  +--ro total-energy-consumption?   yang:gauge64
    |  +--ro saved-energy?               yang:gauge64
    |  +--ro eer?                        decimal64
    +--rw energy-saving-modes {esm-common:energy-saving}?
    |  +--rw energy-saving-mode* [mode]
    |     +--rw mode                    identityref
    |     +--rw energy-saving-method*   identityref
    +--ro component* [name] {esm-common:energy-saving}?
       +--ro name                 string
       +--ro class                identityref
       +--ro energy-monitoring
          +--ro energy-consumption
          |  +--ro average-power?    yang:gauge64
          |  +--ro saved-power?      yang:gauge64
          |  +--ro real-power?       yang:gauge64
          |  +--ro actual-volts?     int32
          |  +--ro actual-amperes?   int32
          |  +--ro actual-celsius?   int32
          +--ro energy-saving
             +--ro enabled?       boolean
             +--ro power-state?   identityref

]]></artwork>
        </figure>
      </section>
      <section anchor="esm-inventory-model">
        <name>ESM Inventory Model</name>
        <t>The structure of the ESM Network Inventory Model is depicted in <xref target="cs-tree"/>.</t>
        <figure anchor="cs-tree">
          <name>ESM Inventory Model Tree Structure</name>
          <artwork><![CDATA[
module: ietf-ni-energy-saving
  grouping network-element-ref:
    +-- ne-ref?   leafref
  grouping component-ref:
    +-- node-ref?   leafref
    +-- ne-ref?     leafref

  augment /ni:network-inventory/ni:network-elements
          /ni:network-element:
    +--ro energy-management {esm-common:energy-saving}?
       +--ro energy-monitoring-capability?   boolean
       +--ro energy-saving-modes
          +--ro energy-saving-mode* [mode]
             +--ro mode                    identityref
             +--ro energy-saving-method*   identityref
  augment /ni:network-inventory/ni:network-elements
          /ni:network-element/ni:components/ni:component:
    +--ro power-parameters {esm-common:energy-saving}?
       +--ro temperature-upper-bound?    int32
       +--ro temperature-middle-bound?   int32
       +--ro temperature-lower-bound?    int32
       +--ro rated-power?                yang:gauge64
       +--ro expected-volts?             int32
       +--ro low-volts-bound?            int32
       +--ro low-volts-fatal?            int32
       +--ro high-volts-bound?           int32
       +--ro high-volts-fatal?           int32
]]></artwork>
        </figure>
      </section>
    </section>
    <section anchor="sec-module">
      <name>YANG Modules</name>
      <section anchor="sec-common">
        <name>Common Module</name>
        <t>The module imports types defined in <xref target="RFC6991"/>.</t>
        <sourcecode type="yang"><![CDATA[
<CODE BEGINS> file "ietf-energy-saving-common@2024-01-23.yang"
module ietf-energy-saving-common {
  yang-version 1.1;
  namespace "urn:ietf:params:xml:ns:yang:ietf-energy-saving-common";
  prefix esm-common;

  import ietf-yang-types {
    prefix yang;
    reference
      "RFC 6991: Common YANG Types";
  }

  organization
    "IETF xxx Working Group.";
  contact
    "WG Web:   <https://datatracker.ietf.org/wg/xxx/>;
     WG List:  <mailto:xxxx@ietf.org>

     Author:   Gen Chen
               <mailto:chengen@huawei.com>
     Editor:   Qin Wu
               <mailto:bill.wu@huawei.com>
     Editor:   Mohamed Boucadair
               <mailto:mohamed.boucadair@orange.com>
     Author:   Carlos Pignataro
               <mailto:cpignata@gmail.com>";
  description
    "This module contains a collection of YANG definitions for power
     and energy management of devices. It also augments both the
     network topology and inventory models.

     Copyright (c) 2024 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 Revised BSD License
     set forth in Section 4.c of the IETF Trust's Legal Provisions
     Relating to IETF Documents
     (https://trustee.ietf.org/license-info).

     This version of this YANG module is part of RFC XXXX; see
     the RFC itself for full legal notices.";

  revision 2024-01-23 {
    description
      "Initial revision.";
    reference
      "RFC XXXX: YANG Data Models for Energy Saving Management";
  }

  feature energy-saving {
    description
      "Specifies support of energy saving management.";
  }

  identity energy-saving-mode {
    description
      "Base identity for energy saving mode.";
  }

  identity basic {
    base energy-saving-mode;
    description
      "Basic energy saving mode.

       In this mode, the system will shut down idle modules
       and put them in a sleep mode.";
  }

  identity standard {
    base energy-saving-mode;
    description
      "Standard energy saving mode.

       In this mode, the system extends basic energy saving
       mode with more advanced Lossless energy saving features,
       e.g., power module schedule.";
  }

  identity deep {
    base energy-saving-mode;
    description
      "Deep energy saving mode.

       In this mode, the system extends standard energy saving
       mode with more advanced system level energy saving features,
       e.g., board scheduling.";
  }

  identity energy-saving-method {
    description
      "Base identity for energy saving method.";
  }

  identity zone-based-fan-speed-adjustment {
    base energy-saving-method;
    description
      "The system collects information about the
       temperatures of the service boards in the chassis
       and the zones where the service boards reside.

       According to the current temperature and target
       temperature of each board, the system implements
       stepless speed adjustment in different zones.";
  }

  identity unused-high-speed-interface-shutdown {
    base energy-saving-method;
    description
      "When detecting an unused high-speed interface, the
       system shuts down the interface to reduce power consumption
       of the interface circuits.

       When the interface needs to run service, the
       system will automatically wake up the interface and
       restore the interface to the normal working state.";
  }

  identity unused-port-shutdown {
    base energy-saving-method;
    description
      "When detecting an unused user port, the system automatically
       or manually shuts down the interface circuits and optical
       module of the port to reduce port power consumption. When
       detecting that the port needs to run service, the system
       automatically enables the port and restores the port to the
       normal running state, without affecting application of the
       board.";
  }

  identity unused-board-shutdown {
    base energy-saving-method;
    description
      "When detecting an unused board, the system automatically
       shuts down the power supply of the board, ensuring zero
       power consumption of an unused board.

       When detecting that the board needs to run service, the system
       automatically powers on the board and restores the board
       to the normalrunning state, without affecting application of
       the whole device.";
  }

  identity dynamic-frequency-adjustment {
    base energy-saving-method;
    description
      "When detecting that a service board is carrying a small
       service load, the system automatically reduces the working
       frequency of the service processing module of the board
       while maintaining the service quality. In doing so, power
       consumption of the service processing module is reduced.
       When the service load of the board increases, the system
       automatically increases the working frequency of the service
       processing module to meet service needs.";
  }

  identity unused-channel-shutdown {
    base energy-saving-method;
    description
      "When an unused channel is detected, the unused channel is
       closed. Dynamically open the channel when detecting that
       there are services on the channel.";
  }

  identity load-based-power-module-scheduling {
    base energy-saving-method;
    description
      "Power modules intelligently schedule internal power supply
       based on the power load. When the power load decreases,
       some power supplies are automatically disabled.

       When the power load increases, the disabled power supplies
       are enabled again. ";
  }

  identity load-based-board-scheduling {
    base energy-saving-method;
    description
      "Boards intelligently schedule internal forwarding resources
       based on the service load. When the service load decreases,
       some forwarding resources are automatically disabled or the
       working frequency of the forwarding resources is reduced.

       When the service load increases, the disabled forwarding
       resources are enabled again or the working frequency of
       forwarding resources is improved. In the case of burst
       traffic, packet forwarding may be delayed, but packets
       will not be lost.";
  }

  identity energy-saving-power-state {
    description
      "Base identity for power state.";
    reference
      "RFC 7326: Energy Management Framework";
  }

  identity off-state {
    base energy-saving-power-state;
    description
      "Indicates that the component typically
             requires a complete boot when awakened.";
    reference
      "RFC 7326: Energy Management Framework";
  }

  identity sleep-state {
    base energy-saving-power-state;
    description
      "Indicates that a component with energy management support
       is not functional but immediately available such as
       wake up mechanism.";
    reference
      "RFC 7326: Energy Management Framework";
  }

  identity low-power-state {
    base energy-saving-power-state;
    description
      "Indicates that some components with energy management 
       support are not available and these components can
       take measures to use less energy.";
    reference
      "RFC 7326: Energy Management Framework";
  }

  identity full-power-state {
    base energy-saving-power-state;
    description
      "Indicates that all components with energy management
       support are available and may use maximum power.";
    reference
      "RFC 7326: Energy Management Framework";
  }

  typedef energy-saving-operator {
    type enumeration {
      enum on {
        value 1;
        description
          "Power-on for energy saving.";
      }
      enum off {
        value 2;
        description
          "Power-off for energy saving.";
      }
    }
    description
      "Energy saving operator.";
  }

  grouping energy-consumption-data {
    description
      "Grouping for energy monitoring.";
    leaf average-power {
      type yang:gauge64;
      units "mW";
      description
        "The average consumed power.";
    }
    leaf saved-power {
      type yang:gauge64;
      units "mW";
      description
        "The saved power.";
    }
    leaf real-power {
      type yang:gauge64;
      units "mW";
      description
        "The actual observed consumed power.";
      reference
        "RFC 6988: Requirements for Energy Management";
    }
    leaf actual-volts {
      type int32;
      units "mV";
      description
        "The actual observed voltage.";
      reference
        "RFC 6988: Requirements for Energy Management";
    }
    leaf actual-amperes {
      type int32;
      units "mA";
      description
        "The actual observed current.";
      reference
        "RFC 6988: Requirements for Energy Management";
    }
    leaf actual-celsius {
      type int32;
      units "0.01 C";
      description
        "The actual observed temperature.";
    }
  }

  grouping energy-saving-modes {
    description
      "Grouping for energy saving mode and methods.";
    list energy-saving-mode {
      key "mode";
      description
        "The energy saving mode.";
      leaf mode {
        type identityref {
          base energy-saving-mode;
        }
        description
          "The energy saving mode.";
      }
      leaf-list energy-saving-method {
        type identityref {
          base energy-saving-method;
        }
        description
          "The energy saving method.";
      }
    }
  }

  grouping power-parameters {
    description
      "Grouping for energy paramters.";
    leaf temperature-upper-bound {
      type int32;
      units "0.01 C";
      description
        "The upper bound overheat temperature of the component.
         Upon the upper bound is exceeded, an alarm will be
         triggered to indicate fatal failure.";
      reference
        "RFC 8632: A YANG Data Model for Alarm Management";
    }
    leaf temperature-middle-bound {
      type int32;
      units "0.01 C";
      description
        "The middle bound overheat temperature of the component.
         Upon the middle bound is exceeded, an alarm will be
         triggered.";
      reference
        "RFC 8632: A YANG Data Model for Alarm Management";
    }
    leaf temperature-lower-bound {
      type int32;
      units "0.01 C";
      description
        "The lower bound overheat temperature of the component.
         Upon the lower bound is exceeded, the alarm will be
         triggered.";
      reference
        "RFC 8632: A YANG Data Model for Alarm Management";
    }
    leaf rated-power {
      type yang:gauge64;
      units "mW";
      description
        "The rated power.";
    }
    leaf expected-volts {
      type int32;
      units "mV";
      description
        "The expected volts.";
    }
    leaf low-volts-bound {
      type int32;
      units "mV";
      description
        "The lower volts bound which might cause equipment
         misbehavior or even damage.";
    }
    leaf low-volts-fatal {
      type int32;
      units "mV";
      description
        "The lowest volts bound which might cause equipment fatal
         damage.";
    }
    leaf high-volts-bound {
      type int32;
      units "mV";
      description
        "The higher volts bound which should trigger an alarm.";
      reference
        "RFC 8632: A YANG Data Model for Alarm Management";
    }
    leaf high-volts-fatal {
      type int32;
      units "mV";
      description
        "The highest volts bound of monitoring class which
         will cause fatal failure.";
    }
  } 

    grouping energy-power-consumption-stats {
      description
        "Statistics data about energy and power monitoring.";
      leaf total-energy-consumption {
        type yang:gauge64;
        units "Wh";
        description
          "Accumulated energy consumption of equipment.";
      }
      leaf saved-energy {
        type yang:gauge64;
        units "Wh";
        description
          "Saved energy consumption of equipment.";
      }
      leaf eer {
        type decimal64 {
          fraction-digits 18;
        }
        units "Gbps/Watt";
        description
          "The energy efficiency rating (EER) is a metric
           generally defined as a functional unit divided by
           the energy used.";
      }
    }
}
<CODE ENDS>
]]></sourcecode>
      </section>
      <section anchor="sec-ntw">
        <name>Network Module</name>
        <t>The module imports "ietf-network" <xref target="RFC8345"/> and "ietf-energy-saving-common".</t>
        <sourcecode type="yang"><![CDATA[
<CODE BEGINS> file "ietf-ntw-energy-saving@2024-01-23.yang"
module ietf-ntw-energy-saving {
  yang-version 1.1;
  namespace "urn:ietf:params:xml:ns:yang:ietf-ntw-energy-saving";
  prefix esm-ntw;

  import ietf-energy-saving-common {
    prefix esm-common;
    reference
      "RFC XXXX: YANG Data Models for Energy Saving Management";
  }
  import ietf-network {
    prefix nw;
    reference
      "RFC 8345: A YANG Data Model for Network Topologies";
  }
  import ietf-yang-types {
    prefix yang;
    reference
      "RFC 6991: Common YANG Types";
  }
  import iana-hardware {
   prefix ianahw;
   reference
     "https://www.iana.org/assignments/iana-hardware/iana-hardware.xhtml";
  }
  organization
    "IETF XXX Working Group.";
  contact
    "WG Web:   <https://datatracker.ietf.org/wg/xxx/>;
     WG List:  <mailto:xxxx@ietf.org>

     Author:   Gen Chen
               <mailto:chengen@huawei.com>
     Editor:   Qin Wu
               <mailto:bill.wu@huawei.com>
     Editor:   Mohamed Boucadair
               <mailto:mohamed.boucadair@orange.com>
     Author:   Carlos Pignataro
               <mailto:cpignata@gmail.com>";
  description
    "This module contains a collection of YANG definitions for power
     and energy management of devices. It also augments both the
     network topology and inventory models.

     Copyright (c) 2024 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 Revised BSD License
     set forth in Section 4.c of the IETF Trust's Legal Provisions
     Relating to IETF Documents
     (https://trustee.ietf.org/license-info).

     This version of this YANG module is part of RFC XXXX; see
     the RFC itself for full legal notices.";

  revision 2024-01-23 {
    description
      "Initial revision.";
    reference
      "RFC XXXX: YANG Data Models for Energy Saving Management";
  }
  
  augment "/nw:networks/nw:network/nw:node" {
    if-feature "esm-common:energy-saving";
    description
      "Energy monitoring data for network elements.";
    container energy-power-consumption {
      config false;
      description
        "Statistics data about energy and power monitoring.";
      uses esm-common:energy-power-consumption-stats;
      leaf start-time {
        type yang:date-and-time;
        description
          "The time (in hundredths of a second) since the
          network management portion of the system was last
          re-initialized. It corresponds to the sysUpTime MIB object.
          It specifies the start time of the energy measurement
          results collection.";
      reference
        "RFC 3418:   Management Information Base (MIB) for the
                     Simple Network Management Protocol (SNMP)";
      }
    }
    container energy-saving-modes {
      description
        "List of the energy saving mode.";
      uses esm-common:energy-saving-modes;
    }
    list component {
      key name;
      config false;
      description
      "List of components.";
      leaf name {
        type string;
        description
          "The name assigned to this component.
           This name is not required to be the same as
           entPhysicalName.";
      }
      leaf class {
        type identityref {
          base ianahw:hardware-class;
        }
        mandatory true;
        description
          "An indication of the general hardware type of the
           component.";
        reference
          "RFC 6933: Entity MIB (Version 4) - entPhysicalClass";
        }
      container energy-monitoring {
        description
          "Energy monitoring data for components.";
        container energy-consumption {
          description
          "Statistics of component about energy monitoring.";
          uses esm-common:energy-consumption-data;
        }
       container energy-saving {
        description
        "Controls energy saving parameters of a component.";
         leaf enabled {
          type boolean;
          default "true";
           description
             "Controls whether the energy-saving
             of the component is enabled (when set to true)
              or disabled (set to false).";
         }
         leaf power-state {
          type identityref {
            base esm-common:energy-saving-power-state;
          }
          description
            "The device energy saving operator state.";
         }
       }
     } 
   }
  }
}
<CODE ENDS>
]]></sourcecode>
      </section>
      <section anchor="sec-ni">
        <name>Network Inventory Module</name>
        <t>The module imports "ietf-network-inventory" <xref target="I-D.ietf-ivy-network-inventory-yang"/> and "ietf-energy-saving-common".</t>
        <sourcecode type="yang"><![CDATA[
<CODE BEGINS> file "ietf-ni-energy-saving@2024-01-23.yang"
module ietf-ni-energy-saving {
  yang-version 1.1;
  namespace "urn:ietf:params:xml:ns:yang:ietf-ni-energy-saving";
  prefix esm-ni;

  import ietf-energy-saving-common {
    prefix esm-common;
    reference
      "RFC XXXX: YANG Data Models for Energy Saving Management";
  }
  import ietf-network-inventory {
    prefix ni;
    reference
      "RFC IIII: A YANG Data Model for Network Inventory";
  }

  organization
    "IETF xxx Working Group.";
  contact
    "WG Web:   <https://datatracker.ietf.org/wg/xxx/>;
     WG List:  <mailto:xxxx@ietf.org>

     Author:   Gen Chen
               <mailto:chengen@huawei.com>
     Editor:   Qin Wu
               <mailto:bill.wu@huawei.com>
     Editor:   Mohamed Boucadair
               <mailto:mohamed.boucadair@orange.com>
     Author:   Carlos Pignataro
               <mailto:cpignata@gmail.com>";
  description
    "This module contains a collection of YANG definitions for power
     and energy management of devices. It also augments both the
     network topology and inventory models.

     Copyright (c) 2024 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 Revised BSD License
     set forth in Section 4.c of the IETF Trust's Legal Provisions
     Relating to IETF Documents
     (https://trustee.ietf.org/license-info).

     This version of this YANG module is part of RFC XXXX; see
     the RFC itself for full legal notices.";

  revision 2024-01-23 {
    description
      "Initial revision.";
    reference
      "RFC XXXX: YANG Data Models for Energy Saving Management";
  }

  grouping network-element-ref {
    description
      "Contains the information necessary to reference a network
       element.";
    leaf ne-ref {
      type leafref {
        path "/ni:network-inventory/ni:network-elements"
           + "/ni:network-element/ni:ne-id";
        require-instance false;
      }
      description
        "Used to reference a network element.";
    }
  }

  grouping component-ref {
    description
      "Contains the information necessary to reference a component.";
    leaf node-ref {
      type leafref {
        path "/ni:network-inventory/ni:network-elements"
           + "/ni:network-element[ni:ne-id="
           + "current()/../ne-ref]/ni:components/ni:component"
           + "/ni:component-id";
        require-instance false;
      }
      description
        "Used to reference a component.";
    }
    uses network-element-ref;
  }

  augment "/ni:network-inventory/ni:network-elements"
        + "/ni:network-element" {
    if-feature "esm-common:energy-saving";
    description
      "Energy management static data for network element.";
    container energy-management {
      config false;
      description
        "Statistics of the energy management.";
      leaf energy-monitoring-capability {
        type boolean;
        description
          "Indicates whether monitoring can be performed.";
      }
      container energy-saving-modes {
        description
          "List of supported energy saving modes.";
        uses esm-common:energy-saving-modes;
      }
    }
  }

  augment "/ni:network-inventory/ni:network-elements"
        + "/ni:network-element/ni:components/ni:component" {
    if-feature "esm-common:energy-saving";
    description
      "Energy management static data for component.";
    container power-parameters {
      config false;
      description
        "Power parameter monitoring.";
      uses esm-common:power-parameters;
    }
  }
}
<CODE ENDS>
]]></sourcecode>
      </section>
    </section>
    <section anchor="security-considerations">
      <name>Security Considerations</name>
      <t>This section uses the template described in Section 3.7 of <xref target="I-D.ietf-netmod-rfc8407bis"/>.</t>
      <t>The YANG modules specified in this document define a schema for data
   that is designed to be accessed via network management protocol such
   as NETCONF <xref target="RFC6241"/> or RESTCONF <xref target="RFC8040"/>.These network management
   protocols are required to use a secure transport layer and mutual
   authentication, e.g., SSH <xref target="RFC6242"/> without the "none" authentication
   option, Transport Layer Security (TLS) <xref target="RFC8446"/> with mutual X.509
   authentication, and HTTPS with HTTP authentication (<xref section="11" sectionFormat="of" target="RFC9110"/>).</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 several 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. Specifically, the following subtrees and data nodes have particular
sensitivities/vulnerabilities:</t>
      <dl>
        <dt>energy-saving-modes:</dt>
        <dd>
          <t>This leaf specifies the energy saving mode set globally on a device.</t>
        </dd>
        <dt>esm-ntw:energy-saving/esm-ntw:enabled:</dt>
        <dd>
          <t>This leaf enable/disables energy saving state of specific component.
</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. Specifically, the following subtrees and data nodes have particular
sensitivities/vulnerabilities:</t>
          <dl>
            <dt>'TBC':</dt>
            <dd>
              <t>....</t>
            </dd>
          </dl>
        </dd>
      </dl>
    </section>
    <section anchor="iana-considerations">
      <name>IANA Considerations</name>
      <section anchor="the-ietf-xml-registry">
        <name>The "IETF XML" Registry</name>
        <t>This document requests IANA to register the following URIs
in the "ns" subregistry within the "IETF XML Registry" <xref target="RFC3688"/>:</t>
        <artwork><![CDATA[
   URI: urn:ietf:params:xml:ns:yang:ietf-energy-saving-common
   Registrant Contact: The IESG.
   XML: N/A, the requested URIs are XML namespaces.

   URI: urn:ietf:params:xml:ns:yang:ietf-ntw-energy-saving
   Registrant Contact: The IESG.
   XML: N/A, the requested URIs are XML namespaces.

   URI: urn:ietf:params:xml:ns:yang:ietf-ni-energy-saving
   Registrant Contact: The IESG.
   XML: N/A, the requested URIs are XML namespaces.
]]></artwork>
      </section>
      <section anchor="the-yang-module-names-registry">
        <name>The "YANG Module Names" Registry</name>
        <t>This document requests IANA to register the following YANG modules
   in the "YANG Module Names" registry <xref target="RFC6020"/> within
   the "YANG Parameters" registry group.</t>
        <artwork><![CDATA[
   name: ietf-energy-saving-common
   prefix: esm-common
   namespace: urn:ietf:params:xml:ns:yang:ietf-energy-saving-common
   Maintained by IANA? N
   Reference: RFC XXXX

   name: ietf-ntw-energy-saving
   prefix: esm-ntw
   namespace: urn:ietf:params:xml:ns:yang:ietf-ntw-energy-saving
   Maintained by IANA? N
   Reference: RFC XXXX

   name: ietf-ni-energy-saving
   prefix: esm-ni
   namespace: urn:ietf:params:xml:ns:yang:ietf-ni-energy-saving
   Maintained by IANA? N
   Reference: RFC XXXX
]]></artwork>
      </section>
    </section>
  </middle>
  <back>
    <references>
      <name>References</name>
      <references anchor="sec-normative-references">
        <name>Normative References</name>
        <reference anchor="RFC8345">
          <front>
            <title>A YANG Data Model for Network Topologies</title>
            <author fullname="A. Clemm" initials="A." surname="Clemm"/>
            <author fullname="J. Medved" initials="J." surname="Medved"/>
            <author fullname="R. Varga" initials="R." surname="Varga"/>
            <author fullname="N. Bahadur" initials="N." surname="Bahadur"/>
            <author fullname="H. Ananthakrishnan" initials="H." surname="Ananthakrishnan"/>
            <author fullname="X. Liu" initials="X." surname="Liu"/>
            <date month="March" year="2018"/>
            <abstract>
              <t>This document defines an abstract (generic, or base) YANG data model for network/service topologies and inventories. The data model serves as a base model that is augmented with technology-specific details in other, more specific topology and inventory data models.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="8345"/>
          <seriesInfo name="DOI" value="10.17487/RFC8345"/>
        </reference>
        <reference anchor="I-D.ietf-ivy-network-inventory-yang">
          <front>
            <title>A YANG Data Model for Network Inventory</title>
            <author fullname="Chaode Yu" initials="C." surname="Yu">
              <organization>Huawei Technologies</organization>
            </author>
            <author fullname="Sergio Belotti" initials="S." surname="Belotti">
              <organization>Nokia</organization>
            </author>
            <author fullname="Jean-Francois Bouquier" initials="J." surname="Bouquier">
              <organization>Vodafone</organization>
            </author>
            <author fullname="Fabio Peruzzini" initials="F." surname="Peruzzini">
              <organization>TIM</organization>
            </author>
            <author fullname="Phil Bedard" initials="P." surname="Bedard">
              <organization>Cisco</organization>
            </author>
            <date day="4" month="March" year="2024"/>
            <abstract>
              <t>   This document defines a base YANG data model for network inventory
   that is application- and technology-agnostic.  This data model can be
   augmented with application-specific and technology-specific details
   in other, more specific network inventory data models.

              </t>
            </abstract>
          </front>
          <seriesInfo name="Internet-Draft" value="draft-ietf-ivy-network-inventory-yang-01"/>
        </reference>
        <reference anchor="RFC2119">
          <front>
            <title>Key words for use in RFCs to Indicate Requirement Levels</title>
            <author fullname="S. Bradner" initials="S." surname="Bradner"/>
            <date month="March" year="1997"/>
            <abstract>
              <t>In many standards track documents several words are used to signify the requirements in the specification. These words are often capitalized. This document defines these words as they should be interpreted in IETF documents. This document specifies an Internet Best Current Practices for the Internet Community, and requests discussion and suggestions for improvements.</t>
            </abstract>
          </front>
          <seriesInfo name="BCP" value="14"/>
          <seriesInfo name="RFC" value="2119"/>
          <seriesInfo name="DOI" value="10.17487/RFC2119"/>
        </reference>
        <reference anchor="RFC8174">
          <front>
            <title>Ambiguity of Uppercase vs Lowercase in RFC 2119 Key Words</title>
            <author fullname="B. Leiba" initials="B." surname="Leiba"/>
            <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="RFC6991">
          <front>
            <title>Common YANG Data Types</title>
            <author fullname="J. Schoenwaelder" initials="J." role="editor" surname="Schoenwaelder"/>
            <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="RFC6241">
          <front>
            <title>Network Configuration Protocol (NETCONF)</title>
            <author fullname="R. Enns" initials="R." role="editor" surname="Enns"/>
            <author fullname="M. Bjorklund" initials="M." role="editor" surname="Bjorklund"/>
            <author fullname="J. Schoenwaelder" initials="J." role="editor" surname="Schoenwaelder"/>
            <author fullname="A. Bierman" initials="A." role="editor" surname="Bierman"/>
            <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="RFC8040">
          <front>
            <title>RESTCONF Protocol</title>
            <author fullname="A. Bierman" initials="A." surname="Bierman"/>
            <author fullname="M. Bjorklund" initials="M." surname="Bjorklund"/>
            <author fullname="K. Watsen" initials="K." surname="Watsen"/>
            <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="RFC8341">
          <front>
            <title>Network Configuration Access Control Model</title>
            <author fullname="A. Bierman" initials="A." surname="Bierman"/>
            <author fullname="M. Bjorklund" initials="M." surname="Bjorklund"/>
            <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>
        <reference anchor="RFC3688">
          <front>
            <title>The IETF XML Registry</title>
            <author fullname="M. Mealling" initials="M." surname="Mealling"/>
            <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="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"/>
            <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>
      </references>
      <references anchor="sec-informative-references">
        <name>Informative References</name>
        <reference anchor="RFC6988">
          <front>
            <title>Requirements for Energy Management</title>
            <author fullname="J. Quittek" initials="J." role="editor" surname="Quittek"/>
            <author fullname="M. Chandramouli" initials="M." surname="Chandramouli"/>
            <author fullname="R. Winter" initials="R." surname="Winter"/>
            <author fullname="T. Dietz" initials="T." surname="Dietz"/>
            <author fullname="B. Claise" initials="B." surname="Claise"/>
            <date month="September" year="2013"/>
            <abstract>
              <t>This document defines requirements for standards specifications for Energy Management. The requirements defined in this document are concerned with monitoring functions as well as control functions. Monitoring functions include identifying energy-managed devices and their components, as well as monitoring their Power States, Power Inlets, Power Outlets, actual power, Power Attributes, received energy, provided energy, and contained batteries. Control functions include such functions as controlling power supply and Power State of energy-managed devices and their components.</t>
              <t>This document does not specify the features that must be implemented by compliant implementations but rather lists features that must be supported by standards for Energy Management.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="6988"/>
          <seriesInfo name="DOI" value="10.17487/RFC6988"/>
        </reference>
        <reference anchor="I-D.ietf-netmod-rfc8407bis">
          <front>
            <title>Guidelines for Authors and Reviewers of Documents Containing YANG Data Models</title>
            <author fullname="Andy Bierman" initials="A." surname="Bierman">
              <organization>YumaWorks</organization>
            </author>
            <author fullname="Mohamed Boucadair" initials="M." surname="Boucadair">
              <organization>Orange</organization>
            </author>
            <author fullname="Qin Wu" initials="Q." surname="Wu">
              <organization>Huawei</organization>
            </author>
            <date day="21" month="June" year="2024"/>
            <abstract>
              <t>   This memo provides guidelines for authors and reviewers of
   specifications containing YANG modules, including IANA-maintained
   modules.  Recommendations and procedures are defined, which are
   intended to increase interoperability and usability of Network
   Configuration Protocol (NETCONF) and RESTCONF protocol
   implementations that utilize YANG modules.  This document obsoletes
   RFC 8407.

   Also, this document updates RFC 8126 by providing additional
   guidelines for writing the IANA considerations for RFCs that specify
   IANA-maintained modules.

              </t>
            </abstract>
          </front>
          <seriesInfo name="Internet-Draft" value="draft-ietf-netmod-rfc8407bis-12"/>
        </reference>
        <reference anchor="RFC3418">
          <front>
            <title>Management Information Base (MIB) for the Simple Network Management Protocol (SNMP)</title>
            <author fullname="R. Presuhn" initials="R." role="editor" surname="Presuhn"/>
            <date month="December" year="2002"/>
            <abstract>
              <t>This document defines managed objects which describe the behavior of a Simple Network Management Protocol (SNMP) entity. This document obsoletes RFC 1907, Management Information Base for Version 2 of the Simple Network Management Protocol (SNMPv2). [STANDARDS-TRACK]</t>
            </abstract>
          </front>
          <seriesInfo name="STD" value="62"/>
          <seriesInfo name="RFC" value="3418"/>
          <seriesInfo name="DOI" value="10.17487/RFC3418"/>
        </reference>
        <reference anchor="RFC6933">
          <front>
            <title>Entity MIB (Version 4)</title>
            <author fullname="A. Bierman" initials="A." surname="Bierman"/>
            <author fullname="D. Romascanu" initials="D." surname="Romascanu"/>
            <author fullname="J. Quittek" initials="J." surname="Quittek"/>
            <author fullname="M. Chandramouli" initials="M." surname="Chandramouli"/>
            <date month="May" year="2013"/>
            <abstract>
              <t>This memo defines a portion of the Management Information Base (MIB) for use with network management protocols in the Internet community. In particular, it describes managed objects used for managing multiple logical and physical entities managed by a single Simple Network Management Protocol (SNMP) agent. This document specifies version 4 of the Entity MIB. This memo obsoletes version 3 of the Entity MIB module published as RFC 4133.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="6933"/>
          <seriesInfo name="DOI" value="10.17487/RFC6933"/>
        </reference>
        <reference anchor="RFC8340">
          <front>
            <title>YANG Tree Diagrams</title>
            <author fullname="M. Bjorklund" initials="M." surname="Bjorklund"/>
            <author fullname="L. Berger" initials="L." role="editor" surname="Berger"/>
            <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="RFC6242">
          <front>
            <title>Using the NETCONF Protocol over Secure Shell (SSH)</title>
            <author fullname="M. Wasserman" initials="M." surname="Wasserman"/>
            <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">
          <front>
            <title>The Transport Layer Security (TLS) Protocol Version 1.3</title>
            <author fullname="E. Rescorla" initials="E." surname="Rescorla"/>
            <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="RFC9110">
          <front>
            <title>HTTP Semantics</title>
            <author fullname="R. Fielding" initials="R." role="editor" surname="Fielding"/>
            <author fullname="M. Nottingham" initials="M." role="editor" surname="Nottingham"/>
            <author fullname="J. Reschke" initials="J." role="editor" surname="Reschke"/>
            <date month="June" year="2022"/>
            <abstract>
              <t>The Hypertext Transfer Protocol (HTTP) is a stateless application-level protocol for distributed, collaborative, hypertext information systems. This document describes the overall architecture of HTTP, establishes common terminology, and defines aspects of the protocol that are shared by all versions. In this definition are core protocol elements, extensibility mechanisms, and the "http" and "https" Uniform Resource Identifier (URI) schemes.</t>
              <t>This document updates RFC 3864 and obsoletes RFCs 2818, 7231, 7232, 7233, 7235, 7538, 7615, 7694, and portions of 7230.</t>
            </abstract>
          </front>
          <seriesInfo name="STD" value="97"/>
          <seriesInfo name="RFC" value="9110"/>
          <seriesInfo name="DOI" value="10.17487/RFC9110"/>
        </reference>
        <reference anchor="I-D.cx-opsawg-green-metrics">
          <front>
            <title>Green Networking Metrics</title>
            <author fullname="Alexander Clemm" initials="A." surname="Clemm">
              <organization>Futurewei</organization>
            </author>
            <author fullname="Lijun Dong" initials="L." surname="Dong">
              <organization>Futurewei</organization>
            </author>
            <author fullname="Greg Mirsky" initials="G." surname="Mirsky">
              <organization>Ericsson</organization>
            </author>
            <author fullname="Laurent Ciavaglia" initials="L." surname="Ciavaglia">
              <organization>Nokia</organization>
            </author>
            <author fullname="Jeff Tantsura" initials="J." surname="Tantsura">
              <organization>Nvidia</organization>
            </author>
            <author fullname="Marie-Paule Odini" initials="M." surname="Odini">
         </author>
            <author fullname="Eve Schooler" initials="E." surname="Schooler">
         </author>
            <author fullname="Ali Rezaki" initials="A." surname="Rezaki">
              <organization>Nokia</organization>
            </author>
            <author fullname="Carlos Pignataro" initials="C." surname="Pignataro">
              <organization>North Carolina State University</organization>
            </author>
            <date day="4" month="March" year="2024"/>
            <abstract>
              <t>   This document explains the need for network instrumentation that
   allows to assess a number of sustainability-related attributes such
   as power consumption, energy efficiency, and carbon footprint
   associated with a network, its equipment, and the services that are
   provided over it.  It also suggests a set of related metrics that,
   when provided visibility into, can help to optimize a network's
   "greenness" accordingly.

              </t>
            </abstract>
          </front>
          <seriesInfo name="Internet-Draft" value="draft-cx-opsawg-green-metrics-02"/>
        </reference>
        <reference anchor="I-D.manral-bmwg-power-usage">
          <front>
            <title>Benchmarking Power usage of networking devices</title>
            <author fullname="Vishwas Manral" initials="V." surname="Manral">
              <organization>HP</organization>
            </author>
            <author fullname="Puneet Sharma" initials="P." surname="Sharma">
              <organization>HP</organization>
            </author>
            <author fullname="Sujata Banerjee" initials="S." surname="Banerjee">
              <organization>HP</organization>
            </author>
            <author fullname="Yang Ping" initials="Y." surname="Ping">
              <organization>H3C</organization>
            </author>
            <date day="12" month="March" year="2013"/>
            <abstract>
              <t>   With the rapid growth of networks around the globe there is an ever
   increasing need to improve the energy efficiency of network devices.
   Operators are begining to seek more information of power consumption
   in the network, have no standard mechanism to measure, report and
   compare power usage of different networking equipment under different
   network configuration and conditions.

   This document provides suggestions for measuring power usage of live
   networks under different traffic loads and various switch router
   configuration settings.  It provides a benchmarking suite which can
   be employed for any networking device .

              </t>
            </abstract>
          </front>
          <seriesInfo name="Internet-Draft" value="draft-manral-bmwg-power-usage-04"/>
        </reference>
      </references>
    </references>
    <?line 1143?>

<section numbered="false" anchor="acknowledgments">
      <name>Acknowledgments</name>
      <t>This work has benefited from the discussions that occured during the Sustainable
   Networking Side Meeting in IETF#117 and the "e-impact" IAB workshop. In
   particular, <xref target="I-D.cx-opsawg-green-metrics"/> assess several
   sustainability-related attributes such as power consumption, energy
   efficiency, and carbon footprint associated with a network, its
   equipment, and the services that are provided over it and suggest a
   set of metrics that provide network observability and can be used to
   optimize a network's "greenness". <xref target="I-D.manral-bmwg-power-usage"/>
   provides suggestions for measuring power usage of live networks under
   different traffic loads and various switch router configuration
   settings.</t>
    </section>
  </back>
  <!-- ##markdown-source:
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
dJNZoHfCDPv2BCt0+5einOlC5whjvY9Zd9qeHNx/socCz0e0wdwiLU389aZn
BzUms3U73jNJacwp4ElRBXQCvM9NxxPPA2icSmzl2xKoHdCmBUzDChlXi5Iv
+gHHMc/iXVEmeOink3/jmDnHSOKQ7uYLqpRvsFIwl3MCAiCAQcKyiUfbk0W1
h5aac/qh/rvVGeJ2fPRMnY3qhJywlrkGSh8fWFTmaHzHfVYr6c2wBFrGGmef
dny4ciqNlwzQgGg7feTsoqAUmB3Adlef6tce0/hzShsSrKNuoYGlqnJASOyc
nhy/2fUuzXYk2bNW0iOw6Hq0aONdKuiRTrehRqAAwdosEncpBZ30x9fSK4Ok
TRloTarp3JaW6POxLVuJO1Xv3E7gi2rqGxWwgkp6MRdP8TH7JHYMz60GYN6o
w4fx8N+eiS2HOK6z3sJe8UR7swFB8E1yl7h1ivwNvO3w6uhBptcFHP1Vk1dz
IDnj10y/Z7ZqyjlT6a4CmZnB/fuYk0FpJ6jYO39TI+eDXboa0VDuADs37Pau
I//OMPDpqp5uGDl88uZpzR/F6Y982DHClenmWOEbIfDTo4ftxAqPBPQYiSsI
NDzgw8Hb+widhTYaGLwsV9EalQrpkoYER52i8rhBslkIJlgMUUgbHe+hZgPF
9UJWdPb5orUQ2azQXrWgZQmF5A6l7KFHiWYAkNhtGWw8OlQnge6ocmS/dhs9
v2wRoZtJ5RCiT8P1mmqf2e1kXnXa7qUa2T11S0CTsybDqZGm2QSsvlxSYhuv
xV4RemocAOIEoZItYlDu/U1bnwZ+M5Gq5FqBquRbxKnax2q3w1TJ/5MolXOo
ezNelWzAAS8GuipeZURLtd4fxfl+NEkTwPcozvcozvcozvcoTu/RJJuOCuzH
70DrKG9dtrPhTOLuO5RAvlZY3R3SuD8YP6qVRi4Wnx/YXGtW5wg6PtMqBPkZ
bn2k3dC1TX9qVnTOtYO2k7gxlaEpX0DXK2EPGhNY7SV53el36joOT+/b3e7m
uDWOXbxJ+ne8dya5Os7xjyf6PzXR/9IurHJfd3bvjMd3WCZ+23D0oK8tS8Vv
ydQOSRkCzd882mRUzgmbXpuefmLebIDV2QOE89ioN87aG2Z1D+S0E/hrx1db
Ab3WkUdGiDcd5dmOtHQmpD0zeLubRc843TQVvoYDhk1UvO4q/bbhut7WdTRM
7YuRvrOFGgGLrWN3nezamxfGTbr6B8lpRzMtP3qSiK8hoG+ad19sFelvt+qa
f++0Gt0jvtT5QN0gzDfqIssaV9TWeoM8Jm2mdD+be+OUveL6RxSoT582XnFt
L2xpXMetI+5x9/JRTnHBZQOYzSxDc8MbwtFXrwFCJuw6xR0COERhHmMSelcU
dDgctxEiHPCVTw7PDl6fvNAHfN57gNd7QVNvD0/dF4/u0tWZZ7TLrgsagWno
vIfXjeyiLx3yZdqSrx+kCS5dNcKbCmrc2kAYgeuOrrz2oflMqdPTX/U1xPce
3FOXOKkjlsQwA4EctmoirHzFMM5Mi6+oRSMAO2evTnf13aAPHjzUt0MxOuLv
4z/f/cmHFKL869nZm1Mujl9bZdw70Pf4AnRo46e9vbt027mWBT0LP2hcELVP
bBQqMqcm7Tsn+wfHuzahaI8v61V3p7Cg4k2p6lIdnM1ElZIIns6Bs51EdC2j
5jlPXwyn8bgdqh5ieEHfrCRjvoaFzCbuPbTbCHvgGDEzd+bo27KzSuo7B8+c
ExT4CkvnOj/n4NnOvEFfsoxA1sBGxOQO7jPnb0ArSd/ETjKWIDvK+mA4Ul9r
lJR6ZqpCprt0XRuKtoOE2vtt7xkHTOFrlfBNW+d1igF9aAkBJepGJ3sX6XlS
5JxBg9cgAqLSpYe67wnmnVXAGFKslOeBTTy0rANZca8CUldJFo6Wi/Cc3eB5
iJghEEnHwNAN4Qob2/BYqCMQaSf2SO3yd+7bwcOHmV0OCtSIFaCBJgTdtH5H
U0LdvI635XpGyclAqDvAedm1sdbo2WyEEjdP8ymfzYFnDapDaxA8p5g1h7U7
9ilFmFsN8tM7Kv7cDsmb+5zMNanOChYS9TS366AgbDGJmEMin6h2JAgB9QjR
VRJ0VLHY1jQd5xAhhxPMFfWIltZ4JV84EMxlNcI/Ss5GSl1xDq1jFbs+wfuD
REWI22fPDm6rG0fH8MFBGm+67AzQt26R1VRZZcevhuKtnGPg5gLj4O7gSWdE
lFXJcMgiYkG1vGF78e7tUTlQJ+8Ns3KI3SoUTPcuL9OkaVHndt5/+OjR5eVE
XR8AfQCQE/FFR1KTEWXwyNkDjqxOqM9Hh6cvaSkVcJiIkzv7IyWJ1E+wTdgT
MqeIpImRq5jadjj5rnr5v0Woe//CN8DHLLewcLm3tNJVs66Uifa1ntsKmuv1
qfGi6mnNyJ9yye7eu6scE77L3NZ7Y7xepxYFPMZWHrGrm24oE3oxYeK41boi
0egrxPlYHZnFN5sjjZ6KE2ajmu1PTPRv0MLWK44uqlDgunh6YX4Vkh4RbeCY
XBtFD8RrYcjyHASBmIbRBzSm+9GHLF/DkMix+cGnSVYvpzgg/WVIs7LhpRVt
GnwWMDOYAhqzBFVnVuRLfYJPVNPF4eosijyKyENUV2RimdO6RFS1Y6RcXHx7
CrZcHEtJUWZQALSpt/b2fjQh/aEMYGADlR5CH58RJuUiX43VBaF2VBnp6Vb0
MchXZbieB3MYjLKA9wyUuIQJEyE8kJSdSxp4NWIUvgi6l7uaqxY75wOOnMsp
7Z6Fkb7bfkoHTuTVCohQdS6RNlOxEUazCYTeojEyXTfHiGn31t6KiJsHoaZa
NJjPcaNPyJ5EpS7TxD5zTVXLen60W1yHbPSl8OCUqKuN9TyJLjI1mN4uxZAI
mgENh2NNbZjvAS2D6XKtl8/pntzWTEThaNaROF3MbDNWd+sC4ik6QTq5UdRZ
zMtN9rxYfXcrHibFjoa+yZIvSRdg6irmVPMSWKAMChkY9/8Fiv+9a3CVAAA=

-->

</rfc>
