A YANG Data Model for Routing Management
RFC 8022
| Document | Type |
RFC - Proposed Standard
(November 2016; No errata)
Obsoleted by RFC 8349
|
|
|---|---|---|---|
| Last updated | 2016-11-09 | ||
| Replaces | draft-lhotka-netmod-routing-cfg | ||
| Stream | IETF | ||
| Formats | plain text html pdf htmlized bibtex | ||
| Yang Validation | ☯ 1 errors, 0 warnings. | ||
| Reviews | |||
| Additional Resources | |||
| Stream | WG state | Submitted to IESG for Publication | |
| Document shepherd | Lou Berger | ||
| Shepherd write-up | Show (last changed 2016-10-20) | ||
| IESG | IESG state | RFC 8022 (Proposed Standard) | |
| Consensus Boilerplate | Yes | ||
| Telechat date | |||
| Responsible AD | Benoît Claise | ||
| Send notices to | draft-ietf-netmod-routing-cfg.all@ietf.org | ||
| IANA | IANA review state | IANA OK - Actions Needed | |
| IANA action state | RFC-Ed-Ack | ||
Internet Engineering Task Force (IETF) L. Lhotka
Request for Comments: 8022 CZ.NIC
Category: Standards Track A. Lindem
ISSN: 2070-1721 Cisco Systems
November 2016
A YANG Data Model for Routing Management
Abstract
This document contains a specification of three YANG modules and one
submodule. Together they form the core routing data model that
serves as a framework for configuring and managing a routing
subsystem. It is expected that these modules will be augmented by
additional YANG modules defining data models for control-plane
protocols, route filters, and other functions. The core routing data
model provides common building blocks for such extensions -- routes,
Routing Information Bases (RIBs), and control-plane protocols.
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
http://www.rfc-editor.org/info/rfc8022.
Copyright Notice
Copyright (c) 2016 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
(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.
Lhotka & Lindem Standards Track [Page 1]
RFC 8022 YANG Routing Management November 2016
Table of Contents
1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . 3
2. Terminology and Notation . . . . . . . . . . . . . . . . . . 3
2.1. Glossary of New Terms . . . . . . . . . . . . . . . . . . 4
2.2. Tree Diagrams . . . . . . . . . . . . . . . . . . . . . . 5
2.3. Prefixes in Data Node Names . . . . . . . . . . . . . . . 5
3. Objectives . . . . . . . . . . . . . . . . . . . . . . . . . 6
4. The Design of the Core Routing Data Model . . . . . . . . . . 6
4.1. System-Controlled and User-Controlled List Entries . . . 8
5. Basic Building Blocks . . . . . . . . . . . . . . . . . . . . 9
5.1. Route . . . . . . . . . . . . . . . . . . . . . . . . . . 9
5.2. Routing Information Base (RIB) . . . . . . . . . . . . . 9
5.3. Control-Plane Protocol . . . . . . . . . . . . . . . . . 10
5.3.1. Routing Pseudo-Protocols . . . . . . . . . . . . . . 10
5.3.2. Defining New Control-Plane Protocols . . . . . . . . 11
5.4. Parameters of IPv6 Router Advertisements . . . . . . . . 12
6. Interactions with Other YANG Modules . . . . . . . . . . . . 13
6.1. Module "ietf-interfaces" . . . . . . . . . . . . . . . . 13
6.2. Module "ietf-ip" . . . . . . . . . . . . . . . . . . . . 13
7. Routing Management YANG Module . . . . . . . . . . . . . . . 14
8. IPv4 Unicast Routing Management YANG Module . . . . . . . . . 26
9. IPv6 Unicast Routing Management YANG Module . . . . . . . . . 32
9.1. IPv6 Router Advertisements Submodule . . . . . . . . . . 37
10. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 47
11. Security Considerations . . . . . . . . . . . . . . . . . . . 48
12. References . . . . . . . . . . . . . . . . . . . . . . . . . 49
12.1. Normative References . . . . . . . . . . . . . . . . . . 49
12.2. Informative References . . . . . . . . . . . . . . . . . 50
Appendix A. The Complete Data Trees . . . . . . . . . . . . . . 51
A.1. Configuration Data . . . . . . . . . . . . . . . . . . . 51
A.2. State Data . . . . . . . . . . . . . . . . . . . . . . . 52
Appendix B. Minimum Implementation . . . . . . . . . . . . . . . 53
Appendix C. Example: Adding a New Control-Plane Protocol . . . . 54
Appendix D. Data Tree Example . . . . . . . . . . . . . . . . . 56
Acknowledgments . . . . . . . . . . . . . . . . . . . . . . . . . 64
Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . 64
Show full document text