|
Packit |
8fb591 |
module ietf-yang-types {
|
|
Packit |
8fb591 |
|
|
Packit |
8fb591 |
namespace "urn:ietf:params:xml:ns:yang:ietf-yang-types";
|
|
Packit |
8fb591 |
prefix "yang";
|
|
Packit |
8fb591 |
|
|
Packit |
8fb591 |
organization
|
|
Packit |
8fb591 |
"IETF NETMOD (NETCONF Data Modeling Language) Working Group";
|
|
Packit |
8fb591 |
|
|
Packit |
8fb591 |
contact
|
|
Packit |
8fb591 |
"WG Web: <http://tools.ietf.org/wg/netmod/>
|
|
Packit |
8fb591 |
WG List: <mailto:netmod@ietf.org>
|
|
Packit |
8fb591 |
|
|
Packit |
8fb591 |
WG Chair: David Kessens
|
|
Packit |
8fb591 |
<mailto:david.kessens@nsn.com>
|
|
Packit |
8fb591 |
|
|
Packit |
8fb591 |
WG Chair: Juergen Schoenwaelder
|
|
Packit |
8fb591 |
<mailto:j.schoenwaelder@jacobs-university.de>
|
|
Packit |
8fb591 |
|
|
Packit |
8fb591 |
Editor: Juergen Schoenwaelder
|
|
Packit |
8fb591 |
<mailto:j.schoenwaelder@jacobs-university.de>";
|
|
Packit |
8fb591 |
|
|
Packit |
8fb591 |
description
|
|
Packit |
8fb591 |
"This module contains a collection of generally useful derived
|
|
Packit |
8fb591 |
YANG data types.
|
|
Packit |
8fb591 |
|
|
Packit |
8fb591 |
Copyright (c) 2013 IETF Trust and the persons identified as
|
|
Packit |
8fb591 |
authors of the code. All rights reserved.
|
|
Packit |
8fb591 |
|
|
Packit |
8fb591 |
Redistribution and use in source and binary forms, with or
|
|
Packit |
8fb591 |
without modification, is permitted pursuant to, and subject
|
|
Packit |
8fb591 |
to the license terms contained in, the Simplified BSD License
|
|
Packit |
8fb591 |
set forth in Section 4.c of the IETF Trust's Legal Provisions
|
|
Packit |
8fb591 |
Relating to IETF Documents
|
|
Packit |
8fb591 |
(http://trustee.ietf.org/license-info).
|
|
Packit |
8fb591 |
|
|
Packit |
8fb591 |
This version of this YANG module is part of RFC 6991; see
|
|
Packit |
8fb591 |
the RFC itself for full legal notices.";
|
|
Packit |
8fb591 |
|
|
Packit |
8fb591 |
revision 2013-07-15 {
|
|
Packit |
8fb591 |
description
|
|
Packit |
8fb591 |
"This revision adds the following new data types:
|
|
Packit |
8fb591 |
- yang-identifier
|
|
Packit |
8fb591 |
- hex-string
|
|
Packit |
8fb591 |
- uuid
|
|
Packit |
8fb591 |
- dotted-quad";
|
|
Packit |
8fb591 |
reference
|
|
Packit |
8fb591 |
"RFC 6991: Common YANG Data Types";
|
|
Packit |
8fb591 |
}
|
|
Packit |
8fb591 |
|
|
Packit |
8fb591 |
revision 2010-09-24 {
|
|
Packit |
8fb591 |
description
|
|
Packit |
8fb591 |
"Initial revision.";
|
|
Packit |
8fb591 |
reference
|
|
Packit |
8fb591 |
"RFC 6021: Common YANG Data Types";
|
|
Packit |
8fb591 |
}
|
|
Packit |
8fb591 |
|
|
Packit |
8fb591 |
/*** collection of counter and gauge types ***/
|
|
Packit |
8fb591 |
|
|
Packit |
8fb591 |
typedef counter32 {
|
|
Packit |
8fb591 |
type uint32;
|
|
Packit |
8fb591 |
description
|
|
Packit |
8fb591 |
"The counter32 type represents a non-negative integer
|
|
Packit |
8fb591 |
that monotonically increases until it reaches a
|
|
Packit |
8fb591 |
maximum value of 2^32-1 (4294967295 decimal), when it
|
|
Packit |
8fb591 |
wraps around and starts increasing again from zero.
|
|
Packit |
8fb591 |
|
|
Packit |
8fb591 |
Counters have no defined 'initial' value, and thus, a
|
|
Packit |
8fb591 |
single value of a counter has (in general) no information
|
|
Packit |
8fb591 |
content. Discontinuities in the monotonically increasing
|
|
Packit |
8fb591 |
value normally occur at re-initialization of the
|
|
Packit |
8fb591 |
management system, and at other times as specified in the
|
|
Packit |
8fb591 |
description of a schema node using this type. If such
|
|
Packit |
8fb591 |
other times can occur, for example, the creation of
|
|
Packit |
8fb591 |
a schema node of type counter32 at times other than
|
|
Packit |
8fb591 |
re-initialization, then a corresponding schema node
|
|
Packit |
8fb591 |
should be defined, with an appropriate type, to indicate
|
|
Packit |
8fb591 |
the last discontinuity.
|
|
Packit |
8fb591 |
|
|
Packit |
8fb591 |
The counter32 type should not be used for configuration
|
|
Packit |
8fb591 |
schema nodes. A default statement SHOULD NOT be used in
|
|
Packit |
8fb591 |
combination with the type counter32.
|
|
Packit |
8fb591 |
|
|
Packit |
8fb591 |
In the value set and its semantics, this type is equivalent
|
|
Packit |
8fb591 |
to the Counter32 type of the SMIv2.";
|
|
Packit |
8fb591 |
reference
|
|
Packit |
8fb591 |
"RFC 2578: Structure of Management Information Version 2
|
|
Packit |
8fb591 |
(SMIv2)";
|
|
Packit |
8fb591 |
}
|
|
Packit |
8fb591 |
|
|
Packit |
8fb591 |
typedef zero-based-counter32 {
|
|
Packit |
8fb591 |
type yang:counter32;
|
|
Packit |
8fb591 |
default "0";
|
|
Packit |
8fb591 |
description
|
|
Packit |
8fb591 |
"The zero-based-counter32 type represents a counter32
|
|
Packit |
8fb591 |
that has the defined 'initial' value zero.
|
|
Packit |
8fb591 |
|
|
Packit |
8fb591 |
A schema node of this type will be set to zero (0) on creation
|
|
Packit |
8fb591 |
and will thereafter increase monotonically until it reaches
|
|
Packit |
8fb591 |
a maximum value of 2^32-1 (4294967295 decimal), when it
|
|
Packit |
8fb591 |
wraps around and starts increasing again from zero.
|
|
Packit |
8fb591 |
|
|
Packit |
8fb591 |
Provided that an application discovers a new schema node
|
|
Packit |
8fb591 |
of this type within the minimum time to wrap, it can use the
|
|
Packit |
8fb591 |
'initial' value as a delta. It is important for a management
|
|
Packit |
8fb591 |
station to be aware of this minimum time and the actual time
|
|
Packit |
8fb591 |
between polls, and to discard data if the actual time is too
|
|
Packit |
8fb591 |
long or there is no defined minimum time.
|
|
Packit |
8fb591 |
|
|
Packit |
8fb591 |
In the value set and its semantics, this type is equivalent
|
|
Packit |
8fb591 |
to the ZeroBasedCounter32 textual convention of the SMIv2.";
|
|
Packit |
8fb591 |
reference
|
|
Packit |
8fb591 |
"RFC 4502: Remote Network Monitoring Management Information
|
|
Packit |
8fb591 |
Base Version 2";
|
|
Packit |
8fb591 |
}
|
|
Packit |
8fb591 |
|
|
Packit |
8fb591 |
typedef counter64 {
|
|
Packit |
8fb591 |
type uint64;
|
|
Packit |
8fb591 |
description
|
|
Packit |
8fb591 |
"The counter64 type represents a non-negative integer
|
|
Packit |
8fb591 |
that monotonically increases until it reaches a
|
|
Packit |
8fb591 |
maximum value of 2^64-1 (18446744073709551615 decimal),
|
|
Packit |
8fb591 |
when it wraps around and starts increasing again from zero.
|
|
Packit |
8fb591 |
|
|
Packit |
8fb591 |
Counters have no defined 'initial' value, and thus, a
|
|
Packit |
8fb591 |
single value of a counter has (in general) no information
|
|
Packit |
8fb591 |
content. Discontinuities in the monotonically increasing
|
|
Packit |
8fb591 |
value normally occur at re-initialization of the
|
|
Packit |
8fb591 |
management system, and at other times as specified in the
|
|
Packit |
8fb591 |
description of a schema node using this type. If such
|
|
Packit |
8fb591 |
other times can occur, for example, the creation of
|
|
Packit |
8fb591 |
a schema node of type counter64 at times other than
|
|
Packit |
8fb591 |
re-initialization, then a corresponding schema node
|
|
Packit |
8fb591 |
should be defined, with an appropriate type, to indicate
|
|
Packit |
8fb591 |
the last discontinuity.
|
|
Packit |
8fb591 |
|
|
Packit |
8fb591 |
The counter64 type should not be used for configuration
|
|
Packit |
8fb591 |
schema nodes. A default statement SHOULD NOT be used in
|
|
Packit |
8fb591 |
combination with the type counter64.
|
|
Packit |
8fb591 |
|
|
Packit |
8fb591 |
In the value set and its semantics, this type is equivalent
|
|
Packit |
8fb591 |
to the Counter64 type of the SMIv2.";
|
|
Packit |
8fb591 |
reference
|
|
Packit |
8fb591 |
"RFC 2578: Structure of Management Information Version 2
|
|
Packit |
8fb591 |
(SMIv2)";
|
|
Packit |
8fb591 |
}
|
|
Packit |
8fb591 |
|
|
Packit |
8fb591 |
typedef zero-based-counter64 {
|
|
Packit |
8fb591 |
type yang:counter64;
|
|
Packit |
8fb591 |
default "0";
|
|
Packit |
8fb591 |
description
|
|
Packit |
8fb591 |
"The zero-based-counter64 type represents a counter64 that
|
|
Packit |
8fb591 |
has the defined 'initial' value zero.
|
|
Packit |
8fb591 |
|
|
Packit |
8fb591 |
|
|
Packit |
8fb591 |
|
|
Packit |
8fb591 |
|
|
Packit |
8fb591 |
A schema node of this type will be set to zero (0) on creation
|
|
Packit |
8fb591 |
and will thereafter increase monotonically until it reaches
|
|
Packit |
8fb591 |
a maximum value of 2^64-1 (18446744073709551615 decimal),
|
|
Packit |
8fb591 |
when it wraps around and starts increasing again from zero.
|
|
Packit |
8fb591 |
|
|
Packit |
8fb591 |
Provided that an application discovers a new schema node
|
|
Packit |
8fb591 |
of this type within the minimum time to wrap, it can use the
|
|
Packit |
8fb591 |
'initial' value as a delta. It is important for a management
|
|
Packit |
8fb591 |
station to be aware of this minimum time and the actual time
|
|
Packit |
8fb591 |
between polls, and to discard data if the actual time is too
|
|
Packit |
8fb591 |
long or there is no defined minimum time.
|
|
Packit |
8fb591 |
|
|
Packit |
8fb591 |
In the value set and its semantics, this type is equivalent
|
|
Packit |
8fb591 |
to the ZeroBasedCounter64 textual convention of the SMIv2.";
|
|
Packit |
8fb591 |
reference
|
|
Packit |
8fb591 |
"RFC 2856: Textual Conventions for Additional High Capacity
|
|
Packit |
8fb591 |
Data Types";
|
|
Packit |
8fb591 |
}
|
|
Packit |
8fb591 |
|
|
Packit |
8fb591 |
typedef gauge32 {
|
|
Packit |
8fb591 |
type uint32;
|
|
Packit |
8fb591 |
description
|
|
Packit |
8fb591 |
"The gauge32 type represents a non-negative integer, which
|
|
Packit |
8fb591 |
may increase or decrease, but shall never exceed a maximum
|
|
Packit |
8fb591 |
value, nor fall below a minimum value. The maximum value
|
|
Packit |
8fb591 |
cannot be greater than 2^32-1 (4294967295 decimal), and
|
|
Packit |
8fb591 |
the minimum value cannot be smaller than 0. The value of
|
|
Packit |
8fb591 |
a gauge32 has its maximum value whenever the information
|
|
Packit |
8fb591 |
being modeled is greater than or equal to its maximum
|
|
Packit |
8fb591 |
value, and has its minimum value whenever the information
|
|
Packit |
8fb591 |
being modeled is smaller than or equal to its minimum value.
|
|
Packit |
8fb591 |
If the information being modeled subsequently decreases
|
|
Packit |
8fb591 |
below (increases above) the maximum (minimum) value, the
|
|
Packit |
8fb591 |
gauge32 also decreases (increases).
|
|
Packit |
8fb591 |
|
|
Packit |
8fb591 |
In the value set and its semantics, this type is equivalent
|
|
Packit |
8fb591 |
to the Gauge32 type of the SMIv2.";
|
|
Packit |
8fb591 |
reference
|
|
Packit |
8fb591 |
"RFC 2578: Structure of Management Information Version 2
|
|
Packit |
8fb591 |
(SMIv2)";
|
|
Packit |
8fb591 |
}
|
|
Packit |
8fb591 |
|
|
Packit |
8fb591 |
typedef gauge64 {
|
|
Packit |
8fb591 |
type uint64;
|
|
Packit |
8fb591 |
description
|
|
Packit |
8fb591 |
"The gauge64 type represents a non-negative integer, which
|
|
Packit |
8fb591 |
may increase or decrease, but shall never exceed a maximum
|
|
Packit |
8fb591 |
value, nor fall below a minimum value. The maximum value
|
|
Packit |
8fb591 |
cannot be greater than 2^64-1 (18446744073709551615), and
|
|
Packit |
8fb591 |
the minimum value cannot be smaller than 0. The value of
|
|
Packit |
8fb591 |
a gauge64 has its maximum value whenever the information
|
|
Packit |
8fb591 |
being modeled is greater than or equal to its maximum
|
|
Packit |
8fb591 |
value, and has its minimum value whenever the information
|
|
Packit |
8fb591 |
being modeled is smaller than or equal to its minimum value.
|
|
Packit |
8fb591 |
If the information being modeled subsequently decreases
|
|
Packit |
8fb591 |
below (increases above) the maximum (minimum) value, the
|
|
Packit |
8fb591 |
gauge64 also decreases (increases).
|
|
Packit |
8fb591 |
|
|
Packit |
8fb591 |
In the value set and its semantics, this type is equivalent
|
|
Packit |
8fb591 |
to the CounterBasedGauge64 SMIv2 textual convention defined
|
|
Packit |
8fb591 |
in RFC 2856";
|
|
Packit |
8fb591 |
reference
|
|
Packit |
8fb591 |
"RFC 2856: Textual Conventions for Additional High Capacity
|
|
Packit |
8fb591 |
Data Types";
|
|
Packit |
8fb591 |
}
|
|
Packit |
8fb591 |
|
|
Packit |
8fb591 |
/*** collection of identifier-related types ***/
|
|
Packit |
8fb591 |
|
|
Packit |
8fb591 |
typedef object-identifier {
|
|
Packit |
8fb591 |
type string {
|
|
Packit |
8fb591 |
pattern '(([0-1](\.[1-3]?[0-9]))|(2\.(0|([1-9]\d*))))'
|
|
Packit |
8fb591 |
+ '(\.(0|([1-9]\d*)))*';
|
|
Packit |
8fb591 |
}
|
|
Packit |
8fb591 |
description
|
|
Packit |
8fb591 |
"The object-identifier type represents administratively
|
|
Packit |
8fb591 |
assigned names in a registration-hierarchical-name tree.
|
|
Packit |
8fb591 |
|
|
Packit |
8fb591 |
Values of this type are denoted as a sequence of numerical
|
|
Packit |
8fb591 |
non-negative sub-identifier values. Each sub-identifier
|
|
Packit |
8fb591 |
value MUST NOT exceed 2^32-1 (4294967295). Sub-identifiers
|
|
Packit |
8fb591 |
are separated by single dots and without any intermediate
|
|
Packit |
8fb591 |
whitespace.
|
|
Packit |
8fb591 |
|
|
Packit |
8fb591 |
The ASN.1 standard restricts the value space of the first
|
|
Packit |
8fb591 |
sub-identifier to 0, 1, or 2. Furthermore, the value space
|
|
Packit |
8fb591 |
of the second sub-identifier is restricted to the range
|
|
Packit |
8fb591 |
0 to 39 if the first sub-identifier is 0 or 1. Finally,
|
|
Packit |
8fb591 |
the ASN.1 standard requires that an object identifier
|
|
Packit |
8fb591 |
has always at least two sub-identifiers. The pattern
|
|
Packit |
8fb591 |
captures these restrictions.
|
|
Packit |
8fb591 |
|
|
Packit |
8fb591 |
Although the number of sub-identifiers is not limited,
|
|
Packit |
8fb591 |
module designers should realize that there may be
|
|
Packit |
8fb591 |
implementations that stick with the SMIv2 limit of 128
|
|
Packit |
8fb591 |
sub-identifiers.
|
|
Packit |
8fb591 |
|
|
Packit |
8fb591 |
This type is a superset of the SMIv2 OBJECT IDENTIFIER type
|
|
Packit |
8fb591 |
since it is not restricted to 128 sub-identifiers. Hence,
|
|
Packit |
8fb591 |
this type SHOULD NOT be used to represent the SMIv2 OBJECT
|
|
Packit |
8fb591 |
IDENTIFIER type; the object-identifier-128 type SHOULD be
|
|
Packit |
8fb591 |
used instead.";
|
|
Packit |
8fb591 |
reference
|
|
Packit |
8fb591 |
"ISO9834-1: Information technology -- Open Systems
|
|
Packit |
8fb591 |
Interconnection -- Procedures for the operation of OSI
|
|
Packit |
8fb591 |
Registration Authorities: General procedures and top
|
|
Packit |
8fb591 |
arcs of the ASN.1 Object Identifier tree";
|
|
Packit |
8fb591 |
}
|
|
Packit |
8fb591 |
|
|
Packit |
8fb591 |
typedef object-identifier-128 {
|
|
Packit |
8fb591 |
type object-identifier {
|
|
Packit |
8fb591 |
pattern '\d*(\.\d*){1,127}';
|
|
Packit |
8fb591 |
}
|
|
Packit |
8fb591 |
description
|
|
Packit |
8fb591 |
"This type represents object-identifiers restricted to 128
|
|
Packit |
8fb591 |
sub-identifiers.
|
|
Packit |
8fb591 |
|
|
Packit |
8fb591 |
In the value set and its semantics, this type is equivalent
|
|
Packit |
8fb591 |
to the OBJECT IDENTIFIER type of the SMIv2.";
|
|
Packit |
8fb591 |
reference
|
|
Packit |
8fb591 |
"RFC 2578: Structure of Management Information Version 2
|
|
Packit |
8fb591 |
(SMIv2)";
|
|
Packit |
8fb591 |
}
|
|
Packit |
8fb591 |
|
|
Packit |
8fb591 |
typedef yang-identifier {
|
|
Packit |
8fb591 |
type string {
|
|
Packit |
8fb591 |
length "1..max";
|
|
Packit |
8fb591 |
pattern '[a-zA-Z_][a-zA-Z0-9\-_.]*';
|
|
Packit |
8fb591 |
pattern '.|..|[^xX].*|.[^mM].*|..[^lL].*';
|
|
Packit |
8fb591 |
}
|
|
Packit |
8fb591 |
description
|
|
Packit |
8fb591 |
"A YANG identifier string as defined by the 'identifier'
|
|
Packit |
8fb591 |
rule in Section 12 of RFC 6020. An identifier must
|
|
Packit |
8fb591 |
start with an alphabetic character or an underscore
|
|
Packit |
8fb591 |
followed by an arbitrary sequence of alphabetic or
|
|
Packit |
8fb591 |
numeric characters, underscores, hyphens, or dots.
|
|
Packit |
8fb591 |
|
|
Packit |
8fb591 |
A YANG identifier MUST NOT start with any possible
|
|
Packit |
8fb591 |
combination of the lowercase or uppercase character
|
|
Packit |
8fb591 |
sequence 'xml'.";
|
|
Packit |
8fb591 |
reference
|
|
Packit |
8fb591 |
"RFC 6020: YANG - A Data Modeling Language for the Network
|
|
Packit |
8fb591 |
Configuration Protocol (NETCONF)";
|
|
Packit |
8fb591 |
}
|
|
Packit |
8fb591 |
|
|
Packit |
8fb591 |
/*** collection of types related to date and time***/
|
|
Packit |
8fb591 |
|
|
Packit |
8fb591 |
typedef date-and-time {
|
|
Packit |
8fb591 |
type string {
|
|
Packit |
8fb591 |
pattern '\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d+)?'
|
|
Packit |
8fb591 |
+ '(Z|[\+\-]\d{2}:\d{2})';
|
|
Packit |
8fb591 |
}
|
|
Packit |
8fb591 |
description
|
|
Packit |
8fb591 |
"The date-and-time type is a profile of the ISO 8601
|
|
Packit |
8fb591 |
standard for representation of dates and times using the
|
|
Packit |
8fb591 |
Gregorian calendar. The profile is defined by the
|
|
Packit |
8fb591 |
date-time production in Section 5.6 of RFC 3339.
|
|
Packit |
8fb591 |
|
|
Packit |
8fb591 |
The date-and-time type is compatible with the dateTime XML
|
|
Packit |
8fb591 |
schema type with the following notable exceptions:
|
|
Packit |
8fb591 |
|
|
Packit |
8fb591 |
(a) The date-and-time type does not allow negative years.
|
|
Packit |
8fb591 |
|
|
Packit |
8fb591 |
(b) The date-and-time time-offset -00:00 indicates an unknown
|
|
Packit |
8fb591 |
time zone (see RFC 3339) while -00:00 and +00:00 and Z
|
|
Packit |
8fb591 |
all represent the same time zone in dateTime.
|
|
Packit |
8fb591 |
|
|
Packit |
8fb591 |
(c) The canonical format (see below) of data-and-time values
|
|
Packit |
8fb591 |
differs from the canonical format used by the dateTime XML
|
|
Packit |
8fb591 |
schema type, which requires all times to be in UTC using
|
|
Packit |
8fb591 |
the time-offset 'Z'.
|
|
Packit |
8fb591 |
|
|
Packit |
8fb591 |
This type is not equivalent to the DateAndTime textual
|
|
Packit |
8fb591 |
convention of the SMIv2 since RFC 3339 uses a different
|
|
Packit |
8fb591 |
separator between full-date and full-time and provides
|
|
Packit |
8fb591 |
higher resolution of time-secfrac.
|
|
Packit |
8fb591 |
|
|
Packit |
8fb591 |
The canonical format for date-and-time values with a known time
|
|
Packit |
8fb591 |
zone uses a numeric time zone offset that is calculated using
|
|
Packit |
8fb591 |
the device's configured known offset to UTC time. A change of
|
|
Packit |
8fb591 |
the device's offset to UTC time will cause date-and-time values
|
|
Packit |
8fb591 |
to change accordingly. Such changes might happen periodically
|
|
Packit |
8fb591 |
in case a server follows automatically daylight saving time
|
|
Packit |
8fb591 |
(DST) time zone offset changes. The canonical format for
|
|
Packit |
8fb591 |
date-and-time values with an unknown time zone (usually
|
|
Packit |
8fb591 |
referring to the notion of local time) uses the time-offset
|
|
Packit |
8fb591 |
-00:00.";
|
|
Packit |
8fb591 |
reference
|
|
Packit |
8fb591 |
"RFC 3339: Date and Time on the Internet: Timestamps
|
|
Packit |
8fb591 |
RFC 2579: Textual Conventions for SMIv2
|
|
Packit |
8fb591 |
XSD-TYPES: XML Schema Part 2: Datatypes Second Edition";
|
|
Packit |
8fb591 |
}
|
|
Packit |
8fb591 |
|
|
Packit |
8fb591 |
typedef timeticks {
|
|
Packit |
8fb591 |
type uint32;
|
|
Packit |
8fb591 |
description
|
|
Packit |
8fb591 |
"The timeticks type represents a non-negative integer that
|
|
Packit |
8fb591 |
represents the time, modulo 2^32 (4294967296 decimal), in
|
|
Packit |
8fb591 |
hundredths of a second between two epochs. When a schema
|
|
Packit |
8fb591 |
node is defined that uses this type, the description of
|
|
Packit |
8fb591 |
the schema node identifies both of the reference epochs.
|
|
Packit |
8fb591 |
|
|
Packit |
8fb591 |
In the value set and its semantics, this type is equivalent
|
|
Packit |
8fb591 |
to the TimeTicks type of the SMIv2.";
|
|
Packit |
8fb591 |
reference
|
|
Packit |
8fb591 |
"RFC 2578: Structure of Management Information Version 2
|
|
Packit |
8fb591 |
(SMIv2)";
|
|
Packit |
8fb591 |
}
|
|
Packit |
8fb591 |
|
|
Packit |
8fb591 |
typedef timestamp {
|
|
Packit |
8fb591 |
type yang:timeticks;
|
|
Packit |
8fb591 |
description
|
|
Packit |
8fb591 |
"The timestamp type represents the value of an associated
|
|
Packit |
8fb591 |
timeticks schema node at which a specific occurrence
|
|
Packit |
8fb591 |
happened. The specific occurrence must be defined in the
|
|
Packit |
8fb591 |
description of any schema node defined using this type. When
|
|
Packit |
8fb591 |
the specific occurrence occurred prior to the last time the
|
|
Packit |
8fb591 |
associated timeticks attribute was zero, then the timestamp
|
|
Packit |
8fb591 |
value is zero. Note that this requires all timestamp values
|
|
Packit |
8fb591 |
to be reset to zero when the value of the associated timeticks
|
|
Packit |
8fb591 |
attribute reaches 497+ days and wraps around to zero.
|
|
Packit |
8fb591 |
|
|
Packit |
8fb591 |
The associated timeticks schema node must be specified
|
|
Packit |
8fb591 |
in the description of any schema node using this type.
|
|
Packit |
8fb591 |
|
|
Packit |
8fb591 |
In the value set and its semantics, this type is equivalent
|
|
Packit |
8fb591 |
to the TimeStamp textual convention of the SMIv2.";
|
|
Packit |
8fb591 |
reference
|
|
Packit |
8fb591 |
"RFC 2579: Textual Conventions for SMIv2";
|
|
Packit |
8fb591 |
}
|
|
Packit |
8fb591 |
|
|
Packit |
8fb591 |
/*** collection of generic address types ***/
|
|
Packit |
8fb591 |
|
|
Packit |
8fb591 |
typedef phys-address {
|
|
Packit |
8fb591 |
type string {
|
|
Packit |
8fb591 |
pattern '([0-9a-fA-F]{2}(:[0-9a-fA-F]{2})*)?';
|
|
Packit |
8fb591 |
}
|
|
Packit |
8fb591 |
|
|
Packit |
8fb591 |
|
|
Packit |
8fb591 |
|
|
Packit |
8fb591 |
|
|
Packit |
8fb591 |
description
|
|
Packit |
8fb591 |
"Represents media- or physical-level addresses represented
|
|
Packit |
8fb591 |
as a sequence octets, each octet represented by two hexadecimal
|
|
Packit |
8fb591 |
numbers. Octets are separated by colons. The canonical
|
|
Packit |
8fb591 |
representation uses lowercase characters.
|
|
Packit |
8fb591 |
|
|
Packit |
8fb591 |
In the value set and its semantics, this type is equivalent
|
|
Packit |
8fb591 |
to the PhysAddress textual convention of the SMIv2.";
|
|
Packit |
8fb591 |
reference
|
|
Packit |
8fb591 |
"RFC 2579: Textual Conventions for SMIv2";
|
|
Packit |
8fb591 |
}
|
|
Packit |
8fb591 |
|
|
Packit |
8fb591 |
typedef mac-address {
|
|
Packit |
8fb591 |
type string {
|
|
Packit |
8fb591 |
pattern '[0-9a-fA-F]{2}(:[0-9a-fA-F]{2}){5}';
|
|
Packit |
8fb591 |
}
|
|
Packit |
8fb591 |
description
|
|
Packit |
8fb591 |
"The mac-address type represents an IEEE 802 MAC address.
|
|
Packit |
8fb591 |
The canonical representation uses lowercase characters.
|
|
Packit |
8fb591 |
|
|
Packit |
8fb591 |
In the value set and its semantics, this type is equivalent
|
|
Packit |
8fb591 |
to the MacAddress textual convention of the SMIv2.";
|
|
Packit |
8fb591 |
reference
|
|
Packit |
8fb591 |
"IEEE 802: IEEE Standard for Local and Metropolitan Area
|
|
Packit |
8fb591 |
Networks: Overview and Architecture
|
|
Packit |
8fb591 |
RFC 2579: Textual Conventions for SMIv2";
|
|
Packit |
8fb591 |
}
|
|
Packit |
8fb591 |
|
|
Packit |
8fb591 |
/*** collection of XML-specific types ***/
|
|
Packit |
8fb591 |
|
|
Packit |
8fb591 |
typedef xpath1.0 {
|
|
Packit |
8fb591 |
type string;
|
|
Packit |
8fb591 |
description
|
|
Packit |
8fb591 |
"This type represents an XPATH 1.0 expression.
|
|
Packit |
8fb591 |
|
|
Packit |
8fb591 |
When a schema node is defined that uses this type, the
|
|
Packit |
8fb591 |
description of the schema node MUST specify the XPath
|
|
Packit |
8fb591 |
context in which the XPath expression is evaluated.";
|
|
Packit |
8fb591 |
reference
|
|
Packit |
8fb591 |
"XPATH: XML Path Language (XPath) Version 1.0";
|
|
Packit |
8fb591 |
}
|
|
Packit |
8fb591 |
|
|
Packit |
8fb591 |
/*** collection of string types ***/
|
|
Packit |
8fb591 |
|
|
Packit |
8fb591 |
typedef hex-string {
|
|
Packit |
8fb591 |
type string {
|
|
Packit |
8fb591 |
pattern '([0-9a-fA-F]{2}(:[0-9a-fA-F]{2})*)?';
|
|
Packit |
8fb591 |
}
|
|
Packit |
8fb591 |
description
|
|
Packit |
8fb591 |
"A hexadecimal string with octets represented as hex digits
|
|
Packit |
8fb591 |
separated by colons. The canonical representation uses
|
|
Packit |
8fb591 |
lowercase characters.";
|
|
Packit |
8fb591 |
}
|
|
Packit |
8fb591 |
|
|
Packit |
8fb591 |
typedef uuid {
|
|
Packit |
8fb591 |
type string {
|
|
Packit |
8fb591 |
pattern '[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-'
|
|
Packit |
8fb591 |
+ '[0-9a-fA-F]{4}-[0-9a-fA-F]{12}';
|
|
Packit |
8fb591 |
}
|
|
Packit |
8fb591 |
description
|
|
Packit |
8fb591 |
"A Universally Unique IDentifier in the string representation
|
|
Packit |
8fb591 |
defined in RFC 4122. The canonical representation uses
|
|
Packit |
8fb591 |
lowercase characters.
|
|
Packit |
8fb591 |
|
|
Packit |
8fb591 |
The following is an example of a UUID in string representation:
|
|
Packit |
8fb591 |
f81d4fae-7dec-11d0-a765-00a0c91e6bf6
|
|
Packit |
8fb591 |
";
|
|
Packit |
8fb591 |
reference
|
|
Packit |
8fb591 |
"RFC 4122: A Universally Unique IDentifier (UUID) URN
|
|
Packit |
8fb591 |
Namespace";
|
|
Packit |
8fb591 |
}
|
|
Packit |
8fb591 |
|
|
Packit |
8fb591 |
typedef dotted-quad {
|
|
Packit |
8fb591 |
type string {
|
|
Packit |
8fb591 |
pattern
|
|
Packit |
8fb591 |
'(([0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])\.){3}'
|
|
Packit |
8fb591 |
+ '([0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])';
|
|
Packit |
8fb591 |
}
|
|
Packit |
8fb591 |
description
|
|
Packit |
8fb591 |
"An unsigned 32-bit number expressed in the dotted-quad
|
|
Packit |
8fb591 |
notation, i.e., four octets written as decimal numbers
|
|
Packit |
8fb591 |
and separated with the '.' (full stop) character.";
|
|
Packit |
8fb591 |
}
|
|
Packit |
8fb591 |
}
|