Re: [Netconf] Request for new groupings in ietf-yang-library
Martin Bjorklund <mbj@tail-f.com> Tue, 22 August 2017 07:57 UTC
Return-Path: <mbj@tail-f.com>
X-Original-To: netconf@ietfa.amsl.com
Delivered-To: netconf@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 23C5A126B71 for <netconf@ietfa.amsl.com>; Tue, 22 Aug 2017 00:57:22 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.9
X-Spam-Level:
X-Spam-Status: No, score=-1.9 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, SPF_PASS=-0.001, URIBL_BLOCKED=0.001] autolearn=ham autolearn_force=no
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 85flAi52eTue for <netconf@ietfa.amsl.com>; Tue, 22 Aug 2017 00:57:20 -0700 (PDT)
Received: from mail.tail-f.com (mail.tail-f.com [46.21.102.45]) by ietfa.amsl.com (Postfix) with ESMTP id 14FC2132925 for <netconf@ietf.org>; Tue, 22 Aug 2017 00:57:20 -0700 (PDT)
Received: from localhost (unknown [173.38.220.57]) by mail.tail-f.com (Postfix) with ESMTPSA id DB4BC1AE02C9; Tue, 22 Aug 2017 09:57:18 +0200 (CEST)
Date: Tue, 22 Aug 2017 09:55:49 +0200
Message-Id: <20170822.095549.31250933146131636.mbj@tail-f.com>
To: jclarke@cisco.com
Cc: netconf@ietf.org
From: Martin Bjorklund <mbj@tail-f.com>
In-Reply-To: <DD5AB369-5FBE-488C-84B3-A3DF64CA22FC@cisco.com>
References: <DD5AB369-5FBE-488C-84B3-A3DF64CA22FC@cisco.com>
X-Mailer: Mew version 6.7 on Emacs 24.5 / Mule 6.0 (HANACHIRUSATO)
Mime-Version: 1.0
Content-Type: Text/Plain; charset="utf-8"
Content-Transfer-Encoding: base64
Archived-At: <https://mailarchive.ietf.org/arch/msg/netconf/qFR7Sm_VWuqAT7mdg0R6NStKvxA>
Subject: Re: [Netconf] Request for new groupings in ietf-yang-library
X-BeenThere: netconf@ietf.org
X-Mailman-Version: 2.1.22
Precedence: list
List-Id: Network Configuration WG mailing list <netconf.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/netconf>, <mailto:netconf-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/netconf/>
List-Post: <mailto:netconf@ietf.org>
List-Help: <mailto:netconf-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/netconf>, <mailto:netconf-request@ietf.org?subject=subscribe>
X-List-Received-Date: Tue, 22 Aug 2017 07:57:22 -0000
Hi, "Joe Clarke" <jclarke@cisco.com> wrote: > Hello, netconf. Kent informed me that there is some bis work going on > relative to the ietf-yang-library. As part of the work with the > yang-catalog model, the YANG Catalog team found that while we’d like > to use the groupings in the ietf-yang-library, not all of the leafs > are conducive to the case where we don’t have a server (e.g., > conformance-type). > > To that end, we would like it if the groupings in ietf-yang-library > could be broken out in terms of model leafs and implementation leafs. > Below is a proposed scheme to create new top-level groupings > separating model data from implementation data. Thoughts? I think this makes sense. I suggest we follow your proposal, but change the name "common-leafs" to "module-identification-leafs". /martin > > Joe > > grouping common-leafs { > leaf name { > type yang:yang-identifier; > description > "The YANG module or submodule name."; > } > leaf revision { > type union { > type revision-identifier; > type string { length 0; } > } > description > "The YANG module or submodule revision date. > A zero-length string is used if no revision statement > is present in the YANG module or submodule."; > } > description > "The YANG module or submodule revision date. > A zero-length string is used if no revision statement > is present in the YANG module or submodule."; > } > > grouping schema-leaf { > leaf schema { > type inet:uri; > description > "Contains a URL that represents the YANG schema > resource for this module or submodule. > This leaf will only be present if there is a URL > available for retrieval of the schema for this entry."; > } > description > "These are a subset of leafs from the yang-library (RFC 7895) that > provide some > extractable fields for catalog modules. The module-list grouping > cannot be > used from yang-library as modules themselves cannot have conformance > without > a server."; > } > > grouping imlementation-leafs { > leaf-list feature { > type yang:yang-identifier; > description > "List of YANG feature names from this module that are > supported by the server, regardless of whether they are > defined in the module or any included submodule."; > } > list deviation { > key "name revision"; > description > "List of YANG deviation module names and revisions > used by this server to modify the conformance of > the module associated with this entry. Note that > the same module can be used for deviations for > multiple modules, so the same entry MAY appear > within multiple 'module' entries. > The deviation module MUST be present in the 'module' > list, with the same name and revision values. > The 'conformance-type' value will be 'implement' for > the deviation module."; > uses common-leafs; > } > leaf conformance-type { > type enumeration { > enum implement { > description > "Indicates that the server implements one or more > protocol-accessible objects defined in the YANG module > identified in this entry. This includes deviation > statements defined in the module. > For YANG version 1.1 modules, there is at most one > module entry with conformance type 'implement' for a > particular module name, since YANG 1.1 requires that, > at most, one revision of a module is implemented. > For YANG version 1 modules, there SHOULD NOT be more > than one module entry for a particular module name."; > } > enum import { > description > "Indicates that the server imports reusable definitions > from the specified revision of the module but does > not implement any protocol-accessible objects from > this revision. > Multiple module entries for the same module name MAY > exist. This can occur if multiple modules import the > same module but specify different revision dates in > the import statements."; > } > } > mandatory true; > description > "Indicates the type of conformance the server is claiming > for the YANG module identified by this entry."; > } > description > "This is a set of leafs extracted from the yang-library that are > specific to server implementations."; > } > > _______________________________________________ > Netconf mailing list > Netconf@ietf.org > https://www.ietf.org/mailman/listinfo/netconf
- [Netconf] Request for new groupings in ietf-yang-… Joe Clarke
- Re: [Netconf] Request for new groupings in ietf-y… Martin Bjorklund