YANG Library
RFC 8525

Document Type RFC - Proposed Standard (March 2019; No errata)
Obsoletes RFC 7895
Last updated 2019-03-06
Replaces draft-nmdsdt-netconf-rfc7895bis
Stream IETF
Formats plain text pdf html bibtex
Yang Validation 2 errors, 0 warnings.
Reviews
Additional URLs
- Yang catalog entry for ietf-yang-library@2018-10-16.yang
- Yang impact analysis for draft-ietf-netconf-rfc7895bis
- Mailing list discussion
Stream WG state Submitted to IESG for Publication
Document shepherd Mahesh Jethanandani
Shepherd write-up Show (last changed 2018-04-09)
IESG IESG state RFC 8525 (Proposed Standard)
Consensus Boilerplate Yes
Telechat date
Responsible AD Ignas Bagdonas
Send notices to Mahesh Jethanandani <mjethanandani@gmail.com>
IANA IANA review state IANA OK - Actions Needed
IANA action state RFC-Ed-Ack
Internet Engineering Task Force (IETF)                        A. Bierman
Request for Comments: 8525                                     YumaWorks
Obsoletes: 7895                                             M. Bjorklund
Category: Standards Track                                 Tail-f Systems
ISSN: 2070-1721                                         J. Schoenwaelder
                                                       Jacobs University
                                                               K. Watsen
                                                         Watsen Networks
                                                               R. Wilton
                                                           Cisco Systems
                                                              March 2019

                              YANG Library

Abstract

   This document describes a YANG library that provides information
   about the YANG modules, datastores, and datastore schemas used by a
   network management server.  Simple caching mechanisms are provided to
   allow clients to minimize retrieval of this information.  This
   version of the YANG library supports the Network Management Datastore
   Architecture (NMDA) by listing all datastores supported by a network
   management server and the schema that is used by each of these
   datastores.

   This document obsoletes RFC 7895.

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/rfc8525.

Bierman, et al.              Standards Track                    [Page 1]
RFC 8525                      YANG Library                    March 2019

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 ....................................................3
      1.1. Terminology ................................................4
   2. Objectives ......................................................5
   3. YANG Library Data Model .........................................6
   4. YANG Library YANG Module ........................................8
   5. IANA Considerations ............................................20
   6. Security Considerations ........................................21
   7. References .....................................................22
      7.1. Normative References ......................................22
      7.2. Informative References ....................................23
   Appendix A.  Summary of Changes from RFC 7895 .....................25
   Appendix B.  Example YANG Library Instance for a Basic Server .....25
   Appendix C.  Example YANG Library Instance for an Advanced Server .27
   Authors' Addresses ................................................32

Bierman, et al.              Standards Track                    [Page 2]
RFC 8525                      YANG Library                    March 2019

1.  Introduction

   There is a need for a standard mechanism to expose which YANG modules
   [RFC7950], datastores [RFC8342], and datastore schemas [RFC8342] are
   in use by a network management server.

   This document defines the YANG module "ietf-yang-library" that
   provides this information.  This version of the YANG library is
   compatible with the Network Management Datastore Architecture (NMDA)
   [RFC8342].  The previous version of the YANG library, defined in
   [RFC7895], is not compatible with the NMDA since it assumes that all
   datastores have exactly the same schema.  This is not necessarily
   true in the NMDA since dynamic configuration datastores may have
   their own datastore schema.  Furthermore, the operational state
   datastore may support non-configurable YANG modules in addition to
   the YANG modules supported by conventional configuration datastores.

   The old YANG library definitions have been retained (for backwards-
Show full document text