[Netconf] the name "checksum" in YANG library

Martin Bjorklund <mbj@tail-f.com> Thu, 11 October 2018 10:46 UTC

Return-Path: <mbj@tail-f.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 DAFDF130E57 for <netconf@ietfa.amsl.com>; Thu, 11 Oct 2018 03:46:02 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.901
X-Spam-Level:
X-Spam-Status: No, score=-1.901 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, SPF_PASS=-0.001] autolearn=ham autolearn_force=no
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 pr_cwmF_xiz0 for <netconf@ietfa.amsl.com>; Thu, 11 Oct 2018 03:46:01 -0700 (PDT)
Received: from mail.tail-f.com (mail.tail-f.com [46.21.102.45]) by ietfa.amsl.com (Postfix) with ESMTP id 5B4DA130DE5 for <netconf@ietf.org>; Thu, 11 Oct 2018 03:46:01 -0700 (PDT)
Received: from localhost (unknown [173.38.220.61]) by mail.tail-f.com (Postfix) with ESMTPSA id 9D9C31AE0310 for <netconf@ietf.org>; Thu, 11 Oct 2018 12:46:00 +0200 (CEST)
Date: Thu, 11 Oct 2018 12:46:00 +0200
Message-Id: <20181011.124600.2085483972062437440.mbj@tail-f.com>
To: netconf@ietf.org
From: Martin Bjorklund <mbj@tail-f.com>
X-Mailer: Mew version 6.7 on Emacs 24.5 / Mule 6.0 (HANACHIRUSATO)
Mime-Version: 1.0
Content-Type: Text/Plain; charset="us-ascii"
Content-Transfer-Encoding: 7bit
Archived-At: <https://mailarchive.ietf.org/arch/msg/netconf/sXC8oF6CtxXvzyKHOgqXWX8TE_U>
Subject: [Netconf] the name "checksum" in YANG library
X-BeenThere: netconf@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: Network Configuration WG mailing 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, 11 Oct 2018 10:46:03 -0000

Hi,

Several reviewers in the IESG have commented that the name "checksum"
in YANG library is misleading.  It is not really a checksum ('There is
no requirement that the same information always results in the same
"checksum" value.')

So since many people have complained, maybe we should change it.

After a quick discussion among (some of the) authors, we suggest that
we call it "YANG library content identifier" or "content-id" for
short.

The changes would be:

OLD:

   o  YANG library checksum: A server-generated checksum of the contents
      of the YANG library.

NEW:

   o  YANG library content identifier: A server-generated identifier of
      the contents of the YANG library.


OLD:

   o  The "/yang-library/checksum" leaf contains the YANG library
      checksum, which is a unique implementation-specific identifier
      representing the current information in the YANG library on a
      specific server.


NEW:

   o  The "/yang-library/content-id" leaf contains the YANG library
      content identifier, which is a unique implementation-specific
      identifier representing the current information in the YANG
      library on a specific server.


... and various simpler search&replaces.


We would also update the schema-mount and netconf-nmda documents to
use the new term.


Does anyone object to this change?



/martin