Internet-Draft YANG Protocol Requirements May 2024
Watsen Expires 18 November 2024 [Page]
Workgroup:
NETMOD Working Group
Internet-Draft:
draft-yn-netmod-yang-proto-00
Published:
Intended Status:
Standards Track
Expires:
Author:
K. Watsen
Watsen Networks

Requirements for YANG-based Protocols

Abstract

YANG is a data modeling language used to model configuration, operational state, asynchronous notifications, and remote procedure calls (RPCs) for network management. This document describes the syntax and semantics of version 2.0 of the YANG language (YANG 2.0). YANG 2.0 is a major release of the YANG language, updating version 1.1 of the YANG language in both backwards-compatible and backwards-incompatible ways.

Production Process (to be removed by RFC Editor)

This document is developed on GitHub (https://github.com/netmod-wg/rfc7950bis). If you wish to contribute, please consider opening a pull request (PR). Please see the README file for details.

Special Thanks

The following individuals were entrusted to review all of the design proposals and specification updates made by authors. Sorted by first name: Kent Watsen.

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 18 November 2024.

Table of Contents

1. Introduction

YANG [RFC6020] [RFC7950] is a data modeling language used to model configuration, operational state, asynchronous notifications, and remote procedure calls (RPCs) for network management. In this sense, YANG is a domain-specific data modeling language having, e.g., first-class annotations for configuration and operational state, with rules for how they relate.

1.1. Key Words

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.

2. IANA Considerations

This document registers one capability identifier URN from the "Network Configuration Protocol (NETCONF) Capability URNs" registry:

3. Security Considerations

This document defines a language with which to write and read descriptions of management information. The language itself has no security impact on the Internet.

4. References

4.1. Normative References

[RFC2119]
Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", BCP 14, RFC 2119, DOI 10.17487/RFC2119, , <https://www.rfc-editor.org/info/rfc2119>.
[RFC8174]
Leiba, B., "Ambiguity of Uppercase vs Lowercase in RFC 2119 Key Words", BCP 14, RFC 8174, DOI 10.17487/RFC8174, , <https://www.rfc-editor.org/info/rfc8174>.

4.2. Informative References

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

Acknowledgements

The editor wishes to thank the following individuals, who all provided helpful comments on various draft versions of this document:

Author's Address

Kent Watsen
Watsen Networks