Internet DRAFT - draft-chen-netmod-yang-ext
draft-chen-netmod-yang-ext
NETCONF Data Modeling Language Q. Chen
Internet-Draft M. Du
Intended status: Informational ZTE Corporation
Expires: April 21, 2011 Oct 18, 2010
Extending YANG with Revised Types
draft-chen-netmod-yang-ext-00
Abstract
YANG - the NETCONF Data Modeling Language - supports modeling of a
tree of data elements that represent the configuration and runtime
status of a particular network element managed via NETCONF. This
document introduces new idea which revises the ID
[draft-linowski-netmod-yang-abstract-03] and clears some ambiguous
concepts and descrptions.
Status of this Memo
This Internet-Draft is submitted in full conformance with the
provisions of BCP 78 and BCP 79.
Internet-Drafts are working documents of the Internet Engineering
Task Force (IETF). Note that other groups may also distribute
working documents as Internet-Drafts. The list of current Internet-
Drafts is at http://datatracker.ietf.org/drafts/current/.
Internet-Drafts are draft documents valid for a maximum of six months
and may be updated, replaced, or obsoleted by other documents at any
time. It is inappropriate to use Internet-Drafts as reference
material or to cite them other than as "work in progress."
This Internet-Draft will expire on April 21, 2011.
Copyright Notice
Copyright (c) 2010 IETF Trust and the persons identified as the
document authors. All rights reserved.
This document is subject to BCP 78 and the IETF Trust's Legal
Provisions Relating to IETF Documents
(http://trustee.ietf.org/license-info) in effect on the date of
publication of this document. Please review these documents
carefully, as they describe your rights and restrictions with respect
to this document. Code Components extracted from this document must
include Simplified BSD License text as described in Section 4.e of
the Trust Legal Provisions and are provided without warranty as
Chen & Du Expires April 21, 2011 [Page 1]
Internet-Draft YANG Extension Oct 2010
described in the Simplified BSD License.
Table of Contents
1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 3
1.1. Conventions used in this document . . . . . . . . . . . . . 3
2. Redefing type in YANG abstract . . . . . . . . . . . . . . . . 3
3. Revised types in yang-abstract . . . . . . . . . . . . . . . . 3
3.1. Removing confusion . . . . . . . . . . . . . . . . . . . . 3
3.2. Result . . . . . . . . . . . . . . . . . . . . . . . . . . 4
4. Management Consideration . . . . . . . . . . . . . . . . . . . 4
5. Security Considerations . . . . . . . . . . . . . . . . . . . . 4
6. IANA Considerations . . . . . . . . . . . . . . . . . . . . . . 4
Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . . 4
Chen & Du Expires April 21, 2011 [Page 2]
Internet-Draft YANG Extension Oct 2010
1. Introduction
[draft-linowski-netmod-yang-abstract-03] suggests to enhance YANG
with supplementary modeling features and language abstractions with
the aim to improve the model extensibility and reuse.
However, some ideas and description are not defined clearly,this memo
tries to amend the concepts and gives some suggestions.
1.1. Conventions used in this document
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
"SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this
document are to be interpreted as described in [RFC2119].
2. Redefing type in YANG abstract
section "2.3. instance extension statement" and "2.4. instance-list
extension statement", the table of substatement list out that "type"
is allowed, but "instance-type" is not listed. so it is conflict with
what is wrote in section 3.2. instance-type extension statement.
suggest that "instance-type" is need not defined, use "type" instead,
and give description in section 2.3 and 2.4
3. Revised types in yang-abstract
3.1. Removing confusion
There exists difference between types of a list and types of the node
of the list,and both types are being used in application
implementation. But in YANG and yang-abstract, it is not
distinguished. It will cause confusion in complehension and
implementation . So it is strongly suggested do not introduce
subtree/subtype/field in list definition, that is in
"draft-linowski-netmod-yang-abstract-03.txt" , section "2.4.
instance-list extension statement" remove choice ,
container,instance,instance-list,leaf ,leaf-list,list in substatment
table, only "type" for use a complex-type is allowed.
Chen & Du Expires April 21, 2011 [Page 3]
Internet-Draft YANG Extension Oct 2010
3.2. Result
+---------------+-------------+
| substatement | cardinality |
+---------------+-------------+
| description | 0..1 |
| config | 0..1 |
| if-feature | 0..n |
| mandatory | 0..1 |
| must | 0..n |
| reference | 0..1 |
| status | 0..1 |
| type | 1 |
+---------------+-------------+
Figure 1: instance's substatements
4. Management Consideration
5. Security Considerations
TBD
6. IANA Considerations
TBD
Authors' Addresses
Qiaogang Chen
ZTE Corporation
3/F, R.D. Building 3, ZTE Industrial Park, Liuxian Road
Shenzhen 518055
P.R.China
Phone: +86 755 26773712
Email: chen.qiaogang@zte.com.cn
URI: http://www.zte.com.cn/
Chen & Du Expires April 21, 2011 [Page 4]
Internet-Draft YANG Extension Oct 2010
Ming Du
ZTE Corporation
3/F, R.D. Building 3, ZTE Industrial Park, Liuxian Road
Shenzhen 518055
P.R.China
Phone: +86 755 26773712
Email: du.ming@zte.com.cn
URI: http://www.zte.com.cn/
Chen & Du Expires April 21, 2011 [Page 5]
