rfc9108v1.txt   rfc9108.txt 
Internet Engineering Task Force (IETF) L. Lhotka Internet Engineering Task Force (IETF) L. Lhotka
Request for Comments: 9108 CZ.NIC Request for Comments: 9108 CZ.NIC
Category: Standards Track P. Špaček Category: Standards Track P. Špaček
ISSN: 2070-1721 Internet Systems Consortium ISSN: 2070-1721 Internet Systems Consortium
July 2021 August 2021
YANG Types for DNS Classes and Resource Record Types YANG Types for DNS Classes and Resource Record Types
Abstract Abstract
This document introduces the YANG module "iana-dns-class-rr-type", This document introduces the YANG module "iana-dns-class-rr-type",
which contains derived types reflecting two IANA registries: DNS which contains derived types reflecting two IANA registries: DNS
CLASSes and Resource Record (RR) TYPEs. These YANG types are CLASSes and Resource Record (RR) TYPEs. These YANG types are
intended as the minimum basis for future data modeling work. intended as the minimum basis for future data modeling work.
skipping to change at line 100 skipping to change at line 100
cooperation and compromise from the vendors and developers of major cooperation and compromise from the vendors and developers of major
DNS server platforms. Nevertheless, it is likely that any DNS- DNS server platforms. Nevertheless, it is likely that any DNS-
related data modeling effort will need to use various DNS parameters related data modeling effort will need to use various DNS parameters
and enumerations that are specified in several IANA registries. For and enumerations that are specified in several IANA registries. For
use with YANG, these parameters and enumerations have to be use with YANG, these parameters and enumerations have to be
translated into corresponding YANG types or other structures. Such translated into corresponding YANG types or other structures. Such
translations should be straightforward and relatively translations should be straightforward and relatively
uncontroversial. uncontroversial.
This document provides a translation of two fundamental DNS-related This document provides a translation of two fundamental DNS-related
IANA registries to YANG. It contains the initial revision of the IANA registries to YANG. It contains the initial version of the YANG
YANG module "iana-dns-class-rr-type", which defines derived types for module "iana-dns-class-rr-type", which defines derived types for the
the common parameters of DNS resource records (RR): class and type. common parameters of DNS resource records (RR): class and type.
These YANG types, "dns-class" and "rr-type", reflect the IANA These YANG types, "dns-class" and "rr-type", reflect the IANA
registries "DNS CLASSes" and "Resource Record (RR) TYPEs" registries "DNS CLASSes" and "Resource Record (RR) TYPEs"
[IANA-DNS-PARAMETERS]. [IANA-DNS-PARAMETERS].
Appendix A contains an XSLT 1.0 stylesheet that is intended to be Appendix A contains an XSLT 1.0 stylesheet that is intended to be
used by IANA for generating the initial revision of the "iana-dns- used by IANA for generating the initial version of the "iana-dns-
class-rr-type" YANG module. Subsequently, whenever a new class or RR class-rr-type" YANG module. Subsequently, whenever a new class or RR
type is added to the above registries, IANA will also update the type is added to the above registries, IANA will also update the
"iana-dns-class-rr-type" YANG module, following the instructions in "iana-dns-class-rr-type" YANG module, following the instructions in
Section 4 below. Section 4 below.
2. Terminology 2. Terminology
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
"SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and
"OPTIONAL" in this document are to be interpreted as described in "OPTIONAL" in this document are to be interpreted as described in
skipping to change at line 196 skipping to change at line 196
As unassigned and reserved class and RR type values are not included As unassigned and reserved class and RR type values are not included
in the mnemonic name enumerations, they can only be specified using in the mnemonic name enumerations, they can only be specified using
their decimal values. their decimal values.
4. IANA Considerations 4. IANA Considerations
This section deals with actions and processes necessary for IANA to This section deals with actions and processes necessary for IANA to
undertake to maintain the "iana-dns-class-rr-type" YANG module. This undertake to maintain the "iana-dns-class-rr-type" YANG module. This
YANG module is intended to reflect the "DNS CLASSes" and "Resource YANG module is intended to reflect the "DNS CLASSes" and "Resource
Record (RR) TYPEs" registries in [IANA-DNS-PARAMETERS]. The most Record (RR) TYPEs" registries in [IANA-DNS-PARAMETERS]. The most
recent revision of the YANG module is available from the "YANG recent version of the YANG module is available from the "YANG
Parameters" registry [IANA-YANG-PARAMETERS]. Parameters" registry [IANA-YANG-PARAMETERS].
Upon publication of this document, the initial revision of the "iana- With the publication of this document, IANA has created and posted
dns-class-rr-type" YANG module SHALL be created by applying the XSLT the initial version of the "iana-dns-class-rr-type" YANG module by
stylesheet from Appendix A to the XML version of applying the XSLT stylesheet from Appendix A to the XML version of
[IANA-DNS-PARAMETERS]. [IANA-DNS-PARAMETERS].
IANA has added this note to the "iana-dns-class-rr-type" item of the IANA has added this note to the "iana-dns-class-rr-type" item of the
"YANG Module Names" registry [IANA-YANG-PARAMETERS]: "YANG Module Names" registry [IANA-YANG-PARAMETERS]:
| Classes and types of DNS resource records must not be directly | Classes and types of DNS resource records must not be directly
| added to the "iana-dns-class-rr-type" YANG module. They must | added to the "iana-dns-class-rr-type" YANG module. They must
| instead be added to the "DNS CLASSes" and "Resource Record (RR) | instead be added to the "DNS CLASSes" and "Resource Record (RR)
| TYPEs" registries, respectively. | TYPEs" registries, respectively.
skipping to change at line 417 skipping to change at line 417
Copyright (c) 2021 IETF Trust and the persons identified as Copyright (c) 2021 IETF Trust and the persons identified as
authors of the code. All rights reserved. authors of the code. All rights reserved.
Redistribution and use in source and binary forms, with or Redistribution and use in source and binary forms, with or
without modification, is permitted pursuant to, and subject to without modification, is permitted pursuant to, and subject to
the license terms contained in, the Simplified BSD License set the license terms contained in, the Simplified BSD License set
forth in Section 4.c of the IETF Trust's Legal Provisions forth in Section 4.c of the IETF Trust's Legal Provisions
Relating to IETF Documents Relating to IETF Documents
(https://trustee.ietf.org/license-info). (https://trustee.ietf.org/license-info).
This initial version of this YANG module was generated from This version of this YANG module was generated from
the corresponding IANA registries using an XSLT stylesheet the corresponding IANA registries using an XSLT stylesheet
from Appendix A of RFC 9108 from Appendix A of RFC 9108
(https://www.rfc-editor.org/info/rfc9108); see the RFC itself (https://www.rfc-editor.org/info/rfc9108); see the RFC itself
for full legal notices."; for full legal notices.";
reference reference
"IANA 'Domain Name System (DNS) Parameters' registry "IANA 'Domain Name System (DNS) Parameters' registry
https://www.iana.org/assignments/dns-parameters";</text> https://www.iana.org/assignments/dns-parameters";</text>
<text>&#xA;&#xA;</text> <text>&#xA;&#xA;</text>
</variable> </variable>
 End of changes. 6 change blocks. 
10 lines changed or deleted 10 lines changed or added

This html diff was produced by rfcdiff 1.48. The latest version is available from http://tools.ietf.org/tools/rfcdiff/