With-defaults Capability for NETCONF
RFC 6243
Document | Type | RFC - Proposed Standard (June 2011; Errata) | |||||
---|---|---|---|---|---|---|---|
Authors | Andy Bierman , Balázs Lengyel | ||||||
Last updated | 2020-01-21 | ||||||
Replaces | draft-bierman-netconf-with-defaults | ||||||
Stream | IETF | ||||||
Formats | plain text html pdf htmlized with errata bibtex | ||||||
Yang Validation | ☯ 4 errors, 0 warnings. | ||||||
Reviews | |||||||
Additional Resources |
|
||||||
Stream | WG state | WG Document | |||||
Document shepherd | No shepherd assigned | ||||||
IESG | IESG state | RFC 6243 (Proposed Standard) | |||||
Consensus Boilerplate | Unknown | ||||||
Telechat date | |||||||
Responsible AD | Dan Romascanu | ||||||
IESG note | Bert Wijnen is the PROTO Shepherd | ||||||
Send notices to | (None) |
Internet Engineering Task Force (IETF) A. Bierman Request for Comments: 6243 Brocade Category: Standards Track B. Lengyel ISSN: 2070-1721 Ericsson June 2011 With-defaults Capability for NETCONF Abstract The Network Configuration Protocol (NETCONF) defines ways to read and edit configuration data from a NETCONF server. In some cases, part of this data may not be set by the NETCONF client, but rather a default value known to the server is used instead. In many situations the NETCONF client has a priori knowledge about default data, so the NETCONF server does not need to save it in a NETCONF configuration datastore or send it to the client in a retrieval operation reply. In other situations the NETCONF client will need this data from the server. Not all server implementations treat this default data the same way. This document defines a capability-based extension to the NETCONF protocol that allows the NETCONF client to identify how defaults are processed by the server, and also defines new mechanisms for client control of server processing of default data. 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 5741. 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/rfc6243. Bierman & Lengyel Standards Track [Page 1] RFC 6243 with-defaults June 2011 Copyright Notice Copyright (c) 2011 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. Table of Contents 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 3 1.1. Terminology . . . . . . . . . . . . . . . . . . . . . . . 3 1.2. Default-Handling Behavior . . . . . . . . . . . . . . . . 5 1.3. Client Controlled Retrieval of Default Data . . . . . . . 5 2. Default-Handling Basic Modes . . . . . . . . . . . . . . . . . 6 2.1. 'report-all' Basic Mode . . . . . . . . . . . . . . . . . 6 2.1.1. 'report-all' Basic Mode Retrieval . . . . . . . . . . 6 2.1.2. 'report-all' <with-defaults> Retrieval . . . . . . . . 6 2.1.3. 'report-all' <edit-config> and <copy-config> Behavior . . . . . . . . . . . . . . . . . . . . . . . 6 2.2. 'trim' Basic Mode . . . . . . . . . . . . . . . . . . . . 7 2.2.1. 'trim' Basic Mode Retrieval . . . . . . . . . . . . . 7 2.2.2. 'trim' <with-defaults> Retrieval . . . . . . . . . . . 7 2.2.3. 'trim' <edit-config> and <copy-config> Behavior . . . 7 2.3. 'explicit' Basic Mode . . . . . . . . . . . . . . . . . . 8 2.3.1. 'explicit' Basic Mode Retrieval . . . . . . . . . . . 8 2.3.2. 'explicit' <with-defaults> Retrieval . . . . . . . . . 8 2.3.3. 'explicit' <edit-config> and <copy-config> Behavior . 8 3. Retrieval of Default Data . . . . . . . . . . . . . . . . . . 9 3.1. 'report-all' Retrieval Mode . . . . . . . . . . . . . . . 9 3.2. 'trim' Retrieval Mode . . . . . . . . . . . . . . . . . . 9 3.3. 'explicit' Retrieval Mode . . . . . . . . . . . . . . . . 9 3.4. 'report-all-tagged' Retrieval Mode . . . . . . . . . . . . 9 4. With-defaults Capability . . . . . . . . . . . . . . . . . . . 10 4.1. Overview . . . . . . . . . . . . . . . . . . . . . . . . . 10 4.2. Dependencies . . . . . . . . . . . . . . . . . . . . . . . 10 4.3. Capability Identifier . . . . . . . . . . . . . . . . . . 10 4.4. New Operations . . . . . . . . . . . . . . . . . . . . . . 11 4.5. Modifications to Existing Operations . . . . . . . . . . . 11 4.5.1. <get>, <get-config>, and <copy-config> Operations . . 11 4.5.2. <edit-config> Operation . . . . . . . . . . . . . . . 12Show full document text