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

Muly Ilan <muly_i@rad.com> Mon, 23 November 2020 13:34 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 3C0BC3A0B04 for <netconf@ietfa.amsl.com>; Mon, 23 Nov 2020 05:34:55 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: 0.1
X-Spam-Level:
X-Spam-Status: No, score=0.1 tagged_above=-999 required=5 tests=[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 aIeoEBHOOy-n for <netconf@ietfa.amsl.com>; Mon, 23 Nov 2020 05:34:53 -0800 (PST)
Received: from EUR01-HE1-obe.outbound.protection.outlook.com (mail-eopbgr130050.outbound.protection.outlook.com [40.107.13.50]) (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 BA2E73A0AFA for <netconf@ietf.org>; Mon, 23 Nov 2020 05:34:52 -0800 (PST)
ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=kQrSVlc6uvrG/n/+ch7qK/y5soa0BENZue/CTEb/JuQMXrrGtU4CKw1/fxiqIBsCmlxqKtCBNDkhA9aiGut0xKa4JdnwIB6Wcq2bn+p9VAT+Suu10YeDh55a/QJBjqG2XPUT0hnb/aRsRHy0TmI3A/TOObS4YtZS7u7GDRhqK9xQMBHnFq2/ysKMh+4lIf5xXrkQJWc7KFnjQ9sggSG1+BupNT0jJ0PMUrdEfYNNh7e3BwMVySO+Nfwrr1Ln4CggOe07VtW3yXgxLJICgnmdzuq3eJwI4lVLiHVLwIT43u6zvDhb1nTWCJzqsezaPeUpF3Sv5k1TDfqjTQ6CJBoPyw==
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=Lx7YIX7mCTwfyPApW9E2F0oDl4i6o+VVMdh7Dt3ObsY=; b=mDGxrIlg4Vhh+QrmUki+5VZ8op4eRSqQKkN6kb90FjyMtqtSQlBYH/qM/CL3XZUoo6MXRq9DZuyv+5Lm/xW6sInn4AWsSvs6Vt9Hrf8v3NOWx6fIEL+L65sNCXgp6q+Wm3zCsrnxEuXhTtxDMcFPOmY7soX8NMNCzh0DZjVPgZSNU2WY0/UOfyi77AjswLaf6p+i40RyX1mf4eif72tZljrAGyncouWGci5Nve11ArArkVI6RMgE1oUHFWbQD0mgz09tboKdLANIYVcQNQyiaYLbao4Eg/dPPvjiX1JDdBpvQkio8RktTHU1Rak9fBTJOCbzotalNmQTTPb9SEkeYw==
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=Lx7YIX7mCTwfyPApW9E2F0oDl4i6o+VVMdh7Dt3ObsY=; b=XIY9SEAsuRM3t+Dha4qhOgDnS73dxjZep0BrkV8E+qZ8iSmWLHp0KLdtHyZshnLXXCl/uUixbh6DWrEB/CBkZy7K6AWp7UfPM+D+OiUmLpfyBEc7F3+ZP0HIB2CnCmt+RaoGGBSXYeHx1VKqtY48LnHX3PeqKMnnIjo2rXPu+bY=
Received: from AM0PR0302MB3348.eurprd03.prod.outlook.com (2603:10a6:208:b::19) by AM0PR03MB3538.eurprd03.prod.outlook.com (2603:10a6:208:42::27) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3589.22; Mon, 23 Nov 2020 13:34:50 +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.3589.025; Mon, 23 Nov 2020 13:34:50 +0000
From: Muly Ilan <muly_i@rad.com>
To: Andy Bierman <andy@yumaworks.com>, =?utf-8?B?TWFydGluIEJqw7Zya2x1bmQ=?= <mbj+ietf@4668.se>
CC: Kent Watsen <kwatsen@juniper.net>, Netconf <netconf@ietf.org>, RFC Editor <rfc-editor@rfc-editor.org>
Thread-Topic: [netconf] [Technical Errata Reported] RFC8040 (6342)
Thread-Index: AQHWwRzkciHC9EbDXEyiRm/auJwoyqnVZYeAgABKIoCAAAg2YA==
Date: Mon, 23 Nov 2020 13:34:49 +0000
Message-ID: <AM0PR0302MB3348B74B591E5D85C4A88FBCF9FC0@AM0PR0302MB3348.eurprd03.prod.outlook.com>
References: <20201122221445.1E11FF4071F@rfc-editor.org> <20201123.093729.325420538444196813.id@4668.se> <CABCOCHQUrG_JuMFP8PXs-8qJYjXttSVVKqnn+-QT5hm9Nf6xNQ@mail.gmail.com>
In-Reply-To: <CABCOCHQUrG_JuMFP8PXs-8qJYjXttSVVKqnn+-QT5hm9Nf6xNQ@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: f7ba25df-4a93-43b8-3c23-08d88fb48d49
x-ms-traffictypediagnostic: AM0PR03MB3538:
x-microsoft-antispam-prvs: <AM0PR03MB35388F59642F5DC4167BAC75F9FC0@AM0PR03MB3538.eurprd03.prod.outlook.com>
x-ms-oob-tlc-oobclassifiers: OLM:8273;
x-ms-exchange-senderadcheck: 1
x-microsoft-antispam: BCL:0;
x-microsoft-antispam-message-info: palmmFGD2YpRVXD9aJDWMy3QVvG/ALTXLXE+n3aB5KuHnivKFz5htEMEbyNlgbyWh2Z1NGNtlP0bSuMqUBsTEdkgGBm5XxRg7f6mmut1drYQSPNGYkC7W/Da4hnYczdp9ktyO7w8QF/30GTNkqZkzyTaq5CE6tyyFhw9/N0wqFlN9FSEXnkNkNUnXulpexuBrDZ1Ltx+Y59A3ABYQ1+DIKJ//CcTX04dURzDUDGv/cogZPIVYFxI3rGyLX0CbTChY4XLZjDGkfe8i2VQ+0kWMaG+Bt3v2emaegn0McAz452WfMXGZUtx44QmaUCKMDV33kzIDetQcUiOrqatN3AtmMGfycBCIc6HOFZO0NxzE62Sm+pZPdFtNYKmxTjwVr5lkK+l020DNdN7qNAtEvzwrQ==
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)(136003)(396003)(39850400004)(346002)(376002)(366004)(6506007)(64756008)(316002)(966005)(9326002)(478600001)(66574015)(8936002)(4326008)(86362001)(2906002)(166002)(71200400001)(66476007)(66946007)(8676002)(52536014)(5660300002)(83380400001)(66446008)(55016002)(9686003)(53546011)(66556008)(7696005)(33656002)(76116006)(110136005)(26005)(54906003)(186003); DIR:OUT; SFP:1101;
x-ms-exchange-antispam-messagedata: e/VuCj7pFJlrW3O47deivqovdfADhymrRU2CKXV3u/uo3xyPLzG+sQpguz20J2yVH6KpX2aP9nhrDpBBtXxPibjD8Ws4QPJais4cYmV5ZGmCcR3v7KalX6Pr1PavZUrEViXpi28bLLPOarZWta+Py6H0WH2k5rLCgK1ga8z85p7VaBjOFaxCKgi3RSHGHqPjAXFc8UXUevQ7szYySE5SwfXBFbGmifUzs1068h8hl+YNGrWEX1+bPGw3AwTRsSpcNbZYJLEfWdRBU/HYgVh+8PSboRpH2CcNNJV+BqrAh+fF7QR+Nm/M5Vvylic39J6FmwX/4lIjUquiWnSY9/e7gWxQ3Oj048Zz+sFvTKCWvj2cNvSyCLWt9fPxXYAFPgBY6amWbUMQJbNwtEXALz4G+IhYczD0l2zPLLGU7zyP0noi/rzedVlEmrq/U0WxQg7Knd3Yf1TnsITGWv6MoKn4TOEDnEVidlo6fozKiKoKZB2EKdMy2lmzPuCSja5yyHbrkuPi+BKjNZXV7PNtbxH+co321nd2v/hfCTg9I/mwAqHXY+sSW9UYypcb9Z/L3Tyg/XT/EnaJs5+8YwREJGNRC5t7HIrfWuUu7/TJPt1iZt7cLrpc///d0Smk4qU9feV6IIoh0z6+5l0XjBrUfTKP3EeX9JAheL5f3+hMqr2ee1QdLDYYa6+BhQuWfzGIT5OmHXdirkAapMQg5hPzl+WdbNU3LsPAay4SvA+dJtW5VC1chDI17l+m3rh+sEbVSRWOs3SF13fNRFl4xIEK/NDt1hVzk3YKG+ekn0Txg/OzureYvyK3GKWlSt3zsB2xQvaXVFO75dQh6vBinzg+X15OGo6KsBwO5WXt5C59LNPVtKzlpdaR+epbmCGH6kcUW1B5XiMdHmxdYvIxPSYepioPUQ==
x-ms-exchange-transport-forked: True
Content-Type: multipart/alternative; boundary="_000_AM0PR0302MB3348B74B591E5D85C4A88FBCF9FC0AM0PR0302MB3348_"
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: f7ba25df-4a93-43b8-3c23-08d88fb48d49
X-MS-Exchange-CrossTenant-originalarrivaltime: 23 Nov 2020 13:34:49.9618 (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: JwmcIpr/nBYdiWUe8qqUynLdC1B2DItMdl3VJpnt9Mt03az1ETaDL6IZYHBJwvVV
X-MS-Exchange-Transport-CrossTenantHeadersStamped: AM0PR03MB3538
Archived-At: <https://mailarchive.ietf.org/arch/msg/netconf/vCOfvDUSBPQBrW7Aunih5Di0ztU>
Subject: Re: [netconf] [Technical Errata Reported] RFC8040 (6342)
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: Mon, 23 Nov 2020 13:34:55 -0000

Hi Andy,

The example for plain PATCH in appendix B.2.5 has keys in both the URI and body.
Whereas the example in section 4.6.1 has keys only in the URI.

Clearly one of the examples is wrong.

Best,

Muly


From: netconf [mailto:netconf-bounces@ietf.org] On Behalf Of Andy Bierman
Sent: 23/11/2020 15:03
To: Martin Björklund <mbj+ietf@4668.se>
Cc: Kent Watsen <kwatsen@juniper.net>et>; Netconf <netconf@ietf.org>rg>; RFC Editor <rfc-editor@rfc-editor.org>
Subject: Re: [netconf] [Technical Errata Reported] RFC8040 (6342)



On Mon, Nov 23, 2020 at 12:37 AM Martin Björklund <mbj+ietf@4668.se<mailto:mbj%2Bietf@4668.se>> wrote:
Hi,

The issue boils down to if list keys are required in a plain patch.
Unfortunately, the RFC doesn't specifucy this.  From a technical pow,
list keys are not necessary.  In fact, if they are present in the
payload, they are redundant (since they are part of the URL) (this is
actually mentioned in the RFC).

Since it isn't clearly specified, I think we must assume that the keys
are not required.  Hence I think that this errata should be rejected.

In a future version of this document, the behaviour should be
clarified.


+1

reject this errata



/martin

Andy


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/eid6342<https://eur01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fwww.rfc-editor.org%2Ferrata%2Feid6342&data=04%7C01%7Cmuly_i%40rad.com%7C556dc10cce6348d850e808d88fb024e0%7Cf9047108cc2c4e4897a343fad1b3bf9d%7C1%7C0%7C637417333989910693%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C1000&sdata=Ah8q7Rb9GwOp4Ck6%2FErNLDk92PpSA6KPbnrxJ%2FHYpjc%3D&reserved=0>
>
> --------------------------------------
> Type: Technical
> Reported by: Muly Ilan <muly_i@rad.com<mailto:muly_i@rad.com>>
>
> Section: 4.6.1
>
> Original Text
> -------------
> To replace just the "year" field in the "album" resource (instead of
> replacing the entire resource with the PUT method), the client might
> send a plain patch as follows:
> PATCH /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%7C556dc10cce6348d850e808d88fb024e0%7Cf9047108cc2c4e4897a343fad1b3bf9d%7C1%7C0%7C637417333989920683%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C1000&sdata=R4iqFtnIw%2FktGcQd1UzdrY5gT6LYF2cl0q%2BfNg63sWs%3D&reserved=0>
> If-Match: "b8389233a4c"
> Content-Type: application/yang-data+xml
> <album xmlns="http://example.com/ns/example-jukebox<https://eur01.safelinks.protection.outlook.com/?url=http%3A%2F%2Fexample.com%2Fns%2Fexample-jukebox&data=04%7C01%7Cmuly_i%40rad.com%7C556dc10cce6348d850e808d88fb024e0%7Cf9047108cc2c4e4897a343fad1b3bf9d%7C1%7C0%7C637417333989920683%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C1000&sdata=T8NtFORUGSRk6HjN%2F382U0vkB%2FVF%2FJ5YvKDkBMETFuA%3D&reserved=0>">
> <year>2011</year>
> </album>
>
> Corrected Text
> --------------
> To replace just the "year" field in the "album" resource (instead of
> replacing the entire resource with the PUT method), the client might
> send a plain patch as follows:
> PATCH /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%7C556dc10cce6348d850e808d88fb024e0%7Cf9047108cc2c4e4897a343fad1b3bf9d%7C1%7C0%7C637417333989930678%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C1000&sdata=63TdkWZRnrYaSaHSHMDbAlxHTkIDP4Zu7YPrzn96RgE%3D&reserved=0>
> If-Match: "b8389233a4c"
> Content-Type: application/yang-data+xml
> <album xmlns="http://example.com/ns/example-jukebox<https://eur01.safelinks.protection.outlook.com/?url=http%3A%2F%2Fexample.com%2Fns%2Fexample-jukebox&data=04%7C01%7Cmuly_i%40rad.com%7C556dc10cce6348d850e808d88fb024e0%7Cf9047108cc2c4e4897a343fad1b3bf9d%7C1%7C0%7C637417333989930678%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C1000&sdata=gysKTJN95f59w58%2BNWMVp5ZG6N7V1Ir0m6dL8JG6qI0%3D&reserved=0>">
> <name>Wasting Light</name>
> <year>2011</year>
> </album>
>
> Notes
> -----
> Missing key leaf value in the message-body (<name>Wasting Light</name>)
>
> 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
>
> _______________________________________________
> netconf mailing list
> netconf@ietf.org<mailto:netconf@ietf.org>
> https://www.ietf.org/mailman/listinfo/netconf<https://eur01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fwww.ietf.org%2Fmailman%2Flistinfo%2Fnetconf&data=04%7C01%7Cmuly_i%40rad.com%7C556dc10cce6348d850e808d88fb024e0%7Cf9047108cc2c4e4897a343fad1b3bf9d%7C1%7C0%7C637417333989940676%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C1000&sdata=RTyHWObVREumAU3i3pb0Q0c8tJVUEcG1v0D0olUm1LA%3D&reserved=0>