150 lines
4.7 KiB
XML
150 lines
4.7 KiB
XML
<?xml version="1.0" encoding="UTF-8"?>
|
|
<!DOCTYPE rfc SYSTEM "rfc2629-xhtml.ent">
|
|
<?rfc toc="yes"?>
|
|
<rfc xmlns:xi="http://www.w3.org/2001/XInclude" category="info" docName="%(name)s" ipr="trust200902" obsoletes="" updates="" submissionType="IETF" xml:lang="en" version="3">
|
|
<front>
|
|
<title>%(title)s</title>
|
|
<seriesInfo name="Internet-Draft" value="%(name)s"/>
|
|
<author asciiFullname="%(asciiAuthor)s" fullname="%(author)s" initials="%(initials)s" asciiSurname="%(asciiSurname)s" surname="%(surname)s">
|
|
<organization>Test Centre Inc.</organization>
|
|
<address>
|
|
<postal>
|
|
<street>42 Some Road</street>
|
|
<city>Some Where 12345</city>
|
|
<country>UK</country>
|
|
</postal>
|
|
<email>%(email)s</email>
|
|
</address>
|
|
</author>
|
|
<date day="%(day)s" month="%(month)s" year="%(year)s"/>
|
|
<workgroup>%(group)s</workgroup>
|
|
<abstract>
|
|
<t>
|
|
This document describes how to test tests.
|
|
</t>
|
|
</abstract>
|
|
</front>
|
|
<middle>
|
|
<section numbered="true" toc="default">
|
|
<name>Introduction</name>
|
|
<t>
|
|
This document describes a protocol for testing tests.
|
|
</t>
|
|
</section>
|
|
<section numbered="true" toc="default">
|
|
<name>Yang</name>
|
|
<sourcecode name="ietf-yang-metadata@2016-08-05.yang" type="" markers="true"><![CDATA[
|
|
|
|
module ietf-yang-metadata {
|
|
|
|
namespace "urn:ietf:params:xml:ns:yang:ietf-yang-metadata";
|
|
|
|
prefix "md";
|
|
|
|
organization
|
|
"IETF NETMOD (NETCONF Data Modeling Language) Working Group";
|
|
|
|
contact
|
|
"WG Web: <https://datatracker.ietf.org/wg/netmod/>
|
|
|
|
WG List: <mailto:netmod@ietf.org>
|
|
|
|
WG Chair: Lou Berger
|
|
<mailto:lberger@labn.net>
|
|
|
|
WG Chair: Kent Watsen
|
|
<mailto:kwatsen@juniper.net>
|
|
|
|
Editor: Ladislav Lhotka
|
|
<mailto:lhotka@nic.cz>";
|
|
|
|
description
|
|
"This YANG module defines an 'extension' statement that allows
|
|
for defining metadata annotations.
|
|
|
|
Copyright (c) 2016 IETF Trust and the persons identified as
|
|
authors of the code. All rights reserved.
|
|
|
|
Redistribution and use in source and binary forms, with or
|
|
without modification, is permitted pursuant to, and subject to
|
|
the license terms contained in, the Simplified BSD License set
|
|
forth in Section 4.c of the IETF Trust's Legal Provisions
|
|
Relating to IETF Documents
|
|
(http://trustee.ietf.org/license-info).
|
|
|
|
This version of this YANG module is part of RFC 7952
|
|
(http://www.rfc-editor.org/info/rfc7952); see the RFC itself
|
|
for full legal notices.";
|
|
|
|
revision 2016-08-05 {
|
|
description
|
|
"Initial revision.";
|
|
reference
|
|
"RFC 7952: Defining and Using Metadata with YANG";
|
|
}
|
|
|
|
extension annotation {
|
|
argument name;
|
|
description
|
|
"This extension allows for defining metadata annotations in
|
|
YANG modules. The 'md:annotation' statement can appear only
|
|
at the top level of a YANG module or submodule, i.e., it
|
|
becomes a new alternative in the ABNF production rule for
|
|
'body-stmts' (Section 14 in RFC 7950).
|
|
|
|
The argument of the 'md:annotation' statement defines the name
|
|
of the annotation. Syntactically, it is a YANG identifier as
|
|
defined in Section 6.2 of RFC 7950.
|
|
|
|
An annotation defined with this 'extension' statement inherits
|
|
the namespace and other context from the YANG module in which
|
|
it is defined.
|
|
|
|
The data type of the annotation value is specified in the same
|
|
way as for a leaf data node using the 'type' statement.
|
|
|
|
The semantics of the annotation and other documentation can be
|
|
specified using the following standard YANG substatements (all
|
|
are optional): 'description', 'if-feature', 'reference',
|
|
'status', and 'units'.
|
|
|
|
A server announces support for a particular annotation by
|
|
including the module in which the annotation is defined among
|
|
the advertised YANG modules, e.g., in a NETCONF <hello>
|
|
message or in the YANG library (RFC 7950). The annotation can
|
|
then be attached to any instance of a data node defined in any
|
|
YANG module that is advertised by the server.
|
|
|
|
XML encoding and JSON encoding of annotations are defined in
|
|
RFC 7952.";
|
|
}
|
|
}
|
|
|
|
]]></sourcecode>
|
|
</section>
|
|
<section anchor="JSON" numbered="true" toc="default">
|
|
<name>JSON example</name>
|
|
<t>
|
|
The JSON object should look like this:
|
|
|
|
{
|
|
"test": 1234
|
|
}
|
|
</t>
|
|
</section>
|
|
<section anchor="Security" numbered="true" toc="default">
|
|
<name>Security Considerations</name>
|
|
<t>
|
|
There are none.
|
|
</t>
|
|
</section>
|
|
<section anchor="IANA" numbered="true" toc="default">
|
|
<name>IANA Considerations</name>
|
|
<t>
|
|
No new registrations for IANA.
|
|
</t>
|
|
</section>
|
|
</middle>
|
|
<back/>
|
|
</rfc>
|