Debian Codegraph @

rfc9194.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 9194: A YANG Module for IS-IS Reverse Metric</title>
8 <meta content="Christian Hopps" name="author">
9 <meta content="
10 This document defines a YANG module for managing the reverse metric
11 extension to the Intermediate System to Intermediate System (IS-IS)
12 intra-domain routing information exchange protocol.
13
14 " name="description">
15 <meta content="xml2rfc 3.15.1" name="generator">
16 <meta content="9194" name="rfc.number">
17 <!-- Generator version information:
18 xml2rfc 3.15.1
19 Python 3.9.13
20 appdirs 1.4.4
21 ConfigArgParse 1.5.3
22 google-i18n-address 2.5.1
23 html5lib 1.1
24 intervaltree 3.1.0
25 Jinja2 3.1.2
26 kitchen 1.2.6
27 lxml 4.9.0
28 MarkupSafe 2.1.1
29 pycountry 22.3.5
30 PyYAML 6.0
31 requests 2.28.0
32 setuptools 44.1.1
33 six 1.16.0
34 weasyprint 56.1
35 -->
36 <link href="rfc9194.xml" rel="alternate" type="application/rfc+xml">
37 <link href="#copyright" rel="license">
38 <style type="text/css">/*
39
40 NOTE: Changes at the bottom of this file overrides some earlier settings.
41
42 Once the style has stabilized and has been adopted as an official RFC style,
43 this can be consolidated so that style settings occur only in one place, but
44 for now the contents of this file consists first of the initial CSS work as
45 provided to the RFC Formatter (xml2rfc) work, followed by itemized and
46 commented changes found necssary during the development of the v3
47 formatters.
48
49 */
50
51 /* fonts */
52 @import url('https://fonts.googleapis.com/css?family=Noto+Sans'); /* Sans-serif */
53 @import url('https://fonts.googleapis.com/css?family=Noto+Serif'); /* Serif (print) */
54 @import url('https://fonts.googleapis.com/css?family=Roboto+Mono'); /* Monospace */
55
56 @viewport {
57 zoom: 1.0;
58 width: extend-to-zoom;
59 }
60 @-ms-viewport {
61 width: extend-to-zoom;
62 zoom: 1.0;
63 }
64 /* general and mobile first */
65 html {
66 }
67 body {
68 max-width: 90%;
69 margin: 1.5em auto;
70 color: #222;
71 background-color: #fff;
72 font-size: 14px;
73 font-family: 'Noto Sans', Arial, Helvetica, sans-serif;
74 line-height: 1.6;
75 scroll-behavior: smooth;
76 }
77 .ears {
78 display: none;
79 }
80
81 /* headings */
82 #title, h1, h2, h3, h4, h5, h6 {
83 margin: 1em 0 0.5em;
84 font-weight: bold;
85 line-height: 1.3;
86 }
87 #title {
88 clear: both;
89 border-bottom: 1px solid #ddd;
90 margin: 0 0 0.5em 0;
91 padding: 1em 0 0.5em;
92 }
93 .author {
94 padding-bottom: 4px;
95 }
96 h1 {
97 font-size: 26px;
98 margin: 1em 0;
99 }
100 h2 {
101 font-size: 22px;
102 margin-top: -20px; /* provide offset for in-page anchors */
103 padding-top: 33px;
104 }
105 h3 {
106 font-size: 18px;
107 margin-top: -36px; /* provide offset for in-page anchors */
108 padding-top: 42px;
109 }
110 h4 {
111 font-size: 16px;
112 margin-top: -36px; /* provide offset for in-page anchors */
113 padding-top: 42px;
114 }
115 h5, h6 {
116 font-size: 14px;
117 }
118 #n-copyright-notice {
119 border-bottom: 1px solid #ddd;
120 padding-bottom: 1em;
121 margin-bottom: 1em;
122 }
123 /* general structure */
124 p {
125 padding: 0;
126 margin: 0 0 1em 0;
127 text-align: left;
128 }
129 div, span {
130 position: relative;
131 }
132 div {
133 margin: 0;
134 }
135 .alignRight.art-text {
136 background-color: #f9f9f9;
137 border: 1px solid #eee;
138 border-radius: 3px;
139 padding: 1em 1em 0;
140 margin-bottom: 1.5em;
141 }
142 .alignRight.art-text pre {
143 padding: 0;
144 }
145 .alignRight {
146 margin: 1em 0;
147 }
148 .alignRight > *:first-child {
149 border: none;
150 margin: 0;
151 float: right;
152 clear: both;
153 }
154 .alignRight > *:nth-child(2) {
155 clear: both;
156 display: block;
157 border: none;
158 }
159 svg {
160 display: block;
161 }
162 .alignCenter.art-text {
163 background-color: #f9f9f9;
164 border: 1px solid #eee;
165 border-radius: 3px;
166 padding: 1em 1em 0;
167 margin-bottom: 1.5em;
168 }
169 .alignCenter.art-text pre {
170 padding: 0;
171 }
172 .alignCenter {
173 margin: 1em 0;
174 }
175 .alignCenter > *:first-child {
176 display: table;
177 border: none;
178 margin: 0 auto;
179 }
180
181 /* lists */
182 ol, ul {
183 padding: 0;
184 margin: 0 0 1em 2em;
185 }
186 ol ol, ul ul, ol ul, ul ol {
187 margin-left: 1em;
188 }
189 li {
190 margin: 0 0 0.25em 0;
191 }
192 .ulCompact li {
193 margin: 0;
194 }
195 ul.empty, .ulEmpty {
196 list-style-type: none;
197 }
198 ul.empty li, .ulEmpty li {
199 margin-top: 0.5em;
200 }
201 ul.ulBare, li.ulBare {
202 margin-left: 0em !important;
203 }
204 ul.compact, .ulCompact,
205 ol.compact, .olCompact {
206 line-height: 100%;
207 margin: 0 0 0 2em;
208 }
209
210 /* definition lists */
211 dl {
212 }
213 dl > dt {
214 float: left;
215 margin-right: 1em;
216 }
217 /*
218 dl.nohang > dt {
219 float: none;
220 }
221 */
222 dl > dd {
223 margin-bottom: .8em;
224 min-height: 1.3em;
225 }
226 dl.compact > dd, .dlCompact > dd {
227 margin-bottom: 0em;
228 }
229 dl > dd > dl {
230 margin-top: 0.5em;
231 margin-bottom: 0em;
232 }
233
234 /* links */
235 a {
236 text-decoration: none;
237 }
238 a[href] {
239 color: #22e; /* Arlen: WCAG 2019 */
240 }
241 a[href]:hover {
242 background-color: #f2f2f2;
243 }
244 figcaption a[href],
245 a[href].selfRef {
246 color: #222;
247 }
248 /* XXX probably not this:
249 a.selfRef:hover {
250 background-color: transparent;
251 cursor: default;
252 } */
253
254 /* Figures */
255 tt, code, pre {
256 background-color: #f9f9f9;
257 font-family: 'Roboto Mono', monospace;
258 }
259 pre {
260 border: 1px solid #eee;
261 margin: 0;
262 padding: 1em;
263 }
264 img {
265 max-width: 100%;
266 }
267 figure {
268 margin: 0;
269 }
270 figure blockquote {
271 margin: 0.8em 0.4em 0.4em;
272 }
273 figcaption {
274 font-style: italic;
275 margin: 0 0 1em 0;
276 }
277 @media screen {
278 pre {
279 overflow-x: auto;
280 max-width: 100%;
281 max-width: calc(100% - 22px);
282 }
283 }
284
285 /* aside, blockquote */
286 aside, blockquote {
287 margin-left: 0;
288 padding: 1.2em 2em;
289 }
290 blockquote {
291 background-color: #f9f9f9;
292 color: #111; /* Arlen: WCAG 2019 */
293 border: 1px solid #ddd;
294 border-radius: 3px;
295 margin: 1em 0;
296 }
297 cite {
298 display: block;
299 text-align: right;
300 font-style: italic;
301 }
302
303 /* tables */
304 table {
305 width: 100%;
306 margin: 0 0 1em;
307 border-collapse: collapse;
308 border: 1px solid #eee;
309 }
310 th, td {
311 text-align: left;
312 vertical-align: top;
313 padding: 0.5em 0.75em;
314 }
315 th {
316 text-align: left;
317 background-color: #e9e9e9;
318 }
319 tr:nth-child(2n+1) > td {
320 background-color: #f5f5f5;
321 }
322 table caption {
323 font-style: italic;
324 margin: 0;
325 padding: 0;
326 text-align: left;
327 }
328 table p {
329 /* XXX to avoid bottom margin on table row signifiers. If paragraphs should
330 be allowed within tables more generally, it would be far better to select on a class. */
331 margin: 0;
332 }
333
334 /* pilcrow */
335 a.pilcrow {
336 color: #666; /* Arlen: AHDJ 2019 */
337 text-decoration: none;
338 visibility: hidden;
339 user-select: none;
340 -ms-user-select: none;
341 -o-user-select:none;
342 -moz-user-select: none;
343 -khtml-user-select: none;
344 -webkit-user-select: none;
345 -webkit-touch-callout: none;
346 }
347 @media screen {
348 aside:hover > a.pilcrow,
349 p:hover > a.pilcrow,
350 blockquote:hover > a.pilcrow,
351 div:hover > a.pilcrow,
352 li:hover > a.pilcrow,
353 pre:hover > a.pilcrow {
354 visibility: visible;
355 }
356 a.pilcrow:hover {
357 background-color: transparent;
358 }
359 }
360
361 /* misc */
362 hr {
363 border: 0;
364 border-top: 1px solid #eee;
365 }
366 .bcp14 {
367 font-variant: small-caps;
368 }
369
370 .role {
371 font-variant: all-small-caps;
372 }
373
374 /* info block */
375 #identifiers {
376 margin: 0;
377 font-size: 0.9em;
378 }
379 #identifiers dt {
380 width: 3em;
381 clear: left;
382 }
383 #identifiers dd {
384 float: left;
385 margin-bottom: 0;
386 }
387 /* Fix PDF info block run off issue */
388 @media print {
389 #identifiers dd {
390 float: none;
391 }
392 }
393 #identifiers .authors .author {
394 display: inline-block;
395 margin-right: 1.5em;
396 }
397 #identifiers .authors .org {
398 font-style: italic;
399 }
400
401 /* The prepared/rendered info at the very bottom of the page */
402 .docInfo {
403 color: #666; /* Arlen: WCAG 2019 */
404 font-size: 0.9em;
405 font-style: italic;
406 margin-top: 2em;
407 }
408 .docInfo .prepared {
409 float: left;
410 }
411 .docInfo .prepared {
412 float: right;
413 }
414
415 /* table of contents */
416 #toc {
417 padding: 0.75em 0 2em 0;
418 margin-bottom: 1em;
419 }
420 nav.toc ul {
421 margin: 0 0.5em 0 0;
422 padding: 0;
423 list-style: none;
424 }
425 nav.toc li {
426 line-height: 1.3em;
427 margin: 0.75em 0;
428 padding-left: 1.2em;
429 text-indent: -1.2em;
430 }
431 /* references */
432 .references dt {
433 text-align: right;
434 font-weight: bold;
435 min-width: 7em;
436 }
437 .references dd {
438 margin-left: 8em;
439 overflow: auto;
440 }
441
442 .refInstance {
443 margin-bottom: 1.25em;
444 }
445
446 .references .ascii {
447 margin-bottom: 0.25em;
448 }
449
450 /* index */
451 .index ul {
452 margin: 0 0 0 1em;
453 padding: 0;
454 list-style: none;
455 }
456 .index ul ul {
457 margin: 0;
458 }
459 .index li {
460 margin: 0;
461 text-indent: -2em;
462 padding-left: 2em;
463 padding-bottom: 5px;
464 }
465 .indexIndex {
466 margin: 0.5em 0 1em;
467 }
468 .index a {
469 font-weight: 700;
470 }
471 /* make the index two-column on all but the smallest screens */
472 @media (min-width: 600px) {
473 .index ul {
474 -moz-column-count: 2;
475 -moz-column-gap: 20px;
476 }
477 .index ul ul {
478 -moz-column-count: 1;
479 -moz-column-gap: 0;
480 }
481 }
482
483 /* authors */
484 address.vcard {
485 font-style: normal;
486 margin: 1em 0;
487 }
488
489 address.vcard .nameRole {
490 font-weight: 700;
491 margin-left: 0;
492 }
493 address.vcard .label {
494 font-family: "Noto Sans",Arial,Helvetica,sans-serif;
495 margin: 0.5em 0;
496 }
497 address.vcard .type {
498 display: none;
499 }
500 .alternative-contact {
501 margin: 1.5em 0 1em;
502 }
503 hr.addr {
504 border-top: 1px dashed;
505 margin: 0;
506 color: #ddd;
507 max-width: calc(100% - 16px);
508 }
509
510 /* temporary notes */
511 .rfcEditorRemove::before {
512 position: absolute;
513 top: 0.2em;
514 right: 0.2em;
515 padding: 0.2em;
516 content: "The RFC Editor will remove this note";
517 color: #9e2a00; /* Arlen: WCAG 2019 */
518 background-color: #ffd; /* Arlen: WCAG 2019 */
519 }
520 .rfcEditorRemove {
521 position: relative;
522 padding-top: 1.8em;
523 background-color: #ffd; /* Arlen: WCAG 2019 */
524 border-radius: 3px;
525 }
526 .cref {
527 background-color: #ffd; /* Arlen: WCAG 2019 */
528 padding: 2px 4px;
529 }
530 .crefSource {
531 font-style: italic;
532 }
533 /* alternative layout for smaller screens */
534 @media screen and (max-width: 1023px) {
535 body {
536 padding-top: 2em;
537 }
538 #title {
539 padding: 1em 0;
540 }
541 h1 {
542 font-size: 24px;
543 }
544 h2 {
545 font-size: 20px;
546 margin-top: -18px; /* provide offset for in-page anchors */
547 padding-top: 38px;
548 }
549 #identifiers dd {
550 max-width: 60%;
551 }
552 #toc {
553 position: fixed;
554 z-index: 2;
555 top: 0;
556 right: 0;
557 padding: 0;
558 margin: 0;
559 background-color: inherit;
560 border-bottom: 1px solid #ccc;
561 }
562 #toc h2 {
563 margin: -1px 0 0 0;
564 padding: 4px 0 4px 6px;
565 padding-right: 1em;
566 min-width: 190px;
567 font-size: 1.1em;
568 text-align: right;
569 background-color: #444;
570 color: white;
571 cursor: pointer;
572 }
573 #toc h2::before { /* css hamburger */
574 float: right;
575 position: relative;
576 width: 1em;
577 height: 1px;
578 left: -164px;
579 margin: 6px 0 0 0;
580 background: white none repeat scroll 0 0;
581 box-shadow: 0 4px 0 0 white, 0 8px 0 0 white;
582 content: "";
583 }
584 #toc nav {
585 display: none;
586 padding: 0.5em 1em 1em;
587 overflow: auto;
588 height: calc(100vh - 48px);
589 border-left: 1px solid #ddd;
590 }
591 }
592
593 /* alternative layout for wide screens */
594 @media screen and (min-width: 1024px) {
595 body {
596 max-width: 724px;
597 margin: 42px auto;
598 padding-left: 1.5em;
599 padding-right: 29em;
600 }
601 #toc {
602 position: fixed;
603 top: 42px;
604 right: 42px;
605 width: 25%;
606 margin: 0;
607 padding: 0 1em;
608 z-index: 1;
609 }
610 #toc h2 {
611 border-top: none;
612 border-bottom: 1px solid #ddd;
613 font-size: 1em;
614 font-weight: normal;
615 margin: 0;
616 padding: 0.25em 1em 1em 0;
617 }
618 #toc nav {
619 display: block;
620 height: calc(90vh - 84px);
621 bottom: 0;
622 padding: 0.5em 0 0;
623 overflow: auto;
624 }
625 img { /* future proofing */
626 max-width: 100%;
627 height: auto;
628 }
629 }
630
631 /* pagination */
632 @media print {
633 body {
634
635 width: 100%;
636 }
637 p {
638 orphans: 3;
639 widows: 3;
640 }
641 #n-copyright-notice {
642 border-bottom: none;
643 }
644 #toc, #n-introduction {
645 page-break-before: always;
646 }
647 #toc {
648 border-top: none;
649 padding-top: 0;
650 }
651 figure, pre {
652 page-break-inside: avoid;
653 }
654 figure {
655 overflow: scroll;
656 }
657 pre.breakable {
658 break-inside: auto;
659 }
660 h1, h2, h3, h4, h5, h6 {
661 page-break-after: avoid;
662 }
663 h2+*, h3+*, h4+*, h5+*, h6+* {
664 page-break-before: avoid;
665 }
666 pre {
667 white-space: pre-wrap;
668 word-wrap: break-word;
669 font-size: 10pt;
670 }
671 table {
672 border: 1px solid #ddd;
673 }
674 td {
675 border-top: 1px solid #ddd;
676 }
677 }
678
679 /* This is commented out here, as the string-set: doesn't
680 pass W3C validation currently */
681 /*
682 .ears thead .left {
683 string-set: ears-top-left content();
684 }
685
686 .ears thead .center {
687 string-set: ears-top-center content();
688 }
689
690 .ears thead .right {
691 string-set: ears-top-right content();
692 }
693
694 .ears tfoot .left {
695 string-set: ears-bottom-left content();
696 }
697
698 .ears tfoot .center {
699 string-set: ears-bottom-center content();
700 }
701
702 .ears tfoot .right {
703 string-set: ears-bottom-right content();
704 }
705 */
706
707 @page :first {
708 padding-top: 0;
709 @top-left {
710 content: normal;
711 border: none;
712 }
713 @top-center {
714 content: normal;
715 border: none;
716 }
717 @top-right {
718 content: normal;
719 border: none;
720 }
721 }
722
723 @page {
724 size: A4;
725 margin-bottom: 45mm;
726 padding-top: 20px;
727 /* The follwing is commented out here, but set appropriately by in code, as
728 the content depends on the document */
729 /*
730 @top-left {
731 content: 'Internet-Draft';
732 vertical-align: bottom;
733 border-bottom: solid 1px #ccc;
734 }
735 @top-left {
736 content: string(ears-top-left);
737 vertical-align: bottom;
738 border-bottom: solid 1px #ccc;
739 }
740 @top-center {
741 content: string(ears-top-center);
742 vertical-align: bottom;
743 border-bottom: solid 1px #ccc;
744 }
745 @top-right {
746 content: string(ears-top-right);
747 vertical-align: bottom;
748 border-bottom: solid 1px #ccc;
749 }
750 @bottom-left {
751 content: string(ears-bottom-left);
752 vertical-align: top;
753 border-top: solid 1px #ccc;
754 }
755 @bottom-center {
756 content: string(ears-bottom-center);
757 vertical-align: top;
758 border-top: solid 1px #ccc;
759 }
760 @bottom-right {
761 content: '[Page ' counter(page) ']';
762 vertical-align: top;
763 border-top: solid 1px #ccc;
764 }
765 */
766
767 }
768
769 /* Changes introduced to fix issues found during implementation */
770 /* Make sure links are clickable even if overlapped by following H* */
771 a {
772 z-index: 2;
773 }
774 /* Separate body from document info even without intervening H1 */
775 section {
776 clear: both;
777 }
778
779
780 /* Top align author divs, to avoid names without organization dropping level with org names */
781 .author {
782 vertical-align: top;
783 }
784
785 /* Leave room in document info to show Internet-Draft on one line */
786 #identifiers dt {
787 width: 8em;
788 }
789
790 /* Don't waste quite as much whitespace between label and value in doc info */
791 #identifiers dd {
792 margin-left: 1em;
793 }
794
795 /* Give floating toc a background color (needed when it's a div inside section */
796 #toc {
797 background-color: white;
798 }
799
800 /* Make the collapsed ToC header render white on gray also when it's a link */
801 @media screen and (max-width: 1023px) {
802 #toc h2 a,
803 #toc h2 a:link,
804 #toc h2 a:focus,
805 #toc h2 a:hover,
806 #toc a.toplink,
807 #toc a.toplink:hover {
808 color: white;
809 background-color: #444;
810 text-decoration: none;
811 }
812 }
813
814 /* Give the bottom of the ToC some whitespace */
815 @media screen and (min-width: 1024px) {
816 #toc {
817 padding: 0 0 1em 1em;
818 }
819 }
820
821 /* Style section numbers with more space between number and title */
822 .section-number {
823 padding-right: 0.5em;
824 }
825
826 /* prevent monospace from becoming overly large */
827 tt, code, pre {
828 font-size: 95%;
829 }
830
831 /* Fix the height/width aspect for ascii art*/
832 pre.sourcecode,
833 .art-text pre {
834 line-height: 1.12;
835 }
836
837
838 /* Add styling for a link in the ToC that points to the top of the document */
839 a.toplink {
840 float: right;
841 margin-right: 0.5em;
842 }
843
844 /* Fix the dl styling to match the RFC 7992 attributes */
845 dl > dt,
846 dl.dlParallel > dt {
847 float: left;
848 margin-right: 1em;
849 }
850 dl.dlNewline > dt {
851 float: none;
852 }
853
854 /* Provide styling for table cell text alignment */
855 table td.text-left,
856 table th.text-left {
857 text-align: left;
858 }
859 table td.text-center,
860 table th.text-center {
861 text-align: center;
862 }
863 table td.text-right,
864 table th.text-right {
865 text-align: right;
866 }
867
868 /* Make the alternative author contact informatio look less like just another
869 author, and group it closer with the primary author contact information */
870 .alternative-contact {
871 margin: 0.5em 0 0.25em 0;
872 }
873 address .non-ascii {
874 margin: 0 0 0 2em;
875 }
876
877 /* With it being possible to set tables with alignment
878 left, center, and right, { width: 100%; } does not make sense */
879 table {
880 width: auto;
881 }
882
883 /* Avoid reference text that sits in a block with very wide left margin,
884 because of a long floating dt label.*/
885 .references dd {
886 overflow: visible;
887 }
888
889 /* Control caption placement */
890 caption {
891 caption-side: bottom;
892 }
893
894 /* Limit the width of the author address vcard, so names in right-to-left
895 script don't end up on the other side of the page. */
896
897 address.vcard {
898 max-width: 30em;
899 margin-right: auto;
900 }
901
902 /* For address alignment dependent on LTR or RTL scripts */
903 address div.left {
904 text-align: left;
905 }
906 address div.right {
907 text-align: right;
908 }
909
910 /* Provide table alignment support. We can't use the alignX classes above
911 since they do unwanted things with caption and other styling. */
912 table.right {
913 margin-left: auto;
914 margin-right: 0;
915 }
916 table.center {
917 margin-left: auto;
918 margin-right: auto;
919 }
920 table.left {
921 margin-left: 0;
922 margin-right: auto;
923 }
924
925 /* Give the table caption label the same styling as the figcaption */
926 caption a[href] {
927 color: #222;
928 }
929
930 @media print {
931 .toplink {
932 display: none;
933 }
934
935 /* avoid overwriting the top border line with the ToC header */
936 #toc {
937 padding-top: 1px;
938 }
939
940 /* Avoid page breaks inside dl and author address entries */
941 .vcard {
942 page-break-inside: avoid;
943 }
944
945 }
946 /* Tweak the bcp14 keyword presentation */
947 .bcp14 {
948 font-variant: small-caps;
949 font-weight: bold;
950 font-size: 0.9em;
951 }
952 /* Tweak the invisible space above H* in order not to overlay links in text above */
953 h2 {
954 margin-top: -18px; /* provide offset for in-page anchors */
955 padding-top: 31px;
956 }
957 h3 {
958 margin-top: -18px; /* provide offset for in-page anchors */
959 padding-top: 24px;
960 }
961 h4 {
962 margin-top: -18px; /* provide offset for in-page anchors */
963 padding-top: 24px;
964 }
965 /* Float artwork pilcrow to the right */
966 @media screen {
967 .artwork a.pilcrow {
968 display: block;
969 line-height: 0.7;
970 margin-top: 0.15em;
971 }
972 }
973 /* Make pilcrows on dd visible */
974 @media screen {
975 dd:hover > a.pilcrow {
976 visibility: visible;
977 }
978 }
979 /* Make the placement of figcaption match that of a table's caption
980 by removing the figure's added bottom margin */
981 .alignLeft.art-text,
982 .alignCenter.art-text,
983 .alignRight.art-text {
984 margin-bottom: 0;
985 }
986 .alignLeft,
987 .alignCenter,
988 .alignRight {
989 margin: 1em 0 0 0;
990 }
991 /* In print, the pilcrow won't show on hover, so prevent it from taking up space,
992 possibly even requiring a new line */
993 @media print {
994 a.pilcrow {
995 display: none;
996 }
997 }
998 /* Styling for the external metadata */
999 div#external-metadata {
1000 background-color: #eee;
1001 padding: 0.5em;
1002 margin-bottom: 0.5em;
1003 display: none;
1004 }
1005 div#internal-metadata {
1006 padding: 0.5em; /* to match the external-metadata padding */
1007 }
1008 /* Styling for title RFC Number */
1009 h1#rfcnum {
1010 clear: both;
1011 margin: 0 0 -1em;
1012 padding: 1em 0 0 0;
1013 }
1014 /* Make .olPercent look the same as <ol><li> */
1015 dl.olPercent > dd {
1016 margin-bottom: 0.25em;
1017 min-height: initial;
1018 }
1019 /* Give aside some styling to set it apart */
1020 aside {
1021 border-left: 1px solid #ddd;
1022 margin: 1em 0 1em 2em;
1023 padding: 0.2em 2em;
1024 }
1025 aside > dl,
1026 aside > ol,
1027 aside > ul,
1028 aside > table,
1029 aside > p {
1030 margin-bottom: 0.5em;
1031 }
1032 /* Additional page break settings */
1033 @media print {
1034 figcaption, table caption {
1035 page-break-before: avoid;
1036 }
1037 }
1038 /* Font size adjustments for print */
1039 @media print {
1040 body { font-size: 10pt; line-height: normal; max-width: 96%; }
1041 h1 { font-size: 1.72em; padding-top: 1.5em; } /* 1*1.2*1.2*1.2 */
1042 h2 { font-size: 1.44em; padding-top: 1.5em; } /* 1*1.2*1.2 */
1043 h3 { font-size: 1.2em; padding-top: 1.5em; } /* 1*1.2 */
1044 h4 { font-size: 1em; padding-top: 1.5em; }
1045 h5, h6 { font-size: 1em; margin: initial; padding: 0.5em 0 0.3em; }
1046 }
1047 /* Sourcecode margin in print, when there's no pilcrow */
1048 @media print {
1049 .artwork,
1050 .artwork > pre,
1051 .sourcecode {
1052 margin-bottom: 1em;
1053 }
1054 }
1055 /* Avoid narrow tables forcing too narrow table captions, which may render badly */
1056 table {
1057 min-width: 20em;
1058 }
1059 /* ol type a */
1060 ol.type-a { list-style-type: lower-alpha; }
1061 ol.type-A { list-style-type: upper-alpha; }
1062 ol.type-i { list-style-type: lower-roman; }
1063 ol.type-I { list-style-type: lower-roman; }
1064 /* Apply the print table and row borders in general, on request from the RPC,
1065 and increase the contrast between border and odd row background sligthtly */
1066 table {
1067 border: 1px solid #ddd;
1068 }
1069 td {
1070 border-top: 1px solid #ddd;
1071 }
1072 tr {
1073 break-inside: avoid;
1074 }
1075 tr:nth-child(2n+1) > td {
1076 background-color: #f8f8f8;
1077 }
1078 /* Use style rules to govern display of the TOC. */
1079 @media screen and (max-width: 1023px) {
1080 #toc nav { display: none; }
1081 #toc.active nav { display: block; }
1082 }
1083 /* Add support for keepWithNext */
1084 .keepWithNext {
1085 break-after: avoid-page;
1086 break-after: avoid-page;
1087 }
1088 /* Add support for keepWithPrevious */
1089 .keepWithPrevious {
1090 break-before: avoid-page;
1091 }
1092 /* Change the approach to avoiding breaks inside artwork etc. */
1093 figure, pre, table, .artwork, .sourcecode {
1094 break-before: auto;
1095 break-after: auto;
1096 }
1097 /* Avoid breaks between <dt> and <dd> */
1098 dl {
1099 break-before: auto;
1100 break-inside: auto;
1101 }
1102 dt {
1103 break-before: auto;
1104 break-after: avoid-page;
1105 }
1106 dd {
1107 break-before: avoid-page;
1108 break-after: auto;
1109 orphans: 3;
1110 widows: 3
1111 }
1112 span.break, dd.break {
1113 margin-bottom: 0;
1114 min-height: 0;
1115 break-before: auto;
1116 break-inside: auto;
1117 break-after: auto;
1118 }
1119 /* Undo break-before ToC */
1120 @media print {
1121 #toc {
1122 break-before: auto;
1123 }
1124 }
1125 /* Text in compact lists should not get extra bottim margin space,
1126 since that would makes the list not compact */
1127 ul.compact p, .ulCompact p,
1128 ol.compact p, .olCompact p {
1129 margin: 0;
1130 }
1131 /* But the list as a whole needs the extra space at the end */
1132 section ul.compact,
1133 section .ulCompact,
1134 section ol.compact,
1135 section .olCompact {
1136 margin-bottom: 1em; /* same as p not within ul.compact etc. */
1137 }
1138 /* The tt and code background above interferes with for instance table cell
1139 backgrounds. Changed to something a bit more selective. */
1140 tt, code {
1141 background-color: transparent;
1142 }
1143 p tt, p code, li tt, li code {
1144 background-color: #f8f8f8;
1145 }
1146 /* Tweak the pre margin -- 0px doesn't come out well */
1147 pre {
1148 margin-top: 0.5px;
1149 }
1150 /* Tweak the comact list text */
1151 ul.compact, .ulCompact,
1152 ol.compact, .olCompact,
1153 dl.compact, .dlCompact {
1154 line-height: normal;
1155 }
1156 /* Don't add top margin for nested lists */
1157 li > ul, li > ol, li > dl,
1158 dd > ul, dd > ol, dd > dl,
1159 dl > dd > dl {
1160 margin-top: initial;
1161 }
1162 /* Elements that should not be rendered on the same line as a <dt> */
1163 /* This should match the element list in writer.text.TextWriter.render_dl() */
1164 dd > div.artwork:first-child,
1165 dd > aside:first-child,
1166 dd > figure:first-child,
1167 dd > ol:first-child,
1168 dd > div:first-child > pre.sourcecode,
1169 dd > table:first-child,
1170 dd > ul:first-child {
1171 clear: left;
1172 }
1173 /* fix for weird browser behaviour when <dd/> is empty */
1174 dt+dd:empty::before{
1175 content: "\00a0";
1176 }
1177 /* Make paragraph spacing inside <li> smaller than in body text, to fit better within the list */
1178 li > p {
1179 margin-bottom: 0.5em
1180 }
1181 /* Don't let p margin spill out from inside list items */
1182 li > p:last-of-type {
1183 margin-bottom: 0;
1184 }
1185 </style>
1186 <link href="rfc-local.css" rel="stylesheet" type="text/css">
1187 <link href="https://dx.doi.org/10.17487/rfc9194" rel="alternate">
1188 <link href="urn:issn:2070-1721" rel="alternate">
1189 <link href="https://datatracker.ietf.org/doc/draft-ietf-lsr-yang-isis-reverse-metric-06" rel="prev">
1190 </head>
1191 <body class="xml2rfc">
1192 <script src="https://www.rfc-editor.org/js/metadata.min.js"></script>
1193 <table class="ears">
1194 <thead><tr>
1195 <td class="left">RFC 9194</td>
1196 <td class="center">YANG Module for IS-IS Reverse Metric</td>
1197 <td class="right">October 2022</td>
1198 </tr></thead>
1199 <tfoot><tr>
1200 <td class="left">Hopps</td>
1201 <td class="center">Standards Track</td>
1202 <td class="right">[Page]</td>
1203 </tr></tfoot>
1204 </table>
1205 <div id="external-metadata" class="document-information"></div>
1206 <div id="internal-metadata" class="document-information">
1207 <dl id="identifiers">
1208 <dt class="label-stream">Stream:</dt>
1209 <dd class="stream">Internet Engineering Task Force (IETF)</dd>
1210 <dt class="label-rfc">RFC:</dt>
1211 <dd class="rfc"><a href="https://www.rfc-editor.org/rfc/rfc9194" class="eref">9194</a></dd>
1212 <dt class="label-category">Category:</dt>
1213 <dd class="category">Standards Track</dd>
1214 <dt class="label-published">Published:</dt>
1215 <dd class="published">
1216 <time datetime="2022-10" class="published">October 2022</time>
1217 </dd>
1218 <dt class="label-issn">ISSN:</dt>
1219 <dd class="issn">2070-1721</dd>
1220 <dt class="label-authors">Author:</dt>
1221 <dd class="authors">
1222 <div class="author">
1223 <div class="author-name">C. Hopps</div>
1224 <div class="org">LabN Consulting, L.L.C.</div>
1225 </div>
1226 </dd>
1227 </dl>
1228 </div>
1229 <h1 id="rfcnum">RFC 9194</h1>
1230 <h1 id="title">A YANG Module for IS-IS Reverse Metric</h1>
1231 <section id="section-abstract">
1232 <h2 id="abstract"><a href="#abstract" class="selfRef">Abstract</a></h2>
1233 <p id="section-abstract-1">This document defines a YANG module for managing the reverse metric
1234 extension to the Intermediate System to Intermediate System (IS-IS)
1235 intra-domain routing information exchange protocol.<a href="#section-abstract-1" class="pilcrow">¶</a></p>
1236 </section>
1237 <div id="status-of-memo">
1238 <section id="section-boilerplate.1">
1239 <h2 id="name-status-of-this-memo">
1240 <a href="#name-status-of-this-memo" class="section-name selfRef">Status of This Memo</a>
1241 </h2>
1242 <p id="section-boilerplate.1-1">
1243 This is an Internet Standards Track document.<a href="#section-boilerplate.1-1" class="pilcrow">¶</a></p>
1244 <p id="section-boilerplate.1-2">
1245 This document is a product of the Internet Engineering Task Force
1246 (IETF). It represents the consensus of the IETF community. It has
1247 received public review and has been approved for publication by
1248 the Internet Engineering Steering Group (IESG). Further
1249 information on Internet Standards is available in Section 2 of
1250 RFC 7841.<a href="#section-boilerplate.1-2" class="pilcrow">¶</a></p>
1251 <p id="section-boilerplate.1-3">
1252 Information about the current status of this document, any
1253 errata, and how to provide feedback on it may be obtained at
1254 <span><a href="https://www.rfc-editor.org/info/rfc9194">https://www.rfc-editor.org/info/rfc9194</a></span>.<a href="#section-boilerplate.1-3" class="pilcrow">¶</a></p>
1255 </section>
1256 </div>
1257 <div id="copyright">
1258 <section id="section-boilerplate.2">
1259 <h2 id="name-copyright-notice">
1260 <a href="#name-copyright-notice" class="section-name selfRef">Copyright Notice</a>
1261 </h2>
1262 <p id="section-boilerplate.2-1">
1263 Copyright (c) 2022 IETF Trust and the persons identified as the
1264 document authors. All rights reserved.<a href="#section-boilerplate.2-1" class="pilcrow">¶</a></p>
1265 <p id="section-boilerplate.2-2">
1266 This document is subject to BCP 78 and the IETF Trust's Legal
1267 Provisions Relating to IETF Documents
1268 (<span><a href="https://trustee.ietf.org/license-info">https://trustee.ietf.org/license-info</a></span>) in effect on the date of
1269 publication of this document. Please review these documents
1270 carefully, as they describe your rights and restrictions with
1271 respect to this document. Code Components extracted from this
1272 document must include Revised BSD License text as described in
1273 Section 4.e of the Trust Legal Provisions and are provided without
1274 warranty as described in the Revised BSD License.<a href="#section-boilerplate.2-2" class="pilcrow">¶</a></p>
1275 </section>
1276 </div>
1277 <div id="toc">
1278 <section id="section-toc.1">
1279 <a href="#" onclick="scroll(0,0)" class="toplink">▲</a><h2 id="name-table-of-contents">
1280 <a href="#name-table-of-contents" class="section-name selfRef">Table of Contents</a>
1281 </h2>
1282 <nav class="toc"><ul class="compact toc ulBare ulEmpty">
1283 <li class="compact toc ulBare ulEmpty" id="section-toc.1-1.1">
1284 <p id="section-toc.1-1.1.1" class="keepWithNext"><a href="#section-1" class="auto internal xref">1</a>.  <a href="#name-introduction" class="internal xref">Introduction</a></p>
1285 </li>
1286 <li class="compact toc ulBare ulEmpty" id="section-toc.1-1.2">
1287 <p id="section-toc.1-1.2.1"><a href="#section-2" class="auto internal xref">2</a>.  <a href="#name-yang-management" class="internal xref">YANG Management</a></p>
1288 <ul class="compact toc ulBare ulEmpty">
1289 <li class="compact toc ulBare ulEmpty" id="section-toc.1-1.2.2.1">
1290 <p id="section-toc.1-1.2.2.1.1" class="keepWithNext"><a href="#section-2.1" class="auto internal xref">2.1</a>.  <a href="#name-yang-tree" class="internal xref">YANG Tree</a></p>
1291 </li>
1292 <li class="compact toc ulBare ulEmpty" id="section-toc.1-1.2.2.2">
1293 <p id="section-toc.1-1.2.2.2.1" class="keepWithNext"><a href="#section-2.2" class="auto internal xref">2.2</a>.  <a href="#name-yang-module" class="internal xref">YANG Module</a></p>
1294 </li>
1295 </ul>
1296 </li>
1297 <li class="compact toc ulBare ulEmpty" id="section-toc.1-1.3">
1298 <p id="section-toc.1-1.3.1"><a href="#section-3" class="auto internal xref">3</a>.  <a href="#name-iana-considerations" class="internal xref">IANA Considerations</a></p>
1299 <ul class="compact toc ulBare ulEmpty">
1300 <li class="compact toc ulBare ulEmpty" id="section-toc.1-1.3.2.1">
1301 <p id="section-toc.1-1.3.2.1.1"><a href="#section-3.1" class="auto internal xref">3.1</a>.  <a href="#name-updates-to-the-ietf-xml-reg" class="internal xref">Updates to the IETF XML Registry</a></p>
1302 </li>
1303 <li class="compact toc ulBare ulEmpty" id="section-toc.1-1.3.2.2">
1304 <p id="section-toc.1-1.3.2.2.1"><a href="#section-3.2" class="auto internal xref">3.2</a>.  <a href="#name-updates-to-the-yang-module-" class="internal xref">Updates to the YANG Module Names Registry</a></p>
1305 </li>
1306 </ul>
1307 </li>
1308 <li class="compact toc ulBare ulEmpty" id="section-toc.1-1.4">
1309 <p id="section-toc.1-1.4.1"><a href="#section-4" class="auto internal xref">4</a>.  <a href="#name-security-considerations" class="internal xref">Security Considerations</a></p>
1310 </li>
1311 <li class="compact toc ulBare ulEmpty" id="section-toc.1-1.5">
1312 <p id="section-toc.1-1.5.1"><a href="#section-5" class="auto internal xref">5</a>.  <a href="#name-normative-references" class="internal xref">Normative References</a></p>
1313 </li>
1314 <li class="compact toc ulBare ulEmpty" id="section-toc.1-1.6">
1315 <p id="section-toc.1-1.6.1"><a href="#section-6" class="auto internal xref">6</a>.  <a href="#name-informative-references" class="internal xref">Informative References</a></p>
1316 </li>
1317 <li class="compact toc ulBare ulEmpty" id="section-toc.1-1.7">
1318 <p id="section-toc.1-1.7.1"><a href="#appendix-A" class="auto internal xref">Appendix A</a>.  <a href="#name-examples" class="internal xref">Examples</a></p>
1319 <ul class="compact toc ulBare ulEmpty">
1320 <li class="compact toc ulBare ulEmpty" id="section-toc.1-1.7.2.1">
1321 <p id="section-toc.1-1.7.2.1.1"><a href="#appendix-A.1" class="auto internal xref">A.1</a>.  <a href="#name-enablement-example-using-xm" class="internal xref">Enablement Example Using XML YANG Instance Data</a></p>
1322 </li>
1323 <li class="compact toc ulBare ulEmpty" id="section-toc.1-1.7.2.2">
1324 <p id="section-toc.1-1.7.2.2.1"><a href="#appendix-A.2" class="auto internal xref">A.2</a>.  <a href="#name-usage-example-using-xml-yan" class="internal xref">Usage Example Using XML YANG Instance Data</a></p>
1325 </li>
1326 <li class="compact toc ulBare ulEmpty" id="section-toc.1-1.7.2.3">
1327 <p id="section-toc.1-1.7.2.3.1"><a href="#appendix-A.3" class="auto internal xref">A.3</a>.  <a href="#name-usage-example-using-json-ya" class="internal xref">Usage Example Using JSON YANG Instance Data</a></p>
1328 </li>
1329 </ul>
1330 </li>
1331 <li class="compact toc ulBare ulEmpty" id="section-toc.1-1.8">
1332 <p id="section-toc.1-1.8.1"><a href="#appendix-B" class="auto internal xref"></a><a href="#name-authors-address" class="internal xref">Author's Address</a></p>
1333 </li>
1334 </ul>
1335 </nav>
1336 </section>
1337 </div>
1338 <section id="section-1">
1339 <h2 id="name-introduction">
1340 <a href="#section-1" class="section-number selfRef">1. </a><a href="#name-introduction" class="section-name selfRef">Introduction</a>
1341 </h2>
1342 <p id="section-1-1">This document defines a YANG module for managing the reverse metric
1343 extension to IS-IS <span>[<a href="#RFC8500" class="cite xref">RFC8500</a>]</span> <span>[<a href="#ISO-10589" class="cite xref">ISO-10589</a>]</span>. Please refer to <span>[<a href="#RFC8500" class="cite xref">RFC8500</a>]</span> for the
1344 description and definition of the functionality managed by this
1345 module.<a href="#section-1-1" class="pilcrow">¶</a></p>
1346 <p id="section-1-2">The YANG data model described in this document conforms to the
1347 Network Management Datastore Architecture defined in <span>[<a href="#RFC8342" class="cite xref">RFC8342</a>]</span>.<a href="#section-1-2" class="pilcrow">¶</a></p>
1348 </section>
1349 <section id="section-2">
1350 <h2 id="name-yang-management">
1351 <a href="#section-2" class="section-number selfRef">2. </a><a href="#name-yang-management" class="section-name selfRef">YANG Management</a>
1352 </h2>
1353 <section id="section-2.1">
1354 <h3 id="name-yang-tree">
1355 <a href="#section-2.1" class="section-number selfRef">2.1. </a><a href="#name-yang-tree" class="section-name selfRef">YANG Tree</a>
1356 </h3>
1357 <p id="section-2.1-1">The following is the YANG tree diagram <span>[<a href="#RFC8340" class="cite xref">RFC8340</a>]</span> for the IS-IS
1358 reverse metric extension additions.<a href="#section-2.1-1" class="pilcrow">¶</a></p>
1359 <div id="section-2.1-2">
1360 <pre class="lang-yangtree sourcecode">
1361 module: ietf-isis-reverse-metric
1362 augment /rt:routing/rt:control-plane-protocols
1363 /rt:control-plane-protocol/isis:isis:
1364 +--rw reverse-metric
1365 +--rw enable-receive? boolean
1366 augment /rt:routing/rt:control-plane-protocols
1367 /rt:control-plane-protocol/isis:isis/isis:interfaces
1368 /isis:interface:
1369 +--rw reverse-metric
1370 +--rw metric? isis:wide-metric
1371 +--rw flags
1372 | +--rw whole-lan? boolean
1373 | +--rw allow-unreachable? boolean
1374 +--rw exclude-te-metric? boolean
1375 +--rw level-1
1376 | +--rw metric? isis:wide-metric
1377 | +--rw flags
1378 | | +--rw whole-lan? boolean
1379 | | +--rw allow-unreachable? boolean
1380 | +--rw exclude-te-metric? boolean
1381 +--rw level-2
1382 +--rw metric? isis:wide-metric
1383 +--rw flags
1384 | +--rw whole-lan? boolean
1385 | +--rw allow-unreachable? boolean
1386 +--rw exclude-te-metric? boolean
1387 augment /rt:routing/rt:control-plane-protocols
1388 /rt:control-plane-protocol/isis:isis/isis:interfaces
1389 /isis:interface/isis:adjacencies/isis:adjacency:
1390 +--ro reverse-metric
1391 +--ro metric? isis:wide-metric
1392 +--ro flags
1393 | +--ro whole-lan? boolean
1394 | +--ro allow-unreachable? boolean
1395 +--ro te-metric? uint32
1396 </pre><a href="#section-2.1-2" class="pilcrow">¶</a>
1397 </div>
1398 </section>
1399 <section id="section-2.2">
1400 <h3 id="name-yang-module">
1401 <a href="#section-2.2" class="section-number selfRef">2.2. </a><a href="#name-yang-module" class="section-name selfRef">YANG Module</a>
1402 </h3>
1403 <p id="section-2.2-1">The following is the YANG module for managing the IS-IS reverse
1404 metric functionality defined in <span>[<a href="#RFC8500" class="cite xref">RFC8500</a>]</span>. It imports modules from <span>[<a href="#RFC8349" class="cite xref">RFC8349</a>]</span> and <span>[<a href="#RFC9130" class="cite xref">RFC9130</a>]</span>.<a href="#section-2.2-1" class="pilcrow">¶</a></p>
1405 <p id="section-2.2-2">This YANG module uses the same per-level hierarchical configuration
1406 structure as that defined in the augmented base module.<a href="#section-2.2-2" class="pilcrow">¶</a></p>
1407 <div id="section-2.2-3">
1408 <pre class="breakable lang-yang sourcecode">&lt;CODE BEGINS&gt; file "[email protected]"
1409
1410 module ietf-isis-reverse-metric {
1411 yang-version 1.1;
1412 namespace "urn:ietf:params:xml:ns:yang:ietf-isis-reverse-metric";
1413 prefix isis-rmetric;
1414
1415 import ietf-routing {
1416 prefix rt;
1417 reference
1418 "RFC 8349: A YANG Data Model for Routing Management
1419 (NMDA Version)";
1420 }
1421 import ietf-isis {
1422 prefix isis;
1423 reference
1424 "RFC 9130: YANG Data Model for the IS-IS Protocol";
1425 }
1426
1427 organization
1428 "IETF LSR Working Group (LSR)";
1429
1430 contact
1431 "WG Web: &lt;https://datatracker.ietf.org/wg/lsr/&gt;
1432 WG List: &lt;mailto:[email protected]&gt;
1433
1434 Author: Christian Hopps
1435 &lt;mailto:[email protected]&gt;";
1436
1437 description
1438 "This module defines the configuration and operational state
1439 for managing the IS-IS reverse metric functionality
1440 (RFC 8500).
1441
1442 Copyright (c) 2022 IETF Trust and the persons identified as
1443 authors of the code. All rights reserved.
1444
1445 Redistribution and use in source and binary forms, with or
1446 without modification, is permitted pursuant to, and subject to
1447 the license terms contained in, the Revised BSD License set
1448 forth in Section 4.c of the IETF Trust's Legal Provisions
1449 Relating to IETF Documents
1450 (https://trustee.ietf.org/license-info).
1451
1452 This version of this YANG module is part of RFC 9194; see the
1453 RFC itself for full legal notices.";
1454 reference
1455 "RFC 8500: IS-IS Routing with Reverse Metric";
1456
1457 revision 2022-10-19 {
1458 description
1459 "Initial revision.";
1460 reference
1461 "RFC 9194: A YANG Module for IS-IS Reverse Metric";
1462 }
1463
1464 grouping reverse-metric-data {
1465 description
1466 "IS-IS reverse metric data.";
1467 leaf metric {
1468 type isis:wide-metric;
1469 description
1470 "The reverse metric value.";
1471 reference
1472 "RFC 8500: IS-IS Routing with Reverse Metric, Section 2";
1473 }
1474 container flags {
1475 description
1476 "The reverse metric flag values.";
1477 leaf whole-lan {
1478 type boolean;
1479 description
1480 "The 'Whole LAN' bit (W bit) (RFC 8500). If true, then
1481 a Designated Intermediate System (DIS) processing this
1482 reverse metric will add the metric value to all the
1483 nodes it advertises in the pseudonode Link State
1484 Protocol Data Unit (LSP) for this interface.
1485 Otherwise, it will only increment the metric for the
1486 advertising node in the pseudonode LSP for this
1487 interface.";
1488 reference
1489 "RFC 8500: IS-IS Routing with Reverse Metric,
1490 Section 2";
1491 }
1492 leaf allow-unreachable {
1493 type boolean;
1494 description
1495 "The 'Unreachable' bit (U bit) (RFC 8500). If true, it
1496 allows the neighbor to increment the overall metric up
1497 to 2^24-1 rather than the lesser maximum of 2^24-2.
1498 If the metric is then set by the neighbor to 2^24-1,
1499 it will cause traffic to stop using, rather than avoid
1500 using, the interface.";
1501 reference
1502 "RFC 8500: IS-IS Routing with Reverse Metric,
1503 Section 2";
1504 }
1505 }
1506 }
1507
1508 grouping reverse-metric-if-config-data {
1509 description
1510 "IS-IS reverse metric config data.";
1511 uses reverse-metric-data;
1512 leaf exclude-te-metric {
1513 type boolean;
1514 default "false";
1515 description
1516 "If true and there is a TE metric defined for this
1517 interface, then do not send the Traffic Engineering
1518 Metric sub-TLV in the Reverse Metric TLV.";
1519
1520 reference
1521 "RFC 8500: IS-IS Routing with Reverse Metric, Section 2";
1522 }
1523 }
1524
1525 grouping tlv16-reverse-metric {
1526 description
1527 "IS-IS Reverse Metric TLV data.";
1528 uses reverse-metric-data;
1529 leaf te-metric {
1530 type uint32;
1531 description
1532 "The TE metric value from the sub-TLV, if present.";
1533 reference
1534 "RFC 8500: IS-IS Routing with Reverse Metric, Section 2";
1535 }
1536 }
1537
1538 augment "/rt:routing/rt:control-plane-protocols/"
1539 + "rt:control-plane-protocol/"
1540 + "isis:isis" {
1541 when "derived-from-or-self(../rt:type, 'isis:isis')" {
1542 description
1543 "This augment is only valid when the routing protocol
1544 instance type is 'isis'.";
1545 }
1546
1547 description
1548 "The reverse metric configuration for an IS-IS instance.";
1549
1550 container reverse-metric {
1551 description
1552 "Global reverse metric configuration.";
1553 leaf enable-receive {
1554 type boolean;
1555 default "false";
1556 description
1557 "Enables handling of reverse metric announcements from
1558 neighbors. By default, reverse metric handling is
1559 disabled and must be explicitly enabled through this
1560 configuration.";
1561 }
1562 }
1563 }
1564
1565 augment "/rt:routing/rt:control-plane-protocols/"
1566 + "rt:control-plane-protocol/"
1567 + "isis:isis/isis:interfaces/isis:interface" {
1568 when "derived-from-or-self(../../../rt:type, 'isis:isis')" {
1569 description
1570 "This augment is only valid when the routing protocol
1571 instance type is 'isis'.";
1572 }
1573
1574 description
1575 "The reverse metric configuration for an interface.";
1576
1577 container reverse-metric {
1578 description
1579 "Announces a reverse metric to neighbors. The
1580 configuration is hierarchical and follows the same
1581 behavior as that defined for per-level values in the
1582 augmented base module.
1583
1584 Reverse metric operation is enabled by the configuration
1585 of a 'reverse-metric' metric value either at the top
1586 level or under a level-specific container node. If a
1587 'reverse-metric' metric value is only specified under a
1588 level-specific container node, then operation is only
1589 enabled at the specified level.
1590
1591 As the reverse metric is advertised in IS-IS Hello
1592 Protocol Data Units (IIH PDUs), level-specific
1593 configuration is only available for broadcast interface
1594 types.";
1595 uses reverse-metric-if-config-data {
1596 refine "flags/whole-lan" {
1597 default "false";
1598 }
1599 refine "flags/allow-unreachable" {
1600 default "false";
1601 }
1602 }
1603 container level-1 {
1604 when '../../isis:interface-type = "broadcast"';
1605 description
1606 "Announces a reverse metric to level-1 neighbors.";
1607 uses reverse-metric-if-config-data;
1608 }
1609 container level-2 {
1610 when '../../isis:interface-type = "broadcast"';
1611 description
1612 "Announces a reverse metric to level-2 neighbors.";
1613 uses reverse-metric-if-config-data;
1614 }
1615 }
1616 }
1617 augment "/rt:routing/rt:control-plane-protocols/"
1618 + "rt:control-plane-protocol/"
1619 + "isis:isis/isis:interfaces/isis:interface/"
1620 + "isis:adjacencies/isis:adjacency" {
1621 when "derived-from-or-self(../../../../../rt:type,
1622 'isis:isis')" {
1623 description
1624 "This augment is only valid when the routing protocol
1625 instance type is 'isis'.";
1626 }
1627
1628 description
1629 "The reverse metric state advertised by an adjacency.";
1630 container reverse-metric {
1631 description
1632 "IS-IS Reverse Metric TLV data.";
1633 uses tlv16-reverse-metric;
1634 }
1635 }
1636 }
1637
1638 &lt;CODE ENDS&gt;</pre><a href="#section-2.2-3" class="pilcrow">¶</a>
1639 </div>
1640 </section>
1641 </section>
1642 <section id="section-3">
1643 <h2 id="name-iana-considerations">
1644 <a href="#section-3" class="section-number selfRef">3. </a><a href="#name-iana-considerations" class="section-name selfRef">IANA Considerations</a>
1645 </h2>
1646 <section id="section-3.1">
1647 <h3 id="name-updates-to-the-ietf-xml-reg">
1648 <a href="#section-3.1" class="section-number selfRef">3.1. </a><a href="#name-updates-to-the-ietf-xml-reg" class="section-name selfRef">Updates to the IETF XML Registry</a>
1649 </h3>
1650 <p id="section-3.1-1">This document registers a URI in the "IETF XML Registry" <span>[<a href="#RFC3688" class="cite xref">RFC3688</a>]</span>.
1651 Following the format in <span>[<a href="#RFC3688" class="cite xref">RFC3688</a>]</span>, the following registration has been
1652 made:<a href="#section-3.1-1" class="pilcrow">¶</a></p>
1653 <span class="break"></span><dl class="dlCompact dlParallel" id="section-3.1-2">
1654 <dt id="section-3.1-2.1">URI:</dt>
1655 <dd style="margin-left: 1.5em" id="section-3.1-2.2">urn:ietf:params:xml:ns:yang:ietf-isis-reverse-metric<a href="#section-3.1-2.2" class="pilcrow">¶</a>
1656 </dd>
1657 <dd class="break"></dd>
1658 <dt id="section-3.1-2.3">Registrant Contact:</dt>
1659 <dd style="margin-left: 1.5em" id="section-3.1-2.4">The IESG.<a href="#section-3.1-2.4" class="pilcrow">¶</a>
1660 </dd>
1661 <dd class="break"></dd>
1662 <dt id="section-3.1-2.5">XML:</dt>
1663 <dd style="margin-left: 1.5em" id="section-3.1-2.6">N/A; the requested URI is an XML namespace.<a href="#section-3.1-2.6" class="pilcrow">¶</a>
1664 </dd>
1665 <dd class="break"></dd>
1666 </dl>
1667 </section>
1668 <section id="section-3.2">
1669 <h3 id="name-updates-to-the-yang-module-">
1670 <a href="#section-3.2" class="section-number selfRef">3.2. </a><a href="#name-updates-to-the-yang-module-" class="section-name selfRef">Updates to the YANG Module Names Registry</a>
1671 </h3>
1672 <p id="section-3.2-1">This document registers one YANG module in the "YANG Module Names"
1673 registry <span>[<a href="#RFC6020" class="cite xref">RFC6020</a>]</span>. Following the format in <span>[<a href="#RFC6020" class="cite xref">RFC6020</a>]</span>, the following
1674 registration has been made:<a href="#section-3.2-1" class="pilcrow">¶</a></p>
1675 <span class="break"></span><dl class="dlCompact dlParallel" id="section-3.2-2">
1676 <dt id="section-3.2-2.1">Name:</dt>
1677 <dd style="margin-left: 1.5em" id="section-3.2-2.2">ietf-isis-reverse-metric<a href="#section-3.2-2.2" class="pilcrow">¶</a>
1678 </dd>
1679 <dd class="break"></dd>
1680 <dt id="section-3.2-2.3">Maintained by IANA?</dt>
1681 <dd style="margin-left: 1.5em" id="section-3.2-2.4">N<a href="#section-3.2-2.4" class="pilcrow">¶</a>
1682 </dd>
1683 <dd class="break"></dd>
1684 <dt id="section-3.2-2.5">Namespace:</dt>
1685 <dd style="margin-left: 1.5em" id="section-3.2-2.6">urn:ietf:params:xml:ns:yang:ietf-isis-reverse-metric<a href="#section-3.2-2.6" class="pilcrow">¶</a>
1686 </dd>
1687 <dd class="break"></dd>
1688 <dt id="section-3.2-2.7">Prefix:</dt>
1689 <dd style="margin-left: 1.5em" id="section-3.2-2.8">isis-rmetric<a href="#section-3.2-2.8" class="pilcrow">¶</a>
1690 </dd>
1691 <dd class="break"></dd>
1692 <dt id="section-3.2-2.9">Reference:</dt>
1693 <dd style="margin-left: 1.5em" id="section-3.2-2.10">RFC 9194<a href="#section-3.2-2.10" class="pilcrow">¶</a>
1694 </dd>
1695 <dd class="break"></dd>
1696 </dl>
1697 </section>
1698 </section>
1699 <section id="section-4">
1700 <h2 id="name-security-considerations">
1701 <a href="#section-4" class="section-number selfRef">4. </a><a href="#name-security-considerations" class="section-name selfRef">Security Considerations</a>
1702 </h2>
1703 <p id="section-4-1">The YANG module specified in this document defines a schema for data
1704 that is designed to be accessed via network management protocols such
1705 as NETCONF <span>[<a href="#RFC6241" class="cite xref">RFC6241</a>]</span> or RESTCONF <span>[<a href="#RFC8040" class="cite xref">RFC8040</a>]</span>.
1706 The lowest NETCONF layer is the secure transport layer, and the
1707 mandatory-to-implement secure transport is Secure Shell (SSH)
1708 <span>[<a href="#RFC6242" class="cite xref">RFC6242</a>]</span>. The lowest RESTCONF layer is HTTPS, and the
1709 mandatory-to-implement secure transport is TLS <span>[<a href="#RFC8446" class="cite xref">RFC8446</a>]</span>.<a href="#section-4-1" class="pilcrow">¶</a></p>
1710 <p id="section-4-2">The Network Configuration Access Control Model (NACM) <span>[<a href="#RFC8341" class="cite xref">RFC8341</a>]</span>
1711 provides the means to restrict access for particular NETCONF or RESTCONF users
1712 to a preconfigured subset of all available NETCONF or RESTCONF protocol
1713 operations and content.<a href="#section-4-2" class="pilcrow">¶</a></p>
1714 <p id="section-4-3">The YANG module defined in this document can enable, disable, and
1715 modify the behavior of metrics used by routing. For the security
1716 implications regarding these types of changes, consult <span>[<a href="#RFC8500" class="cite xref">RFC8500</a>]</span> --
1717 which defines the functionality -- as well as <span>[<a href="#RFC9130" class="cite xref">RFC9130</a>]</span>.<a href="#section-4-3" class="pilcrow">¶</a></p>
1718 <p id="section-4-4">There are a number of data nodes defined in this YANG module that are
1719 writable/creatable/deletable (i.e., config true, which is the
1720 default). These data nodes may be considered sensitive or vulnerable
1721 in some network environments. Write operations (e.g., edit-config)
1722 to these data nodes without proper protection can have a negative effect
1723 on network operations. These YANG nodes correspond directly to the
1724 functionality provided in RFC 8500, and the security considerations of the
1725 functionality are described in RFC 8500.
1726 These are the subtrees and data nodes:<a href="#section-4-4" class="pilcrow">¶</a></p>
1727 <div class="alignLeft art-ascii-art art-text artwork" id="section-4-5">
1728 <pre>
1729 Under "/rt:routing/rt:control-plane-protocols/" +
1730 "rt:control-plane-protocol/isis:isis"
1731
1732 - /isis-rmetric:reverse-metric/isis-rmetric:enable-receive
1733 </pre><a href="#section-4-5" class="pilcrow">¶</a>
1734 </div>
1735 <div class="alignLeft art-ascii-art art-text artwork" id="section-4-6">
1736 <pre>
1737 Under "/rt:routing/rt:control-plane-protocols/" +
1738 "rt:control-plane-protocol/isis:isis/" +
1739 "isis:interfaces/isis:interface/" +
1740 "isis-rmetric:reverse-metric"
1741
1742 - /isis-rmetric:metric
1743 - /isis-rmetric:flags/isis-rmetric:whole-lan
1744 - /isis-rmetric:flags/isis-rmetric:allow-unreachable
1745 - /isis-rmetric:exclude-te-metric
1746 </pre><a href="#section-4-6" class="pilcrow">¶</a>
1747 </div>
1748 <div class="alignLeft art-ascii-art art-text artwork" id="section-4-7">
1749 <pre>
1750 Under "/rt:routing/rt:control-plane-protocols/" +
1751 "rt:control-plane-protocol/isis:isis/" +
1752 "isis:interfaces/isis:interface/" +
1753 "isis-rmetric:reverse-metric/" +
1754 "isis-rmetric:level-1/"
1755
1756 - /isis-rmetric:metric
1757 - /isis-rmetric:flags/isis-rmetric:whole-lan
1758 - /isis-rmetric:flags/isis-rmetric:allow-unreachable
1759 - /isis-rmetric:exclude-te-metric
1760 </pre><a href="#section-4-7" class="pilcrow">¶</a>
1761 </div>
1762 <div class="alignLeft art-ascii-art art-text artwork" id="section-4-8">
1763 <pre>
1764 Under "/rt:routing/rt:control-plane-protocols/" +
1765 "rt:control-plane-protocol/isis:isis/" +
1766 "isis:interfaces/isis:interface/" +
1767 "isis-rmetric:reverse-metric/" +
1768 "isis-rmetric:level-2/"
1769
1770 - /isis-rmetric:metric
1771 - /isis-rmetric:flags/isis-rmetric:whole-lan
1772 - /isis-rmetric:flags/isis-rmetric:allow-unreachable
1773 - /isis-rmetric:exclude-te-metric
1774 </pre><a href="#section-4-8" class="pilcrow">¶</a>
1775 </div>
1776 <p id="section-4-9">Some of the readable data nodes in this YANG module may be considered
1777 sensitive or vulnerable in some network environments. It is thus
1778 important to control read access (e.g., via get, get-config, or
1779 notification) to these data nodes. These YANG nodes correspond
1780 directly to the functionality provided in RFC 8500, and the security
1781 considerations of the functionality are described in RFC 8500.
1782 These are the subtrees and data nodes:<a href="#section-4-9" class="pilcrow">¶</a></p>
1783 <div class="alignLeft art-ascii-art art-text artwork" id="section-4-10">
1784 <pre>
1785 Under "/rt:routing/rt:control-plane-protocols/" +
1786 "rt:control-plane-protocol/isis:isis/" +
1787 "isis:interfaces/isis:interface/" +
1788 "isis:adjacencies/isis:adjacency/" +
1789 "isis-rmetric:reverse-metric"
1790
1791 - /isis-rmetric:metric
1792 - /isis-rmetric:flags/isis-rmetric:whole-lan
1793 - /isis-rmetric:flags/isis-rmetric:allow-unreachable
1794 - /isis-rmetric:te-metric
1795 </pre><a href="#section-4-10" class="pilcrow">¶</a>
1796 </div>
1797 </section>
1798 <section id="section-5">
1799 <h2 id="name-normative-references">
1800 <a href="#section-5" class="section-number selfRef">5. </a><a href="#name-normative-references" class="section-name selfRef">Normative References</a>
1801 </h2>
1802 <dl class="references">
1803 <dt id="ISO-10589">[ISO-10589]</dt>
1804 <dd>
1805 <span class="refAuthor">ISO</span>, <span class="refTitle">"Intermediate System to Intermediate System intra- domain routeing information exchange protocol for use in conjunction with the protocol for providing the connectionless-mode network service (ISO 8473)"</span>, <span class="refContent">International Standard 10589: 2002, Second Edition</span>, <time datetime="2002" class="refDate">2002</time>, <span>&lt;<a href="https://www.iso.org/standard/30932.html">https://www.iso.org/standard/30932.html</a>&gt;</span>. </dd>
1806 <dd class="break"></dd>
1807 <dt id="RFC3688">[RFC3688]</dt>
1808 <dd>
1809 <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>
1810 <dd class="break"></dd>
1811 <dt id="RFC6020">[RFC6020]</dt>
1812 <dd>
1813 <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>
1814 <dd class="break"></dd>
1815 <dt id="RFC6241">[RFC6241]</dt>
1816 <dd>
1817 <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>
1818 <dd class="break"></dd>
1819 <dt id="RFC6242">[RFC6242]</dt>
1820 <dd>
1821 <span class="refAuthor">Wasserman, M.</span>, <span class="refTitle">"Using the NETCONF Protocol over Secure Shell (SSH)"</span>, <span class="seriesInfo">RFC 6242</span>, <span class="seriesInfo">DOI 10.17487/RFC6242</span>, <time datetime="2011-06" class="refDate">June 2011</time>, <span>&lt;<a href="https://www.rfc-editor.org/info/rfc6242">https://www.rfc-editor.org/info/rfc6242</a>&gt;</span>. </dd>
1822 <dd class="break"></dd>
1823 <dt id="RFC8040">[RFC8040]</dt>
1824 <dd>
1825 <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>
1826 <dd class="break"></dd>
1827 <dt id="RFC8340">[RFC8340]</dt>
1828 <dd>
1829 <span class="refAuthor">Bjorklund, M.</span> and <span class="refAuthor">L. Berger, Ed.</span>, <span class="refTitle">"YANG Tree Diagrams"</span>, <span class="seriesInfo">BCP 215</span>, <span class="seriesInfo">RFC 8340</span>, <span class="seriesInfo">DOI 10.17487/RFC8340</span>, <time datetime="2018-03" class="refDate">March 2018</time>, <span>&lt;<a href="https://www.rfc-editor.org/info/rfc8340">https://www.rfc-editor.org/info/rfc8340</a>&gt;</span>. </dd>
1830 <dd class="break"></dd>
1831 <dt id="RFC8341">[RFC8341]</dt>
1832 <dd>
1833 <span class="refAuthor">Bierman, A.</span> and <span class="refAuthor">M. Bjorklund</span>, <span class="refTitle">"Network Configuration Access Control Model"</span>, <span class="seriesInfo">STD 91</span>, <span class="seriesInfo">RFC 8341</span>, <span class="seriesInfo">DOI 10.17487/RFC8341</span>, <time datetime="2018-03" class="refDate">March 2018</time>, <span>&lt;<a href="https://www.rfc-editor.org/info/rfc8341">https://www.rfc-editor.org/info/rfc8341</a>&gt;</span>. </dd>
1834 <dd class="break"></dd>
1835 <dt id="RFC8342">[RFC8342]</dt>
1836 <dd>
1837 <span class="refAuthor">Bjorklund, M.</span>, <span class="refAuthor">Schoenwaelder, J.</span>, <span class="refAuthor">Shafer, P.</span>, <span class="refAuthor">Watsen, K.</span>, and <span class="refAuthor">R. Wilton</span>, <span class="refTitle">"Network Management Datastore Architecture (NMDA)"</span>, <span class="seriesInfo">RFC 8342</span>, <span class="seriesInfo">DOI 10.17487/RFC8342</span>, <time datetime="2018-03" class="refDate">March 2018</time>, <span>&lt;<a href="https://www.rfc-editor.org/info/rfc8342">https://www.rfc-editor.org/info/rfc8342</a>&gt;</span>. </dd>
1838 <dd class="break"></dd>
1839 <dt id="RFC8349">[RFC8349]</dt>
1840 <dd>
1841 <span class="refAuthor">Lhotka, L.</span>, <span class="refAuthor">Lindem, A.</span>, and <span class="refAuthor">Y. Qu</span>, <span class="refTitle">"A YANG Data Model for Routing Management (NMDA Version)"</span>, <span class="seriesInfo">RFC 8349</span>, <span class="seriesInfo">DOI 10.17487/RFC8349</span>, <time datetime="2018-03" class="refDate">March 2018</time>, <span>&lt;<a href="https://www.rfc-editor.org/info/rfc8349">https://www.rfc-editor.org/info/rfc8349</a>&gt;</span>. </dd>
1842 <dd class="break"></dd>
1843 <dt id="RFC8446">[RFC8446]</dt>
1844 <dd>
1845 <span class="refAuthor">Rescorla, E.</span>, <span class="refTitle">"The Transport Layer Security (TLS) Protocol Version 1.3"</span>, <span class="seriesInfo">RFC 8446</span>, <span class="seriesInfo">DOI 10.17487/RFC8446</span>, <time datetime="2018-08" class="refDate">August 2018</time>, <span>&lt;<a href="https://www.rfc-editor.org/info/rfc8446">https://www.rfc-editor.org/info/rfc8446</a>&gt;</span>. </dd>
1846 <dd class="break"></dd>
1847 <dt id="RFC8500">[RFC8500]</dt>
1848 <dd>
1849 <span class="refAuthor">Shen, N.</span>, <span class="refAuthor">Amante, S.</span>, and <span class="refAuthor">M. Abrahamsson</span>, <span class="refTitle">"IS-IS Routing with Reverse Metric"</span>, <span class="seriesInfo">RFC 8500</span>, <span class="seriesInfo">DOI 10.17487/RFC8500</span>, <time datetime="2019-02" class="refDate">February 2019</time>, <span>&lt;<a href="https://www.rfc-editor.org/info/rfc8500">https://www.rfc-editor.org/info/rfc8500</a>&gt;</span>. </dd>
1850 <dd class="break"></dd>
1851 <dt id="RFC9130">[RFC9130]</dt>
1852 <dd>
1853 <span class="refAuthor">Litkowski, S., Ed.</span>, <span class="refAuthor">Yeung, D.</span>, <span class="refAuthor">Lindem, A.</span>, <span class="refAuthor">Zhang, J.</span>, and <span class="refAuthor">L. Lhotka</span>, <span class="refTitle">"YANG Data Model for the IS-IS Protocol"</span>, <span class="seriesInfo">RFC 9130</span>, <span class="seriesInfo">DOI 10.17487/RFC9130</span>, <time datetime="2022-10" class="refDate">October 2022</time>, <span>&lt;<a href="https://www.rfc-editor.org/info/rfc9130">https://www.rfc-editor.org/info/rfc9130</a>&gt;</span>. </dd>
1854 <dd class="break"></dd>
1855 <dt id="W3C.REC-xml-20081126">[W3C.REC-xml-20081126]</dt>
1856 <dd>
1857 <span class="refAuthor">Bray, T.</span>, <span class="refAuthor">Paoli, J.</span>, <span class="refAuthor">Sperberg-McQueen, M.</span>, <span class="refAuthor">Maler, E.</span>, and <span class="refAuthor">F. Yergeau</span>, <span class="refTitle">"Extensible Markup Language (XML) 1.0 (Fifth Edition)"</span>, <span class="refContent">World Wide Web Consortium Recommendation REC-xml-20081126</span>, <time datetime="2008-11" class="refDate">November 2008</time>, <span>&lt;<a href="https://www.w3.org/TR/2008/REC-xml-20081126">https://www.w3.org/TR/2008/REC-xml-20081126</a>&gt;</span>. </dd>
1858 <dd class="break"></dd>
1859 </dl>
1860 </section>
1861 <section id="section-6">
1862 <h2 id="name-informative-references">
1863 <a href="#section-6" class="section-number selfRef">6. </a><a href="#name-informative-references" class="section-name selfRef">Informative References</a>
1864 </h2>
1865 <dl class="references">
1866 <dt id="RFC7951">[RFC7951]</dt>
1867 <dd>
1868 <span class="refAuthor">Lhotka, L.</span>, <span class="refTitle">"JSON Encoding of Data Modeled with YANG"</span>, <span class="seriesInfo">RFC 7951</span>, <span class="seriesInfo">DOI 10.17487/RFC7951</span>, <time datetime="2016-08" class="refDate">August 2016</time>, <span>&lt;<a href="https://www.rfc-editor.org/info/rfc7951">https://www.rfc-editor.org/info/rfc7951</a>&gt;</span>. </dd>
1869 <dd class="break"></dd>
1870 </dl>
1871 </section>
1872 <section id="appendix-A">
1873 <h2 id="name-examples">
1874 <a href="#appendix-A" class="section-number selfRef">Appendix A. </a><a href="#name-examples" class="section-name selfRef">Examples</a>
1875 </h2>
1876 <section id="appendix-A.1">
1877 <h3 id="name-enablement-example-using-xm">
1878 <a href="#appendix-A.1" class="section-number selfRef">A.1. </a><a href="#name-enablement-example-using-xm" class="section-name selfRef">Enablement Example Using XML YANG Instance Data</a>
1879 </h3>
1880 <p id="appendix-A.1-1">Below is an example of XML <span>[<a href="#W3C.REC-xml-20081126" class="cite xref">W3C.REC-xml-20081126</a>]</span> YANG instance data <span>[<a href="#RFC8342" class="cite xref">RFC8342</a>]</span> to enable reverse metric processing.<a href="#appendix-A.1-1" class="pilcrow">¶</a></p>
1881 <span id="name-example-xml-data-to-enable-"></span><figure id="figure-1">
1882 <div id="appendix-A.1-2.1">
1883 <pre class="lang-xml sourcecode">
1884 &lt;rt:routing
1885 xmlns:rt="urn:ietf:params:xml:ns:yang:ietf-routing"
1886 xmlns:isis="urn:ietf:params:xml:ns:yang:ietf-isis"
1887 xmlns:isis-rmetric=
1888 "urn:ietf:params:xml:ns:yang:ietf-isis-reverse-metric"&gt;
1889 &lt;rt:control-plane-protocols&gt;
1890 &lt;rt:control-plane-protocol&gt;
1891 &lt;rt:type&gt;isis:isis&lt;/rt:type&gt;
1892 &lt;rt:name&gt;default&lt;/rt:name&gt;
1893 &lt;isis:isis&gt;
1894 &lt;isis:area-address&gt;00&lt;/isis:area-address&gt;
1895 &lt;isis-rmetric:reverse-metric&gt;
1896 &lt;isis-rmetric:enable-receive&gt;true&lt;/isis-rmetric:enable-receive&gt;
1897 &lt;/isis-rmetric:reverse-metric&gt;
1898 &lt;/isis:isis&gt;
1899 &lt;/rt:control-plane-protocol&gt;
1900 &lt;/rt:control-plane-protocols&gt;
1901 &lt;/rt:routing&gt;
1902 </pre>
1903 </div>
1904 <figcaption><a href="#figure-1" class="selfRef">Figure 1</a>:
1905 <a href="#name-example-xml-data-to-enable-" class="selfRef">Example XML Data to Enable Reverse Metric Processing</a>
1906 </figcaption></figure>
1907 </section>
1908 <section id="appendix-A.2">
1909 <h3 id="name-usage-example-using-xml-yan">
1910 <a href="#appendix-A.2" class="section-number selfRef">A.2. </a><a href="#name-usage-example-using-xml-yan" class="section-name selfRef">Usage Example Using XML YANG Instance Data</a>
1911 </h3>
1912 <p id="appendix-A.2-1">Below is an example of XML YANG instance data <span>[<a href="#RFC8342" class="cite xref">RFC8342</a>]</span> for the
1913 "ietf-isis-reverse-metric" module.<a href="#appendix-A.2-1" class="pilcrow">¶</a></p>
1914 <span id="name-example-xml-data-for-the-ie"></span><figure id="figure-2">
1915 <div id="appendix-A.2-2.1">
1916 <pre class="lang-xml sourcecode">
1917 &lt;if:interfaces
1918 xmlns:if="urn:ietf:params:xml:ns:yang:ietf-interfaces"
1919 xmlns:ianaift="urn:ietf:params:xml:ns:yang:iana-if-type"&gt;
1920 &lt;if:interface&gt;
1921 &lt;if:name&gt;eth0&lt;/if:name&gt;
1922 &lt;if:type&gt;ianaift:ethernetCsmacd&lt;/if:type&gt;
1923 &lt;/if:interface&gt;
1924 &lt;/if:interfaces&gt;
1925 &lt;rt:routing
1926 xmlns:rt="urn:ietf:params:xml:ns:yang:ietf-routing"
1927 xmlns:isis="urn:ietf:params:xml:ns:yang:ietf-isis"
1928 xmlns:isis-rmetric=
1929 "urn:ietf:params:xml:ns:yang:ietf-isis-reverse-metric"&gt;
1930 &lt;rt:control-plane-protocols&gt;
1931 &lt;rt:control-plane-protocol&gt;
1932 &lt;rt:type&gt;isis:isis&lt;/rt:type&gt;
1933 &lt;rt:name&gt;default&lt;/rt:name&gt;
1934 &lt;isis:isis&gt;
1935 &lt;isis:area-address&gt;00&lt;/isis:area-address&gt;
1936 &lt;isis:interfaces&gt;
1937 &lt;isis:interface&gt;
1938 &lt;isis:name&gt;eth0&lt;/isis:name&gt;
1939 &lt;isis-rmetric:reverse-metric&gt;
1940 &lt;isis-rmetric:metric&gt;
1941 65535
1942 &lt;/isis-rmetric:metric&gt;
1943 &lt;/isis-rmetric:reverse-metric&gt;
1944 &lt;/isis:interface&gt;
1945 &lt;/isis:interfaces&gt;
1946 &lt;/isis:isis&gt;
1947 &lt;/rt:control-plane-protocol&gt;
1948 &lt;/rt:control-plane-protocols&gt;
1949 &lt;/rt:routing&gt;
1950 </pre>
1951 </div>
1952 <figcaption><a href="#figure-2" class="selfRef">Figure 2</a>:
1953 <a href="#name-example-xml-data-for-the-ie" class="selfRef">Example XML Data for the "ietf-isis-reverse-metric" Module</a>
1954 </figcaption></figure>
1955 </section>
1956 <section id="appendix-A.3">
1957 <h3 id="name-usage-example-using-json-ya">
1958 <a href="#appendix-A.3" class="section-number selfRef">A.3. </a><a href="#name-usage-example-using-json-ya" class="section-name selfRef">Usage Example Using JSON YANG Instance Data</a>
1959 </h3>
1960 <p id="appendix-A.3-1">Below is an example of JSON YANG instance data <span>[<a href="#RFC7951" class="cite xref">RFC7951</a>]</span> for the
1961 "ietf-isis-reverse-metric" module.<a href="#appendix-A.3-1" class="pilcrow">¶</a></p>
1962 <span id="name-example-json-data-for-the-l"></span><figure id="figure-3">
1963 <div id="appendix-A.3-2.1">
1964 <pre class="lang-json sourcecode">
1965 {
1966 "ietf-interfaces:interfaces": {
1967 "interface": [
1968 {
1969 "name": "eth0",
1970 "type": "iana-if-type:ethernetCsmacd"
1971 }
1972 ]
1973 },
1974 "ietf-routing:routing": {
1975 "control-plane-protocols": {
1976 "control-plane-protocol": [
1977 {
1978 "type": "ietf-isis:isis",
1979 "name": "default",
1980 "ietf-isis:isis": {
1981 "area-address": [
1982 "00"
1983 ],
1984 "interfaces": {
1985 "interface": [
1986 {
1987 "name": "eth0",
1988 "ietf-isis-reverse-metric:reverse-metric": {
1989 "level-1": {
1990 "metric": 65535,
1991 "exclude-te-metric": true
1992 }
1993 }
1994 }
1995 ]
1996 }
1997 }
1998 }
1999 ]
2000 }
2001 }
2002 }
2003 </pre>
2004 </div>
2005 <figcaption><a href="#figure-3" class="selfRef">Figure 3</a>:
2006 <a href="#name-example-json-data-for-the-l" class="selfRef">Example JSON Data for the Level-1-Only Reverse Metric</a>
2007 </figcaption></figure>
2008 </section>
2009 </section>
2010 <div id="authors-addresses">
2011 <section id="appendix-B">
2012 <h2 id="name-authors-address">
2013 <a href="#name-authors-address" class="section-name selfRef">Author's Address</a>
2014 </h2>
2015 <address class="vcard">
2016 <div dir="auto" class="left"><span class="fn nameRole">Christian Hopps</span></div>
2017 <div dir="auto" class="left"><span class="org">LabN Consulting, L.L.C.</span></div>
2018 <div class="email">
2019 <span>Email:</span>
2020 <a href="mailto:[email protected]" class="email">[email protected]</a>
2021 </div>
2022 </address>
2023 </section>
2024 </div>
2025 <script>const toc = document.getElementById("toc");
2026 toc.querySelector("h2").addEventListener("click", e => {
2027 toc.classList.toggle("active");
2028 });
2029 toc.querySelector("nav").addEventListener("click", e => {
2030 toc.classList.remove("active");
2031 });
2032 </script>
2033 </body>
2034 </html>