Re: [YANG] import statement

Juergen Schoenwaelder <j.schoenwaelder@jacobs-university.de> Sat, 03 May 2008 14:32 UTC

Return-Path: <yang-bounces@ietf.org>
X-Original-To: yang-archive@optimus.ietf.org
Delivered-To: ietfarch-yang-archive@core3.amsl.com
Received: from core3.amsl.com (localhost [127.0.0.1]) by core3.amsl.com (Postfix) with ESMTP id AF7D028C19B; Sat, 3 May 2008 07:32:13 -0700 (PDT)
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 BA99228C180 for <yang@core3.amsl.com>; Sat, 3 May 2008 07:32:12 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.016
X-Spam-Level:
X-Spam-Status: No, score=-2.016 tagged_above=-999 required=5 tests=[AWL=0.233, BAYES_00=-2.599, HELO_EQ_DE=0.35]
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 UTCSXf2TgHdk for <yang@core3.amsl.com>; Sat, 3 May 2008 07:32:11 -0700 (PDT)
Received: from hermes.jacobs-university.de (hermes.jacobs-university.de [212.201.44.23]) by core3.amsl.com (Postfix) with ESMTP id 00F0328C1D0 for <yang@ietf.org>; Sat, 3 May 2008 07:32:10 -0700 (PDT)
Received: from localhost (demetrius2.jacobs-university.de [212.201.44.47]) by hermes.jacobs-university.de (Postfix) with ESMTP id AC774C0012; Sat, 3 May 2008 16:32:19 +0200 (CEST)
X-Virus-Scanned: amavisd-new at jacobs-university.de
Received: from hermes.jacobs-university.de ([212.201.44.23]) by localhost (demetrius2.jacobs-university.de [212.201.44.32]) (amavisd-new, port 10024) with ESMTP id csOif2iFxJAd; Sat, 3 May 2008 16:32:06 +0200 (CEST)
Received: from elstar.local (elstar.iuhb02.iu-bremen.de [10.50.231.133]) by hermes.jacobs-university.de (Postfix) with ESMTP id 10385C000E; Sat, 3 May 2008 16:32:14 +0200 (CEST)
Received: by elstar.local (Postfix, from userid 501) id 61A0A56E0F3; Sat, 3 May 2008 16:32:05 +0200 (CEST)
Date: Sat, 03 May 2008 16:32:05 +0200
From: Juergen Schoenwaelder <j.schoenwaelder@jacobs-university.de>
To: Ladislav Lhotka <lhotka@cesnet.cz>
Message-ID: <20080503143205.GA24972@elstar.local>
Mail-Followup-To: Ladislav Lhotka <lhotka@cesnet.cz>, yang@ietf.org
References: <1209812833.14759.12.camel@missotis> <20080503120217.GA24899@elstar.local> <1209823237.14759.24.camel@missotis>
MIME-Version: 1.0
Content-Disposition: inline
In-Reply-To: <1209823237.14759.24.camel@missotis>
User-Agent: Mutt/1.5.17 (2007-11-01)
Cc: yang@ietf.org
Subject: Re: [YANG] import statement
X-BeenThere: yang@ietf.org
X-Mailman-Version: 2.1.9
Precedence: list
Reply-To: j.schoenwaelder@jacobs-university.de
List-Id: YANG modeling Language for NETCONF <yang.ietf.org>
List-Unsubscribe: <https://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: <https://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

On Sat, May 03, 2008 at 04:00:37PM +0200, Ladislav Lhotka wrote:

> Then the one and only way for utilizing the imported name "foo-cont" in
> module bar is in 
> 
>   augment /foo:foo-cont {
>     ...
>   }
> 
> which results in placing (possibly augmented) copy of the "foo-cont"
> container at the location of the augment statement. Or am I missing
> something?

You are missing something. ;-) Here is what the YANG ID says (section
7.15):

   The "augment" statement allows a module or submodule to add to the
   schema tree defined in another module or submodule.

And section 3:

   o  augment: Adds new nodes to a previously defined node.

And section 4.2.8:

   YANG allows a module to insert additional nodes into data models,
   including both the current module (and its submodules) or an external
   module.  This is useful e.g. for vendors to add vendor-specific
   parameters to standard data models in an interoperable way.

   The "augment" statement defines the location in the data model
   hierarchy where new nodes are inserted, and the "when" statement
   defines the conditions when the new nodes are valid.

There are also examples. An augment of foo-cont simply sticks nodes
into the foo-cont container; there is no new instantiation of
foo-cont.

/js

-- 
Juergen Schoenwaelder           Jacobs University Bremen gGmbH
Phone: +49 421 200 3587         Campus Ring 1, 28759 Bremen, Germany
Fax:   +49 421 200 3103         <http://www.jacobs-university.de/>
_______________________________________________
YANG mailing list
YANG@ietf.org
https://www.ietf.org/mailman/listinfo/yang