idnits 2.17.1 draft-chin-netmod-iana-af-numbers-00.txt: Checking boilerplate required by RFC 5378 and the IETF Trust (see https://trustee.ietf.org/license-info): ---------------------------------------------------------------------------- No issues found here. Checking nits according to https://www.ietf.org/id-info/1id-guidelines.txt: ---------------------------------------------------------------------------- No issues found here. Checking nits according to https://www.ietf.org/id-info/checklist : ---------------------------------------------------------------------------- ** There is 1 instance of too long lines in the document, the longest one being 31 characters in excess of 72. Miscellaneous warnings: ---------------------------------------------------------------------------- == The copyright year in the IETF Trust and authors Copyright Line does not match the current year -- The document date (May 22, 2017) is 2530 days in the past. Is this intentional? Checking references for intended status: Proposed Standard ---------------------------------------------------------------------------- (See RFCs 3967 and 4897 for information about using normative references to lower-maturity documents in RFCs) -- Possible downref: Non-RFC (?) normative reference: ref. 'IANA-ADDRESS-FAMILY-NUMBERS-MIB' Summary: 1 error (**), 0 flaws (~~), 1 warning (==), 2 comments (--). Run idnits with the --verbose option for more detailed information about the items above. -------------------------------------------------------------------------------- 1 Internet Engineering Task Force C. Chen 2 Internet Draft Ericsson 3 Intended status: Standards Track May 22, 2017 4 Expires: November 2017 6 IANA Address Family Numbers Yang Model 8 draft-chin-netmod-iana-af-numbers-00.txt 10 Abstract 12 This document defines initial version of the iana-af-numbers YANG 13 model. 15 Status of this Memo 17 This Internet-Draft is submitted in full conformance with the 18 provisions of BCP 78 and BCP 79. 20 Internet-Drafts are working documents of the Internet Engineering 21 Task Force (IETF), its areas, and its working groups. Note that 22 other groups may also distribute working documents as Internet- 23 Drafts. 25 Internet-Drafts are draft documents valid for a maximum of six months 26 and may be updated, replaced, or obsoleted by other documents at any 27 time. It is inappropriate to use Internet-Drafts as reference 28 material or to cite them other than as "work in progress." 30 The list of current Internet-Drafts can be accessed at 31 http://www.ietf.org/ietf/1id-abstracts.txt 33 The list of Internet-Draft Shadow Directories can be accessed at 34 http://www.ietf.org/shadow.html 36 This Internet-Draft will expire on November 22, 2017. 38 Copyright Notice 40 Copyright (c) 2017 IETF Trust and the persons identified as the 41 document authors. All rights reserved. 43 This document is subject to BCP 78 and the IETF Trust's Legal 44 Provisions Relating to IETF Documents 45 (http://trustee.ietf.org/license-info) in effect on the date of 46 publication of this document. Please review these documents 47 carefully, as they describe your rights and restrictions with respect 48 to this document. Code Components extracted from this document must 49 include Simplified BSD License text as described in Section 4.e of 50 the Trust Legal Provisions and are provided without warranty as 51 described in the Simplified BSD License. 53 Table of Contents 55 1. Introduction ................................................ 2 56 2. IANA Address Family Numbers YANG Module ...................... 2 57 3. IANA Considerations ........................................ 10 58 4. Security Considerations ..................................... 12 59 5. Normative References........................................ 12 61 1. Introduction 63 This document defines the initial version of the iana-af-numbers 64 YANG module for address family numbers definitions. 66 The iana-af-numbers module reflects IANA's existing "address 67 family numbers definitions" registry [Address Family Numbers]. The 68 latest revision of the module can be obtained from the IANA web site. 70 New values should be made to IANA and added to the "address family 71 numbers definitions" registry, the IANA-ADDRESS-FAMILY-NUMBERS-MIB 72 and the iana-af-numbers YANG module are updated by IANA. 74 2. IANA Address Family Numbers YANG Module 76 file "iana-af-numbers.yang" 77 module iana-af-numbers { 79 namespace "urn:ietf:params:xml:ns:yang:iana-af-numbers"; 80 prefix "ianaafn"; 82 organization 83 "IANA"; 85 contact 86 "Postal: Internet Assigned Numbers Authority 87 Internet Corporation for Assigned Names and Numbers 88 12025 Waterfront Drive, Suite 300 89 Los Angeles, CA 90094-2536 90 USA 92 Tel: +1 310-301-5800 93 E-Mail: iana&iana.org"; 95 description 96 "The MIB module defines the AddressFamilyNumbers 97 textual convention."; 99 revision "2017-05-19" { 100 description 101 "Initial revision."; 102 reference 103 "IANA-ADDRESS-FAMILY-NUMBERS-MIB"; 104 } 106 identity iana-af-numbers { 107 description 108 "The definition of this textual convention with the 109 addition of newly assigned values is published 110 periodically by the IANA, in either the Assigned 111 Numbers RFC, or some derivative of it specific to 112 Internet Network Management number assignments. 113 (The latest arrangements can be obtained by 114 contacting the IANA.) 116 Requests for new values should be made to IANA via 117 email (iana&iana.org)."; 118 } 120 identity ipV4 { 121 base iana-af-numbers; 122 description 123 "IP Version 4"; 124 reference 125 ""; 126 } 128 identity ipV6 { 129 base iana-af-numbers; 130 description 131 "IP Version 6"; 132 reference 133 ""; 135 } 137 identity nsap { 138 base iana-af-numbers; 139 description 140 "NSAP"; 141 reference 142 ""; 143 } 145 identity hdlc { 146 base iana-af-numbers; 147 description 148 "8-bit multidrop"; 149 reference 150 ""; 151 } 153 identity bbn1822 { 154 base iana-af-numbers; 155 description 156 ""; 157 reference 158 ""; 159 } 161 identity all802 { 162 base iana-af-numbers; 163 description 164 "includes all 802 media plus Ethernet 165 'canonical format'"; 166 reference 167 ""; 168 } 170 identity e163 { 171 base iana-af-numbers; 172 description 173 ""; 174 reference 175 ""; 176 } 178 identity e164 { 179 base iana-af-numbers; 180 description 181 "SMDS, Frame Relay, ATM"; 183 reference 184 ""; 185 } 187 identity f69 { 188 base iana-af-numbers; 189 description 190 "Telex"; 191 reference 192 ""; 193 } 195 identity x121 { 196 base iana-af-numbers; 197 description 198 "X.25, Frame Relay"; 199 reference 200 ""; 201 } 203 identity ipx { 204 base iana-af-numbers; 205 description 206 "IPX (Internet Protocol Exchange)"; 207 reference 208 ""; 209 } 211 identity appleTalk { 212 base iana-af-numbers; 213 description 214 "Apple Talk"; 215 reference 216 ""; 217 } 219 identity decnetIV { 220 base iana-af-numbers; 221 description 222 "DEC Net Phase IV"; 223 reference 224 ""; 225 } 227 identity banyanVines { 228 base iana-af-numbers; 229 description 230 "Banyan Vines"; 231 reference 232 ""; 233 } 235 identity e164withNsap { 236 base iana-af-numbers; 237 description 238 "E.164 with NSAP format subaddress"; 239 reference 240 ""; 241 } 243 identity dns { 244 base iana-af-numbers; 245 description 246 "Domain Name System"; 247 reference 248 ""; 249 } 251 identity distinguishedName { 252 base iana-af-numbers; 253 description 254 "Distinguished Name, per X.500"; 255 reference 256 ""; 257 } 259 identity asNumber { 260 base iana-af-numbers; 261 description 262 "16-bit quantity, per the AS number space"; 263 reference 264 ""; 265 } 267 identity xtpOverIpv4 { 268 base iana-af-numbers; 269 description 270 "XTP over IP version 4"; 271 reference 272 ""; 273 } 275 identity xtpOverIpv6 { 276 base iana-af-numbers; 277 description 278 "XTP over IP version 6"; 279 reference 280 ""; 281 } 283 identity xtpNativeModeXTP { 284 base iana-af-numbers; 285 description 286 "XTP native mode XTP"; 287 reference 288 ""; 289 } 291 identity fibreChannelWWPN { 292 base iana-af-numbers; 293 description 294 "Fibre Channel World-Wide Port Name"; 295 reference 296 ""; 297 } 299 identity fibreChannelWWNN { 300 base iana-af-numbers; 301 description 302 "Fibre Channel World-Wide Node Name"; 303 reference 304 ""; 305 } 307 identity gwid { 308 base iana-af-numbers; 309 description 310 "Gateway Identifier"; 311 reference 312 ""; 313 } 315 identity afi { 316 base iana-af-numbers; 317 description 318 "AFI for L2VPN information"; 319 reference 320 ""; 321 } 323 identity mplsTpSectionEndpointIdentifier { 324 base iana-af-numbers; 325 description 326 "MPLS-TP Section Endpoint Identifier"; 327 reference 328 ""; 329 } 331 identity mplsTpLspEndpointIdentifier { 332 base iana-af-numbers; 333 description 334 "MPLS-TP LSP Endpoint Identifier"; 335 reference 336 ""; 337 } 339 identity mplsTpPseudowireEndpointIdentifier { 340 base iana-af-numbers; 341 description 342 "MPLS-TP Pseudowire Endpoint Identifier"; 343 reference 344 ""; 345 } 347 identity eigrpCommonServiceFamily { 348 base iana-af-numbers; 349 description 350 "EIGRP Common Service Family"; 351 reference 352 ""; 353 } 355 identity eigrpIpv4ServiceFamily { 356 base iana-af-numbers; 357 description 358 "EIGRP IPv4 Service Family"; 359 reference 360 ""; 361 } 363 identity eigrpIpv6ServiceFamily { 364 base iana-af-numbers; 365 description 366 "EIGRP IPv6 Service Family"; 367 reference 368 ""; 369 } 370 identity lispCanonicalAddressFormat { 371 base iana-af-numbers; 372 description 373 "LISP Canonical Address Format (LCAF)"; 374 reference 375 ""; 376 } 378 identity bgpLs { 379 base iana-af-numbers; 380 description 381 "BGP-LS"; 382 reference 383 ""; 384 } 386 identity fortyeightBitMacBitMac { 387 base iana-af-numbers; 388 description 389 "48-bit MAC"; 390 reference 391 ""; 392 } 394 identity sixtyfourBitMac { 395 base iana-af-numbers; 396 description 397 "64-bit MAC"; 398 reference 399 ""; 400 } 402 identity oui { 403 base iana-af-numbers; 404 description 405 "Organizationally Unique Identifier"; 406 reference 407 ""; 408 } 410 identity mac24 { 411 base iana-af-numbers; 412 description 413 "MAC/24"; 414 reference 415 ""; 416 } 417 identity mac40 { 418 base iana-af-numbers; 419 description 420 "MAC/40"; 421 reference 422 ""; 423 } 425 identity ipv664 { 426 base iana-af-numbers; 427 description 428 "IPv6/64"; 429 reference 430 ""; 431 } 433 identity rBridgePortID { 434 base iana-af-numbers; 435 description 436 "RBridge Port ID"; 437 reference 438 ""; 439 } 441 identity trillNickname { 442 base iana-af-numbers; 443 description 444 "TRILL Nickname"; 445 reference 446 ""; 447 } 448 } 449 451 3. IANA Considerations 453 This document defines the initial version of the IANA-maintained 454 iana-af-numbers YANG module. 456 The iana-af-numbers YANG module is intended to reflect the 457 "address family numbers definitions" registry [ADDRESS FAMILY 458 NUMBERS-IANA-REGISTRY], exactly like the IANA address family numbers- 459 MIB module [IANA-ADDRESS-FAMILY-NUMBERS-MIB] reflects the "address 460 family numbers definitions" registry. 462 New address family number value must not be directly added to the 463 iana-af-numbers YANG module. They must instead be added to the 464 "address family numbers definitions" registry. 466 When an address family number is added to the "address family 467 numbers definitions" registry, a new "identity" statement must be 468 added to the iana-af-numbers YANG module. The name of the "identity" 469 is the same as the corresponding enumeration in the IANA-ADDRESS- 470 FAMILY-NUMBERS-MIB. The following substatements to the "identity" 471 statement should be defined: 473 "base": Contains the value "iana-af-numbers". 475 "status": Include only if a registration has been deprecated 476 (use the value "deprecated") or obsoleted (use the value 477 "obsolete"). 479 "description": Replicate the description from the registry, if 480 any. Insert line breaks as needed so that the line does not 481 exceed 72 characters. 483 "reference": Replicate the reference from the registry, if any, 484 and add the title of the document. 486 Unassigned or reserved values are not present in the module. 488 When the iana-af-numbers YANG module is updated, a new "revision" 489 statement must be added in front of the existing revision statements. 491 IANA has added this new note to the "address family numbers 492 definitions" registry: 494 When this registry is modified, the YANG module iana-af-numbers 495 must be updated. 497 The "Reference" text in the "address family numbers definitions" 498 registry should add this new RFC. 500 3.1. URI Registrations 502 This document registers a URI in the "IETF XML" registry 503 [RFC3688]. 505 Following the format in RFC 3688, the following registration has 506 been made. 508 URI: urn:ietf:params:xml:ns:yang:iana-af-numbers 509 Registrant Contact: IANA. 511 XML: N/A; the requested URI is an XML namespace. 513 3.2. YANG Module Registrations 515 This document registers a YANG module in the "YANG Module Names" 517 registry [RFC7950]. 519 name: iana-af-numbers 521 namespace: urn:ietf:params:xml:ns:yang:iana-af-numbers 523 prefix: ianaafn 525 4. Security Considerations 527 The YANG module definitions does not create any security 528 implications. 530 5. Normative References 532 [IANA-ADDRESS-FAMILY-NUMBERS-MIB] 534 Internet Assigned Numbers Authority, 535 "AddressFamilyNumbers Textual Convention definitions", 536 . 539 [Address Family Numbers-IANA-REGISTRY] 541 Internet Assigned Numbers Authority, "Address Family 542 Numbers Definitions", 543 . 547 [RFC3688] Mealling, M., "The IETF XML Registry", BCP 81, RFC 548 3688, January 2004. 550 [RFC7950] Bjorklund, M., "The YANG 1.1 Data Modeling Language", 551 RFC 7950, August 2016. 553 Authors' Addresses 555 Chin Chen 556 Ericsson (China) Communications Company Ltd. 557 Ericsson Tower, No. 5 Lize East Street, 558 Chaoyang District Beijing 100102, P.R. China 560 Email: chin.chen@ericsson.com