Skip to main content

YANG Data Model for MPLS mLDP
draft-ietf-mpls-mldp-yang-04

The information below is for an old version of the document.
Document Type
This is an older version of an Internet-Draft whose latest revision state is "Active".
Authors Syed Kamran Raza , Sowmya Krishnaswamy , Xufeng Liu , Santosh Esale , Loa Andersson , Jeff Tantsura
Last updated 2018-07-16
Replaces draft-ietf-mpls-ldp-mldp-yang
RFC stream Internet Engineering Task Force (IETF)
Formats
Reviews
Additional resources Mailing list discussion
Stream WG state WG Document
Document shepherd (None)
IESG IESG state I-D Exists
Consensus boilerplate Unknown
Telechat date (None)
Responsible AD (None)
Send notices to (None)
draft-ietf-mpls-mldp-yang-04
MPLS Working Group                                               K. Raza
Internet-Draft                                           S. Krishnaswamy
Intended status: Standards Track                     Cisco Systems, Inc.
Expires: January 17, 2019                            
                                                                  X. Liu
                                                          Volta Networks
                                                          
                                                                S. Esale
                                                        Juniper Networks
                                                        
                                                            L. Andersson
                                                     Huawei Technologies

                                                             J. Tantsura
                                                          Nuage Networks

                                                           July 16, 2018

                     YANG Data Model for MPLS mLDP
                      draft-ietf-mpls-mldp-yang-04

Abstract

   This document describes a YANG data model for Multi-Protocol Label
   Switching (MPLS) Multipoint Label Distribution Protocol (mLDP).  The
   mLDP data model augments the LDP data model.

Status of This Memo

   This Internet-Draft is submitted in full conformance with the
   provisions of BCP 78 and BCP 79.

   Internet-Drafts are working documents of the Internet Engineering
   Task Force (IETF).  Note that other groups may also distribute
   working documents as Internet-Drafts.  The list of current Internet-
   Drafts is at https://datatracker.ietf.org/drafts/current/.

   Internet-Drafts are draft documents valid for a maximum of six months
   and may be updated, replaced, or obsoleted by other documents at any
   time.  It is inappropriate to use Internet-Drafts as reference
   material or to cite them other than as "work in progress."

   This Internet-Draft will expire on January 17, 2019.

Raza, et al.            Expires January 17, 2019                [Page 1]
Internet-Draft        YANG Data Model for MPLS mLDP            July 2018

Copyright Notice

   Copyright (c) 2018 IETF Trust and the persons identified as the
   document authors.  All rights reserved.

   This document is subject to BCP 78 and the IETF Trust's Legal
   Provisions Relating to IETF Documents
   (https://trustee.ietf.org/license-info) in effect on the date of
   publication of this document.  Please review these documents
   carefully, as they describe your rights and restrictions with respect
   to this document.  Code Components extracted from this document must
   include Simplified BSD License text as described in Section 4.e of
   the Trust Legal Provisions and are provided without warranty as
   described in the Simplified BSD License.

Table of Contents

   1.  Introduction  . . . . . . . . . . . . . . . . . . . . . . . .   3
     1.1.  Base and Extended . . . . . . . . . . . . . . . . . . . .   3
   2.  Specification of Requirements . . . . . . . . . . . . . . . .   4
   3.  Overview  . . . . . . . . . . . . . . . . . . . . . . . . . .   4
     3.1.  Scope . . . . . . . . . . . . . . . . . . . . . . . . . .   5
     3.2.  FEC Types . . . . . . . . . . . . . . . . . . . . . . . .   6
   4.  Configuration . . . . . . . . . . . . . . . . . . . . . . . .   7
     4.1.  Configuration Hierarchy . . . . . . . . . . . . . . . . .   7
     4.2.  mldp global container . . . . . . . . . . . . . . . . . .   8
     4.3.  Leveraging LDP containers . . . . . . . . . . . . . . . .   9
     4.4.  Configuration Tree  . . . . . . . . . . . . . . . . . . .   9
       4.4.1.  Base  . . . . . . . . . . . . . . . . . . . . . . . .   9
       4.4.2.  Extended  . . . . . . . . . . . . . . . . . . . . . .  10
   5.  Operational State . . . . . . . . . . . . . . . . . . . . . .  12
     5.1.  Base  . . . . . . . . . . . . . . . . . . . . . . . . . .  12
     5.2.  Extended  . . . . . . . . . . . . . . . . . . . . . . . .  13
     5.3.  Derived states  . . . . . . . . . . . . . . . . . . . . .  16
       5.3.1.  Root state  . . . . . . . . . . . . . . . . . . . . .  16
       5.3.2.  Bindings state  . . . . . . . . . . . . . . . . . . .  17
       5.3.3.  Capabilities state  . . . . . . . . . . . . . . . . .  20
   6.  Notifications . . . . . . . . . . . . . . . . . . . . . . . .  20
     6.1.  Base  . . . . . . . . . . . . . . . . . . . . . . . . . .  20
     6.2.  Extended  . . . . . . . . . . . . . . . . . . . . . . . .  21
   7.  Actions . . . . . . . . . . . . . . . . . . . . . . . . . . .  22
   8.  Open Items  . . . . . . . . . . . . . . . . . . . . . . . . .  22
   9.  YANG Specification  . . . . . . . . . . . . . . . . . . . . .  23
     9.1.  Base  . . . . . . . . . . . . . . . . . . . . . . . . . .  23
     9.2.  Extended  . . . . . . . . . . . . . . . . . . . . . . . .  32
   10. Security Considerations . . . . . . . . . . . . . . . . . . .  55
   11. IANA Considerations . . . . . . . . . . . . . . . . . . . . .  55
   12. Acknowledgments . . . . . . . . . . . . . . . . . . . . . . .  55

Raza, et al.            Expires January 17, 2019                [Page 2]
Internet-Draft        YANG Data Model for MPLS mLDP            July 2018

   13. Normative References  . . . . . . . . . . . . . . . . . . . .  55
   Appendix A.  Additional Contributors  . . . . . . . . . . . . . .  57
   Authors' Addresses  . . . . . . . . . . . . . . . . . . . . . . .  57

1.  Introduction

   This document introduces a YANG data model for MPLS Multipoint Label
   Distribution Protocol (mLDP).  The mLDP model being defined here is
   dependent on LDP YANG data model [I-D.ietf-mpls-ldp-yang].  This
   implies that an opertor will need to use base LDP module to configure
   and manage control plane for mLDP.  For example, an operator would
   enable LDP discovery on MPLS interface to establish LDP/mLDP peering
   on which mLDP bindings could be exchanged.  Similarly, an operator
   could query state information for an LDP peer in order to verify
   peering attributes etc.

   Moreover, it is important to note here that any assumptions made in
   the LDP model also hold true in this document, unless otherwise
   explicitly stated.

   Like its parent LDP data model, this mLDP model also defines the
   following constructs for managing the mLDP protocol:

   o  Configuration

   o  Operational State

   o  Executables (Actions)

   o  Notifications

   The modeling in this document complies with the Network Management
   Datastore Architecture (NMDA) [RFC8342].  The operational state data
   is combined with the associated configuration data in the same
   hierarchy [I-D.ietf-netmod-rfc6087bis].  When protocol states are
   retrieved from the NMDA operational state datastore, the returned
   states cover all "config true" (rw) and "config false" (ro) nodes
   defined in the schema.

   This document is organized to define the data model for each of the
   above constructs in the sequence as listed above.

1.1.  Base and Extended

   Like LDP model, the configuration and state items are divided into
   following two broad categories:

   o  Base

Raza, et al.            Expires January 17, 2019                [Page 3]
Internet-Draft        YANG Data Model for MPLS mLDP            July 2018

   o  Extended

   The "base" category contains the basic and fundamental features that
   are covered in mLDP base specification [RFC6388] alongwith few
   significant extension like targeted mLDP [RFC7060], constituting the
   minumum requirements for an mLDP deployment.  Whereas, the "extended"
   category contains all other non-base features (such as recursive FEC
   support, protection etc.).  All the items in a base category are
   mandatory and hence no "if-feature" is allowed under the "base"
   category.  While "base" model support will suffice for small
   deployments, large deployments will require not only the "base"
   module support but also "extended" support for some selected and
   required features.

   The base and extended catogories are defined in their own modules
   ietf-mpls-mldp and ietf-mpls-mldp-extended respectively, each of
   which augments the LDP base model as defined under ietf-mpls-ldp
   module [I-D.ietf-mpls-ldp-yang].

   Like LDP, mLDP "base" model configuration and state covers ipv4
   address-family only, with ipv6 address-family related configuration
   and state be covered in "extended" model.

2.  Specification of Requirements

   The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
   "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this
   document are to be interpreted as described in [RFC2119].

3.  Overview

   This document defines a new module named "ietf-mpls-mldp" for mLDP
   YANG base data model that augments /rt:routing/rt:control-plane-
   protocols/ldp:mpls-ldp defined in [I-D.ietf-mpls-ldp-yang].  The
   document also defines "ietf-mpls-mldp-extended" module that models
   the extended mLDP features under YANG.

   Following diagram depicts high level mLDP yang tree organization and
   hierarchy with respect to LDP:

Raza, et al.            Expires January 17, 2019                [Page 4]
Internet-Draft        YANG Data Model for MPLS mLDP            July 2018

            +-- rw routing
              +-- rw control-plane-protocols
                 +-- rw mpls-ldp
                     +-- rw some_ldp_container
                     |   +-- rw mldp
                     |       +-- rw ...                 // mldp base
                     |       |   +-- rw ...
                     |       |   +-- ro ...
                     |       |   +--
                     |       +-- rw mldp-ext:...        // mldp extended
                     |       |   +-- rw ...
                     |       |   +-- ro ...
                     |       |   +--
                     +-- ro some_ldp_container
                         +-- ro mldp
                             +-- ro ...                 // mldp base
                             |   +-- ro ...
                             |   +--
                             +-- ro mldp-ext:...        // mldp extended
                                 +-- ro ...
                                 +--

       notifications:
          +--- n mpls-mldp-some_event
          +--- n ...

                                 Figure 1

3.1.  Scope

   Following are the main mLDP areas and features that are within the
   scope of this model:

   o  Base:

      *  mLDP Base Specification [RFC6388]

      *  Targeted mLDP [RFC7060]

      *  Configured Leaf LSPs (manually provisioned)

   o  Extended:

      *  mLDP Recursive FEC [RFC6512]

      *  mLDP Fast-Reroute (FRR):

Raza, et al.            Expires January 17, 2019                [Page 5]
Internet-Draft        YANG Data Model for MPLS mLDP            July 2018

         +  Node Protection [RFC7715]

         +  Multicast-only

      *  In-band Signaling:

         +  mLDP In-band Signaling [RFC6826]

         +  mLDP In-band signaling in a VRF [RFC7246]

         +  mLDP In-band Signaling with Wildcards [RFC7438]

      *  Hub-and-Spoke Multipoint LSPs [RFC7140]

   [Ed Note: Some of the topics in the above list are to be addressed/
   extended in a later revision of this document].

3.2.  FEC Types

   The FEC for Multipoint LSP is presented as (root-address, opaque-
   type).  The following is the table for various type of MP opaque
   values with their keys, as covered in the configuration and state
   model:

       +-------------------------+--------------------+------------+
       | Opaque Type             | Key                | RFC        |
       +-------------------------+--------------------+------------+
       | Generic LSP Identifier  | LSP Id             | [RFC6388]  |
       | Transit IPv4 Source     | Source, Group      | [RFC6826]  |
       | Transit IPv6 Source     | Source, Group      | [RFC6826]  |
       | Transit IPv4 Bidir      | RP, Group          | [RFC6826]  |
       | Transit IPv6 Bidir      | RP, Group          | [RFC6826]  |
       | Transit VPNv4 Source    | Source, Group, RD  | [RFC7246]  |
       | Transit VPNv6 Source    | Source, Group, RD  | [RFC7246]  |
       | Transit VPNv4 Bidir     | RP, Group, RD      | [RFC7246]  |
       | Transit VPNv6 Bidir     | RP, Group, RD      | [RFC7246]  |
       | Recursive Opaque        | Root               | [RFC6512]  |
       | VPN-Recursive Opaque    | Root, RD           | [RFC6512]  |
       +-------------------------+--------------------+------------+

                     Table 1: MP Opaque Types and keys

   It is to be noted that there are three basic types (LSP Id, Source,
   and Bidir) and then there are variants (VPN, recursive, VPN-
   recursive) on top of these basic types.

Raza, et al.            Expires January 17, 2019                [Page 6]
Internet-Draft        YANG Data Model for MPLS mLDP            July 2018

   The "base" model includes only the "Generic LSP Identifier" opaque
   type (for ipv4), while rest of the above types are covered by the
   "extended" model.

4.  Configuration

4.1.  Configuration Hierarchy

   Following is the high-level configuration organization for base and
   extended mLDP:

        augment /rt:routing/rt:control-plane-protocols/rt:control-plane-protocol:
              +-- mpls-ldp
                  +-- global
                       +-- ...
                       +-- ...
                       +-- mldp
                       |   +-- ...
                       |   +-- ...
                       |   +-- address-families
                       |       +-- ipv4
                       |       |   +-- ...
                       |       |   +-- mldp-ext: ...
                       |       |   +-- ...
                       |       |   +-- configured-leaf-lsps
                       |       |       +-- ...
                       |       |       +-- ...
                       |       |       +-- mldp-ext: ...
                       |       |       +-- ...
                       |       +-- mldp-ext: ipv6
                       |           +-- ...
                       |           +-- ...
                       |           +-- configured-leaf-lsps
                       |               +-- ...
                       |               +-- ...
                       +-- capability
                       |   +-- mldp
                       |       +-- ...
                       |       +-- mldp-ext: ...
                       |       +-- ...
                       +-- forwarding-nexthop
                           +--- interfaces
                                +--- interface* [name]
                                     +--- mldp-ext: ...

                                 Figure 2

Raza, et al.            Expires January 17, 2019                [Page 7]
Internet-Draft        YANG Data Model for MPLS mLDP            July 2018

   From above hierarchy, we can categorize mLDP configuration parameters
   into two types:

   o  Parameters that are mLDP specific

   o  Parameters that leverage/extend LDP containers and parameters

   Following subsections first describe mLDP specific configuration
   parameters, followed by those leveraging LDP.  It is to be noted that
   these parameters are defined under their respective base or extended
   module as per their categorization.

4.2.  mldp global container

   mldp container is an augmentation of LDP global container and holds
   the configuration related to items that are mLDP specific.  The main
   items under this container are:

   o  mLDP enabling: To enable mLDP under a (VRF) routing instance, mldp
      container is enabled under LDP.  Given that mLDP requires LDP
      signalling, it is not sensible to allow disabling LDP control
      plane under a (VRF) network-instance while requiring mLDP to be
      enabled for the same.  However, if a user wants only to allow
      signalling for multipoint FECs on an LDP/mLDP enabled VRF
      instance, he/she can use LDP label-policies to disable unicast
      FECs under the VRF.

   o  mLDP per-AF features: mLDP manages its own list of IP address-
      families and the features enabled underneath.  The per-AF mLDP
      configuration items include:

      *  Multicast-only FRR: This enables Multicast-only FRR
         functionality for a given AF under mLDP.  The feature allows
         route-policy to be configured for finer control/applicability
         of the feature.

      *  Recursive FEC: The recursive-fec feature [RFC6512] can be
         enabled per AF with a route-policy.

      *  Configured Leaf LSPs: To provision multipoint leaf LSP
         manually, a container is provided per-AF under LDP.  The
         configuration is flexible and allows a user to specify MP LSPs
         of type p2mp or mp2mp with IPv4 or IPv6 root address(es) by
         using either LSP-Id or (S,G).

   Targeted mLDP feature specification [RFC7060] does not require any
   mLDP specific configuration.  It, however, requires LDP upstream-
   label-assignment capability [RFC6389] to be enabled.

Raza, et al.            Expires January 17, 2019                [Page 8]
Internet-Draft        YANG Data Model for MPLS mLDP            July 2018

4.3.  Leveraging LDP containers

   mLDP configuration model leverages following configuration areas and
   containers that are already defined for LDP:

   o  Capabilities: A new container "mldp" is defined that augments
      LDP's capabilities container.  This new container specifies any
      mLDP specific capabilities and their parameters.  Moreover, a new
      "mldp" container is also added by augmenting LDP per-peer
      capability container to override/control mLDP specific
      capabilities on a peer level.  In the scope of this document, the
      most important capabilities related to mLDP are p2mp, mp2mp, make-
      before-break, hub-and-spoke, and node-protection.

   o  Discovery and Peer: mLDP requires LDP discovery and peer
      procedures to form mLDP peering.  A peer is treated as mLDP peer
      only when either P2MP or MP2MP capabilities have been successfully
      exchanged with the peer.  If a user wish to selectively enable or
      disable mLDP with a LDP-enabled peer, he/she may use per-peer mLDP
      capabilities configuration.  [Ed Note: The option to control mLDP
      enabling/disabling on a peer-list is being explored for future ].
      In most common deployments, it is desirable to disable mLDP
      (capabilities announcements) on a targeted-only LDP peering, where
      targeted-only peer is the one whose discovery sources are targeted
      type only.  In future revision, a configuration option for this
      support will also be provided.

   o  Forwarding: By default, mLDP is allowed to select any of the LDP
      enabled interface as a downstream interface towards a nexthop
      (LDP/mLDP peer) for MP LSP programming.  However, a configuration
      option is provided to allow mLDP to exclude a given interface from
      such a selection.  Note that such a configuration option will be
      useful only when there are more than one interfaces available for
      the downstream selection.

4.4.  Configuration Tree

4.4.1.  Base

   Following is a simplified graphical representation of the data model
   for mLDP base configuration

Raza, et al.            Expires January 17, 2019                [Page 9]
Internet-Draft        YANG Data Model for MPLS mLDP            July 2018

module: ietf-mpls-mldp
  augment /rt:routing/rt:control-plane-protocols/ldp:mpls-ldp/ldp:global/ldp:capability:
    +--rw mldp
       +--rw p2mp
       |  +--rw enable?   boolean
       +--rw mp2mp
       |  +--rw enable?   boolean
       +--rw make-before-break
          +--rw enable?             boolean
          +--rw switchover-delay?   uint16
          +--rw timeout?            uint16

  augment /rt:routing/rt:control-plane-protocols/ldp:mpls-ldp/ldp:global:
    +--rw mldp
       +--rw enable?             boolean
       +--rw address-families
          +--rw ipv4
             +--rw configured-leaf-lsps
                +--rw opaque-type-lspid
                   +--rw fec-label* [root-address lsp-id]
                      +--rw root-address              inet:ipv4-address
                      +--rw lsp-id                    uint32
                      +--rw multipoint-type?          multipoint-type

                                 Figure 3

4.4.2.  Extended

   Following is a simplified graphical representation of the data model
   for mLDP extended configuration

module: ietf-mpls-mldp
  augment /rt:routing/rt:control-plane-protocols/ldp:mpls-ldp/ldp:global/ldp:capability:
    +--rw mldp
       +--rw mldp-ext:hub-and-spoke {capability-mldp-hsmp}?
       |  +--rw mldp-ext:enable?   boolean
       +--rw mldp-ext:node-protection {capability-mldp-node-protection}?
          +--rw mldp-ext:plr?           boolean
          +--rw mldp-ext:merge-point
             +--rw mldp-ext:enable?                            boolean
             +--rw mldp-ext:targeted-session-teardown-delay?   uint16

  augment /rt:routing/rt:control-plane-protocols/ldp:mpls-ldp/ldp:global:
    +--rw mldp
       +--rw enable?             boolean

Raza, et al.            Expires January 17, 2019               [Page 10]
Internet-Draft        YANG Data Model for MPLS mLDP            July 2018

       +--rw address-families
          +--rw ipv4
          |  +--rw configured-leaf-lsps
          |  |  +--rw mldp-ext:opaque-type-transit
          |  |  |  +--rw mldp-ext:fec-label* [root-address source-address group-address rd recur-root-address recur-rd]
          |  |  |     +--rw mldp-ext:root-address          inet:ipv4-address
          |  |  |     +--rw mldp-ext:source-address        inet:ip-address
          |  |  |     +--rw mldp-ext:group-address         inet:ip-address-no-zone
          |  |  |     +--rw mldp-ext:rd                    route-distinguisher
          |  |  |     +--rw mldp-ext:recur-root-address    inet:ip-address
          |  |  |     +--rw mldp-ext:recur-rd              route-distinguisher
          |  |  |     +--rw mldp-ext:multipoint-type?      mldp:multipoint-type
          |  |  +--rw mldp-ext:opaque-type-bidir
          |  |     +--rw mldp-ext:fec-label* [root-address rp group-address rd recur-root-address recur-rd]
          |  |        +--rw mldp-ext:root-address          inet:ipv4-address
          |  |        +--rw mldp-ext:rp                    inet:ip-address
          |  |        +--rw mldp-ext:group-address         inet:ip-address-no-zone
          |  |        +--rw mldp-ext:rd                    route-distinguisher
          |  |        +--rw mldp-ext:recur-root-address    inet:ip-address
          |  |        +--rw mldp-ext:recur-rd              route-distinguisher
          |  |        +--rw mldp-ext:multipoint-type?      mldp:multipoint-type
          |  +--rw mldp-ext:multicast-only-frr {mldp-mofrr}?
          |  |  +--rw mldp-ext:prefix-list?   ldp-ext:prefix-list-ref
          |  +--rw mldp-ext:recursive-fec
          |     +--rw mldp-ext:prefix-list?   ldp-ext:prefix-list-ref
          +--rw mldp-ext:ipv6
             +--rw mldp-ext:configured-leaf-lsps
             |  +--rw mldp-ext:opaque-type-lspid
             |  |  +--rw mldp-ext:fec-label* [root-address lsp-id]
             |  |     +--rw mldp-ext:root-address       inet:ipv6-address
             |  |     +--rw mldp-ext:lsp-id             uint32
             |  |     +--rw mldp-ext:multipoint-type?   mldp:multipoint-type
             |  |     +--rw mldp-ext:recursive-fec* [recur-root-address recur-rd]
             |  |        +--rw mldp-ext:recur-root-address    inet:ip-address
             |  |        +--rw mldp-ext:recur-rd              route-distinguisher
             |  |        +--rw mldp-ext:multipoint-type?      mldp:multipoint-type
             |  +--rw mldp-ext:opaque-type-transit
             |  |  +--rw mldp-ext:fec-label* [root-address source-address group-address rd recur-root-address recur-rd]
             |  |     +--rw mldp-ext:root-address          inet:ipv6-address
             |  |     +--rw mldp-ext:source-address        inet:ip-address
             |  |     +--rw mldp-ext:group-address         inet:ip-address-no-zone
             |  |     +--rw mldp-ext:rd                    route-distinguisher
             |  |     +--rw mldp-ext:recur-root-address    inet:ip-address
             |  |     +--rw mldp-ext:recur-rd              route-distinguisher
             |  |     +--rw mldp-ext:multipoint-type?      mldp:multipoint-type
             |  +--rw mldp-ext:opaque-type-bidir
             |     +--rw mldp-ext:fec-label* [root-address rp group-address rd recur-root-address recur-rd]
             |        +--rw mldp-ext:root-address          inet:ipv6-address

Raza, et al.            Expires January 17, 2019               [Page 11]
Internet-Draft        YANG Data Model for MPLS mLDP            July 2018

             |        +--rw mldp-ext:rp                    inet:ip-address
             |        +--rw mldp-ext:group-address         inet:ip-address-no-zone
             |        +--rw mldp-ext:rd                    route-distinguisher
             |        +--rw mldp-ext:recur-root-address    inet:ip-address
             |        +--rw mldp-ext:recur-rd              route-distinguisher
             |        +--rw mldp-ext:multipoint-type?      mldp:multipoint-type
             +--rw mldp-ext:multicast-only-frr {mldp-mofrr}?
             |  +--rw mldp-ext:prefix-list?   ldp-ext:prefix-list-ref
             +--rw mldp-ext:recursive-fec
                +--rw mldp-ext:prefix-list?   ldp-ext:prefix-list-ref

  augment /rt:routing/rt:control-plane-protocols/ldp:mpls-ldp/ldp:peers/ldp:peer/ldp:capability:
    +--rw mldp {per-peer-capability}?
       +--rw p2mp
       |  +--rw enable?   boolean
       +--rw mp2mp
       |  +--rw enable?   boolean
       +--rw make-before-break
          +--rw enable?             boolean
          +--rw switchover-delay?   uint16
          +--rw timeout?            uint16

  augment /rt:routing/rt:control-plane-protocols/ldp:mpls-ldp/ldp:global/ldp-ext:forwarding-nexthop/ldp-ext:interfaces/ldp-ext:interface/ldp-ext:address-family:
  +--rw mldp-disable?   boolean

                                 Figure 4

5.  Operational State

   Operational state of mLDP can be queried and obtained from various
   read-only mdlp "state" containers that augment ldp containers.

5.1.  Base

   Following is a simplified graphical representation of the data model
   for mLDP base operational state:

Raza, et al.            Expires January 17, 2019               [Page 12]
Internet-Draft        YANG Data Model for MPLS mLDP            July 2018

module: ietf-mpls-mldp
  augment /rt:routing/rt:control-plane-protocols/ldp:mpls-ldp/ldp:peers/ldp:peer/ldp:received-peer-state/ldp:capability:
    +--ro mldp
       +--ro p2mp
       |  +--ro enable?   boolean
       +--ro mp2mp
       |  +--ro enable?   boolean
       +--ro make-before-break
          +--ro enable?   boolean

  augment /rt:routing/rt:control-plane-protocols/ldp:mpls-ldp/ldp:global:
    +--rw mldp
       +--rw enable?             boolean
       +--rw address-families
          +--rw ipv4
             +--ro roots
                +--ro root* [root-address]
                   +--ro root-address    inet:ipv4-address
                   +--ro is-self?        boolean
                   +--ro reachability* [address interface]
                   |  +--ro address      inet:ipv4-address
                   |  +--ro interface    if:interface-ref
                   |  +--ro peer?        -> ../../../../../../../../ldp:peers/peer/lsr-id
                   +--ro bindings
                      +--ro opaque-type-lspid
                         +--ro fec-label* [lsp-id]
                            +--ro lsp-id                    uint32
                            +--ro multipoint-type?          multipoint-type
                            +--ro peer* [direction peer advertisement-type]
                               +--ro direction              ldp:downstream-upstream
                               +--ro peer                   -> /rt:routing/control-plane-protocols/ldp:mpls-ldp/peers/peer/lsr-id
                               +--ro advertisement-type     ldp:advertised-received
                               +--ro label?                 rt-types:mpls-label
                               +--ro mbb-role?              enumeration
                               +--ro mldp-ext:mofrr-role?   mofrr-role

                                 Figure 5

5.2.  Extended

   Following is a simplified graphical representation of the data model
   for mLDP extended operational state:

module: ietf-mpls-mldp

  augment /rt:routing/rt:control-plane-protocols/ldp:mpls-ldp/ldp:peers/ldp:peer/ldp:received-peer-state/ldp:capability:

Raza, et al.            Expires January 17, 2019               [Page 13]
Internet-Draft        YANG Data Model for MPLS mLDP            July 2018

    +--ro mldp
       +--ro mldp-ext:hub-and-spoke
       |  +--ro mldp-ext:enable?   boolean
       +--ro mldp-ext:node-protection
          +--ro mldp-ext:plr?           boolean
          +--ro mldp-ext:merge-point?   boolean

  augment /rt:routing/rt:control-plane-protocols/ldp:mpls-ldp/ldp:global:
    +--rw mldp
       +--rw enable?             boolean
       +--rw address-families
          +--rw ipv4
          |  +--ro roots
          |     +--ro root* [root-address]
          |        +--ro root-address    inet:ipv4-address
          |        +--ro bindings
          |           +--ro opaque-type-lspid
          |           |     +--ro mldp-ext:recursive-fec* [recur-root-address recur-rd]
          |           |        +--ro mldp-ext:recur-root-address    inet:ip-address
          |           |        +--ro mldp-ext:recur-rd              route-distinguisher
          |           |        +--ro mldp-ext:multipoint-type?      mldp:multipoint-type
          |           |        +--ro mldp-ext:peer* [direction peer advertisement-type]
          |           |           +--ro mldp-ext:direction             ldp:downstream-upstream
          |           |           +--ro mldp-ext:peer                  -> /rt:routing/control-plane-protocols/ldp:mpls-ldp/peers/peer/lsr-id
          |           |           +--ro mldp-ext:advertisement-type    ldp:advertised-received
          |           |           +--ro mldp-ext:label?                rt-types:mpls-label
          |           |           +--ro mldp-ext:mbb-role?             enumeration
          |           |           +--ro mldp-ext:mofrr-role?           mofrr-role
          |           +--ro mldp-ext:opaque-type-transit
          |           |  +--ro mldp-ext:fec-label* [source-address group-address rd recur-root-address recur-rd]
          |           |     +--ro mldp-ext:source-address        inet:ip-address
          |           |     +--ro mldp-ext:group-address         inet:ip-address-no-zone
          |           |     +--ro mldp-ext:rd                    route-distinguisher
          |           |     +--ro mldp-ext:recur-root-address    inet:ip-address
          |           |     +--ro mldp-ext:recur-rd              route-distinguisher
          |           |     +--ro mldp-ext:multipoint-type?      mldp:multipoint-type
          |           |     +--ro mldp-ext:peer* [direction peer advertisement-type]
          |           |        +--ro mldp-ext:direction             ldp:downstream-upstream
          |           |        +--ro mldp-ext:peer                  -> /rt:routing/control-plane-protocols/ldp:mpls-ldp/peers/peer/lsr-id
          |           |        +--ro mldp-ext:advertisement-type    ldp:advertised-received
          |           |        +--ro mldp-ext:label?                rt-types:mpls-label
          |           |        +--ro mldp-ext:mbb-role?             enumeration
          |           |        +--ro mldp-ext:mofrr-role?           mofrr-role
          |           +--ro mldp-ext:opaque-type-bidir
          |              +--ro mldp-ext:fec-label* [rp group-address rd recur-root-address recur-rd]
          |                 +--ro mldp-ext:rp                    inet:ip-address
          |                 +--ro mldp-ext:group-address         inet:ip-address-no-zone
          |                 +--ro mldp-ext:rd                    route-distinguisher

Raza, et al.            Expires January 17, 2019               [Page 14]
Internet-Draft        YANG Data Model for MPLS mLDP            July 2018

          |                 +--ro mldp-ext:recur-root-address    inet:ip-address
          |                 +--ro mldp-ext:recur-rd              route-distinguisher
          |                 +--ro mldp-ext:multipoint-type?      mldp:multipoint-type
          |                 +--ro mldp-ext:peer* [direction peer advertisement-type]
          |                    +--ro mldp-ext:direction             ldp:downstream-upstream
          |                    +--ro mldp-ext:peer                  -> /rt:routing/control-plane-protocols/ldp:mpls-ldp/peers/peer/lsr-id
          |                    +--ro mldp-ext:advertisement-type    ldp:advertised-received
          |                    +--ro mldp-ext:label?                rt-types:mpls-label
          |                    +--ro mldp-ext:mbb-role?             enumeration
          |                    +--ro mldp-ext:mofrr-role?           mofrr-role
          +--rw mldp-ext:ipv6
             +--ro mldp-ext:roots
                +--ro mldp-ext:root* [root-address]
                   +--ro mldp-ext:root-address    inet:ipv6-address
                   +--ro mldp-ext:is-self?        boolean
                   +--ro mldp-ext:reachability* [address interface]
                   |  +--ro mldp-ext:address      inet:ipv6-address
                   |  +--ro mldp-ext:interface    if:interface-ref
                   |  +--ro mldp-ext:peer?        -> ../../../../../../../../ldp:peers/peer/lsr-id
                   +--ro mldp-ext:bindings
                      +--ro mldp-ext:opaque-type-lspid
                      |  +--ro mldp-ext:fec-label* [lsp-id]
                      |     +--ro mldp-ext:lsp-id             uint32
                      |     +--ro mldp-ext:multipoint-type?   mldp:multipoint-type
                      |     +--ro mldp-ext:peer* [direction peer advertisement-type]
                      |     |  +--ro mldp-ext:direction             ldp:downstream-upstream
                      |     |  +--ro mldp-ext:peer                  -> /rt:routing/control-plane-protocols/ldp:mpls-ldp/peers/peer/lsr-id
                      |     |  +--ro mldp-ext:advertisement-type    ldp:advertised-received
                      |     |  +--ro mldp-ext:label?                rt-types:mpls-label
                      |     |  +--ro mldp-ext:mbb-role?             enumeration
                      |     |  +--ro mldp-ext:mofrr-role?           mofrr-role
                      |     +--ro mldp-ext:recursive-fec* [recur-root-address recur-rd]
                      |        +--ro mldp-ext:recur-root-address    inet:ip-address
                      |        +--ro mldp-ext:recur-rd              route-distinguisher
                      |        +--ro mldp-ext:multipoint-type?      mldp:multipoint-type
                      |        +--ro mldp-ext:peer* [direction peer advertisement-type]
                      |           +--ro mldp-ext:direction             ldp:downstream-upstream
                      |           +--ro mldp-ext:peer                  -> /rt:routing/control-plane-protocols/ldp:mpls-ldp/peers/peer/lsr-id
                      |           +--ro mldp-ext:advertisement-type    ldp:advertised-received
                      |           +--ro mldp-ext:label?                rt-types:mpls-label
                      |           +--ro mldp-ext:mbb-role?             enumeration
                      |           +--ro mldp-ext:mofrr-role?           mofrr-role
                      +--ro mldp-ext:opaque-type-transit
                      |  +--ro mldp-ext:fec-label* [source-address group-address rd recur-root-address recur-rd]
                      |     +--ro mldp-ext:source-address        inet:ip-address
                      |     +--ro mldp-ext:group-address         inet:ip-address-no-zone
                      |     +--ro mldp-ext:rd                    route-distinguisher
                      |     +--ro mldp-ext:recur-root-address    inet:ip-address

Raza, et al.            Expires January 17, 2019               [Page 15]
Internet-Draft        YANG Data Model for MPLS mLDP            July 2018

                      |     +--ro mldp-ext:recur-rd              route-distinguisher
                      |     +--ro mldp-ext:multipoint-type?      mldp:multipoint-type
                      |     +--ro mldp-ext:peer* [direction peer advertisement-type]
                      |        +--ro mldp-ext:direction             ldp:downstream-upstream
                      |        +--ro mldp-ext:peer                  -> /rt:routing/control-plane-protocols/ldp:mpls-ldp/peers/peer/lsr-id
                      |        +--ro mldp-ext:advertisement-type    ldp:advertised-received
                      |        +--ro mldp-ext:label?                rt-types:mpls-label
                      |        +--ro mldp-ext:mbb-role?             enumeration
                      |        +--ro mldp-ext:mofrr-role?           mofrr-role
                      +--ro mldp-ext:opaque-type-bidir
                         +--ro mldp-ext:fec-label* [rp group-address rd recur-root-address recur-rd]
                            +--ro mldp-ext:rp                    inet:ip-address
                            +--ro mldp-ext:group-address         inet:ip-address-no-zone
                            +--ro mldp-ext:rd                    route-distinguisher
                            +--ro mldp-ext:recur-root-address    inet:ip-address
                            +--ro mldp-ext:recur-rd              route-distinguisher
                            +--ro mldp-ext:multipoint-type?      mldp:multipoint-type
                            +--ro mldp-ext:peer* [direction peer advertisement-type]
                               +--ro mldp-ext:direction             ldp:downstream-upstream
                               +--ro mldp-ext:peer                  -> /rt:routing/control-plane-protocols/ldp:mpls-ldp/peers/peer/lsr-id
                               +--ro mldp-ext:advertisement-type    ldp:advertised-received
                               +--ro mldp-ext:label?                rt-types:mpls-label
                               +--ro mldp-ext:mbb-role?             enumeration
                               +--ro mldp-ext:mofrr-role?           mofrr-role

                                 Figure 6

5.3.  Derived states

   Following are main areas for which mLDP operational derived state is
   defined:

   o  Root

   o  Bindings (FEC-label)

   o  Capabilities

5.3.1.  Root state

   Root address is a fundamental construct for MP FEC bindings and LSPs.
   The root state provides information on all the known roots in a given
   address-familty, and their information on the root reachability (as
   learnt from RIB).  In case of multi-path reachability to a root, the
   selection of upstream path is done on per-LSP basis at the time of
   LSP setup.  Similarly, when protection mechanisms like MBB or MoFRR

Raza, et al.            Expires January 17, 2019               [Page 16]
Internet-Draft        YANG Data Model for MPLS mLDP            July 2018

   are in place, the path designation as active/standby or primary/
   backup is also done on per LSP basis.  It is to be noted that a given
   root can be shared amongst multiple P2MP and/or MP2MP LSPs.
   Moreover, an LSP can be signaled to more than one root for RNR
   purposes.

   The following diagram illustrates a root database on a branch/transit
   LSR:

        root 203.0.113.1:
            path1:
                RIB: GigEthernet 1/0, 198.51.100.1;
                LDP: peer 192.0.2.1:0
            path2:
                RIB: GigEthernet 2/0, 198.51.100.16;
                LDP: peer 192.0.2.2:0

        root 203.0.113.2:
            path1:
                RIB: 198.51.100.100;      (NOTE: This is a recursive path)
                LDP: peer 192.0.2.100:0   (NOTE: T-mLDP peer)

        root . . . .

                                 Figure 7

   A root entry on a root LSR itself will be presented as follows:

           root 203.0.113.10:
               is-self

                                 Figure 8

5.3.2.  Bindings state

   Binding state provides information on mLDP FEC-label bindings for
   both P2MP and MP2MP FEC types.  Like LDP, the FEC-label binding
   derived state is presented in a FEC-centric view per address-family,
   and provides information on both inbound (received) and outbound
   (advertised) bindings.  The FEC is presented as (root-address,
   opaque-type-data) as described earlier in section Section 3.2, and
   the direction (upstream or downstream) is picked with respect to root
   reachability.  In case of MBB or/and MoFRR, the role of a given peer

Raza, et al.            Expires January 17, 2019               [Page 17]
Internet-Draft        YANG Data Model for MPLS mLDP            July 2018

   binding is also provided with respect to MBB (active or standby) or/
   and MoFRR (primary or backup).

   Following captures a high level tree hierarchy for mLDP bindings
   state:

+--rw mpls-ldp!
 +--rw global
   +--rw mldp
      +--rw address-families
         +--rw ipv4 (or ipv6)
            +--ro state
               +--ro roots
                  +--ro root* [root-address]
                     +--ro ....
                     +--ro bindings
                        +--ro opaque-type-xxx
                        |  +--ro fec-label* [type-specific-key]
                        |     +--ro some_key_1  ...
                        |     +--ro some_key_2  ...
                        |     +--ro multipoint-type?          multipoint-type
                        |     +--ro peer* [direction peer advertisement-type]
                        |     |  +--ro direction              ldp:downstream-upstream
                        |     |  +--ro peer                   leafref
                        |     |  +--ro advertisement-type     ldp:advertised-received
                        |     |  +--ro label?                 mpls:mpls-label
                        |     |  +--ro mbb-role?              enumeration
                        |     |  +--ro mldp-ext:mofrr-role?   mofrr-role
                        +--ro opaque-type-yyy
                        |  +--ro fec-label* [type-specific-key]
                        |     +--ro some_key_1  ...
                        ...

                                 Figure 9

   mLDP binding state is organized and presented per root address, and
   hence the bindings container hang off a root node in the model.  The
   bindings state is made available for FECs pertaining to different
   types of opaque types, with some state avaiable under "base" tree and
   the rest under "extended".

   In the above tree, the various opaque types alongwith their type
   specific key(s) refer to the table Table 1 captured earlier in the
   document.  For example, if the opaque type is Generic LSP Identifier,

Raza, et al.            Expires January 17, 2019               [Page 18]
Internet-Draft        YANG Data Model for MPLS mLDP            July 2018

   then the type-specific-key will be a uint32 LSP-Id key.  Please see
   the complete model for all other types.

   It is important to take note of the following:

   o  The address-family ipv4/ipv4 applies to "root" address in the mLDP
      binding tree.  The other addresses (source, group, RP etc) do not
      have to be of the same address family type as the root.

   o  The "recur-root-address" field applies to Recursive opaque type,
      and (recur-root-address, recur-rd) fields applies to VPN-Recursive
      opaque types as defined in [RFC6512]

   o  In case of a recursive FEC, the address-family of the recur-root-
      address could be different than the address-family of the root
      address of original encapsulated MP FEC

   The following diagram illustrates the FEC-label binding information
   structure for a P2MP (Transit IPv4 Source type) LSP on a branch/
   transit LSR:

            FEC (root 203.0.113.1, S=198.51.100.1, G=224.1.1.1):
              type: p2mp
              upstream:
                advertised:
                  peer 192.0.2.1:0, label 16000 (local)
              downstream:
                received:
                  peer 192.0.2.2:0, label 17000 (remote)
                  peer 192.0.2.3:0, label 18000  (remote)

                                 Figure 10

   The following diagram illustrates the FEC-label binding information
   structure for a similar MP2MP LSP on a branch/transit LSR:

Raza, et al.            Expires January 17, 2019               [Page 19]
Internet-Draft        YANG Data Model for MPLS mLDP            July 2018

           FEC (root 203.0.113.2, RP=198.51.100.2, G=224.1.1.1):
             type: mp2mp
             upstream:
               advertised:
                 peer 192.0.2.1:0, label 16000 (local)
               received:
                 peer 192.0.2.1:0, label 17000 (remote)
             downstream:
               advertised:
                 peer 192.0.2.2:0, label 16001 (local), MBB role=active
                 peer 192.0.2.3:0, label 16002 (local), MBB role=standby
               received:
                 peer 192.0.2.2:0, label 17001 (remote)
                 peer 192.0.2.3:0, label 18001 (remote)

                                 Figure 11

5.3.3.  Capabilities state

   Like LDP, mLDP capabilities state comprise two types of information:

   o  global: augments ldp:global/ldp:state/ldp:capability.

   o  per-peer: augments ldp:peers/ldp:peer/ldp:state/ldp:capability

6.  Notifications

   mLDP notification module consists of notification related to changes
   in the operational state of an mLDP FEC.

6.1.  Base

   Following is a simplified graphical representation of the base data
   model for mLDP notifications:

Raza, et al.            Expires January 17, 2019               [Page 20]
Internet-Draft        YANG Data Model for MPLS mLDP            July 2018

module: ietf-mpls-mldp
notifications:
    +---n mpls-mldp-fec-event
       +--ro event-type?                     ldp:oper-status-event-type
       +--ro (opaque-type)?
          +--:(opaque-type-lspid)
             +--ro opaque-type-lspid
                +--ro root-address?             inet:ip-address
                +--ro lsp-id?                   uint32
                +--ro multipoint-type?          multipoint-type
                +--ro mldp-ext:recursive-fec
                   +--ro mldp-ext:recur-root-address?   inet:ip-address
                   +--ro mldp-ext:recur-rd?             route-distinguisher
                   +--ro mldp-ext:multipoint-type?      mldp:multipoint-type

                                 Figure 12

6.2.  Extended

   Following is a simplified graphical representation of the extended
   data model for mLDP notifications:

Raza, et al.            Expires January 17, 2019               [Page 21]
Internet-Draft        YANG Data Model for MPLS mLDP            July 2018

module: ietf-mpls-mldp
notifications:
    +---n mpls-mldp-fec-event
       +--ro event-type?                     ldp:oper-status-event-type
       +--ro (opaque-type)?
          +--:(mldp-ext:opaque-type-transit)
          |  +--ro mldp-ext:opaque-type-transit
          |     +--ro mldp-ext:root-address?         inet:ip-address
          |     +--ro mldp-ext:source-address?       inet:ip-address
          |     +--ro mldp-ext:group-address?        inet:ip-address-no-zone
          |     +--ro mldp-ext:rd?                   route-distinguisher
          |     +--ro mldp-ext:recur-root-address?   inet:ip-address
          |     +--ro mldp-ext:recur-rd?             route-distinguisher
          |     +--ro mldp-ext:multipoint-type?      mldp:multipoint-type
          +--:(mldp-ext:opaque-type-bidir)
             +--ro mldp-ext:opaque-type-bidir
                +--ro mldp-ext:root-address?         inet:ip-address
                +--ro mldp-ext:rp?                   inet:ip-address
                +--ro mldp-ext:group-address?        inet:ip-address-no-zone
                +--ro mldp-ext:rd?                   route-distinguisher
                +--ro mldp-ext:recur-root-address?   inet:ip-address
                +--ro mldp-ext:recur-rd?             route-distinguisher
                +--ro mldp-ext:multipoint-type?      mldp:multipoint-type

                                 Figure 13

7.  Actions

   Currently, no RPCs/actions are defined for mLDP.

8.  Open Items

   Following is a list of open items that are to be discussed and
   addressed in future revisions of this document:

   o  Specify default values for configuration parameters

   o  Extend the "Configured Leaf LSPs" for various type of opaque-types

   o  Extend mLDP notifications for other types of opaque values as well

   o  Make MP LSP configuration and state model consistent

Raza, et al.            Expires January 17, 2019               [Page 22]
Internet-Draft        YANG Data Model for MPLS mLDP            July 2018

9.  YANG Specification

   Following is the actual YANG definition (module) for mLDP constructs
   defined earlier in the document.

9.1.  Base

   <CODE BEGINS> file "ietf-mpls-mldp@2017-10-19.yang"

   module ietf-mpls-mldp {
     namespace "urn:ietf:params:xml:ns:yang:ietf-mpls-mldp";
     prefix "mldp";

     import ietf-inet-types {
       prefix "inet";
     }

     import ietf-interfaces {
       prefix "if";
     }

     import ietf-mpls-ldp {
       prefix "ldp";
     }

     import ietf-routing {
       prefix "rt";
     }

     import ietf-routing-types {
       prefix "rt-types";
     }

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

        WG Chair: Loa Andersson
                  <mailto:loa@pi.nu>

        WG Chair: Ross Callon
                  <mailto:rcallon@juniper.net>

        WG Chair: George Swallow

Raza, et al.            Expires January 17, 2019               [Page 23]
Internet-Draft        YANG Data Model for MPLS mLDP            July 2018

                  <mailto:swallow.ietf@gmail.com>

        Editor:   Kamran Raza
                  <mailto:skraza@cisco.com>

        Editor:   Rajiv Asati
                  <mailto:rajiva@cisco.com>

        Editor:   Xufeng Liu
                  <mailto:Xufeng_Liu@jabil.com>

        Editor:   Santosh Esale
                  <mailto:sesale@juniper.net>

        Editor:   Xia Chen
                  <mailto:jescia.chenxia@huawei.com>

        Editor:   Himanshu Shah
                  <mailto:hshah@ciena.com>";

     description
       "This YANG module defines the essential components for the
        management of Multi-Protocol Label Switching (MPLS) Multipoint
        LDP (mLDP).";

     revision 2017-10-19 {
       description
         "Initial revision.";
       reference
         "RFC XXXX: YANG Data Model for MPLS mLDP.";
     }

     /*
      * Typedefs
      */
     typedef multipoint-type {
       type enumeration {
         enum p2mp {
           description "Point to multipoint.";
         }
         enum mp2mp {
           description "Multipoint to multipoint.";
         }
       }
       description
         "p2mp or mp2mp.";
     }

Raza, et al.            Expires January 17, 2019               [Page 24]
Internet-Draft        YANG Data Model for MPLS mLDP            July 2018

     /*
      * Groupings
      */

     grouping mldp-capabilities {
       description
         "mLDP capabilities.";
       container p2mp {
         description
           "Configure point-to-multipoint capability.";
         leaf enable {
           type boolean;
           description
             "Enable point-to-multipoint.";
         }
       }
       container mp2mp {
         description
           "Configure multipoint-to-multipoint capability.";
         leaf enable {
           type boolean;
           description
             "Enable multipoint-to-multipoint.";
         }
       }
       container make-before-break {
         description
           "Configure make-before-break capability.";
         leaf enable {
           type boolean;
           description
             "Enable make-before-break.";
         }
         leaf switchover-delay {
           type uint16;
           units seconds;
           description
             "Switchover delay in seconds.";
         }
         leaf timeout {
           type uint16;
           units seconds;
           description
             "Timeout in seconds.";
         }
       }
     } // mldp-capabilities

Raza, et al.            Expires January 17, 2019               [Page 25]
Internet-Draft        YANG Data Model for MPLS mLDP            July 2018

     grouping mldp-fec-event {
       description
         "A mLDP FEC event.";
       choice opaque-type {
         description
           "The type of opaque value element.";
         case opaque-type-lspid {
           container opaque-type-lspid {
             description
               "The type of opaque value element is
                the generic LSP identifier";
             reference
               "RFC6388: Label Distribution Protocol
               Extensions for Point-to-Multipoint and
               Multipoint-to-Multipoint Label Switched
               Paths.";
             leaf root-address {
               type inet:ip-address;
               description
                 "Root address.";
             }
             leaf lsp-id {
               type uint32;
               description "ID to identify the LSP.";
             }
             leaf multipoint-type {
               type multipoint-type;
               description
                 "The type of mutipoint, p2mp or mp2mp.";
             }
           } // container opaque-type-lspid
         }
       }
     } // mldp-fec-event

     grouping  mldp-binding-label-peer-state-attributes {
       description
         "mLDP label binding per peer attributes.";
       leaf direction {
         type ldp:downstream-upstream;
         description
           "Downstream or upstream.";
       }
       leaf peer {
         type leafref {
           path
             "/rt:routing/rt:control-plane-protocols/"
           + "ldp:mpls-ldp/ldp:peers/ldp:peer/ldp:lsr-id";

Raza, et al.            Expires January 17, 2019               [Page 26]
Internet-Draft        YANG Data Model for MPLS mLDP            July 2018

         }
         description
           "LDP peer from which this binding is received,
            or to which this binding is advertised.";
       }
       leaf advertisement-type {
         type ldp:advertised-received;
         description
           "Advertised or received.";
       }
       leaf label {
         type rt-types:mpls-label;
         description
           "Advertised (outbound) or received (inbound) label.";
       }
       leaf mbb-role {
         when "../direction = 'upstream'" {
           description
             "For upstream.";
         }
         type enumeration {
           enum none {
             description "MBB is not enabled.";
           }
           enum active {
             description "This LSP is active.";
           }
           enum inactive {
             description "This LSP is inactive.";
           }
         }
         description
           "The MBB status of this LSP.";
       }
     } // mldp-binding-label-peer-state-attributes

     grouping  mldp-binding-label-state-attributes {
       description
         "mLDP label binding attributes.";
       list peer {
         key "direction peer advertisement-type";
         description
           "List of advertised and received peers.";
         uses mldp-binding-label-peer-state-attributes;
       } // peer
     } // mldp-binding-label-state-attributes

     /*

Raza, et al.            Expires January 17, 2019               [Page 27]
Internet-Draft        YANG Data Model for MPLS mLDP            July 2018

      * Configuration data and operational state data nodes
      */
     augment "/rt:routing/rt:control-plane-protocols/"
       + "ldp:mpls-ldp/ldp:global/ldp:capability" {
       description "Augmentation for MLDP global capability.";
       container mldp {
         description
           "Multipoint capabilities.";
         uses mldp-capabilities;
       }
     }

     /*
      * Operational state data nodes
      */
     augment "/rt:routing/rt:control-plane-protocols/"
       + "ldp:mpls-ldp/ldp:peers/ldp:peer/ldp:received-peer-state/"
       + "ldp:capability" {
       description
         "Augmentation for MLDP received peer state capability.";
       container mldp {
         description
           "Multipoint capabilities.";

         container p2mp {
           description
             "Configure point-to-multipoint capability.";
           leaf enable {
             type boolean;
             description
               "Enable point-to-multipoint.";
           }
         }
         container mp2mp {
           description
             "Configure multipoint-to-multipoint capability.";
           leaf enable {
             type boolean;
             description
               "Enable multipoint-to-multipoint.";
           }
         }
         container make-before-break {
           description
             "Configure make-before-break capability.";
           leaf enable {
             type boolean;
             description

Raza, et al.            Expires January 17, 2019               [Page 28]
Internet-Draft        YANG Data Model for MPLS mLDP            July 2018

               "Enable make-before-break.";
           }
         }
       } // mldp
     }

     /*
      * Global augmentation
      */
     augment "/rt:routing/rt:control-plane-protocols/"
       + "ldp:mpls-ldp/ldp:global" {
       description "MLDP global augmentation.";
       container mldp {
         description
           "mLDP attributes at per instance level. Defining
            attributes here does not enable any MP capabilities.
            MP capabilities need to be explicitly enabled under
            container capability.";

         leaf enable {
           type boolean;
           description
             "Enable mLDP.";
         }

         container address-families {
           description
             "Per-af params.";

           container ipv4 {
             description
                 "IPv4 information.";
             container roots {
               config false;
               description
                 "IPv4 multicast LSP roots.";
               list root {
                 key "root-address";
                 description
                   "List of roots for configured multicast LSPs.";

                 leaf root-address {
                   type inet:ipv4-address;
                   description
                     "Root address.";
                 }

                 leaf is-self {

Raza, et al.            Expires January 17, 2019               [Page 29]
Internet-Draft        YANG Data Model for MPLS mLDP            July 2018

                   type boolean;
                   description
                     "This is the root.";
                 }

                 list reachability {
                   key "address interface";
                   description
                     "A next hop for reachability to root,
                        as a RIB view.";
                   leaf address {
                     type inet:ipv4-address;
                     description
                       "The next hop address to reach root.";
                   }
                   leaf interface {
                     type if:interface-ref;
                     description
                       "Interface connecting to next-hop.";
                   }
                   leaf peer {
                     type leafref {
                       path
                         "../../../../../../../../ldp:peers/"
                         + "ldp:peer/ldp:lsr-id";
                     }
                     description
                       "LDP peer from which this next hop can be
                        reached.";
                   }
                 }

                 container bindings {
                   description
                     "mLDP FEC to label bindings.";
                   container opaque-type-lspid {
                     description
                       "The type of opaque value element is
                          the generic LSP identifier";
                     reference
                       "RFC6388: Label Distribution Protocol
                        Extensions for Point-to-Multipoint and
                        Multipoint-to-Multipoint Label Switched
                        Paths.";
                     list fec-label {
                       key
                         "lsp-id";
                       description

Raza, et al.            Expires January 17, 2019               [Page 30]
Internet-Draft        YANG Data Model for MPLS mLDP            July 2018

                         "List of FEC to label bindings.";
                       leaf lsp-id {
                         type uint32;
                         description "ID to identify the LSP.";
                       }
                       leaf multipoint-type {
                         type multipoint-type;
                         description
                           "The type of mutipoint, p2mp or mp2mp.";
                       }
                       uses mldp-binding-label-state-attributes;
                     } // fec-label
                   } // opaque-type-lspid
                 } // bindings
               } // list root
             } // roots

             container configured-leaf-lsps {
               description
                 "Configured multicast LSPs.";
               container opaque-type-lspid {
                 description
                   "The type of opaque value element is
                    the generic LSP identifier";
                 reference
                   "RFC6388: Label Distribution Protocol
                    Extensions for Point-to-Multipoint and
                    Multipoint-to-Multipoint Label Switched
                    Paths.";
                 list fec-label {
                   key
                     "root-address lsp-id";
                   description
                     "List of FEC to label bindings.";
                   leaf root-address {
                     type inet:ipv4-address;
                     description
                       "Root address.";
                   }
                   leaf lsp-id {
                     type uint32;
                     description "ID to identify the LSP.";
                   }
                   leaf multipoint-type {
                     type multipoint-type;
                     description
                       "The type of mutipoint, p2mp or mp2mp.";
                   }

Raza, et al.            Expires January 17, 2019               [Page 31]
Internet-Draft        YANG Data Model for MPLS mLDP            July 2018

                 } // fec-label
               } // opaque-type-lspid
             } // configured-leaf-lsps
           } // ipv4
         } // list address-family
       } // mldp
     }

     /*
      * Notifications
      */
     notification mpls-mldp-fec-event {
       description
         "Notification event for a change of FEC status.";
       leaf event-type {
         type ldp:oper-status-event-type;
         description "Event type.";
       }
       uses mldp-fec-event;
     }
   }

   <CODE ENDS>

                                 Figure 14

9.2.  Extended

   <CODE BEGINS> file "ietf-mpls-mldp-extended@2017-10-19.yang"

   module ietf-mpls-mldp-extended {
     namespace "urn:ietf:params:xml:ns:yang:ietf-mpls-mldp-extended";
     prefix "mldp-ext";

     import ietf-inet-types {
       prefix "inet";
     }

     import ietf-interfaces {
       prefix "if";
     }

     import ietf-routing {
       prefix "rt";
     }

Raza, et al.            Expires January 17, 2019               [Page 32]
Internet-Draft        YANG Data Model for MPLS mLDP            July 2018

     import ietf-mpls-ldp {
       prefix "ldp";
     }

     import ietf-mpls-ldp-extended {
       prefix "ldp-ext";
     }

     import ietf-mpls-mldp {
       prefix "mldp";
     }

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

        WG Chair: Loa Andersson
                  <mailto:loa@pi.nu>

        WG Chair: Ross Callon
                  <mailto:rcallon@juniper.net>

        WG Chair: George Swallow
                  <mailto:swallow.ietf@gmail.com>

        Editor:   Kamran Raza
                  <mailto:skraza@cisco.com>

        Editor:   Rajiv Asati
                  <mailto:rajiva@cisco.com>

        Editor:   Xufeng Liu
                  <mailto:Xufeng_Liu@jabil.com>

        Editor:   Santosh Esale
                  <mailto:sesale@juniper.net>

        Editor:   Xia Chen
                  <mailto:jescia.chenxia@huawei.com>

        Editor:   Himanshu Shah
                  <mailto:hshah@ciena.com>";

     description
       "This YANG module defines the essential components for the
        management of Multi-Protocol Label Switching (MPLS) Multipoint

Raza, et al.            Expires January 17, 2019               [Page 33]
Internet-Draft        YANG Data Model for MPLS mLDP            July 2018

        LDP (mLDP).";

     revision 2017-10-19 {
       description
         "Initial revision.";
       reference
         "RFC XXXX: YANG Data Model for MPLS mLDP.";
     }

     /*
      * Features
      */
     feature capability-mldp-hsmp {
       description
         "This feature indicates that the system allows to configure
          mLDP hub-and-spoke-multipoint capability.";
     }

     feature capability-mldp-node-protection {
       description
         "This feature indicates that the system allows to configure
          mLDP node-protection capability.";
     }

     feature mldp-mofrr {
       description
         "This feature indicates that the system supports mLDP
          Multicast only FRR (MoFRR).";
     }

     feature per-peer-capability {
       description
         "This feature indicates that the system allows to configure
          mLDP capabilities at the per peer level.";
     }

     /*
      * Typedefs
      */
     typedef route-distinguisher {
       type string {
       }
       description
         "Type definition for route distinguisher.";
       reference
         "RFC4364: BGP/MPLS IP Virtual Private Networks (VPNs).";
     }

Raza, et al.            Expires January 17, 2019               [Page 34]
Internet-Draft        YANG Data Model for MPLS mLDP            July 2018

     typedef mofrr-role {
       type enumeration {
         enum none {
           description "MOFRR is not enabled.";
         }
         enum primary {
           description "This LSP is primary.";
         }
         enum backup {
           description "This LSP is backup.";
         }
       }
       description
         "This type represents the MOFRR (Multicast only FRR) role
          status of a LSP.";
     }

     /*
      * Groupings
      */
     grouping  mldp-ext-binding-label-state-attributes {
       description
         "mLDP label binding attributes.";

       list peer {
         key "direction peer advertisement-type";
         description
           "List of advertised and received peers.";
         uses mldp:mldp-binding-label-peer-state-attributes;

         leaf mofrr-role {
           when "../direction = 'upstream'" {
             description
               "For upstream.";
           }
           type mofrr-role;
           description
             "The MOFRR status of this LSP.";
         }
       } // peer
     } // mldp-ext-binding-label-state-attributes

     grouping mldp-ext-capabilities {
       description
         "mLDP extended capabilities.";
       container hub-and-spoke {
         if-feature capability-mldp-hsmp;
         description

Raza, et al.            Expires January 17, 2019               [Page 35]
Internet-Draft        YANG Data Model for MPLS mLDP            July 2018

           "Configure hub-and-spoke-multipoint capability.";
         reference
           "RFC7140: LDP Extensions for Hub and Spoke Multipoint
            Label Switched Path";
         leaf enable {
           type boolean;
           description
             "Enable hub-and-spoke-multipoint.";
         }
       }
       container node-protection {
         if-feature capability-mldp-node-protection;
         description
           "Configure node-protection capability.";
         reference
           "RFC7715: mLDP Node Protection.";
         leaf plr {
           type boolean;
           description
             "Point of Local Repair capable for MP LSP node
              protection.";
         }
         container merge-point {
           description
             "Merge Point capable for MP LSP node protection.";
           leaf enable {
             type boolean;
             description
               "Enable merge point capability.";
           }
           leaf targeted-session-teardown-delay {
             type uint16;
             units seconds;
             description
               "Targeted session teardown delay.";
           }
         } // merge-point
       }
     } // mldp-ext-capabilities

     grouping  mldp-ipv6-configured-lsp-roots {
       description
         "mLDP IPv6 roots containers.";

       container roots {
         description
           "Configured IPv6 multicast LSPs.";

Raza, et al.            Expires January 17, 2019               [Page 36]
Internet-Draft        YANG Data Model for MPLS mLDP            July 2018

         list root {
           key "root-address";
           description
             "List of roots for configured multicast LSPs.";

           leaf root-address {
             type inet:ipv6-address;
             description
               "Root address.";
           }

           choice lsp-key-type {
             description
               "LSP ID based or source-group based .";
             case lsp-id {
               container opaque-type-lspid {
                 description
                   "The type of opaque value element is
                    the generic LSP identifier";
                 list lsp {
                   key "lsp-id";
                   description
                     "List of LSPs.";
                   leaf lsp-id {
                     type uint16;
                     description "ID to identify the LSP.";
                   }
                 } // list lsp
               } // opaque-type-lspid
             } // case lsp-id

             case source-group {
               container opaque-type-transit {
                 description
                   "The type of opaque value element is the transit IPv6
                    source.";
                 list lsp {
                   key "source-address group-address";
                   description
                     "List of LSPs.";
                   leaf source-address {
                     type inet:ipv6-address;
                     description
                       "Source address.";
                   }
                   leaf group-address {
                     type inet:ipv6-address-no-zone;
                     description

Raza, et al.            Expires January 17, 2019               [Page 37]
Internet-Draft        YANG Data Model for MPLS mLDP            July 2018

                       "Group address.";
                   }
                 }
               }
             } // case source-group
           } // choice lsp-key-type
         } // list root
       } // roots
     } // mldp-ipv6-configured-lsp-roots

     grouping mldp-ext-per-af-config-attibutes {
       description
         "mLDP per address family configuration attibutes.";
       container multicast-only-frr {
         if-feature mldp-mofrr;
         description
           "Multicast only FRR (MoFRR) policy.";
         leaf prefix-list {
           type ldp-ext:prefix-list-ref;
           description
             "Enables MoFRR for the specified access list.";
         }
       } // multicast-only-frr
       container recursive-fec {
         description
           "Recursive FEC policy.";
         leaf prefix-list {
           type ldp-ext:prefix-list-ref;
           description
             "Enables recursive FEC for the specified access list.";
         }
       } // recursive-for
     } // mldp-ext-per-af-config-attibutes

     grouping recursive-fec-attibutes {
       description
         "mLDP recursive FEC attibutes.";
       leaf recur-root-address {
         type inet:ip-address;
         description
           "Recursive root address.";
         reference
           "RFC6512: Using Multipoint LDP When the
            Backbone Has No Route to the Root";
       }
       leaf recur-rd {
         type route-distinguisher;
         description

Raza, et al.            Expires January 17, 2019               [Page 38]
Internet-Draft        YANG Data Model for MPLS mLDP            July 2018

           "Route Distinguisher in the VPN-Recursive
            Opaque Value.";
         reference
           "RFC6512: Using Multipoint LDP When the
            Backbone Has No Route to the Root";
       }
       leaf multipoint-type {
         type mldp:multipoint-type;
         description
           "The type of mutipoint, p2mp or mp2mp.";
       }
     } // recursive-fec-attibutes

     /*
      * Configuration data and operational state data nodes
      */
     // Global capability
     augment "/rt:routing/rt:control-plane-protocols/"
       + "ldp:mpls-ldp/ldp:global/ldp:capability/mldp:mldp" {
       description "Augmentation for MLDP global capability.";

       uses mldp-ext-capabilities;
     }

     // Peer capability
     augment "/rt:routing/rt:control-plane-protocols/"
       + "ldp:mpls-ldp/ldp:peers/ldp:peer/ldp:capability" {
       description "Augmentation for MLDP peer capability.";
       container mldp {
         if-feature per-peer-capability;
         description
           "mLDP capabilities.";
         uses mldp:mldp-capabilities;
       }
     }

     // IPv4 config
     augment "/rt:routing/rt:control-plane-protocols/"
       + "ldp:mpls-ldp/ldp:global/mldp:mldp/mldp:address-families/"
       + "mldp:ipv4" {
       description "Augmentation for MLDP IPv4 configuration.";
       uses mldp-ext-per-af-config-attibutes;
     }

     // IPv4 configured-leaf-lsps config
     augment "/rt:routing/rt:control-plane-protocols/"
       + "ldp:mpls-ldp/ldp:global/mldp:mldp/mldp:address-families/"
       + "mldp:ipv4/mldp:configured-leaf-lsps/mldp:opaque-type-lspid/"

Raza, et al.            Expires January 17, 2019               [Page 39]
Internet-Draft        YANG Data Model for MPLS mLDP            July 2018

       + "mldp:fec-label" {
       description
         "Augmentation for MLDP IPv4 configured-leaf-lsps
          configuration for opaque-type-lspid.";
       list recursive-fec {
         key
           "recur-root-address recur-rd";
         description
           "List of recursive opaque values.";
         uses recursive-fec-attibutes;
       } // fec-label
     }

     augment "/rt:routing/rt:control-plane-protocols/"
       + "ldp:mpls-ldp/ldp:global/mldp:mldp/mldp:address-families/"
       + "mldp:ipv4/mldp:configured-leaf-lsps" {
       description
         "Augmentation for MLDP IPv4 configured-leaf-lsps
          configuration.";

       container opaque-type-transit {
         description
           "The type of opaque value element is the transit IPv4
            source.";
         reference
           "RFC6826: Multipoint LDP In-Band Signaling for
            Point-to-Multipoint and
            Multipoint-to-Multipoint Label Switched Paths.";
         list fec-label {
           key
             "root-address source-address group-address "
           + "rd recur-root-address recur-rd";
           description
             "List of FEC to label bindings.";
           leaf root-address {
             type inet:ipv4-address;
             description
               "Root address.";
           }
           leaf source-address {
             type inet:ip-address;
             description
               "Source address.";
           }
           leaf group-address {
             type inet:ip-address-no-zone;
             description

Raza, et al.            Expires January 17, 2019               [Page 40]
Internet-Draft        YANG Data Model for MPLS mLDP            July 2018

               "Group address.";
           }
           leaf rd {
             type route-distinguisher;
             description
               "Route Distinguisher.";
             reference
               "RFC7246: Multipoint Label Distribution
                Protocol In-Band Signaling in a Virtual
                Routing and Forwarding (VRF) Table
                Context.";
           }
           uses recursive-fec-attibutes;
         } // fec-label
       } // opaque-type-transit

       container opaque-type-bidir {
         description
           "The type of opaque value element is
            the generic LSP identifier";
         reference
           "RFC6826: Multipoint LDP In-Band Signaling for
            Point-to-Multipoint and
            Multipoint-to-Multipoint Label Switched
            Paths.";
         list fec-label {
           key
             "root-address rp group-address rd recur-root-address "
           + "recur-rd";
           description
             "List of FEC to label bindings.";
           leaf root-address {
             type inet:ipv4-address;
             description
               "Root address.";
           }
           leaf rp {
             type inet:ip-address;
             description
               "RP address.";
           }
           leaf group-address {
             type inet:ip-address-no-zone;
             description
               "Group address.";
           }
           leaf rd {
             type route-distinguisher;

Raza, et al.            Expires January 17, 2019               [Page 41]
Internet-Draft        YANG Data Model for MPLS mLDP            July 2018

             description
               "Route Distinguisher.";
             reference
               "RFC7246: Multipoint Label Distribution
                Protocol In-Band Signaling in a Virtual
                Routing and Forwarding (VRF) Table
                Context.";
           }
           uses recursive-fec-attibutes;
         } // fec-label
       } // opaque-type-bidir
     }

     // IPv6 config
     augment "/rt:routing/rt:control-plane-protocols/"
       + "ldp:mpls-ldp/ldp:global/mldp:mldp/mldp:address-families/"
       + "ipv6" {
       description "Augmentation for MLDP IPv4 configuration.";
       uses mldp-ext-per-af-config-attibutes;
     }

     // Global forwarding-nexthop
     augment "/rt:routing/rt:control-plane-protocols/"
       + "ldp:mpls-ldp/ldp:global/ldp-ext:forwarding-nexthop/"
       + "ldp-ext:interfaces/ldp-ext:interface/ldp-ext:address-family" {
       description
         "Augmentation for MLDP nexthop forwarding interface.";
       leaf mldp-disable {
         type boolean;
         description
           "Disable mLDP forwarding on the interface.";
       }
     }

     /*
      * Operational state data nodes
      */
     // IPv4 state for per peer bindings
     augment "/rt:routing/rt:control-plane-protocols/"
       + "ldp:mpls-ldp/ldp:global/mldp:mldp/mldp:address-families/"
       + "mldp:ipv4/mldp:roots/mldp:root/mldp:bindings/"
       + "mldp:opaque-type-lspid/mldp:fec-label/mldp:peer" {
       description "Augmentation for MLDP IPv4 state.";

       leaf mofrr-role {
         when "../mldp:direction = 'upstream'" {
           description
             "For upstream.";

Raza, et al.            Expires January 17, 2019               [Page 42]
Internet-Draft        YANG Data Model for MPLS mLDP            July 2018

         }
         type mofrr-role;
         description
           "The MOFRR status of this LSP.";
       }
     }

     // Peer capability state
     augment "/rt:routing/rt:control-plane-protocols/"
       + "ldp:mpls-ldp/ldp:peers/ldp:peer/ldp:received-peer-state/"
       + "ldp:capability/mldp:mldp" {
       description
         "Augmentation for MLDP received peer state capability.";
       container hub-and-spoke {
         description
           "Configure hub-and-spoke-multipoint capability.";
         reference
           "RFC7140: LDP Extensions for Hub and Spoke Multipoint
            Label Switched Path";
         leaf enable {
           type boolean;
           description
             "Enable hub-and-spoke-multipoint.";
         }
       }
       container node-protection {
         description
           "Configure node-protection capability.";
         reference
           "RFC7715: mLDP Node Protection.";
         leaf plr {
           type boolean;
           description
             "Point of Local Repair capable for MP LSP node
              protection.";
         }
         leaf merge-point {
           type boolean;
           description
             "Merge Point capable for MP LSP node protection.";
         } // merge-point
       } // node-protection
     }

     // IPv4 bindings state
     augment "/rt:routing/rt:control-plane-protocols/"
       + "ldp:mpls-ldp/ldp:global/mldp:mldp/mldp:address-families/"
       + "mldp:ipv4/mldp:roots/mldp:root/mldp:bindings" {

Raza, et al.            Expires January 17, 2019               [Page 43]
Internet-Draft        YANG Data Model for MPLS mLDP            July 2018

       description "Augmentation for MLDP IPv4 bindings.";
       container opaque-type-transit {
         description
           "The type of opaque value element is the transit IPv4
            source.";
         reference
           "RFC6826: Multipoint LDP In-Band Signaling for
            Point-to-Multipoint and
            Multipoint-to-Multipoint Label Switched Paths.";
         list fec-label {
           key
             "source-address group-address "
           + "rd recur-root-address recur-rd";
           description
             "List of FEC to label bindings.";
           leaf source-address {
             type inet:ip-address;
             description
               "Source address.";
           }
           leaf group-address {
             type inet:ip-address-no-zone;
             description
               "Group address.";
           }
           leaf rd {
             type route-distinguisher;
             description
               "Route Distinguisher.";
             reference
               "RFC7246: Multipoint Label Distribution
                Protocol In-Band Signaling in a Virtual
                Routing and Forwarding (VRF) Table
                Context.";
           }
           uses recursive-fec-attibutes;
           uses mldp-ext-binding-label-state-attributes;
         } // fec-label
       } // opaque-type-transit

       container opaque-type-bidir {
         description
           "The type of opaque value element is
            the generic LSP identifier";
         reference
           "RFC6826: Multipoint LDP In-Band Signaling for
            Point-to-Multipoint and
            Multipoint-to-Multipoint Label Switched

Raza, et al.            Expires January 17, 2019               [Page 44]
Internet-Draft        YANG Data Model for MPLS mLDP            July 2018

            Paths.";
         list fec-label {
           key
             "rp group-address rd recur-root-address recur-rd";
           description
             "List of FEC to label bindings.";
           leaf rp {
             type inet:ip-address;
             description
               "RP address.";
           }
           leaf group-address {
             type inet:ip-address-no-zone;
             description
               "Group address.";
           }
           leaf rd {
             type route-distinguisher;
             description
               "Route Distinguisher.";
             reference
               "RFC7246: Multipoint Label Distribution
                Protocol In-Band Signaling in a Virtual
                Routing and Forwarding (VRF) Table
                Context.";
           }
           uses recursive-fec-attibutes;
           uses mldp-ext-binding-label-state-attributes;
         } // fec-label
       } // opaque-type-bidir
     }

     // IPv6 bindings state
     augment "/rt:routing/rt:control-plane-protocols/"
       + "ldp:mpls-ldp/ldp:global/mldp:mldp/mldp:address-families/"
       + "ipv6/roots/root/bindings" {
       description "Augmentation for MLDP IPv6 bindings.";
       container opaque-type-transit {
         config false;
         description
           "The type of opaque value element is the transit IPv6
            source.";
         reference
           "RFC6826: Multipoint LDP In-Band Signaling for
            Point-to-Multipoint and
            Multipoint-to-Multipoint Label Switched
            Paths.";
         list fec-label {

Raza, et al.            Expires January 17, 2019               [Page 45]
Internet-Draft        YANG Data Model for MPLS mLDP            July 2018

           key
             "source-address group-address "
           + "rd recur-root-address recur-rd";
           description
             "List of FEC to label bindings.";
           leaf source-address {
             type inet:ip-address;
             description
               "Source address.";
           }
           leaf group-address {
             type inet:ip-address-no-zone;
             description
               "Group address.";
           }
           leaf rd {
             type route-distinguisher;
             description
               "Route Distinguisher.";
             reference
               "RFC7246: Multipoint Label Distribution
                Protocol In-Band Signaling in a Virtual
                Routing and Forwarding (VRF) Table
                Context.";
           }
           uses recursive-fec-attibutes;
           uses mldp-ext-binding-label-state-attributes;
         } // fec-label
       } // opaque-type-transit

       container opaque-type-bidir {
         config false;
         description
           "The type of opaque value element is
            the generic LSP identifier";
         reference
           "RFC6826: Multipoint LDP In-Band Signaling for
            Point-to-Multipoint and
            Multipoint-to-Multipoint Label Switched
            Paths.";
         list fec-label {
           key
             "rp group-address rd recur-root-address recur-rd";
           description
             "List of FEC to label bindings.";
           leaf rp {
             type inet:ip-address;
             description

Raza, et al.            Expires January 17, 2019               [Page 46]
Internet-Draft        YANG Data Model for MPLS mLDP            July 2018

               "RP address.";
           }
           leaf group-address {
             type inet:ip-address-no-zone;
             description
               "Group address.";
           }
           leaf rd {
             type route-distinguisher;
             description
               "Route Distinguisher.";
             reference
               "RFC7246: Multipoint Label Distribution
                Protocol In-Band Signaling in a Virtual
                Routing and Forwarding (VRF) Table
                Context.";
           }
           uses recursive-fec-attibutes;
           uses mldp-ext-binding-label-state-attributes;
         } // fec-label
       } // opaque-type-bidir
     }

     // IPv4 bindings opaque-type-lspid state
     augment "/rt:routing/rt:control-plane-protocols/"
       + "ldp:mpls-ldp/ldp:global/mldp:mldp/mldp:address-families/"
       + "mldp:ipv4/mldp:roots/mldp:root/mldp:bindings/"
       + "mldp:opaque-type-lspid/mldp:fec-label" {
       description
         "Augmentation for MLDP IPv4 bindings with opaque type LSP ID.";
       list recursive-fec {
         key
           "recur-root-address recur-rd";
         description
           "List of recursive opaque values.";
         uses recursive-fec-attibutes;
         uses mldp-ext-binding-label-state-attributes;
       } // fec-label
     }

     // IPv6 bindings opaque-type-lspid state
     augment "/rt:routing/rt:control-plane-protocols/"
       + "ldp:mpls-ldp/ldp:global/mldp:mldp/mldp:address-families/"
       + "ipv6/roots/root/bindings/opaque-type-lspid/fec-label" {
       description
         "Augmentation for MLDP IPv6 bindings with opaque type LSP ID.";
       list recursive-fec {
         key "recur-root-address recur-rd";

Raza, et al.            Expires January 17, 2019               [Page 47]
Internet-Draft        YANG Data Model for MPLS mLDP            July 2018

         config false;
         description
           "List of recursive opaque values.";
         uses recursive-fec-attibutes;
         uses mldp-ext-binding-label-state-attributes;
       } // fec-label
     }

     /*
      * Per AF augmentation
      */
     // IPv6 augmentation
     augment "/rt:routing/rt:control-plane-protocols/"
       + "ldp:mpls-ldp/ldp:global/mldp:mldp/mldp:address-families" {
       description "Augmentation for MLDP IPv6 address family.";
       container ipv6 {
         description
           "IPv6 information.";

         container roots {
           config false;
           description
             "IPv6 multicast LSP roots.";
           list root {
             key "root-address";
             description
               "List of roots for configured multicast LSPs.";

             leaf root-address {
               type inet:ipv6-address;
               description
                 "Root address.";
             }

             leaf is-self {
               type boolean;
               description
                 "This is the root.";
             }

             list reachability {
               key "address interface";
               description
                 "A next hop for reachability to root,
                  as a RIB view.";
               leaf address {
                 type inet:ipv6-address;
                 description

Raza, et al.            Expires January 17, 2019               [Page 48]
Internet-Draft        YANG Data Model for MPLS mLDP            July 2018

                   "The next hop address to reach root.";
               }
               leaf interface {
                 type if:interface-ref;
                 description
                   "Interface connecting to next-hop.";
               }
               leaf peer {
                 type leafref {
                   path
                     "../../../../../../../../ldp:peers/"
                     + "ldp:peer/ldp:lsr-id";
                 }
                 description
                   "LDP peer from which this next hop can be
                    reached.";
               }
             }

             container bindings {
               description
                 "mLDP FEC to label bindings.";
               container opaque-type-lspid {
                 description
                   "The type of opaque value element is
                    the generic LSP identifier";
                 reference
                   "RFC6388: Label Distribution Protocol
                    Extensions for Point-to-Multipoint and
                    Multipoint-to-Multipoint Label Switched
                    Paths.";
                 list fec-label {
                   key
                     "lsp-id";
                   description
                     "List of FEC to label bindings.";
                   leaf lsp-id {
                     type uint32;
                     description "ID to identify the LSP.";
                   }
                   leaf multipoint-type {
                     type mldp:multipoint-type;
                     description
                       "The type of mutipoint, p2mp or mp2mp.";
                   }

                   uses mldp-ext-binding-label-state-attributes;
                 } // fec-label

Raza, et al.            Expires January 17, 2019               [Page 49]
Internet-Draft        YANG Data Model for MPLS mLDP            July 2018

               } // opaque-type-lspid
             } // bindings
           } // list root
         } // roots

         container configured-leaf-lsps {
           description
             "Configured multicast LSPs.";

           container opaque-type-lspid {
             description
               "The type of opaque value element is
                the generic LSP identifier";
             reference
               "RFC6388: Label Distribution Protocol
                Extensions for Point-to-Multipoint and
                Multipoint-to-Multipoint Label Switched
                Paths.";
             list fec-label {
               key
                 "root-address lsp-id";
               description
                 "List of FEC to label bindings.";
               leaf root-address {
                 type inet:ipv6-address;
                 description
                   "Root address.";
               }
               leaf lsp-id {
                 type uint32;
                 description "ID to identify the LSP.";
               }
               leaf multipoint-type {
                 type mldp:multipoint-type;
                 description
                   "The type of mutipoint, p2mp or mp2mp.";
               }
               list recursive-fec {
                 key
                   "recur-root-address recur-rd";
                 description
                   "List of recursive opaque values.";
                 uses recursive-fec-attibutes;
               } // fec-label
             } // fec-label
           } // opaque-type-lspid

           container opaque-type-transit {

Raza, et al.            Expires January 17, 2019               [Page 50]
Internet-Draft        YANG Data Model for MPLS mLDP            July 2018

             description
               "The type of opaque value element is the transit IPv4
                source.";
             reference
               "RFC6826: Multipoint LDP In-Band Signaling for
                Point-to-Multipoint and
                Multipoint-to-Multipoint Label Switched Paths.";
             list fec-label {
               key
                 "root-address source-address group-address "
                 + "rd recur-root-address recur-rd";
               description
                 "List of FEC to label bindings.";
               leaf root-address {
                 type inet:ipv6-address;
                 description
                   "Root address.";
               }
               leaf source-address {
                 type inet:ip-address;
                 description
                   "Source address.";
               }
               leaf group-address {
                 type inet:ip-address-no-zone;
                 description
                   "Group address.";
               }
               leaf rd {
                 type route-distinguisher;
                 description
                   "Route Distinguisher.";
                 reference
                   "RFC7246: Multipoint Label Distribution
                    Protocol In-Band Signaling in a Virtual
                    Routing and Forwarding (VRF) Table
                    Context.";
               }
               uses recursive-fec-attibutes;
             } // fec-label
           } // opaque-type-transit

           container opaque-type-bidir {
             description
               "The type of opaque value element is
                the generic LSP identifier";
             reference
               "RFC6826: Multipoint LDP In-Band Signaling for

Raza, et al.            Expires January 17, 2019               [Page 51]
Internet-Draft        YANG Data Model for MPLS mLDP            July 2018

                Point-to-Multipoint and
                Multipoint-to-Multipoint Label Switched
                Paths.";
             list fec-label {
               key
                 "root-address rp group-address rd recur-root-address "
               + "recur-rd";
               description
                 "List of FEC to label bindings.";
               leaf root-address {
                 type inet:ipv6-address;
                 description
                   "Root address.";
               }
               leaf rp {
                 type inet:ip-address;
                 description
                   "RP address.";
               }
               leaf group-address {
                 type inet:ip-address-no-zone;
                 description
                   "Group address.";
               }
               leaf rd {
                 type route-distinguisher;
                 description
                   "Route Distinguisher.";
                 reference
                   "RFC7246: Multipoint Label Distribution
                    Protocol In-Band Signaling in a Virtual
                    Routing and Forwarding (VRF) Table
                    Context.";
               }
               uses recursive-fec-attibutes;
             } // fec-label
           } // opaque-type-bidir
         } // configured-leaf-lsps
       } // ipv6
     }

     /*
      * Global augmentation
      */

     /*
      * Notifications
      */

Raza, et al.            Expires January 17, 2019               [Page 52]
Internet-Draft        YANG Data Model for MPLS mLDP            July 2018

     augment "/mldp:mpls-mldp-fec-event/mldp:opaque-type/"
       + "mldp:opaque-type-lspid/mldp:opaque-type-lspid" {
       description
         "Augmentation for MLDP notification for opaque-type-lspid.";
       container recursive-fec {
         description
           "Container of recursive opaque values.";
         uses recursive-fec-attibutes;
       } // fec-label
     }

     augment "/mldp:mpls-mldp-fec-event/mldp:opaque-type" {
       description
         "Augmentation for MLDP notification.";
       case opaque-type-transit {
         container opaque-type-transit {
           description
             "The type of opaque value element is the transit IPv4
              source.";
           reference
             "RFC6826: Multipoint LDP In-Band Signaling for
              Point-to-Multipoint and
              Multipoint-to-Multipoint Label Switched Paths.";
           leaf root-address {
             type inet:ip-address;
             description
               "Root address.";
           }
           leaf source-address {
             type inet:ip-address;
             description
               "Source address.";
           }
           leaf group-address {
             type inet:ip-address-no-zone;
             description
               "Group address.";
           }
           leaf rd {
             type route-distinguisher;
             description
               "Route Distinguisher.";
             reference
               "RFC7246: Multipoint Label Distribution
                Protocol In-Band Signaling in a Virtual
                Routing and Forwarding (VRF) Table
                Context.";
           }

Raza, et al.            Expires January 17, 2019               [Page 53]
Internet-Draft        YANG Data Model for MPLS mLDP            July 2018

           uses recursive-fec-attibutes;
         } // opaque-type-transit
       } // opaque-type-transit

       case opaque-type-bidir {
         container opaque-type-bidir {
           description
             "The type of opaque value element is
              the generic LSP identifier";
           reference
             "RFC6826: Multipoint LDP In-Band Signaling for
              Point-to-Multipoint and
              Multipoint-to-Multipoint Label Switched
              Paths.";
           leaf root-address {
             type inet:ip-address;
             description
               "Root address.";
           }
           leaf rp {
             type inet:ip-address;
             description
               "RP address.";
           }
           leaf group-address {
             type inet:ip-address-no-zone;
             description
               "Group address.";
           }
           leaf rd {
             type route-distinguisher;
             description
               "Route Distinguisher.";
             reference
               "RFC7246: Multipoint Label Distribution
                Protocol In-Band Signaling in a Virtual
                Routing and Forwarding (VRF) Table
                Context.";
           }
           uses recursive-fec-attibutes;
         } // opaque-type-bidir
       } // opaque-type-bidir
     }
   }

   <CODE ENDS>

Raza, et al.            Expires January 17, 2019               [Page 54]
Internet-Draft        YANG Data Model for MPLS mLDP            July 2018

                                 Figure 15

10.  Security Considerations

   This mLDP model shares the same security considerations as captured
   in LDP Yang model [I-D.ietf-mpls-ldp-yang].

11.  IANA Considerations

   This document requests the registration of the following URIs in the
   IETF "XML registry" [RFC3688]:

   +------------------------------------------------+------------+-----+
   | URI                                            | Registrant | XML |
   +------------------------------------------------+------------+-----+
   | urn:ietf:params:xml:ns:yang:ietf-mpls-mldp     | The IESG   | N/A |
   |                                                |            |     |
   | urn:ietf:params:xml:ns:yang:ietf-mpls-mldp-    | The IESG   | N/A |
   | extended                                       |            |     |
   +------------------------------------------------+------------+-----+

   This document requests the registration of the following YANG modules
   in the "YANG Module Names" registry [RFC6020]:

   +----------------+--------------------------------+--------+--------+
   | Name           | Namespace                      | Prefix | Refere |
   |                |                                |        | nce    |
   +----------------+--------------------------------+--------+--------+
   | ietf-mpls-mldp | urn:ietf:params:xml:ns:yang    | mldp   | This d |
   |                | :ietf-mpls-mldp                |        | ocumen |
   |                |                                |        | t      |
   |                |                                |        |        |
   | ietf-mpls-     | urn:ietf:params:xml:ns:yang    | mldp-  | This d |
   | mldp-extended  | :ietf-mpls-mldp-extended       | ext    | ocumen |
   |                |                                |        | t      |
   +----------------+--------------------------------+--------+--------+

12.  Acknowledgments

   The authors would like to acknowledge Ladislav Lhotka for his useful
   comments as the YANG Doctor.

13.  Normative References

   [I-D.ietf-mpls-ldp-yang]
              Raza, K., Asati, R., Liu, X., Esale, S., Chen, X., and H.
              Shah, "YANG Data Model for MPLS LDP", draft-ietf-mpls-ldp-
              yang-04 (work in progress), March 2018.

Raza, et al.            Expires January 17, 2019               [Page 55]
Internet-Draft        YANG Data Model for MPLS mLDP            July 2018

   [I-D.ietf-netmod-rfc6087bis]
              Bierman, A., "Guidelines for Authors and Reviewers of YANG
              Data Model Documents", draft-ietf-netmod-rfc6087bis-20
              (work in progress), March 2018.

   [RFC2119]  Bradner, S., "Key words for use in RFCs to Indicate
              Requirement Levels", BCP 14, RFC 2119,
              DOI 10.17487/RFC2119, March 1997,
              <https://www.rfc-editor.org/info/rfc2119>.

   [RFC3688]  Mealling, M., "The IETF XML Registry", BCP 81, RFC 3688,
              DOI 10.17487/RFC3688, January 2004,
              <https://www.rfc-editor.org/info/rfc3688>.

   [RFC6020]  Bjorklund, M., Ed., "YANG - A Data Modeling Language for
              the Network Configuration Protocol (NETCONF)", RFC 6020,
              DOI 10.17487/RFC6020, October 2010,
              <https://www.rfc-editor.org/info/rfc6020>.

   [RFC6388]  Wijnands, IJ., Ed., Minei, I., Ed., Kompella, K., and B.
              Thomas, "Label Distribution Protocol Extensions for Point-
              to-Multipoint and Multipoint-to-Multipoint Label Switched
              Paths", RFC 6388, DOI 10.17487/RFC6388, November 2011,
              <https://www.rfc-editor.org/info/rfc6388>.

   [RFC6389]  Aggarwal, R. and JL. Le Roux, "MPLS Upstream Label
              Assignment for LDP", RFC 6389, DOI 10.17487/RFC6389,
              November 2011, <https://www.rfc-editor.org/info/rfc6389>.

   [RFC6512]  Wijnands, IJ., Rosen, E., Napierala, M., and N. Leymann,
              "Using Multipoint LDP When the Backbone Has No Route to
              the Root", RFC 6512, DOI 10.17487/RFC6512, February 2012,
              <https://www.rfc-editor.org/info/rfc6512>.

   [RFC6826]  Wijnands, IJ., Ed., Eckert, T., Leymann, N., and M.
              Napierala, "Multipoint LDP In-Band Signaling for Point-to-
              Multipoint and Multipoint-to-Multipoint Label Switched
              Paths", RFC 6826, DOI 10.17487/RFC6826, January 2013,
              <https://www.rfc-editor.org/info/rfc6826>.

   [RFC7060]  Napierala, M., Rosen, E., and IJ. Wijnands, "Using LDP
              Multipoint Extensions on Targeted LDP Sessions", RFC 7060,
              DOI 10.17487/RFC7060, November 2013,
              <https://www.rfc-editor.org/info/rfc7060>.

Raza, et al.            Expires January 17, 2019               [Page 56]
Internet-Draft        YANG Data Model for MPLS mLDP            July 2018

   [RFC7140]  Jin, L., Jounay, F., Wijnands, IJ., and N. Leymann, "LDP
              Extensions for Hub and Spoke Multipoint Label Switched
              Path", RFC 7140, DOI 10.17487/RFC7140, March 2014,
              <https://www.rfc-editor.org/info/rfc7140>.

   [RFC7246]  Wijnands, IJ., Ed., Hitchen, P., Leymann, N., Henderickx,
              W., Gulko, A., and J. Tantsura, "Multipoint Label
              Distribution Protocol In-Band Signaling in a Virtual
              Routing and Forwarding (VRF) Table Context", RFC 7246,
              DOI 10.17487/RFC7246, June 2014,
              <https://www.rfc-editor.org/info/rfc7246>.

   [RFC7438]  Wijnands, IJ., Ed., Rosen, E., Gulko, A., Joorde, U., and
              J. Tantsura, "Multipoint LDP (mLDP) In-Band Signaling with
              Wildcards", RFC 7438, DOI 10.17487/RFC7438, January 2015,
              <https://www.rfc-editor.org/info/rfc7438>.

   [RFC7715]  Wijnands, IJ., Ed., Raza, K., Atlas, A., Tantsura, J., and
              Q. Zhao, "Multipoint LDP (mLDP) Node Protection",
              RFC 7715, DOI 10.17487/RFC7715, January 2016,
              <https://www.rfc-editor.org/info/rfc7715>.

   [RFC8342]  Bjorklund, M., Schoenwaelder, J., Shafer, P., Watsen, K.,
              and R. Wilton, "Network Management Datastore Architecture
              (NMDA)", RFC 8342, DOI 10.17487/RFC8342, March 2018,
              <https://www.rfc-editor.org/info/rfc8342>.

Appendix A.  Additional Contributors

   Matthew Bocci
   Nokia
   Email: matthew.bocci@nokia.com

Authors' Addresses

   Kamran Raza
   Cisco Systems, Inc.
   2000 Innovation Drive
   Kanata, ON  K2K-3E8
   CA
   Email: skraza@cisco.com

   Rajiv Asati
   Cisco Systems, Inc.
   Email: rajiva@cisco.com

Raza, et al.            Expires January 17, 2019               [Page 57]
Internet-Draft        YANG Data Model for MPLS mLDP            July 2018

   Sowmya Krishnaswamy
   Cisco Systems, Inc.
   Email: sowkrish@cisco.com

   Xufeng Liu
   Volta Networks
   Email: xufeng.liu.ietf@gmail.com

   Jeff Tantsura
   Nuage Networks
   Email: jefftant.ietf@gmail.com

   Santosh Esale
   Juniper Networks
   Email: sesale@juniper.net

   Xia Chen
   Huawei Technologies
   Email: jescia.chenxia@huawei.com

   Loa Andersson
   Huawei Technologies
   Email: loa@pi.nu

   Himanshu Shah
   Ciena Corporation
   Email: hshah@ciena.com

Raza, et al.            Expires January 17, 2019               [Page 58]