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

Kent Watsen <kent@watsen.net> Fri, 01 April 2022 11:24 UTC

Return-Path: <0100017fe4dec66b-298dc5a9-2d75-4a10-b90b-d11553726957-000000@amazonses.watsen.net>
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 E93D93A1312 for <netmod@ietfa.amsl.com>; Fri, 1 Apr 2022 04:24:44 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.908
X-Spam-Level:
X-Spam-Status: No, score=-1.908 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, RCVD_IN_MSPIKE_H4=0.001, RCVD_IN_MSPIKE_WL=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01] 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 jJZOlkJ_-pms for <netmod@ietfa.amsl.com>; Fri, 1 Apr 2022 04:24:41 -0700 (PDT)
Received: from a8-96.smtp-out.amazonses.com (a8-96.smtp-out.amazonses.com [54.240.8.96]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-SHA256 (128/128 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 01A043A1122 for <netmod@ietf.org>; Fri, 1 Apr 2022 04:24:40 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/simple; s=6gbrjpgwjskckoa6a5zn6fwqkn67xbtw; d=amazonses.com; t=1648812279; h=Content-Type:Content-Transfer-Encoding:From:Mime-Version:Subject:Date:Message-Id:References:Cc:In-Reply-To:To:Feedback-ID; bh=IOXaXi8xknZtryZJ1jyP1ferRdehWtr/b91kDDQoFGA=; b=B0P6PC1YIxmlt9fVOtSYHfkHWUntc1IpvEnj2tmhNsR+fgzPw5VaMtdOU/QHygi4 GXYdWQ4b01I5YXXn1B/0giGuziv05AADDqkXGBWvHKuOzI0FpOJxev0x95WM+HS93U6 H73aujeQ8IOzNSknM7LsHaRPsmSQ1oF3l6QEEr60=
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: quoted-printable
From: Kent Watsen <kent@watsen.net>
Mime-Version: 1.0 (1.0)
Date: Fri, 01 Apr 2022 11:24:39 +0000
Message-ID: <0100017fe4dec66b-298dc5a9-2d75-4a10-b90b-d11553726957-000000@email.amazonses.com>
References: <3740e8e7-5e90-f2e2-b252-0dd42690f71c@mg-soft.si>
Cc: NETMOD Working Group <netmod@ietf.org>
In-Reply-To: <3740e8e7-5e90-f2e2-b252-0dd42690f71c@mg-soft.si>
To: Jernej Tuljak <jernej.tuljak@mg-soft.si>
X-Mailer: iPhone Mail (18H107)
Feedback-ID: 1.us-east-1.DKmIRZFhhsBhtmFMNikgwZUWVrODEw9qVcPhqJEI2DA=:AmazonSES
X-SES-Outgoing: 2022.04.01-54.240.8.96
Archived-At: <https://mailarchive.ietf.org/arch/msg/netmod/gN99gvGg8lyjCB1-oNqCOv0WeKk>
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: Fri, 01 Apr 2022 11:24:45 -0000

Hi Jernej,

> RFC7950, 7.14.4. says:
> 
>    Input parameters are encoded as child XML elements to the rpc node's
>    XML element, in the same order as they are defined within the "input"
>    statement.
> 
> For the following model:
> 
> module b {
>   namespace "b:uri";
>   prefix b;
> 
>   grouping params {
>     container params {
>       leaf x {
>         type string;
>       }
>     }
>   }
> 
>   rpc foo {
>     input {
>       uses params {
>         augment params {
>           leaf y {
>             type string;
>           }
>         }
>       }
>     }
>   }
> }
> 
> If both "leaf" data nodes are instantiated (XML encoding) as part of <rpc> for "foo", does <x> come before or after <y> (in document order)?

Augmented-in nodes come after other nodes. 

I’ve always wished there were a way to specify where they’re placed, for readability, but it’s too inconsequential to raise as an issue here. 

> Jernej

Kent