Yang解析

2023-10-25 21:17:34

摘自：https://blog.csdn.net/CSND_PAN/article/details/79542917

一、Yang的来源

早在2003年，IETF成立了一个NETCONF工作组，提出一种基于XML的网络配置管理协议，也就是NETCONF(Network Configuration Protocol)，因为该协议的配置功能非常强大，同时兼顾监控和故障管理，安全验证和访问控制，所以得到业界的一致认可，所以广泛采用netconfig来配置网络。

NETCONF协议分为传输层、RPC层、操作层和内容层。其中，内容层是唯一没有标准化的层，于是一种新的建模语言YAN*生了，它的目标是对NETCONF数据模型、操作进行建模，覆盖NETCONF协议的操作层和内容层

二、Yang的基本元素

module

module是YANG的基本单元，是写yang文件的基本框架，包括以下几种类型语句：
1、head语句(yang-version/namespace/prefix)
2、连接语句(import/include)、
3、元信息(organization/contract)、
4、revision语句、
5、定义语句(container/leaf/leaf-list/grouping等等)。
YANG模块有如下的布局：

module <module-name> {
//header information
yang-version statement
namespace statement
prefix statement

 // linkage statements
import statements
include statements

 // meta information
organization statement
contact statement
description statement
reference statement

// revision history
revision statements

 // module definitions
other statements
}

例如：

submodule

submodule是部分模块定义，用于对模块提供支持。
submodule文件内容布局如下：

submodule <module-name> {
yang-version statement

 // module identification
belongs-to statement

 // linkage statements
import statements
include statements

 // meta information
organization statement
contact statement
description statement
reference statement

// revision history
revision statements

 // module definitions
other statements
}

submodule示例如下：

注意：
submodule必须通过belongs-to语句使用， submodule只能由belong-to指定的module或这个指定module的其它submodule进行include，其它module(包括submodule)都不能include。同时子模块不可以import它的父模块

namespace

module中必须定义所有节点都属于一个特定的XML命名空间，由一个URI指定命名空间。例如

Import revision

import或include语句包含一个revision-date的子句，所有引入的YANG定义来自要导入或引入的指定revision模块。通过引入特定的模块修订，我们可以独立发布演变中的模块。YANG提供了指定的规则，如何发布进化中的模块并且保持向后的兼容性。比如：

YANG的数据类型

基本数据类型
YANG基本数据类型如下。

类别	类型	限制
Integral	Integral {u,}int{8,16,32,64}	range
Decimals	decimal64	range, fraction-digits
String	string	length,pattern
Enumeration	enumeration	enum
Bool and Bits	boolean, bits
Binary	binary	length
References	leafref	path
References	identityref	base
References	instance-identifier
Other	union
Other	empty

更加详细的描述请参看rfc6020协议，例如

派生类型

YANG采用typedef语句来定义派生类型。例如以下是定义一个派生类型percent，限制类型是内建类型uint8：

Java typedef percent { type uint8 { range “0 .. 100”; } } 再如定义一个ip-address类型，它包含了两个派生类型的联合： typedef ip-address { type union { type ipv4-address; type ipv6-address; } }

1 2 3 4 5 6 7 8 9 10 11 12

typedef percent { type uint8 { range “0 .. 100” ; } } 再如定义一个 ip - address类型，它包含了两个派生类型的联合： typedef ip - address { type union { type ipv4 - address ; type ipv6 - address ; } }