IETF Logo Mail Archive

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

Andy Bierman <andy@yumaworks.com> Thu, 19 December 2019 16:23 UTC

Return-Path: <andy@yumaworks.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 CEC8D1201EA for <netmod@ietfa.amsl.com>; Thu, 19 Dec 2019 08:23:34 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.898
X-Spam-Level:
X-Spam-Status: No, score=-1.898 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_HELO_NONE=0.001, SPF_PASS=-0.001, URIBL_BLOCKED=0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (2048-bit key) header.d=yumaworks-com.20150623.gappssmtp.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 rwfVQxLmjCQp for <netmod@ietfa.amsl.com>; Thu, 19 Dec 2019 08:23:33 -0800 (PST)
Received: from mail-lf1-x12e.google.com (mail-lf1-x12e.google.com [IPv6:2a00:1450:4864:20::12e]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id CFE60120AE9 for <netmod@ietf.org>; Thu, 19 Dec 2019 08:22:57 -0800 (PST)
Received: by mail-lf1-x12e.google.com with SMTP id v201so4746701lfa.11 for <netmod@ietf.org>; Thu, 19 Dec 2019 08:22:57 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yumaworks-com.20150623.gappssmtp.com; s=20150623; h=mime-version:references:in-reply-to:from:date:message-id:subject:to :cc; bh=rJkCi9bEz7NnlmgG/wrxBzMSS8q41GzpIr3qkx2RWrU=; b=Y1TsElMLpKGr+ZqdRCVtNRzC64bM21TdCo1/hD0TMeinwsfFYNmObNIkxMotkHc0gW ZxrmoQ1ER/UdSP1tmuZQYmgvtWshJIuhBDjJPXnMFvVllMnG3knDJ4k0tZlX6E7/+Dyr 6aqLqlG3N4WqOxQls5qZwJ+cYncRH5P8wb+BmKL5nYW8+dDIlNh0jd6j6UgQgGWDVzK8 FRPbdOZWAu2PW+q6MgqkDPJGNSAJC62N4d6XulDbPkmNqBDgtuLuKnDOrgwzQV2Bnv3M aokJGPfWjsvVoJ6YhT54Mjcp9r0LHc5ZkVvjB7rh47iciTMRkUI8v676lR0WaWrIMp7a JIug==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=rJkCi9bEz7NnlmgG/wrxBzMSS8q41GzpIr3qkx2RWrU=; b=FWWf1YW1dzLdHuXK2oiP2/gJAn1LUPdqi0OapAL07ecvbtlA7G4crrZ9jMFgvOhHH9 yYiLKB6RVnL7RISYmE0i4o1L/kVznl+EVDw/w0vnfqkro1IWqyOl1LKA1kg09n85mZMm 8lS/p2VA7kBdpZLpeIWQ0pBjkqwR9H+y96GI14w8pkK97hrfe9+0WSR4jqI3lq/wa6FL bnpgX5KERFL4k+Vn/hzoeFBssZjRT9ZW9JIVZP2NsdSYwSApe9WOFb8FVKsd9OeFKBTb 1MlEEeWxnxjNyWm1P92R650w3bBxD4bBMJspeVn4sX5A8YWL6EzYuwhmBp9+ShCPZhMf qMwg==
X-Gm-Message-State: APjAAAUO4Ji9pcppJoUmpoWURyvBlT10sAq++V0nHF6VsWkZ8pK4eyQE aBpjiDgOcSNLJOw24fGorsY/D7VDhvkZOOE5K/SL8w==
X-Google-Smtp-Source: APXvYqxceReaoxfZWTNe90Xt7xsMatvM0wERPd1esFNj4WONsct5YJkUnpllaLxbqs6W0GkUZ8qkbFTvQqZDXb2N5zM=
X-Received: by 2002:a05:6512:15d:: with SMTP id m29mr6068605lfo.51.1576772575966; Thu, 19 Dec 2019 08:22:55 -0800 (PST)
MIME-Version: 1.0
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>
In-Reply-To: <d3520549f06107de8939af24268f56f56683fbb0.camel@nic.cz>
From: Andy Bierman <andy@yumaworks.com>
Date: Thu, 19 Dec 2019 08:22:44 -0800
Message-ID: <CABCOCHRFQrXgGKB10B9MXbKa2vMfaY3eWaj5Sp4W0DPQ0F-pGQ@mail.gmail.com>
To: Ladislav Lhotka <lhotka@nic.cz>
Cc: NetMod WG <netmod@ietf.org>
Content-Type: multipart/alternative; boundary="000000000000484cb8059a10f94b"
Archived-At: <https://mailarchive.ietf.org/arch/msg/netmod/dlw7ZyE_296MNXWxLg8qXvHaF5U>
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: Thu, 19 Dec 2019 16:23:35 -0000

On Thu, Dec 19, 2019 at 8:00 AM Ladislav Lhotka <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
> https://www.ietf.org/mailman/listinfo/netmod
>

v2.23.0 | Report a Bug | By Email