Re: [netmod] EXTERNAL: Module update rules: changing a type to a union

Alex Campbell <Alex.Campbell@Aviatnet.com> Sun, 12 August 2018 23:22 UTC

Return-Path: <Alex.Campbell@Aviatnet.com>
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 926AD130E2C for <netmod@ietfa.amsl.com>; Sun, 12 Aug 2018 16:22:47 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.91
X-Spam-Level:
X-Spam-Status: No, score=-1.91 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_PASS=-0.001, T_DKIMWL_WL_MED=-0.01] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (1024-bit key) header.d=aviatus.onmicrosoft.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 PXgV2onDcR84 for <netmod@ietfa.amsl.com>; Sun, 12 Aug 2018 16:22:45 -0700 (PDT)
Received: from NAM04-CO1-obe.outbound.protection.outlook.com (mail-eopbgr690067.outbound.protection.outlook.com [40.107.69.67]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-SHA384 (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 8A7F7129619 for <netmod@ietf.org>; Sun, 12 Aug 2018 16:22:45 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=aviatus.onmicrosoft.com; s=selector1-aviatnet-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=hLWS4gZVa13PEoIq3cpcjS8MI/BGYXCcYLHwGY4lBIA=; b=Z5v01TDP+WSMdQqg9LU/yPI5mZxrbbuehLFa8mV++mu39MsT0mCVoIrR3raX8Iu6An7VZAj8zxmjqSQ5jU5gWWMvCUiI7RPX9nofJKwlvyq6D+bVrnVx7MebQian5iTx3zG/RPmghxXLsH24dt5DMhY25MCbQg4wyE1rTeJyTR8=
Received: from DM6PR08CA0009.namprd08.prod.outlook.com (2603:10b6:5:80::22) by SN2PR0801MB2205.namprd08.prod.outlook.com (2603:10b6:804:17::16) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.1038.21; Sun, 12 Aug 2018 23:22:43 +0000
Received: from BY2NAM03FT009.eop-NAM03.prod.protection.outlook.com (2a01:111:f400:7e4a::208) by DM6PR08CA0009.outlook.office365.com (2603:10b6:5:80::22) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384) id 15.20.1038.19 via Frontend Transport; Sun, 12 Aug 2018 23:22:42 +0000
Authentication-Results: spf=pass (sender IP is 192.147.115.53) smtp.mailfrom=Aviatnet.com; nokia.com; dkim=none (message not signed) header.d=none;nokia.com; dmarc=bestguesspass action=none header.from=Aviatnet.com;
Received-SPF: Pass (protection.outlook.com: domain of Aviatnet.com designates 192.147.115.53 as permitted sender) receiver=protection.outlook.com; client-ip=192.147.115.53; helo=mail-send.aviatnet.com;
Received: from mail-send.aviatnet.com (192.147.115.53) by BY2NAM03FT009.mail.protection.outlook.com (10.152.84.120) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P256) id 15.20.1059.14 via Frontend Transport; Sun, 12 Aug 2018 23:22:42 +0000
From: Alex Campbell <Alex.Campbell@Aviatnet.com>
To: "Sterne, Jason (Nokia - CA/Ottawa)" <jason.sterne@nokia.com>, "netmod@ietf.org" <netmod@ietf.org>
Thread-Topic: EXTERNAL: [netmod] Module update rules: changing a type to a union
Thread-Index: AdQwu/McZzPv597ySjipjOU6kpIpKgB10lX6
Date: Sun, 12 Aug 2018 23:22:41 +0000
Message-ID: <1534116160999.19498@Aviatnet.com>
References: <VI1PR07MB39818C462606D318A99672B19B240@VI1PR07MB3981.eurprd07.prod.outlook.com>
In-Reply-To: <VI1PR07MB39818C462606D318A99672B19B240@VI1PR07MB3981.eurprd07.prod.outlook.com>
Accept-Language: en-NZ, en-US
Content-Language: en-NZ
X-MS-Has-Attach:
X-MS-TNEF-Correlator:
x-ms-exchange-transport-fromentityheader: Hosted
x-originating-ip: [10.15.6.10]
Content-Type: multipart/alternative; boundary="_000_153411616099919498Aviatnetcom_"
MIME-Version: 1.0
X-EOPAttributedMessage: 0
X-Forefront-Antispam-Report: CIP:192.147.115.53; IPV:NLI; CTRY:US; EFV:NLI; SFV:NSPM; SFS:(10009020)(136003)(396003)(39840400004)(376002)(346002)(2980300002)(438002)(53754006)(189003)(199004)(26005)(86362001)(486006)(126002)(446003)(11346002)(2616005)(476003)(186003)(30436002)(97876018)(6246003)(956004)(19627405001)(25786009)(229853002)(336012)(54896002)(6486002)(53546011)(14444005)(102836004)(6116002)(3846002)(106466001)(16586007)(106002)(296002)(8936002)(72206003)(76176011)(36756003)(15650500001)(316002)(7696005)(110136005)(84326002)(7636002)(478600001)(117636001)(53416004)(7596002)(2906002)(4546004)(356003)(118246002)(7736002)(2501003)(8676002)(36736006)(5660300001)(246002)(19607625011); DIR:OUT; SFP:1101; SCL:1; SRVR:SN2PR0801MB2205; H:mail-send.aviatnet.com; FPR:; SPF:Pass; LANG:en; PTR:mail-send.aviatnet.com; MX:1; A:1;
X-Microsoft-Exchange-Diagnostics: 1; BY2NAM03FT009; 1:679TCiIccdOT9XK1cgEy1wXA8xQOzjr2BBb9jxrYhmOpPwfSlNIcQ6yNpMLPj7A9zhgFuh1ae6JoXRvAKvUMrlscXBzNOxAATrYstj73i++bVw2hq5vUTRXFmZHBHle5
X-MS-PublicTrafficType: Email
X-MS-Office365-Filtering-Correlation-Id: fb1ee6a2-f1e3-47a0-0e9f-08d600aa80ab
X-Microsoft-Antispam: BCL:0; PCL:0; RULEID:(7020095)(4652040)(8989117)(4534165)(4627221)(201703031133081)(201702281549075)(8990107)(5600074)(711020)(4608076)(2017052603328)(7153060)(7193020); SRVR:SN2PR0801MB2205;
X-Microsoft-Exchange-Diagnostics: 1; SN2PR0801MB2205; 3:UbpoqODrTo5jP8e7tLdb/O4sOHKmc/EPiqeRlE4JKK1PJdwJuG9BBkYYH9htbIXeyDIfhtlYQoUxvvIu8goMRw2zkOgZLHieGgLkLZjwwr0rMp8SxjthM+Ll3gMW/tCNeCd3DFziuHz/KK1jcszn2ALHQUp254LDIppmeMxxKOcx96p0x02m70SIGw7lATkUgN/8USKp6sxsr+m6wgIBWAEWubufpsHE99OicJymhIm/fTfT20Nu3+9x3qB8BiHRXylSXthag0mTtkAjTND6L0g2+cyAaKGIB0H9pxc110x8/NlFBObbS5CiOB6M/uDWjsjoSrpwLySVf1lJdy0D7zIQKqPPVUixo2gimgt5NA8=; 25:J5zHYfYlFNkAlUobsmbdL3T1wVKXNo4/I7X1S64T+z4uFtylHL72lBwDvgCcRi5rOOd78jhy0vFyQLHTwE1/hzw2a31c1aFmscO4wI/i0YuZzzhZv0ThMosHKMPpJyDBRT62t25P0QDEveO7lNg7IV5nJDAoouH3EbZ3YJnaCK0vCENpMQCkXKZ7SVVSZsBRyVVc45Q61lbmUhUGcEnvIOy9atyQCtQbot9/Aeyri+C8ZyQET82zfbNm+JDAubIUxsSTbqSav8XeKJlyNTzY/kyGKrX5Op+dktjW0NIByCcxulCCe95s7d7wYucbHlkCTT+HnPCmMMmecOD6tCDxwg==
X-MS-TrafficTypeDiagnostic: SN2PR0801MB2205:
X-Microsoft-Exchange-Diagnostics: 1; SN2PR0801MB2205; 31:scy0ibbYoBucSp/xuwFZ4rHGjK9BxYn/jHeEaS2SyC/uaIN8LZwj71rDpPC7J6KOntEyBlz7xjPK9vgFkDjflddUf91T20+QkU3EN2cOpa5ygVE0VNTNIsygirGOv9LXK4vg2d0t7XpkoayZIyNZqzXnrdrXE3qtLdfwIqK+Lhw5okakOoXWLUHo4d/j7fTrpi9qmc1DR6ZVVr7fg++f+MxDoU0lEYQ0CcuE8iaTYQs=; 20:FrlCkj1yt5g0YVR258NrulIxolMyZ8kr5etOXVFP0fg/zupgUP7d6PhERF7M+PSzb+gr0QTAntoXZHeObWmnlDwcaLX4gct2rCNWTSL4VGagpvuqoPfoO6LqeucK7k6hVePu6pLKuXwHvCBLsm5Lueq0VE+wvwO0t8N4Lp6d+61pvgT15WLxbZr31nIhE5paIGTbH75Wtt0RndGRC7XT78oQySWEirXjRyrbG7nF/d8BzsZJc4eTqLPhVhYCBVUyCSETTF8s6wgUJyF0DrHersZ4G77IoGlb2vxM5ut2hVsFVgiRR57EbMoAQmwCHPExF+dz8ua2qyMhZ14ou799yTE5yX6ZpjsBqLSByt/ZVEGrK8aGePDydpuIrl2s6EukckmlxczwygpqD7bTspHGTIZBxYVj0xnzQcGuolUOQzPFV2S8BMFCDIz8pyOgpZrSOIMTZUoR8uSxQw73SR/teTQbLACuxe+CJmog9jQjYl3J+cGxsnBxngmGMV2MOLou
X-Microsoft-Antispam-PRVS: <SN2PR0801MB2205743015F3CC42D5F60B57873A0@SN2PR0801MB2205.namprd08.prod.outlook.com>
X-Exchange-Antispam-Report-Test: UriScan:(158342451672863)(82608151540597)(109105607167333)(195916259791689);
X-MS-Exchange-SenderADCheck: 1
X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(8211001083)(6040522)(2401047)(5005006)(8121501046)(3002001)(10201501046)(3231311)(944501410)(52105095)(93006095)(93004095)(149027)(150027)(6041310)(201703131423095)(201703031522075)(201702281528075)(20161123555045)(201703061421075)(201703061406153)(20161123558120)(20161123562045)(20161123564045)(20161123560045)(6072148)(201708071742011)(7699016); SRVR:SN2PR0801MB2205; BCL:0; PCL:0; RULEID:; SRVR:SN2PR0801MB2205;
X-Microsoft-Exchange-Diagnostics: 1; SN2PR0801MB2205; 4:P2q5oWqvo6jY810SrxS3lHTDCp7V/yjzMxf0To5xDRwYq2BXzqMSyT2xHpr3Ro/RbHB9OZltuFeFKGWJBZomrLGeIow4ZlqjBKnhKivhVFYB0zxinHNps/0zmCJOPUCub7qxkkwo38DlhtiQTGi6Cm+8NHSrcTF8AKEz2m1mCC5mzDqBLK0EnxgYN0WXq68UtKbWxynzs0keKxGv2tUi/Z/JfGxPqwrK4zfvW9XUEVB4oS+yGHLrVw8BD4GFm+TxysxyXuNtra9inYHZ0lWeyptLIdW/GrLCkToxssaEKWcQ6RT0SLc7otx9zBHUHVSllpYk6yvZXbFsQo8GpBnUSmbGNa46E0yYfIGX0nRPIRsm9lqwTvoNVogovCKre4V89u0nCy5+cmmRTp1CzE3AYfN1q4kyvyJtA3cb2QHMbMI=
X-Forefront-PRVS: 0762FFD075
X-Microsoft-Exchange-Diagnostics: 1; SN2PR0801MB2205; 23:pp1SNT6E/gCO7786z4CAz/3+eMhEm2lMxR4LpJgNVSyraeyS3qMAjh3FjT4UeigG0huV8kI9c+Qrmbwa6YeVRFDHclXNX7I1U5pkdS58mnQPfjeeP8XOZIjWvHSJFLUMr0UUxiThpPgux1AHnzvHveslt6OwIMGiHyb5m6uOcw5RJZrqxsES76L9q74s4OqLu4LFwyZwGJn9W9wHp6EXfcSsXCsw54DTwJaiSlnOYj/KeeCG7V2JafOiPci7EXSh0MEODzQcT10kE5Sz1bp174ayPM8NFdmK1n6DjE5ljYfHPrV5hBjJ4afZSOSxRlzm/BSOnjQWuV7LqXurPx8g7IiAVDDPiidI3h1+fl6t+Vuk7d678skzlcVfZSe74neFQffqRZ1E2Wt+d4gN9PVMUikMdoQrXUc7DtI2/8lsasVVVynPLAGMQ5va6NgoyMsh//HnZw2yFcZx/PPnbc4oHgNoyPmnsiZxPuW+terM1VCls43Ys1nWycK9kY8T6449pzGtkJXCwTBx+nr/3at4DhkJHv5eCpMryX9bhRyXpDfyuqc39Pyp9bc0UZXT3Q+DfKgAIcc/V+6eXKSvU9vTm8dKo+5UNNG6Bcl7s9PSKyZS80Cc59DzcgNdRh8fgkIDVyB+dTogpFevJ4wnBcviv5Pu+uIiC5JsqoMB/UQbXhSjHndZYKg8IdumltmMayaN791nV0ueFffVB5en6RidscyxMsh1giP+KGEsRHJWOWXW7TgqfATBWxshb8eTCnszZaTQB0nnxDWxy82SYox25xKT8HziI1rPAo3BmW1d2zBspTjWjnWgKX/3zKlAekV+/befq3gFAotuNsXmiRhj2YW50CaQLfXv0ybPRok0E3dCmPpj0FW7bkkY8a6NaPwpEOYjXvmiIiidYkeZ1BjaBdX2ERzsMGAHu7X0hkOQE3FwGD/Kwpsmtedy9c5E3G27NGvRBb+3MFDbFGSKSbBfncXk43GhS/8vqz+RHNuoZ6Udvps6QHwcI3k+2noowyXNDQucJGgEuPJULvxCUZYFjbKN/TNK5B1Hm/nUWSnAmyLeTJI1EXwcYEYnwWUyYfduAH02FL2vo82MnTVnLA41XgdxMaswVVzV8L1fwOkNV2b6XDPwCG3yRDU4y9OGGxaDe3OH2f3JdaNidQrgdirKRNo3iE1CFxgegX1gov4Jpq2jt5eh3J+k10GlszMsWfwvCgvrgniP0BfbtSXIVMGnSL4b/auxk5c+HEavoFFmpyctY5CukUf3DHgg2gUtYzyX67Pj7d17zBUhbTNot11OIyxJgD99pDhMa65SVmqyXR4VEu54MAvYVMom9fdyXQfo7zS4A3RLFr8+9ZDdKLfiyQRvvdpJXK9xac8uZKbTNrk=
X-Microsoft-Antispam-Message-Info: jR39lIoGQ1t4f4j/jQjz3ziNQkeT4kQd+xaunWIhor+XcoCNXR03UDanJpK6K3MX7uZs3gqBgnB8zwF3v/B2c4Cuo5sixHVY6akCi6cvkByG+IW7MpZy/rLluUelE8hfZSY64/p+DjqcfNyfRDGlFvdexDk53qwFqBfPUqeZue9mFx9MJVPagQPxi/JJ+0tb8M0c9z2cOihlzNupiILUxffLpzNT3tgLmYYrBJqfJ8WAt7TfAwYGBZiIeFS4jrvDlNa1od2DlG5YENwUE5LbHziFdEwaNUGawFFOQzkxkZbfYMRftL07Xddvq4R8tgj76YWPyOhX9gwyUr2Uqodz08BEjQG32kZU2sstf2Gv0ZI=
X-Microsoft-Exchange-Diagnostics: 1; SN2PR0801MB2205; 6:GDGtunT17vFki+L2vVnLoXBLWud/iHMjW7aHJEnRFWBYc+1JFU3QPxulJTwbC93OYEJyuTjohr1aXXqk8GBK256nLhGauO9ZR5kswyleRDW7KQsy1O4TpgMASVLg0kRn73U00bKzUQ43wFzqhW/M6FouuaL9giIi6Dek4a2COVs/tQPHLjhXifWeyWLX8Cmy9otZdm7N+9BQL1ewPXCFVzVoPofvrakQNXx7N6/dh1AE/V8EIxOM+4HWIDuZTvlV7jweeeb+lX03ZkdE1kOp026OHwtFAG/cyML7o13cCtll6S9EockjjypEaq3AX6D+owDv1J+1mixTc3z+Bv3okqv7ph2ZIwI0BrE5sAais8Nwms9VGuOP+a5Pt6L2nciTqmQTq3GqBUWmW3jCFjOc7FgVxoV9m5PxxvLhtf8TTM+06DHJj+Gf1EDxoJhFMVyCwtIBRtLRPJgxu55ESDDZpA==; 5:z9PFEG/JYLJLb946Zeeih4M2abZouMTahen/AZdZ6zpaR80CEB0QHXDH11wA3P4TKB7+fAqZTAD4dVMdKwU4icvPIesLzYYz7cNrj0zKMSzi2xLwS3nUs05jESPU6q5IgfU5rRfrWXZbsXk9oBfLNdMvk0Hd/p8O31NGXyEpg1Y=; 7:ItVcANQoLa+ew/mLvmbz4M0cZi44m/5PHhEjQNWrvz/xPg2GctXyawWqDIL1xggWsBEb2RHbJXAz6NY+z4bBtbv2mQTGyaKvY1Zjpj4bIFYcZoyp28+u8SD9EoEaUgBWz8HF5uuBdyaXOR2jTVk4Unb/UUcyJTpW43JahthBy2g3TLppImxLyYxzwR6hZirLVZT6IwC+yN3jCzA7JLd2jkZp490y1j3kDZOJcRniNYyqlvVeCNZxKwZFeC5SI4JG
SpamDiagnosticOutput: 1:99
SpamDiagnosticMetadata: NSPM
X-OriginatorOrg: aviatnet.com
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 12 Aug 2018 23:22:42.2013 (UTC)
X-MS-Exchange-CrossTenant-Network-Message-Id: fb1ee6a2-f1e3-47a0-0e9f-08d600aa80ab
X-MS-Exchange-CrossTenant-Id: 8d7d22b9-3890-4eef-95a6-a226e64151be
X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=8d7d22b9-3890-4eef-95a6-a226e64151be; Ip=[192.147.115.53]; Helo=[mail-send.aviatnet.com]
X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem
X-MS-Exchange-Transport-CrossTenantHeadersStamped: SN2PR0801MB2205
Archived-At: <https://mailarchive.ietf.org/arch/msg/netmod/jS7FKaxBdXNgJhIhnEpsAYaMQ90>
Subject: Re: [netmod] EXTERNAL: Module update rules: changing a type to a union
X-BeenThere: netmod@ietf.org
X-Mailman-Version: 2.1.27
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: Sun, 12 Aug 2018 23:22:47 -0000

Hi,


It seems to be that the rule you quoted specifically states that expanding the value space is not okay:


   o  A "type" statement may be replaced with another "type" statement
      that does not change the syntax or semantics of the type.  For
      example, an inline type definition may be replaced with a typedef,
      but an int8 type cannot be replaced by an int16, since the syntax
      would change.



________________________________
From: netmod <netmod-bounces@ietf.org> on behalf of Sterne, Jason (Nokia - CA/Ottawa) <jason.sterne@nokia.com>
Sent: Saturday, 11 August 2018 3:19 a.m.
To: netmod@ietf.org
Subject: EXTERNAL: [netmod] Module update rules: changing a type to a union

Hi all,

I'm uncertain about how to interpret the YANG module update rules when a type changes to a union.

Is the following change allowed?

From:
  typedef my-type {
    type enumeration {
      enum "foo";
    }
  }
To:
  typedef my-type {
    type union {
      type enumeration {
        enum "foo";
      }
      type uint32;
    }
  }

The general spirit of the rules is that expanding the value space is generally OK, but this case does seem to violate this paragraph of section 11:

   o  A "type" statement may be replaced with another "type" statement
      that does not change the syntax or semantics of the type.  For
      example, an inline type definition may be replaced with a typedef,
      but an int8 type cannot be replaced by an int16, since the syntax
      would change.


Does the addition of the union change the semantics of the type if that union encompasses the original type?

With XML encoding I can see how an "old" client could easily still communicate with a "new" server for this change. But I wonder about other possible encodings that might change when a type becomes a union that contains additional types.

Regards,
Jason