Re: [netmod] Query about augmenting module from submodule in YANG 1.0

Robert Wilton <rwilton@cisco.com> Mon, 21 August 2017 14:04 UTC

Return-Path: <rwilton@cisco.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 C50F4132A50 for <netmod@ietfa.amsl.com>; Mon, 21 Aug 2017 07:04:12 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -14.5
X-Spam-Level:
X-Spam-Status: No, score=-14.5 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, HTML_MESSAGE=0.001, RCVD_IN_DNSWL_HI=-5, SPF_PASS=-0.001, USER_IN_DEF_DKIM_WL=-7.5] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (1024-bit key) header.d=cisco.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 Qq5I_FSYS5iG for <netmod@ietfa.amsl.com>; Mon, 21 Aug 2017 07:04:09 -0700 (PDT)
Received: from aer-iport-3.cisco.com (aer-iport-3.cisco.com [173.38.203.53]) (using TLSv1.2 with cipher DHE-RSA-SEED-SHA (128/128 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id D5A4D124207 for <netmod@ietf.org>; Mon, 21 Aug 2017 07:04:08 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=cisco.com; i=@cisco.com; l=9757; q=dns/txt; s=iport; t=1503324248; x=1504533848; h=subject:to:references:from:message-id:date:mime-version: in-reply-to; bh=aqJ2IHKiDkQg4QVp5Z5ifOYLbtE5dym+Ep9TrCwR2Vo=; b=CYlDwLNvZeVdLH4zXL4C23ApD0usLeajV5oOMhvVA3RieTALcSJRRL9O jZUvUayLU+gwAbkCnT3EUYa09nu/VT7f632ltwq6FatFsSJ7UexpxCc9l tDABHkjuLlHlZNGjBy62F0y1SCcbOf9y7clrH5UHy4CgeBGg3SSWSgViR o=;
X-IronPort-Anti-Spam-Filtered: true
X-IronPort-Anti-Spam-Result: A0AvAwDu55pZ/xbLJq1eGQEBAQEBAQEBAQEBBwEBAQEBgm8+gRGBFYN3iw6QbSKQZYU5DoIEK4UcAoRIFwECAQEBAQEBAWsohRgBAQEBAyNLBhEECxEEAQEBJwMCAkYJCAYBDAYCAQEQih0QrnyCJieLMgEBAQEBAQEBAQEBAQEBAQEBAQEBAR2DKINOgWMrC4JxgyaBNQuDIIJhBaBPh1SMboIQWYhghxWJaYNJiG4gATaBCjIhCBwVSYcbPzYBAYgggj8BAQE
X-IronPort-AV: E=Sophos;i="5.41,409,1498521600"; d="scan'208,217";a="655117401"
Received: from aer-iport-nat.cisco.com (HELO aer-core-1.cisco.com) ([173.38.203.22]) by aer-iport-3.cisco.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 21 Aug 2017 14:04:04 +0000
Received: from [10.63.23.66] (dhcp-ensft1-uk-vla370-10-63-23-66.cisco.com [10.63.23.66]) by aer-core-1.cisco.com (8.14.5/8.14.5) with ESMTP id v7LE44wU026765; Mon, 21 Aug 2017 14:04:04 GMT
To: "Ivory, William" <william.ivory@intl.att.com>, "'netmod@ietf.org'" <netmod@ietf.org>
References: <E3378E0605547F4E854DEE0CB1116AB020865B@gbcdcmbx03.intl.att.com> <85A1FF5A-EF0B-4278-B4FF-3FE431486B2C@tail-f.com> <E3378E0605547F4E854DEE0CB1116AB02102DC@gbcdcmbx03.intl.att.com> <11857e8e-f46e-dc2e-cf99-80224859d221@transpacket.com> <E3378E0605547F4E854DEE0CB1116AB0210631@gbcdcmbx03.intl.att.com> <defe35bb-bb8b-f1f0-d8c4-2d2d0f23731b@transpacket.com> <1502290869.16638.15.camel@nic.cz> <20170809151312.GC42207@elstar.local> <6ef68131-f731-0edc-b731-d7ec85924f03@cisco.com> <E3378E0605547F4E854DEE0CB1116AB021CE2D@gbcdcmbx03.intl.att.com>
From: Robert Wilton <rwilton@cisco.com>
Message-ID: <2c4b4d0c-daf0-899c-8025-38395ef9902e@cisco.com>
Date: Mon, 21 Aug 2017 15:04:04 +0100
User-Agent: Mozilla/5.0 (Windows NT 10.0; WOW64; rv:52.0) Gecko/20100101 Thunderbird/52.2.1
MIME-Version: 1.0
In-Reply-To: <E3378E0605547F4E854DEE0CB1116AB021CE2D@gbcdcmbx03.intl.att.com>
Content-Type: multipart/alternative; boundary="------------E49EEFE75767679D52F30E5B"
Content-Language: en-US
Archived-At: <https://mailarchive.ietf.org/arch/msg/netmod/YeXMb1Wl2ckc8SKsA8eh54arBLU>
Subject: Re: [netmod] Query about augmenting module from submodule in YANG 1.0
X-BeenThere: netmod@ietf.org
X-Mailman-Version: 2.1.22
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: Mon, 21 Aug 2017 14:04:13 -0000

Hi William,

The github issue is really only to track this point for further 
discussion and to the avoid losing the useful discussion on the alias.

I think that there is often useful discussion on the NETMOD alias that 
ends up at least with a partial resolution, but that never gets 
documented anywhere.  In a few cases these end up as errata, but often 
they either get deferred to a future version, or are treated as 
collective wisdom from the WG participants.  For the latter case, I'm 
hoping that we can store the summary of some of these discussions on a 
community maintained wiki.


YANG 1/1.1 modules using sub-modules could be upgraded into a single 
YANG 2.0 module.  This is an allowed backwards compatible change with no 
changes to the node paths or namespaces.

The pertinent text is in RFC 7950, sec 11:

    o  A module may be split into a set of submodules or a submodule may
       be removed, provided the definitions in the module do not change
       in any way other than those allowed here.

Thanks,
Rob


On 21/08/2017 14:44, Ivory, William wrote:
> Hi Rob,
>
> That would make it very hard to update existing 1.x YANG models to use new features in YANG 2.x if they used submodules.  Maybe that's something that no one would ever consider doing anyway, or maybe YANG 1.1 already has similar differences to 1.0?  I had (perhaps naively) assumed that you could migrate a namespace / model from YANG 1.0 to 2.0?
>
> Regards,
>
> William
>
> -----Original Message-----
> From: netmod [mailto:netmod-bounces@ietf.org] On Behalf Of Robert Wilton
> Sent: 21 August 2017 11:24
> To: netmod@ietf.org
> Subject: Re: [netmod] Query about augmenting module from submodule in YANG 1.0
>
>
>
> On 09/08/2017 16:13, Juergen Schoenwaelder wrote:
>> On Wed, Aug 09, 2017 at 05:01:09PM +0200, Ladislav Lhotka wrote:
>>> I remember that in early stages of YANG there was some irrational
>>> fear of introducing too many namespaces, and submodules may be a
>>> consequence of it. As you write, submodules provide no benefits
>>> whatsoever in terms of modularity, but the overhead in terms of
>>> metadata, IANA registration etc. is pretty much the same as for
>>> modules.
>> In case YANG 2.0 is ever done, I suggest someone files a proposal to
>> remove submodules if the cost/benefit ratio is at odds. There is
>> nothing wrong with removing stuff that has been found problematic.
> I agree.
>
> I've added https://urldefense.proofpoint.com/v2/url?u=https-3A__github.com_netmod-2Dwg_yang-2Dnext_issues_26&d=DwICAg&c=LFYZ-o9_HUMeMTSQicvjIg&r=p8kyeK3u4ZYiaQ2ZPGqwkyXmQgBH6r5jpYiYWzhqJ48&m=l7c4IPL049A2bVVO14fyBMly211xU61xSHgPlAT7owI&s=-kR4fUtXArQy0RwWb32DpT1bP4X_cNqt2zJVoC0JiX8&e=
>
> Rob
>
>> The motivation for submodules was that organizations maintaining large
>> modules with multiple people can do so without having to mess around
>> with tools like m4 scripts to produce a single module from 'snippets'
>> and to avoid integration surprises. But perhaps using m4 scripts and
>> decent version control systems (that can integrate and compile on
>> checkin) is indeed cheaper than having submodules part of the YANG
>> language itself.
>>
>> /js
>>
> _______________________________________________
> netmod mailing list
> netmod@ietf.org
> https://urldefense.proofpoint.com/v2/url?u=https-3A__www.ietf.org_mailman_listinfo_netmod&d=DwICAg&c=LFYZ-o9_HUMeMTSQicvjIg&r=p8kyeK3u4ZYiaQ2ZPGqwkyXmQgBH6r5jpYiYWzhqJ48&m=l7c4IPL049A2bVVO14fyBMly211xU61xSHgPlAT7owI&s=t7vGIH8ABuAm00e-bkSowD9eawModGq0N2OkjANtpYI&e=
> .
>