Re: [netmod] Text in import to indicate whether a module is needed as import-only or as implemented

Balázs Lengyel <balazs.lengyel@ericsson.com> Fri, 03 January 2020 09:12 UTC

Return-Path: <balazs.lengyel@ericsson.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 001F91200D8 for <netmod@ietfa.amsl.com>; Fri, 3 Jan 2020 01:12:34 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.001
X-Spam-Level:
X-Spam-Status: No, score=-2.001 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIMWL_WL_HIGH=-0.001, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, HTML_MESSAGE=0.001, RCVD_IN_DNSWL_NONE=-0.0001, SPF_PASS=-0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (1024-bit key) header.d=ericsson.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 o3F7FzH_hZXa for <netmod@ietfa.amsl.com>; Fri, 3 Jan 2020 01:12:33 -0800 (PST)
Received: from EUR02-HE1-obe.outbound.protection.outlook.com (mail-eopbgr10058.outbound.protection.outlook.com [40.107.1.58]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 73B24120044 for <netmod@ietf.org>; Fri, 3 Jan 2020 01:12:32 -0800 (PST)
ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=ZmBkA3gZ8X/aNtv+rlXeSSdF2He439kxxc8bhes1TY9qPio0RUvtyZvRW0vsWLr+mbR2q1ArYLZk9B6mUt6GSJWUj9VUrOFr1fQfYZw7WNeXkTQEg0BaNqXVg8DqX+dVVKpu8qOMCS0dj6l4jpogi7/lt5b1uJY9Of740Lk5n9wLg+ZvgaI8bQGL/ORAGk79jUYc5IZhx422nqdh+JXJVHrazt7Vk4bYD1muHPeaFmyU9AaeTMqugItyxEr7Zny9WjD8/rwVdDHv50TyU2/x1SpTDJZL8vXzjFuxfOGARd0n7CxtJALo5qJ4YiBDPUpqR9LQk1OKvKAyA74VimmgYA==
ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=sztfwSjB61OHYGOpnTL7yoLvWfmuAsYFQol0b1FjSWA=; b=NsuZagJRdWhir28XVzQNAGYCP/VCz0BHXP7KuJq9lKJJNaczYo2xTJVkh8/OHmAlDV0UpQaxOAZJ51JApS6n2LedVnkoZs03W005an70gLY0BZ1FWlcya0ruiAC1vjK4qxd7MdAkqHM81m5l/O9oDdXnAD33I2KedYxe7yp2KVBARdRk707eO9IZnrZNyIxNJOdjSqYYCttueN4mxtCmU3tYOSVXHyyZsuPsURCzD18bOx6wQ3sF6fcT0ry52aJpNL/IP2fGE9QZZM6pTLyT0KAHpeVMCMk4MYAcs2BJ8oR+CAgg5KtNTAYXpMJ35UDbnHUJQR2jdOC0uPzTcJOUrQ==
ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=ericsson.com; dmarc=pass action=none header.from=ericsson.com; dkim=pass header.d=ericsson.com; arc=none
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=ericsson.com; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=sztfwSjB61OHYGOpnTL7yoLvWfmuAsYFQol0b1FjSWA=; b=qv83W7R7FI9yBkaY4eIa22v9MT8NdVhDp9EO85D/JCMAag83yRqEv19OZNwuMVldGzLXbJujGMWpIuavmKxgncHgEsSvb0xF9UqZn7P7aZXxxaJOBRGTX2Q+jsXPJSjhyeATl8VHJEbAHjzQS/28emmi12Au9fQl01HuhwYGSmY=
Received: from VI1PR07MB4047.eurprd07.prod.outlook.com (52.134.20.154) by VI1PR07MB5920.eurprd07.prod.outlook.com (20.178.15.152) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.2602.8; Fri, 3 Jan 2020 09:12:29 +0000
Received: from VI1PR07MB4047.eurprd07.prod.outlook.com ([fe80::819:a879:8fe2:1686]) by VI1PR07MB4047.eurprd07.prod.outlook.com ([fe80::819:a879:8fe2:1686%5]) with mapi id 15.20.2602.012; Fri, 3 Jan 2020 09:12:29 +0000
From: =?utf-8?B?QmFsw6F6cyBMZW5neWVs?= <balazs.lengyel@ericsson.com>
To: Andy Bierman <andy@yumaworks.com>, Ladislav Lhotka <lhotka@nic.cz>
CC: NetMod WG <netmod@ietf.org>
Thread-Topic: [netmod] Text in import to indicate whether a module is needed as import-only or as implemented
Thread-Index: AdW1rIivNNF/ygLlRsqN7vYQ6ujj8wAHQSMAABzp24AAAQTrAAARCBUAAADIkQAC4vIRcA==
Date: Fri, 3 Jan 2020 09:12:29 +0000
Message-ID: <VI1PR07MB40472B4BEFB581AEE4F7C158F0230@VI1PR07MB4047.eurprd07.prod.outlook.com>
References: <AM0PR0702MB36654D2907FBCC620AD179F7F0530@AM0PR0702MB3665.eurprd07.prod.outlook.com> <CABCOCHR_jEGDjSA_BhUWyLFB=4JJSFKqyT_3AHi91pfGFik-LQ@mail.gmail.com> <87fthgye1c.fsf@nic.cz> <20191219075237.44xz6d34mn2ihjw2@anna.jacobs.jacobs-university.de> <d3520549f06107de8939af24268f56f56683fbb0.camel@nic.cz> <CABCOCHRFQrXgGKB10B9MXbKa2vMfaY3eWaj5Sp4W0DPQ0F-pGQ@mail.gmail.com>
In-Reply-To: <CABCOCHRFQrXgGKB10B9MXbKa2vMfaY3eWaj5Sp4W0DPQ0F-pGQ@mail.gmail.com>
Accept-Language: en-US
Content-Language: en-US
X-MS-Has-Attach: yes
X-MS-TNEF-Correlator:
authentication-results: spf=none (sender IP is ) smtp.mailfrom=balazs.lengyel@ericsson.com;
x-originating-ip: [89.135.192.225]
x-ms-publictraffictype: Email
x-ms-office365-filtering-correlation-id: a5a1a519-f4be-4e04-3650-08d7902d0f1d
x-ms-traffictypediagnostic: VI1PR07MB5920:
x-microsoft-antispam-prvs: <VI1PR07MB592090459629176572E386CAF0230@VI1PR07MB5920.eurprd07.prod.outlook.com>
x-ms-oob-tlc-oobclassifiers: OLM:8273;
x-forefront-prvs: 0271483E06
x-forefront-antispam-report: SFV:NSPM; SFS:(10009020)(4636009)(346002)(136003)(39860400002)(366004)(376002)(396003)(189003)(199004)(8936002)(66476007)(8676002)(33656002)(81156014)(81166006)(7696005)(4001150100001)(26005)(966005)(85182001)(86362001)(66446008)(64756008)(66616009)(186003)(66946007)(66556008)(76116006)(71200400001)(4326008)(53546011)(6506007)(55016002)(52536014)(5660300002)(9686003)(2906002)(316002)(110136005)(66574012)(85202003)(478600001); DIR:OUT; SFP:1101; SCL:1; SRVR:VI1PR07MB5920; H:VI1PR07MB4047.eurprd07.prod.outlook.com; FPR:; SPF:None; LANG:en; PTR:InfoNoRecords; MX:1; A:1;
received-spf: None (protection.outlook.com: ericsson.com does not designate permitted sender hosts)
x-ms-exchange-senderadcheck: 1
x-microsoft-antispam: BCL:0;
x-microsoft-antispam-message-info: 8FPgFJ43uyHX2+TKPybfntDECXHSc6XhsZTZvyYtfce0pFnOGOmoOy4isfy33XBUABdueJb7h1f5Xz7V2/ULZA+ElM6mJSsNTgxacoWqrb2vfaKWO8tvdrAZtFxq/LqNexIRZahcMDAXDmhvHkyXb0OfkAvVxznhDHBeYynAHp7ruwKisqVexB0YxTmL3un/qJMGD8UZatfRHMmrjuMdEM9l4pR5ZO4Sih/sBiBgi2jKKZjfh2Cw2PrmA5kn10pyGoHjEzcN/ZmeAM3FwVK3vDRXnHBrMDAvlKkV3cJ+LuwHVcY65eep2yJEOOinb63kSL68t3XaiXWjtMtdwSH8tOVsK5hF96YUCpun838hgAprDzY8twNP9UnnT+ctOhQR1q+3YAVHgAd+jW9z2TTiNezF2Cy/96R4MqbF4K8q8zmN8ehzrX3suEqtKmfYoLTd+hbST7fpF8S32qjNRDLE5Tt4KTKa3H6vZBr8SHvrVS4=
x-ms-exchange-transport-forked: True
Content-Type: multipart/signed; protocol="application/x-pkcs7-signature"; micalg=SHA1; boundary="----=_NextPart_000_000A_01D5C21E.49EFFE10"
MIME-Version: 1.0
X-OriginatorOrg: ericsson.com
X-MS-Exchange-CrossTenant-Network-Message-Id: a5a1a519-f4be-4e04-3650-08d7902d0f1d
X-MS-Exchange-CrossTenant-originalarrivaltime: 03 Jan 2020 09:12:29.6266 (UTC)
X-MS-Exchange-CrossTenant-fromentityheader: Hosted
X-MS-Exchange-CrossTenant-id: 92e84ceb-fbfd-47ab-be52-080c6b87953f
X-MS-Exchange-CrossTenant-mailboxtype: HOSTED
X-MS-Exchange-CrossTenant-userprincipalname: wuhFnia0Z0cBkoQqhA94RDq+yKVgjP9tKyGjgVodd2QKaUV8clDJvfs7pX1bWtWkgM3saGhBqdtNH7ibSG0SbED5Xn4jEjWWZ6Xgc3/KARA=
X-MS-Exchange-Transport-CrossTenantHeadersStamped: VI1PR07MB5920
Archived-At: <https://mailarchive.ietf.org/arch/msg/netmod/CaxFS4ppS7-EMeMXljpbTI1v7zg>
Subject: Re: [netmod] Text in import to indicate whether a module is needed as import-only or as implemented
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, 03 Jan 2020 09:12:35 -0000

As a draft author who was asked to add text about the imports IMHO

*	it would be easy for me to remove the description from the import. Actually I really just want to know what is acceptable to the group, so I can proceed
*	I also think that adding this text is in most cases easy and it does not need updates later.
*	The rules in some cases might not be trivial.

*	Imported YAMs need to be implemented if

*	Imported parts are included in Xpath (augment, when, must, require-instance)

*	Imported YAMs do not need to be implemented if only the following are used

*	Types
*	Features
*	extensions

*	Ambiguous if

*	groupings are used
*	if the dependency is not formally defined by YANG, but functionally needed. (E.g. notification-capabilities does not formally need YANG-Push to be implemented, however there is no sense in defining capabilities if YANG-Push is itself not implemented.)
*	deviation ?
*	other cases ?

Regards Balazs

 

From: netmod <netmod-bounces@ietf.org> On Behalf Of Andy Bierman
Sent: 2019. december 19., csütörtök 17:23
To: Ladislav Lhotka <lhotka@nic.cz>
Cc: NetMod WG <netmod@ietf.org>
Subject: Re: [netmod] Text in import to indicate whether a module is needed as import-only or as implemented

 

 

 

On Thu, Dec 19, 2019 at 8:00 AM Ladislav Lhotka <lhotka@nic.cz <mailto:lhotka@nic.cz> > wrote:

On Thu, 2019-12-19 at 07:52 +0000, Schönwälder, Jürgen wrote:
> On Thu, Dec 19, 2019 at 08:23:27AM +0100, Ladislav Lhotka wrote:
> > I don't see how YANG syntax defines this. If a module imports ietf-netconf-
> > acm, it could be because
> > 
> > - it just uses a typedef, such as "node-instance-identifier", and then
> >   ietf-netconf-acm needn't be implemented (but can be),
> > 
> > or
> > 
> > - it augments ietf-netconf-acm, which makes sense only if the latter
> >   module is implemented.
> > 
> > It it the YANG library that specifies whether a module is implemented or
> > not, but the "import" statement itself doesn't tell you anything.
> > 
> 
> Can we not assume that an implementor will figure out the difference?

An implementor should be able to figure it out, but other potential module users
may not. For example, if somebody is evaluating whether to use a module for
their device or not, it is important to know that NACM has to be implemented (or
not).

 

You seem to be talking about a new conformance documentation procedure

that attempts to solve the problem "to use modules A, B, and C together

to achieve some functionality X, all these conditions need to be met".

(Sounds more like a problem for YANG Packages to solve)

 

IMO this is a much harder problem than something that can be solved

with extra description-stmt text. The writer is likely to get it wrong or not

keep it up to date, so a tool to analyze the file seems like a better solution.

 

Lada

 

 

Andy

 


> Or someone writes a pyang plugin to determine from the schema tree the
> kind of imports there are (for a given set of features).
> 
> /js
> 
-- 
Ladislav Lhotka
Head, CZ.NIC Labs
PGP Key ID: 0xB8F92B08A9F76C67

_______________________________________________
netmod mailing list
netmod@ietf.org <mailto:netmod@ietf.org> 
https://www.ietf.org/mailman/listinfo/netmod