A YANG Data Model for the Internet Group Management Protocol (IGMP) and Multicast Listener Discovery (MLD)
RFC 8652

Document Type RFC - Proposed Standard (November 2019; No errata)
Last updated 2019-11-06
Replaces draft-guo-pim-igmp-mld-yang
Stream IETF
Formats plain text xml pdf htmlized bibtex
Yang Validation 0 errors, 1 warnings.
Reviews
Additional URLs
- Yang catalog entry for ietf-igmp-mld@2019-06-12.yang
- Yang impact analysis for draft-ietf-pim-igmp-mld-yang
- Mailing list discussion
Stream WG state Submitted to IESG for Publication
Document shepherd Stig Venaas
Shepherd write-up Show (last changed 2017-11-20)
IESG IESG state RFC 8652 (Proposed Standard)
Consensus Boilerplate Yes
Telechat date
Responsible AD Alvaro Retana
Send notices to Stig Venaas <stig@venaas.com>, aretana.ietf@gmail.com
IANA IANA review state IANA OK - Actions Needed
IANA action state RFC-Ed-Ack


Internet Engineering Task Force (IETF)                            X. Liu
Request for Comments: 8652                                Volta Networks
Category: Standards Track                                         F. Guo
ISSN: 2070-1721                                                   Huawei
                                                            M. Sivakumar
                                                                 Juniper
                                                           P. McAllister
                                                     Metaswitch Networks
                                                                A. Peter
                                                       IP Infusion India
                                                           November 2019

  A YANG Data Model for the Internet Group Management Protocol (IGMP)
                 and Multicast Listener Discovery (MLD)

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) devices.

Status of This Memo

   This is an Internet Standards Track document.

   This document is a product of the Internet Engineering Task Force
   (IETF).  It represents the consensus of the IETF community.  It has
   received public review and has been approved for publication by the
   Internet Engineering Steering Group (IESG).  Further information on
   Internet Standards is available in Section 2 of RFC 7841.

   Information about the current status of this document, any errata,
   and how to provide feedback on it may be obtained at
   https://www.rfc-editor.org/info/rfc8652.

Copyright Notice

   Copyright (c) 2019 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
     1.1.  Terminology
     1.2.  Conventions Used in This Document
     1.3.  Tree Diagrams
     1.4.  Prefixes in Data Node Names
   2.  Design of the Data Model
     2.1.  Scope of Model
       2.1.1.  Parameters Not Covered at the Global Level
       2.1.2.  Parameters Not Covered at the Interface Level
     2.2.  Optional Capabilities
     2.3.  Position of Address Family in Hierarchy
   3.  Module Structure
     3.1.  IGMP Configuration and Operational State
     3.2.  MLD Configuration and Operational State
     3.3.  IGMP and MLD Actions
   4.  IGMP and MLD YANG Module
   5.  Security Considerations
   6.  IANA Considerations
   7.  References
     7.1.  Normative References
     7.2.  Informative References
   Acknowledgments
   Contributors
   Authors' Addresses

1.  Introduction

   YANG [RFC6020] [RFC7950] is a data definition language that was
   introduced to model the configuration and running state of a device
   managed using network management protocols such as NETCONF [RFC6241]
   or RESTCONF [RFC8040].  YANG is now also being used as a component of
   wider management interfaces, such as command-line interfaces (CLIs).

   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) devices.  The protocol versions include
   IGMPv1 [RFC1112], IGMPv2 [RFC2236], IGMPv3 [RFC3376], MLDv1
   [RFC2710], and MLDv2 [RFC3810].  The core features of the IGMP and
   MLD protocols are defined as required.  Non-core features are defined
   as optional in the provided data model.

   The YANG data model in this document conforms to the Network
   Management Datastore Architecture (NMDA) [RFC8342].

1.1.  Terminology

   The terminology for describing YANG data models is found in [RFC6020]
   and [RFC7950], including:

   *  augment

   *  data model

   *  data node

   *  identity

   *  module

   The following abbreviations are used in this document and the defined
   model:

   IGMP:  Internet Group Management Protocol [RFC3376].

   MLD:  Multicast Listener Discovery [RFC3810].

   SSM:  Source-Specific Multicast service model [RFC3569] [RFC4607].

1.2.  Conventions Used in This Document

   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] [RFC8174] when, and only when, they appear in all
   capitals, as shown here.
Show full document text