[Docs] [txt|pdf] [Tracker] [Email] [Nits]

Versions: 00 draft-zhao-pim-igmp-mld-snooping-yang

Internet Engineering Task Force                                 H. Zhao
Internet Draft                                                 Ericsson
Intended status: Standards Track                       February 6, 2017
Expires: August 2017



                A Yang Data Model for IGMP and MLD Snooping
                 draft-zhao-igmp-mld-snooping-yang-00.txt




Abstract

   This document defines a YANG data model that can be used to
configure and manage Internet Group Management Protocol (IGMP) and
Multicast Listener Discovery (MLD) Snooping devices.

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), its areas, and its working groups.  Note that
   other groups may also distribute working documents as Internet-
   Drafts.

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

   The list of current Internet-Drafts can be accessed at
   http://www.ietf.org/ietf/1id-abstracts.txt

   The list of Internet-Draft Shadow Directories can be accessed at
   http://www.ietf.org/shadow.html

   This Internet-Draft will expire on August 6, 2017.

Copyright Notice

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





Zhao                    Expires August 6, 2017                 [Page 1]


Internet-Draft      IGMP & MLD Snooping Yang Model        February 2017


   This document is subject to BCP 78 and the IETF Trust's Legal
   Provisions Relating to IETF Documents
   (http://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...................................................2
      1.1. Terminology...............................................2
      1.2. Tree Diagrams.............................................3
   2. Design of Data Model...........................................3
      2.1. Overview..................................................3
      2.2. IGMP and MLD Snooping Configuration.......................3
      2.3. IGMP and MLD Snooping Operational State...................6
      2.4. IGMP and MLD Snooping RPC................................10
   3. IGMP and MLD Snooping YANG Module.............................10
   4. Security Considerations.......................................26
   5. IANA Considerations...........................................26
   6. Normative References..........................................26

1. Introduction

   This document defines a YANG [RFC6020] data model for the management
   of Internet Group Management Protocol (IGMP) and Multicast Listener
   Discovery (MLD) Snooping devices.

   This data model includes configuration data and state data (status
   information and counters for the collection of statistics).

1.1. Terminology

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

   The terminology for describing YANG data models is found in[RFC6020].




Zhao                    Expires August 6, 2017                 [Page 2]


Internet-Draft      IGMP & MLD Snooping Yang Model        February 2017


1.2. Tree Diagrams

   A simplified graphical representation of the data model is used in
   this document.  The meaning of the symbols in these diagrams is as
   follows:

   o  Brackets "[" and "]" enclose list keys.

   o  Abbreviations before data node names: "rw" means configuration
   (read-write), and "ro" means state data (read-only).

   o  Symbols after data node names: "?" means an optional node, "!"
   means a presence container, and "*" denotes a list and leaf-list.

   o  Parentheses enclose choice and case nodes, and case nodes are also
   marked with a colon (":").

   o  Ellipsis ("...") stands for contents of subtrees that are not
   shown.

2. Design of Data Model

   The model covers Considerations for Internet Group Management
   Protocol (IGMP) and Multicast Listener Discovery (MLD) Snooping
   Switches [RFC4541].

   The goal of this document is to define a data model that provides a
   common user interface to IGMP and MLD Snooping.  There is very
   information that is designated as "mandatory", providing freedom for
   vendors to adapt this data model to their respective product
   implementations.

2.1. Overview

   The IGMP and MLD Snooping YANG module defined in this document has
   all the common building blocks for the IGMP and MLD Snooping
   protocol. The YANG module includes IGMP and MLD Snooping
   configuration data, Operational state data, and the rpc method for
   clearing the specified IGMP and MLD Snooping statistics.



2.2. IGMP and MLD Snooping Configuration

   The IGMP and MLD Snooping modules define the configuration in a two-
   level hierarchy as listed below:



Zhao                    Expires August 6, 2017                 [Page 3]


Internet-Draft      IGMP & MLD Snooping Yang Model        February 2017


   Global level: IGMP MLD Snooping configuration attributes for the
   entire routing instance

   VLAN-level: IGMP MLD configuration attributes specific to the given
   VLAN.



   module: ietf-igmp-mld-snooping

      +--rw configuration

      |  +--rw igmp-snooping

      |  |  +--rw global

      |  |  |  +--rw enable?   boolean {global-admin-enable}?

      |  |  +--rw vlans

      |  |     +--rw vlan* [vlan-id]

      |  |        +--rw vlan-id                       uint16

      |  |        +--rw enable?                       boolean {admin-enable}?

      |  |        +--rw forwarding-mode?              enumeration

      |  |        +--rw explicit-tracking?            string

      |  |        +--rw send-query?                   boolean

      |  |        +--rw mrouter-learning?             boolean

      |  |        +--rw mrouter-aging-time?           uint16

      |  |        +--rw fast-leave?                   empty {fast-leave}?

      |  |        +--rw last-member-query-interval?   uint16

      |  |        +--rw query-interval?               uint16

      |  |        +--rw max-response-time?            uint16

      |  |        +--rw require-router-alert?         boolean {require-router-alert}?

      |  |        +--rw robustness-variable?          uint8


Zhao                    Expires August 6, 2017                 [Page 4]


Internet-Draft      IGMP & MLD Snooping Yang Model        February 2017


      |  |        +--rw source-policy?                string {source-policy}?

      |  |        +--rw verify-source-subnet?         empty {verify-source-subnet}?

      |  |        +--rw version?                      uint8

      |  |        +--rw ssm-map* [source-addr group-addr-prefix] {ssm-map}?

      |  |        |  +--rw source-addr          ssm-map-ipv4-addr-type

      |  |        |  +--rw group-addr-prefix    inet:ipv4-prefix

      |  |        +--rw static-mrouter-interface*     if:interface-ref

      |  |        +--rw static-l2-multicast-group* [group]

      |  |           +--rw group        inet:ipv4-address

      |  |           +--rw interface?   if:interface-ref

      |  +--rw mld-snooping

      |     +--rw global

      |     |  +--rw enable?   boolean {global-admin-enable}?

      |     +--rw vlans

      |        +--rw vlan* [vlan-id]

      |           +--rw vlan-id                       uint16

      |           +--rw enable?                       boolean {admin-enable}?

      |           +--rw forwarding-mode?              enumeration

      |           +--rw explicit-tracking?            string

      |           +--rw send-query?                   boolean

      |           +--rw mrouter-learning?             boolean

      |           +--rw mrouter-aging-time?           uint16

      |           +--rw fast-leave?                   empty {fast-leave}?

      |           +--rw last-member-query-interval?   uint16


Zhao                    Expires August 6, 2017                 [Page 5]


Internet-Draft      IGMP & MLD Snooping Yang Model        February 2017


      |           +--rw query-interval?               uint16

      |           +--rw max-response-time?            uint16

      |           +--rw require-router-alert?         boolean {require-router-alert}?

      |           +--rw robustness-variable?          uint8

      |           +--rw source-policy?                string {source-policy}?

      |           +--rw verify-source-subnet?         empty {verify-source-subnet}?

      |           +--rw version?                      uint8

      |           +--rw ssm-map* [source-addr group-addr-prefix] {ssm-map}?

      |           |  +--rw source-addr          ssm-map-ipv6-addr-type

      |           |  +--rw group-addr-prefix    inet:ipv6-prefix

      |           +--rw static-mrouter-interface*     if:interface-ref

      |           +--rw static-l2-multicast-group* [group]

      |              +--rw group        inet:ipv4-address

      |              +--rw interface?   if:interface-ref

2.3. IGMP and MLD Snooping Operational State

   The IGMP and MLD Snooping module contains operational state
   information also in a two-level hierarchy as mentioned earlier.

   Global level: IGMP MLD Snooping operational state attributes for the
   entire routing instance

   VLAN-level: IGMP MLD Snooping operational state attributes specific
   to the given VLAN.

   module: ietf-igmp-mld-snooping

      +--rw configuration

      ...

      +--ro state



Zhao                    Expires August 6, 2017                 [Page 6]


Internet-Draft      IGMP & MLD Snooping Yang Model        February 2017


         +--ro igmp-snooping

         |  +--ro global

         |  |  +--ro enable?          boolean {global-admin-enable}?

         |  |  +--ro entries-count?   uint32

         |  +--ro vlans

         |     +--ro vlan* [vlan-id]

         |        +--ro vlan-id                       uint16

         |        +--ro enable?                       boolean {admin-enable}?

         |        +--ro forwarding-mode?              enumeration

         |        +--ro explicit-tracking?            string

         |        +--ro send-query?                   boolean

         |        +--ro mrouter-learning?             boolean

         |        +--ro mrouter-aging-time?           uint16

         |        +--ro fast-leave?                   empty {fast-leave}?

         |        +--ro last-member-query-interval?   uint16

         |        +--ro query-interval?               uint16

         |        +--ro max-response-time?            uint16

         |        +--ro require-router-alert?         boolean {require-router-alert}?

         |        +--ro robustness-variable?          uint8

         |        +--ro source-policy?                string {source-policy}?

         |        +--ro verify-source-subnet?         empty {verify-source-subnet}?

         |        +--ro version?                      uint8

         |        +--ro ssm-map* [source-addr group-addr-prefix] {ssm-map}?

         |        |  +--ro source-addr          ssm-map-ipv4-addr-type


Zhao                    Expires August 6, 2017                 [Page 7]


Internet-Draft      IGMP & MLD Snooping Yang Model        February 2017


         |        |  +--ro group-addr-prefix    inet:ipv4-prefix

         |        +--ro mrouter*                      if:interface-ref

         |        +--ro port-info*                    if:interface-ref

         |        +--ro mac-address*                  yang:phys-address

         |        +--ro querier?                      inet:ipv4-address

         |        +--ro group* [address]

         |           +--ro address    inet:ipv4-address

         |           +--ro source* [address]

         |              +--ro address        inet:ipv4-address

         |              +--ro reporter?      inet:ipv4-address

         |              +--ro filter-mode?   enumeration

         |              +--ro interface?     if:interface-ref

         |              +--ro up-time?       uint32

         |              +--ro last-join?     uint32

         |              +--ro last-leave?    uint32

         +--ro mld-snooping

            +--ro global

            |  +--ro enable?          boolean {global-admin-enable}?

            |  +--ro entries-count?   uint32

            +--ro vlans

               +--ro vlan* [vlan-id]

                  +--ro vlan-id                       uint16

                  +--ro enable?                       boolean {admin-enable}?

                  +--ro forwarding-mode?              enumeration


Zhao                    Expires August 6, 2017                 [Page 8]


Internet-Draft      IGMP & MLD Snooping Yang Model        February 2017


                  +--ro explicit-tracking?            string

                  +--ro send-query?                   boolean

                  +--ro mrouter-learning?             boolean

                  +--ro mrouter-aging-time?           uint16

                  +--ro fast-leave?                   empty {fast-leave}?

                  +--ro last-member-query-interval?   uint16

                  +--ro query-interval?               uint16

                  +--ro max-response-time?            uint16

                  +--ro require-router-alert?         boolean {require-router-alert}?

                  +--ro robustness-variable?          uint8

                  +--ro source-policy?                string {source-policy}?

                  +--ro verify-source-subnet?         empty {verify-source-subnet}?

                  +--ro version?                      uint8

                  +--ro ssm-map* [source-addr group-addr-prefix] {ssm-map}?

                  |  +--ro source-addr          ssm-map-ipv6-addr-type

                  |  +--ro group-addr-prefix    inet:ipv6-prefix

                  +--ro mrouter*                      if:interface-ref

                  +--ro port-info*                    if:interface-ref

                  +--ro mac-address*                  yang:phys-address

                  +--ro querier?                      inet:ipv6-address

                  +--ro group* [address]

                     +--ro address    inet:ipv6-address

                     +--ro source* [address]

                        +--ro address        inet:ipv6-address


Zhao                    Expires August 6, 2017                 [Page 9]


Internet-Draft      IGMP & MLD Snooping Yang Model        February 2017


                        +--ro reporter?      inet:ipv6-address

                        +--ro filter-mode?   enumeration

                        +--ro interface?     if:interface-ref

                        +--ro up-time?       uint32

                        +--ro last-join?     uint32

                        +--ro last-leave?    uint32



2.4. IGMP and MLD Snooping RPC

   IGMP and MLD Snooping RPC clears the specified IGMP and MLD Snooping
   statistics.

   rpcs:

      +---x clear-igmp-mld-snooping-statistics     {rpc-clear-statistics}?

         +---w input

            +---w vlan-id?   uint16



3. IGMP and MLD Snooping YANG Module

   <CODE BEGINS> file "ietf-igmp-mld-snooping@2017-02-05.yang"
   module ietf-igmp-mld-snooping {
         namespace "urn:ietf:params:xml:ns:yang:ietf-igmp-mld-snooping";
         // replace with IANA namespace when assigned
         prefix igmp-mld-snooping;

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

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

         import ietf-interfaces {
           prefix "if";


Zhao                    Expires August 6, 2017                [Page 10]


Internet-Draft      IGMP & MLD Snooping Yang Model        February 2017


         }

         organization
           "IETF PIM Working Group";

         contact
           "WG Web:   <http://tools.ietf.org/wg/pim/>
            WG List:  <mailto:pim@ietf.org>

            WG Chair: Stig Venaas
                      <mailto:stig@venaas.com>

            WG Chair: Mike McBride
                      <mailto:mmcbride7@gmail.com>

            Editors:  Hongji Zhao
                  <mailto:hongji.zhao@ericsson.com> ";

         description
           "The module defines a collection of YANG definitions common
   for
           IGMP and MLD Snooping.";

         revision 2017-02-05 {
           description
             "Initial revision.";
           reference
             "RFC XXXX: A YANG Data Model for IGMP and MLD Snooping";
         }

         /*
          * Features
          */
         feature global-admin-enable {
           description
             "Support global configuration to enable or disable IGMP and
   MLD Snooping.";
         }

         feature admin-enable {
           description
             "Support configuration to enable or disable protocol under
   VLAN instance.";
         }

         feature fast-leave {
           description


Zhao                    Expires August 6, 2017                [Page 11]


Internet-Draft      IGMP & MLD Snooping Yang Model        February 2017


             "Support configuration of fast-leave.";
         }

         feature join-group {
           description
             "Support configuration of join-group.";
         }

         feature require-router-alert {
           description
             "Support configuration of require-router-alert.";
         }

         feature source-policy {
           description
             "Support configuration of source policy.";
         }

         feature ssm-map {
           description
             "Support configuration of ssm-map.";
         }

         feature static-l2-multicast-group {
           description
             "Support configuration of L2 multicast static-group.";
         }

         feature verify-source-subnet {
           description
             "Support configuration of verify-source-subnet.";
         }

         feature per-vlan-config {
           description
             "Support configuration of each VLAN.";
         }

        feature rpc-clear-statistics {
           description
             "Support to clear statistics by RPC for IGMP and MLD
   Snooping.";
         }


         /*
          * Typedefs


Zhao                    Expires August 6, 2017                [Page 12]


Internet-Draft      IGMP & MLD Snooping Yang Model        February 2017


          */
         typedef ssm-map-ipv4-addr-type {
           type union {
             type enumeration {
               enum 'policy' {
                 description
                 "Source address in SSM map policy.";
               }
             }
             type inet:ipv4-address;
           }
           description
             "Source IPV4 address type for SSM map.";
         } // ssm-map-ipv4-addr-type

         typedef ssm-map-ipv6-addr-type {
           type union {
             type enumeration {
               enum 'policy' {
                 description
                 "Source address in SSM map policy.";
               }
             }
             type inet:ipv6-address;
           }
           description
             "Source IPV6 address type for SSM map.";
         } // ssm-map-ipv6-addr-type



         /*
          * Identities
          */

         /*
          * Groupings
          */
         grouping global-config-attributes {
           description "Global configuration of IGMP and MLD Snooping.";

           leaf enable {
             if-feature global-admin-enable;
             type boolean;

             description



Zhao                    Expires August 6, 2017                [Page 13]


Internet-Draft      IGMP & MLD Snooping Yang Model        February 2017


      "Set the value to true to enable IGMP or MLD Snooping in the
   global view";
           }


         } // global-config-attributes

         grouping global-state-attributes {
           description  "Global attributes of IGMP and MLD Snooping
   state";
           leaf entries-count {
             type uint32;
             description
               "The number of L2 multicast entries in IGMP and MLD
   Snooping.";
           }


         } // global-state-attributes

         grouping vlan-config-attributes-igmp-snooping {
           description "IGMP snooping configuration of each VLAN.";

           uses vlan-config-attributes-igmp-mld-snooping;

           list ssm-map {

             if-feature ssm-map;
             key "source-addr group-addr-prefix";
           description "SSM mapping list for igmp snooping";

             leaf source-addr {
               type ssm-map-ipv4-addr-type;
               description
                 "Source IP address.";
             }
             leaf group-addr-prefix {
               type inet:ipv4-prefix;
               description
                 "Multicast group IP address for ssm-map in the format
   of x.x.x.x/x ";
             }
           }


         } // vlan-config-attributes-igmp-snooping



Zhao                    Expires August 6, 2017                [Page 14]


Internet-Draft      IGMP & MLD Snooping Yang Model        February 2017


         grouping vlan-config-attributes-igmp-mld-snooping {
           description
             "IGMP and MLD Snooping configuration of each VLAN.";

           leaf enable {
             if-feature admin-enable;
             type boolean;
             description
               "Set the value to true to enable IGMP and MLD Snooping in
   the VLAN instance.";
           }

         leaf forwarding-mode {
            type enumeration {
               enum "mac" {
                description
                  "";
               }
               enum "ip"  {
                description
                  "";
               }
            }
            description "The default forwarding mode for IGMP and MLD
   Snooping is ip.";
         }

         leaf explicit-tracking {
            when "../version = 3";
            type string;
            description "Tracks IGMPv3 membership reports from
   individual hosts for each port of each VLAN. ";
         }

         leaf send-query {
            type boolean;
            default true;
            description "Enable quick response for topo changes";
         }

         leaf mrouter-learning {
            type boolean;
            default true;
            description
               "Enable router port learning function";
         }



Zhao                    Expires August 6, 2017                [Page 15]


Internet-Draft      IGMP & MLD Snooping Yang Model        February 2017


         leaf mrouter-aging-time {
            type uint16 ;
            default 180;
            description "Aging time for mrouter port";
         }


           leaf fast-leave {
             if-feature fast-leave;
             type empty;
             description
               "When fast leave is enabled, the IGMP software assumes
   that no more than one host is present on each VLAN port.";
           }
           leaf last-member-query-interval {
             type uint16 {
               range "1..65535";
             }
             description
               " Modify the value to adjust the leave latency of the
   network.";
           }

           leaf query-interval {
             type uint16;
             units seconds;
             default 125;
             description
               "Interval between general queries sent by the querier.";
           }
           leaf max-response-time {
             type uint16;
             units seconds;
             description
               "Maximum time for the host to respond the query packet.";

           }
           leaf require-router-alert {
             if-feature require-router-alert;
             type boolean;
             description
               "When the value is true, router alert exists in the IP
   head of IGMP or MLD packet.";
           }
           leaf robustness-variable {
             type uint8 {
               range "2..7";


Zhao                    Expires August 6, 2017                [Page 16]


Internet-Draft      IGMP & MLD Snooping Yang Model        February 2017


             }
             default 2;
             description
               "Adjust the value for the expected packet loss on the
   network.";

           }
           leaf source-policy {
             if-feature source-policy;
             type string;
             description
               "Name of the access policy used to filter sources.";
           }
           leaf verify-source-subnet {
             if-feature verify-source-subnet;
             type empty;
             description
               "If the value is present, the interface accepts packets
   with matching source IP subnet only.";
           }
           leaf version {
             type uint8 {
               range "1..3";
             }
             description "IGMP and MLD Snooping version.";
           }
         } // vlan-config-attributes-igmp-mld-snooping

         grouping vlan-config-attributes-mld-snooping {
           description "MLD snooping configuration of each VLAN.";

           uses vlan-config-attributes-igmp-mld-snooping;


           list ssm-map {
             if-feature ssm-map;
             key "source-addr group-addr-prefix";
             description "SSM mapping list for MLD snooping";
             leaf source-addr {
               type ssm-map-ipv6-addr-type;
               description
                 "Source IP address.";
             }
             leaf group-addr-prefix {
               type inet:ipv6-prefix;
               description
                 "Multicast group IP address for ssm-map";


Zhao                    Expires August 6, 2017                [Page 17]


Internet-Draft      IGMP & MLD Snooping Yang Model        February 2017


             }
           }

         } // vlan-config-attributes-mld-snooping

         grouping vlan-state-attributes-igmp-snooping {
           description
             "State attributes for IGMP snooping of each VLAN.";

           uses vlan-state-attributes-igmp-mld-snooping;

           leaf querier {
             type inet:ipv4-address;
             description "Configures a snooping querier when PIM is
   disabled because multicast traffic does not need to be routed. The IP
   address is used as the source address in messages.";
           }


           list group {
             key "address";
             description "IGMP snooping information";

             leaf address {
               type inet:ipv4-address;
               description
                 "Multicast group IP address";
             }


             list source {
               key "address";
            description "Source IP address for multicast stream";
               leaf address {
                 type inet:ipv4-address;
                 description "Source IP address for multicast stream";
               }

            leaf reporter {
               type inet:ipv4-address;
               description "The reporter IP address behind the port";
            }

               uses vlan-state-group-attributes-igmp-mld-snooping;

             } // list source
           } // list group


Zhao                    Expires August 6, 2017                [Page 18]


Internet-Draft      IGMP & MLD Snooping Yang Model        February 2017


         } // vlan-state-attributes-igmp-snooping

         grouping vlan-state-attributes-igmp-mld-snooping {
           description
             "State attributes for both IGMP and MLD Snooping of each
   VLAN.";

           leaf-list mrouter {
            type if:interface-ref;
            description "The interfaces that connect to the multicast
   router";
           }

           leaf-list port-info {
            type if:interface-ref;
            description "The port-info shows the interfaces that attach
   the hosts, which join in the multicast group";
           }

           leaf-list mac-address {
            type yang:phys-address;
            description "Destination mac address for L2 multicast
   forwarding.";
           }

         } // vlan-config-attributes-igmp-mld-snooping

         grouping vlan-state-attributes-mld-snooping {
           description
             "State attributes for MLD snooping of each VLAN.";

           uses vlan-state-attributes-igmp-mld-snooping;

           leaf querier {
             type inet:ipv6-address;
             description
            "Configures a snooping querier when PIM is disabled because
   multicast traffic does not need to be routed.";
           }

           list group {
             key "address";
             description "MLD snooping statistics information";

             leaf address {
               type inet:ipv6-address;
               description


Zhao                    Expires August 6, 2017                [Page 19]


Internet-Draft      IGMP & MLD Snooping Yang Model        February 2017


                 "Multicast group IP address";
             }

             list source {
               key "address";
            description "Source IP address for multicast stream";

               leaf address {
                 type inet:ipv6-address;
                 description "Source IP address for multicast stream";
               }

            leaf reporter {
               type inet:ipv6-address;
               description "The reporter IP address behind the port";
            }

               uses vlan-state-group-attributes-igmp-mld-snooping;

             } // list source
           } // list group
         } // vlan-state-attributes-mld-snooping

         grouping vlan-state-group-attributes-igmp-mld-snooping {
           description
             "State attributes for both IGMP and MLD Snooping of each
   VLAN.";

           leaf filter-mode {
             type enumeration {
               enum "include" {
                 description
                 "";
               }
               enum "exclude" {
                 description
                 "";
               }
             }
             description "Allow (include) or block (exclude) filtering
   ";
           }

         leaf interface {
            type if:interface-ref;
            description
            "The outgoing interface for L2 multicast stream.";


Zhao                    Expires August 6, 2017                [Page 20]


Internet-Draft      IGMP & MLD Snooping Yang Model        February 2017


         }

           leaf up-time {
             type uint32;
             units seconds;
             description "The up time for the interface.";
           }

         leaf last-join {
            type uint32;
            units seconds;
            description "The last-join information collected since a
   clear command was entered last time.";
         }

         leaf last-leave {
            type uint32;
            units seconds;
            description "The last-leave information collected since a
   clear command was entered last time.";
         }

         } // vlan-state-group-attributes-igmp-mld-snooping



        grouping vlan-config-static-l2-multicast-group {
           description
             "Configures a L2 static connection to a multicast
   receiver.";

         list static-l2-multicast-group {

            key group;
            description "Multicast group IP address";

            leaf group {
               type inet:ipv4-address;
               description
               "Multicast group IP address";
            }
            leaf interface {
               type if:interface-ref;
               description
               "Interface for static multicast group";
            }
         }


Zhao                    Expires August 6, 2017                [Page 21]


Internet-Draft      IGMP & MLD Snooping Yang Model        February 2017



        } //vlan-config-static-l2-multicast-group

         /*
          * Configuration data nodes
          */
         container configuration
         {
           description
             "IGMP and MLD Snooping configuration data.";

           container igmp-snooping {
             description
               "IGMP Snooping configuration data.";

             container global {
               description
                 "Global attributes.";
               uses global-config-attributes;
             }

             container vlans {
               description
                 "List of VLANs that enable IGMP Snooping.";


               list vlan {
                 key "vlan-id";
                 description
                   "IGMP Snooping config-attributes for each VLAN.";
                 leaf vlan-id {
                   type uint16 {
                  range "1 .. 4094";
               }
                   description
                     "VLAN ID, the range of which is 1 to 4094.";
                 }
                 uses vlan-config-attributes-igmp-snooping {
                   if-feature per-vlan-config;
                 }

              leaf-list static-mrouter-interface {
                type if:interface-ref;
                description "Configures a static connection to a
   multicast router. The interface to the router must be in the selected
   VLAN. The interface is specified by type and number.";
              }


Zhao                    Expires August 6, 2017                [Page 22]


Internet-Draft      IGMP & MLD Snooping Yang Model        February 2017



              uses vlan-config-static-l2-multicast-group {
               if-feature static-l2-multicast-group;
              }

               } // vlan
             } // vlans
           } // igmp-snooping

           container mld-snooping {
             description
               "MLD Snooping configuration data.";

             container global {
               description
                 "Global attributes.";
               uses global-config-attributes;
             }

             container vlans {
               description
                 "List of VLANs that enable IGMP Snooping.";


               list vlan {
                 key "vlan-id";
                 description
                   "IGMP Snooping configuration attributes for each
   VLAN.";

                 leaf vlan-id {
                   type uint16 {
                  range "1 .. 4094";
               }
                   description
                     "VLAN ID, the range of which is 1 to 4094";
                 }

                 uses vlan-config-attributes-mld-snooping {
                   if-feature per-vlan-config;
                 }

               leaf-list static-mrouter-interface {
                type if:interface-ref;
                description "Configures a static connection to a
   multicast router. The interface to the router must be in the selected
   VLAN. The interface is specified by type and number.";


Zhao                    Expires August 6, 2017                [Page 23]


Internet-Draft      IGMP & MLD Snooping Yang Model        February 2017


              }

              uses vlan-config-static-l2-multicast-group {
               if-feature static-l2-multicast-group;
              }


               } // vlan
             } // vlans
           } // mld-snooping
         } //

         /*
          * Operational state data nodes
          */
         container state
         {
         config false;

           description
             "IGMP and MLD Snooping state data.";

           container igmp-snooping {
             description
               "IGMP Snooping operational state data.";

             container global {
               description
                 "Global attributes.";
               uses global-config-attributes;
               uses global-state-attributes;
             }

             container vlans{
               description
                 " List of VLANs that enable IGMP Snooping.";

               list vlan {
                 key "vlan-id";
                 description
                   "IGMP Snooping state-attributes for each VLAN.";
                 leaf vlan-id {
                   type uint16 {
                  range "1 .. 4094";
               }
                   description
                     "VLAN ID, the range of which is 1 to 4094 ";


Zhao                    Expires August 6, 2017                [Page 24]


Internet-Draft      IGMP & MLD Snooping Yang Model        February 2017


                 }
                 uses vlan-config-attributes-igmp-snooping {
                   if-feature per-vlan-config;
                 }
                 uses vlan-state-attributes-igmp-snooping;
               } // vlan
             } // vlans
           } // igmp-snooping

           container mld-snooping {
             description
               "MLD Snooping state data.";

             container global {
               description
                 "Global attributes.";
               uses global-config-attributes;
               uses global-state-attributes;
             }

             container vlans {
               description
                 "List of VLANs that enable MLD Snooping.";

               list vlan {
                 key "vlan-id";
                 description
                   "MLD Snooping state-attributes for each VLAN.";

                 leaf vlan-id {
                   type uint16 {
                  range "1 .. 4094";
               }
                   description
                     "VLAN ID, the range of which is 1 to 4094 ";
                 }
                 uses vlan-config-attributes-mld-snooping {
                   if-feature per-vlan-config;
                 }
                 uses vlan-state-attributes-mld-snooping;
               } // vlan
             } // vlans
           } // mld-snooping
         } //

         /*
          * RPCs


Zhao                    Expires August 6, 2017                [Page 25]


Internet-Draft      IGMP & MLD Snooping Yang Model        February 2017


          */
         //clear ip igmp snooping statistics interface vlan-id

        rpc clear-igmp-mld-snooping-statistics {
           if-feature rpc-clear-statistics;
           description
             "Clears the specified IGMP and MLD Snooping statistics.";

           input {
             leaf vlan-id {
                   type uint16 {
                  range "1 .. 4094";
               }
                   description
                     "VLAN ID, the range of which is 1 to 4094 ";
             }

           }
         } // rpc clear-igmp-mld-snooping-statistics


         /*
          * Notifications
          */
       }
   <CODE ENDS>




4. Security Considerations

   The data model defined does not create any security implications.



5. IANA Considerations

   This draft does not request any IANA action.



6. Normative References

   [RFC6020] Bjorklund, M., Ed., "YANG - A Data Modeling Language for
             the Network Configuration Protocol (NETCONF)", RFC 6020,
             October 2010.


Zhao                    Expires August 6, 2017                [Page 26]


Internet-Draft      IGMP & MLD Snooping Yang Model        February 2017


   [RFC6021] Schoenwaelder, J., Ed., "Common YANG Data Types", RFC 6021,
             October 2010.

   [RFC4541] M. Christensen, K. Kimball, F. Solensky, "Considerations
             for Internet Group Management Protocol (IGMP) and Multicast
             Listener Discovery (MLD) Snooping Switches", RFC 4541, May
             2006.

   [RFC2236] Fenner, W., "Internet Group Management Protocol, Version
             2", RFC 2236, November 1997.

   [RFC2710] Deering, S., Fenner, W., and B. Haberman, "Multicast
             Listener Discovery (MLD) for IPv6", RFC 2710, October 1999.

   [RFC3376] Cain, B., Deering, S., Kouvelas, I., Fenner, B., and A.
             Thyagarajan, "Internet Group Management Protocol, Version
             3", RFC 3376, October 2002.

   [RFC3810] Vida, R. and L. Costa, "Multicast Listener Discovery
             Version 2 (MLDv2) for IPv6", RFC 3810, June 2004.

   [RFC4604] Holbrook, H., Cain, B., and B. Haberman, "Using
             InternetGroup Management Protocol Version 3 (IGMPv3) and
             Multicast Listener Discovery Protocol Version 2 (MLDv2) for
             Source-Specific Multicast", RFC 4604, August 2006.

   [RFC4607] Holbrook, H. and B. Cain, "Source-Specific Multicast for
             IP", RFC 4607, August 2006.

   [draft-ietf-pim-igmp-mld-yang-01] X. Liu, F. Guo, M. Sivakumar, P.
             McAllister, A. Peter, "A YANG data model for Internet Group
             Management Protocol (IGMP) and Multicast Listener Discovery
             (MLD)", draft-ietf-pim-igmp-mld-yang-01, October 28, 2016.





   Authors' Addresses

   Hongji Zhao
   Ericsson (China) Communications Company Ltd.
   Ericsson Tower, No. 5 Lize East Street,
   Chaoyang District Beijing 100102, P.R. China

   Email: hongji.zhao@ericsson.com



Zhao                    Expires August 6, 2017                [Page 27]


Html markup produced by rfcmarkup 1.129c, available from https://tools.ietf.org/tools/rfcmarkup/