draft-ietf-netconf-yang-library-05.txt   draft-ietf-netconf-yang-library-06.txt 
Network Working Group A. Bierman Network Working Group A. Bierman
Internet-Draft YumaWorks Internet-Draft YumaWorks
Intended status: Standards Track M. Bjorklund Intended status: Standards Track M. Bjorklund
Expires: October 11, 2016 Tail-f Systems Expires: October 29, 2016 Tail-f Systems
K. Watsen K. Watsen
Juniper Networks Juniper Networks
April 9, 2016 April 27, 2016
YANG Module Library YANG Module Library
draft-ietf-netconf-yang-library-05 draft-ietf-netconf-yang-library-06
Abstract Abstract
This document describes a YANG library, which provides information This document describes a YANG library, which provides information
about all the YANG modules used by a network management server (e.g., about all the YANG modules used by a network management server (e.g.,
a Network Configuration Protocol (NETCONF) server). Simple caching a Network Configuration Protocol (NETCONF) server). Simple caching
mechanisms are provided to allow clients to minimize retrieval of mechanisms are provided to allow clients to minimize retrieval of
this information. this information.
Status of This Memo Status of This Memo
skipping to change at page 1, line 37 skipping to change at page 1, line 37
Internet-Drafts are working documents of the Internet Engineering Internet-Drafts are working documents of the Internet Engineering
Task Force (IETF). Note that other groups may also distribute Task Force (IETF). Note that other groups may also distribute
working documents as Internet-Drafts. The list of current Internet- working documents as Internet-Drafts. The list of current Internet-
Drafts is at http://datatracker.ietf.org/drafts/current/. Drafts is at http://datatracker.ietf.org/drafts/current/.
Internet-Drafts are draft documents valid for a maximum of six months Internet-Drafts are draft documents valid for a maximum of six months
and may be updated, replaced, or obsoleted by other documents at any and may be updated, replaced, or obsoleted by other documents at any
time. It is inappropriate to use Internet-Drafts as reference time. It is inappropriate to use Internet-Drafts as reference
material or to cite them other than as "work in progress." material or to cite them other than as "work in progress."
This Internet-Draft will expire on October 11, 2016. This Internet-Draft will expire on October 29, 2016.
Copyright Notice Copyright Notice
Copyright (c) 2016 IETF Trust and the persons identified as the Copyright (c) 2016 IETF Trust and the persons identified as the
document authors. All rights reserved. document authors. All rights reserved.
This document is subject to BCP 78 and the IETF Trust's Legal This document is subject to BCP 78 and the IETF Trust's Legal
Provisions Relating to IETF Documents Provisions Relating to IETF Documents
(http://trustee.ietf.org/license-info) in effect on the date of (http://trustee.ietf.org/license-info) in effect on the date of
publication of this document. Please review these documents publication of this document. Please review these documents
skipping to change at page 2, line 26 skipping to change at page 2, line 26
2.1.2. modules-state/module . . . . . . . . . . . . . . . . 5 2.1.2. modules-state/module . . . . . . . . . . . . . . . . 5
2.2. YANG Library Module . . . . . . . . . . . . . . . . . . . 5 2.2. YANG Library Module . . . . . . . . . . . . . . . . . . . 5
3. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 11 3. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 11
3.1. YANG Module Registry . . . . . . . . . . . . . . . . . . 11 3.1. YANG Module Registry . . . . . . . . . . . . . . . . . . 11
4. Security Considerations . . . . . . . . . . . . . . . . . . . 11 4. Security Considerations . . . . . . . . . . . . . . . . . . . 11
5. Acknowledgements . . . . . . . . . . . . . . . . . . . . . . 12 5. Acknowledgements . . . . . . . . . . . . . . . . . . . . . . 12
6. References . . . . . . . . . . . . . . . . . . . . . . . . . 12 6. References . . . . . . . . . . . . . . . . . . . . . . . . . 12
6.1. Normative References . . . . . . . . . . . . . . . . . . 12 6.1. Normative References . . . . . . . . . . . . . . . . . . 12
6.2. Informative References . . . . . . . . . . . . . . . . . 13 6.2. Informative References . . . . . . . . . . . . . . . . . 13
Appendix A. Change Log . . . . . . . . . . . . . . . . . . . . . 13 Appendix A. Change Log . . . . . . . . . . . . . . . . . . . . . 13
A.1. v04 to v05 . . . . . . . . . . . . . . . . . . . . . . . 13 A.1. v05 to v06 . . . . . . . . . . . . . . . . . . . . . . . 13
A.2. v03 to v04 . . . . . . . . . . . . . . . . . . . . . . . 14 A.2. v04 to v05 . . . . . . . . . . . . . . . . . . . . . . . 14
A.3. v02 to v03 . . . . . . . . . . . . . . . . . . . . . . . 14 A.3. v03 to v04 . . . . . . . . . . . . . . . . . . . . . . . 14
A.4. v01 to v02 . . . . . . . . . . . . . . . . . . . . . . . 14 A.4. v02 to v03 . . . . . . . . . . . . . . . . . . . . . . . 14
A.5. v00 to v01 . . . . . . . . . . . . . . . . . . . . . . . 14 A.5. v01 to v02 . . . . . . . . . . . . . . . . . . . . . . . 14
A.6. draft-ietf-netconf-restconf-03 to v00 . . . . . . . . . . 14 A.6. v00 to v01 . . . . . . . . . . . . . . . . . . . . . . . 14
Appendix B. Open Issues . . . . . . . . . . . . . . . . . . . . 14 A.7. draft-ietf-netconf-restconf-03 to v00 . . . . . . . . . . 14
Appendix B. Open Issues . . . . . . . . . . . . . . . . . . . . 15
Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . 15 Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . 15
1. Introduction 1. Introduction
There is a need for standard mechanisms to identify the YANG modules There is a need for standard mechanisms to identify the YANG modules
and submodules that are in use by a server that implements YANG data and submodules that are in use by a server that implements YANG data
models. If a large number of YANG modules are utilized by the models. If a large number of YANG modules are utilized by the
server, then the YANG library contents needed can be relatively server, then the YANG library contents needed can be relatively
large. This information changes very infrequently, so it is large. This information changes very infrequently, so it is
important that clients be able to cache the YANG library contents and important that clients be able to cache the YANG library contents and
skipping to change at page 7, line 11 skipping to change at page 7, line 11
set forth in Section 4.c of the IETF Trust's Legal Provisions set forth in Section 4.c of the IETF Trust's Legal Provisions
Relating to IETF Documents Relating to IETF Documents
(http://trustee.ietf.org/license-info). (http://trustee.ietf.org/license-info).
This version of this YANG module is part of RFC XXXX; see This version of this YANG module is part of RFC XXXX; see
the RFC itself for full legal notices."; the RFC itself for full legal notices.";
// RFC Ed.: replace XXXX with actual RFC number and remove this // RFC Ed.: replace XXXX with actual RFC number and remove this
// note. // note.
// RFC Ed.: remove this note // RFC Ed.: remove this note
// Note: extracted from draft-ietf-netconf-yang-library-05.txt // Note: extracted from draft-ietf-netconf-yang-library-06.txt
// RFC Ed.: update the date below with the date of RFC publication // RFC Ed.: update the date below with the date of RFC publication
// and remove this note. // and remove this note.
revision 2016-04-09 { revision 2016-04-09 {
description description
"Initial revision."; "Initial revision.";
reference reference
"RFC XXXX: YANG Module Library."; "RFC XXXX: YANG Module Library.";
} }
skipping to change at page 11, line 34 skipping to change at page 11, line 34
3. IANA Considerations 3. IANA Considerations
3.1. YANG Module Registry 3.1. YANG Module Registry
This document registers one URI in the IETF XML registry [RFC3688]. This document registers one URI in the IETF XML registry [RFC3688].
Following the format in RFC 3688, the following registration is Following the format in RFC 3688, the following registration is
requested to be made. requested to be made.
URI: urn:ietf:params:xml:ns:yang:ietf-yang-library URI: urn:ietf:params:xml:ns:yang:ietf-yang-library
Registrant Contact: The NETMOD WG of the IETF. Registrant Contact: The NETCONF WG of the IETF.
XML: N/A, the requested URI is an XML namespace. XML: N/A, the requested URI is an XML namespace.
This document registers one YANG module in the YANG Module Names This document registers one YANG module in the YANG Module Names
registry [RFC6020]. registry [RFC6020].
name: ietf-yang-library name: ietf-yang-library
namespace: urn:ietf:params:xml:ns:yang:ietf-yang-library namespace: urn:ietf:params:xml:ns:yang:ietf-yang-library
prefix: yanglib prefix: yanglib
// RFC Ed.: replace XXXX with RFC number and remove this note // RFC Ed.: replace XXXX with RFC number and remove this note
reference: RFC XXXX reference: RFC XXXX
skipping to change at page 13, line 36 skipping to change at page 13, line 36
<http://www.rfc-editor.org/info/rfc6536>. <http://www.rfc-editor.org/info/rfc6536>.
[RFC6991] Schoenwaelder, J., Ed., "Common YANG Data Types", RFC [RFC6991] Schoenwaelder, J., Ed., "Common YANG Data Types", RFC
6991, DOI 10.17487/RFC6991, July 2013, 6991, DOI 10.17487/RFC6991, July 2013,
<http://www.rfc-editor.org/info/rfc6991>. <http://www.rfc-editor.org/info/rfc6991>.
6.2. Informative References 6.2. Informative References
[I-D.ietf-netmod-rfc6020bis] [I-D.ietf-netmod-rfc6020bis]
Bjorklund, M., "The YANG 1.1 Data Modeling Language", Bjorklund, M., "The YANG 1.1 Data Modeling Language",
draft-ietf-netmod-rfc6020bis-10 (work in progress), draft-ietf-netmod-rfc6020bis-11 (work in progress),
February 2016. February 2016.
[RFC5277] Chisholm, S. and H. Trevino, "NETCONF Event [RFC5277] Chisholm, S. and H. Trevino, "NETCONF Event
Notifications", RFC 5277, DOI 10.17487/RFC5277, July 2008, Notifications", RFC 5277, DOI 10.17487/RFC5277, July 2008,
<http://www.rfc-editor.org/info/rfc5277>. <http://www.rfc-editor.org/info/rfc5277>.
[RFC6470] Bierman, A., "Network Configuration Protocol (NETCONF) [RFC6470] Bierman, A., "Network Configuration Protocol (NETCONF)
Base Notifications", RFC 6470, DOI 10.17487/RFC6470, Base Notifications", RFC 6470, DOI 10.17487/RFC6470,
February 2012, <http://www.rfc-editor.org/info/rfc6470>. February 2012, <http://www.rfc-editor.org/info/rfc6470>.
Appendix A. Change Log Appendix A. Change Log
-- RFC Ed.: remove this section before publication. -- RFC Ed.: remove this section before publication.
A.1. v04 to v05 A.1. v05 to v06
o correct IANA instructions for module
A.2. v04 to v05
o clarify security considerations per secdir review o clarify security considerations per secdir review
o clarifications for AD review o clarifications for AD review
A.2. v03 to v04 A.3. v03 to v04
o editorial changes after WGLC o editorial changes after WGLC
o one library instance per management protocol o one library instance per management protocol
o removed protocol definitions o removed protocol definitions
o removed requirements on YANG 1.1 modules (text is moved to draft- o removed requirements on YANG 1.1 modules (text is moved to draft-
ietf-netmod-rfc6020bis) ietf-netmod-rfc6020bis)
o added notification yang-library-change o added notification yang-library-change
o changed top-level node name from "modules" to "modules-state" o changed top-level node name from "modules" to "modules-state"
o changed leaf "conformance" to "conformance-type" o changed leaf "conformance" to "conformance-type"
A.3. v02 to v03 A.4. v02 to v03
o added yang-protocol identity o added yang-protocol identity
o added identities for NETCONF and RESTCONF protocols o added identities for NETCONF and RESTCONF protocols
o added yang-protocol leaf-list to /modules o added yang-protocol leaf-list to /modules
o added restricted-protocol leaf-list to /modules/module o added restricted-protocol leaf-list to /modules/module
A.4. v01 to v02 A.5. v01 to v02
o clarify 'implement' conformance for YANG 1.1 modules o clarify 'implement' conformance for YANG 1.1 modules
A.5. v00 to v01 A.6. v00 to v01
o change conformance leaf to enumeration o change conformance leaf to enumeration
o filled in security considerations section o filled in security considerations section
A.6. draft-ietf-netconf-restconf-03 to v00 A.7. draft-ietf-netconf-restconf-03 to v00
o moved ietf-yang-library from RESTCONF draft to new draft o moved ietf-yang-library from RESTCONF draft to new draft
Appendix B. Open Issues Appendix B. Open Issues
-- RFC Ed.: remove this section before publication. -- RFC Ed.: remove this section before publication.
The YANG Library issue tracker can be found here: The YANG Library issue tracker can be found here:
https://github.com/netconf-wg/yang-library/issues https://github.com/netconf-wg/yang-library/issues
 End of changes. 14 change blocks. 
20 lines changed or deleted 25 lines changed or added

This html diff was produced by rfcdiff 1.45. The latest version is available from http://tools.ietf.org/tools/rfcdiff/