[netmod] Modeling unknown bits in YANG (draft-haas-netmod-unknown-bits-00)

Jeffrey Haas <jhaas@pfrc.org> Thu, 26 January 2023 20:52 UTC

Return-Path: <jhaas@slice.pfrc.org>
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 C0AE9C14CE40 for <netmod@ietfa.amsl.com>; Thu, 26 Jan 2023 12:52:02 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.896
X-Spam-Level:
X-Spam-Status: No, score=-1.896 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, RCVD_IN_DNSWL_BLOCKED=0.001, RCVD_IN_ZEN_BLOCKED_OPENDNS=0.001, SPF_PASS=-0.001, URIBL_BLOCKED=0.001, URIBL_DBL_BLOCKED_OPENDNS=0.001, URIBL_ZEN_BLOCKED_OPENDNS=0.001] autolearn=ham autolearn_force=no
Received: from mail.ietf.org ([50.223.129.194]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id KEPUZWMOaU1s for <netmod@ietfa.amsl.com>; Thu, 26 Jan 2023 12:51:59 -0800 (PST)
Received: from slice.pfrc.org (slice.pfrc.org [67.207.130.108]) by ietfa.amsl.com (Postfix) with ESMTP id E5AFDC14CF17 for <netmod@ietf.org>; Thu, 26 Jan 2023 12:51:58 -0800 (PST)
Received: by slice.pfrc.org (Postfix, from userid 1001) id 9D4BC1E2D3; Thu, 26 Jan 2023 15:51:57 -0500 (EST)
Date: Thu, 26 Jan 2023 15:51:57 -0500
From: Jeffrey Haas <jhaas@pfrc.org>
To: netmod@ietf.org
Message-ID: <20230126205157.GC27893@pfrc.org>
MIME-Version: 1.0
Content-Type: text/plain; charset="us-ascii"
Content-Disposition: inline
User-Agent: Mutt/1.5.21 (2010-09-15)
Archived-At: <https://mailarchive.ietf.org/arch/msg/netmod/BIHk975Iz3NDSikOyAD0WqX7vuY>
Subject: [netmod] Modeling unknown bits in YANG (draft-haas-netmod-unknown-bits-00)
X-BeenThere: netmod@ietf.org
X-Mailman-Version: 2.1.39
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, 26 Jan 2023 20:52:02 -0000

The following draft is hopefully a simple proposal.  It models operational
state for protocols with bit vectors using the 'bits' type in YANG when a
given bit position hasn't been assigned yet.

This proposal comes out of a brief inquiry to the YANG doctors while trying
to solve the problem mentioned in the draft for the BGP YANG model.

Your feedback is appreciated and, if the proposal is acceptable, I'd suggest
adoption by the Working Group.

Please note that the draft is on github.  I'm happy to take feedback as
issues or pull requests there:

https://github.com/jhaas-pfrc/draft-haas-netmod-unknown-bits

-- Jeff

----- Forwarded message from internet-drafts@ietf.org -----

Date: Thu, 26 Jan 2023 12:43:24 -0800
From: internet-drafts@ietf.org
To: Jeffrey Haas <jhaas@pfrc.org>
Subject: New Version Notification for draft-haas-netmod-unknown-bits-00.txt


A new version of I-D, draft-haas-netmod-unknown-bits-00.txt
has been successfully submitted by Jeffrey Haas and posted to the
IETF repository.

Name:		draft-haas-netmod-unknown-bits
Revision:	00
Title:		Representing Unknown YANG bits in Operational State
Document date:	2023-01-26
Group:		Individual Submission
Pages:		18
URL:            https://www.ietf.org/archive/id/draft-haas-netmod-unknown-bits-00.txt
Status:         https://datatracker.ietf.org/doc/draft-haas-netmod-unknown-bits/
Html:           https://www.ietf.org/archive/id/draft-haas-netmod-unknown-bits-00.html
Htmlized:       https://datatracker.ietf.org/doc/html/draft-haas-netmod-unknown-bits


Abstract:
   Protocols frequently have fields where the contents are a series of
   bits that have specific meaning.  When modeling operational state for
   such protocols in YANG, the 'bits' YANG built-in type is a natural
   method for modeling such fields.  The YANG 'bits' built-in type is
   best suited when the meaning of a bit assignment is clear.

   When bits that are currently RESERVED or otherwise unassigned by the
   protocol are received, being able to display them is necessary in
   YANG operational models.  This cannot be done using the YANG 'bits'
   built-in type without assigning them a name.  However, YANG
   versioning rules do not permit renaming of named bits.

   This draft proposes a methodology to represent unknown bits in YANG
   operational models and creates a YANG typedef to assist in uniformly
   naming such unknown bits.

                                                                                  


The IETF Secretariat


----- End forwarded message -----