--- 1/draft-ietf-isis-yang-isis-cfg-20.txt 2018-07-02 09:13:42.674979790 -0700 +++ 2/draft-ietf-isis-yang-isis-cfg-21.txt 2018-07-02 09:13:42.846983903 -0700 @@ -1,25 +1,25 @@ IS-IS Working Group S. Litkowski Internet-Draft Orange Intended status: Standards Track D. Yeung -Expires: November 26, 2018 Arrcus, Inc +Expires: January 3, 2019 Arrcus, Inc A. Lindem Cisco Systems J. Zhang Juniper Networks L. Lhotka CZ.NIC - May 25, 2018 + July 2, 2018 YANG Data Model for IS-IS protocol - draft-ietf-isis-yang-isis-cfg-20 + draft-ietf-isis-yang-isis-cfg-21 Abstract This document defines a YANG data model that can be used to configure and manage IS-IS protocol on network elements. Requirements Language The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this @@ -33,21 +33,21 @@ Internet-Drafts are working documents of the Internet Engineering Task Force (IETF). Note that other groups may also distribute working documents as Internet-Drafts. The list of current Internet- Drafts is at http://datatracker.ietf.org/drafts/current/. Internet-Drafts are draft documents valid for a maximum of six months and may be updated, replaced, or obsoleted by other documents at any time. It is inappropriate to use Internet-Drafts as reference material or to cite them other than as "work in progress." - This Internet-Draft will expire on November 26, 2018. + This Internet-Draft will expire on January 3, 2019. Copyright Notice Copyright (c) 2018 IETF Trust and the persons identified as the document authors. All rights reserved. This document is subject to BCP 78 and the IETF Trust's Legal Provisions Relating to IETF Documents (http://trustee.ietf.org/license-info) in effect on the date of publication of this document. Please review these documents @@ -61,51 +61,51 @@ 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . 3 1.1. Tree diagram . . . . . . . . . . . . . . . . . . . . . . 3 2. Design of the Data Model . . . . . . . . . . . . . . . . . . 3 2.1. IS-IS Configuration . . . . . . . . . . . . . . . . . . . 9 2.2. Multitopology Parameters . . . . . . . . . . . . . . . . 10 2.3. Per-Level Parameters . . . . . . . . . . . . . . . . . . 10 2.4. Per-Interface Parameters . . . . . . . . . . . . . . . . 12 2.5. Authentication Parameters . . . . . . . . . . . . . . . . 23 2.6. IGP/LDP synchronization . . . . . . . . . . . . . . . . . 23 - 2.7. ISO parameters . . . . . . . . . . . . . . . . . . . . . 23 - 2.8. IP FRR . . . . . . . . . . . . . . . . . . . . . . . . . 23 + 2.7. ISO parameters . . . . . . . . . . . . . . . . . . . . . 24 + 2.8. IP FRR . . . . . . . . . . . . . . . . . . . . . . . . . 24 2.9. Operational States . . . . . . . . . . . . . . . . . . . 24 - 3. RPC Operations . . . . . . . . . . . . . . . . . . . . . . . 24 + 3. RPC Operations . . . . . . . . . . . . . . . . . . . . . . . 25 4. Notifications . . . . . . . . . . . . . . . . . . . . . . . . 25 5. Interaction with Other YANG Modules . . . . . . . . . . . . . 26 - 6. IS-IS YANG Module . . . . . . . . . . . . . . . . . . . . . . 26 - 7. Security Considerations . . . . . . . . . . . . . . . . . . . 101 - 8. Contributors . . . . . . . . . . . . . . . . . . . . . . . . 102 - 9. Acknowledgements . . . . . . . . . . . . . . . . . . . . . . 102 - 10. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 103 - 11. Change log for ietf-isis YANG module . . . . . . . . . . . . 103 - 11.1. From version -19 to version -20 . . . . . . . . . . . . 103 - 11.2. From version -18 to version -19 . . . . . . . . . . . . 103 - 11.3. From version -17 to version -18 . . . . . . . . . . . . 103 - 11.4. From version -16 to version -17 . . . . . . . . . . . . 104 - 11.5. From version -15 to version -16 . . . . . . . . . . . . 104 - 11.6. From version -14 to version -15 . . . . . . . . . . . . 104 - 11.7. From version -13 to version -14 . . . . . . . . . . . . 104 - 11.8. From version -12 to version -13 . . . . . . . . . . . . 105 - 11.9. From version -09 to version -12 . . . . . . . . . . . . 105 - 11.10. From version -08 to version -09 . . . . . . . . . . . . 105 - 11.11. From version -07 to version -08 . . . . . . . . . . . . 105 - 11.12. From version -05 to version -07 . . . . . . . . . . . . 105 - 11.13. From version -03 to version -05 . . . . . . . . . . . . 106 - 11.14. From version -02 to version -03 . . . . . . . . . . . . 106 - 11.15. From version -01 to version -02 . . . . . . . . . . . . 106 - 11.16. From version -00 to version -01 . . . . . . . . . . . . 107 - 12. Normative References . . . . . . . . . . . . . . . . . . . . 107 - Appendix A. Example of IS-IS configuration in XML . . . . . . . 108 - Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . 111 + 6. IS-IS YANG Module . . . . . . . . . . . . . . . . . . . . . . 27 + 7. Security Considerations . . . . . . . . . . . . . . . . . . . 94 + 8. Contributors . . . . . . . . . . . . . . . . . . . . . . . . 95 + 9. Acknowledgements . . . . . . . . . . . . . . . . . . . . . . 95 + 10. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 95 + 11. Change log for ietf-isis YANG module . . . . . . . . . . . . 96 + 11.1. From version -19 to version -20 . . . . . . . . . . . . 96 + 11.2. From version -18 to version -19 . . . . . . . . . . . . 96 + 11.3. From version -17 to version -18 . . . . . . . . . . . . 96 + 11.4. From version -16 to version -17 . . . . . . . . . . . . 96 + 11.5. From version -15 to version -16 . . . . . . . . . . . . 96 + 11.6. From version -14 to version -15 . . . . . . . . . . . . 97 + 11.7. From version -13 to version -14 . . . . . . . . . . . . 97 + 11.8. From version -12 to version -13 . . . . . . . . . . . . 97 + 11.9. From version -09 to version -12 . . . . . . . . . . . . 97 + 11.10. From version -08 to version -09 . . . . . . . . . . . . 98 + 11.11. From version -07 to version -08 . . . . . . . . . . . . 98 + 11.12. From version -05 to version -07 . . . . . . . . . . . . 98 + 11.13. From version -03 to version -05 . . . . . . . . . . . . 98 + 11.14. From version -02 to version -03 . . . . . . . . . . . . 99 + 11.15. From version -01 to version -02 . . . . . . . . . . . . 99 + 11.16. From version -00 to version -01 . . . . . . . . . . . . 99 + 12. Normative References . . . . . . . . . . . . . . . . . . . . 100 + Appendix A. Example of IS-IS configuration in XML . . . . . . . 101 + Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . 103 1. Introduction This document defines a YANG data model for IS-IS routing protocol. The data model covers configuration of an IS-IS routing protocol instance as well as operational states. 1.1. Tree diagram @@ -142,40 +142,41 @@ The figure below describes the overall structure of the isis YANG module: module: ietf-isis augment /rt:routing/rt:ribs/rt:rib/rt:routes/rt:route: +--ro metric? uint32 +--ro tag* uint64 +--ro route-type? enumeration augment /if:interfaces/if:interface: +--rw clns-mtu? uint16 - augment /rt:routing/rt:control-plane-protocols/rt:control-plane-protoc -ol: + augment /rt:routing/rt:control-plane-protocols/ + | rt:control-plane-protocol: +--rw isis +--rw enable? boolean {admin-control}? +--rw level-type? level +--rw system-id? system-id - +--rw maximum-area-addresses? uint8 {maximum-area-addresses}? + +--rw maximum-area-addresses? + | uint8 {maximum-area-addresses}? +--rw area-address* area-address +--rw mpls | +--rw ipv4-router-id? inet:ipv4-address {ipv4-router-id}? | +--rw ipv6-router-id? inet:ipv6-address {ipv6-router-id}? | +--rw ldp | ... +--rw auto-cost {auto-cost}? | +--rw reference-bandwidth? uint32 | +--rw enable? boolean +--rw lsp-mtu? uint16 +--rw lsp-lifetime? uint16 - +--rw lsp-refresh? rt-types:timer-value-seconds16 {l -sp-refresh}? + +--rw lsp-refresh? + | rt-types:timer-value-seconds16 {lsp-refresh}? +--rw graceful-restart {graceful-restart}? | +--rw enable? boolean | +--rw restart-interval? rt-types:timer-value-seconds16 | +--rw helper-enable? boolean +--rw nsr {nsr}? | +--rw enable? boolean +--rw node-tags {node-tag}? | +--rw node-tag* [tag] | ... +--rw authentication @@ -547,56 +549,54 @@ interface-specific parameter always override an IS-IS global parameter. Some parameters like hello-padding are defined as containers to allow easy extension by vendor specific modules. +--rw interfaces | +--rw interface* [name] | +--rw name if:interface-ref | +--rw level-type? level - | +--rw lsp-pacing-interval? rt-types:timer-value-milli -seconds - | +--rw lsp-retransmit-interval? rt-types:timer-value-secon -ds16 + | +--rw lsp-pacing-interval? + | | rt-types:timer-value-milliseconds + | +--rw lsp-retransmit-interval? + | | rt-types:timer-value-seconds16 | +--rw passive? boolean - | +--rw csnp-interval? rt-types:timer-value-secon -ds16 + | +--rw csnp-interval? + | | rt-types:timer-value-seconds16 | +--rw hello-padding | | +--rw enable? boolean | +--rw mesh-group-enable? mesh-group-state | +--rw mesh-group? uint8 | +--rw interface-type? interface-type | +--rw enable? boolean {admin-control}? | +--rw tag* uint32 {prefix-tag}? | +--rw tag64* uint64 {prefix-tag64}? | +--rw node-flag? boolean {node-flag}? | +--rw hello-authentication | | +--rw (authentication-type)? | | | +--:(key-chain) {key-chain}? | | | | +--rw key-chain? key-chain:key-chain-ref | | | +--:(password) | | | +--rw key? string | | | +--rw crypto-algorithm? identityref | | +--rw level-1 | | | +--rw (authentication-type)? | | | +--:(key-chain) {key-chain}? - | | | | +--rw key-chain? key-chain:key-chain-r -ef + | | | | +--rw key-chain? key-chain:key-chain-ref | | | +--:(password) | | | +--rw key? string | | | +--rw crypto-algorithm? identityref | | +--rw level-2 | | +--rw (authentication-type)? | | +--:(key-chain) {key-chain}? - | | | +--rw key-chain? key-chain:key-chain-r -ef + | | | +--rw key-chain? key-chain:key-chain-ref | | +--:(password) | | +--rw key? string | | +--rw crypto-algorithm? identityref | +--rw hello-interval | | +--rw value? rt-types:timer-value-seconds16 | | +--rw level-1 | | | +--rw value? rt-types:timer-value-seconds16 | | +--rw level-2 | | +--rw value? rt-types:timer-value-seconds16 | +--rw hello-multiplier @@ -643,38 +643,38 @@ | | | +--rw enable? boolean | | | +--rw remote-lfa {remote-lfa}? | | | +--rw enable? boolean | | +--rw level-2 | | +--rw candidate-disabled? boolean | | +--rw enable? boolean | | +--rw remote-lfa {remote-lfa}? | | +--rw enable? boolean | +--rw topologies {multi-topology}? | | +--rw topology* [name] - | | +--rw name -> ../../../../../../../../rt:ribs/ri -b/name + | | +--rw name + | | | -> ../../../../../../../../rt:ribs/rib/name | | +--rw metric | | +--rw value? wide-metric | | +--rw level-1 | | | +--rw value? wide-metric | | +--rw level-2 | | +--rw value? wide-metric | +--ro adjacencies | | +--ro adjacency* [] | | +--ro neighbor-systype? level | | +--ro neighbor-sysid? system-id - | | +--ro neighbor-extended-circuit-id? extended-circui -t-id + | | +--ro neighbor-extended-circuit-id? + | | | extended-circuit-id | | +--ro neighbor-snpa? snpa | | +--ro usage? level - | | +--ro hold-timer? rt-types:timer- -value-seconds16 + | | +--ro hold-timer? + | | | rt-types:timer-value-seconds16 | | +--ro neighbor-priority? uint8 | | +--ro lastuptime? yang:timestamp | | +--ro state? adj-state-type | +--ro event-counters | | +--ro adjacency-changes? uint32 | | +--ro adjacency-number? uint32 | | +--ro init-fails? uint32 | | +--ro adjacency-rejects? uint32 | | +--ro id-len-mismatch? uint32 | | +--ro max-area-addresses-mismatch? uint32 @@ -1231,27 +1231,27 @@ Some IS-IS specific routes attributes are added to route objects of the ietf-routing module by augmenting "/rt:routing- state/rt:ribs/rt:rib/rt:routes/rt:route". The modules defined in this document use some groupings from ietf- keychain [I-D.ietf-rtgwg-yang-key-chain]. 6. IS-IS YANG Module - file "ietf-isis@2018-05-25.yang" - + file "ietf-yang@2018-07-02.yang" module ietf-isis { yang-version 1.1; namespace "urn:ietf:params:xml:ns:yang:ietf-isis"; prefix isis; + import ietf-routing { prefix "rt"; reference "RFC 8349 - A YANG Data Model for Routing Management (NMDA Version)"; } import ietf-inet-types { prefix inet; reference "RFC 6021 - Common YANG Data Types"; } @@ -1317,21 +1317,21 @@ <mailto:yiqu@cisco.com> Jeff Tantsura <mailto:jefftant.ietf@gmail.com> "; description "The YANG module defines a generic configuration model for IS-IS common across all of the vendor implementations."; - revision 2017-05-25 { + revision 2018-07-02 { description "Initial revision."; reference "RFC XXXX"; } /* Identities */ identity isis { base rt:routing-protocol; description "Identity for the IS-IS routing protocol."; @@ -1345,22 +1346,21 @@ description "Identity for the IS-IS routing protocol database reset action."; } identity clear-isis-adjacency { description "Identity for the IS-IS routing protocol adjacency reset action."; } identity lsp-log-reason { - description "Base identity for an LSP change - log reason."; + description "Base identity for an LSP change log reason."; } identity refresh { base lsp-log-reason; description "Identity used when the LSP log reason is a refresh LSP received."; } identity content-change { @@ -1381,21 +1381,21 @@ feature bfd { description "Support for BFD detection of IS-IS neighbor reachability."; reference "RFC 5880 - Bidirectional Forwarding Detection (BFD) RFC 5881 - Bidirectional Forwarding Detection (BFD) for IPv4 and IPv6 (Single Hop)"; } feature key-chain { description "Support of keychain for authentication."; - + reference "RFC8177 - YANG Data Model for Key Chains"; } feature node-flag { description "Support of node-flag advertisement as prefix attribute"; reference "RFC7794 - IS-IS Prefix Attributes for Extended IP and IPv6 Reachability"; } feature node-tag { description @@ -1407,50 +1407,48 @@ description "Support of synchronization between IS-IS and LDP."; reference "RFC5443 - LDP IGP Synchronization"; } feature fast-reroute { description "Support of IP Fast Reroute."; } feature nsr { description - "Support of - Non Stop Routing."; + "Support of Non-Stop Routing."; } feature lfa { description - "Support of Loop Free Alternates."; + "Support of Loop-Free Alternates."; reference "RFC5286 - Basic Specification of IP Fast-Reroute: Loop-free Alternates"; } feature remote-lfa { description "Support of remote Loop Free Alternates."; reference "RFC7490 - Remote Loop-Free Alternate Fast Reroute"; } feature overload-max-metric { description "Support of overload by setting all links to max metric."; } feature prefix-tag { description - "Add 32bit tag to prefixes"; - + "Support for 32-bit prefix tags"; reference "RFC5130 - A Policy Control Mechanism in IS-IS Using Administrative Tags"; } feature prefix-tag64 { description - "Add 64bit tag to prefixes"; + "Support for 64-bit prefix tags"; reference "RFC5130 - A Policy Control Mechanism in IS-IS Using Administrative Tags"; } feature auto-cost { description "Use an automated assignment of metrics."; } feature ipv4-router-id { description "Support of IPv4 router ID configuration under IS-IS."; @@ -1493,29 +1492,30 @@ /* Type definitions */ typedef instance-state-ref { type leafref { path "/rt:routing-state/" +"rt:control-plane-protocols/rt:control-plane-protocol/" +"rt:name"; } description - "This type is used for leaves that reference state data of + "This type is used for leaves that reference state data for an IS-IS protocol instance."; } typedef circuit-id { type uint8; description "This type defines the circuit ID associated with an interface."; + } typedef extended-circuit-id { type uint32; description "This type defines the extended circuit ID associated with an interface."; } typedef interface-type { @@ -1519,188 +1519,179 @@ } typedef interface-type { type enumeration { enum broadcast { description "Broadcast interface type."; } enum point-to-point { description - "Point to point interface type."; + "Point-to-point interface type."; } } description "This type defines the type of adjacency to be established on the interface. - This is affecting the type of hello - message that would be used."; + The interface-type determines the type + of hello message that is used."; } typedef level { type enumeration { enum "level-1" { description - "This enum describes L1 only capability."; + "This enum indicates L1-only capability."; } enum "level-2" { description - "This enum describes L2 only capability."; + "This enum indicates L2-only capability."; } enum "level-all" { description - "This enum describes both levels capability."; + "This enum indicates capability for both levels."; } } default "level-all"; description "This type defines IS-IS level of an object."; } - typedef adj-state-type { type enumeration { enum "up" { description - "This state describes that - adjacency is established."; + "State indicates the adjacency is established."; } enum "down" { description - "This state describes that - adjacency is NOT established."; + "State indicates the adjacency is NOT established."; } enum "init" { description - "This state describes that - adjacency is establishing."; + "State indicates the adjacency is establishing."; } enum "failed" { description - "This state describes that - adjacency is failed."; + "State indicates the adjacency is failed."; } } description "This type defines states of an adjacency"; } typedef if-state-type { type enumeration { enum "up" { - description - "Up state."; + description "Up state."; } enum "down" { - description - "Down state"; + description "Down state"; } } description - "This type defines states of an interface"; + "This type defines the state of an interface"; } typedef level-number { type uint8 { range "1 .. 2"; } description - "This type defines a current IS-IS level."; + "This type defines the current IS-IS level."; } typedef lsp-id { type string { pattern '[0-9A-Fa-f]{4}\.[0-9A-Fa-f]{4}\.[0-9A-Fa-f]' +'{4}\.[0-9][0-9]-[0-9][0-9]'; } description - "This type defines IS-IS LSP ID using pattern, - system id looks like : 0143.0438.AeF0.02-01"; + "This type defines the IS-IS LSP ID format using a + pattern, An example LSP ID is 0143.0438.AeF0.02-01"; } typedef area-address { type string { pattern '[0-9A-Fa-f]{2}\.([0-9A-Fa-f]{4}\.){0,3}'; } description "This type defines the area address format."; } typedef snpa { type string { length "0 .. 20"; } description - "This type defines Subnetwork Point - of Attachement format."; + "This type defines the Subnetwork Point + of Attachement (SNPA) format."; } typedef system-id { type string { pattern '[0-9A-Fa-f]{4}\.[0-9A-Fa-f]{4}\.[0-9A-Fa-f]{4}'; } description - "This type defines IS-IS system id using pattern, - system id looks like : 0143.0438.AeF0"; + "This type defines IS-IS system-id using pattern, + An example system-id is 0143.0438.AeF0"; } typedef wide-metric { type uint32 { range "0 .. 16777215"; } description - "This type defines wide style format - of IS-IS metric."; + "This type defines wide style format of IS-IS metric."; } typedef std-metric { type uint8 { range "0 .. 63"; } description - "This type defines old style format - of IS-IS metric."; + "This type defines old style format of IS-IS metric."; } typedef mesh-group-state { type enumeration { - enum "meshinactive" { + enum "mesh-inactive" { description "Interface is not part of a mesh group."; } - enum "meshset" { + enum "mesh-set" { description "Interface is part of a mesh group."; } - enum "meshblocked" { + enum "mesh-blocked" { description - "LSPs must not be flooded over that interface."; + "LSPs must not be flooded over this interface."; } } description "This type describes meshgroup state of an interface"; } /* Grouping definitions for configuration and ops state */ grouping adjacency-state { container adjacencies { config false; list adjacency { - leaf neighbor-systype { + leaf neighbor-sys-type { type level; description - "Type of neighboring system"; + "Level capability of neighboring system"; } leaf neighbor-sysid { type system-id; description "The system-id of the neighbor"; } leaf neighbor-extended-circuit-id { type extended-circuit-id; description "Circuit ID of the neighbor"; @@ -1709,22 +1700,22 @@ type snpa; description "SNPA of the neighbor"; } leaf usage { type level; description "Define the level(s) activated on the adjacency. On a p2p link this might be level 1 and 2, but on a LAN, the usage will be level 1 - between peers at L1 or level 2 between - peers at L2."; + between peers at level 1 or level 2 between + peers at level 2."; } leaf hold-timer { type rt-types:timer-value-seconds16; units seconds; description "The holding time in seconds for this adjacency. This value is based on received hello PDUs and the elapsed time since receipt."; } @@ -1742,22 +1733,21 @@ "When the adjacency most recently entered state 'up', measured in hundredths of a second since the last reinitialization of the network management subsystem. The value is 0 if the adjacency has never been in state 'up'."; } leaf state { type adj-state-type; description - "This leaf describes the state of the - interface."; + "This leaf describes the state of the interface."; } description "List of operational adjacencies."; } description "This container lists the adjacencies of the local node."; } description @@ -1780,40 +1770,40 @@ description "Protected prefix."; } leaf alternate { type string; description "Alternate nexthop for the prefix."; } leaf alternate-type { type enumeration { - enum equalcost { + enum equal-cost { description "ECMP alternate."; } enum lfa { description "LFA alternate."; } enum remote-lfa { description "Remote LFA alternate."; } enum tunnel { description "Tunnel based alternate (like RSVP-TE or GRE)."; } enum ti-lfa { description - "TI LFA alternate."; + "TI-LFA alternate."; } enum mrt { description "MRT alternate."; } enum other { description "Unknown alternate type."; } } @@ -1812,226 +1802,201 @@ description "MRT alternate."; } enum other { description "Unknown alternate type."; } } description "Type of alternate."; - } leaf best { type boolean; description - "describes if the alternate is the best one."; + "Indicates if the alternate is the preferred."; } leaf non-best-reason { type string; description "Information field to describe why the alternate is not best."; } leaf protection-available { type bits { - bit nodeprotect { + bit node-protect { position 0; description "Node protection available."; } - bit linkprotect { + bit link-protect { position 1; description "Link protection available."; } - bit srlgprotect { + bit srlg-protect { position 2; description "SRLG protection available."; } - bit downstreamprotect { + bit downstream-protect { position 3; description "Downstream protection available."; } bit other { position 4; description "Other protection available."; } } - description - "Describes protection provided by the alternate."; + description "Protection provided by the alternate."; } leaf alternate-metric1 { type uint32; description - "Metric from PLR to destination - through the alternate path."; - + "Metric from Point of Local Repair (PLR) to + destination through the alternate path."; } leaf alternate-metric2 { type uint32; description "Metric from PLR to the alternate node"; } leaf alternate-metric3 { type uint32; description "Metric from alternate node to the destination"; } description - "Per AF statistics."; + "Per-AF protected prefix statistics."; } description "List of prefixes that are protected."; } - container nonprotected-routes { + container unprotected-routes { config false; list af-stats { key "af prefix"; leaf af { type iana-rt-types:address-family; - description - "Address-family"; + description "Address-family"; } leaf prefix { type string; - description - "Protected prefix."; + description "Unprotected prefix."; } description - "Per AF statistics."; + "Per AF unprotected prefix statistics."; } description "List of prefixes that are not protected."; } list protection-statistics { key frr-protection-method; config false; leaf frr-protection-method { type string; - description - "Protection method used."; - + description "Protection method used."; } list af-stats { key af; leaf af { type iana-rt-types:address-family; - description - "Address-family"; + description "Address-family"; } leaf total-routes { type uint32; - description - "Total prefixes."; + description "Total prefixes."; } leaf unprotected-routes { type uint32; description - "Total of prefixes who are - not protected."; + "Total prefixes that are not protected."; } leaf protected-routes { type uint32; description - "Total of prefixes who are - protected."; + "Total prefixes that are protected."; } leaf linkprotected-routes { type uint32; description - "Total of prefixes who are - link protected."; + "Total prefixes that are link protected."; } leaf nodeprotected-routes { type uint32; description - "Total of prefixes who are - node protected."; + "Total prefixes that are node protected."; } description - "Per AF statistics."; + "Per AF protected prefix statistics."; } - description - "Global protection statistics."; - } - description - "IPFRR states."; + description "Global protection statistics."; } + description "IPFRR states."; + } grouping notification-instance-hdr { description - "This group describes common instance specific - data for notifications."; + "Instance specific IS-IS notification data grouping"; leaf routing-instance { type string; - description - "Describes the name of the routing-instance instance."; + description "Name of the routing-instance instance."; } leaf routing-protocol-name { type string; - description - "Describes the name of the IS-IS instance."; + description "Name of the IS-IS instance."; } leaf isis-level { type level; - description - "Describes the IS-IS level of the instance."; + description "IS-IS level of the instance."; } } grouping notification-interface-hdr { description - "This group describes common interface specific - data for notifications."; + "Interface specific IS-IS notification data grouping"; leaf interface-name { type string; - description - "Describes the name of the IS-IS interface."; + description "IS-IS interface name"; } leaf interface-level { type level; - description - "Describes the IS-IS level of the interface."; + description "IS-IS level of the interface."; } leaf extended-circuit-id { type extended-circuit-id; - description - "Describes the extended circuit-id of the interface."; + description "Eextended circuit-id of the interface."; } } grouping route-content { description - "This group add isis-specific route properties."; + "IS-IS protocol-specific route properties grouping."; leaf metric { type uint32; - description - "This leaf describes IS-IS metric of a route."; + description "IS-IS metric of a route."; } leaf-list tag { type uint64; description - "This leaf describes list of tags associated - with the route. The leaf describes both - 32bits and 64bits tags."; + "List of tags associated with the route. The leaf + describes both 32-bit and 64-bit tags."; } leaf route-type { type enumeration { enum l2-up-internal { description "Level 2 internal route and not leaked to a lower level"; } enum l1-up-internal { description "Level 1 internal route and not leaked to a lower level"; @@ -2054,58 +2019,51 @@ } enum l2-down-external { description "Level 2 external route and leaked to a lower level"; } enum l1-down-external { description "Level 1 external route and leaked to a lower level"; } } - description - "This leaf describes the type of IS-IS route."; - + description "IS-IS route type."; } } grouping admin-control { leaf enable { if-feature admin-control; type boolean; default true; description - "Control the administrative - state."; + "Control the administrative state."; } description "Grouping for admin control."; } grouping fast-reroute-global-cfg { description - "This group defines global - configuration of IPFRR."; + "IPFRR global configuration grouping"; container lfa { if-feature lfa; description - "This container may be - augmented with global parameters - for LFA. - Creating the container has no effect on - LFA activation."; + "This container may be augmented with global + parameters for LFA. Creating the container has no + effect on LFA activation."; } } grouping fast-reroute-if-cfg { description - "This group defines interface - configuration of IPFRR."; + "IPFRR interface configuration grouping"; container lfa { if-feature lfa; uses lfa-if-cfg; container level-1 { uses lfa-if-cfg; description "LFA level 1 config"; } container level-2 { uses lfa-if-cfg; @@ -2201,28 +2158,29 @@ } leaf last-spf-time { type yang:timestamp; config false; description "Time of last SPF computation."; } description "Grouping for IETF SPF delay operational states."; } + grouping local-rib { description "Local-rib grouping."; container local-rib { config false; description "Local-rib."; list route { key "prefix"; - description "Routes"; + description "List of IS-IS local RIB Routes"; leaf prefix { type inet:ip-prefix; description "Destination prefix."; } container next-hops { description "All next hops for the route."; list next-hop { key "next-hop"; description "List of next hop for the route"; leaf outgoing-interface { @@ -2246,22 +2204,21 @@ } leaf route-tag { type uint32; description "Route tag for this route."; } } } } grouping isis-node-tag-cfg { - description - "IS-IS node tag config."; + description "IS-IS node tag config."; container node-tags { if-feature node-tag; list node-tag { key tag; leaf tag { type uint32; description "Node tag value."; } description @@ -2279,228 +2235,196 @@ leaf key-chain { type key-chain:key-chain-ref; description "Reference to a key-chain."; } } case password { leaf key { type string; description - "This leaf describes the - authentication key."; + "This leaf specifies the authentication key."; } leaf crypto-algorithm { type identityref { base key-chain:crypto-algorithm; } description "Cryptographic algorithm associated with key."; } } - description - "Choice of authentication."; + description "Choice of authentication."; } - description - "Grouping for global auth config."; + description "Grouping for global authentication config."; } + grouping metric-type-global-cfg { leaf value { type enumeration { enum wide-only { description - "Advertise new metric style only - (RFC5305)"; + "Advertise new metric style only (RFC5305)"; } enum old-only { description - "Advertise old metric style only - (RFC1195)"; + "Advertise old metric style only (RFC1195)"; } enum both { - description "Advertise both metric - styles"; + description "Advertise both metricstyles"; } } default wide-only; description - "This leaf describes the type of metric - to be generated. - Wide-only means only new metric style + "Type of metric to be generated: + - wide-only means only new metric style is generated, - old-only means that only old style metric + - old-only means that only old style metric is generated, - and both means that both are advertised. + - both means that both are advertised. This leaf is only affecting IPv4 metrics."; } description "Grouping for global metric style config."; } grouping default-metric-global-cfg { leaf value { type wide-metric; default "10"; - description - "Value of the metric"; + description "Value of the metric"; } description - "Grouping for global default metric config."; + "Global default metric config grouping."; } grouping overload-global-cfg { leaf status { type boolean; default false; description - "This leaf defines the overload status."; + "This leaf specifies the overload status."; } - description - "Grouping for overload bit config."; + description "Grouping for overload bit config."; } grouping overload-max-metric-global-cfg { leaf timeout { type rt-types:timer-value-seconds16; units "seconds"; description - "This leaf defines the timeout in seconds - of the overload condition."; + "Timeout (in seconds) of the overload condition."; } description - "Grouping for overload-max-metric config."; + "Overload maximum metric configuration grouping"; } grouping route-preference-global-cfg { choice granularity { case detail { leaf internal { type uint8; description - "This leaf defines the protocol - preference for internal routes."; + "Protocol preference for internal routes."; } leaf external { type uint8; description - "This leaf defines the protocol - preference for external routes."; + "Protocol preference for external routes."; } } case coarse { leaf default { type uint8; description - "This leaf defines the protocol - preference for all IS-IS routes."; + "Protocol preference for all IS-IS routes."; } } description "Choice for implementation of route preference."; } description - "This grouping defines how route preference is configured."; + "Global route preference grouping"; } grouping hello-authentication-cfg { choice authentication-type { case key-chain { if-feature key-chain; leaf key-chain { type key-chain:key-chain-ref; - description - "Reference to a key-chain."; + description "Reference to a key-chain."; } } case password { leaf key { type string; - description - "This leaf describes the - authentication key."; + description "Authentication key specification"; } leaf crypto-algorithm { type identityref { base key-chain:crypto-algorithm; } description "Cryptographic algorithm associated with key."; } } - description - "Choice of authentication."; + description "Choice of authentication."; } - description - "Grouping for hello authentication."; + description "Grouping for hello authentication."; } - grouping hello-interval-cfg { leaf value { type rt-types:timer-value-seconds16; units "seconds"; default 10; description - "This leaf defines the interval of - hello messages."; + "Interval (in seconds) between successive hello + messages."; } - description - "Interval between - hello messages."; - + description "Interval between hello messages."; } grouping hello-multiplier-cfg { leaf value { type uint16; default 3; description - "This leaf defines the number of - hello failed to be received before + "Number of missed hello messages prior to declaring the adjacency down."; } description - "This grouping defines the number of - hello failed to be received before - declaring the adjacency down."; + "Number of missed hello messages prior to + adjacency down grouping."; } grouping priority-cfg { leaf value { type uint8 { range "0 .. 127"; } default 64; description - "This leaf describes the priority of - the interface - for DIS election."; + "Priority of interface for DIS election."; } - description - "This grouping leaf describes the - priority of - the interface - for DIS election."; + description "Interface DIS election priority grouping"; } grouping metric-cfg { leaf value { type wide-metric; default "10"; - description - "Metric value."; + description "Metric value."; } - description - "Grouping for interface metric"; + description "Interface metric grouping"; } - grouping lfa-if-cfg { leaf candidate-disabled { type boolean; default false; description "Prevent the interface to be used as backup."; } leaf enable { type boolean; default false; @@ -2498,541 +2422,475 @@ leaf candidate-disabled { type boolean; default false; description "Prevent the interface to be used as backup."; } leaf enable { type boolean; default false; description - "Activates LFA. - This model assumes activation + "LFA Activation - this model assumes activation of per-prefix LFA."; } container remote-lfa { if-feature remote-lfa; leaf enable { type boolean; default false; description "Activates rLFA."; } - description - "remote LFA configuration."; + description "Remote LFA configuration."; } - description - "Grouping for LFA - interface configuration"; + description "Grouping for LFA interface configuration"; } grouping isis-global-cfg { - description - "Defines the IS-IS global configuration."; + description "IS-IS global configuration grouping"; uses admin-control; leaf level-type { type level; default "level-all"; description - "This leaf describes the type of IS-IS node. - A node can be level-1-only, level-2-only - or level-1-2. - "; + "Level of an IS-IS node - can be level-1-only, + level-2-only or level-1-2."; } leaf system-id { type system-id; - description - "This leaf defines the system-id of the node."; + description "System-id of the node."; } leaf maximum-area-addresses { if-feature maximum-area-addresses; type uint8; default 3; - description - "Defines the maximum areas supported."; + description "Maximum areas supported."; } leaf-list area-address { type area-address; description - "List of areas supported by the - protocol instance."; + "List of areas supported by the protocol instance."; } container mpls { leaf ipv4-router-id { if-feature ipv4-router-id; type inet:ipv4-address; description - "Router ID value that would be used in - TLV 134."; + "Router ID value that would be used in TLV 134."; } leaf ipv6-router-id { if-feature ipv6-router-id; type inet:ipv6-address; description - "Router ID value that would be used in - TLV 140."; + "Router ID value that would be used in TLV 140."; } container ldp { container igp-sync { if-feature ldp-igp-sync; description - "This container may be augmented - with global parameters for igp-ldp-sync."; + "This container may be augmented with global + parameters for igp-ldp-sync."; } - description - "LDP related configuration."; + description "LDP configuration."; } - description - "This container handles mpls config."; + description "MPLS configuration"; } container auto-cost { if-feature auto-cost; leaf reference-bandwidth { type uint32; units "bps"; - description - "This leaf defines the bandwidth for calculating - metric."; + description "Bandwidth for calculating metric."; } leaf enable { type boolean; default false; - description - "Enable/disable auto-cost."; + description "Enable/disable auto-cost."; } - description - "This container defines the auto-cost configuration."; + description "Auto-cost configuration."; + } leaf lsp-mtu { type uint16; units "bytes"; default 1492; description - "This leaf describes the maximum size of a - LSP PDU in bytes."; + "Maximum size of an LSP PDU in bytes."; } leaf lsp-lifetime { type uint16 { range "1..65535"; } units "seconds"; description - "This leaf describes the lifetime of the router - LSP in seconds."; + "Lifetime of the router's LSPs in seconds."; } leaf lsp-refresh { if-feature lsp-refresh; type rt-types:timer-value-seconds16; units "seconds"; description - "This leaf describes the refresh interval of the - router LSP in seconds."; + "Refresh interval of the router's LSPs in seconds."; } container graceful-restart { if-feature graceful-restart; leaf enable { type boolean; default false; - description - "Control enabling the feature."; + description "Enable graceful restart."; } leaf restart-interval { type rt-types:timer-value-seconds16; units "seconds"; description - "Interval in seconds to attempt graceful restart prior - to failing"; + "Interval (in seconds) to attempt graceful restart prior + to failure."; } leaf helper-enable { type boolean; default true; description - "If enabled, the local router can act as restart helper."; + "Enable local IS-IS router as graceful restart helper."; } - description - "This container activates graceful restart."; + description "Graceful-Restart Configuration."; } container nsr { if-feature nsr; - description - "Non-Stop Routing (NSR) config state."; + description "Non-Stop Routing (NSR) configuration."; leaf enable { type boolean; default false; - description - "Enable/Disable NSR."; + description "Enable/Disable Non-Stop Routing (NSR)."; } } uses isis-node-tag-cfg; container authentication { uses authentication-global-cfg; container level-1 { uses authentication-global-cfg; - description "level-1 specific cfg"; + description "level-1 specific configuration"; } container level-2 { uses authentication-global-cfg; - description "level-2 specific cfg"; + description "level-2 specific configuration"; } - description "authentication global cfg. - It covers both LSPs and SNPs."; + description "Authentication global configuration for + both LSPs and SNPs."; } + container metric-type { uses metric-type-global-cfg; container level-1 { uses metric-type-global-cfg; - description "level-1 specific cfg"; + description "level-1 specific configuration"; } container level-2 { uses metric-type-global-cfg; - description "level-2 specific cfg"; + description "level-2 specific configuration"; } - description "Metric style global cfg."; + description "Metric style global configuration"; } container default-metric { uses default-metric-global-cfg; container level-1 { uses default-metric-global-cfg; - description "level-1 specific cfg"; + description "level-1 specific configuration"; } container level-2 { uses default-metric-global-cfg; - description "level-2 specific cfg"; + description "level-2 specific configuration"; } - description "Default metric global cfg."; + description "Default metric global configuration"; } container afs { if-feature nlpid-control; list af { key af; leaf af { type iana-rt-types:address-family; - - description - "Address-family"; + description "Address-family"; } leaf enable { type boolean; - description - "Describes the activation state of the - AF."; + description "Activate the address family."; } description - "This list permits activation - of new address families."; + "List of address families and whether or not they + are activated."; } - description - "Container for address-families"; - + description "Address Family configuration"; } container preference { uses route-preference-global-cfg; - description - "This container defines the protocol preference."; + description "Router preference configuration for IS-IS + protocol instance route installation"; } container overload { uses overload-global-cfg; - description - "This container describes if the router is - set to overload state."; + description "Router protocol instance overload state + configuration"; } container overload-max-metric { if-feature overload-max-metric; uses overload-max-metric-global-cfg; description - "This container describes if the router is - set to overload state using max-metric - advertisement."; + "Router protocol instance overload maximum + metric advertisement configuration."; } } grouping isis-global-topologies-cfg { - description - "Per topology config."; + description "Per-topology configuration"; container default-metric { uses default-metric-global-cfg; container level-1 { uses default-metric-global-cfg; - description "level-1 specific cfg"; + description "level-1 specific configuration"; } container level-2 { uses default-metric-global-cfg; - description "level-2 specific cfg"; + description "level-2 specific configuration"; } - description "Default metric per - topology cfg."; + description "Default metric per-topology configuration"; } uses isis-node-tag-cfg; } grouping isis-if-cfg { - description - "Grouping for interface cfg."; - + description "Interface configuration grouping"; leaf level-type { type level; default "level-all"; - description - "This leaf defines the associated IS-IS - level of the interface."; + description "IS-IS level of the interface."; } leaf lsp-pacing-interval { type rt-types:timer-value-milliseconds; units "milliseconds"; default 33; description - "This leaf defines the interval between - LSP transmissions in milli-seconds"; + "Interval (in milli-seconds) between LSP + transmissions."; } leaf lsp-retransmit-interval { type rt-types:timer-value-seconds16; units "seconds"; description - "This leaf defines the interval between - retransmission of LSP"; + "Interval (in seconds) between LSP + retransmissions."; } leaf passive { type boolean; default "false"; description - "This leaf defines if interface is in - passive mode (IS-IS not running, - but network is advertised)."; + "Indicates whetherthe interface is in passive mode (IS-IS + not running but network is advertised)."; } leaf csnp-interval { type rt-types:timer-value-seconds16; units "seconds"; default 10; description - "This leaf defines the interval of CSNP - messages."; + "Interval (in seconds) between CSNP messages."; } container hello-padding { leaf enable { type boolean; default "true"; description - "Status of Hello-padding activation. - By default, the implementation shall - pad HELLOs."; + "IS-IS Hello-padding activation - enabled by default."; } - description - "This container handles IS-IS hello padding - configuration."; + description "IS-IS hello padding configuration."; } leaf mesh-group-enable { type mesh-group-state; - description - "Describes the mesh group state of - the interface."; + description "IS-IS interface mesh-group state"; } leaf mesh-group { - when "../mesh-group-enable = 'meshset'" { + when "../mesh-group-enable = 'mesh-set'" { description - "Only valid when mesh-group-enable - equals to meshset"; + "Only valid when mesh-group-enable equals meshset"; } type uint8; - description - "Describes the mesh group ID of - the interface."; + description "IS-IS interface mesh-group ID."; } leaf interface-type { type interface-type; default "broadcast"; description - "This leaf defines the type of adjacency - to be established on the interface. - This is affecting the type of hello - message that would be used."; + "Type of adjacency to be established on the interface. This + dictates the type of hello messages that are used."; } uses admin-control; leaf-list tag { if-feature prefix-tag; type uint32; description - "This leaf defines list of tags associated - with the interface."; + "List of tags associated with the interface."; } leaf-list tag64 { if-feature prefix-tag64; type uint64; description - "This leaf defines list of 64bits tags - associated with the interface."; + "List of 64-bit tags associated with the interface."; } leaf node-flag { if-feature node-flag; type boolean; default false; description - "Set prefix as a node - representative prefix."; + "Set prefix as a node representative prefix."; } container hello-authentication { uses hello-authentication-cfg; container level-1 { uses hello-authentication-cfg; - description "level-1 specific cfg"; + description "level-1 specific configuration"; } container level-2 { uses hello-authentication-cfg; - description "level-2 specific cfg"; + description "level-2 specific configuration"; } - description "Authentication type - to be used in hello messages."; + description + "Authentication type to be used in hello messages."; } container hello-interval { uses hello-interval-cfg; container level-1 { uses hello-interval-cfg; - description "level-1 specific cfg"; + description "level-1 specific configuration"; } container level-2 { uses hello-interval-cfg; - description "level-2 specific cfg"; + description "level-2 specific configuration"; } - description "Interval between - hello messages."; + description "Interval between hello messages."; } container hello-multiplier { uses hello-multiplier-cfg; container level-1 { uses hello-multiplier-cfg; - description "level-1 specific cfg"; + description "level-1 specific configuration"; } container level-2 { uses hello-multiplier-cfg; - description "level-2 specific cfg"; + description "level-2 specific configuration"; } - description "Hello multiplier - configuration."; + description "Hello multiplier configuration."; } container priority { must '../interface-type = "broadcast"' { error-message - "Priority only applies to broadcast - interfaces."; - description - "Check for broadcast interface."; + "Priority only applies to broadcast interfaces."; + description "Check for broadcast interface."; } uses priority-cfg; container level-1 { uses priority-cfg; - description "level-1 specific cfg"; + description "level-1 specific configuration"; } container level-2 { uses priority-cfg; - description "level-2 specific cfg"; + description "level-2 specific configuration"; } description "Priority for DIS election."; } container metric { uses metric-cfg; container level-1 { uses metric-cfg; - description "level-1 specific cfg"; + description "level-1 specific configuration"; } container level-2 { uses metric-cfg; - description "level-2 specific cfg"; + description "level-2 specific configuration"; } description "Metric configuration."; } container bfd { if-feature bfd; description "BFD Client Configuration."; uses bfd-types:client-cfg-parms; reference "draft-ietf-bfd-yang-xx.txt: YANG Data Model for Bidirectional Forwarding Detection (BFD)"; } container afs { if-feature nlpid-control; list af { key af; leaf af { type iana-rt-types:address-family; - - description - "Address-family"; + description "Address-family"; } - description - "List of AFs."; + description "List of AFs."; } - description - "Container for address-families"; + description "Interface address-families"; } container mpls { container ldp { leaf igp-sync { if-feature ldp-igp-sync; type boolean; default false; - description - "Enables IGP/LDP sync."; + description "Enables IGP/LDP synchronization"; + } - description - "LDP protocol related configurations."; + description "LDP protocol related configuration."; } - description - "Container for MPLS specific configuration - for IS-IS."; + description "MPLS configuration for IS-IS interfaces"; } } grouping isis-if-topologies-cfg { - description - "IS-IS interface topology cfg."; + description "IS-IS interface topology configuration."; container metric { uses metric-cfg; container level-1 { uses metric-cfg; - description "level-1 specific cfg"; + description "level-1 specific configuration"; } container level-2 { uses metric-cfg; - description "level-2 specific cfg"; + description "level-2 specific configuration"; } - description "Metric configuration."; + description "Metric IS-IS interface configuration."; } } grouping system-counters { container system-counters { config false; list level { key level; leaf level { type level-number; - description - "This leaf describes the IS-IS level."; + description "IS-IS level."; } leaf corrupted-lsps { type uint32; description "Number of corrupted in-memory LSPs detected. LSPs received from the wire with a bad checksum are silently dropped and not counted. LSPs received from the wire with parse errors are counted by lsp-errors."; } @@ -3048,23 +2906,22 @@ } leaf database-overload { type uint32; description "Number of times the database has become overloaded."; } leaf own-lsp-purge { type uint32; description - "Number of times a zero-aged copy of the - system's own LSP is received from some - other node."; + "Number of times a zero-aged copy of the system's + own LSP is received from some other IS-IS node."; } leaf manual-address-drop-from-area { type uint32; description "Number of times a manual address has been dropped from the area."; } leaf max-sequence { type uint32; description @@ -3073,1599 +2930,1386 @@ } leaf sequence-number-skipped { type uint32; description "Number of times a sequence number skip has occured."; } leaf id-len-mismatch { type uint32; description - "Number of times a PDU is received with - a different value for ID field length - from that of the receiving system."; + "Number of times a PDU is received with a + different value for the ID field length + than that of the receiving system."; } leaf partition-changes { type uint32; description "Number of partition changes detected."; } leaf lsp-errors { type uint32; description - "Number of LSPs with errors we have - received."; + "Number of LSPs with errors we have received."; } leaf spf-runs { type uint32; description "Number of times we ran SPF at this level."; } description "List of supported levels."; } description - "The container defines a list of counters - for the IS."; + "List counters for the IS-IS protocol instance"; } - description - "Grouping for system counters."; + description "System counters grouping."; } grouping event-counters { container event-counters { config false; leaf adjacency-changes { type uint32; description - "The number of times an adjacency state - change has occured on this interface."; + "The number of times an adjacency state change has + occured on this interface."; } leaf adjacency-number { type uint32; description - "The number of adjacencies on this - interface."; + "The number of adjacencies on this interface."; } leaf init-fails { type uint32; description - "The number of times initialization of - this interface has failed. This counts - events such as PPP NCP failures. - Failures to form an adjacency are counted - by adjacency-rejects."; + "The number of times initialization of this + interface has failed. This counts events such + as PPP NCP failures. Failures to form an + adjacency are counted by adjacency-rejects."; } leaf adjacency-rejects { type uint32; description "The number of times an adjacency has been rejected on this interface."; } leaf id-len-mismatch { type uint32; description "The number of times an IS-IS PDU with an ID field length different from that for this system has been received on this interface."; } leaf max-area-addresses-mismatch { type uint32; description - "The number of times an IS-IS PDU with - according max area address field - differs from that for - this system has been received on this - interface."; + "The number of times an IS-IS PDU has been + received on this interface with the + max area address field differing from that of + this system."; } leaf authentication-type-fails { type uint32; description "Number of authentication type mismatches."; } leaf authentication-fails { type uint32; description "Number of authentication key failures."; } leaf lan-dis-changes { type uint32; description - "The number of times the DIS has changed - on this interface at this level. - If the interface type is point to point, - the count is zero."; + "The number of times the DIS has changed on this + interface at this level. If the interface type is + point-to-point,the count is zero."; } - description - "Provides protocol event counters."; + description "IS-IS interface event counters."; } description - "Grouping for event counters"; + "Grouping for IS-IS interface event counters"; } grouping packet-counters { container packet-counters { config false; list level { key level; leaf level { type level-number; - description - "This leaf describes the IS-IS level."; + description "IS-IS level."; } container iih { leaf in { type uint32; - description - "Received PDUs."; + description "Received IIH PDUs."; } leaf out { type uint32; - description - "Sent PDUs."; + description "Sent IIH PDUs."; } - description - "The number of IIH PDUs received/sent."; + description "Number of IIH PDUs received/sent."; } container ish { leaf in { type uint32; - description - "Received PDUs."; + description "Received ISH PDUs."; } leaf out { type uint32; - description - "Sent PDUs."; + description "Sent ISH PDUs."; } description - "The number of ISH PDUs received/sent."; + "ISH PDUs received/sent."; } container esh { leaf in { type uint32; - description - "Received PDUs."; + description "Received ESH PDUs."; } leaf out { type uint32; - description - "Sent PDUs."; + description "Sent ESH PDUs."; } - description - "The number of ESH PDUs received/sent."; + description "Number of ESH PDUs received/sent."; } container lsp { leaf in { type uint32; - description - "Received PDUs."; + description "Received LSP PDUs."; } leaf out { type uint32; - description - "Sent PDUs."; + description "Sent LSP PDUs."; } - description - "The number of LSP PDUs received/sent."; + description "Number of LSP PDUs received/sent."; } container psnp { leaf in { type uint32; - description - "Received PDUs."; + description "Received PSNP PDUs."; } leaf out { type uint32; - description - "Sent PDUs."; + description "Sent PSNP PDUs."; } - description - "The number of PSNP PDUs received/sent."; + description "Number of PSNP PDUs received/sent."; } container csnp { leaf in { type uint32; - description - "Received PDUs."; + description "Received CSNP PDUs."; } leaf out { type uint32; - description - "Sent PDUs."; + description "Sent CSNP PDUs."; } - description - "The number of CSNP PDUs received/sent."; + description "Number of CSNP PDUs received/sent."; } container unknown { leaf in { type uint32; - description - "Received PDUs."; + description "Received unknown PDUs."; } leaf out { type uint32; - description - "Sent PDUs."; + description "Sent unknown PDUs."; } - description - "The number of unknown PDUs received/sent."; + description "Number of unknown PDUs received/sent."; } description - "List of supported levels."; + "List of packet counter for supported llevels."; } - description - "Provides packet counters per level."; + description "Packet counters per IS-IS level."; } description - "Grouping for packet counters."; + "Grouping for per IS-IS Level packet counters."; } grouping spf-log { container spf-log { config false; list event { key id; leaf id { type uint32; description - "This leaf defines the event identifier. - This is a purely internal value."; - + "Event identifier - purely internal value."; } leaf spf-type { type enumeration { enum full { - description - "Computation done is a Full SPF."; + description "Full SPF computation."; } enum route-only { description - "Computation done is a - reachability computation - only."; + "Route reachability only SPF computation"; } } - description - "This leaf describes the type of computation - used."; + description "Type of SPF computation performed."; } leaf level { type level-number; description - "This leaf describes the level affected by the - the computation."; + "IS-IS level number for SPF computation"; } leaf schedule-timestamp { type yang:timestamp; description - "This leaf describes the timestamp - when the computation was scheduled."; + "Timestamp of when the SPF computation was + scheduled."; } leaf start-timestamp { type yang:timestamp; description - "This leaf describes the timestamp - when the computation was started."; + "Timestamp of when the SPF computation started."; } leaf end-timestamp { type yang:timestamp; description - "This leaf describes the timestamp - when the computation was ended."; + "Timestamp of when the SPF computation ended."; } list trigger-lsp { key "lsp"; leaf lsp { type lsp-id; description - "This leaf describes the LSPID - of the LSP."; + "LSPID of the LSP triggering SPF computation."; } leaf sequence { type uint32; description - "This leaf describes the sequence - number of the LSP."; + "Sequence number of the LSP triggering SPF + computation"; } description - "This leaf describes list of LSPs - that triggered the computation."; + "This list includes the LSPs that triggered the + SPF computation."; + } description - "List of computation events. - It is used as a wrapping buffer."; + "List of computation events - implemented as a + wrapping buffer."; } description "This container lists the SPF computation events."; } - description - "Grouping for spf-log events."; + description "Grouping for spf-log events."; } grouping lsp-log { container lsp-log { config false; list event { key id; leaf id { type uint32; description - "This leaf defines the event identifier. - This is a purely internal value."; + "Event identifier - purely internal value."; } leaf level { type level-number; description - "This leaf describes the level affected by the - the computation."; + "IS-IS level number for LSP"; } container lsp { leaf lsp { type lsp-id; description - "This leaf describes the LSPID - of the LSP."; + "LSPID of the LSP."; } leaf sequence { type uint32; description - "This leaf describes the sequence - number of the LSP."; + "Sequence number of the LSP."; } description - "This container describes the received LSP - , in case of local LSP update the local - LSP ID is referenced."; + "LSP identification container - either the received + LSP or the locally generated LSP."; } leaf received-timestamp { type yang:timestamp; - description - "This leaf describes the timestamp - when the LSP was received. In case of - local LSP update, the timestamp refers - to the local LSP update time."; + "Timestamp of when the LSP was received. In case + of local LSP update, the timestamp refers to the + local LSP update time."; } leaf change { type identityref { base lsp-log-reason; } - description - "This leaf describes the type of change - in the LSP."; + description "Type of LSP change."; } description - "List of LSP events. - It is used as a wrapping buffer."; + "List of LSP events - implemented as a + wrapping buffer."; } description - "This container lists the LSP reception events. - Local LSP modification are also contained in the - list."; - } - description - "Grouping for LSP log."; + "LSP reception and local LSP origination events + container."; + + } description "Grouping for LSP log."; } grouping hostname-db { container hostnames { config false; list hostname { key system-id; leaf system-id { type system-id; description - "This leaf describes the system-id - associated with the hostname."; + "System-id associated with the hostname."; } leaf hostname { type string; description - "This leaf describes the hostname - associated with the system ID."; + "Hostname associated with the system ID."; } description - "List of system-id/hostname associations"; + "List of system-id/hostname associations."; } description - "This container describes the list - of binding between system-id and - hostnames."; + "Hostname to system-id mapping database."; } description - "Grouping for hostname to systemid mapping database."; + "Grouping for hostname to system-id mapping database."; + } /* Groupings for the LSDB description */ grouping prefix-reachability-attributes { description - "This group defines extended reachability attributes of an + "Grouping for extended reachability attributes of an IPv4 or IPv6 prefix."; leaf external-prefix-flag { type boolean; - description - "External prefix flag."; + description "External prefix flag."; } leaf readvertisement-flag { type boolean; - description - "Readvertisement flag."; + description "Readvertisement flag."; } leaf node-flag { type boolean; - description - "Node flag."; + description "Node flag."; } } grouping prefix-ipv4-source-router-id { description - "This group defines the IPv4 source router ID of - a prefix advertisement."; + "Grouping for the IPv4 source router ID of a prefix + advertisement."; leaf ipv4-source-router-id { type inet:ipv4-address; - description - "IPv4 Source router ID address."; + description "IPv4 Source router ID address."; } } grouping prefix-ipv6-source-router-id { description - "This group defines the IPv6 source router ID of - a prefix advertisement."; + "Grouping for the IPv6 source router ID of a prefix + advertisement."; leaf ipv6-source-router-id { type inet:ipv6-address; - description - "IPv6 Source router ID address."; + description "IPv6 Source router ID address."; } } grouping prefix-attributes-extension { - description - "Prefix extended attributes."; - + description "Prefix extended attributes."; uses prefix-reachability-attributes; uses prefix-ipv4-source-router-id; uses prefix-ipv6-source-router-id; } grouping prefix-ipv4-std { description - "This group defines attributes of an - IPv4 standard prefix."; + "Grouping for attributes of an IPv4 standard prefix."; leaf up-down { type boolean; - description - "This leaf expresses the value of up/down bit."; + description "Value of up/down bit."; } leaf i-e { type boolean; - description - "This leaf expresses the value of I/E bit."; + description "Value of I/E bit."; } leaf ip-prefix { type inet:ipv4-address; - description - "This leaf describes the IPv4 prefix"; + description "IPv4 prefix address"; } leaf prefix-len { type uint8; - description - "This leaf describes the IPv4 prefix len in bits"; + description "IPv4 prefix length (in bits)"; } leaf default-metric { type std-metric; - description - "This leaf describes the IS-IS default metric value"; + description "Default IS-IS metric for IPv4 prefix"; } container delay-metric { leaf metric { type std-metric; - description - "This leaf describes the IS-IS delay metric value"; + description "IS-IS delay metric for IPv4 prefix"; } leaf supported { type boolean; default "false"; description - "This leaf describes if the metric is supported."; + "Indicates whether IS-IS delay metric is supported."; } - - description - "This container defines the IS-IS delay metric."; + description "IS-IS delay metric container."; } container expense-metric { leaf metric { type std-metric; - description - "This leaf describes the IS-IS expense metric value"; + description "IS-IS expense metric for IPv4 prefix"; } leaf supported { type boolean; default "false"; description - "This leaf describes if the metric is supported."; + "Indicates whether IS-IS delay metric is supported."; } - description - "This container defines the IS-IS expense metric."; - + description "IS-IS expense metric container."; } container error-metric { leaf metric { type std-metric; description "This leaf describes the IS-IS error metric value"; } leaf supported { type boolean; default "false"; - description - "This leaf describes if the metric is supported."; + description "IS-IS error metric for IPv4 prefix"; } - - description - "This container defines the IS-IS error metric."; + description "IS-IS error metric container."; } } grouping prefix-ipv4-extended { description - "This group defines attributes of an - IPv4 extended prefix."; + "Grouping for attributes of an IPv4 extended prefix."; leaf up-down { type boolean; - description - "This leaf expresses the value of up/down bit."; + description "Value of up/down bit."; } leaf ip-prefix { type inet:ipv4-address; - description - "This leaf describes the IPv4 prefix"; + description "IPv4 prefix address"; } leaf prefix-len { type uint8; - description - "This leaf describes the IPv4 prefix len in bits"; + description "IPv4 prefix length (in bits)"; } leaf metric { type wide-metric; - description - "This leaf describes the IS-IS metric value"; + description "IS-IS wide metric value"; } leaf-list tag { type uint32; description - "This leaf describes a list of tags associated with - the prefix."; + "List of 32-bit tags associated with the IPv4 prefix."; } leaf-list tag64 { type uint64; description - "This leaf describes a list of 64-bit tags associated with - the prefix."; + "List of 32-bit tags associated with the IPv4 prefix."; } uses prefix-attributes-extension; } grouping prefix-ipv6-extended { - description - "This group defines attributes of an - IPv6 prefix."; + description "Grouping for attributes of an IPv6 prefix."; leaf up-down { type boolean; - description - "This leaf expresses the value of up/down bit."; + description "Value of up/down bit."; } leaf ip-prefix { type inet:ipv6-address; - description - "This leaf describes the IPv6 prefix"; + description "IPv6 prefix address"; } leaf prefix-len { type uint8; - description - "This leaf describes the IPv4 prefix len in bits"; + description "IPv4 prefix length (in bits)"; } leaf metric { type wide-metric; - description - "This leaf describes the IS-IS metric value"; + description "IS-IS wide metric value"; } leaf-list tag { type uint32; description - "This leaf describes a list of tags associated with - the prefix."; + "List of 32-bit tags associated with the IPv4 prefix."; } leaf-list tag64 { type uint64; description - "This leaf describes a list of 64-bit tags associated with - the prefix."; + "List of 32-bit tags associated with the IPv4 prefix."; } uses prefix-attributes-extension; - } grouping neighbor-extended { description - "This group defines attributes of an - IS-IS extended neighbor."; + "Grouping for attributes of an IS-IS extended neighbor."; leaf neighbor-id { type system-id; - description - "This leaf describes the system-id of the neighbor."; + description "System-id of the extended neighbor."; } leaf metric { type wide-metric; - description - "This leaf describes the IS-IS metric value"; + description "IS-IS wide metric for extended neighbor"; } + } grouping neighbor { - description - "This group defines attributes of an - IS-IS standard neighbor."; + description "IS-IS standard neighbor grouping."; leaf neighbor-id { type system-id; - description - "This leaf describes the system-id of the neighbor."; + description "IS-IS neighbor system-id"; } leaf i-e { type boolean; description - "This leaf expresses the value of I/E bit."; + "Internal or External (I/E) Metric bit value"; } leaf default-metric { type std-metric; - description - "This leaf describes the IS-IS default metric value"; + description "IS-IS default metric value"; } container delay-metric { leaf metric { type std-metric; - description - "This leaf describes the IS-IS delay metric value"; + description "IS-IS delay metric value"; } leaf supported { type boolean; default "false"; - description - "This leaf describes if the metric is supported."; - + description "IS-IS delay metric supported"; } - description - "This container defines the IS-IS delay metric."; + description "IS-IS delay metric container"; } container expense-metric { leaf metric { type std-metric; - description - "This leaf describes the IS-IS delay expense value"; + description "IS-IS delay expense metric value"; } leaf supported { type boolean; default "false"; - description - "This leaf describes if the metric is supported."; + description "IS-IS delay expense metric supported"; } - description - "This container defines the IS-IS expense metric."; + description "IS-IS delay expense metric container"; } container error-metric { leaf metric { type std-metric; - description - "This leaf describes the IS-IS error metric value"; + description "IS-IS error metric value"; } leaf supported { type boolean; default "false"; - description - "This leaf describes if the metric is supported."; + description "IS-IS error metric supported"; } - description - "This container defines the IS-IS error metric."; + description "IS-IS error metric container"; } } grouping lsp-entry { - description - "This group defines attributes of an - IS-IS LSP database entry."; + description "IS-IS LSP database entry groupting"; leaf decoded-completed { type boolean; - description - "The IS-IS body is fully decoded."; + description "IS-IS LSP body fully decoded."; } leaf raw-data { type yang:hex-string; description - "The complete LSP in network byte - order hexadecimal as received or originated."; + "The hexadecial representation of the complete LSP in + network-byte order (NBO) as received or originated."; } leaf lsp-id { type lsp-id; - description - "This leaf describes the LSP ID of the LSP."; + description "LSP ID of the LSP"; } leaf checksum { type uint16; - description - "This leaf describes the checksum of the LSP."; + description "LSP checksum"; } leaf remaining-lifetime { type uint16; units "seconds"; description - "This leaf describes the remaining lifetime - in seconds before the LSP expiration."; + "Remaining lifetime (in seconds) until LSP expiration."; } leaf sequence { type uint32; description "This leaf describes the sequence number of the LSP."; } leaf attributes { type bits { - bit PARTITIONNED { - description - "If set, the originator supports partition - repair."; + bit partitioned { + description "Originator partition repair supported"; } - bit ATTACHED-ERROR { + bit attached-error { description "If set, the originator is attached to another area using the referred metric."; + } - bit ATTACHED-EXPENSE { + bit attached-expense { description "If set, the originator is attached to another area using the referred metric."; } - bit ATTACHED-DELAY { + bit attached-delay { description "If set, the originator is attached to another area using the referred metric."; } - bit ATTACHED-DEFAULT { + bit attached-default { description "If set, the originator is attached to another area using the referred metric."; } - bit OVERLOAD { + bit overload { description "If set, the originator is overloaded, and must be avoided in path calculation."; } } - description - "This leaf describes attributes of the LSP."; + description "LSP attributes"; } leaf-list ipv4-addresses { type inet:ipv4-address; description - "This leaf describes the IPv4 addresses of the node. - IS-IS reference is TLV 132."; + "List of IPv4 addresses of the IS-IS node - IS-IS + reference is TLV 132."; } leaf-list ipv6-addresses { type inet:ipv6-address; description - "This leaf describes the IPv6 interface - addresses of the node. - IS-IS reference is TLV 232."; + "List of IPv6 addresses of the IS-IS node - IS-IS + reference is TLV 232."; } leaf ipv4-te-routerid { type inet:ipv4-address; description - "This leaf describes the IPv4 Traffic Engineering - router ID of the node. + "IPv4 Traffic Engineering router ID of the IS-IS node - IS-IS reference is TLV 134."; } leaf ipv6-te-routerid { type inet:ipv6-address; description - "This leaf describes the IPv6 Traffic Engineering - router ID of the node. + "IPv6 Traffic Engineering router ID of the IS-IS node - IS-IS reference is TLV 140."; } leaf-list protocol-supported { type uint8; description - "This leaf describes the list of - supported protocols. + "List of supported protocols of the IS-IS node - IS-IS reference is TLV 129."; } leaf dynamic-hostname { type string; description - "This leaf describes the name of the node. - IS-IS reference is TLV 137."; + "Host Name of the IS-IS node - IS-IS reference + is TLV 137."; } container authentication { leaf authentication-type { type string; description - "This leaf describes the authentication type - to be used."; + "Authentication type to be used with IS-IS node."; } leaf authentication-key { type string; description - "This leaf describes the authentication key - to be used. For security reason, the - authentication key MUST NOT be presented - in plaintext format. Authors recommends - to use MD5 hash to present the authentication-key."; + "Authentication keyto be used. For security reasons, + the authentication key MUST NOT be presented in + plaintext format. It is recommended to use an MD5 + hash to present the authentication-key."; } - description "This container describes authentication - information of the node. IS-IS reference is TLV 10."; + description + "IS-IS node authentication information container - + IS-IS reference is TLV 10."; } container mt-entries { list topology { + description + "List of topologies supported"; leaf MT-ID { type uint16 { range "0 .. 4095"; } description - "This leaf defines the identifier - of a topology."; + "Multi-Topolgoy identifier of topology."; } leaf attributes { type bits { - bit OVERLOAD { + bit overload { description "If set, the originator is overloaded, - and must be avoided in path - calculation."; + and must be avoided in path calculation."; } - bit ATTACHED { + bit attached { description "If set, the originator is attached to another area using the referred metric."; } } description - "This leaf describes attributes of the LSP - for the associated topology."; + "Attributes of the LSP for the associated + topology."; } - description - "List of topologies supported."; } description - "This container describes the topology supported. + "IS-IS node topology information container - IS-IS reference is TLV 229."; } list router-capabilities { leaf flags { type bits { bit flooding { position 0; description - "If the S bit is set(1), - the IS-IS Router CAPABILITY TLV - MUST be flooded across the entire routing domain. - If the S bit is - not set(0), the TLV MUST NOT be leaked between levels. - This bit MUST NOT be altered during the TLV leaking."; + "If the S bit is set, the IS-IS Router CAPABILITY + TLV MUST be flooded across the entire routing + domain. If the S bit is clear, the TLV MUST NOT + be leaked between levels. This bit MUST NOT + be altered during the TLV leaking."; } bit down { position 1; description - "When the IS-IS Router CAPABILITY TLV is - leaked from level-2 to level-1, the D bit - MUST be set. Otherwise, this bit MUST - be clear. IS-IS Router capability TLVs - with the D bit set MUST NOT - be leaked from level-1 to level-2. - This is to prevent TLV looping. - "; + "When the IS-IS Router CAPABILITY TLV is leaked + from level-2 to level-1, the D bit MUST be set. + Otherwise, this bit MUST be clear. IS-IS Router + capability TLVs with the D bit set MUST NOT be + leaked from level-1 to level-2 in to prevent + TLV looping."; } } - description - "Flags associated with router capability."; + description "Router Capability Flags"; } container node-tags { if-feature node-tag; list node-tag { leaf tag { type uint32; - description - "Node tag value."; + description "Node tag value."; } - description - "List of tags."; + description "List of tags."; } - description - "Container for node tags."; + description "Node Tag container"; } leaf binary { type binary; description - "This leaf describes the capability of the node. - Format is binary according to the protocol encoding."; + "Binary encoding of the IS-IS node capabilities"; } description - "This container describes the capabilities of the node. - This container may be extended with detailed - information. - IS-IS reference is TLV 242."; + "IS-IS node capabilities container. This container may + be extended with detailed information - IS-IS + reference is TLV 242."; } container is-neighbor { list neighbor { uses neighbor; - description - "List of neighbors."; + description "List of neighbors."; } description - "This leaf describes list of IS-IS neighbors. - IS-IS reference is TLV 2."; + "Standard IS neighbors container - IS-IS reference is + TLV 2."; } container extended-is-neighbor { list neighbor { uses neighbor-extended; description - "List of neighbors."; - + "List of extended IS neighbors"; } description - "This container describes list of IS-IS extended - neighbors. - IS-IS reference is TLV 22."; + "Standard IS extended neighbors container - IS-IS + reference is TLV 22"; } container ipv4-internal-reachability { list prefixes { uses prefix-ipv4-std; - description - "List of prefixes."; + description "List of prefixes."; } description - "This container describes list of IPv4 internal - reachability information. - IS-IS reference is TLV 128."; + "IPv4 internal reachability information container - IS-IS + reference is TLV 128."; } container ipv4-external-reachability { list prefixes { uses prefix-ipv4-std; - description - "List of prefixes."; + description "List of prefixes."; } description - "This container describes list of IPv4 external - reachability information. + "IPv4 external reachability information container - IS-IS reference is TLV 130."; } container extended-ipv4-reachability { list prefixes { uses prefix-ipv4-extended; - description - "List of prefixes."; + description "List of prefixes."; } description - "This container describes list of IPv4 extended - reachability information. + "IPv4 extended reachability information container - IS-IS reference is TLV 135."; } container mt-is-neighbor { list neighbor { - leaf MT-ID { + leaf mt-id { type uint16 { range "0 .. 4095"; - } - description - "This leaf defines the identifier - of a topology."; + description "Multi-topology (MT) identifier"; } uses neighbor-extended; - description - "List of neighbors."; + description "List of neighbors."; } description - "This container describes list of IS-IS multi-topology - neighbors. - IS-IS reference is TLV 223."; + "IS-IS multi-topology neighbor container - IS-IS + reference is TLV 223."; } container mt-extended-ipv4-reachability { list prefixes { - leaf MT-ID { + leaf mt-id { type uint16 { range "0 .. 4095"; } - description - "This leaf defines the identifier - of a topology."; + description "Multi-topology (MT) identifier"; } uses prefix-ipv4-extended; - description - "List of prefixes."; - + description "List of extended prefixes."; } description - "This container describes list of IPv4 - reachability information in multi-topology - environment. - IS-IS reference is TLV 235."; + "IPv4 multi-topolgy (MT) extended reachability + information container - IS-IS reference is TLV 235."; } container mt-ipv6-reachability { list prefixes { leaf MT-ID { type uint16 { range "0 .. 4095"; } - description - "This leaf defines the identifier - of a topology."; + description "Multi-topology (MT) identifier"; } uses prefix-ipv6-extended; - description - "List of prefixes."; + description "List of IPv6 extended prefixes."; } description - "This container describes list of IPv6 - reachability information in multi-topology - environment. - IS-IS reference is TLV 237."; + "IPv6 multi-topolgy (MT) extended reachability + information container - IS-IS reference is TLV 237."; } container ipv6-reachability { list prefixes { uses prefix-ipv6-extended; - description - "List of prefixes."; + description "List of IPv6 prefixes."; } description - "This container describes list of IPv6 - reachability information. - IS-IS reference is TLV 236."; + "IPv6 reachability information container - IS-IS + reference is TLV 236."; } } grouping lsdb { + description "Link State Database (LSDB) grouping"; container database { config false; list level-db { key level; leaf level { type level-number; - description - "Current level number"; + description "LSDB level number (1 or 2)"; } list lsp { key lsp-id; uses lsp-entry; - description - "List of LSPs in LSDB."; + description "List of LSPs in LSDB"; } - description - "This container describes the list of LSPs - in the level x database."; + description "LSP list for LSDB level container"; } - description - "This container describes IS-IS Link State - databases."; + description "IS-IS Link State database container"; } - description - "Grouping for LSDB description."; } /* Augmentations */ augment "/rt:routing/" +"rt:ribs/rt:rib/rt:routes/rt:route" { when "rt:source-protocol = 'isis:isis'" { description "IS-IS-specific route attributes."; } uses route-content; description "This augments route object in RIB with IS-IS-specific attributes."; } augment "/if:interfaces/if:interface" { leaf clns-mtu { type uint16; - description - "Defines CLNS MTU of the interface."; + description "CLNS MTU of the interface"; } description "ISO interface config."; } augment "/rt:routing/rt:control-plane-protocols/" +"rt:control-plane-protocol" { when "rt:type = 'isis:isis'" { description "This augment is only valid when routing protocol - instance type is isis."; + instance type is 'isis'"; } description "This augments a routing protocol instance with IS-IS specific parameters."; container isis { must "count(area-address) > 0" { - error-message "At least one area-address - must be configured."; + error-message + "At least one area-address must be configured."; description "Enforce configuration of at least one area."; } + uses isis-global-cfg; container fast-reroute { if-feature fast-reroute; uses fast-reroute-global-cfg; uses fast-reroute-global-state; description - "IPFRR."; + "IP Fast ReRoute (IPFRR) global container"; } container spf-control { container ietf-spf-delay { if-feature ietf-spf-delay; uses ietf-spf-delay-cfg; uses ietf-spf-delay-state; - description - "IETF spf delay algorithm configuration."; + description "IETF SPF delay algorithm container"; } description - "Container for all SPF computation related - operations."; + "SPF computation-related information container"; } container topologies { if-feature multi-topology; list topology { key "name"; leaf enable { type boolean; - description - "Control enabling of topologies"; + description "Topology enable configuration"; } leaf name { type leafref { path "../../../../../../rt:ribs/rt:rib/rt:name"; } - - description "RIB"; + description + "Routing Information Base (RIB) corresponding + to topology."; } uses isis-global-topologies-cfg; - description - "List of topologies"; + description "List of topologies"; } - description - "Container for multi-topology"; + description "Multi-topology container"; } container interfaces { list interface { key "name"; leaf name { type if:interface-ref; description "Reference to the interface within the routing-instance."; } uses isis-if-cfg; container fast-reroute { if-feature fast-reroute; uses fast-reroute-if-cfg; description - "IPFRR."; + "IP Fast ReRoute (IPFRR) interface container"; } container topologies { if-feature multi-topology; list topology { key name; leaf name { type leafref { path "../../../../../../../../"+ "rt:ribs/rt:rib/rt:name"; } description - "Name of RIB."; + "Routing Information Base (RIB) corresponding + to topology."; } uses isis-if-topologies-cfg; - description - "List of topologies."; + description "List of interface topologies"; } - description - "Container for multi-topology"; + description "Multi-topology container"; } uses adjacency-state; uses event-counters; uses packet-counters; - description - "List of IS-IS interfaces."; + description "List of IS-IS interfaces."; } description - "This container defines IS-IS interface specific - configuration objects."; + "IS-IS interface specific configuration container"; } uses spf-log; uses lsp-log; uses hostname-db; uses lsdb; uses local-rib; uses system-counters; description - "This container defines IS-IS specific configuration - objects."; + "IS-IS configuration/state top-level container"; } } /* RPC methods */ rpc clear-adjacency { description - "This RPC request clears a particular - set of IS-IS adjacencies. If the operation - fails for IS-IS internal reason, then - error-tag and error-app-tag should be set - to a meaningful value."; + "This RPC request clears a particular set of IS-IS + adjacencies. If the operation fails due to an internal + reason, then the error-tag and error-app-tag should be + set indicating the reason for the failure."; input { leaf routing-protocol-instance-name { type instance-state-ref; mandatory "true"; description "Name of the IS-IS protocol instance whose IS-IS information is being queried. - If the IS-IS instance with name equal to the - value of this parameter doesn't exist, then this - operation SHALL fail with error-tag 'data-missing' - and error-app-tag + If the corresponding IS-IS instance doesn't exist, + then the operation will fail with an error-tag of + 'data-missing' and an error-app-tag of 'routing-protocol-instance-not-found'."; } leaf level { type level; description - "IS-IS level of the adjacency to be cleared. - If IS-IS level is level-1-2, both level 1 and level 2 + "IS-IS level of the adjacency to be cleared. If the + IS-IS level is level-1-2, both level 1 and level 2 adjacencies would be cleared. If the value provided is different from the one - authorized in the enum type, then this - operation SHALL fail with error-tag 'data-missing' - and error-app-tag - 'bad-isis-level'. - "; - + authorized in the enum type, then the operation + SHALL fail with an error-tag of 'data-missing' and + an error-app-tag of 'bad-isis-level'."; } leaf interface { type string; description - "Name of the IS-IS interface. + "IS-IS interface name. - If the IS-IS interface with name equal to the - value of this parameter doesn't exist, then this - operation SHALL fail with error-tag 'data-missing' - and error-app-tag + If the corresponding IS-IS interface doesn't exist, + then the operation SHALL fail with an error-tag of + 'data-missing' and an error-app-tag of 'isis-interface-not-found'."; } } } rpc clear-database { description - "This RPC request clears a particular - IS-IS database. If the operation - fails for IS-IS internal reason, then - error-tag and error-app-tag should be set - to a meaningful value."; + "This RPC request clears a particular IS-IS database. If + the operation fails for an IS-IS internal reason, then + the error-tag and error-app-tag should be set + indicating the reason for the failure."; input { leaf routing-protocol-instance-name { type instance-state-ref; mandatory "true"; description "Name of the IS-IS protocol instance whose IS-IS - information is being queried. + database(s) is/are being cleard. - If the IS-IS instance with name equal to the - value of this parameter doesn't exist, then this - operation SHALL fail with error-tag 'data-missing' - and error-app-tag + If the corresponding IS-IS instance doesn't exist, + then the operation will fail with an error-tag of + 'data-missing' and an error-app-tag of 'routing-protocol-instance-not-found'."; } leaf level { type level; description - "IS-IS level of the adjacency to be cleared. - If IS-IS level is level-1-2, both level 1 and level 2 - adjacencies would be cleared. + "IS-IS level of the adjacency to be cleared. If the + IS-IS level is level-1-2, both level 1 and level 2 + databases would be cleared. If the value provided is different from the one - authorized in the enum type, then this - operation SHALL fail with error-tag 'data-missing' - and error-app-tag - 'bad-isis-level'. - - "; + authorized in the enum type, then the operation + SHALL fail with an error-tag of 'data-missing' and + an error-app-tag of 'bad-isis-level'."; } } } /* Notifications */ - notification database-overload { uses notification-instance-hdr; leaf overload { type enumeration { - enum "off" { + enum off { description - "The system has left overload condition."; + "Indicates IS-IS instance has left overload state"; } - enum "on" { + enum on { description - "The system is in overload condition."; + "Indicates IS-IS instance has entered overload state"; } } - description - "Describes the new overload state of the instance."; + description "New overload state of the IS-IS instance"; } description "This notification is sent when an IS-IS instance - overload condition changes."; + overload state changes."; } notification lsp-too-large { uses notification-instance-hdr; uses notification-interface-hdr; leaf pdu-size { type uint32; - description - "Size of the PDU"; + description "Size of the LSP PDU"; } leaf lsp-id { type lsp-id; - description - "LSP ID."; + description "LSP ID"; } description - "This notification is sent when we attempt - to propagate an LSP that is larger than the - dataLinkBlockSize for the circuit. - The notification generation must be throttled - with at least a 5 second gap. - "; + "This notification is sent when we attempt to propagate + an LSP that is larger than the dataLinkBlockSize for the + circuit. The notification generation must be throttled + with at least 5 seconds betweeen successive + notifications."; } notification if-state-change { uses notification-instance-hdr; uses notification-interface-hdr; leaf state { type if-state-type; description "Interface state."; } description "This notification is sent when an interface state change is detected."; } notification corrupted-lsp-detected { uses notification-instance-hdr; leaf lsp-id { type lsp-id; - description - "LSP ID."; + description "LSP ID"; } description - "This notification is sent when we find - that an LSP that was stored in memory has - become corrupted. - "; + "This notification is sent when we find that + an LSP that was stored in memory has become + corrupted."; } notification attempt-to-exceed-max-sequence { uses notification-instance-hdr; leaf lsp-id { type lsp-id; - description - "LSP ID."; + description "LSP ID"; } description "This notification is sent when the system - wraps the 32-bit sequence counter of an LSP. - "; + wraps the 32-bit sequence counter of an LSP."; } notification id-len-mismatch { uses notification-instance-hdr; uses notification-interface-hdr; leaf pdu-field-len { type uint8; - description - "Size of the ID length in the received PDU"; + description "Size of the ID length in the received PDU"; } leaf raw-pdu { type binary; - description - "Received raw PDU."; + description "Received raw PDU."; } description "This notification is sent when we receive a PDU with a different value for the System ID length. The notification generation must be throttled - with at least a 5 second gap. - "; + with at least 5 seconds betweeen successive + notifications."; + } notification max-area-addresses-mismatch { uses notification-instance-hdr; uses notification-interface-hdr; leaf max-area-addresses { type uint8; - description - "Received number of supported areas"; + description "Received number of supported areas"; } leaf raw-pdu { type binary; - description - "Received raw PDU."; + description "Received raw PDU."; } description "This notification is sent when we receive a PDU with a different value for the Maximum Area Addresses. The notification generation must be throttled - with at least a 5 second gap. - "; + with at least 5 seconds betweeen successive + notifications."; } notification own-lsp-purge { uses notification-instance-hdr; uses notification-interface-hdr; leaf lsp-id { type lsp-id; - description - "LSP ID."; + description "LSP ID"; } description - "This notification is sent when the system - receives a PDU with its own system ID and zero age. - "; + "This notification is sent when the system receives + a PDU with its own system ID and zero age."; } notification sequence-number-skipped { uses notification-instance-hdr; uses notification-interface-hdr; leaf lsp-id { type lsp-id; - description - "LSP ID."; + description "LSP ID"; } description - "This notification is sent when the system - receives a PDU with its own system ID and - different contents. The system has to reissue - the LSP with a higher sequence number. - "; + "This notification is sent when the system receives a + PDU with its own system ID and different contents. The + system has to reoriginate the LSP with a higher sequence + number."; } - notification authentication-type-failure { uses notification-instance-hdr; uses notification-interface-hdr; leaf raw-pdu { type binary; - description - "Received raw PDU."; + description "Received raw PDU."; } description - "This notification is sent when the system - receives a PDU with the wrong authentication type - field. - The notification generation must be throttled with - at least a 5 second gap. - "; + "This notification is sent when the system receives a + PDU with the wrong authentication type field. + The notification generation must be throttled + with at least 5 seconds betweeen successive + notifications."; } notification authentication-failure { uses notification-instance-hdr; uses notification-interface-hdr; leaf raw-pdu { type binary; - description - "Received raw PDU."; - + description "Received raw PDU."; } description - "This notification is sent when the system - receives a PDU with the wrong authentication - information. + "This notification is sent when the system receives + a PDU with the wrong authentication information. The notification generation must be throttled with - at least a 5 second gap. - "; + with at least 5 seconds betweeen successive + notifications."; } notification version-skew { uses notification-instance-hdr; uses notification-interface-hdr; leaf protocol-version { type uint8; - description - "Protocol version received in the PDU."; + description "Protocol version received in the PDU."; } leaf raw-pdu { type binary; - description - "Received raw PDU."; + description "Received raw PDU."; } description - "This notification is sent when the system - receives a PDU with a different protocol version - number. - The notification generation must be throttled with at least - a 5 second gap. - "; + "This notification is sent when the system receives a + PDU with a different protocol version number. + The notification generation must be throttled + with at least 5 seconds betweeen successive + notifications."; } - notification area-mismatch { uses notification-instance-hdr; uses notification-interface-hdr; leaf raw-pdu { type binary; - description - "Received raw PDU."; + description "Received raw PDU."; } description - "This notification is sent when the system - receives a Hello PDU from an IS that does - not share any area address. - The notification generation must be throttled with at least - a 5 second gap. - "; + "This notification is sent when the system receives a + Hello PDU from an IS that does not share any area + address. The notification generation must be throttled + with at least 5 seconds betweeen successive + notifications."; } + notification rejected-adjacency { uses notification-instance-hdr; uses notification-interface-hdr; leaf raw-pdu { type binary; description "Received raw PDU."; } leaf reason { type string; @@ -4665,187 +4309,163 @@ leaf raw-pdu { type binary; description "Received raw PDU."; } leaf reason { type string; description "The system may provide a reason to reject the adjacency. If the reason is not available, - the system use an empty string."; + an empty string will be returned."; } description - "This notification is sent when the system - receives a Hello PDU from an IS but does not - establish an adjacency for some reason. - The notification generation must be throttled with at least - a 5 second gap. - "; + "This notification is sent when the system receives a + Hello PDU from an IS but does not establish an adjacency + for some reason. The notification generation must be + throttled with at least 5 seconds betweeen successive + notifications."; } notification protocols-supported-mismatch { uses notification-instance-hdr; uses notification-interface-hdr; leaf raw-pdu { type binary; - description - "Received raw PDU."; + description "Received raw PDU."; } leaf-list protocols { type uint8; description - "The list of protocols supported by the - remote system."; + "List of protocols supported by the remote system."; } description - "This notification is sent when the system - receives a non pseudonode LSP that has no matching - protocol supported. - The notification generation must be throttled with at least - a 5 second gap. - "; + "This notification is sent when the system receives a + non-pseudonode LSP that has no matching protocols + supported. The notification generation must be throttled + with at least 5 seconds betweeen successive + notifications."; } + notification lsp-error-detected { uses notification-instance-hdr; uses notification-interface-hdr; leaf lsp-id { type lsp-id; - description - "LSP ID."; + description "LSP ID."; } leaf raw-pdu { type binary; - description - "Received raw PDU."; + description "Received raw PDU."; } leaf error-offset { type uint32; description - "If the problem is a malformed TLV, - the error-offset points to the start of the TLV. - If the problem is with the LSP header, - the error-offset points to the suspicious byte"; + "If the problem is a malformed TLV, the error-offset + points to the start of the TLV. If the problem is with + the LSP header, the error-offset points to the errant + byte"; } leaf tlv-type { type uint8; description - "if the problem is a malformed TLV, the tlv-type is set - to the type value of the suspicious TLV. - Otherwise this leaf is not present."; + "If the problem is a malformed TLV, the tlv-type is set + to the type value of the suspicious TLV. Otherwise, + this leaf is not present."; } description - "This notification is sent when the system - receives a LSP with a parse error. - The notification generation must be throttled with at least - a 5 second gap. - "; + "This notification is sent when the system receives an + ' LSP with a parse error. The notification generation must + be throttled with at least 5 seconds betweeen successive + notifications."; } notification adjacency-state-change { uses notification-instance-hdr; uses notification-interface-hdr; leaf neighbor { type string; description - "Describes the name of the neighbor. If the - name of the neighbor is not available, the - field would be empty."; + "Name of the neighbor. If the name of the neighbor is + not available, it is not returned."; } leaf neighbor-system-id { type system-id; - description - "Describes the system-id of the neighbor."; + description "Neighbor system-id"; } leaf state { type adj-state-type; - description - "This leaf describes the new state of the - IS-IS adjacency."; + description "New state of the IS-IS adjacency."; } leaf reason { type string; description - "If the adjacency is going to DOWN, - this leaf provides a reason for the adjacency - going down. The reason is provided as a text. - If the adjacency is going to UP, no reason is - provided."; + "If the adjacency is going to DOWN, this leaf provides + a reason for the adjacency going down. The reason is + provided as a text. If the adjacency is going to UP, no + reason is provided."; } description "This notification is sent when an IS-IS adjacency moves to Up state or to Down state."; } notification lsp-received { uses notification-instance-hdr; uses notification-interface-hdr; leaf lsp-id { type lsp-id; - description - "LSP ID."; + description "LSP ID"; } leaf sequence { type uint32; - description - "Sequence number of the received LSP."; + description "Sequence number of the received LSP."; } leaf received-timestamp { type yang:timestamp; - description - "This leaf describes the timestamp - when the LSP was received. "; + description "Timestamp when the LSP was received."; } leaf neighbor-system-id { type system-id; - description - "Describes the system-id of the neighbor - that sent the LSP."; + description "Neighbor system-id of LSP sender"; } description - "This notification is sent when a LSP - is received. - The notification generation must be throttled with at least - a 5 second gap. "; + "This notification is sent when an LSP is received. + The notification generation must be throttled with at + least 5 seconds betweeen successive notifications."; } notification lsp-generation { uses notification-instance-hdr; leaf lsp-id { type lsp-id; - description - "LSP ID."; + description "LSP ID"; } leaf sequence { type uint32; - description - "Sequence number of the received LSP."; + description "Sequence number of the received LSP."; } leaf send-timestamp { type yang:timestamp; - description - "This leaf describes the timestamp - when our LSP was regenerated. "; + description "Timestamp when our LSP was regenerated."; } description - "This notification is sent when a LSP - is regenerated. - The notification generation must be throttled with at least - a 5 second gap. "; + "This notification is sent when an LSP is regenerated. + The notification generation must be throttled with at + least 5 seconds betweeen successive notifications."; } } - 7. Security Considerations Configuration and state data defined in this document are designed to be accessed via the NETCONF protocol [RFC6241]. As IS-IS is an IGP protocol (critical piece of the network), ensuring stability and security of the protocol is mandatory for the network service. @@ -5123,37 +4743,37 @@ Lhotka, L. and A. Lindem, "A YANG Data Model for Routing Management", draft-ietf-netmod-routing-cfg-25 (work in progress), November 2016. [I-D.ietf-rtgwg-yang-key-chain] Lindem, A., Qu, Y., Yeung, D., Chen, I., and Z. Zhang, "Routing Key Chain YANG Data Model", draft-ietf-rtgwg- yang-key-chain-24 (work in progress), April 2017. [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate - Requirement Levels", BCP 14, RFC 2119, DOI 10.17487/ - RFC2119, March 1997, . + Requirement Levels", BCP 14, RFC 2119, + DOI 10.17487/RFC2119, March 1997, . [RFC3688] Mealling, M., "The IETF XML Registry", BCP 81, RFC 3688, DOI 10.17487/RFC3688, January 2004, . [RFC5120] Przygienda, T., Shen, N., and N. Sheth, "M-ISIS: Multi Topology (MT) Routing in Intermediate System to - Intermediate Systems (IS-ISs)", RFC 5120, DOI 10.17487/ - RFC5120, February 2008, . + Intermediate Systems (IS-ISs)", RFC 5120, + DOI 10.17487/RFC5120, February 2008, . [RFC5286] Atlas, A., Ed. and A. Zinin, Ed., "Basic Specification for - IP Fast Reroute: Loop-Free Alternates", RFC 5286, DOI - 10.17487/RFC5286, September 2008, . [RFC5443] Jork, M., Atlas, A., and L. Fang, "LDP IGP Synchronization", RFC 5443, DOI 10.17487/RFC5443, March 2009, . [RFC6020] Bjorklund, M., Ed., "YANG - A Data Modeling Language for the Network Configuration Protocol (NETCONF)", RFC 6020, DOI 10.17487/RFC6020, October 2010, . @@ -5161,22 +4781,22 @@ [RFC6241] Enns, R., Ed., Bjorklund, M., Ed., Schoenwaelder, J., Ed., and A. Bierman, Ed., "Network Configuration Protocol (NETCONF)", RFC 6241, DOI 10.17487/RFC6241, June 2011, . [RFC6242] Wasserman, M., "Using the NETCONF Protocol over Secure Shell (SSH)", RFC 6242, DOI 10.17487/RFC6242, June 2011, . [RFC6536] Bierman, A. and M. Bjorklund, "Network Configuration - Protocol (NETCONF) Access Control Model", RFC 6536, DOI - 10.17487/RFC6536, March 2012, . [RFC7490] Bryant, S., Filsfils, C., Previdi, S., Shand, M., and N. So, "Remote Loop-Free Alternate (LFA) Fast Reroute (FRR)", RFC 7490, DOI 10.17487/RFC7490, April 2015, . Appendix A. Example of IS-IS configuration in XML This section gives an example of configuration of an IS-IS instance @@ -5228,24 +4848,26 @@ Loopback0 200 0 true Eth1 level-2 - point-to-point + point-to-point + 167890 + Loopback0