[YANG] module version field

Andy Bierman <ietf@andybierman.com> Fri, 08 February 2008 23:09 UTC

Return-Path: <yang-bounces@ietf.org>
X-Original-To: ietfarch-yang-archive@core3.amsl.com
Delivered-To: ietfarch-yang-archive@core3.amsl.com
Received: from localhost (localhost [127.0.0.1]) by core3.amsl.com (Postfix) with ESMTP id 4BF0328C6E9; Fri, 8 Feb 2008 15:09:58 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.265
X-Spam-Level:
X-Spam-Status: No, score=-2.265 tagged_above=-999 required=5 tests=[BAYES_00=-2.599, IP_NOT_FRIENDLY=0.334]
Received: from core3.amsl.com ([127.0.0.1]) by localhost (mail.ietf.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id s8vppUzjWFEN; Fri, 8 Feb 2008 15:09:57 -0800 (PST)
Received: from core3.amsl.com (localhost [127.0.0.1]) by core3.amsl.com (Postfix) with ESMTP id 3469E28C714; Fri, 8 Feb 2008 15:09:55 -0800 (PST)
X-Original-To: yang@core3.amsl.com
Delivered-To: yang@core3.amsl.com
Received: from localhost (localhost [127.0.0.1]) by core3.amsl.com (Postfix) with ESMTP id A6B1328C70E for <yang@core3.amsl.com>; Fri, 8 Feb 2008 15:09:54 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
Received: from core3.amsl.com ([127.0.0.1]) by localhost (mail.ietf.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id r37x0O6Iuekl for <yang@core3.amsl.com>; Fri, 8 Feb 2008 15:09:54 -0800 (PST)
Received: from smtp120.sbc.mail.sp1.yahoo.com (smtp120.sbc.mail.sp1.yahoo.com [69.147.64.93]) by core3.amsl.com (Postfix) with SMTP id A172428C746 for <yang@ietf.org>; Fri, 8 Feb 2008 15:09:31 -0800 (PST)
Received: (qmail 70910 invoked from network); 8 Feb 2008 23:11:00 -0000
Received: from unknown (HELO ?192.168.0.10?) (andybierman@att.net@67.121.105.87 with plain) by smtp120.sbc.mail.sp1.yahoo.com with SMTP; 8 Feb 2008 23:11:00 -0000
X-YMail-OSG: PLFKf5UVM1nNdvHq_ReHfXFsYnS6ECvr8Rj6_0Q8apAMfshm
X-Yahoo-Newman-Property: ymail-3
Message-ID: <47ACE183.5070708@andybierman.com>
Date: Fri, 08 Feb 2008 15:10:59 -0800
From: Andy Bierman <ietf@andybierman.com>
User-Agent: Thunderbird 2.0.0.9 (Windows/20071031)
MIME-Version: 1.0
To: yang <yang@ietf.org>
Subject: [YANG] module version field
X-BeenThere: yang@ietf.org
X-Mailman-Version: 2.1.9
Precedence: list
List-Id: YANG modeling Language for NETCONF <yang.ietf.org>
List-Unsubscribe: <http://www.ietf.org/mailman/listinfo/yang>, <mailto:yang-request@ietf.org?subject=unsubscribe>
List-Archive: <http://www.ietf.org/pipermail/yang>
List-Post: <mailto:yang@ietf.org>
List-Help: <mailto:yang-request@ietf.org?subject=help>
List-Subscribe: <http://www.ietf.org/mailman/listinfo/yang>, <mailto:yang-request@ietf.org?subject=subscribe>
Content-Type: text/plain; charset="us-ascii"
Content-Transfer-Encoding: 7bit
Sender: yang-bounces@ietf.org
Errors-To: yang-bounces@ietf.org

Hi,

The [sub]module version field is kind of important, and there is none in YANG.
SMIv2 has LAST-UPDATED. I like 'version'.  It is CLI and XSD friendly.

IMO, the version string should not be coupled to the LAST-UPDATED timestamp.
What if the vendor has a totally different numbering scheme?

An explicit version field could be a CLR -- just something to match up
to some other string somewhere else, or it could be extra semantics.
The current syntax only allows 1 version per day, which is not good enough
in every development environment.

I think we should consider adding an optional version field to meta-stmts.
If missing, then the most recent revision date is used,
and if no revision statements are present, then the vendor
can use whatever they want (including no version).

Whatever we use, there needs to be exactly one inter-operable field
that can be used in schema discovery, that matches a version
field in YANG/XSD/RNG files.  The namespace URI should not be used for
this purpose.  For protocol features, like the capability URIs,
a version field in the URI is OK because it doesn't change very often,
and NETCONF supports extensions.  YANG module versions should be separate
from the module namespace URI.

Once we work on change control rules, the important CLRs
will get defined ;-)

Andy


_______________________________________________
YANG mailing list
YANG@ietf.org
http://www.ietf.org/mailman/listinfo/yang