Re: [netconf] [Technical Errata Reported] RFC8040 (6362)

Muly Ilan <muly_i@rad.com> Tue, 22 December 2020 15:06 UTC

Return-Path: <muly_i@rad.com>
X-Original-To: netconf@ietfa.amsl.com
Delivered-To: netconf@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 0F68A3A10FD for <netconf@ietfa.amsl.com>; Tue, 22 Dec 2020 07:06:34 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.8
X-Spam-Level:
X-Spam-Status: No, score=-1.8 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, HTML_MESSAGE=0.001, HTTPS_HTTP_MISMATCH=0.1, RCVD_IN_MSPIKE_H2=-0.001, SPF_PASS=-0.001, URIBL_BLOCKED=0.001] autolearn=no autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (1024-bit key) header.d=rad365.onmicrosoft.com
Received: from mail.ietf.org ([4.31.198.44]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id zJM1HIjo7zDI for <netconf@ietfa.amsl.com>; Tue, 22 Dec 2020 07:06:31 -0800 (PST)
Received: from EUR04-VI1-obe.outbound.protection.outlook.com (mail-eopbgr80072.outbound.protection.outlook.com [40.107.8.72]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id EB5243A10F3 for <netconf@ietf.org>; Tue, 22 Dec 2020 07:06:30 -0800 (PST)
ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=Hj2Op36GSNaH9wllteLrEILrosZ78ZMO+x5iXFqBLSJQmVYRdJzaqN/gnVxDF2BWgOjro14XRG4KVPPeyV20EZEO34LY5zx+ObOQgclJvMVBeP0nEOSJp9AHdECPlS93+QWCBfA/qapZDih58IfkJc2SFeU1FSqVlKJ+3V3AqsNAGSMTWi41t8eg7sukM5vm8l5P6hPLweOHa+B0T4Rob8epxtmSfGK91xGcbyANRV9twxS7ScxuPfURIH4BLAoHDKkNq3TkPnG3l23mlBbGb+B0acQs7LEosLSxVljlGD6aZrfELz0Rv3Yet3hSimwneRocmIgxWTtovcGmpHGXCQ==
ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=eVIe7JUZDC4hmH/IkljqbmyOpn9JFXcbe5Hcf3iVjNY=; b=Go4w42Zhn48IAIrSA/YUhiBGLp+yLPlj8dCrFgxFLpymIH3Y0bSeSOb2kU59S38M/wX+K9ZUbDwrZs682OOKfBk8qfbZc3+l98cGPnjcciPH34Hkek5WBPmlpQ7aOsBnAf2X6Y4DCBw0BJoTLTxzxfoVQHmw3/4VMbHyYQmUHtZ7Mt18hC7Nc+wHlZgR2OXLx6JjoYg3Ahv/M2qIRO8lnYkBSFOwaXdG3iB6MHfiGZp8wGLGfHRYVIMuRWrVw8nZsydNNHrw7i2C/CXNEh33VNBD7pHQWx/1wZ+sLD6FsBXYlycVTT/ZxtqSDjdFA/Q7r0ezmZNZ2nvlMJt0r7SInQ==
ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=rad.com; dmarc=pass action=none header.from=rad.com; dkim=pass header.d=rad.com; arc=none
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=rad365.onmicrosoft.com; s=selector1-rad365-onmicrosoft-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=eVIe7JUZDC4hmH/IkljqbmyOpn9JFXcbe5Hcf3iVjNY=; b=AJuqOa9zpkVMRJCWllO6X6b7F/oL89aNgoIGR/uBtaFpf8vbwQ4idQTD2saYR5Vz26MbIT2SNmb8zKCuNI9gDOfF8q9ehtLYe0Mh/HELStgmUlq+MYVRdbcDrVX/8/spPyN7HO/QUW9ZVS+I4FXSWPyS736TxqS4yxFghhla99k=
Received: from AM0PR0302MB3348.eurprd03.prod.outlook.com (2603:10a6:208:b::19) by AM0PR03MB5779.eurprd03.prod.outlook.com (2603:10a6:208:171::29) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3676.33; Tue, 22 Dec 2020 15:06:21 +0000
Received: from AM0PR0302MB3348.eurprd03.prod.outlook.com ([fe80::eccb:ec09:89e2:cd70]) by AM0PR0302MB3348.eurprd03.prod.outlook.com ([fe80::eccb:ec09:89e2:cd70%5]) with mapi id 15.20.3676.033; Tue, 22 Dec 2020 15:06:21 +0000
From: Muly Ilan <muly_i@rad.com>
To: Andy Bierman <andy@yumaworks.com>, RFC Errata System <rfc-editor@rfc-editor.org>
CC: Martin Bjorklund <mbj@tail-f.com>, Kent Watsen <kwatsen@juniper.net>, Warren Kumari <warren@kumari.net>, Robert Wilton <rwilton@cisco.com>, Kent Watsen <kent+ietf@watsen.net>, Mahesh Jethanandani <mjethanandani@gmail.com>, Netconf <netconf@ietf.org>
Thread-Topic: [Technical Errata Reported] RFC8040 (6362)
Thread-Index: AQHW2G+T4dcPBAr/1UuNVk6Y0Yvs3aoDNLcAgAAAv5A=
Date: Tue, 22 Dec 2020 15:06:21 +0000
Message-ID: <AM0PR0302MB334880AA27135AD9F4394663F9DF0@AM0PR0302MB3348.eurprd03.prod.outlook.com>
References: <20201222143414.775F6F40744@rfc-editor.org> <CABCOCHTaMtjRkO24oGfY4vD910z-iUpsTxDSNCQmPU3L1U0QVw@mail.gmail.com>
In-Reply-To: <CABCOCHTaMtjRkO24oGfY4vD910z-iUpsTxDSNCQmPU3L1U0QVw@mail.gmail.com>
Accept-Language: en-US
Content-Language: en-US
X-MS-Has-Attach:
X-MS-TNEF-Correlator:
authentication-results: yumaworks.com; dkim=none (message not signed) header.d=none;yumaworks.com; dmarc=none action=none header.from=rad.com;
x-originating-ip: [185.223.3.181]
x-ms-publictraffictype: Email
x-ms-office365-filtering-ht: Tenant
x-ms-office365-filtering-correlation-id: 2ce69fc1-4d7f-4edc-8399-08d8a68b2484
x-ms-traffictypediagnostic: AM0PR03MB5779:
x-microsoft-antispam-prvs: <AM0PR03MB5779CB13876841016039FFD6F9DF0@AM0PR03MB5779.eurprd03.prod.outlook.com>
x-ms-oob-tlc-oobclassifiers: OLM:7219;
x-ms-exchange-senderadcheck: 1
x-microsoft-antispam: BCL:0;
x-microsoft-antispam-message-info: z3oiQNJZJrn7SGn11Xr4dlZuQjjk22TLxrPKJ75YVMz8W+UYgPEpGb9gMinH6uNnAolLmHeWkhZoLS+CR3zLI4fX+d5tfzf8TOJgOxuBbw7jJX4tGmAnw3UJaDtZmHnQnSuFr/tSHIfUF2UZpj10PMxb/Ob1tfSMmVfhhUzm6ao3CYYkazwOrvvvMuBwDG16vTUUfP4y6WDwES5VJRF6zBbkAcsO8iEkWM5JQ7cYqFx4G8izLLYxAK/CHkdf8urSmvY4DZr0gAgESa8KLAXOe1IGdG0zOt8lbqRXf3YT1EiyzxsT18UgzSYPWGaUlpqnRYraFrZodBwsGIfQ6yzhKsxnMjW8BjzzrkZvllocybfXCZlekagHf9pG4J9Wk7G5EIzGUCh9C6PDW/5lKaihnkx8Z6uYHfs/y9rQVDhgvN7fYcfWwD3fbqi3GHhFtsqUsQgjI4GTKEyQSmtVrtQtMQ==
x-forefront-antispam-report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:AM0PR0302MB3348.eurprd03.prod.outlook.com; PTR:; CAT:NONE; SFS:(4636009)(396003)(366004)(376002)(136003)(39850400004)(346002)(186003)(66476007)(5660300002)(166002)(71200400001)(52536014)(76116006)(8936002)(966005)(33656002)(26005)(478600001)(9326002)(8676002)(54906003)(4326008)(64756008)(86362001)(53546011)(83380400001)(66446008)(316002)(6506007)(66556008)(55016002)(66946007)(7696005)(2906002)(110136005)(9686003); DIR:OUT; SFP:1101;
x-ms-exchange-antispam-messagedata: =?us-ascii?Q?WGhzHgmQ3CBL9+R440jeRwckYZ8KDWirR6+LK69Ltce0hcCI6C3dxEmJx2O2?= =?us-ascii?Q?L8v7xbtUDjLE0f5HwmlMoXa6ecIdzIPZClBPBxwWb3oWfUMorM9OAT/B4Yum?= =?us-ascii?Q?VVvhYK8s0Js0ciQ2bFtBr7U787KZGZibcVcUyJKo3SsfTzi/6W2JYs3ngea7?= =?us-ascii?Q?3Gq6rivuz6M0D/Kpwk5X6JQnV4QByrTPUJugHDhHmc4FRXnofETkNppRqpLw?= =?us-ascii?Q?HdD0fm9QNTlSgNoHjrazxRSDdb+jn6t7er7RtIncoTGXoiJnV5NDDROGYknz?= =?us-ascii?Q?EWC5Ij070XXQBTyUrNwQQECWPik6gGxbOpKihCY03R8h0ITrpNMejbs9qwfB?= =?us-ascii?Q?WjKSKzWn+jAPiRxy045yd3icaML4b3VtQt9McHks7OHqq8IMwT+F4nHW+Wxc?= =?us-ascii?Q?9g+/oePQlb+E5PIJnaSc6TqH9Uv2A+j6ZpbZkRydlxUN1B24ZHGmhz+pgpZ7?= =?us-ascii?Q?pbq2H4HVWxpF2XprRnvcgiYrsdXbvJmjiykZQUIdgGU+hZtf4gAlXJtD7MzN?= =?us-ascii?Q?kSNsw+n4kCvMIMai2g/hACRdAz71hqkKRbv3eCjpJZkZIqFhjA8WChKkUBkn?= =?us-ascii?Q?+CmhSEapW0DIhuVR5in0qNJF7287ZuQoJTCQoMjhWUDmuMcJ3hadh6l9ZRhy?= =?us-ascii?Q?qWvJmvKV/53dzKt+wd0OsmL2BS/0pr/taEARslsiU+ikYHibrh9/l7ak43OS?= =?us-ascii?Q?xcdZO7kxVTAJNbJU87F9LP6aDhCxw/Ry0zgTLlXeFUo5vW0cJeJGvknTJ+Od?= =?us-ascii?Q?yEB472bnAUAhYT7PxOxWVmBDHxmSZlmaVuRW/FcQ3CM2/4tBXHpxvL7gBNf3?= =?us-ascii?Q?TwdpiuLPncQqRSxdddMu09Zy7B1hI+CPM7V04nroFlB41wpNSzJAfHkGxk29?= =?us-ascii?Q?7WY3NCBxBxHwO/3eV8qA4/lqUQI1OOthBTd1NOs7QDqTVgqZ1txeHmUbEneP?= =?us-ascii?Q?/66k2wY5JoSz/srryUpvES0d+DCX497Zmt0bcP8JmVE=3D?=
x-ms-exchange-transport-forked: True
Content-Type: multipart/alternative; boundary="_000_AM0PR0302MB334880AA27135AD9F4394663F9DF0AM0PR0302MB3348_"
MIME-Version: 1.0
X-OriginatorOrg: rad.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-AuthSource: AM0PR0302MB3348.eurprd03.prod.outlook.com
X-MS-Exchange-CrossTenant-Network-Message-Id: 2ce69fc1-4d7f-4edc-8399-08d8a68b2484
X-MS-Exchange-CrossTenant-originalarrivaltime: 22 Dec 2020 15:06:21.5154 (UTC)
X-MS-Exchange-CrossTenant-fromentityheader: Hosted
X-MS-Exchange-CrossTenant-id: f9047108-cc2c-4e48-97a3-43fad1b3bf9d
X-MS-Exchange-CrossTenant-mailboxtype: HOSTED
X-MS-Exchange-CrossTenant-userprincipalname: ZapsPxu1JvKhm841pXli6zw/lNQhMEnQCAwwezmCHSPi9W3ySPcJgR2pCmcj8qad
X-MS-Exchange-Transport-CrossTenantHeadersStamped: AM0PR03MB5779
Archived-At: <https://mailarchive.ietf.org/arch/msg/netconf/zEAXFokwB_GKIY0deXA3tduJF7w>
Subject: Re: [netconf] [Technical Errata Reported] RFC8040 (6362)
X-BeenThere: netconf@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: NETCONF WG list <netconf.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/netconf>, <mailto:netconf-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/netconf/>
List-Post: <mailto:netconf@ietf.org>
List-Help: <mailto:netconf-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/netconf>, <mailto:netconf-request@ietf.org?subject=subscribe>
X-List-Received-Date: Tue, 22 Dec 2020 15:06:34 -0000

Hi Andy,

You are saying that the text in Appendix B.3.1 is wrong. Understood.

Please note that there's a specific example for "content=all" in Appendix B.3.1.  In this example the "ETag" and "Last-Modified" header fields are not used.
I was looking for a well-defined behavior for all the three options of the "content" query parameter.

Thanks,

Muly

From: Andy Bierman [mailto:andy@yumaworks.com]
Sent: 22/12/2020 16:58
To: RFC Errata System <rfc-editor@rfc-editor.org>
Cc: Martin Bjorklund <mbj@tail-f.com>om>; Kent Watsen <kwatsen@juniper.net>et>; Warren Kumari <warren@kumari.net>et>; Robert Wilton <rwilton@cisco.com>om>; Kent Watsen <kent+ietf@watsen.net>et>; Mahesh Jethanandani <mjethanandani@gmail.com>om>; Muly Ilan <muly_i@rad.com>om>; Netconf <netconf@ietf.org>
Subject: Re: [Technical Errata Reported] RFC8040 (6362)

Hi,

This Errata should be rejected.
The cited text in non-normative Appendix B.3.1 is actually wrong.
The parameter content=all can also return these fields for configuration data.


The normative text in 3.5.2 explains what to do.


3.5.2<https://eur01.safelinks.protection.outlook.com/?url=https%3A%2F%2Ftools.ietf.org%2Fhtml%2Frfc8040%23section-3.5.2&data=04%7C01%7Cmuly_i%40rad.com%7C35e8783752fa459ae98a08d8a689f57a%7Cf9047108cc2c4e4897a343fad1b3bf9d%7C1%7C0%7C637442458750543741%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C1000&sdata=7z9T58Li8GDhW2ctfforl%2BtjSz5EwWrCC6UQE6paC2Y%3D&reserved=0>amp;reserved=0>.  Entity-Tag





   For configuration data resources, the server SHOULD maintain a

   resource entity-tag for each resource and return the "ETag" header

   field when it is retrieved as the target resource with the GET or

   HEAD methods.  If maintained, the resource entity-tag MUST be updated

   whenever the resource or any configuration resource within the

   resource is altered.  If not maintained, then the resource entity-tag

   for the datastore MUST be used instead.


Andy

On Tue, Dec 22, 2020 at 6:34 AM RFC Errata System <rfc-editor@rfc-editor.org<mailto:rfc-editor@rfc-editor.org>> wrote:
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/eid6362<https://eur01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fwww.rfc-editor.org%2Ferrata%2Feid6362&data=04%7C01%7Cmuly_i%40rad.com%7C35e8783752fa459ae98a08d8a689f57a%7Cf9047108cc2c4e4897a343fad1b3bf9d%7C1%7C0%7C637442458750553733%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C1000&sdata=%2BGo3kt4FmuA6g6PMoXDD1jbziLdLZpO6OerPIfiNRBU%3D&reserved=0>

--------------------------------------
Type: Technical
Reported by: Muly Ilan <muly_i@rad.com<mailto:muly_i@rad.com>>

Section: 4.3.

Original Text
-------------
   The client might request the response header fields for an XML
   representation of a specific "album" resource:

      GET /restconf/data/example-jukebox:jukebox/\
         library/artist=Foo%20Fighters/album=Wasting%20Light HTTP/1.1
      Host: example.com<https://eur01.safelinks.protection.outlook.com/?url=http%3A%2F%2Fexample.com%2F&data=04%7C01%7Cmuly_i%40rad.com%7C35e8783752fa459ae98a08d8a689f57a%7Cf9047108cc2c4e4897a343fad1b3bf9d%7C1%7C0%7C637442458750553733%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C1000&sdata=j6Qv7qb%2Btlq6PVL1JK4l5opCHygcLLZTqPyufDyVtII%3D&reserved=0>
      Accept: application/yang-data+xml

   The server might respond as follows:

      HTTP/1.1 200 OK
      Date: Thu, 26 Jan 2017 20:56:30 GMT
      Server: example-server
      Content-Type: application/yang-data+xml
      Cache-Control: no-cache
      ETag: "a74eefc993a2b"
      Last-Modified: Thu, 26 Jan 2017 14:02:14 GMT

Corrected Text
--------------
   The client might request the response header fields for an XML
   representation of a specific "album" resource:

      GET /restconf/data/example-jukebox:jukebox/\
         library/artist=Foo%20Fighters/album=Wasting%20Light HTTP/1.1
      Host: example.com<https://eur01.safelinks.protection.outlook.com/?url=http%3A%2F%2Fexample.com%2F&data=04%7C01%7Cmuly_i%40rad.com%7C35e8783752fa459ae98a08d8a689f57a%7Cf9047108cc2c4e4897a343fad1b3bf9d%7C1%7C0%7C637442458750563727%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C1000&sdata=FsU3K27Uav6bEaRklgGqDr11S5Yp%2FJEzebV5KyF2974%3D&reserved=0>
      Accept: application/yang-data+xml

   The server might respond as follows:

      HTTP/1.1 200 OK
      Date: Thu, 26 Jan 2017 20:56:30 GMT
      Server: example-server
      Content-Type: application/yang-data+xml
      Cache-Control: no-cache


Notes
-----
Removed the "ETag" and "Last-Modified" header fields.

According to Appendix B.3.1. :
   To retrieve only the configuration child resources, the "content"
   parameter is set to "config".  Note that the "ETag" and
   "Last-Modified" headers are only returned if the "content" parameter
   value is "config".

Instructions:
-------------
This erratum is currently posted as "Reported". If necessary, please
use "Reply All" to discuss whether it should be verified or
rejected. When a decision is reached, the verifying party
can 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
Area                : Operations and Management
Stream              : IETF
Verifying Party     : IESG