vnfs/TestVNF/netconftemplates/netconftemplates/ietf-yang-metadata@2016-08-05.yin

   1 <rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="m-1">
   2   <data xmlns="urn:ietf:params:xml:ns:yang:ietf-netconf-monitoring">&lt;?xml version="1.0" encoding="UTF-8"?&gt;
   3 &lt;module name="ietf-yang-metadata"
   4         xmlns="urn:ietf:params:xml:ns:yang:yin:1"
   5         xmlns:md="urn:ietf:params:xml:ns:yang:ietf-yang-metadata"&gt;
   6   &lt;namespace uri="urn:ietf:params:xml:ns:yang:ietf-yang-metadata"/&gt;
   7   &lt;prefix value="md"/&gt;
   8   &lt;organization&gt;
   9     &lt;text&gt;IETF NETMOD (NETCONF Data Modeling Language) Working Group&lt;/text&gt;
  10   &lt;/organization&gt;
  11   &lt;contact&gt;
  12     &lt;text&gt;WG Web:   &amp;lt;https://datatracker.ietf.org/wg/netmod/&amp;gt;
  13
  14 WG List:  &amp;lt;mailto:netmod@ietf.org&amp;gt;
  15
  16 WG Chair: Lou Berger
  17           &amp;lt;mailto:lberger@labn.net&amp;gt;
  18
  19 WG Chair: Kent Watsen
  20           &amp;lt;mailto:kwatsen@juniper.net&amp;gt;
  21
  22 Editor:   Ladislav Lhotka
  23           &amp;lt;mailto:lhotka@nic.cz&amp;gt;&lt;/text&gt;
  24   &lt;/contact&gt;
  25   &lt;description&gt;
  26     &lt;text&gt;This YANG module defines an 'extension' statement that allows
  27 for defining metadata annotations.
  28
  29 Copyright (c) 2016 IETF Trust and the persons identified as
  30 authors of the code.  All rights reserved.
  31
  32 Redistribution and use in source and binary forms, with or
  33 without modification, is permitted pursuant to, and subject to
  34 the license terms contained in, the Simplified BSD License set
  35 forth in Section 4.c of the IETF Trust's Legal Provisions
  36 Relating to IETF Documents
  37 (http://trustee.ietf.org/license-info).
  38
  39 This version of this YANG module is part of RFC 7952
  40 (http://www.rfc-editor.org/info/rfc7952); see the RFC itself
  41 for full legal notices.&lt;/text&gt;
  42   &lt;/description&gt;
  43   &lt;revision date="2016-08-05"&gt;
  44     &lt;description&gt;
  45       &lt;text&gt;Initial revision.&lt;/text&gt;
  46     &lt;/description&gt;
  47     &lt;reference&gt;
  48       &lt;text&gt;RFC 7952: Defining and Using Metadata with YANG&lt;/text&gt;
  49     &lt;/reference&gt;
  50   &lt;/revision&gt;
  51   &lt;extension name="annotation"&gt;
  52     &lt;argument name="name"/&gt;
  53     &lt;description&gt;
  54       &lt;text&gt;This extension allows for defining metadata annotations in
  55 YANG modules.  The 'md:annotation' statement can appear only
  56 at the top level of a YANG module or submodule, i.e., it
  57 becomes a new alternative in the ABNF production rule for
  58 'body-stmts' (Section 14 in RFC 7950).
  59
  60 The argument of the 'md:annotation' statement defines the name
  61 of the annotation.  Syntactically, it is a YANG identifier as
  62 defined in Section 6.2 of RFC 7950.
  63
  64 An annotation defined with this 'extension' statement inherits
  65 the namespace and other context from the YANG module in which
  66 it is defined.
  67
  68 The data type of the annotation value is specified in the same
  69 way as for a leaf data node using the 'type' statement.
  70
  71 The semantics of the annotation and other documentation can be
  72 specified using the following standard YANG substatements (all
  73 are optional): 'description', 'if-feature', 'reference',
  74 'status', and 'units'.
  75
  76 A server announces support for a particular annotation by
  77 including the module in which the annotation is defined among
  78 the advertised YANG modules, e.g., in a NETCONF &amp;lt;hello&amp;gt;
  79 message or in the YANG library (RFC 7950).  The annotation can
  80 then be attached to any instance of a data node defined in any
  81 YANG module that is advertised by the server.
  82
  83 XML encoding and JSON encoding of annotations are defined in
  84 RFC 7952.&lt;/text&gt;
  85     &lt;/description&gt;
  86   &lt;/extension&gt;
  87 &lt;/module&gt;
  88 </data>
  89 </rpc-reply>