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

Andy Bierman <andy@yumaworks.com> Thu, 17 October 2019 19:57 UTC

Return-Path: <andy@yumaworks.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 0B63F120241 for <netconf@ietfa.amsl.com>; Thu, 17 Oct 2019 12:57:45 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.898
X-Spam-Level:
X-Spam-Status: No, score=-1.898 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_PASS=-0.001, URIBL_BLOCKED=0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (2048-bit key) header.d=yumaworks-com.20150623.gappssmtp.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 xFK36V8I2rVd for <netconf@ietfa.amsl.com>; Thu, 17 Oct 2019 12:57:42 -0700 (PDT)
Received: from mail-lf1-x12d.google.com (mail-lf1-x12d.google.com [IPv6:2a00:1450:4864:20::12d]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 9290C1200FA for <netconf@ietf.org>; Thu, 17 Oct 2019 12:57:41 -0700 (PDT)
Received: by mail-lf1-x12d.google.com with SMTP id u28so2862195lfc.5 for <netconf@ietf.org>; Thu, 17 Oct 2019 12:57:41 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yumaworks-com.20150623.gappssmtp.com; s=20150623; h=mime-version:references:in-reply-to:from:date:message-id:subject:to :cc; bh=T+nhmrJ+GabRhAjD2+dgts4X6FUI4DE9gn89o+BGsL8=; b=JduU+ZZILwV5TuWRWr5PIGV7C5LYSEPU1sVsmQa8p6016vzc3eRmmvzQSxEe8tFZUF W0Ck0+EZfU6aVgd5SiYj1YKtsxPgoiqUPbrUyEhJqPxnnI5wCtPFhsH893Nbe5OG41Qy YWBnHpEr4jrYNywG5m6dt7ijVeWWCVLv2G/f5S+1qtVehNRqqnotFTHg4PfKxkgekFZy MkyUTAQ7MipNsxJH4Vf6Bd3/uyJ3UxvBCLNgw166hU5NAVCnAtwvWWxPAbVpp10c2c6C Z6C1RG8N2BYxIZpz0e3ipYD95OMnTxh55F9QibQgBuNg2z6yKRgaN/BO9oNGEdUVFUh9 0+NA==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=T+nhmrJ+GabRhAjD2+dgts4X6FUI4DE9gn89o+BGsL8=; b=LA86wPGxPkZg7xcqZnGK5TAjWqDipi7JtwFV19nhj9Vi+adg6Yd/+OccSnB4X05e/8 dJSzSYjSjzYdftqYgOr6a12wt/uoaPmMF741xl06bil2+1T4M24Az/18QRh1xB/O3yAo eEaPzi3CqR7jZLohXvuNTLwlhm6WTf0uz9+8Zm23Qhh4+kriH3KIFCnKyvLjKyK1Dvcd UOG4VdwKna+JSV1Dn50d/urA8aJowDY58dXnW8egJjrtyNvBtRcqz+5PZN+dYeFCbRhg k5mbpY24nw8azJy2bKnvGR4EUisrFPiEBM9kwyfrU5uZXMKUWYiu8gO+yNSfKRsoWBRe wFcg==
X-Gm-Message-State: APjAAAXvdtEmwpIWZx/jUQwXNzjFR5dVnaZm1Y4py4mrrwSB+AHadZMz 40J1wY6xbOqwAgARTMqx6RWtoxwEuFEYpPhycIzp9Q==
X-Google-Smtp-Source: APXvYqw0Y7peU1oNopGM7361U4jW5936JTLpAiGbqWZ5dB5zDLc6PFSOlcXKuHMC/DFSGHuTvagHUsyiM6b2Km3gzpc=
X-Received: by 2002:ac2:4650:: with SMTP id s16mr3736244lfo.32.1571342259447; Thu, 17 Oct 2019 12:57:39 -0700 (PDT)
MIME-Version: 1.0
References: <20190211101359.A9449B82486@rfc-editor.org> <CABwpohtH4hYPQuW+sgE8CC7caNW4CMP5JG+uNb=Am-g5n2t4TA@mail.gmail.com>
In-Reply-To: <CABwpohtH4hYPQuW+sgE8CC7caNW4CMP5JG+uNb=Am-g5n2t4TA@mail.gmail.com>
From: Andy Bierman <andy@yumaworks.com>
Date: Thu, 17 Oct 2019 12:57:28 -0700
Message-ID: <CABCOCHTOgOp59Dm6Ubt+mjYRWgitsTu4=4RN43awvL6CR_i=Ag@mail.gmail.com>
To: Ignas Bagdonas <ibagdona@gmail.com>
Cc: RFC Errata System <rfc-editor@rfc-editor.org>, Martin Bjorklund <mbj@tail-f.com>, Kent Watsen <kwatsen@juniper.net>, Warren Kumari <warren@kumari.net>, Kent Watsen <kent+ietf@watsen.net>, Mahesh Jethanandani <mjethanandani@gmail.com>, Qin Wu <bill.wu@huawei.com>, Netconf <netconf@ietf.org>
Content-Type: multipart/alternative; boundary="00000000000031fe79059520a182"
Archived-At: <https://mailarchive.ietf.org/arch/msg/netconf/jhBug9hJ-Ar4ce54NcqIMIN8lFU>
Subject: Re: [netconf] [Technical Errata Reported] RFC8040 (5633)
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: Thu, 17 Oct 2019 19:57:45 -0000

On Thu, Oct 17, 2019 at 6:08 AM Ignas Bagdonas <ibagdona@gmail.com>; wrote:

> Hi there,
>
> This applies to an example, and while factually correct, it does not seem
> to be a technical errata as such, it is an editorial one
>
> A nit -  a Date: header also needs to be changed.
>
> Any objections?
>
>

I agree the example is wrong -- probably a cut-and-paste from
If-Modified-Since.
In the example shown where 412 Precondition Failed is sent as the response,
the
server Date should be later than Last-Modified date returned.
The fixed example looks like the resource was changed in the future.


Andy


>
>
> On Mon, Feb 11, 2019 at 10:14 AM RFC Errata System <
> 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:
>> http://www.rfc-editor.org/errata/eid5633
>>
>> --------------------------------------
>> Type: Technical
>> Reported by: Qin WU <bill.wu@huawei.com>;
>>
>> Section: B.2.2.
>>
>> Original Text
>> -------------
>>       PATCH /restconf/data/example-jukebox:jukebox/\
>>           library/artist=Foo%20Fighters/album=Wasting%20Light/\
>>           genre HTTP/1.1
>>       Host: example.com
>>       If-Unmodified-Since: Thu, 26 Jan 2017 20:56:30 GMT
>>       Content-Type: application/yang-data+json
>>
>>       { "example-jukebox:genre" : "example-jukebox:alternative" }
>>
>>    In this example, the datastore resource has changed since the time
>>    specified in the "If-Unmodified-Since" header.  The server might
>>    respond as follows:
>>
>>       HTTP/1.1 412 Precondition Failed
>>       Date: Thu, 26 Jan 2017 20:56:30 GMT
>>       Server: example-server
>>       Last-Modified: Thu, 26 Jan 2017 19:41:00 GMT
>>       ETag: "b34aed893a4c"
>>
>>
>> Corrected Text
>> --------------
>>       PATCH /restconf/data/example-jukebox:jukebox/\
>>           library/artist=Foo%20Fighters/album=Wasting%20Light/\
>>           genre HTTP/1.1
>>       Host: example.com
>>       If-Unmodified-Since: Thu, 26 Jan 2017 20:56:30 GMT
>>       Content-Type: application/yang-data+json
>>
>>       { "example-jukebox:genre" : "example-jukebox:alternative" }
>>
>>    In this example, the datastore resource has changed since the time
>>    specified in the "If-Unmodified-Since" header.  The server might
>>    respond as follows:
>>
>>       HTTP/1.1 412 Precondition Failed
>>       Date: Thu, 26 Jan 2017 20:56:30 GMT
>>       Server: example-server
>>       Last-Modified: Thu, 26 Jan 2017 20:57:10 GMT
>>       ETag: "b34aed893a4c"
>>
>>
>> Notes
>> -----
>> The date in the Last-Modified field of the response HTTP header should be
>> greater than the date in the If-Unmodified-Since field of the request HTTP
>> header.
>>
>> 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
>>
>