Re: [Netconf] restconf and namespaces and unique module names.

Xiang Li <xiangli@seguesoft.com> Wed, 23 September 2015 16:08 UTC

Return-Path: <xiangli@seguesoft.com>
X-Original-To: netconf@ietfa.amsl.com
Delivered-To: netconf@ietfa.amsl.com
Received: from localhost (ietfa.amsl.com [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id EDDBF1A87AD for <netconf@ietfa.amsl.com>; Wed, 23 Sep 2015 09:08:27 -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, RCVD_IN_DNSWL_NONE=-0.0001] autolearn=ham
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 bhw2ILMB7lrd for <netconf@ietfa.amsl.com>; Wed, 23 Sep 2015 09:08:26 -0700 (PDT)
Received: from p3plsmtpa09-06.prod.phx3.secureserver.net (p3plsmtpa09-06.prod.phx3.secureserver.net [173.201.193.235]) (using TLSv1.2 with cipher DHE-RSA-AES128-SHA (128/128 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 830201A874E for <netconf@ietf.org>; Wed, 23 Sep 2015 09:08:25 -0700 (PDT)
Received: from [192.168.10.101] ([73.211.21.12]) by p3plsmtpa09-06.prod.phx3.secureserver.net with id Lg8P1r00L0FehNH01g8QbJ; Wed, 23 Sep 2015 09:08:24 -0700
To: netconf@ietf.org
References: <D226D2D0.DFA24%kwatsen@juniper.net> <20150922142615.GC99134@elstar.local> <D226E43C.DFAAA%kwatsen@juniper.net> <20150922190308.GB99737@elstar.local>
From: Xiang Li <xiangli@seguesoft.com>
Message-ID: <5602CE77.8040208@seguesoft.com>
Date: Wed, 23 Sep 2015 11:08:23 -0500
User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:38.0) Gecko/20100101 Thunderbird/38.2.0
MIME-Version: 1.0
In-Reply-To: <20150922190308.GB99737@elstar.local>
Content-Type: text/plain; charset="windows-1252"; format="flowed"
Content-Transfer-Encoding: 7bit
Archived-At: <http://mailarchive.ietf.org/arch/msg/netconf/rXos7W4k3dVo9jmK4V2Pgnatsl0>
Subject: Re: [Netconf] restconf and namespaces and unique module names.
X-BeenThere: netconf@ietf.org
X-Mailman-Version: 2.1.15
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: Wed, 23 Sep 2015 16:08:28 -0000

Hi
On 9/22/2015 2:03 PM, Juergen Schoenwaelder wrote:
> On Tue, Sep 22, 2015 at 05:25:04PM +0000, Kent Watsen wrote:
>>> RFC 6020:
>>>
>>>    The names of all standard modules and submodules MUST be unique.
>>>    Developers of enterprise modules are RECOMMENDED to choose names for
>>>    their modules that will have a low probability of colliding with
>>>    standard or other enterprise modules, e.g., by using the enterprise
>>>    or organization name as a prefix for the module name.
>>>
>>> Apparently, both module names in the example violate this. Note that
>>> module names are used to resolve imports and hence they better are
>>> unique. For the IETF, we can manage that via the IANA registry. For
>>> the other modules, there is a clear recommendation.
>>
>> OK, that's fair, but it doesn't seem to be a followed often outside of the
>> IETF.
>>
>> For instance,
>>
>>    - ETSI NFV-MANO has module names like "nsd", "vnfd" and "vld"
>>    - Open Config has module names beginning with "bgp-" and "mpls-"
>>    - IEEE has module names like "ethernet"
>>    - ODL has some module names like "config" and "flow-errors"
> Because people often do not read specifications and if tools do not
> complain they assume everything is fine. The YANG spec has clear
> words, there is text in the guidelines. We can write more text and it
> will likely not help. Perhaps tutorials need to stress these points.

I agree for standard modules it "MUST" have unique names since it is 
enforceable.

To ensure maximum interoperability, a private module designer better 
follow the
recommendation and carefully choose a name that is unlikely conflicting 
with
others.  We see many private MIBs use a name with company name prefixed, and
for some MIB designers, I believe that is a learned lesson.


--Xiang Li