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

Kent Watsen <kent+ietf@watsen.net> Mon, 24 June 2019 14:40 UTC

Return-Path: <0100016b89ee3b1d-3e294e08-2258-4a2d-b0f9-3d8ac149b1f0-000000@amazonses.watsen.net>
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 CE2721202A7 for <netconf@ietfa.amsl.com>; Mon, 24 Jun 2019 07:40:24 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.897
X-Spam-Level:
X-Spam-Status: No, score=-1.897 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, HTML_MESSAGE=0.001, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_NONE=0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (1024-bit key) header.d=amazonses.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 YGM3gvEhDpTc for <netconf@ietfa.amsl.com>; Mon, 24 Jun 2019 07:40:21 -0700 (PDT)
Received: from a8-83.smtp-out.amazonses.com (a8-83.smtp-out.amazonses.com [54.240.8.83]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-SHA256 (128/128 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 6012412018C for <netconf@ietf.org>; Mon, 24 Jun 2019 07:40:21 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/simple; s=6gbrjpgwjskckoa6a5zn6fwqkn67xbtw; d=amazonses.com; t=1561387219; h=From:Message-Id:Content-Type:Mime-Version:Subject:Date:In-Reply-To:Cc:To:References:Feedback-ID; bh=W/LZi7M9IQ10ezakkQmdkohcu7IjtXWfD2id8l3j5mI=; b=HnaFHyjrBf6UZtMsanFpPHx5ibZSI7IvWSIPMl1kHQJsGl/l+tQR2UOpl/QB9Uop SQW0YIrXY8UAi8TzBm9UT/ym1TMM/ravkiaTTOoyJd4/THr1dbQ32/WJJnRK98MRSoN sdeFygATP7ShuKCnT4eRVhWrufXGf3QkUd7fKujY=
From: Kent Watsen <kent+ietf@watsen.net>
Message-ID: <0100016b89ee3b1d-3e294e08-2258-4a2d-b0f9-3d8ac149b1f0-000000@email.amazonses.com>
Content-Type: multipart/alternative; boundary="Apple-Mail=_DCABB559-53C4-4496-90B1-2A0B4BCEA530"
Mime-Version: 1.0 (Mac OS X Mail 12.4 \(3445.104.11\))
Date: Mon, 24 Jun 2019 14:40:19 +0000
In-Reply-To: <CABCOCHR+EZyoFJywjbwc+HWWppFWPgRVGuMN7UoRrAVE3YemqA@mail.gmail.com>
Cc: Qin Wu <bill.wu@huawei.com>, RFC Errata System <rfc-editor@rfc-editor.org>, Martin Bjorklund <mbj@tail-f.com>, Kent Watsen <kwatsen@juniper.net>, Ignas Bagdonas <ibagdona@gmail.com>, Warren Kumari <warren@kumari.net>, Mahesh Jethanandani <mjethanandani@gmail.com>, "netconf@ietf.org" <netconf@ietf.org>
To: Andy Bierman <andy@yumaworks.com>
References: <B8F9A780D330094D99AF023C5877DABAA49AB6EE@nkgeml513-mbx.china.huawei.com> <CABCOCHR+EZyoFJywjbwc+HWWppFWPgRVGuMN7UoRrAVE3YemqA@mail.gmail.com>
X-Mailer: Apple Mail (2.3445.104.11)
X-SES-Outgoing: 2019.06.24-54.240.8.83
Feedback-ID: 1.us-east-1.DKmIRZFhhsBhtmFMNikgwZUWVrODEw9qVcPhqJEI2DA=:AmazonSES
Archived-At: <https://mailarchive.ietf.org/arch/msg/netconf/ZCqp5Nh8jpBIkELf_Alcmy-3YiM>
Subject: Re: [netconf] [Technical Errata Reported] RFC8040 (5761)
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, 24 Jun 2019 14:40:25 -0000

The suggested fix is better.  Too bad we didn't catch it during publication.  Changing it in an Errata isn't appropriate.  Please file an issue for RESTCONF-next here: https://github.com/netconf-wg/restconf-next/issues <https://github.com/netconf-wg/restconf-next/issues>.

Kent



> On Jun 24, 2019, at 10:26 AM, Andy Bierman <andy@yumaworks.com> wrote:
> 
> 
> 
> On Mon, Jun 24, 2019 at 6:27 AM Qin Wu <bill.wu@huawei.com <mailto:bill.wu@huawei.com>> wrote:
> Thanks for the quick reply, can you clarify the reason behind? Thanks!
> 
>  
> 
> 
> 
> RFC 8040 specifies an error-tag to use.
> The claim that RFC 6241 specifies something else is no proof the
> WG intended to use that error-tag in RFC 8040.
> 
> An errata means that implementations that conform to the RFC are wrong
> and need to be corrected.  IMO the change being proposed is not a typo and
> there is no other text in RFC 8040 that contradicts the specified error-tag. 
> 
> A change of this technical significance that impacts conformance needs to go
> through the normal RFC publication/approval process.
> 
> Andy
> 
> -Qin
> 
> 发件人: Andy Bierman [mailto:andy@yumaworks.com <mailto:andy@yumaworks.com>] 
> 发送时间: 2019年6月24日 20:59
> 收件人: RFC Errata System <rfc-editor@rfc-editor.org <mailto:rfc-editor@rfc-editor.org>>
> 抄送: Martin Bjorklund <mbj@tail-f.com <mailto:mbj@tail-f.com>>; Kent Watsen <kwatsen@juniper.net <mailto:kwatsen@juniper.net>>; Ignas Bagdonas <ibagdona@gmail.com <mailto:ibagdona@gmail.com>>; Warren Kumari <warren@kumari.net <mailto:warren@kumari.net>>; Kent Watsen <kent+ietf@watsen.net <mailto:kent%2Bietf@watsen.net>>; Mahesh Jethanandani <mjethanandani@gmail.com <mailto:mjethanandani@gmail.com>>; Qin Wu <bill.wu@huawei.com <mailto:bill.wu@huawei.com>>; Netconf <netconf@ietf.org <mailto:netconf@ietf.org>>
> 主题: Re: [Technical Errata Reported] RFC8040 (5761)
> 
>  
> 
> Hi,
> 
>  
> 
> The cited text is in 4.4.1 (there is no 4.1.1).
> 
>  
> 
> I do not see any evidence that the WG intended to write the word "data-exists" but
> 
> wrote "resource-denied" instead. Therefore this cannot be changed with an errata.
> 
>  
> 
>  
> 
> Andy
> 
>  
> 
>  
> 
> On Sun, Jun 23, 2019 at 6:08 PM 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/eid5761 <https://www.rfc-editor.org/errata/eid5761>
> 
> --------------------------------------
> Type: Technical
> Reported by: Qin WU <bill.wu@huawei.com <mailto:bill.wu@huawei.com>>
> 
> Section: 4.1.1
> 
> Original Text
> -------------
> If the data resource already exists, then the POST request MUST fail
> and a "409 Conflict" status-line MUST be returned.  The error-tag
> value "resource-denied" is used in this case
> 
> Corrected Text
> --------------
> If the data resource already exists, then the POST request MUST fail
> and a "409 Conflict" status-line MUST be returned.  The error-tag 
> value "data-exists" is used in this case
> 
> Notes
> -----
> The error-tag value should be corrected as "data-exists" in this case 
> based on the context. According to error-tag definition in RFC6241:
> 
>    error-tag:      resource-denied
>    error-type:     transport, rpc, protocol, application
>    error-severity: error
>    error-info:     none
>    Description:    Request could not be completed because of
>                    insufficient resources.
> 
> It is apparent error-tag value "data-exists" should be corresponding 
> to the data resource already exists condition.
> 
> 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
>