<?xml version="1.0" encoding="UTF-8"?>
  <?xml-stylesheet type="text/xsl" href="rfc2629.xslt" ?>
  <!-- generated by https://github.com/cabo/kramdown-rfc version 1.7.31 (Ruby 3.3.8) -->


<!DOCTYPE rfc  [
  <!ENTITY nbsp    "&#160;">
  <!ENTITY zwsp   "&#8203;">
  <!ENTITY nbhy   "&#8209;">
  <!ENTITY wj     "&#8288;">

]>


<rfc ipr="trust200902" docName="draft-pamtv-netconf-error-registries-00" category="std" consensus="true" submissionType="IETF" tocInclude="true" sortRefs="true" symRefs="true">
  <front>
    <title abbrev="NETCONF Error Registries">NETCONF Error List and Error Identities Registries</title>

    <author fullname="Per Andersson">
      <organization>Ionio Systems</organization>
      <address>
        <email>per.ietf@ionio.se</email>
      </address>
    </author>
    <author fullname="Mithun Thai Valaphil">
      <organization>Equinix</organization>
      <address>
        <email>mithun.ietf@gmail.com</email>
      </address>
    </author>

    <date year="2026" month="March" day="02"/>

    <area>ops</area>
    <workgroup>NETCONF</workgroup>
    <keyword>Internet-Draft</keyword>

    <abstract>


<?line 37?>

<t>This document defines IANA registries for the NETCONF Error List and NETCONF
Error Identities.</t>



    </abstract>



  </front>

  <middle>


<?line 43?>

<section anchor="introduction"><name>Introduction</name>

<t>In order to have a canonical source for all NETCONF Error and NETCONF Error
Identities, two IANA registries are defined. These registries can be extended
and updated as needed.</t>

<t>It is an advantage for protocol evolution to have canonical sources to extend,
instead of a set of documents that need to be compiled and referenced.</t>

</section>
<section anchor="conventions-and-definitions"><name>Conventions and Definitions</name>

<t>The key words "<bcp14>MUST</bcp14>", "<bcp14>MUST NOT</bcp14>", "<bcp14>REQUIRED</bcp14>", "<bcp14>SHALL</bcp14>", "<bcp14>SHALL
NOT</bcp14>", "<bcp14>SHOULD</bcp14>", "<bcp14>SHOULD NOT</bcp14>", "<bcp14>RECOMMENDED</bcp14>", "<bcp14>NOT RECOMMENDED</bcp14>",
"<bcp14>MAY</bcp14>", and "<bcp14>OPTIONAL</bcp14>" in this document are to be interpreted as
described in BCP 14 <xref target="RFC2119"/> <xref target="RFC8174"/> when, and only when, they
appear in all capitals, as shown here.</t>

<?line -18?>

</section>
<section anchor="iana-considerations"><name>IANA Considerations</name>

<section anchor="netconf-error-list-registry"><name>NETCONF Error List Registry</name>

<t>This document defines a registry for the NETCONF Error List defined in
Appendix A of <xref target="RFC6241"/>. The name of the registry is "NETCONF Error List".
The review policy for this registry is "IETF Review" <xref target="RFC5226"/>. The registry
shall record the following for each entry:</t>

<t><list style="symbols">
  <t>error-tag, TBD</t>
  <t>error-type, TBD</t>
  <t>error-severity, TBD</t>
  <t>error-info, auxilary information described as data nodes (XML tags).</t>
  <t>Description</t>
  <t>The reference for the document registering the value.</t>
</list></t>

<t>The initial contents of the registry is defined in <xref target="RFC6241"/> and inlined
below:</t>

<figure><artwork><![CDATA[
error-tag:      in-use
error-type:     protocol, application
error-severity: error
error-info:     none
Description:    The request requires a resource that already is in
                use.

error-tag:      invalid-value
error-type:     protocol, application
error-severity: error
error-info:     none
Description:    The request specifies an unacceptable value for one
                or more parameters.

error-tag:      too-big
error-type:     transport, rpc, protocol, application
error-severity: error
error-info:     none
Description:    The request or response (that would be generated) is
                too large for the implementation to handle.

error-tag:      missing-attribute
error-type:     rpc, protocol, application
error-severity: error
error-info:     <bad-attribute> : name of the missing attribute
                <bad-element> : name of the element that is supposed
                  to contain the missing attribute
Description:    An expected attribute is missing.

error-tag:      bad-attribute
error-type:     rpc, protocol, application
error-severity: error
error-info:     <bad-attribute> : name of the attribute w/ bad value
                <bad-element> : name of the element that contains
                  the attribute with the bad value
Description:    An attribute value is not correct; e.g., wrong type,
                out of range, pattern mismatch.
]]></artwork></figure>

</section>
<section anchor="netconf-error-identities"><name>NETCONF Error Identities</name>

<t>This document defines a registry for NETCONF Error Identities. The name of the
registry is "NETCONF Error Identities". The review policy for this registry is
"IETF Review" <xref target="RFC5226"/>. The registry shall record the following for each
entry:</t>

<t><list style="symbols">
  <t>Identity name.</t>
  <t>Base identity, if applicable.</t>
  <t>Additional information.</t>
  <t>The reference for the document registering the value.</t>
</list></t>

<t>The initial contents of the registry is defined in <xref target="RFC8639"/> and <xref target="RFC8641"/>
and inlined below:</t>

<figure><artwork><![CDATA[
dscp-unavailable
encoding-unsupported
filter-unsupported
insufficient-resources
replay-unsupported

filter-unsupported
insufficient-resources
no-such-subscription

no-such-subscription

datastore-not-subscribable
unchanging-selection

period-unsupported
update-too-big
synchronization-size
]]></artwork></figure>

</section>
</section>


  </middle>

  <back>



    <references title='Normative References' anchor="sec-normative-references">



<reference anchor="RFC5226">
  <front>
    <title>Guidelines for Writing an IANA Considerations Section in RFCs</title>
    <author fullname="T. Narten" initials="T." surname="Narten"/>
    <author fullname="H. Alvestrand" initials="H." surname="Alvestrand"/>
    <date month="May" year="2008"/>
    <abstract>
      <t>Many protocols make use of identifiers consisting of constants and other well-known values. Even after a protocol has been defined and deployment has begun, new values may need to be assigned (e.g., for a new option type in DHCP, or a new encryption or authentication transform for IPsec). To ensure that such quantities have consistent values and interpretations across all implementations, their assignment must be administered by a central authority. For IETF protocols, that role is provided by the Internet Assigned Numbers Authority (IANA).</t>
      <t>In order for IANA to manage a given namespace prudently, it needs guidelines describing the conditions under which new values can be assigned or when modifications to existing values can be made. If IANA is expected to play a role in the management of a namespace, IANA must be given clear and concise instructions describing that role. This document discusses issues that should be considered in formulating a policy for assigning values to a namespace and provides guidelines for authors on the specific text that must be included in documents that place demands on IANA.</t>
      <t>This document obsoletes RFC 2434. This document specifies an Internet Best Current Practices for the Internet Community, and requests discussion and suggestions for improvements.</t>
    </abstract>
  </front>
  <seriesInfo name="RFC" value="5226"/>
  <seriesInfo name="DOI" value="10.17487/RFC5226"/>
</reference>
<reference anchor="RFC6241">
  <front>
    <title>Network Configuration Protocol (NETCONF)</title>
    <author fullname="R. Enns" initials="R." role="editor" surname="Enns"/>
    <author fullname="M. Bjorklund" initials="M." role="editor" surname="Bjorklund"/>
    <author fullname="J. Schoenwaelder" initials="J." role="editor" surname="Schoenwaelder"/>
    <author fullname="A. Bierman" initials="A." role="editor" surname="Bierman"/>
    <date month="June" year="2011"/>
    <abstract>
      <t>The Network Configuration Protocol (NETCONF) defined in this document provides mechanisms to install, manipulate, and delete the configuration of network devices. It uses an Extensible Markup Language (XML)-based data encoding for the configuration data as well as the protocol messages. The NETCONF protocol operations are realized as remote procedure calls (RPCs). This document obsoletes RFC 4741. [STANDARDS-TRACK]</t>
    </abstract>
  </front>
  <seriesInfo name="RFC" value="6241"/>
  <seriesInfo name="DOI" value="10.17487/RFC6241"/>
</reference>
<reference anchor="RFC8639">
  <front>
    <title>Subscription to YANG Notifications</title>
    <author fullname="E. Voit" initials="E." surname="Voit"/>
    <author fullname="A. Clemm" initials="A." surname="Clemm"/>
    <author fullname="A. Gonzalez Prieto" initials="A." surname="Gonzalez Prieto"/>
    <author fullname="E. Nilsen-Nygaard" initials="E." surname="Nilsen-Nygaard"/>
    <author fullname="A. Tripathy" initials="A." surname="Tripathy"/>
    <date month="September" year="2019"/>
    <abstract>
      <t>This document defines a YANG data model and associated mechanisms enabling subscriber-specific subscriptions to a publisher's event streams. Applying these elements allows a subscriber to request and receive a continuous, customized feed of publisher-generated information.</t>
    </abstract>
  </front>
  <seriesInfo name="RFC" value="8639"/>
  <seriesInfo name="DOI" value="10.17487/RFC8639"/>
</reference>
<reference anchor="RFC8641">
  <front>
    <title>Subscription to YANG Notifications for Datastore Updates</title>
    <author fullname="A. Clemm" initials="A." surname="Clemm"/>
    <author fullname="E. Voit" initials="E." surname="Voit"/>
    <date month="September" year="2019"/>
    <abstract>
      <t>This document describes a mechanism that allows subscriber applications to request a continuous and customized stream of updates from a YANG datastore. Providing such visibility into updates enables new capabilities based on the remote mirroring and monitoring of configuration and operational state.</t>
    </abstract>
  </front>
  <seriesInfo name="RFC" value="8641"/>
  <seriesInfo name="DOI" value="10.17487/RFC8641"/>
</reference>
<reference anchor="RFC2119">
  <front>
    <title>Key words for use in RFCs to Indicate Requirement Levels</title>
    <author fullname="S. Bradner" initials="S." surname="Bradner"/>
    <date month="March" year="1997"/>
    <abstract>
      <t>In many standards track documents several words are used to signify the requirements in the specification. These words are often capitalized. This document defines these words as they should be interpreted in IETF documents. This document specifies an Internet Best Current Practices for the Internet Community, and requests discussion and suggestions for improvements.</t>
    </abstract>
  </front>
  <seriesInfo name="BCP" value="14"/>
  <seriesInfo name="RFC" value="2119"/>
  <seriesInfo name="DOI" value="10.17487/RFC2119"/>
</reference>
<reference anchor="RFC8174">
  <front>
    <title>Ambiguity of Uppercase vs Lowercase in RFC 2119 Key Words</title>
    <author fullname="B. Leiba" initials="B." surname="Leiba"/>
    <date month="May" year="2017"/>
    <abstract>
      <t>RFC 2119 specifies common key words that may be used in protocol specifications. This document aims to reduce the ambiguity by clarifying that only UPPERCASE usage of the key words have the defined special meanings.</t>
    </abstract>
  </front>
  <seriesInfo name="BCP" value="14"/>
  <seriesInfo name="RFC" value="8174"/>
  <seriesInfo name="DOI" value="10.17487/RFC8174"/>
</reference>



    </references>




<?line 173?>

<section numbered="false" anchor="acknowledgments"><name>Acknowledgments</name>

<t>TODO acknowledge.</t>

</section>


  </back>

<!-- ##markdown-source:
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
fxEAAA==

-->

</rfc>

