<?xml version="1.0" encoding="utf-8"?>
<?xml-model href="rfc7991bis.rnc"?>  <!-- Required for schema validation and schema-aware editing -->
<!-- <?xml-stylesheet type="text/xsl" href="rfc2629.xslt" ?> -->
<!-- This third-party XSLT can be enabled for direct transformations in XML processors, including most browsers -->


<!DOCTYPE rfc [
  <!ENTITY nbsp    "&#160;">
  <!ENTITY zwsp   "&#8203;">
  <!ENTITY nbhy   "&#8209;">
  <!ENTITY wj     "&#8288;">
]>
<!-- If further character entities are required then they should be added to the DOCTYPE above.
     Use of an external entity file is not recommended. -->

<rfc
  xmlns:xi="http://www.w3.org/2001/XInclude"
  category="std"
  consensus="true"
  docName="draft-ietf-lsvr-bgp-ls-yang-01"
  ipr="trust200902"
  obsoletes=""
  submissionType="IETF"
  updates=""
  xml:lang="en"
  version="3">

  <front>
    <title abbrev="BGP LS, LS-VPN, LS-SPF YANG Model">A YANG Model for BGP-LS, BGP-LS-VPN, and BGP-LS-SPF</title>
    <seriesInfo name="Internet-Draft" value="draft-ietf-lsvr-bgp-ls-yang-01"/>
   
    <author fullname="Mahesh Jethanandani" initials="M." role="editor" surname="Jethanandani">
      <organization>Arrcus, Inc</organization>
      <address>
        <postal>
          <street/>
          <city/>
          <region/>
          <code/>
          <country/>
        </postal>        
        <phone/>
        <email>mjethanandani@gmail.com</email>  
        <uri/>
      </address>
    </author>
    <author fullname="Keyur Patel" initials="K." surname="Patel">
      <organization>Arrcus, Inc</organization>
      <address>
        <postal>
          <street/>
          <city/>
          <region/>
          <code/>
          <country/>
        </postal>        
        <phone/>
        <email>keyur@arrcus.com</email>
        <uri/>
      </address>
    </author>
   
    <date/>
    <area>Routing</area>
    <workgroup>LSVR</workgroup>
    <keyword>bgp</keyword>
    <keyword>bgp-ls</keyword>
    <keyword>bgp-ls-vpn</keyword>
    <keyword>bgp-ls-spf</keyword>
    <keyword>yang</keyword>

    <abstract>
      <t>This document defines a YANG data model for configuration
      and management of BGP-LS, BGP-LS-VPN, and BGP-LS-SPF.</t>
    </abstract>
  </front>

  <middle>
    
    <section>
      <name>Introduction</name>
      <t><xref target="RFC7752">North-Bound Distribution of Link-State
      (LS) and Traffic Engineering (TE) Information Using BGP</xref>
      describes a mechanism by which LS and TE information can be
      collected and shared with external components using BGP routing
      protocol. That LS combined with Shortest Path First (SPF)
      algorithm can be used by BGP for making routing
      decisions. Additionally, <xref
      target="I-D.ietf-lsvr-bgp-spf">BGP Link-State Shortest Path
      First (SPF) Routing</xref> describes how it allows BGP to be
      used efficiently as both the underlay and the overlay protocol
      in Many Massively Scaled Data Centers (MSDC). This document
      defines a <xref target="RFC7950">YANG 1.1 </xref> model that can
      be used to configure a router of that capability. It also
      defines a model for Link State DataBase (LSDB) that is used to
      store Link State Advertisements (LSA).
      </t>

      <t>The model conforms to the <xref target="RFC8342">NMDA</xref>
      architecture.</t>

      <section>
	<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"/> <xref target="RFC8174"/> when, and 
	only when, they appear in all capitals, as shown here.</t>
      </section>
    </section>

    <section>
      <name>Terminology</name>
      <t>
	This document references terms defined in other documents.
      </t>

      <ul>
	<li>BGP SPF Routing Domain</li>
	<li>BGP-LS-SPF NLRI</li>
      </ul>
	
      <section>
	<name>Acronyms</name>
	<t>This document uses a few acronyms. Some of them are defined
	here for reference.</t>
	<table>
	  <name>Acronyms</name>
          <thead>
            <!-- [REPLACE/DELETE] a table header is optional -->
            <tr><th>Acronym</th><th>Definition</th></tr>
          </thead>
          <tbody>
	    <tr><td>AFI</td><td>Address Family Indicator</td></tr>
	    <tr><td>LS</td><td>Link-State</td></tr>
	    <tr><td>LSA</td><td>Link-State Advertisements</td></tr>
	    <tr><td>LSDB</td><td>Link-State DataBase</td></tr>
	    <tr><td>SAFI</td><td>Subsequent Address Family
	    Indicator</td></tr>
            <tr><td>SPF</td><td>Shortest Path First</td></tr>
            <tr><td>TE</td><td>Traffic Engineering</td></tr>
          </tbody>
	</table>
      </section>
    </section>

    <section>
      <name>Tree Diagram</name>
      <t>An abridged version of the tree diagram is shown here.
      Annotations used in the diagram are defined in <xref
      target="RFC8340">YANG Tree Diagrams </xref>.</t>
      <figure>
	<name>Tree Diagram for BGP-LS, BGP-LS-SPF YANG Model</name>
        <artwork><![CDATA[
module: ietf-bgp-ls

  augment /rt:routing/rt:control-plane-protocols
            /rt:control-plane-protocol/bgp:bgp/bgp:global
            /bgp:afi-safis/bgp:afi-safi:
    +--rw link-state!
    |  +--rw prefix-limit
    |  |  +--rw max-prefixes?             uint32
    |  |  +--rw shutdown-threshold-pct?   rt-types:percentage
    |  |  +--rw restart-timer?            uint32
    |  +--rw max-rate?              uint32
    |  +--rw max-number?            uint32
    |  +--rw instance-id?           uint64
    |  +--rw asn-plus-bgp-ls-ids?   uint32
    |  +--ro local-databases
    |     +--ro database* [vrf-name instance protocol-id area-id]
    |           ...
    +--rw link-state-spf
       +--rw prefix-limit
       |  +--rw max-prefixes?             uint32
       |  +--rw shutdown-threshold-pct?   rt-types:percentage
       |  +--rw restart-timer?            uint32
       +--rw instance-identifier?   uint64
       +--rw algorithm-type?        spf-algorithm-type
       +--rw node-status?           enumeration
       +--ro log
       |  +--ro event* [id]
       |        ...
       +--ro local-databases
          +--ro database* [vrf-name instance protocol-id area-id]
                ...
  augment /rt:routing/rt:control-plane-protocols
            /rt:control-plane-protocol/bgp:bgp/bgp:neighbors
            /bgp:neighbor/bgp:afi-safis/bgp:afi-safi:
    +--rw link-state!
    |  +--rw prefix-limit
    |  |  +--rw max-prefixes?             uint32
    |  |  +--rw shutdown-threshold-pct?   rt-types:percentage
    |  |  +--rw restart-timer?            uint32
    |  +--rw max-rate?              uint32
    |  +--rw max-number?            uint32
    |  +--rw instance-id?           uint64
    |  +--rw asn-plus-bgp-ls-ids?   uint32
    +--rw link-state-spf
       +--rw prefix-limit
       |  +--rw max-prefixes?             uint32
       |  +--rw shutdown-threshold-pct?   rt-types:percentage
       |  +--rw restart-timer?            uint32
       +--rw metric?         uint32
       +--rw status?         enumeration
  augment /rt:routing/rt:control-plane-protocols
            /rt:control-plane-protocol/bgp:bgp/bgp:global
            /bgp:afi-safis/bgp:afi-safi/bgp:statistics:
    +--ro updates-sent?          yang:zero-based-counter32
    +--ro updates-received?      yang:zero-based-counter32
    +--ro local-ls-originated?   yang:zero-based-counter32
  augment /rt:routing/rt:control-plane-protocols
            /rt:control-plane-protocol/bgp:bgp/bgp:global
            /bgp:afi-safis/bgp:afi-safi/bgp:statistics:
    +--ro scheduled?               yang:zero-based-counter64
    +--ro computed?                yang:zero-based-counter64
    +--ro maximum-duration?        uint64
    +--ro minimum-duration?        uint64
    +--ro average-duration?        uint64
    +--ro last-computation-time?   yang:date-and-time
  augment /rt:routing/rt:control-plane-protocols
            /rt:control-plane-protocol/bgp:bgp/bgp:neighbors
            /bgp:neighbor/bgp:statistics:
    +--rw updates-sent?             yang:zero-based-counter32
    +--rw updates-received?         yang:zero-based-counter32
    +--rw error-updates-received?   yang:zero-based-counter32
    +--rw computations?             yang:zero-based-counter32
    +--rw triggering-events?        yang:zero-based-counter32
  augment /rt:routing/rt:control-plane-protocols
            /rt:control-plane-protocol/bgp:bgp/bgp:peer-groups
            /bgp:peer-group/bgp:afi-safis/bgp:afi-safi:
    +--rw link-state!
    |  +--rw prefix-limit
    |  |  +--rw max-prefixes?             uint32
    |  |  +--rw shutdown-threshold-pct?   rt-types:percentage
    |  |  +--rw restart-timer?            uint32
    |  +--rw max-rate?              uint32
    |  +--rw max-number?            uint32
    |  +--rw instance-id?           uint64
    |  +--rw asn-plus-bgp-ls-ids?   uint32
    +--rw link-state-spf
       +--rw prefix-limit
       |  +--rw max-prefixes?             uint32
       |  +--rw shutdown-threshold-pct?   rt-types:percentage
       |  +--rw restart-timer?            uint32
       +--rw metric?         uint32
       +--rw status?         enumeration

]]></artwork>
      </figure>

    </section>
    <section>
      <name>YANG Models</name>
      <section>
	<name>BGP Link-State YANG model</name>
	<t>The YANG model augments the BGP model in <xref
	target="I-D.ietf-idr-bgp-model"> BGP Model for Service
	Provider Network</xref> to add extensions to BGP
	configuration. These extensions include the addition of three
	new Address Family Indicator (AFI) and Subsequent Address
	Family Indicator (SAFI) - BGP-LS, BGP-LS-VPN, and BGP-LS-SPF.
	</t>

	<t>The BGP model is augmented both at a global level to add
	statistics related to LS, and at a neighbor level to add
	support for the three new AFI/SAFI.
	</t>
      
	<t>The model imports <xref target="RFC6991">Common YANG Data
	Types </xref>, <xref target="RFC8349">A YANG Data Model for
	Routing Management(NMDA Version)</xref>, and <xref
	target="I-D.ietf-idr-bgp-model">BGP Model for Service
	Provider Network</xref>.</t>
      
	<figure>
          <name>YANG Model for BGP-LS, BGP-LS-VPN, BGP-LS-SPF</name>
          <artwork><![CDATA[
<CODE BEGINS> file "ietf-bgp-ls@2023-02-27.yang"
module ietf-bgp-ls {
  yang-version 1.1;
  namespace "urn:ietf:params:xml:ns:yang:ietf-bgp-ls";
  prefix bgp-ls;

  import ietf-yang-types {
    prefix yang;
    reference
      "RFC 6991: Common YANG Data Types.";
  }
  import ietf-routing {
    prefix rt;
    reference
      "RFC 8349, A YANG Data Model for Routing Management
       (NMDA Version).";
  }
  import ietf-bgp {
    prefix bgp;
    reference
      "I-D.ietf-idr-bgp-model: BGP YANG Model for Service Provider
                               Networks.";
  }
  import ietf-bgp-types {
    prefix bt;
    reference
      "I-D.ietf-idr-bgp-model: BGP YANG Model for Service Provider
                               Networks.";
  }
  import ietf-bgp-lsdb {
    prefix bgp-lsdb;
    reference
      "RFC XXXX: A YANG model for BGP-LS, BGP-LS-VPN, 
                 and BGP-LS-SPF.";
  }

  organization
    "IETF LSVR Working Group";
  contact
    "WG Web:   <http://tools.ietf.org/wg/lsvr>
     WG List:  <lsvr@ietf.org>

     Authors: Mahesh Jethanandani (mjethanandani at gmail.com),
              Keyur Patel (keyur at arrcus.com)";

  description
    "This module contains contains management
     information for BGP-LS database.

     Copyright (c) 2023 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
     (https://www.rfc-editor.org/info/rfcXXXX); see the RFC itself
     for full legal notices.

     The key words 'MUST', 'MUST NOT', 'REQUIRED', 'SHALL', 'SHALL
     NOT', 'SHOULD', 'SHOULD NOT', 'RECOMMENDED', 'NOT RECOMMENDED',
     'MAY', and 'OPTIONAL' in this document are to be interpreted as
     described in BCP 14 (RFC 2119) (RFC 8174) when, and only when,
     they appear in all capitals, as shown here.";

  revision 2023-02-27 {
    description
      "Initial Version";
    reference
      "RFC XXXX, BGP Model for Link State Distribution.";
  }

  // Identities.
  identity bgp-ls {
    base bt:afi-safi-type;
    description
      "BGP Link-State.";
    reference
      "RFC 7752: Link-State Info Distribution using BGP.";
  }

  identity bgp-ls-vpn {
    base bt:afi-safi-type;
    description
      "BGP Link-State VPN.";
    reference
      "RFC 7752: Link-State Info Distribution using BGP.";
  }

  identity bgp-ls-spf {
    base bt:afi-safi-type;
    description
      "BGP Link-State Shortest Path First (BGP-LS-SPF).";
    reference
      "I-D.ietf-lsvr-bgp-spf: BGP Link-State SPF Routing.";
  }

  // Typedefs
  typedef spf-algorithm-type {
    type enumeration {
      enum normal {
        description
          "Normal Shortest Path First (SPF) algorithm based on link 
           metric. This is the standard shortest path algorithm as 
           computed by the IGP protocol. Consistent with the
           deployed practice for link-state protocols, Algorithm 0
	   permits any node to overwrite the SPF path with a
	   different path based on its local policy.";
      }
      enum strict {
        description
          "Strict Shortest Path First (SPF) algorithm based on link
           metric. The algorithm is identical to Algorithm 0 but
           Algorithm 1 requires that all nodes along the path will
           honor the SPF routing decision. Local policy at the node
           claiming support for Algorithm 1 MUST NOT alter the SPF
           paths computed by Algorithm 1";
      }
      enum unknown {
        description
          "Unknown Algorithm";
      }
    }
    description
      "SPF algorithm type.";
  }
      
  // Groupings
  grouping bgp-neighbor-ls-common {
    description
      "Grouping for neighbor configuration for Link-State.";
    
      leaf metric {
        type uint32;
        default 10;
        description 
          "Metric associated with the corresponding link to 
           be used in the SPF graph computation.";
      }

      leaf status {
        type enumeration {
          enum reachable {
            description
              "The link is reachable in the current SPF topology.";
          }
          enum uncreachable {
            description
              "The link is unreachable in the current SPF topology.";
          }
        }
        default reachable;
        description 
          "Sets SPF-Status of the corresponding LS Link NLRI.";

      }
  }

  grouping bgp-mp-ls {
    description
      "Grouping for BGP-LS paramters.";

    container link-state {
      when "derived-from-or-self(../../bgp:afi-safi/bgp:name, " +
           "'bgp-ls')" {
	description
	  "Include this container for BGP Linkstate specific
           configuration";
      }
      presence
	"This container is for BGP Linkstate specific congfiguration.";
      
      description
        "Information related to Link-State configuration and
         management.";

      uses bgp:mp-all-afi-safi-common;

      leaf max-rate {
        type uint32;
        units per-second;
        default 200;
        description
          "Maximum rate at which Link-State NLRIs will be
           advertised or withdrawn from neighbors.";
        reference
          "RFC 7752: Link-State Info Distribution Using BGP.";
      }

      leaf max-number {
        type uint32;
        description
          "Maximim number of Link-State NLRIs stored in a router's
           RIB.";
        reference
          "RFC 7752: Link-State Info Distribution Using BGP.";
      }

      leaf instance-id {
        type uint64;
        description
          "64-bit Instance-ID.";
        reference
          "RFC 7752: Link-State Info Distribution Using BGP.";
      }

      leaf asn-plus-bgp-ls-ids {
        type uint32;
        description
          "A pair of ASN and BGP-LS identifiers per flooding set
           in which the node participates.";
        reference
          "RFC 7752: Link-State Info Distribution Using BGP.";
      }
    }
  }

  grouping bgp-mp-ls-spf {
    description
      "Grouping for BGP-LS-SPF parameters.";
    
    container link-state-spf {
      when "derived-from-or-self (../../bgp:afi-safi/bgp:name, " +
                                 "'bgp-ls-spf')" {
	description
	  "Include this container for BGP Link-State SPF specific
           configuration";
      }
      description "BGP Linkstate-SPF configuration options";

      uses bgp:mp-all-afi-safi-common;


    }
  }
	
  augment "/rt:routing/rt:control-plane-protocols" +
          "/rt:control-plane-protocol/bgp:bgp/bgp:global" +
          "/bgp:afi-safis/bgp:afi-safi" {
    description
      "Augmentation of the BGP model to add BGL-LS.";
    uses bgp-mp-ls;
    uses bgp-mp-ls-spf;
  }

  augment "/rt:routing/rt:control-plane-protocols" +
          "/rt:control-plane-protocol/bgp:bgp/bgp:global" +
          "/bgp:afi-safis/bgp:afi-safi/link-state" {
    description
      "Augmentation of BGL-LS to add dB.";
    uses bgp-lsdb:lsdb-top;
  }

  augment "/rt:routing/rt:control-plane-protocols" +
          "/rt:control-plane-protocol/bgp:bgp/bgp:global" +
          "/bgp:afi-safis/bgp:afi-safi/link-state-spf" {
    description
      "Augmentation of BGL-LS-SPF.";

    leaf instance-identifier {
      type uint64;
      default 0;
      description 
        "Instance Identifier to be used for all Link-State NLRI 
         advertisements originated locally";
    }

    leaf algorithm-type {
      type spf-algorithm-type;
      default normal;
      description 
        "SPF Algorithm type associated with Link-State AFI SAFI";
    }

    leaf node-status {
      type enumeration {
        enum reachable {
          description
            "The local node is reachable in the current SPF
	     topology.";
        }
        enum unreacable {
          description
            "The local node is unreachable in the current SPF
	     topology.";
        }
        enum no-transit-support {
          description
            "The local node is reachable but does not support
	     forwarding of transit traffic.";
        }
      }
      default reachable;
      description 
        "Sets SPF-Status of the local node.";
    }

    container log {
      config false;
      description
        "This container lists the SPF computation events.";
    
      list event {
        key id;
        description
          "List of computation events - implemented as a
           wrapping buffer.";

        leaf id {
          type uint32;
          description
            "Event identifier.";
        }

        leaf type {
          type enumeration {
            enum full {
              description "Full SPF computation.";
            }
            enum route-only {
              description
                "Route reachability only SPF computation";
            }
          }
          description "Type of SPF computation performed.";
        }

        leaf schedule-time {
          type yang:date-and-time;
          description
            "Time when the SPF computation was
             scheduled.";
        }

        leaf delay {
          type uint64;
          description
            "Delay in micro-seconds applied for this SPF event.";
        }

        leaf start-time {
          type yang:date-and-time;
          description
            "Time when the SPF computation started.";
        }

        leaf end-time {
          type yang:date-and-time;
          description
            "Time when the SPF computation ended.";
        }

        leaf duration {
          type uint64;
          description
            "Time taken in micro-seconds to execute the SPF
	     computations.";
        }

        leaf node-count {
          type uint64;
          description
            "Number of nodes involved in the SPF computations.";
        }

        leaf prefix-count {
          type uint64;
          description
            "Number of prefixes involved in the SPF computations.";
        }

        leaf route-download-count {
          type uint64;
          description
            "Number of routes updated in the SPF computations.";
        }

        list lsp-trigger {
          key "id";
          description
            "This list includes the LSPs that triggered the
             SPF computation.";

          leaf id {
            type uint32;
            description
              "Trigger identifier.";
          }

          leaf nlri-prefix {
            type string;
            description
              "Prefix of the NLRI triggering SPF computation.";
          }

          leaf nlri-sequence {
            type uint32;
            description
              "Sequence number of the NLRI triggering SPF
	       computation.";
          }

          leaf trigger-time {
            type yang:date-and-time;
            description
              "Time when the trigger event was recorded.";
          }
        }
      }
    }
    uses bgp-lsdb:lsdb-top;
  }

  augment "/rt:routing/rt:control-plane-protocols" +
          "/rt:control-plane-protocol/bgp:bgp/bgp:neighbors" +
          "/bgp:neighbor/bgp:afi-safis/bgp:afi-safi" {
    description
      "Augmentation of the BGP model to add BGL-LS.";
    uses bgp-mp-ls;
    uses bgp-mp-ls-spf;
  }

  augment "/rt:routing/rt:control-plane-protocols" +
          "/rt:control-plane-protocol/bgp:bgp/bgp:neighbors" +
          "/bgp:neighbor/bgp:afi-safis/bgp:afi-safi/link-state-spf" {
    description
      "Augmentation of the BGP neighbor to add BGL-LS.";
    uses bgp-neighbor-ls-common;
  }

  augment "/rt:routing/rt:control-plane-protocols" +
          "/rt:control-plane-protocol/bgp:bgp/bgp:global" +
          "/bgp:afi-safis/bgp:afi-safi/bgp:statistics" {
    when "derived-from-or-self (../bgp:name, 'bgp-ls')" {
      description
        "Include these for BGP Link-State specific statistics.";
    }
    description
      "Augmentation of the global statistics counter to add BGP-LS
       statistics.";

    leaf updates-sent {
      type yang:zero-based-counter32;
      description
        "Total number of Link-State NLRI updates sent.";
      reference
        "RFC 7752: Link-State Info Distribution Using BGP.";
    }

    leaf updates-received {
      type yang:zero-based-counter32;
      description
        "Total number of Link-State NLRI updates received.";
      reference
        "RFC 7752: Link-State Info Distribution Using BGP.";
    }

    leaf local-ls-originated {
      type yang:zero-based-counter32;
      description
        "Total number of locally originated Link-State NLRIs.";
      reference
        "RFC 7752: Link-State Info Distribution Using BGP.";
    }
  }

  augment "/rt:routing/rt:control-plane-protocols" +
          "/rt:control-plane-protocol/bgp:bgp/bgp:global" +
          "/bgp:afi-safis/bgp:afi-safi/bgp:statistics" {
    when "derived-from-or-self (../bgp:name, 'bgp-ls-spf')" {
      description
        "Include these for BGP Link-State SPF specific statistics.";
    }
    description
      "Augmentation of the global statistics counter to add BGP-LS-SPF
       statistics.";

    leaf scheduled {
      type yang:zero-based-counter64;
      description
        "Number of times SPF has been re/scheduled";
    }

    leaf computed {
      type yang:zero-based-counter64;
      description
        "Number of times SPF has been computed";
    }

    leaf maximum-duration {
      type uint64;
      units "microseconds";
      description
        "Maximum duration taken for SPF compuation in
         microseconds.";
    }

    leaf minimum-duration {
      type uint64;
      units "microseconds";
      description
        "Minimum duration taken for SPF compuation in
         microseconds.";
    }

    leaf average-duration {
      type uint64;
      units "microseconds";
      description
        "Average duration taken for SPF compuation in
         microseconds.";
    }

    leaf last-computation-time {
      type yang:date-and-time;
      description
        "Timestamp for last SPF computation for this
         address-family";
    }
  }

  augment "/rt:routing/rt:control-plane-protocols" +
          "/rt:control-plane-protocol/bgp:bgp/bgp:neighbors" +
          "/bgp:neighbor/bgp:statistics" {
    when "derived-from-or-self (../bgp:afi-safis/bgp:afi-safi" +
                               "/bgp:name, 'bgp-ls')" {
      description
        "Include these for BGP Link-State specific statistics.";
    }
    description
      "Augmentation of the BGP per-neighbor statistics to add
       BGP-LS specific counters.";

    leaf updates-sent {
      type yang:zero-based-counter32;
      description
        "Total number of Link-State NLRIs updates sent per neighbor.";
      reference
        "RFC 7752: Link-State Info Distribution Using BGP.";
    }

    leaf updates-received {
      type yang:zero-based-counter32;
      description
        "Total number of Link-State NLRIs updates received per
         neighbor.";
      reference
        "RFC 7752: Link-State Info Distribution Using BGP.";
    }

    leaf error-updates-received {
      type yang:zero-based-counter32;
      description
        "Total number of Link-State NLRIs updates received that
         were errored, per neighbor.";
      reference
        "RFC 7752: Link-State Info Distribution Using BGP.";
    }

    leaf computations {
      type yang:zero-based-counter32;
      description
        "Count of number of SPF computations made.";
      reference
        "I-D.ietf-lsvr-bgp-spf: BGP Link-State SPF Routing.";
    }

    leaf triggering-events {
      type yang:zero-based-counter32;
      description
        "SPF triggering events.";
      reference
        "I-D.ietf-lsvr-bgp-spf: BGP Link-State SPF Routing.";
    }
  }

  augment "/rt:routing/rt:control-plane-protocols" +
          "/rt:control-plane-protocol/bgp:bgp/bgp:peer-groups" +
          "/bgp:peer-group/bgp:afi-safis/bgp:afi-safi" {
    description
      "Augmentation of the BGP peer-group to add BGP-LS and
       BGP-LS-SPF.";

    uses bgp-mp-ls;
    uses bgp-mp-ls-spf;
  }

  augment "/rt:routing/rt:control-plane-protocols" +
          "/rt:control-plane-protocol/bgp:bgp/bgp:peer-groups" +
          "/bgp:peer-group/bgp:afi-safis/bgp:afi-safi/link-state-spf" {
    description
      "Augmentation of the BGP peer-groups to add BGL-LS.";
    uses bgp-neighbor-ls-common;
  }
}
<CODE ENDS>

]]></artwork>
        <!-- [CHECK] markers="true" means that the rendered file will have <CODE BEGINS> and <CODE ENDS> added -->
	</figure>
      </section>
      <section>
	<name>BGP Link-State Database YANG model</name>
	<t>The model imports <xref target="RFC6991">Common YANG Data
	Types </xref>
	</t>
	<figure>
          <name>YANG Model for Link-State Database</name>
          <artwork><![CDATA[
<CODE BEGINS> file "ietf-bgp-lsdb@2023-02-27.yang"
module ietf-bgp-lsdb {
  yang-version 1.1;
  namespace "urn:ietf:params:xml:ns:yang:ietf-bgp-lsdb";
  prefix bgp-lsdb;

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

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

  organization
    "IETF LSVR Working Group";
  contact
    "WG Web:   <http://tools.ietf.org/wg/lsvr>
     WG List:  <lsvr@ietf.org>

     Authors: Mahesh Jethanandani (mjethanandani at gmail.com),
              Keyur Patel (keyur at arrcus.com)";

  description
    "This module contains contains configuration and management
     information for BGP-LS, BGP-LS-SPF.

     Copyright (c) 2023 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
     (https://www.rfc-editor.org/info/rfcXXXX); see the RFC itself
     for full legal notices.

     The key words 'MUST', 'MUST NOT', 'REQUIRED', 'SHALL', 'SHALL
     NOT', 'SHOULD', 'SHOULD NOT', 'RECOMMENDED', 'NOT RECOMMENDED',
     'MAY', and 'OPTIONAL' in this document are to be interpreted as
     described in BCP 14 (RFC 2119) (RFC 8174) when, and only when,
     they appear in all capitals, as shown here.";

  revision 2023-02-27 {
    description
      "Initial Version";
    reference
      "RFC XXXX, BGP Model for Link State Distribution.";
  }

  // Typedefs
  typedef lsdb-proto-id-type {
    type enumeration {
      enum unknown {
        description "Unknown protocol.";
      }
      enum isis-level1 {
        description "IS-IS Level 1.";
      }
      enum isis-level2 {
        description "IS-IS Level 2.";
      }
      enum ospfv2 {
        description "OSPF Version 2.";
      }
      enum direct {
        description "Direct.";
      }
      enum static {
        description "Static";
      }
      enum ospfv3 {
        description "OSPF Version 3.";
      }
      enum bgp {
        description "BGP.";
      }
    }
    description
      "LS database proto id type.";
  }

  typedef lsdb-attr-type {
    type enumeration {
      enum unknown {
        description
        "Unknown attribute.";
      }
      enum node-pdu-auth-info {
        description
          "Node authentication information attribute.";
      }
      enum node-hostname {
        description
          "Node Hostname attribute.";
      } 
      enum node-flags {
        description
          "Node Flags attribute.";
      } 
      enum node-opaque {
        description
          "Node Opaque attribute.";
      } 
      enum node-as {
        description
          "Node AS Number attribute.";
      } 
      enum node-isis-node-id {
        description
          "Node ISIS Node-Id attribute.";
      } 
      enum node-ipv4-rtr-id {
        description
          "Node IPv4 Router-Id attribute.";
      } 
      enum node-ipv6-rtr-id {
        description
          "Node IPv6 Router-Id attribute.";
      } 
      enum node-sid-index {
        description
          "Node SID Index attribute.";
      } 
      enum node-topo-ids {
        description
          "Node Topology-IDs attribute.";
      } 
      enum node-isis-nlpid {
        description
          "Node NLPID attribute.";
      } 
      enum node-isis-area-id {
        description
          "Node ISIS Area-Id attribute.";
      } 
      enum node-ospf-area-id {
        description
          "Node OSPF Area-Id attribute.";
      } 
      enum node-admin-tag {
        description
          "Node Admin-Tags attribute.";
      } 
      enum node-srgb-range {
        description
          "Node SRGB Range attribute.";
      } 
      enum node-spf-status {
        description
          "Node SPF Status attribute.";
      } 
      enum node-spf-algorithm {
        description
          "Node SPF Algorithm Type attribute.";
      }
      enum link-name {
        description
          "Link Name attribute.";
      } 
      enum link-proto-id {
        description
          "Link Protocol-Id attribute.";
      } 
      enum link-local-id {
        description
          "Link Local-Id attribute.";
      } 
      enum link-remote-id {
        description
          "Node Remote-Id attribute.";
      } 
      enum link-local-isis-node-id {
        description
          "Link Local ISO Node-Id attribute.";
      } 
      enum link-remote-isis-node-id {
        description
          "Link Remote ISO Node-Id attribute.";
      } 
      enum link-local-ipv4-rtr-id {
        description
          "Link Local IPv4 Router-Id attribute.";
      } 
      enum link-remote-ipv4-rtr-id {
        description
          "Link Remote IPv4 Router-Id attribute.";
      } 
      enum link-local-ipv6-rtr-id {
        description
          "Link Local IPv6 Router-Id attribute.";
      } 
      enum link-remote-ipv6-rtr-id {
        description
          "Link Remote IPv6 Router-Id attribute.";
      } 
      enum link-circuit-id {
        description
          "Link Local Circuit-Id attribute.";
      } 
      enum link-igp-metric {
        description
          "Link IGP metric attribute.";
      } 
      enum link-mtu {
        description
          "Link MTU attribute.";
      } 
      enum link-max-bandwidth {
        description
          "Link Maximum Bandwidth attribute.";
      } 
      enum link-max-reserve-bandwidth {
        description
          "Link Maximum Reserved Bandwidth attribute.";
      } 
      enum link-unreserve-bandwidth {
        description
          "Link Unreserved Bandwidth attribute.";
      } 
      enum link-default-te-metric {
        description
          "Link TE-Default Metric attribute.";
      } 
      enum link-protection-type {
        description
          "Link Protection-Type attribute.";
      } 
      enum link-opaque {
        description
          "Link Opaque attribute.";
      } 
      enum link-mpls-proto-mask {
        description
          "Link MPLS-Protocol-Mask attribute.";
      } 
      enum lsdb-link-local-ipv4-addr {
        description
	  "Link Local IPv4 Address attribute.";
      } 
      enum lsdb-link-local-ipv6-addr {
        description
	  "Link Local IPv6 Address attribute.";
      } 
      enum lsdb-link-remote-ipv4-addr {
        description
	  "Link Remote IPv4 Address attribute.";
      } 
      enum lsdb-link-remote-ipv6-addr {
        description
	  "Link Remote IPv6 Address attribute.";
      } 
      enum lsdb-link-isis-level {
        description
	  "Link ISIS Level attribute.";
      } 
      enum lsdb-link-admin-tag {
        description
	  "Link Admin-Tag attribute.";
      } 
      enum lsdb-link-srlg {
        description
	  "Link SRLGs attribute.";
      } 
      enum lsdb-link-spf-status {
        description
	  "Link SPF Status attribute.";
      } 
      enum lsdb-prefix-igp-flags {
        description
	  "Prefix IGP-Flags attribute.";
      } 
      enum lsdb-prefix-metric {
        description
	  "Prefix Metric attribute.";
      } 
      enum lsdb-prefix-ospf-forwarding-address {
        description
	  "Prefix OSPF-Forwarding-Address attribute.";
      } 
      enum lsdb-prefix-ospf-route-type {
        description
	  "Prefix OSPF-Route-Type attribute.";
      } 
      enum lsdb-prefix-opaque {
        description
	  "Prefix Opaque attribute.";
      } 
      enum lsdb-prefix-route-tags {
        description
	  "Prefix Route-Tags attribute.";
      } 
      enum lsdb-prefix-ext-route-tags {
        description
	  "Prefix Extended-Route-Tags attribute.";
      } 
      enum lsdb-prefix-spf-status {
        description
	  "Prefix SPF Status attribute.";
      } 
    }
    description
      "Link-State database attribute type.";
  }

  typedef lsdb-obj-type {
    type enumeration {
      enum lsdb-unknown-obj {
        description
	  "Unknown attribute.";
      }
      enum lsdb-node-obj {
        description
	  "Node Object.";
      }
      enum lsdb-link-obj {
        description
	  "Link object.";
      } 
      enum lsdb-prefix-obj {
        description
	  "Prefix object.";
      }
    }
    description
      "Link-State database object type.";
  }

  // Groupings
  grouping lsdb-obj-common {
    description "Common details for all object types.";
  
    leaf handle {
      type uint64;
      description "Handle of the object."; 
    }
  
    leaf type {
      type lsdb-obj-type;
      description "Type of object."; 
    }
  
    leaf topology-id {
      type uint16;
      description "Id of the topology object belongs to."; 
    }
  
    leaf pdu-id {
      type uint32;
      description
        "Id of the original protocol PDU unit this object belongs
         to."; 
    }

    container attributes {
      description
	"List of attributes for a given object.";

      list attribute {
        key "attribute-handle attribute-type";

        leaf attribute-handle {
          type uint64;
          description
	    "Handle of the attribute."; 
        }

        leaf attribute-type {
          type lsdb-attr-type;
          description
	    "Type of attribute."; 
        }

        leaf attribute-length {
          type uint16;
          description
	    "Length of attribute value in bytes.";
        }

        leaf attribute-value {
          type union {
            type uint8;
            type uint16;
            type uint32;
            type uint64;
            type boolean;
            type string;
            type inet:ip-address;
            type yang:hex-string;
          }
          description
	    "Actual value of the attribute.";
        }
        description
	  "Details of a single attribute.";
      }
    }
  }

  grouping lsdb-top {
    description
      "Details for all databases under an application instance.";

    container local-databases {
      config false;
      description
        "List of local databases.";

      list database {
        key "vrf-name instance protocol-id area-id";

        description
	  "Operational state for a given database.";

        leaf vrf-name {
          type string;
          description
            "Name of the VRF this database belongs to.";
        }

        leaf instance {
          type string;
          description
            "Name of the application instance this database belongs
             to.";
        }

        leaf protocol-id {
          type lsdb-proto-id-type;
          description
            "Id of the aplication protocol this database belongs
             to.";
        }

        leaf area-id {
          type uint32;
          description
            "Id of the protocol area this database belongs to.";
        }

        container nodes {
          description
            "List of node objects for a given database.";

          list node {
            key "handle";

            leaf node-id {
              type string;
              description 
                "Id of the node object."; 
            }
  
            uses lsdb-obj-common;
            container links {
              description
                "List of link objects for a given node object.";

              list link {
                key "handle";

                leaf local-id {
		  type uint32;
		  description
		    "Local identifier of the link object."; 
		}

                leaf local-address {
		  type string;
		  description
		    "Local address of the link object."; 
		}

                leaf local-node-id {
		  type uint32;
		  description
		    "Local Node identifier of the link object."; 
		}

                leaf remote-id {
		  type uint32;
		  description
		    "Remote identifier of the link object."; 
		}

                leaf remote-address {
		  type string;
		  description
		    "Remote address of the link object."; 
		}

                leaf remote-node-id {
		  type uint32;
		  description
		    "Remote Node identifier of the link object."; 
		}
  
                uses lsdb-obj-common;
                description
                  "Details of a single link object.";
              }
            }
  
            container prefixes {
              description
                "List of prefix objects for a given node object.";

              list prefix {
                key "handle";

		leaf prefix-key {
		  type string;
		  description
		    "Key value for the prefix object."; 
		}
  
		uses lsdb-obj-common;
                description
		  "Details of a single prefix object.";
              }
            }
            description
              "Details of a single node object.";
          }
        }
      }
    }
  }
}
<CODE ENDS>

]]></artwork>
        <!-- [CHECK] markers="true" means that the rendered file will have <CODE BEGINS> and <CODE ENDS> added -->
	</figure>
      </section>
    </section>
    
    <section anchor="IANA">
      <name>IANA Considerations</name>

      <t>This memo registers the following namespace URIs in the IETF
      XML in the "IETF XML Registry" <xref target="RFC3688"
      format="default" sectionFormat="of"
      derivedContent="RFC3688"/>:</t>

      <dl newline="false" spacing="compact" indent="3">
        <dt>URI:</dt>
        <dd>urn:ietf:params:xml:ns:yang:ietf-bgp-ls</dd>
        <dt>Registrant Contact:</dt>
        <dd>The IESG.</dd>
        <dt>XML:</dt>
        <dd>N/A; the requested URI is an XML namespace.</dd>
      </dl>
      <dl newline="false" spacing="compact" indent="3">
        <dt>URI:</dt>
        <dd>urn:ietf:params:xml:ns:yang:ietf-bgp-lsdb</dd>
        <dt>Registrant Contact:</dt>
        <dd>The IESG.</dd>
        <dt>XML:</dt>
        <dd>N/A; the requested URI is an XML namespace.</dd>
      </dl>

      <t indent="0">This document registers the following YANG
      modules in the "YANG Module Names" registry
      <xref target="RFC6020" format="default" sectionFormat="of"
      derivedContent="RFC6020"/>:</t>

      <dl newline="false" spacing="compact" indent="3">
        <dt>Name:</dt>
        <dd>ietf-bgp-ls</dd>
        <dt>Namespace:</dt>
        <dd>urn:ietf:params:xml:ns:yang:ietf-bgp-ls</dd>
        <dt>Prefix:</dt>
        <dd>bgp-ls</dd>
        <dt>Reference:</dt>
        <dd>RFC XXXX</dd>
      </dl>
      <dl newline="false" spacing="compact" indent="3">
        <dt>Name:</dt>
        <dd>ietf-bgp-lsdb</dd>
        <dt>Namespace:</dt>
        <dd>urn:ietf:params:xml:ns:yang:ietf-bgp-lsdb</dd>
        <dt>Prefix:</dt>
        <dd>bgp-lsdb</dd>
        <dt>Reference:</dt>
        <dd>RFC XXXX</dd>
      </dl>
    </section>
    
    <section anchor="Security">
      <!-- All drafts are required to have a security considerations section. See RFC 3552 for a guide. -->
      <name>Security Considerations</name>
      <t>The YANG module specified in this document defines a schema
      for data that is designed to be accessed via network management
      protocols such as <xref target="RFC6241">NETCONF</xref> or <xref
      target="RFC8040">RESTCONF</xref>. The lowest NETCONF layer is
      the secure transport layer, and the mandatory-to-implement
      secure transport is <xref target="RFC6242">Secure Shell
      (SSH)</xref>. The lowest RESTCONF layer is HTTPS, and the
      mandatory-to-implement secure transport is <xref
      target="RFC8446">TLS</xref>.</t>

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

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

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

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

    </section>
    
    <!-- NOTE: The Acknowledgements and Contributors sections are at the end of this template -->
  </middle>

  <back>
    <references>
      <name>References</name>
      <references>
        <name>Normative References</name>
        
        <xi:include href="https://www.rfc-editor.org/refs/bibxml/reference.RFC.2119.xml"/>
        <xi:include href="https://www.rfc-editor.org/refs/bibxml/reference.RFC.3688.xml"/>
        <xi:include href="https://www.rfc-editor.org/refs/bibxml/reference.RFC.6020.xml"/>
        <xi:include href="https://www.rfc-editor.org/refs/bibxml/reference.RFC.6241.xml"/>
        <xi:include href="https://www.rfc-editor.org/refs/bibxml/reference.RFC.6242.xml"/>
        <xi:include href="https://www.rfc-editor.org/refs/bibxml/reference.RFC.6991.xml"/>
        <xi:include href="https://www.rfc-editor.org/refs/bibxml/reference.RFC.7752.xml"/>
        <xi:include href="https://www.rfc-editor.org/refs/bibxml/reference.RFC.7950.xml"/>
        <xi:include href="https://www.rfc-editor.org/refs/bibxml/reference.RFC.8040.xml"/>
        <xi:include href="https://www.rfc-editor.org/refs/bibxml/reference.RFC.8174.xml"/>
        <xi:include href="https://www.rfc-editor.org/refs/bibxml/reference.RFC.8340.xml"/>
        <xi:include href="https://www.rfc-editor.org/refs/bibxml/reference.RFC.8341.xml"/>
        <xi:include href="https://www.rfc-editor.org/refs/bibxml/reference.RFC.8342.xml"/>
        <xi:include href="https://www.rfc-editor.org/refs/bibxml/reference.RFC.8349.xml"/>
        <xi:include href="https://www.rfc-editor.org/refs/bibxml/reference.RFC.8446.xml"/>
	<?rfc include='reference.I-D.ietf-idr-bgp-model.xml'?>
	<?rfc include='reference.I-D.ietf-lsvr-bgp-spf.xml'?>
      </references>
 
      <references>
        <name>Informative References</name>
      </references>
    </references>
    
    <section>
      <name>Complete Tree Diagram</name>
      <t>Here is a complete tree diagram for the configuration and
      operational part of the model.</t>
      <figure>
	<name>Complete tree diagram</name>
        <artwork><![CDATA[
module: ietf-bgp-ls

  augment /rt:routing/rt:control-plane-protocols
            /rt:control-plane-protocol/bgp:bgp/bgp:global
            /bgp:afi-safis/bgp:afi-safi:
    +--rw link-state!
    |  +--rw prefix-limit
    |  |  +--rw max-prefixes?             uint32
    |  |  +--rw shutdown-threshold-pct?   rt-types:percentage
    |  |  +--rw restart-timer?            uint32
    |  +--rw max-rate?              uint32
    |  +--rw max-number?            uint32
    |  +--rw instance-id?           uint64
    |  +--rw asn-plus-bgp-ls-ids?   uint32
    |  +--ro local-databases
    |     +--ro database* [vrf-name instance protocol-id area-id]
    |        +--ro vrf-name       string
    |        +--ro instance       string
    |        +--ro protocol-id    lsdb-proto-id-type
    |        +--ro area-id        uint32
    |        +--ro nodes
    |           +--ro node* [handle]
    |              +--ro node-id?       string
    |              +--ro handle         uint64
    |              +--ro type?          lsdb-obj-type
    |              +--ro topology-id?   uint16
    |              +--ro pdu-id?        uint32
    |              +--ro attributes
    |              |  +--ro attribute*
    |              |          [attribute-handle attribute-type]
    |              |     +--ro attribute-handle    uint64
    |              |     +--ro attribute-type      lsdb-attr-type
    |              |     +--ro attribute-length?   uint16
    |              |     +--ro attribute-value?    union
    |              +--ro links
    |              |  +--ro link* [handle]
    |              |     +--ro local-id?         uint32
    |              |     +--ro local-address?    string
    |              |     +--ro local-node-id?    uint32
    |              |     +--ro remote-id?        uint32
    |              |     +--ro remote-address?   string
    |              |     +--ro remote-node-id?   uint32
    |              |     +--ro handle            uint64
    |              |     +--ro type?             lsdb-obj-type
    |              |     +--ro topology-id?      uint16
    |              |     +--ro pdu-id?           uint32
    |              |     +--ro attributes
    |              |        +--ro attribute*
    |              |                [attribute-handle attribute-type]
    |              |           +--ro attribute-handle    uint64
    |              |           +--ro attribute-type
    |              |           |       lsdb-attr-type
    |              |           +--ro attribute-length?   uint16
    |              |           +--ro attribute-value?    union
    |              +--ro prefixes
    |                 +--ro prefix* [handle]
    |                    +--ro prefix-key?    string
    |                    +--ro handle         uint64
    |                    +--ro type?          lsdb-obj-type
    |                    +--ro topology-id?   uint16
    |                    +--ro pdu-id?        uint32
    |                    +--ro attributes
    |                       +--ro attribute*
    |                               [attribute-handle attribute-type]
    |                          +--ro attribute-handle    uint64
    |                          +--ro attribute-type
    |                          |       lsdb-attr-type
    |                          +--ro attribute-length?   uint16
    |                          +--ro attribute-value?    union
    +--rw link-state-spf
       +--rw prefix-limit
       |  +--rw max-prefixes?             uint32
       |  +--rw shutdown-threshold-pct?   rt-types:percentage
       |  +--rw restart-timer?            uint32
       +--rw instance-identifier?   uint64
       +--rw algorithm-type?        spf-algorithm-type
       +--rw node-status?           enumeration
       +--ro log
       |  +--ro event* [id]
       |     +--ro id                      uint32
       |     +--ro type?                   enumeration
       |     +--ro schedule-time?          yang:date-and-time
       |     +--ro delay?                  uint64
       |     +--ro start-time?             yang:date-and-time
       |     +--ro end-time?               yang:date-and-time
       |     +--ro duration?               uint64
       |     +--ro node-count?             uint64
       |     +--ro prefix-count?           uint64
       |     +--ro route-download-count?   uint64
       |     +--ro lsp-trigger* [id]
       |        +--ro id               uint32
       |        +--ro nlri-prefix?     string
       |        +--ro nlri-sequence?   uint32
       |        +--ro trigger-time?    yang:date-and-time
       +--ro local-databases
          +--ro database* [vrf-name instance protocol-id area-id]
             +--ro vrf-name       string
             +--ro instance       string
             +--ro protocol-id    lsdb-proto-id-type
             +--ro area-id        uint32
             +--ro nodes
                +--ro node* [handle]
                   +--ro node-id?       string
                   +--ro handle         uint64
                   +--ro type?          lsdb-obj-type
                   +--ro topology-id?   uint16
                   +--ro pdu-id?        uint32
                   +--ro attributes
                   |  +--ro attribute*
                   |          [attribute-handle attribute-type]
                   |     +--ro attribute-handle    uint64
                   |     +--ro attribute-type      lsdb-attr-type
                   |     +--ro attribute-length?   uint16
                   |     +--ro attribute-value?    union
                   +--ro links
                   |  +--ro link* [handle]
                   |     +--ro local-id?         uint32
                   |     +--ro local-address?    string
                   |     +--ro local-node-id?    uint32
                   |     +--ro remote-id?        uint32
                   |     +--ro remote-address?   string
                   |     +--ro remote-node-id?   uint32
                   |     +--ro handle            uint64
                   |     +--ro type?             lsdb-obj-type
                   |     +--ro topology-id?      uint16
                   |     +--ro pdu-id?           uint32
                   |     +--ro attributes
                   |        +--ro attribute*
                   |                [attribute-handle attribute-type]
                   |           +--ro attribute-handle    uint64
                   |           +--ro attribute-type
                   |           |       lsdb-attr-type
                   |           +--ro attribute-length?   uint16
                   |           +--ro attribute-value?    union
                   +--ro prefixes
                      +--ro prefix* [handle]
                         +--ro prefix-key?    string
                         +--ro handle         uint64
                         +--ro type?          lsdb-obj-type
                         +--ro topology-id?   uint16
                         +--ro pdu-id?        uint32
                         +--ro attributes
                            +--ro attribute*
                                    [attribute-handle attribute-type]
                               +--ro attribute-handle    uint64
                               +--ro attribute-type
                               |       lsdb-attr-type
                               +--ro attribute-length?   uint16
                               +--ro attribute-value?    union
  augment /rt:routing/rt:control-plane-protocols
            /rt:control-plane-protocol/bgp:bgp/bgp:neighbors
            /bgp:neighbor/bgp:afi-safis/bgp:afi-safi:
    +--rw link-state!
    |  +--rw prefix-limit
    |  |  +--rw max-prefixes?             uint32
    |  |  +--rw shutdown-threshold-pct?   rt-types:percentage
    |  |  +--rw restart-timer?            uint32
    |  +--rw max-rate?              uint32
    |  +--rw max-number?            uint32
    |  +--rw instance-id?           uint64
    |  +--rw asn-plus-bgp-ls-ids?   uint32
    +--rw link-state-spf
       +--rw prefix-limit
       |  +--rw max-prefixes?             uint32
       |  +--rw shutdown-threshold-pct?   rt-types:percentage
       |  +--rw restart-timer?            uint32
       +--rw metric?         uint32
       +--rw status?         enumeration
  augment /rt:routing/rt:control-plane-protocols
            /rt:control-plane-protocol/bgp:bgp/bgp:global
            /bgp:afi-safis/bgp:afi-safi/bgp:statistics:
    +--ro updates-sent?          yang:zero-based-counter32
    +--ro updates-received?      yang:zero-based-counter32
    +--ro local-ls-originated?   yang:zero-based-counter32
  augment /rt:routing/rt:control-plane-protocols
            /rt:control-plane-protocol/bgp:bgp/bgp:global
            /bgp:afi-safis/bgp:afi-safi/bgp:statistics:
    +--ro scheduled?               yang:zero-based-counter64
    +--ro computed?                yang:zero-based-counter64
    +--ro maximum-duration?        uint64
    +--ro minimum-duration?        uint64
    +--ro average-duration?        uint64
    +--ro last-computation-time?   yang:date-and-time
  augment /rt:routing/rt:control-plane-protocols
            /rt:control-plane-protocol/bgp:bgp/bgp:neighbors
            /bgp:neighbor/bgp:statistics:
    +--rw updates-sent?             yang:zero-based-counter32
    +--rw updates-received?         yang:zero-based-counter32
    +--rw error-updates-received?   yang:zero-based-counter32
    +--rw computations?             yang:zero-based-counter32
    +--rw triggering-events?        yang:zero-based-counter32
  augment /rt:routing/rt:control-plane-protocols
            /rt:control-plane-protocol/bgp:bgp/bgp:peer-groups
            /bgp:peer-group/bgp:afi-safis/bgp:afi-safi:
    +--rw link-state!
    |  +--rw prefix-limit
    |  |  +--rw max-prefixes?             uint32
    |  |  +--rw shutdown-threshold-pct?   rt-types:percentage
    |  |  +--rw restart-timer?            uint32
    |  +--rw max-rate?              uint32
    |  +--rw max-number?            uint32
    |  +--rw instance-id?           uint64
    |  +--rw asn-plus-bgp-ls-ids?   uint32
    +--rw link-state-spf
       +--rw prefix-limit
       |  +--rw max-prefixes?             uint32
       |  +--rw shutdown-threshold-pct?   rt-types:percentage
       |  +--rw restart-timer?            uint32
       +--rw metric?         uint32
       +--rw status?         enumeration

]]></artwork>
      </figure>
    </section>

    <section anchor="Acknowledgements" numbered="false">
      <name>Acknowledgements</name>
      <t>TBA</t>
    </section>
    
    <section anchor="Contributors" numbered="false">
      <!-- [REPLACE/DELETE] a Contributors section is optional -->
      <name>Contributors</name>
      <t>Thanks to all of the contributors.</t>
      <!-- [CHECK] it is optional to add a <contact> record for some or all contributors -->
    </section>
    
 </back>
</rfc>
