[netconf] [Technical Errata Reported] RFC8040 (7884)

RFC Errata System <rfc-editor@rfc-editor.org> Fri, 05 April 2024 07:04 UTC

To: andy@yumaworks.com, mbj@tail-f.com, kwatsen@juniper.net, warren@kumari.net, mjethanandani@gmail.com, mjethanandani@gmail.com, kent+ietf@watsen.net
From: RFC Errata System <rfc-editor@rfc-editor.org>
Cc: jernej.tuljak@mg-soft.si, netconf@ietf.org, rfc-editor@rfc-editor.org
Content-Type: text/plain; charset="UTF-8"
Message-Id: <20240405070451.D4854139094C@rfcpa.amsl.com>
Date: Fri, 05 Apr 2024 00:04:51 -0700
Archived-At: <https://mailarchive.ietf.org/arch/msg/netconf/G5iowEsd4O-SjhOS5APW2wh7010>
Subject: [netconf] [Technical Errata Reported] RFC8040 (7884)
Precedence: list

The following errata report has been submitted for RFC8040,
"RESTCONF Protocol".

--------------------------------------
You may review the report below and at:
https://www.rfc-editor.org/errata/eid7884

--------------------------------------
Type: Technical
Reported by: Jernej Tuljak <jernej.tuljak@mg-soft.si>

Section: 3.5.3.

Original Text
-------------
The following example shows how reserved characters are
percent-encoded within a key value. The value of "key1" contains
a comma, single-quote, double-quote, colon, double-quote, space,
and forward slash (,'":" /). Note that double-quote is not a
reserved character and does not need to be percent-encoded. The
value of "key2" is the empty string, and the value of "key3" is the
string "foo".

Example URL:

/restconf/data/example-top:top/list1=%2C%27"%3A"%20%2F,,foo

Corrected Text
--------------
The following example shows how specific characters are
percent-encoded within a key value. The value of "key1" contains
a comma, single-quote, double-quote, colon, double-quote, space,
and forward slash (,'":" /). Note that double-quote and space are
not reserved characters but also do not correspond to characters in
the unreserved set and therefore need to be percent-encoded. The
value of "key2" is the empty string, and the value of "key3" is the
string "foo".

Example URL:

/restconf/data/example-top:top/list1=%2C%27%22%3A%22%20%2F,,foo

Notes
-----
As explained in RFC3986, the restricted set of URI characters consists of reserved characters, unreserved characters and percent-encodings. If a character does not belong to either reserved characters or unreserved characters it can only appear as a percent-encoding in a valid URI. This restricted set of characters is defined by RFC3986, Appendix A, and does not include double-quote and space characters.

Instructions:
-------------
This erratum is currently posted as "Reported". (If it is spam, it
will be removed shortly by the RFC Production Center.) Please
use "Reply All" to discuss whether it should be verified or
rejected. When a decision is reached, the verifying party
will log in to change the status and edit the report, if necessary.

--------------------------------------
RFC8040 (draft-ietf-netconf-restconf-18)
--------------------------------------
Title : RESTCONF Protocol
Publication Date : January 2017
Author(s) : A. Bierman, M. Bjorklund, K. Watsen
Category : PROPOSED STANDARD
Source : Network Configuration
Stream : IETF
Verifying Party : IESG

[netconf] [Technical Errata Reported] RFC8040 (78… RFC Errata System