Re: [netmod] Does the YANG "status" statement inherit from its parent node?

Martin Bjorklund <mbj@tail-f.com> Tue, 20 December 2016 20:03 UTC

Return-Path: <mbj@tail-f.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 3185D1295DE for <netmod@ietfa.amsl.com>; Tue, 20 Dec 2016 12:03:39 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -5.001
X-Spam-Level:
X-Spam-Status: No, score=-5.001 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, RP_MATCHES_RCVD=-3.1, SPF_PASS=-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 uT5xayrg5biz for <netmod@ietfa.amsl.com>; Tue, 20 Dec 2016 12:03:37 -0800 (PST)
Received: from mail.tail-f.com (mail.tail-f.com [46.21.102.45]) by ietfa.amsl.com (Postfix) with ESMTP id 438C11295BE for <netmod@ietf.org>; Tue, 20 Dec 2016 12:03:37 -0800 (PST)
Received: from localhost (h-13-76.a165.priv.bahnhof.se [155.4.13.76]) by mail.tail-f.com (Postfix) with ESMTPSA id 507C81AE02BC; Tue, 20 Dec 2016 21:03:35 +0100 (CET)
Date: Tue, 20 Dec 2016 21:03:35 +0100
Message-Id: <20161220.210335.1870203216124697421.mbj@tail-f.com>
To: rwilton@cisco.com
From: Martin Bjorklund <mbj@tail-f.com>
In-Reply-To: <1db67b1d-36ef-5cc6-425f-7e22de7e80ae@cisco.com>
References: <1db67b1d-36ef-5cc6-425f-7e22de7e80ae@cisco.com>
X-Mailer: Mew version 6.5 on Emacs 24.3 / Mule 6.0 (HANACHIRUSATO)
Mime-Version: 1.0
Content-Type: Text/Plain; charset="us-ascii"
Content-Transfer-Encoding: 7bit
Archived-At: <https://mailarchive.ietf.org/arch/msg/netmod/WS7xeJHojAuQRjazDbqRbqqWe48>
Cc: netmod@ietf.org
Subject: Re: [netmod] Does the YANG "status" statement inherit from its parent node?
X-BeenThere: netmod@ietf.org
X-Mailman-Version: 2.1.17
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: Tue, 20 Dec 2016 20:03:39 -0000

Robert Wilton <rwilton@cisco.com> wrote:
> Hi,
> 
> The definition of "status" in RFC 7950 in section 7.21.2 (full text
> below), states:
> 
> If no status is specified, the default is "current".
> 
> From my interpretation of the text in the draft, this implies that the
> status of the "new" child leaf in the following example is "current",
> and that this example is allowed!
> 
> My questions are:
>  - Is my interpretation of the current text correct?

Yes.

>  - Is this actually the best behaviour, or should it inherit like the
>    config statement?

I think the idea was that if the status != current, it is better for
the reader if it is explicitly stated.

>  Should I raise an errata for this?

No.

However, we could have said that a current node under a deprecated
node (etc) in the same module is an error, in order to force people
(through the useage of YANG validators) to detect and fix this.


/martin



> 
> container old {
>   status deprecated;
>   leaf new {
>     description "what status do I have?";
>   }
> }
> 
> Thanks,
> Rob
> 
> 
> Full 7.21.2 text from 7950:
> 
> 7.21.2.  The "status" Statement
> 
>    The "status" statement takes as an argument one of the strings
>    "current", "deprecated", or "obsolete".
> 
>    o  "current" means that the definition is current and valid.
> 
>    o  "deprecated" indicates an obsolete definition, but it permits
>       new/continued implementation in order to foster interoperability
>       with older/existing implementations.
> 
>    o  "obsolete" means that the definition is obsolete and SHOULD NOT be
>       implemented and/or can be removed from implementations.
> 
>    If no status is specified, the default is "current".
> 
>    If a definition is "current", it MUST NOT reference a "deprecated" or
>    "obsolete" definition within the same module.
> 
>    If a definition is "deprecated", it MUST NOT reference an "obsolete"
>    definition within the same module.
> 
>    For example, the following is illegal:
> 
>      typedef my-type {
>        status deprecated;
>        type int32;
>      }
> 
>      leaf my-leaf {
>        status current;
>        type my-type; // illegal, since my-type is deprecated
>      }
>