Debian Codegraph @

rfc9108.html

raw
1 <!DOCTYPE html>
2 <html lang="en" class="RFC">
3 <head>
4 <meta charset="utf-8">
5 <meta content="Common,Latin" name="scripts">
6 <meta content="initial-scale=1.0" name="viewport">
7 <title>RFC 9108: YANG Types for DNS Classes and Resource Record Types</title>
8 <meta content="Ladislav Lhotka" name="author">
9 <meta content="Petr Špaček" name="author">
10 <meta content='
11 This document introduces the YANG
12 module "iana-dns-class-rr-type", which contains derived types
13 reflecting two IANA registries: DNS CLASSes and Resource Record
14 (RR) TYPEs. These YANG types are intended as the minimum basis for
15 future data modeling work.
16 ' name="description">
17 <meta content="xml2rfc 3.9.1" name="generator">
18 <meta content="IANA registry" name="keyword">
19 <meta content="DNA Parameters" name="keyword">
20 <meta content="9108" name="rfc.number">
21 <!-- Generator version information:
22 xml2rfc 3.9.1
23 Python 3.6.10
24 appdirs 1.4.4
25 ConfigArgParse 1.2.3
26 google-i18n-address 2.3.5
27 html5lib 1.0.1
28 intervaltree 3.0.2
29 Jinja2 2.11.2
30 kitchen 1.2.6
31 lxml 4.4.2
32 pycairo 1.19.0
33 pycountry 19.8.18
34 pyflakes 2.1.1
35 PyYAML 5.3.1
36 requests 2.22.0
37 setuptools 40.6.2
38 six 1.14.0
39 WeasyPrint 51
40 -->
41 <link href="rfc9108.xml" rel="alternate" type="application/rfc+xml">
42 <link href="#copyright" rel="license">
43 <style type="text/css">/*
44
45 NOTE: Changes at the bottom of this file overrides some earlier settings.
46
47 Once the style has stabilized and has been adopted as an official RFC style,
48 this can be consolidated so that style settings occur only in one place, but
49 for now the contents of this file consists first of the initial CSS work as
50 provided to the RFC Formatter (xml2rfc) work, followed by itemized and
51 commented changes found necssary during the development of the v3
52 formatters.
53
54 */
55
56 /* fonts */
57 @import url('https://fonts.googleapis.com/css?family=Noto+Sans'); /* Sans-serif */
58 @import url('https://fonts.googleapis.com/css?family=Noto+Serif'); /* Serif (print) */
59 @import url('https://fonts.googleapis.com/css?family=Roboto+Mono'); /* Monospace */
60
61 @viewport {
62 zoom: 1.0;
63 width: extend-to-zoom;
64 }
65 @-ms-viewport {
66 width: extend-to-zoom;
67 zoom: 1.0;
68 }
69 /* general and mobile first */
70 html {
71 }
72 body {
73 max-width: 90%;
74 margin: 1.5em auto;
75 color: #222;
76 background-color: #fff;
77 font-size: 14px;
78 font-family: 'Noto Sans', Arial, Helvetica, sans-serif;
79 line-height: 1.6;
80 scroll-behavior: smooth;
81 }
82 .ears {
83 display: none;
84 }
85
86 /* headings */
87 #title, h1, h2, h3, h4, h5, h6 {
88 margin: 1em 0 0.5em;
89 font-weight: bold;
90 line-height: 1.3;
91 }
92 #title {
93 clear: both;
94 border-bottom: 1px solid #ddd;
95 margin: 0 0 0.5em 0;
96 padding: 1em 0 0.5em;
97 }
98 .author {
99 padding-bottom: 4px;
100 }
101 h1 {
102 font-size: 26px;
103 margin: 1em 0;
104 }
105 h2 {
106 font-size: 22px;
107 margin-top: -20px; /* provide offset for in-page anchors */
108 padding-top: 33px;
109 }
110 h3 {
111 font-size: 18px;
112 margin-top: -36px; /* provide offset for in-page anchors */
113 padding-top: 42px;
114 }
115 h4 {
116 font-size: 16px;
117 margin-top: -36px; /* provide offset for in-page anchors */
118 padding-top: 42px;
119 }
120 h5, h6 {
121 font-size: 14px;
122 }
123 #n-copyright-notice {
124 border-bottom: 1px solid #ddd;
125 padding-bottom: 1em;
126 margin-bottom: 1em;
127 }
128 /* general structure */
129 p {
130 padding: 0;
131 margin: 0 0 1em 0;
132 text-align: left;
133 }
134 div, span {
135 position: relative;
136 }
137 div {
138 margin: 0;
139 }
140 .alignRight.art-text {
141 background-color: #f9f9f9;
142 border: 1px solid #eee;
143 border-radius: 3px;
144 padding: 1em 1em 0;
145 margin-bottom: 1.5em;
146 }
147 .alignRight.art-text pre {
148 padding: 0;
149 }
150 .alignRight {
151 margin: 1em 0;
152 }
153 .alignRight > *:first-child {
154 border: none;
155 margin: 0;
156 float: right;
157 clear: both;
158 }
159 .alignRight > *:nth-child(2) {
160 clear: both;
161 display: block;
162 border: none;
163 }
164 svg {
165 display: block;
166 }
167 .alignCenter.art-text {
168 background-color: #f9f9f9;
169 border: 1px solid #eee;
170 border-radius: 3px;
171 padding: 1em 1em 0;
172 margin-bottom: 1.5em;
173 }
174 .alignCenter.art-text pre {
175 padding: 0;
176 }
177 .alignCenter {
178 margin: 1em 0;
179 }
180 .alignCenter > *:first-child {
181 border: none;
182 /* this isn't optimal, but it's an existence proof. PrinceXML doesn't
183 support flexbox yet.
184 */
185 display: table;
186 margin: 0 auto;
187 }
188
189 /* lists */
190 ol, ul {
191 padding: 0;
192 margin: 0 0 1em 2em;
193 }
194 ol ol, ul ul, ol ul, ul ol {
195 margin-left: 1em;
196 }
197 li {
198 margin: 0 0 0.25em 0;
199 }
200 .ulCompact li {
201 margin: 0;
202 }
203 ul.empty, .ulEmpty {
204 list-style-type: none;
205 }
206 ul.empty li, .ulEmpty li {
207 margin-top: 0.5em;
208 }
209 ul.ulBare, li.ulBare {
210 margin-left: 0em !important;
211 }
212 ul.compact, .ulCompact,
213 ol.compact, .olCompact {
214 line-height: 100%;
215 margin: 0 0 0 2em;
216 }
217
218 /* definition lists */
219 dl {
220 }
221 dl > dt {
222 float: left;
223 margin-right: 1em;
224 }
225 /*
226 dl.nohang > dt {
227 float: none;
228 }
229 */
230 dl > dd {
231 margin-bottom: .8em;
232 min-height: 1.3em;
233 }
234 dl.compact > dd, .dlCompact > dd {
235 margin-bottom: 0em;
236 }
237 dl > dd > dl {
238 margin-top: 0.5em;
239 margin-bottom: 0em;
240 }
241
242 /* links */
243 a {
244 text-decoration: none;
245 }
246 a[href] {
247 color: #22e; /* Arlen: WCAG 2019 */
248 }
249 a[href]:hover {
250 background-color: #f2f2f2;
251 }
252 figcaption a[href],
253 a[href].selfRef {
254 color: #222;
255 }
256 /* XXX probably not this:
257 a.selfRef:hover {
258 background-color: transparent;
259 cursor: default;
260 } */
261
262 /* Figures */
263 tt, code, pre, code {
264 background-color: #f9f9f9;
265 font-family: 'Roboto Mono', monospace;
266 }
267 pre {
268 border: 1px solid #eee;
269 margin: 0;
270 padding: 1em;
271 }
272 img {
273 max-width: 100%;
274 }
275 figure {
276 margin: 0;
277 }
278 figure blockquote {
279 margin: 0.8em 0.4em 0.4em;
280 }
281 figcaption {
282 font-style: italic;
283 margin: 0 0 1em 0;
284 }
285 @media screen {
286 pre {
287 overflow-x: auto;
288 max-width: 100%;
289 max-width: calc(100% - 22px);
290 }
291 }
292
293 /* aside, blockquote */
294 aside, blockquote {
295 margin-left: 0;
296 padding: 1.2em 2em;
297 }
298 blockquote {
299 background-color: #f9f9f9;
300 color: #111; /* Arlen: WCAG 2019 */
301 border: 1px solid #ddd;
302 border-radius: 3px;
303 margin: 1em 0;
304 }
305 cite {
306 display: block;
307 text-align: right;
308 font-style: italic;
309 }
310
311 /* tables */
312 table {
313 width: 100%;
314 margin: 0 0 1em;
315 border-collapse: collapse;
316 border: 1px solid #eee;
317 }
318 th, td {
319 text-align: left;
320 vertical-align: top;
321 padding: 0.5em 0.75em;
322 }
323 th {
324 text-align: left;
325 background-color: #e9e9e9;
326 }
327 tr:nth-child(2n+1) > td {
328 background-color: #f5f5f5;
329 }
330 table caption {
331 font-style: italic;
332 margin: 0;
333 padding: 0;
334 text-align: left;
335 }
336 table p {
337 /* XXX to avoid bottom margin on table row signifiers. If paragraphs should
338 be allowed within tables more generally, it would be far better to select on a class. */
339 margin: 0;
340 }
341
342 /* pilcrow */
343 a.pilcrow {
344 color: #666; /* Arlen: AHDJ 2019 */
345 text-decoration: none;
346 visibility: hidden;
347 user-select: none;
348 -ms-user-select: none;
349 -o-user-select:none;
350 -moz-user-select: none;
351 -khtml-user-select: none;
352 -webkit-user-select: none;
353 -webkit-touch-callout: none;
354 }
355 @media screen {
356 aside:hover > a.pilcrow,
357 p:hover > a.pilcrow,
358 blockquote:hover > a.pilcrow,
359 div:hover > a.pilcrow,
360 li:hover > a.pilcrow,
361 pre:hover > a.pilcrow {
362 visibility: visible;
363 }
364 a.pilcrow:hover {
365 background-color: transparent;
366 }
367 }
368
369 /* misc */
370 hr {
371 border: 0;
372 border-top: 1px solid #eee;
373 }
374 .bcp14 {
375 font-variant: small-caps;
376 }
377
378 .role {
379 font-variant: all-small-caps;
380 }
381
382 /* info block */
383 #identifiers {
384 margin: 0;
385 font-size: 0.9em;
386 }
387 #identifiers dt {
388 width: 3em;
389 clear: left;
390 }
391 #identifiers dd {
392 float: left;
393 margin-bottom: 0;
394 }
395 #identifiers .authors .author {
396 display: inline-block;
397 margin-right: 1.5em;
398 }
399 #identifiers .authors .org {
400 font-style: italic;
401 }
402
403 /* The prepared/rendered info at the very bottom of the page */
404 .docInfo {
405 color: #666; /* Arlen: WCAG 2019 */
406 font-size: 0.9em;
407 font-style: italic;
408 margin-top: 2em;
409 }
410 .docInfo .prepared {
411 float: left;
412 }
413 .docInfo .prepared {
414 float: right;
415 }
416
417 /* table of contents */
418 #toc {
419 padding: 0.75em 0 2em 0;
420 margin-bottom: 1em;
421 }
422 nav.toc ul {
423 margin: 0 0.5em 0 0;
424 padding: 0;
425 list-style: none;
426 }
427 nav.toc li {
428 line-height: 1.3em;
429 margin: 0.75em 0;
430 padding-left: 1.2em;
431 text-indent: -1.2em;
432 }
433 /* references */
434 .references dt {
435 text-align: right;
436 font-weight: bold;
437 min-width: 7em;
438 }
439 .references dd {
440 margin-left: 8em;
441 overflow: auto;
442 }
443
444 .refInstance {
445 margin-bottom: 1.25em;
446 }
447
448 .references .ascii {
449 margin-bottom: 0.25em;
450 }
451
452 /* index */
453 .index ul {
454 margin: 0 0 0 1em;
455 padding: 0;
456 list-style: none;
457 }
458 .index ul ul {
459 margin: 0;
460 }
461 .index li {
462 margin: 0;
463 text-indent: -2em;
464 padding-left: 2em;
465 padding-bottom: 5px;
466 }
467 .indexIndex {
468 margin: 0.5em 0 1em;
469 }
470 .index a {
471 font-weight: 700;
472 }
473 /* make the index two-column on all but the smallest screens */
474 @media (min-width: 600px) {
475 .index ul {
476 -moz-column-count: 2;
477 -moz-column-gap: 20px;
478 }
479 .index ul ul {
480 -moz-column-count: 1;
481 -moz-column-gap: 0;
482 }
483 }
484
485 /* authors */
486 address.vcard {
487 font-style: normal;
488 margin: 1em 0;
489 }
490
491 address.vcard .nameRole {
492 font-weight: 700;
493 margin-left: 0;
494 }
495 address.vcard .label {
496 font-family: "Noto Sans",Arial,Helvetica,sans-serif;
497 margin: 0.5em 0;
498 }
499 address.vcard .type {
500 display: none;
501 }
502 .alternative-contact {
503 margin: 1.5em 0 1em;
504 }
505 hr.addr {
506 border-top: 1px dashed;
507 margin: 0;
508 color: #ddd;
509 max-width: calc(100% - 16px);
510 }
511
512 /* temporary notes */
513 .rfcEditorRemove::before {
514 position: absolute;
515 top: 0.2em;
516 right: 0.2em;
517 padding: 0.2em;
518 content: "The RFC Editor will remove this note";
519 color: #9e2a00; /* Arlen: WCAG 2019 */
520 background-color: #ffd; /* Arlen: WCAG 2019 */
521 }
522 .rfcEditorRemove {
523 position: relative;
524 padding-top: 1.8em;
525 background-color: #ffd; /* Arlen: WCAG 2019 */
526 border-radius: 3px;
527 }
528 .cref {
529 background-color: #ffd; /* Arlen: WCAG 2019 */
530 padding: 2px 4px;
531 }
532 .crefSource {
533 font-style: italic;
534 }
535 /* alternative layout for smaller screens */
536 @media screen and (max-width: 1023px) {
537 body {
538 padding-top: 2em;
539 }
540 #title {
541 padding: 1em 0;
542 }
543 h1 {
544 font-size: 24px;
545 }
546 h2 {
547 font-size: 20px;
548 margin-top: -18px; /* provide offset for in-page anchors */
549 padding-top: 38px;
550 }
551 #identifiers dd {
552 max-width: 60%;
553 }
554 #toc {
555 position: fixed;
556 z-index: 2;
557 top: 0;
558 right: 0;
559 padding: 0;
560 margin: 0;
561 background-color: inherit;
562 border-bottom: 1px solid #ccc;
563 }
564 #toc h2 {
565 margin: -1px 0 0 0;
566 padding: 4px 0 4px 6px;
567 padding-right: 1em;
568 min-width: 190px;
569 font-size: 1.1em;
570 text-align: right;
571 background-color: #444;
572 color: white;
573 cursor: pointer;
574 }
575 #toc h2::before { /* css hamburger */
576 float: right;
577 position: relative;
578 width: 1em;
579 height: 1px;
580 left: -164px;
581 margin: 6px 0 0 0;
582 background: white none repeat scroll 0 0;
583 box-shadow: 0 4px 0 0 white, 0 8px 0 0 white;
584 content: "";
585 }
586 #toc nav {
587 display: none;
588 padding: 0.5em 1em 1em;
589 overflow: auto;
590 height: calc(100vh - 48px);
591 border-left: 1px solid #ddd;
592 }
593 }
594
595 /* alternative layout for wide screens */
596 @media screen and (min-width: 1024px) {
597 body {
598 max-width: 724px;
599 margin: 42px auto;
600 padding-left: 1.5em;
601 padding-right: 29em;
602 }
603 #toc {
604 position: fixed;
605 top: 42px;
606 right: 42px;
607 width: 25%;
608 margin: 0;
609 padding: 0 1em;
610 z-index: 1;
611 }
612 #toc h2 {
613 border-top: none;
614 border-bottom: 1px solid #ddd;
615 font-size: 1em;
616 font-weight: normal;
617 margin: 0;
618 padding: 0.25em 1em 1em 0;
619 }
620 #toc nav {
621 display: block;
622 height: calc(90vh - 84px);
623 bottom: 0;
624 padding: 0.5em 0 0;
625 overflow: auto;
626 }
627 img { /* future proofing */
628 max-width: 100%;
629 height: auto;
630 }
631 }
632
633 /* pagination */
634 @media print {
635 body {
636
637 width: 100%;
638 }
639 p {
640 orphans: 3;
641 widows: 3;
642 }
643 #n-copyright-notice {
644 border-bottom: none;
645 }
646 #toc, #n-introduction {
647 page-break-before: always;
648 }
649 #toc {
650 border-top: none;
651 padding-top: 0;
652 }
653 figure, pre {
654 page-break-inside: avoid;
655 }
656 figure {
657 overflow: scroll;
658 }
659 h1, h2, h3, h4, h5, h6 {
660 page-break-after: avoid;
661 }
662 h2+*, h3+*, h4+*, h5+*, h6+* {
663 page-break-before: avoid;
664 }
665 pre {
666 white-space: pre-wrap;
667 word-wrap: break-word;
668 font-size: 10pt;
669 }
670 table {
671 border: 1px solid #ddd;
672 }
673 td {
674 border-top: 1px solid #ddd;
675 }
676 }
677
678 /* This is commented out here, as the string-set: doesn't
679 pass W3C validation currently */
680 /*
681 .ears thead .left {
682 string-set: ears-top-left content();
683 }
684
685 .ears thead .center {
686 string-set: ears-top-center content();
687 }
688
689 .ears thead .right {
690 string-set: ears-top-right content();
691 }
692
693 .ears tfoot .left {
694 string-set: ears-bottom-left content();
695 }
696
697 .ears tfoot .center {
698 string-set: ears-bottom-center content();
699 }
700
701 .ears tfoot .right {
702 string-set: ears-bottom-right content();
703 }
704 */
705
706 @page :first {
707 padding-top: 0;
708 @top-left {
709 content: normal;
710 border: none;
711 }
712 @top-center {
713 content: normal;
714 border: none;
715 }
716 @top-right {
717 content: normal;
718 border: none;
719 }
720 }
721
722 @page {
723 size: A4;
724 margin-bottom: 45mm;
725 padding-top: 20px;
726 /* The follwing is commented out here, but set appropriately by in code, as
727 the content depends on the document */
728 /*
729 @top-left {
730 content: 'Internet-Draft';
731 vertical-align: bottom;
732 border-bottom: solid 1px #ccc;
733 }
734 @top-left {
735 content: string(ears-top-left);
736 vertical-align: bottom;
737 border-bottom: solid 1px #ccc;
738 }
739 @top-center {
740 content: string(ears-top-center);
741 vertical-align: bottom;
742 border-bottom: solid 1px #ccc;
743 }
744 @top-right {
745 content: string(ears-top-right);
746 vertical-align: bottom;
747 border-bottom: solid 1px #ccc;
748 }
749 @bottom-left {
750 content: string(ears-bottom-left);
751 vertical-align: top;
752 border-top: solid 1px #ccc;
753 }
754 @bottom-center {
755 content: string(ears-bottom-center);
756 vertical-align: top;
757 border-top: solid 1px #ccc;
758 }
759 @bottom-right {
760 content: '[Page ' counter(page) ']';
761 vertical-align: top;
762 border-top: solid 1px #ccc;
763 }
764 */
765
766 }
767
768 /* Changes introduced to fix issues found during implementation */
769 /* Make sure links are clickable even if overlapped by following H* */
770 a {
771 z-index: 2;
772 }
773 /* Separate body from document info even without intervening H1 */
774 section {
775 clear: both;
776 }
777
778
779 /* Top align author divs, to avoid names without organization dropping level with org names */
780 .author {
781 vertical-align: top;
782 }
783
784 /* Leave room in document info to show Internet-Draft on one line */
785 #identifiers dt {
786 width: 8em;
787 }
788
789 /* Don't waste quite as much whitespace between label and value in doc info */
790 #identifiers dd {
791 margin-left: 1em;
792 }
793
794 /* Give floating toc a background color (needed when it's a div inside section */
795 #toc {
796 background-color: white;
797 }
798
799 /* Make the collapsed ToC header render white on gray also when it's a link */
800 @media screen and (max-width: 1023px) {
801 #toc h2 a,
802 #toc h2 a:link,
803 #toc h2 a:focus,
804 #toc h2 a:hover,
805 #toc a.toplink,
806 #toc a.toplink:hover {
807 color: white;
808 background-color: #444;
809 text-decoration: none;
810 }
811 }
812
813 /* Give the bottom of the ToC some whitespace */
814 @media screen and (min-width: 1024px) {
815 #toc {
816 padding: 0 0 1em 1em;
817 }
818 }
819
820 /* Style section numbers with more space between number and title */
821 .section-number {
822 padding-right: 0.5em;
823 }
824
825 /* prevent monospace from becoming overly large */
826 tt, code, pre, code {
827 font-size: 95%;
828 }
829
830 /* Fix the height/width aspect for ascii art*/
831 pre.sourcecode,
832 .art-text pre {
833 line-height: 1.12;
834 }
835
836
837 /* Add styling for a link in the ToC that points to the top of the document */
838 a.toplink {
839 float: right;
840 margin-right: 0.5em;
841 }
842
843 /* Fix the dl styling to match the RFC 7992 attributes */
844 dl > dt,
845 dl.dlParallel > dt {
846 float: left;
847 margin-right: 1em;
848 }
849 dl.dlNewline > dt {
850 float: none;
851 }
852
853 /* Provide styling for table cell text alignment */
854 table td.text-left,
855 table th.text-left {
856 text-align: left;
857 }
858 table td.text-center,
859 table th.text-center {
860 text-align: center;
861 }
862 table td.text-right,
863 table th.text-right {
864 text-align: right;
865 }
866
867 /* Make the alternative author contact informatio look less like just another
868 author, and group it closer with the primary author contact information */
869 .alternative-contact {
870 margin: 0.5em 0 0.25em 0;
871 }
872 address .non-ascii {
873 margin: 0 0 0 2em;
874 }
875
876 /* With it being possible to set tables with alignment
877 left, center, and right, { width: 100%; } does not make sense */
878 table {
879 width: auto;
880 }
881
882 /* Avoid reference text that sits in a block with very wide left margin,
883 because of a long floating dt label.*/
884 .references dd {
885 overflow: visible;
886 }
887
888 /* Control caption placement */
889 caption {
890 caption-side: bottom;
891 }
892
893 /* Limit the width of the author address vcard, so names in right-to-left
894 script don't end up on the other side of the page. */
895
896 address.vcard {
897 max-width: 30em;
898 margin-right: auto;
899 }
900
901 /* For address alignment dependent on LTR or RTL scripts */
902 address div.left {
903 text-align: left;
904 }
905 address div.right {
906 text-align: right;
907 }
908
909 /* Provide table alignment support. We can't use the alignX classes above
910 since they do unwanted things with caption and other styling. */
911 table.right {
912 margin-left: auto;
913 margin-right: 0;
914 }
915 table.center {
916 margin-left: auto;
917 margin-right: auto;
918 }
919 table.left {
920 margin-left: 0;
921 margin-right: auto;
922 }
923
924 /* Give the table caption label the same styling as the figcaption */
925 caption a[href] {
926 color: #222;
927 }
928
929 @media print {
930 .toplink {
931 display: none;
932 }
933
934 /* avoid overwriting the top border line with the ToC header */
935 #toc {
936 padding-top: 1px;
937 }
938
939 /* Avoid page breaks inside dl and author address entries */
940 .vcard {
941 page-break-inside: avoid;
942 }
943
944 }
945 /* Tweak the bcp14 keyword presentation */
946 .bcp14 {
947 font-variant: small-caps;
948 font-weight: bold;
949 font-size: 0.9em;
950 }
951 /* Tweak the invisible space above H* in order not to overlay links in text above */
952 h2 {
953 margin-top: -18px; /* provide offset for in-page anchors */
954 padding-top: 31px;
955 }
956 h3 {
957 margin-top: -18px; /* provide offset for in-page anchors */
958 padding-top: 24px;
959 }
960 h4 {
961 margin-top: -18px; /* provide offset for in-page anchors */
962 padding-top: 24px;
963 }
964 /* Float artwork pilcrow to the right */
965 @media screen {
966 .artwork a.pilcrow {
967 display: block;
968 line-height: 0.7;
969 margin-top: 0.15em;
970 }
971 }
972 /* Make pilcrows on dd visible */
973 @media screen {
974 dd:hover > a.pilcrow {
975 visibility: visible;
976 }
977 }
978 /* Make the placement of figcaption match that of a table's caption
979 by removing the figure's added bottom margin */
980 .alignLeft.art-text,
981 .alignCenter.art-text,
982 .alignRight.art-text {
983 margin-bottom: 0;
984 }
985 .alignLeft,
986 .alignCenter,
987 .alignRight {
988 margin: 1em 0 0 0;
989 }
990 /* In print, the pilcrow won't show on hover, so prevent it from taking up space,
991 possibly even requiring a new line */
992 @media print {
993 a.pilcrow {
994 display: none;
995 }
996 }
997 /* Styling for the external metadata */
998 div#external-metadata {
999 background-color: #eee;
1000 padding: 0.5em;
1001 margin-bottom: 0.5em;
1002 display: none;
1003 }
1004 div#internal-metadata {
1005 padding: 0.5em; /* to match the external-metadata padding */
1006 }
1007 /* Styling for title RFC Number */
1008 h1#rfcnum {
1009 clear: both;
1010 margin: 0 0 -1em;
1011 padding: 1em 0 0 0;
1012 }
1013 /* Make .olPercent look the same as <ol><li> */
1014 dl.olPercent > dd {
1015 margin-bottom: 0.25em;
1016 min-height: initial;
1017 }
1018 /* Give aside some styling to set it apart */
1019 aside {
1020 border-left: 1px solid #ddd;
1021 margin: 1em 0 1em 2em;
1022 padding: 0.2em 2em;
1023 }
1024 aside > dl,
1025 aside > ol,
1026 aside > ul,
1027 aside > table,
1028 aside > p {
1029 margin-bottom: 0.5em;
1030 }
1031 /* Additional page break settings */
1032 @media print {
1033 figcaption, table caption {
1034 page-break-before: avoid;
1035 }
1036 }
1037 /* Font size adjustments for print */
1038 @media print {
1039 body { font-size: 10pt; line-height: normal; max-width: 96%; }
1040 h1 { font-size: 1.72em; padding-top: 1.5em; } /* 1*1.2*1.2*1.2 */
1041 h2 { font-size: 1.44em; padding-top: 1.5em; } /* 1*1.2*1.2 */
1042 h3 { font-size: 1.2em; padding-top: 1.5em; } /* 1*1.2 */
1043 h4 { font-size: 1em; padding-top: 1.5em; }
1044 h5, h6 { font-size: 1em; margin: initial; padding: 0.5em 0 0.3em; }
1045 }
1046 /* Sourcecode margin in print, when there's no pilcrow */
1047 @media print {
1048 .artwork,
1049 .sourcecode {
1050 margin-bottom: 1em;
1051 }
1052 }
1053 /* Avoid narrow tables forcing too narrow table captions, which may render badly */
1054 table {
1055 min-width: 20em;
1056 }
1057 /* ol type a */
1058 ol.type-a { list-style-type: lower-alpha; }
1059 ol.type-A { list-style-type: upper-alpha; }
1060 ol.type-i { list-style-type: lower-roman; }
1061 ol.type-I { list-style-type: lower-roman; }
1062 /* Apply the print table and row borders in general, on request from the RPC,
1063 and increase the contrast between border and odd row background sligthtly */
1064 table {
1065 border: 1px solid #ddd;
1066 }
1067 td {
1068 border-top: 1px solid #ddd;
1069 }
1070 tr:nth-child(2n+1) > td {
1071 background-color: #f8f8f8;
1072 }
1073 /* Use style rules to govern display of the TOC. */
1074 @media screen and (max-width: 1023px) {
1075 #toc nav { display: none; }
1076 #toc.active nav { display: block; }
1077 }
1078 /* Add support for keepWithNext */
1079 .keepWithNext {
1080 break-after: avoid-page;
1081 break-after: avoid-page;
1082 }
1083 /* Add support for keepWithPrevious */
1084 .keepWithPrevious {
1085 break-before: avoid-page;
1086 }
1087 /* Change the approach to avoiding breaks inside artwork etc. */
1088 figure, pre, table, .artwork, .sourcecode {
1089 break-before: avoid-page;
1090 break-after: auto;
1091 }
1092 /* Avoid breaks between <dt> and <dd> */
1093 dl {
1094 break-before: auto;
1095 break-inside: auto;
1096 }
1097 dt {
1098 break-before: auto;
1099 break-after: avoid-page;
1100 }
1101 dd {
1102 break-before: avoid-page;
1103 break-after: auto;
1104 orphans: 3;
1105 widows: 3
1106 }
1107 span.break, dd.break {
1108 margin-bottom: 0;
1109 min-height: 0;
1110 break-before: auto;
1111 break-inside: auto;
1112 break-after: auto;
1113 }
1114 /* Undo break-before ToC */
1115 @media print {
1116 #toc {
1117 break-before: auto;
1118 }
1119 }
1120 /* Text in compact lists should not get extra bottim margin space,
1121 since that would makes the list not compact */
1122 ul.compact p, .ulCompact p,
1123 ol.compact p, .olCompact p {
1124 margin: 0;
1125 }
1126 /* But the list as a whole needs the extra space at the end */
1127 section ul.compact,
1128 section .ulCompact,
1129 section ol.compact,
1130 section .olCompact {
1131 margin-bottom: 1em; /* same as p not within ul.compact etc. */
1132 }
1133 /* The tt and code background above interferes with for instance table cell
1134 backgrounds. Changed to something a bit more selective. */
1135 tt, code {
1136 background-color: transparent;
1137 }
1138 p tt, p code, li tt, li code {
1139 background-color: #f8f8f8;
1140 }
1141 /* Tweak the pre margin -- 0px doesn't come out well */
1142 pre {
1143 margin-top: 0.5px;
1144 }
1145 /* Tweak the comact list text */
1146 ul.compact, .ulCompact,
1147 ol.compact, .olCompact,
1148 dl.compact, .dlCompact {
1149 line-height: normal;
1150 }
1151 /* Don't add top margin for nested lists */
1152 li > ul, li > ol, li > dl,
1153 dd > ul, dd > ol, dd > dl,
1154 dl > dd > dl {
1155 margin-top: initial;
1156 }
1157 /* Elements that should not be rendered on the same line as a <dt> */
1158 /* This should match the element list in writer.text.TextWriter.render_dl() */
1159 dd > div.artwork:first-child,
1160 dd > aside:first-child,
1161 dd > figure:first-child,
1162 dd > ol:first-child,
1163 dd > div:first-child > pre.sourcecode,
1164 dd > table:first-child,
1165 dd > ul:first-child {
1166 clear: left;
1167 }
1168 /* fix for weird browser behaviour when <dd/> is empty */
1169 dt+dd:empty::before{
1170 content: "\00a0";
1171 }
1172 /* Make paragraph spacing inside <li> smaller than in body text, to fit better within the list */
1173 li > p {
1174 margin-bottom: 0.5em
1175 }
1176 /* Don't let p margin spill out from inside list items */
1177 li > p:last-of-type {
1178 margin-bottom: 0;
1179 }
1180 </style>
1181 <link href="rfc-local.css" rel="stylesheet" type="text/css">
1182 <link href="https://dx.doi.org/10.17487/rfc9108" rel="alternate">
1183 <link href="urn:issn:2070-1721" rel="alternate">
1184 <link href="https://datatracker.ietf.org/doc/draft-ietf-dnsop-iana-class-type-yang-05" rel="prev">
1185 </head>
1186 <body>
1187 <script src="https://www.rfc-editor.org/js/metadata.min.js"></script>
1188 <table class="ears">
1189 <thead><tr>
1190 <td class="left">RFC 9108</td>
1191 <td class="center">YANG Types for DNS and RR</td>
1192 <td class="right">September 2021</td>
1193 </tr></thead>
1194 <tfoot><tr>
1195 <td class="left">Lhotka &amp; Špaček</td>
1196 <td class="center">Standards Track</td>
1197 <td class="right">[Page]</td>
1198 </tr></tfoot>
1199 </table>
1200 <div id="external-metadata" class="document-information"></div>
1201 <div id="internal-metadata" class="document-information">
1202 <dl id="identifiers">
1203 <dt class="label-stream">Stream:</dt>
1204 <dd class="stream">Internet Engineering Task Force (IETF)</dd>
1205 <dt class="label-rfc">RFC:</dt>
1206 <dd class="rfc"><a href="https://www.rfc-editor.org/rfc/rfc9108" class="eref">9108</a></dd>
1207 <dt class="label-category">Category:</dt>
1208 <dd class="category">Standards Track</dd>
1209 <dt class="label-published">Published:</dt>
1210 <dd class="published">
1211 <time datetime="2021-09" class="published">September 2021</time>
1212 </dd>
1213 <dt class="label-issn">ISSN:</dt>
1214 <dd class="issn">2070-1721</dd>
1215 <dt class="label-authors">Authors:</dt>
1216 <dd class="authors">
1217 <div class="author">
1218 <div class="author-name">L. Lhotka</div>
1219 <div class="org">CZ.NIC</div>
1220 </div>
1221 <div class="author">
1222 <div class="author-name">P. Špaček</div>
1223 <div class="org">Internet Systems Consortium</div>
1224 </div>
1225 </dd>
1226 </dl>
1227 </div>
1228 <h1 id="rfcnum">RFC 9108</h1>
1229 <h1 id="title">YANG Types for DNS Classes and Resource Record Types</h1>
1230 <section id="section-abstract">
1231 <h2 id="abstract"><a href="#abstract" class="selfRef">Abstract</a></h2>
1232 <p id="section-abstract-1">This document introduces the YANG
1233 module "iana-dns-class-rr-type", which contains derived types
1234 reflecting two IANA registries: DNS CLASSes and Resource Record
1235 (RR) TYPEs. These YANG types are intended as the minimum basis for
1236 future data modeling work.<a href="#section-abstract-1" class="pilcrow">¶</a></p>
1237 </section>
1238 <div id="status-of-memo">
1239 <section id="section-boilerplate.1">
1240 <h2 id="name-status-of-this-memo">
1241 <a href="#name-status-of-this-memo" class="section-name selfRef">Status of This Memo</a>
1242 </h2>
1243 <p id="section-boilerplate.1-1">
1244 This is an Internet Standards Track document.<a href="#section-boilerplate.1-1" class="pilcrow">¶</a></p>
1245 <p id="section-boilerplate.1-2">
1246 This document is a product of the Internet Engineering Task Force
1247 (IETF). It represents the consensus of the IETF community. It has
1248 received public review and has been approved for publication by
1249 the Internet Engineering Steering Group (IESG). Further
1250 information on Internet Standards is available in Section 2 of
1251 RFC 7841.<a href="#section-boilerplate.1-2" class="pilcrow">¶</a></p>
1252 <p id="section-boilerplate.1-3">
1253 Information about the current status of this document, any
1254 errata, and how to provide feedback on it may be obtained at
1255 <span><a href="https://www.rfc-editor.org/info/rfc9108">https://www.rfc-editor.org/info/rfc9108</a></span>.<a href="#section-boilerplate.1-3" class="pilcrow">¶</a></p>
1256 </section>
1257 </div>
1258 <div id="copyright">
1259 <section id="section-boilerplate.2">
1260 <h2 id="name-copyright-notice">
1261 <a href="#name-copyright-notice" class="section-name selfRef">Copyright Notice</a>
1262 </h2>
1263 <p id="section-boilerplate.2-1">
1264 Copyright (c) 2021 IETF Trust and the persons identified as the
1265 document authors. All rights reserved.<a href="#section-boilerplate.2-1" class="pilcrow">¶</a></p>
1266 <p id="section-boilerplate.2-2">
1267 This document is subject to BCP 78 and the IETF Trust's Legal
1268 Provisions Relating to IETF Documents
1269 (<span><a href="https://trustee.ietf.org/license-info">https://trustee.ietf.org/license-info</a></span>) in effect on the date of
1270 publication of this document. Please review these documents
1271 carefully, as they describe your rights and restrictions with
1272 respect to this document. Code Components extracted from this
1273 document must include Simplified BSD License text as described in
1274 Section 4.e of the Trust Legal Provisions and are provided without
1275 warranty as described in the Simplified BSD License.<a href="#section-boilerplate.2-2" class="pilcrow">¶</a></p>
1276 </section>
1277 </div>
1278 <div id="toc">
1279 <section id="section-toc.1">
1280 <a href="#" onclick="scroll(0,0)" class="toplink">▲</a><h2 id="name-table-of-contents">
1281 <a href="#name-table-of-contents" class="section-name selfRef">Table of Contents</a>
1282 </h2>
1283 <nav class="toc"><ul class="ulBare toc compact ulEmpty">
1284 <li class="ulBare toc compact ulEmpty" id="section-toc.1-1.1">
1285 <p id="section-toc.1-1.1.1" class="keepWithNext"><a href="#section-1" class="xref">1</a>.  <a href="#name-introduction" class="xref">Introduction</a></p>
1286 </li>
1287 <li class="ulBare toc compact ulEmpty" id="section-toc.1-1.2">
1288 <p id="section-toc.1-1.2.1" class="keepWithNext"><a href="#section-2" class="xref">2</a>.  <a href="#name-terminology" class="xref">Terminology</a></p>
1289 </li>
1290 <li class="ulBare toc compact ulEmpty" id="section-toc.1-1.3">
1291 <p id="section-toc.1-1.3.1" class="keepWithNext"><a href="#section-3" class="xref">3</a>.  <a href="#name-yang-design-considerations" class="xref">YANG Design Considerations</a></p>
1292 </li>
1293 <li class="ulBare toc compact ulEmpty" id="section-toc.1-1.4">
1294 <p id="section-toc.1-1.4.1"><a href="#section-4" class="xref">4</a>.  <a href="#name-iana-considerations" class="xref">IANA Considerations</a></p>
1295 <ul class="compact ulBare toc ulEmpty">
1296 <li class="compact ulBare toc ulEmpty" id="section-toc.1-1.4.2.1">
1297 <p id="section-toc.1-1.4.2.1.1"><a href="#section-4.1" class="xref">4.1</a>.  <a href="#name-uri-registrations" class="xref">URI Registrations</a></p>
1298 </li>
1299 <li class="compact ulBare toc ulEmpty" id="section-toc.1-1.4.2.2">
1300 <p id="section-toc.1-1.4.2.2.1"><a href="#section-4.2" class="xref">4.2</a>.  <a href="#name-yang-module-registrations" class="xref">YANG Module Registrations</a></p>
1301 </li>
1302 </ul>
1303 </li>
1304 <li class="ulBare toc compact ulEmpty" id="section-toc.1-1.5">
1305 <p id="section-toc.1-1.5.1"><a href="#section-5" class="xref">5</a>.  <a href="#name-security-considerations" class="xref">Security Considerations</a></p>
1306 </li>
1307 <li class="ulBare toc compact ulEmpty" id="section-toc.1-1.6">
1308 <p id="section-toc.1-1.6.1"><a href="#section-6" class="xref">6</a>.  <a href="#name-references" class="xref">References</a></p>
1309 <ul class="compact ulBare toc ulEmpty">
1310 <li class="compact ulBare toc ulEmpty" id="section-toc.1-1.6.2.1">
1311 <p id="section-toc.1-1.6.2.1.1"><a href="#section-6.1" class="xref">6.1</a>.  <a href="#name-normative-references" class="xref">Normative References</a></p>
1312 </li>
1313 <li class="compact ulBare toc ulEmpty" id="section-toc.1-1.6.2.2">
1314 <p id="section-toc.1-1.6.2.2.1"><a href="#section-6.2" class="xref">6.2</a>.  <a href="#name-informative-references" class="xref">Informative References</a></p>
1315 </li>
1316 </ul>
1317 </li>
1318 <li class="ulBare toc compact ulEmpty" id="section-toc.1-1.7">
1319 <p id="section-toc.1-1.7.1"><a href="#appendix-A" class="xref">Appendix A</a>.  <a href="#name-xslt-stylesheet" class="xref">XSLT Stylesheet</a></p>
1320 </li>
1321 <li class="ulBare toc compact ulEmpty" id="section-toc.1-1.8">
1322 <p id="section-toc.1-1.8.1"><a href="#appendix-B" class="xref"></a><a href="#name-authors-addresses" class="xref">Authors' Addresses</a></p>
1323 </li>
1324 </ul>
1325 </nav>
1326 </section>
1327 </div>
1328 <div id="introduction">
1329 <section id="section-1">
1330 <h2 id="name-introduction">
1331 <a href="#section-1" class="section-number selfRef">1. </a><a href="#name-introduction" class="section-name selfRef">Introduction</a>
1332 </h2>
1333 <p id="section-1-1">YANG <span>[<a href="#RFC7950" class="xref">RFC7950</a>]</span> has become a de facto standard
1334 as a language for modeling configuration and state data, as well
1335 as specifying management operations and asynchronous
1336 notifications. It is reasonable to expect that the approach
1337 based on utilizing such data models along with standard
1338 management protocols such as NETCONF <span>[<a href="#RFC6241" class="xref">RFC6241</a>]</span>
1339 and RESTCONF <span>[<a href="#RFC8040" class="xref">RFC8040</a>]</span> can be effectively used in
1340 DNS operations, too. In fact, several efforts are currently
1341 underway that attempt to use NETCONF or RESTCONF for configuring
1342 and managing<a href="#section-1-1" class="pilcrow">¶</a></p>
1343 <ul class="normal">
1344 <li class="normal" id="section-1-2.1">authoritative servers,<a href="#section-1-2.1" class="pilcrow">¶</a>
1345 </li>
1346 <li class="normal" id="section-1-2.2">resolvers, and<a href="#section-1-2.2" class="pilcrow">¶</a>
1347 </li>
1348 <li class="normal" id="section-1-2.3">zone data.<a href="#section-1-2.3" class="pilcrow">¶</a>
1349 </li>
1350 </ul>
1351 <p id="section-1-3">While it is possible to use the management protocols
1352 mentioned above with ad hoc or proprietary data models, their
1353 real potential can be realized only if there is a (completely or
1354 partly) unified data model supported by multiple DNS software
1355 implementations. Operators can then, for instance, run several
1356 DNS server implementations in parallel, and use a common
1357 configuration and management interface and data for all of
1358 them. Also, it becomes considerably easier to migrate to another
1359 implementation.<a href="#section-1-3" class="pilcrow">¶</a></p>
1360 <p id="section-1-4">Based on the previous experience from the IETF Routing Area,
1361 it is to be expected that the development of unified data models
1362 for DNS will be a lengthy and complicated process that will
1363 require active cooperation and compromise from the vendors and
1364 developers of major DNS server platforms. Nevertheless, it is
1365 likely that any DNS-related data modeling effort will need to
1366 use various DNS parameters and enumerations that are specified
1367 in several IANA registries. For use with YANG, these parameters
1368 and enumerations have to be translated into corresponding YANG
1369 types or other structures. Such translations should be
1370 straightforward and relatively uncontroversial.<a href="#section-1-4" class="pilcrow">¶</a></p>
1371 <p id="section-1-5">This document provides a translation of two fundamental
1372 DNS-related IANA registries to YANG. It contains the initial
1373 version of the YANG module "iana-dns-class-rr-type", which
1374 defines derived types for the common parameters of DNS resource
1375 records (RR): class and type. These YANG types, "dns-class" and
1376 "rr-type", reflect the IANA registries "DNS CLASSes" and
1377 "Resource Record (RR) TYPEs" <span>[<a href="#IANA-DNS-PARAMETERS" class="xref">IANA-DNS-PARAMETERS</a>]</span>.<a href="#section-1-5" class="pilcrow">¶</a></p>
1378 <p id="section-1-6"><a href="#app.xslt" class="xref">Appendix A</a> contains an XSLT 1.0 stylesheet
1379 that is intended to be used by IANA for generating the initial
1380 version of the "iana-dns-class-rr-type" YANG
1381 module. Subsequently, whenever a new class or RR type is added
1382 to the above registries, IANA will also update the
1383 "iana-dns-class-rr-type" YANG module, following the instructions
1384 in <a href="#iana" class="xref">Section 4</a> below.<a href="#section-1-6" class="pilcrow">¶</a></p>
1385 </section>
1386 </div>
1387 <div id="terminology">
1388 <section id="section-2">
1389 <h2 id="name-terminology">
1390 <a href="#section-2" class="section-number selfRef">2. </a><a href="#name-terminology" class="section-name selfRef">Terminology</a>
1391 </h2>
1392 <p id="section-2-1">
1393 The key words "<span class="bcp14">MUST</span>", "<span class="bcp14">MUST NOT</span>", "<span class="bcp14">REQUIRED</span>", "<span class="bcp14">SHALL</span>", "<span class="bcp14">SHALL NOT</span>", "<span class="bcp14">SHOULD</span>", "<span class="bcp14">SHOULD NOT</span>", "<span class="bcp14">RECOMMENDED</span>", "<span class="bcp14">NOT RECOMMENDED</span>",
1394 "<span class="bcp14">MAY</span>", and "<span class="bcp14">OPTIONAL</span>" in this document are to be interpreted as
1395 described in BCP 14 <span>[<a href="#RFC2119" class="xref">RFC2119</a>]</span> <span>[<a href="#RFC8174" class="xref">RFC8174</a>]</span>
1396 when, and only when, they appear in all capitals, as shown here.<a href="#section-2-1" class="pilcrow">¶</a></p>
1397 <p id="section-2-2">The terminology for describing YANG data models can be found
1398 in <span>[<a href="#RFC7950" class="xref">RFC7950</a>]</span>. DNS terminology used in this
1399 document can be found in <span>[<a href="#RFC1035" class="xref">RFC1035</a>]</span> and <span>[<a href="#RFC8499" class="xref">RFC8499</a>]</span>.<a href="#section-2-2" class="pilcrow">¶</a></p>
1400 </section>
1401 </div>
1402 <div id="design">
1403 <section id="section-3">
1404 <h2 id="name-yang-design-considerations">
1405 <a href="#section-3" class="section-number selfRef">3. </a><a href="#name-yang-design-considerations" class="section-name selfRef">YANG Design Considerations</a>
1406 </h2>
1407 <p id="section-3-1">At the time of writing, the "Domain Name System
1408 (DNS) Parameters" <span>[<a href="#IANA-DNS-PARAMETERS" class="xref">IANA-DNS-PARAMETERS</a>]</span> contains
1409 altogether thirteen registries. The YANG module
1410 "iana-dns-class-rr-type" defines derived types corresponding to
1411 only two of the registries that are essential for data models
1412 involving zone data, namely "DNS CLASSes" and "Resource Record
1413 (RR) TYPEs". It is expected that the remaining registries in
1414 <span>[<a href="#IANA-DNS-PARAMETERS" class="xref">IANA-DNS-PARAMETERS</a>]</span>, as well as other
1415 DNS-related IANA registries, will be analogously reflected in
1416 future YANG modules as necessary. This way, an appropriate
1417 combination of YANG modules can be chosen depending on which
1418 YANG types are needed for a given data modeling purpose.<a href="#section-3-1" class="pilcrow">¶</a></p>
1419 <p id="section-3-2">The registries "DNS CLASSes" and "Resource Record (RR) TYPEs"
1420 are transformed into YANG enumeration types "dns-class-name" and
1421 "rr-type-name", respectively. This is the initial fragment of
1422 the former:<a href="#section-3-2" class="pilcrow">¶</a></p>
1423 <div id="section-3-3">
1424 <pre class="sourcecode lang-yang">
1425 typedef dns-class-name {
1426 type enumeration {
1427 enum IN {
1428 value 1;
1429 description
1430 "Internet (IN)";
1431 reference
1432 "RFC 1035";
1433 }
1434 ...
1435 }
1436 ...
1437 }
1438 </pre><a href="#section-3-3" class="pilcrow">¶</a>
1439 </div>
1440 <p id="section-3-4">The other derived type, "rr-type-name", is defined
1441 similarly.<a href="#section-3-4" class="pilcrow">¶</a></p>
1442 <p id="section-3-5"><span>[<a href="#RFC3597" class="xref">RFC3597</a>]</span> introduced the option of specifying
1443 a class or RR type via its assigned decimal number as an
1444 alternative to the mnemonic name. For example, the "IN" class
1445 can be equivalently written as "CLASS1", and "AAAA" type can be
1446 written as "TYPE28".<a href="#section-3-5" class="pilcrow">¶</a></p>
1447 <p id="section-3-6">Accordingly, the derived types "dns-class" and "rr-type" are
1448 defined in the YANG module as a union of two member types:<a href="#section-3-6" class="pilcrow">¶</a></p>
1449 <ul class="normal">
1450 <li class="normal" id="section-3-7.1">16-bit decimal integer ("uint16")<a href="#section-3-7.1" class="pilcrow">¶</a>
1451 </li>
1452 <li class="normal" id="section-3-7.2">mnemonic name belonging to the enumerations
1453 "dns-class-name" and "rr-type-name", respectively.<a href="#section-3-7.2" class="pilcrow">¶</a>
1454 </li>
1455 </ul>
1456 <p id="section-3-8">For instance, the "rr-type" type is defined as follows:<a href="#section-3-8" class="pilcrow">¶</a></p>
1457 <div id="section-3-9">
1458 <pre class="sourcecode lang-yang">
1459 typedef rr-type {
1460 type union {
1461 type uint16;
1462 type rr-type-name;
1463 }
1464 description
1465 "This type allows reference to a DNS resource record type
1466 using either the assigned mnemonic name or numeric value.";
1467 }
1468 </pre><a href="#section-3-9" class="pilcrow">¶</a>
1469 </div>
1470 <p id="section-3-10">As unassigned and reserved class and RR type values are not
1471 included in the mnemonic name enumerations, they can only be specified
1472 using their decimal values.<a href="#section-3-10" class="pilcrow">¶</a></p>
1473 </section>
1474 </div>
1475 <div id="iana">
1476 <section id="section-4">
1477 <h2 id="name-iana-considerations">
1478 <a href="#section-4" class="section-number selfRef">4. </a><a href="#name-iana-considerations" class="section-name selfRef">IANA Considerations</a>
1479 </h2>
1480 <p id="section-4-1">This section deals with actions and processes necessary for
1481 IANA to undertake to maintain the "iana-dns-class-rr-type" YANG
1482 module. This YANG module is intended to reflect the "DNS
1483 CLASSes" and "Resource Record (RR) TYPEs" registries in <span>[<a href="#IANA-DNS-PARAMETERS" class="xref">IANA-DNS-PARAMETERS</a>]</span>. The most recent version of the
1484 YANG module is available from the "YANG Parameters" registry <span>[<a href="#IANA-YANG-PARAMETERS" class="xref">IANA-YANG-PARAMETERS</a>]</span>.<a href="#section-4-1" class="pilcrow">¶</a></p>
1485 <p id="section-4-2">With the publication of this document, IANA has created and posted the initial version
1486 of the "iana-dns-class-rr-type" YANG module by applying the XSLT stylesheet from
1487 <a href="#app.xslt" class="xref">Appendix A</a> to the XML version of <span>[<a href="#IANA-DNS-PARAMETERS" class="xref">IANA-DNS-PARAMETERS</a>]</span>.<a href="#section-4-2" class="pilcrow">¶</a></p>
1488 <p id="section-4-3">IANA has added this note to the "iana-dns-class-rr-type" item
1489 of the "YANG Module Names" registry <span>[<a href="#IANA-YANG-PARAMETERS" class="xref">IANA-YANG-PARAMETERS</a>]</span>:<a href="#section-4-3" class="pilcrow">¶</a></p>
1490 <blockquote id="section-4-4">
1491 Classes and types of DNS resource records must not be directly
1492 added to the "iana-dns-class-rr-type" YANG module. They must
1493 instead be added to the "DNS CLASSes" and "Resource Record
1494 (RR) TYPEs" registries, respectively.<a href="#section-4-4" class="pilcrow">¶</a>
1495 </blockquote>
1496 <p id="section-4-5">When a new DNS class or RR type is added to the "DNS CLASSes"
1497 or "Resource Record (RR) TYPEs" registry, a new "enum" statement
1498 <span class="bcp14">SHALL</span> be added to the "dns-class-name" or "rr-type-name" type,
1499 respectively. The assigned name defined by the "enum" statement
1500 <span class="bcp14">SHALL</span> be the same as the mnemonic name of the new class or
1501 type. The following substatements to the "enum" statement <span class="bcp14">SHALL</span>
1502 be defined:<a href="#section-4-5" class="pilcrow">¶</a></p>
1503 <span class="break"></span><dl class="dlParallel" id="section-4-6">
1504 <dt id="section-4-6.1">"value":</dt>
1505 <dd style="margin-left: 8.0em" id="section-4-6.2">Use the decimal value from the registry.<a href="#section-4-6.2" class="pilcrow">¶</a>
1506 </dd>
1507 <dd class="break"></dd>
1508 <dt id="section-4-6.3">"status":</dt>
1509 <dd style="margin-left: 8.0em" id="section-4-6.4">Include only if a class or type registration has been
1510 deprecated or obsoleted. IANA "deprecated" maps to YANG status
1511 "deprecated", and IANA "obsolete" maps to YANG status "obsolete".<a href="#section-4-6.4" class="pilcrow">¶</a>
1512 </dd>
1513 <dd class="break"></dd>
1514 <dt id="section-4-6.5">"description":</dt>
1515 <dd style="margin-left: 8.0em" id="section-4-6.6">Replicate the corresponding information from the registry,
1516 namely the full name of the new DNS class, or the meaning of
1517 the new RR type, if any.<a href="#section-4-6.6" class="pilcrow">¶</a>
1518 </dd>
1519 <dd class="break"></dd>
1520 <dt id="section-4-6.7">"reference":</dt>
1521 <dd style="margin-left: 8.0em" id="section-4-6.8">Replicate the reference(s) from the registry.<a href="#section-4-6.8" class="pilcrow">¶</a>
1522 </dd>
1523 <dd class="break"></dd>
1524 </dl>
1525 <p id="section-4-7">Unassigned or reserved values <span class="bcp14">SHALL NOT</span> be included in the
1526 "dns-class-name" and "rr-type-name" enumeration types.<a href="#section-4-7" class="pilcrow">¶</a></p>
1527 <p id="section-4-8">Each time the "iana-dns-class-rr-type" YANG module is updated, a new
1528 "revision" statement <span class="bcp14">SHALL</span> be added before the existing
1529 "revision" statements.<a href="#section-4-8" class="pilcrow">¶</a></p>
1530 <p id="section-4-9">IANA has added this note to the "DNS CLASSes" and
1531 "Resource Record (RR) TYPEs" registries:<a href="#section-4-9" class="pilcrow">¶</a></p>
1532 <blockquote id="section-4-10">
1533 When this registry is modified, the YANG module
1534 "iana-dns-class-rr-type" must be updated as defined in [RFC9108].<a href="#section-4-10" class="pilcrow">¶</a>
1535 </blockquote>
1536 <p id="section-4-11">The "Reference" text in the "DNS CLASSes" registry has been
1537 updated as follows:<a href="#section-4-11" class="pilcrow">¶</a></p>
1538 <p id="section-4-12">
1539 OLD:<a href="#section-4-12" class="pilcrow">¶</a></p>
1540 <blockquote id="section-4-13">
1541 [RFC6895]<a href="#section-4-13" class="pilcrow">¶</a>
1542 </blockquote>
1543 <p id="section-4-14">
1544 NEW:<a href="#section-4-14" class="pilcrow">¶</a></p>
1545 <blockquote id="section-4-15">
1546 [RFC6895][RFC9108]<a href="#section-4-15" class="pilcrow">¶</a>
1547 </blockquote>
1548 <p id="section-4-16">The "Reference" text in the "Resource Record (RR) TYPEs"
1549 registry has been updated as follows:<a href="#section-4-16" class="pilcrow">¶</a></p>
1550 <p id="section-4-17">
1551 OLD:<a href="#section-4-17" class="pilcrow">¶</a></p>
1552 <blockquote id="section-4-18">
1553 [RFC6895][RFC1035]<a href="#section-4-18" class="pilcrow">¶</a>
1554 </blockquote>
1555 <p id="section-4-19">
1556 NEW:<a href="#section-4-19" class="pilcrow">¶</a></p>
1557 <blockquote id="section-4-20">
1558 [RFC6895][RFC1035][RFC9108]<a href="#section-4-20" class="pilcrow">¶</a>
1559 </blockquote>
1560 <section id="section-4.1">
1561 <h3 id="name-uri-registrations">
1562 <a href="#section-4.1" class="section-number selfRef">4.1. </a><a href="#name-uri-registrations" class="section-name selfRef">URI Registrations</a>
1563 </h3>
1564 <p id="section-4.1-1">This document registers a URI in the "IETF XML Registry"
1565 <span>[<a href="#RFC3688" class="xref">RFC3688</a>]</span>. The following registration has been
1566 made:<a href="#section-4.1-1" class="pilcrow">¶</a></p>
1567 <span class="break"></span><dl class="dlParallel dlCompact" id="section-4.1-2">
1568 <dt id="section-4.1-2.1">URI:</dt>
1569 <dd style="margin-left: 1.5em" id="section-4.1-2.2">urn:ietf:params:xml:ns:yang:iana-dns-class-rr-type<a href="#section-4.1-2.2" class="pilcrow">¶</a>
1570 </dd>
1571 <dd class="break"></dd>
1572 <dt id="section-4.1-2.3">Registrant Contact:</dt>
1573 <dd style="margin-left: 1.5em" id="section-4.1-2.4">The IESG.<a href="#section-4.1-2.4" class="pilcrow">¶</a>
1574 </dd>
1575 <dd class="break"></dd>
1576 <dt id="section-4.1-2.5">XML:</dt>
1577 <dd style="margin-left: 1.5em" id="section-4.1-2.6">N/A; the requested URI is an XML namespace.<a href="#section-4.1-2.6" class="pilcrow">¶</a>
1578 </dd>
1579 <dd class="break"></dd>
1580 </dl>
1581 </section>
1582 <section id="section-4.2">
1583 <h3 id="name-yang-module-registrations">
1584 <a href="#section-4.2" class="section-number selfRef">4.2. </a><a href="#name-yang-module-registrations" class="section-name selfRef">YANG Module Registrations</a>
1585 </h3>
1586 <p id="section-4.2-1">This document registers a YANG module in the "YANG Module
1587 Names" registry <span>[<a href="#RFC6020" class="xref">RFC6020</a>]</span>. The following
1588 registration has been made:<a href="#section-4.2-1" class="pilcrow">¶</a></p>
1589 <span class="break"></span><dl class="dlParallel dlCompact" id="section-4.2-2">
1590 <dt id="section-4.2-2.1">Name:</dt>
1591 <dd style="margin-left: 1.5em" id="section-4.2-2.2">iana-dns-class-rr-type<a href="#section-4.2-2.2" class="pilcrow">¶</a>
1592 </dd>
1593 <dd class="break"></dd>
1594 <dt id="section-4.2-2.3">Namespace:</dt>
1595 <dd style="margin-left: 1.5em" id="section-4.2-2.4">urn:ietf:params:xml:ns:yang:iana-dns-class-rr-type<a href="#section-4.2-2.4" class="pilcrow">¶</a>
1596 </dd>
1597 <dd class="break"></dd>
1598 <dt id="section-4.2-2.5">Prefix:</dt>
1599 <dd style="margin-left: 1.5em" id="section-4.2-2.6">dnsct<a href="#section-4.2-2.6" class="pilcrow">¶</a>
1600 </dd>
1601 <dd class="break"></dd>
1602 <dt id="section-4.2-2.7">Reference:</dt>
1603 <dd style="margin-left: 1.5em" id="section-4.2-2.8">RFC 9108<a href="#section-4.2-2.8" class="pilcrow">¶</a>
1604 </dd>
1605 <dd class="break"></dd>
1606 </dl>
1607 </section>
1608 </section>
1609 </div>
1610 <div id="security">
1611 <section id="section-5">
1612 <h2 id="name-security-considerations">
1613 <a href="#section-5" class="section-number selfRef">5. </a><a href="#name-security-considerations" class="section-name selfRef">Security Considerations</a>
1614 </h2>
1615 <p id="section-5-1">This document translates two IANA registries into YANG data
1616 types and otherwise introduces no technology or
1617 protocol. The definitions themselves have no security impact on
1618 the Internet, but their use in concrete YANG modules might
1619 have. The security considerations spelled out in the YANG
1620 specification <span>[<a href="#RFC7950" class="xref">RFC7950</a>]</span> apply to this document
1621 as well.<a href="#section-5-1" class="pilcrow">¶</a></p>
1622 </section>
1623 </div>
1624 <section id="section-6">
1625 <h2 id="name-references">
1626 <a href="#section-6" class="section-number selfRef">6. </a><a href="#name-references" class="section-name selfRef">References</a>
1627 </h2>
1628 <section id="section-6.1">
1629 <h3 id="name-normative-references">
1630 <a href="#section-6.1" class="section-number selfRef">6.1. </a><a href="#name-normative-references" class="section-name selfRef">Normative References</a>
1631 </h3>
1632 <dl class="references">
1633 <dt id="IANA-DNS-PARAMETERS">[IANA-DNS-PARAMETERS]</dt>
1634 <dd>
1635 <span class="refAuthor">IANA</span>, <span class="refTitle">"Domain Name System (DNS) Parameters"</span>, <span>&lt;<a href="https://www.iana.org/assignments/dns-parameters">https://www.iana.org/assignments/dns-parameters</a>&gt;</span>. </dd>
1636 <dd class="break"></dd>
1637 <dt id="IANA-YANG-PARAMETERS">[IANA-YANG-PARAMETERS]</dt>
1638 <dd>
1639 <span class="refAuthor">IANA</span>, <span class="refTitle">"YANG Parameters"</span>, <span>&lt;<a href="https://www.iana.org/assignments/yang-parameters">https://www.iana.org/assignments/yang-parameters</a>&gt;</span>. </dd>
1640 <dd class="break"></dd>
1641 <dt id="RFC2119">[RFC2119]</dt>
1642 <dd>
1643 <span class="refAuthor">Bradner, S.</span>, <span class="refTitle">"Key words for use in RFCs to Indicate Requirement Levels"</span>, <span class="seriesInfo">BCP 14</span>, <span class="seriesInfo">RFC 2119</span>, <span class="seriesInfo">DOI 10.17487/RFC2119</span>, <time datetime="1997-03" class="refDate">March 1997</time>, <span>&lt;<a href="https://www.rfc-editor.org/info/rfc2119">https://www.rfc-editor.org/info/rfc2119</a>&gt;</span>. </dd>
1644 <dd class="break"></dd>
1645 <dt id="RFC3688">[RFC3688]</dt>
1646 <dd>
1647 <span class="refAuthor">Mealling, M.</span>, <span class="refTitle">"The IETF XML Registry"</span>, <span class="seriesInfo">BCP 81</span>, <span class="seriesInfo">RFC 3688</span>, <span class="seriesInfo">DOI 10.17487/RFC3688</span>, <time datetime="2004-01" class="refDate">January 2004</time>, <span>&lt;<a href="https://www.rfc-editor.org/info/rfc3688">https://www.rfc-editor.org/info/rfc3688</a>&gt;</span>. </dd>
1648 <dd class="break"></dd>
1649 <dt id="RFC6020">[RFC6020]</dt>
1650 <dd>
1651 <span class="refAuthor">Bjorklund, M., Ed.</span>, <span class="refTitle">"YANG - A Data Modeling Language for the Network Configuration Protocol (NETCONF)"</span>, <span class="seriesInfo">RFC 6020</span>, <span class="seriesInfo">DOI 10.17487/RFC6020</span>, <time datetime="2010-10" class="refDate">October 2010</time>, <span>&lt;<a href="https://www.rfc-editor.org/info/rfc6020">https://www.rfc-editor.org/info/rfc6020</a>&gt;</span>. </dd>
1652 <dd class="break"></dd>
1653 <dt id="RFC7950">[RFC7950]</dt>
1654 <dd>
1655 <span class="refAuthor">Bjorklund, M., Ed.</span>, <span class="refTitle">"The YANG 1.1 Data Modeling Language"</span>, <span class="seriesInfo">RFC 7950</span>, <span class="seriesInfo">DOI 10.17487/RFC7950</span>, <time datetime="2016-08" class="refDate">August 2016</time>, <span>&lt;<a href="https://www.rfc-editor.org/info/rfc7950">https://www.rfc-editor.org/info/rfc7950</a>&gt;</span>. </dd>
1656 <dd class="break"></dd>
1657 <dt id="RFC8174">[RFC8174]</dt>
1658 <dd>
1659 <span class="refAuthor">Leiba, B.</span>, <span class="refTitle">"Ambiguity of Uppercase vs Lowercase in RFC 2119 Key Words"</span>, <span class="seriesInfo">BCP 14</span>, <span class="seriesInfo">RFC 8174</span>, <span class="seriesInfo">DOI 10.17487/RFC8174</span>, <time datetime="2017-05" class="refDate">May 2017</time>, <span>&lt;<a href="https://www.rfc-editor.org/info/rfc8174">https://www.rfc-editor.org/info/rfc8174</a>&gt;</span>. </dd>
1660 <dd class="break"></dd>
1661 <dt id="W3C.REC-xslt-19991116">[W3C.REC-xslt-19991116]</dt>
1662 <dd>
1663 <span class="refAuthor">Clark, J.</span>, <span class="refTitle">"XSL Transformations (XSLT) Version 1.0"</span>, <span class="seriesInfo">W3C Recommendation REC-xslt-19991116</span>, <time datetime="1999-11" class="refDate">November 1999</time>, <span>&lt;<a href="https://www.w3.org/TR/1999/REC-xslt-19991116">https://www.w3.org/TR/1999/REC-xslt-19991116</a>&gt;</span>. </dd>
1664 <dd class="break"></dd>
1665 </dl>
1666 </section>
1667 <section id="section-6.2">
1668 <h3 id="name-informative-references">
1669 <a href="#section-6.2" class="section-number selfRef">6.2. </a><a href="#name-informative-references" class="section-name selfRef">Informative References</a>
1670 </h3>
1671 <dl class="references">
1672 <dt id="RFC1035">[RFC1035]</dt>
1673 <dd>
1674 <span class="refAuthor">Mockapetris, P.</span>, <span class="refTitle">"Domain names - implementation and specification"</span>, <span class="seriesInfo">STD 13</span>, <span class="seriesInfo">RFC 1035</span>, <span class="seriesInfo">DOI 10.17487/RFC1035</span>, <time datetime="1987-11" class="refDate">November 1987</time>, <span>&lt;<a href="https://www.rfc-editor.org/info/rfc1035">https://www.rfc-editor.org/info/rfc1035</a>&gt;</span>. </dd>
1675 <dd class="break"></dd>
1676 <dt id="RFC3597">[RFC3597]</dt>
1677 <dd>
1678 <span class="refAuthor">Gustafsson, A.</span>, <span class="refTitle">"Handling of Unknown DNS Resource Record (RR) Types"</span>, <span class="seriesInfo">RFC 3597</span>, <span class="seriesInfo">DOI 10.17487/RFC3597</span>, <time datetime="2003-09" class="refDate">September 2003</time>, <span>&lt;<a href="https://www.rfc-editor.org/info/rfc3597">https://www.rfc-editor.org/info/rfc3597</a>&gt;</span>. </dd>
1679 <dd class="break"></dd>
1680 <dt id="RFC6241">[RFC6241]</dt>
1681 <dd>
1682 <span class="refAuthor">Enns, R., Ed.</span>, <span class="refAuthor">Bjorklund, M., Ed.</span>, <span class="refAuthor">Schoenwaelder, J., Ed.</span>, and <span class="refAuthor">A. Bierman, Ed.</span>, <span class="refTitle">"Network Configuration Protocol (NETCONF)"</span>, <span class="seriesInfo">RFC 6241</span>, <span class="seriesInfo">DOI 10.17487/RFC6241</span>, <time datetime="2011-06" class="refDate">June 2011</time>, <span>&lt;<a href="https://www.rfc-editor.org/info/rfc6241">https://www.rfc-editor.org/info/rfc6241</a>&gt;</span>. </dd>
1683 <dd class="break"></dd>
1684 <dt id="RFC8040">[RFC8040]</dt>
1685 <dd>
1686 <span class="refAuthor">Bierman, A.</span>, <span class="refAuthor">Bjorklund, M.</span>, and <span class="refAuthor">K. Watsen</span>, <span class="refTitle">"RESTCONF Protocol"</span>, <span class="seriesInfo">RFC 8040</span>, <span class="seriesInfo">DOI 10.17487/RFC8040</span>, <time datetime="2017-01" class="refDate">January 2017</time>, <span>&lt;<a href="https://www.rfc-editor.org/info/rfc8040">https://www.rfc-editor.org/info/rfc8040</a>&gt;</span>. </dd>
1687 <dd class="break"></dd>
1688 <dt id="RFC8499">[RFC8499]</dt>
1689 <dd>
1690 <span class="refAuthor">Hoffman, P.</span>, <span class="refAuthor">Sullivan, A.</span>, and <span class="refAuthor">K. Fujiwara</span>, <span class="refTitle">"DNS Terminology"</span>, <span class="seriesInfo">BCP 219</span>, <span class="seriesInfo">RFC 8499</span>, <span class="seriesInfo">DOI 10.17487/RFC8499</span>, <time datetime="2019-01" class="refDate">January 2019</time>, <span>&lt;<a href="https://www.rfc-editor.org/info/rfc8499">https://www.rfc-editor.org/info/rfc8499</a>&gt;</span>. </dd>
1691 <dd class="break"></dd>
1692 </dl>
1693 </section>
1694 </section>
1695 <div id="app.xslt">
1696 <section id="appendix-A">
1697 <h2 id="name-xslt-stylesheet">
1698 <a href="#appendix-A" class="section-number selfRef">Appendix A. </a><a href="#name-xslt-stylesheet" class="section-name selfRef">XSLT Stylesheet</a>
1699 </h2>
1700 <p id="appendix-A-1">This appendix contains an XSLT 1.0 stylesheet <span>[<a href="#W3C.REC-xslt-19991116" class="xref">W3C.REC-xslt-19991116</a>]</span> that is to be used to
1701 generate the initial revision of the "iana-dns-class-rr-type"
1702 YANG module. This is achieved by applying the stylesheet to the
1703 XML version of the IANA registry "Domain Name System (DNS)
1704 Parameters" <span>[<a href="#IANA-DNS-PARAMETERS" class="xref">IANA-DNS-PARAMETERS</a>]</span> that was
1705 current at the time this document was published.<a href="#appendix-A-1" class="pilcrow">¶</a></p>
1706 <p id="appendix-A-2">Using the ubiquitous xsltproc tool, the YANG module text can
1707 be generated with this command:<a href="#appendix-A-2" class="pilcrow">¶</a></p>
1708 <div id="appendix-A-3">
1709 <pre class="sourcecode lang-bash">
1710 $ xsltproc iana-dns-class-rr-type.xsl dns-parameters.xml
1711 </pre><a href="#appendix-A-3" class="pilcrow">¶</a>
1712 </div>
1713 <div id="appendix-A-4">
1714 <pre class="sourcecode lang-xml">&lt;CODE BEGINS&gt; file "iana-dns-class-rr-type.xsl"
1715
1716 &lt;?xml version="1.0" standalone="yes"?&gt;
1717 &lt;stylesheet xmlns="http://www.w3.org/1999/XSL/Transform"
1718 xmlns:iana="http://www.iana.org/assignments"
1719 version="1.0"&gt;
1720 &lt;output method="text"/&gt;
1721 &lt;strip-space elements="*"/&gt;
1722
1723 &lt;variable name="dq"&gt;"&lt;/variable&gt;
1724 &lt;variable name="sq"&gt;'&lt;/variable&gt;
1725
1726 &lt;variable name="module-intro"&gt;
1727 &lt;text&gt;module iana-dns-class-rr-type {
1728 yang-version 1.1;
1729 namespace
1730 "urn:ietf:params:xml:ns:yang:iana-dns-class-rr-type";
1731 prefix dnsct;
1732
1733 organization
1734 "Internet Assigned Numbers Authority (IANA)";
1735
1736 contact
1737 " Internet Assigned Numbers Authority
1738
1739 Postal: ICANN
1740 12025 Waterfront Drive, Suite 300
1741 Los Angeles, CA 90094
1742
1743 Tel: +1 424 254 5300
1744
1745 &amp;lt;mailto:[email protected]&amp;gt;";
1746
1747 description
1748 "This YANG module translates IANA registries 'DNS CLASSes' and
1749 'Resource Record (RR) TYPEs' to YANG-derived types.
1750
1751 Copyright (c) 2021 IETF Trust and the persons identified as
1752 authors of the code. All rights reserved.
1753
1754 Redistribution and use in source and binary forms, with or
1755 without modification, is permitted pursuant to, and subject to
1756 the license terms contained in, the Simplified BSD License set
1757 forth in Section 4.c of the IETF Trust's Legal Provisions
1758 Relating to IETF Documents
1759 (https://trustee.ietf.org/license-info).
1760
1761 This version of this YANG module was generated from
1762 the corresponding IANA registries using an XSLT stylesheet
1763 from Appendix A of RFC 9108
1764 (https://www.rfc-editor.org/info/rfc9108); see the RFC itself
1765 for full legal notices.";
1766
1767 reference
1768 "IANA 'Domain Name System (DNS) Parameters' registry
1769 https://www.iana.org/assignments/dns-parameters";&lt;/text&gt;
1770 &lt;text&gt;&amp;#xA;&amp;#xA;&lt;/text&gt;
1771 &lt;/variable&gt;
1772
1773 &lt;template name="enum"&gt;
1774 &lt;param name="id"/&gt;
1775 &lt;value-of select="concat(' enum ', $id)"/&gt;
1776 &lt;text&gt; {&amp;#xA; value &lt;/text&gt;
1777 &lt;value-of select="concat(iana:value, ';&amp;#xA;')"/&gt;
1778 &lt;if test="contains(iana:description, 'OBSOLETE')"&gt;
1779 &lt;text&gt; status obsolete;&amp;#xA;&lt;/text&gt;
1780 &lt;/if&gt;
1781 &lt;apply-templates select="iana:description"/&gt;
1782 &lt;variable name="xrefs" select="iana:xref[@type!='note']"/&gt;
1783 &lt;if test="$xrefs"&gt;
1784 &lt;text&gt; reference&amp;#xA; "&lt;/text&gt;
1785 &lt;if test="count($xrefs)&amp;gt;1"&gt;- &lt;/if&gt;
1786 &lt;apply-templates select="iana:xref[@type!='note']"/&gt;
1787 &lt;/if&gt;
1788 &lt;text&gt; }&amp;#xA;&lt;/text&gt;
1789 &lt;/template&gt;
1790
1791 &lt;template match="/"&gt;
1792 &lt;value-of select="$module-intro"/&gt;
1793 &lt;apply-templates select="iana:registry[@id='dns-parameters']"/&gt;
1794 &lt;text&gt;}&amp;#xA;&lt;/text&gt;
1795 &lt;/template&gt;
1796
1797 &lt;template match="iana:registry[@id='dns-parameters']"&gt;
1798 &lt;apply-templates select="iana:updated"/&gt;
1799 &lt;apply-templates
1800 select="iana:registry[@id='dns-parameters-2']"/&gt;
1801 &lt;apply-templates
1802 select="iana:registry[@id='dns-parameters-4']"/&gt;
1803 &lt;/template&gt;
1804
1805 &lt;template match="iana:updated"&gt;
1806 &lt;value-of select="concat(' revision ', ., ' {')"/&gt;
1807 &lt;text&gt;
1808 description
1809 "Initial revision.";
1810 reference
1811 "RFC 9108: YANG Types for DNS Classes and Resource Record
1812 Types";
1813 }
1814
1815 /* Typedefs */&amp;#xA;&amp;#xA;&lt;/text&gt;
1816 &lt;/template&gt;
1817
1818 &lt;template match="iana:registry[@id='dns-parameters-2']"&gt;
1819 &lt;text&gt; typedef dns-class-name {&amp;#xA;&lt;/text&gt;
1820 &lt;text&gt; type enumeration {&amp;#xA;&lt;/text&gt;
1821 &lt;apply-templates
1822 select="iana:record[not(iana:description='Unassigned' or
1823 starts-with(iana:description,'Reserved'))]"
1824 mode="class"/&gt;
1825 &lt;text&gt; }
1826 description
1827 "This enumeration type defines mnemonic names and corresponding
1828 numeric values of DNS classes.";
1829 reference
1830 "RFC 6895: Domain Name System (DNS) IANA Considerations";
1831 }
1832
1833 typedef dns-class {
1834 type union {
1835 type uint16;
1836 type dns-class-name;
1837 }
1838 description
1839 "This type allows reference to a DNS class using either the
1840 assigned mnemonic name or numeric value.";
1841 }&amp;#xA;&amp;#xA;&lt;/text&gt;
1842 &lt;/template&gt;
1843
1844 &lt;template match="iana:registry[@id='dns-parameters-4']"&gt;
1845 &lt;text&gt; typedef rr-type-name {&amp;#xA;&lt;/text&gt;
1846 &lt;text&gt; type enumeration {&amp;#xA;&lt;/text&gt;
1847 &lt;apply-templates
1848 select="iana:record[iana:type!='Unassigned' and
1849 iana:type!='Private use' and iana:type!='Reserved']"
1850 mode="rr-type"/&gt;
1851 &lt;text&gt; }
1852 description
1853 "This enumeration type defines mnemonic names and corresponding
1854 numeric values of DNS resource record types.";
1855 reference
1856 "- RFC 6895: Domain Name System (DNS) IANA Considerations
1857
1858 - RFC 1035: Domain names - implementation and specification";
1859 }
1860
1861 typedef rr-type {
1862 type union {
1863 type uint16;
1864 type rr-type-name;
1865 }
1866 description
1867 "This type allows reference to a DNS resource record type
1868 using either the assigned mnemonic name or numeric value.";
1869 }&amp;#xA;&lt;/text&gt;
1870 &lt;/template&gt;
1871
1872 &lt;template match="iana:record" mode="class"&gt;
1873 &lt;call-template name="enum"&gt;
1874 &lt;with-param name="id"&gt;
1875 &lt;choose&gt;
1876 &lt;when test="contains(iana:description,'(')"&gt;
1877 &lt;value-of select="substring-before(substring-after(
1878 iana:description, '('), ')')"/&gt;
1879 &lt;/when&gt;
1880 &lt;otherwise&gt;
1881 &lt;value-of
1882 select="substring-after(iana:description, ' ')"/&gt;
1883 &lt;/otherwise&gt;
1884 &lt;/choose&gt;
1885 &lt;/with-param&gt;
1886 &lt;/call-template&gt;
1887 &lt;/template&gt;
1888
1889 &lt;template match="iana:record" mode="rr-type"&gt;
1890 &lt;call-template name="enum"&gt;
1891 &lt;with-param name="id" select="iana:type"/&gt;
1892 &lt;/call-template&gt;
1893 &lt;/template&gt;
1894
1895 &lt;template match="iana:description"&gt;
1896 &lt;text&gt; description&amp;#xA; &lt;/text&gt;
1897 &lt;value-of select="concat($dq, ., $dq, ';&amp;#xA;')"/&gt;
1898 &lt;/template&gt;
1899
1900 &lt;template match="iana:xref"&gt;
1901 &lt;choose&gt;
1902 &lt;when test="@type='rfc'"&gt;
1903 &lt;value-of
1904 select="concat('RFC ', substring-after(@data, 'rfc'))"/&gt;
1905 &lt;/when&gt;
1906 &lt;when test="@type='person'"&gt;
1907 &lt;apply-templates
1908 select="/iana:registry/iana:people/iana:person[
1909 @id=current()/@data]"/&gt;
1910 &lt;/when&gt;
1911 &lt;when test="@type='text'"&gt;
1912 &lt;value-of select="translate(., $dq, $sq)"/&gt;
1913 &lt;/when&gt;
1914 &lt;otherwise&gt;
1915 &lt;value-of select="@data"/&gt;
1916 &lt;/otherwise&gt;
1917 &lt;/choose&gt;
1918 &lt;choose&gt;
1919 &lt;when test="position()=last()"&gt;
1920 &lt;text&gt;";&amp;#xA;&lt;/text&gt;
1921 &lt;/when&gt;
1922 &lt;otherwise&gt;
1923 &lt;text&gt;&amp;#xA; - &lt;/text&gt;
1924 &lt;/otherwise&gt;
1925 &lt;/choose&gt;
1926 &lt;/template&gt;
1927
1928 &lt;template match="iana:person"&gt;
1929 &lt;value-of select="concat(iana:name, ' &amp;lt;', iana:uri, '&amp;gt;')"/&gt;
1930 &lt;/template&gt;
1931
1932 &lt;/stylesheet&gt;
1933
1934
1935 &lt;CODE ENDS&gt;</pre><a href="#appendix-A-4" class="pilcrow">¶</a>
1936 </div>
1937 </section>
1938 </div>
1939 <div id="authors-addresses">
1940 <section id="appendix-B">
1941 <h2 id="name-authors-addresses">
1942 <a href="#name-authors-addresses" class="section-name selfRef">Authors' Addresses</a>
1943 </h2>
1944 <address class="vcard">
1945 <div dir="auto" class="left"><span class="fn nameRole">Ladislav Lhotka</span></div>
1946 <div dir="auto" class="left"><span class="org">CZ.NIC</span></div>
1947 <div dir="auto" class="left"><span class="country-name">Czech Republic</span></div>
1948 <div class="email">
1949 <span>Email:</span>
1950 <a href="mailto:[email protected]" class="email">[email protected]</a>
1951 </div>
1952 </address>
1953 <address class="vcard">
1954 <div dir="auto" class="left"><span class="fn nameRole">Petr Špaček</span></div>
1955 <div dir="auto" class="left"><span class="org">Internet Systems Consortium</span></div>
1956 <div dir="auto" class="left"><span class="country-name">Czech Republic</span></div>
1957 <div class="email">
1958 <span>Email:</span>
1959 <a href="mailto:[email protected]" class="email">[email protected]</a>
1960 </div>
1961 </address>
1962 </section>
1963 </div>
1964 <script>const toc = document.getElementById("toc");
1965 toc.querySelector("h2").addEventListener("click", e => {
1966 toc.classList.toggle("active");
1967 });
1968 toc.querySelector("nav").addEventListener("click", e => {
1969 toc.classList.remove("active");
1970 });
1971 </script>
1972 </body>
1973 </html>