Re: [netmod] RPC input parameter definition order (uses augment)

Robert Varga <nite@hq.sk> Tue, 05 April 2022 09:18 UTC

Return-Path: <nite@hq.sk>
X-Original-To: netmod@ietfa.amsl.com
Delivered-To: netmod@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 5F6083A22AB for <netmod@ietfa.amsl.com>; Tue, 5 Apr 2022 02:18:00 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.109
X-Spam-Level:
X-Spam-Status: No, score=-2.109 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, NICE_REPLY_A=-0.001, RCVD_IN_DNSWL_BLOCKED=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01, URIBL_BLOCKED=0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (1024-bit key) header.d=hq.sk
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 RvolAGbbWolC for <netmod@ietfa.amsl.com>; Tue, 5 Apr 2022 02:17:54 -0700 (PDT)
Received: from mail.hq.sk (hq.sk [81.89.59.181]) (using TLSv1.2 with cipher ADH-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 986B73A22B5 for <netmod@ietf.org>; Tue, 5 Apr 2022 02:17:53 -0700 (PDT)
Received: from [172.16.4.36] (46.229.239.158.host.vnet.sk [46.229.239.158]) by mail.hq.sk (Postfix) with ESMTPSA id 23C63246794; Tue, 5 Apr 2022 11:17:50 +0200 (CEST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=hq.sk; s=mail; t=1649150270; bh=OqOiNxQziFLUTP7quIGVu+SalMCgF7yxcZnuWKYuv50=; h=Date:Subject:To:Cc:References:From:In-Reply-To; b=PRoU6ZZNJzNWHra8jiD+a2yGDtyo4s2+hJ/67xYnRZZBby0Y4Mvw+Og8SJrlsPSZH my5kWCOtkwBOY8Ibhh4M2TiswNbpyR2ov+t952zX3fSAqIN1UgHjRqPvGNIQFjebzP CRb4TEEf0jy4y5SYP1Jw+ZnRDF1LKHGavhwaCJ2U=
Message-ID: <d162f8b0-1463-c54d-a1a0-1685dfed3d77@hq.sk>
Date: Tue, 05 Apr 2022 11:17:49 +0200
MIME-Version: 1.0
User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:91.0) Gecko/20100101 Thunderbird/91.7.0
Content-Language: en-US
To: Jernej Tuljak <jernej.tuljak@mg-soft.si>, Andy Bierman <andy@yumaworks.com>, Kent Watsen <kent@watsen.net>
Cc: NETMOD Working Group <netmod@ietf.org>
References: <3740e8e7-5e90-f2e2-b252-0dd42690f71c@mg-soft.si> <0100017fe4dec66b-298dc5a9-2d75-4a10-b90b-d11553726957-000000@email.amazonses.com> <CABCOCHR4pGF8wouBkcZm9hJMtKN8TWNNAs8RRfUP-6fHtCPXnw@mail.gmail.com> <9a55de3d-c7bc-597a-e1c8-e11f58325049@mg-soft.si> <31192d86-bd73-9708-b96b-63f1bb291024@hq.sk> <0ec18689-0e95-945f-0c5a-5c4c4d0b5d70@mg-soft.si>
From: Robert Varga <nite@hq.sk>
In-Reply-To: <0ec18689-0e95-945f-0c5a-5c4c4d0b5d70@mg-soft.si>
Content-Type: multipart/signed; micalg="pgp-sha256"; protocol="application/pgp-signature"; boundary="------------13sZq9HFbCg8aAhDXZExo0HR"
Archived-At: <https://mailarchive.ietf.org/arch/msg/netmod/RaD8f5KdkZd5R799iqWQFkuNkVE>
Subject: Re: [netmod] RPC input parameter definition order (uses augment)
X-BeenThere: netmod@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: NETMOD WG list <netmod.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/netmod>, <mailto:netmod-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/netmod/>
List-Post: <mailto:netmod@ietf.org>
List-Help: <mailto:netmod-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/netmod>, <mailto:netmod-request@ietf.org?subject=subscribe>
X-List-Received-Date: Tue, 05 Apr 2022 09:18:01 -0000

On 05/04/2022 09:14, Jernej Tuljak wrote:
>> The presence of the intermediate grouping is a pure module-internal 
>> modeling detail. I believe introducing/removing the grouping is a 
>> non-breaking change as per RFC6020 (if memory serves right).
> 
> Module updating rules state this:
> 
>     o  Any set of data definition nodes may be replaced with another set
>        of syntactically and semantically equivalent nodes.  For example,
>        a set of leafs may be replaced by a "uses" statement of a grouping
>        with the same leafs.
> 
> and this:
> 
>     In statements that have any data definition statements as
>     substatements, those data definition substatements MUST NOT be
>     reordered.
> 
> Can you state that your second example may be rewritten into your first 
> one while retaining semantic equivalence? For the second example, it is 
> clear that XML encoding for that container imposes ordering on <bar> and 
> <foo> (in that order), for the first, this is no longer true.

I stand corrected, I forgot about the second statement and also the 
special-case of RPC input/output:

>    The container's child nodes are encoded as subelements to the
>    container element.  If the container defines RPC input or output
>    parameters, these subelements are encoded in the same order as they
>    are defined within the "container" statement.  Otherwise, the
>    subelements are encoded in any order.

Regards,
Robert