[netmod] missing sections
Phil Shafer <phil@juniper.net> Wed, 10 March 2010 20:04 UTC
Return-Path: <phil@juniper.net>
X-Original-To: netmod@core3.amsl.com
Delivered-To: netmod@core3.amsl.com
Received: from localhost (localhost [127.0.0.1]) by core3.amsl.com (Postfix) with ESMTP id 261D03A6915 for <netmod@core3.amsl.com>; Wed, 10 Mar 2010 12:04:09 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -6.599
X-Spam-Level:
X-Spam-Status: No, score=-6.599 tagged_above=-999 required=5 tests=[BAYES_00=-2.599, RCVD_IN_DNSWL_MED=-4]
Received: from mail.ietf.org ([64.170.98.32]) by localhost (core3.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id jIU+T8543k-H for <netmod@core3.amsl.com>; Wed, 10 Mar 2010 12:04:08 -0800 (PST)
Received: from exprod7og125.obsmtp.com (exprod7og125.obsmtp.com [64.18.2.28]) by core3.amsl.com (Postfix) with ESMTP id 1D24D3A68E7 for <netmod@ietf.org>; Wed, 10 Mar 2010 12:04:08 -0800 (PST)
Received: from source ([66.129.224.36]) (using TLSv1) by exprod7ob125.postini.com ([64.18.6.12]) with SMTP ID DSNKS5f7PPhDQPs/mKk2a/ilCbhwXYkcc6Wj@postini.com; Wed, 10 Mar 2010 12:04:13 PST
Received: from p-emfe01-sac.jnpr.net (66.129.254.72) by P-EMHUB01-HQ.jnpr.net (172.24.192.35) with Microsoft SMTP Server id 8.1.393.1; Wed, 10 Mar 2010 12:01:44 -0800
Received: from p-emlb01-sac.jnpr.net ([66.129.254.46]) by p-emfe01-sac.jnpr.net with Microsoft SMTPSVC(6.0.3790.3959); Wed, 10 Mar 2010 12:01:43 -0800
Received: from emailsmtp56.jnpr.net ([172.24.60.77]) by p-emlb01-sac.jnpr.net with Microsoft SMTPSVC(6.0.3790.3959); Wed, 10 Mar 2010 12:01:43 -0800
Received: from magenta.juniper.net ([172.17.27.123]) by emailsmtp56.jnpr.net with Microsoft SMTPSVC(6.0.3790.3959); Wed, 10 Mar 2010 12:01:43 -0800
Received: from idle.juniper.net (idleski.juniper.net [172.25.4.26]) by magenta.juniper.net (8.11.3/8.11.3) with ESMTP id o2AK1gD80248 for <netmod@ietf.org>; Wed, 10 Mar 2010 12:01:42 -0800 (PST) (envelope-from phil@juniper.net)
Received: from idle.juniper.net (localhost [127.0.0.1]) by idle.juniper.net (8.14.3/8.14.3) with ESMTP id o2AJjUmb074378 for <netmod@ietf.org>; Wed, 10 Mar 2010 19:45:30 GMT (envelope-from phil@idle.juniper.net)
Message-ID: <201003101945.o2AJjUmb074378@idle.juniper.net>
To: netmod@ietf.org
Date: Wed, 10 Mar 2010 14:45:30 -0500
From: Phil Shafer <phil@juniper.net>
X-OriginalArrivalTime: 10 Mar 2010 20:01:43.0575 (UTC) FILETIME=[81996A70:01CAC08C]
MIME-Version: 1.0
Content-Type: text/plain
Subject: [netmod] missing sections
X-BeenThere: netmod@ietf.org
X-Mailman-Version: 2.1.9
Precedence: list
List-Id: NETMOD WG list <netmod.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/listinfo/netmod>, <mailto:netmod-request@ietf.org?subject=unsubscribe>
List-Archive: <http://www.ietf.org/mail-archive/web/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: Wed, 10 Mar 2010 20:04:09 -0000
There were two sections in the last arch draft that were missing. See the attached delta for the new text. Unfortunately I cannot post a new draft. Thanks, Phil ------ ** Modeler -(No clue what needs said here; lots to say, but what's important?) +The modeler's role constructing a model based on their in-depth +knowledge of the problem domain being modeled. This model should +be as simple as possible, but should balance complexity with +expressiveness. The organization of the model should target not only +the current model, but should allow for extensibility from other +modules and for adaptability to future changes. Additional modeling issues are discussed in ^modeling^. @@ -680,8 +684,50 @@ ** Default Values -(With all the discussion on this point, it needs to be mentioned here.) +The concept of default values is simple, but their details, +representation, and interaction with configuration data can be +difficult issues. NETCONF leaves default values as a data model +issue, and YANG gives flexibility to the device implementation in +terms of how default values are handled. The requirement is that the +device "MUST operationally behave as is if the leaf was present in the +data tree with the default value as its value". This gives the device +implementation choices in how default values are handled. +One choice is to view the configuration as a set of instructions for +how the device should be configured. If a data value is given as part +of those instructions is the default value, then it should be retained +as part of the configuration, but if it not explicitly given, then the +value is not considered to be part of configuration. + +Another choice is to trim values that are identical to the default +values, implicitly removing them from the configuration database. +The act of setting a leaf to it's default value effectively deletes +that leaf. + +The device could also choose to report all default values, regardless +of whether they were explicitly set. This choice eases the work of +a client that needs default values, but may significantly increase the +size of the configuration data. + +These choices reflect the default handling schemes of widely deployed +networking devices and supporting them allows YANG to reduce +implementation and deployment costs of YANG-based models. + +When the client retrieves data from the device, it must be prepared to +handle the absence of leaf nodes with the default value, since the +server is not required to send such leaf elements. This permits the +device to implement either of the first two default handling schemes +given above. + +Regardless of the implementation choice, the device can support the +"with-defaults" capability (^RFCWITHDEFAULTS^) and give the client the +ability to select the desired handling of default values. + +When evaluating the XPath expressions for constraints like "must" and +"when", the evaluation context for the expressions will include any +appropriate default values, so the modeler can depend on consistent +behavior from all devices. +
- [netmod] missing sections Phil Shafer