Internet DRAFT - draft-chin-netmod-iana-af-numbers

draft-chin-netmod-iana-af-numbers



Internet Engineering Task Force                               C. Chen
Internet Draft                                               Ericsson
Intended status: Standards Track                          May 22, 2017
Expires: November 2017



                  IANA Address Family Numbers Yang Model


                 draft-chin-netmod-iana-af-numbers-00.txt




Abstract

   This document defines initial version of the iana-af-numbers YANG
model.

Status of this Memo

   This Internet-Draft is submitted in full conformance with the
   provisions of BCP 78 and BCP 79.

   Internet-Drafts are working documents of the Internet Engineering
   Task Force (IETF), its areas, and its working groups.  Note that
   other groups may also distribute working documents as Internet-
   Drafts.

   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."

   The list of current Internet-Drafts can be accessed at
   http://www.ietf.org/ietf/1id-abstracts.txt

   The list of Internet-Draft Shadow Directories can be accessed at
   http://www.ietf.org/shadow.html

   This Internet-Draft will expire on November 22, 2017.

Copyright Notice

   Copyright (c) 2017 IETF Trust and the persons identified as the
   document authors. All rights reserved.




Chen                  Expires November 22, 2017               [Page 1]

Internet-Draft IANA Address Family Numbers Yang Model         May 2017


   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
   carefully, as they describe your rights and restrictions with respect
   to this document. Code Components extracted from this document must
   include Simplified BSD License text as described in Section 4.e of
   the Trust Legal Provisions and are provided without warranty as
   described in the Simplified BSD License.



Table of Contents


   1. Introduction ................................................ 2
   2. IANA Address Family Numbers YANG Module ...................... 2
   3. IANA Considerations ........................................ 10
   4. Security Considerations                                  ..................................... 12
   5. Normative References........................................ 12

1. Introduction

      This document defines the initial version of the iana-af-numbers
   YANG module for address family numbers definitions.

      The iana-af-numbers module reflects IANA's existing "address
   family numbers definitions" registry [Address Family Numbers].  The
   latest revision of the module can be obtained from the IANA web site.

      New values should be made to IANA and added to the "address family
   numbers definitions" registry, the IANA-ADDRESS-FAMILY-NUMBERS-MIB
   and the iana-af-numbers YANG module are updated by IANA.

2. IANA Address Family Numbers YANG Module

   <CODE BEGINS> file "iana-af-numbers.yang"
   module iana-af-numbers {

      namespace "urn:ietf:params:xml:ns:yang:iana-af-numbers";
      prefix "ianaafn";

      organization
         "IANA";

      contact
         "Postal:    Internet Assigned Numbers Authority


Chen                  Expires November 22, 2017               [Page 2]

Internet-Draft IANA Address Family Numbers Yang Model         May 2017


          Internet Corporation for Assigned Names and Numbers
          12025 Waterfront Drive, Suite 300
          Los Angeles, CA 90094-2536
          USA

          Tel:    +1  310-301-5800
          E-Mail: iana&iana.org";

      description
         "The MIB module defines the AddressFamilyNumbers
          textual convention.";

      revision "2017-05-19" {
         description
            "Initial revision.";
         reference
            "IANA-ADDRESS-FAMILY-NUMBERS-MIB";
      }

      identity iana-af-numbers {
         description
            "The definition of this textual convention with the
             addition of newly assigned values is published
             periodically by the IANA, in either the Assigned
             Numbers RFC, or some derivative of it specific to
             Internet Network Management number assignments.
             (The latest arrangements can be obtained by
             contacting the IANA.)

             Requests for new values should be made to IANA via
             email (iana&iana.org).";
      }

      identity ipV4 {
         base iana-af-numbers;
         description
            "IP Version 4";
         reference
            "";
      }

      identity ipV6 {
         base iana-af-numbers;
         description
            "IP Version 6";
         reference
            "";


Chen                  Expires November 22, 2017               [Page 3]

Internet-Draft IANA Address Family Numbers Yang Model         May 2017


      }

      identity nsap {
         base iana-af-numbers;
         description
            "NSAP";
         reference
            "";
      }

      identity hdlc {
         base iana-af-numbers;
         description
            "8-bit multidrop";
         reference
            "";
      }

      identity bbn1822 {
         base iana-af-numbers;
         description
            "";
         reference
            "";
      }

      identity all802 {
         base iana-af-numbers;
         description
            "includes all 802 media plus Ethernet
             'canonical format'";
         reference
            "";
      }

      identity e163 {
         base iana-af-numbers;
         description
            "";
         reference
            "";
      }

      identity e164 {
         base iana-af-numbers;
         description
            "SMDS, Frame Relay, ATM";


Chen                  Expires November 22, 2017               [Page 4]

Internet-Draft IANA Address Family Numbers Yang Model         May 2017


         reference
            "";
      }

      identity f69 {
         base iana-af-numbers;
         description
            "Telex";
         reference
            "";
      }

      identity x121 {
         base iana-af-numbers;
         description
            "X.25, Frame Relay";
         reference
            "";
      }

      identity ipx {
         base iana-af-numbers;
         description
            "IPX (Internet Protocol Exchange)";
         reference
            "";
      }

      identity appleTalk {
         base iana-af-numbers;
         description
            "Apple Talk";
         reference
            "";
      }

      identity decnetIV {
         base iana-af-numbers;
         description
            "DEC Net Phase IV";
         reference
            "";
      }

      identity banyanVines {
         base iana-af-numbers;
         description


Chen                  Expires November 22, 2017               [Page 5]

Internet-Draft IANA Address Family Numbers Yang Model         May 2017


            "Banyan Vines";
         reference
            "";
      }

      identity e164withNsap {
         base iana-af-numbers;
         description
            "E.164 with NSAP format subaddress";
         reference
            "";
      }

      identity dns {
         base iana-af-numbers;
         description
            "Domain Name System";
         reference
            "";
      }

      identity distinguishedName {
         base iana-af-numbers;
         description
            "Distinguished Name, per X.500";
         reference
            "";
      }

      identity asNumber {
         base iana-af-numbers;
         description
            "16-bit quantity, per the AS number space";
         reference
            "";
      }

      identity xtpOverIpv4 {
         base iana-af-numbers;
         description
            "XTP over IP version 4";
         reference
            "";
      }

      identity xtpOverIpv6 {
         base iana-af-numbers;


Chen                  Expires November 22, 2017               [Page 6]

Internet-Draft IANA Address Family Numbers Yang Model         May 2017


         description
            "XTP over IP version 6";
         reference
            "";
      }

      identity xtpNativeModeXTP {
         base iana-af-numbers;
         description
            "XTP native mode XTP";
         reference
            "";
      }

      identity fibreChannelWWPN {
         base iana-af-numbers;
         description
            "Fibre Channel World-Wide Port Name";
         reference
            "";
      }

      identity fibreChannelWWNN {
         base iana-af-numbers;
         description
            "Fibre Channel World-Wide Node Name";
         reference
            "";
      }

      identity gwid {
         base iana-af-numbers;
         description
            "Gateway Identifier";
         reference
            "";
      }

      identity afi {
         base iana-af-numbers;
         description
            "AFI for L2VPN information";
         reference
            "";
      }

      identity mplsTpSectionEndpointIdentifier {


Chen                  Expires November 22, 2017               [Page 7]

Internet-Draft IANA Address Family Numbers Yang Model         May 2017


         base iana-af-numbers;
         description
            "MPLS-TP Section Endpoint Identifier";
         reference
            "";
      }

      identity mplsTpLspEndpointIdentifier {
         base iana-af-numbers;
         description
            "MPLS-TP LSP Endpoint Identifier";
         reference
            "";
      }

      identity mplsTpPseudowireEndpointIdentifier {
         base iana-af-numbers;
         description
            "MPLS-TP Pseudowire Endpoint Identifier";
         reference
            "";
      }

      identity eigrpCommonServiceFamily {
         base iana-af-numbers;
         description
            "EIGRP Common Service Family";
         reference
            "";
      }

      identity eigrpIpv4ServiceFamily {
         base iana-af-numbers;
         description
            "EIGRP IPv4 Service Family";
         reference
            "";
      }

      identity eigrpIpv6ServiceFamily {
         base iana-af-numbers;
         description
            "EIGRP IPv6 Service Family";
         reference
            "";
      }



Chen                  Expires November 22, 2017               [Page 8]

Internet-Draft IANA Address Family Numbers Yang Model         May 2017


      identity lispCanonicalAddressFormat {
         base iana-af-numbers;
         description
            "LISP Canonical Address Format (LCAF)";
         reference
            "";
      }

      identity bgpLs {
         base iana-af-numbers;
         description
            "BGP-LS";
         reference
            "";
      }

      identity fortyeightBitMacBitMac {
         base iana-af-numbers;
         description
            "48-bit MAC";
         reference
            "";
      }

      identity sixtyfourBitMac {
         base iana-af-numbers;
         description
            "64-bit MAC";
         reference
            "";
      }

      identity oui {
         base iana-af-numbers;
         description
            "Organizationally Unique Identifier";
         reference
            "";
      }

      identity mac24 {
         base iana-af-numbers;
         description
            "MAC/24";
         reference
            "";
      }


Chen                  Expires November 22, 2017               [Page 9]

Internet-Draft IANA Address Family Numbers Yang Model         May 2017



      identity mac40 {
         base iana-af-numbers;
         description
            "MAC/40";
         reference
            "";
      }

      identity ipv664 {
         base iana-af-numbers;
         description
            "IPv6/64";
         reference
            "";
      }

      identity rBridgePortID {
         base iana-af-numbers;
         description
            "RBridge Port ID";
         reference
            "";
      }

      identity trillNickname {
         base iana-af-numbers;
         description
            "TRILL Nickname";
         reference
            "";
      }
   }
   <CODE ENDS>

3. IANA Considerations

      This document defines the initial version of the IANA-maintained
   iana-af-numbers YANG module.

      The iana-af-numbers YANG module is intended to reflect the
   "address family numbers definitions" registry [ADDRESS FAMILY
   NUMBERS-IANA-REGISTRY], exactly like the IANA address family numbers-
   MIB module [IANA-ADDRESS-FAMILY-NUMBERS-MIB] reflects the "address
   family numbers definitions" registry.




Chen                  Expires November 22, 2017              [Page 10]

Internet-Draft IANA Address Family Numbers Yang Model         May 2017


      New address family number value must not be directly added to the
   iana-af-numbers YANG module.  They must instead be added to the
   "address family numbers definitions" registry.

      When an address family number is added to the "address family
   numbers definitions" registry, a new "identity" statement must be
   added to the iana-af-numbers YANG module.  The name of the "identity"
   is the same as the corresponding enumeration in the IANA-ADDRESS-
   FAMILY-NUMBERS-MIB.  The following substatements to the "identity"
   statement should be defined:

         "base": Contains the value "iana-af-numbers".

         "status": Include only if a registration has been deprecated
         (use the value "deprecated") or obsoleted (use the value
         "obsolete").

         "description": Replicate the description from the registry, if
         any.  Insert line breaks as needed so that the line does not
         exceed 72 characters.

         "reference": Replicate the reference from the registry, if any,
         and add the title of the document.

      Unassigned or reserved values are not present in the module.

      When the iana-af-numbers YANG module is updated, a new "revision"
   statement must be added in front of the existing revision statements.

      IANA has added this new note to the "address family numbers
   definitions" registry:

         When this registry is modified, the YANG module iana-af-numbers
   must be updated.

      The "Reference" text in the "address family numbers definitions"
   registry should add this new RFC.

   3.1.  URI Registrations

      This document registers a URI in the "IETF XML" registry
   [RFC3688].

      Following the format in RFC 3688, the following registration has
   been made.

         URI: urn:ietf:params:xml:ns:yang:iana-af-numbers


Chen                  Expires November 22, 2017              [Page 11]

Internet-Draft IANA Address Family Numbers Yang Model         May 2017


         Registrant Contact: IANA.

         XML: N/A; the requested URI is an XML namespace.

   3.2.  YANG Module Registrations

      This document registers a YANG module in the "YANG Module Names"

      registry [RFC7950].

         name:         iana-af-numbers

         namespace:    urn:ietf:params:xml:ns:yang:iana-af-numbers

         prefix:       ianaafn



4. Security Considerations

   The YANG module definitions does not create any security
   implications.



5. Normative References

      [IANA-ADDRESS-FAMILY-NUMBERS-MIB]

                 Internet Assigned Numbers Authority,
             "AddressFamilyNumbers Textual Convention definitions",
             <https://www.iana.org/assignments/ianaaddressfamilynumbers-
             mib/ianaaddressfamilynumbers-mib>.

      [Address Family Numbers-IANA-REGISTRY]

                 Internet Assigned Numbers Authority, "Address Family
             Numbers Definitions",
             <https://www.iana.org/assignments/address-family-
             numbers/address-family-numbers.xhtml#address-family-
             numbers-2>.

      [RFC3688]  Mealling, M., "The IETF XML Registry", BCP 81, RFC
             3688, January 2004.

      [RFC7950]  Bjorklund, M., "The YANG 1.1 Data Modeling Language",
             RFC 7950, August 2016.


Chen                  Expires November 22, 2017              [Page 12]

Internet-Draft IANA Address Family Numbers Yang Model         May 2017




   Authors' Addresses

   Chin Chen
   Ericsson (China) Communications Company Ltd.
   Ericsson Tower, No. 5 Lize East Street,
   Chaoyang District Beijing 100102, P.R. China

   Email: chin.chen@ericsson.com






































Chen                  Expires November 22, 2017              [Page 13]