home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1997 December / Internet_Info_CD-ROM_Walnut_Creek_December_1997.iso / drafts / draft_ietf_i / draft-ietf-ipngwg-ipv6-udp-mib-00.txt < prev    next >
Text File  |  1997-06-10  |  12KB  |  344 lines
  1.  
  2.  
  3. Internet-Draft          UDP MIB for IPv6           June 1997
  4. Expires December 1997
  5.  
  6.  
  7.         IP Version 6 Management Information Base 
  8.                  for the User Datagram Protocol 
  9.  
  10.                  <draft-ietf-ipngwg-ipv6-udp-mib-00.txt>
  11.  
  12.                  Mike Daniele
  13.                  Digital Equipment Corporation
  14.  
  15.  
  16. Status of this Memo
  17.  
  18.    This document is an Internet-Draft.  Internet-Drafts are working
  19.    documents of the Internet Engineering Task Force (IETF), its
  20.    areas, and its working groups.  Note that other groups may also
  21.    distribute working documents as Internet-Drafts.
  22.  
  23.    Internet-Drafts are draft documents valid for a maximum of six
  24.    months and may be updated, replaced, or obsoleted by other
  25.    documents at any time.  It is inappropriate to use Internet-
  26.    Drafts as reference material or to cite them other than as
  27.    "work in progress."
  28.  
  29.    To view the entire list of current Internet-Drafts, please check
  30.    the "1id-abstracts.txt" listing contained in the Internet-Drafts
  31.    Shadow Directories on ftp.is.co.za (Africa), ftp.nordu.net
  32.    (Europe), munnari.oz.au (Pacific Rim), ds.internic.net (US East
  33.    Coast), or ftp.isi.edu (US West Coast).
  34.  
  35. Abstract
  36.  
  37.    This document is one in the series of documents that define
  38.    various MIB objects for IPv6.  Specifically, this document
  39.    is the MIB module which defines managed objects for 
  40.    implementations of the User Datagram Protocol (UDP) 
  41.    over IP Version 6 (IPv6).
  42.  
  43.    This document also recommends a specific policy with respect to
  44.    the applicability of RFC 2013 for implementations of IPv6.
  45.    Namely, the most of managed objects defined in RFC 2013 are 
  46.    independent of which IP versions underly UDP, and only the 
  47.    UDP listener information is IP version-specific.  
  48.  
  49.    This memo defines an experimental portion of the Management
  50.    Information Base (MIB) for use with network management
  51.    protocols in the IPv6-based internets.
  52.  
  53. 1.  Introduction
  54.  
  55.    A management system contains: several (potentially many) nodes, each
  56.    with a processing entity, termed an agent, which has access to
  57.    management instrumentation; at least one management station; and, a
  58.    management protocol, used to convey management information between
  59.    the agents and management stations.  Operations of the protocol are
  60.    carried out under an administrative framework which defines
  61.    authentication, authorization, access control, and privacy policies.
  62.  
  63.    Management stations execute management applications which monitor and
  64.    control managed elements.  Managed elements are devices such as
  65.    hosts, routers, terminal servers, etc., which are monitored and
  66.    controlled via access to their management information.
  67.  
  68.    Management information is viewed as a collection of managed objects,
  69.    residing in a virtual information store, termed the Management
  70.    Information Base (MIB).  Collections of related objects are defined
  71.    in MIB modules.  These modules are written using a subset of OSI's
  72.    Abstract Syntax Notation One (ASN.1) [1], termed the Structure of
  73.    Management Information (SMI) [2].
  74.  
  75. 2.  Overview
  76.  
  77.    This document is one in the series of documents that define various
  78.    MIB objects, and statements of conformance, for IPv6.  This document 
  79.    defines the required instrumentation for implementations of UDP over
  80.    IPv6.
  81.  
  82. 3.  Transparency of IP versions to UDP
  83.  
  84.    The fact that UDP is carried over IPv6 as opposed to IPv4,
  85.    is largely invisible to a UDP implementation.  A "UDPng" did 
  86.    not need to be defined, implementations simply need to support 
  87.    IPv6 addresses.
  88.  
  89.    As such, the managed objects already defined in [UDP MIB] are 
  90.    sufficient for managing UDP in the presence of IPv6.  These objects
  91.    are equally applicable whether the managed node supports IPv4 only,
  92.    IPv6 only, or both IPv4 and IPv6.
  93.  
  94.    For example, udpInDatagrams counts "The total number of UDP datagrams 
  95.    delivered to UDP users", regardless of which version of IP is used 
  96.    to deliver any of those datagrams.
  97.  
  98.    Stated differently, UDP implementations don't need separate counters
  99.    for IPv4 and for IPv6.
  100.  
  101. 4.  Representing UDP Listeners 
  102.  
  103.    The exception to the statements in section 3 is the udpTable.
  104.    Since IPv6 addresses cannot be represented with the IpAddress syntax,
  105.    not all UDP endpoints can be represented in the udpTable
  106.    defined in [UDP MIB].
  107.  
  108.    This memo defines a new, separate table to represent only those
  109.    UDP endpoints that utilize an IPv6 address.  UDP endpoints on 
  110.    IPv4 addresses continue to be represented in udpTable [UDP MIB].
  111.  
  112.    A different approach would have been to define a new table to
  113.    represent all UDP endpoints regardless of IP version.  This would
  114.    require changes to [UDP MIB] and hence to existing (IPv4-only)
  115.    UDP implementations.  The approach suggested in this memo has the 
  116.    advantage of leaving [UDP MIB] intact.
  117.  
  118. 5.  Conformance
  119.  
  120.    This memo contains conformance statements to define conformance
  121.    to this MIB for UDP over IPv6 implementations.  Conformance is
  122.    defined in terms of both the new UDP table defined here, and the 
  123.    objects defined in [UDP MIB].
  124.  
  125. 6.  Definitions
  126.  
  127.         IPV6-UDP-MIB DEFINITIONS ::= BEGIN
  128.  
  129.         IMPORTS
  130.              MODULE-IDENTITY, OBJECT-TYPE,
  131.              MODULE-COMPLIANCE, OBJECT-GROUP    FROM SNMPv2-CONF
  132.              Unsigned32, Gauge32, Counter32,
  133.              Integer32                          FROM SNMPv2-SMI
  134.              Ipv6, Ipv6Address,
  135.          Ipv6IfIndex, Ipv6IfIndexOrZero     FROM IPV6-TC
  136.          udpInDatagrams, udpNoPorts,
  137.          udpInErrors, udpOutDatagrams    FROM UDP-MIB;
  138.  
  139.         ipv6UdpMIB MODULE-IDENTITY
  140.              LAST-UPDATED "9706090000Z"
  141.              ORGANIZATION "IETF IPv6 MIB Working Group"
  142.              CONTACT-INFO
  143.                "    Mike Daniele
  144.  
  145.                 Postal: Digital Equipment Corporation
  146.             110 Spitbrook Rd
  147.                 Nashua, NH 03062.
  148.                         US
  149.  
  150.                 Phone:  +1 603 881 1423 
  151.                 Email:  daniele@zk3.dec.com"
  152.          DESCRIPTION
  153.                "The MIB module for entities implementing UDP
  154.                 over IPv6."
  155.              ::= { ipv6  3}
  156.  
  157.  
  158.           -- objects specific to UDP for IPv6 
  159.  
  160.           ipv6UdpMIBObjects OBJECT IDENTIFIER ::= { ipv6UdpMIB 1 }
  161.  
  162.  
  163.           -- the UDP over IPv6 Listener table 
  164.  
  165.           -- This table contains information about this entity's 
  166.       -- UDP/IPv6 endpoints.  Only endpoints utilizing IPv6 addresses 
  167.       -- are contained in this table.  This entity's UDP/IPv4 endpoints 
  168.       -- are contained in udpTable.
  169.  
  170.           ipv6UdpTable OBJECT-TYPE
  171.              SYNTAX      SEQUENCE OF Ipv6UdpEntry
  172.              MAX-ACCESS  not-accessible
  173.              STATUS      current
  174.              DESCRIPTION
  175.             "A table containing UDP listener information for
  176.          UDP/IPv6 endpoints."
  177.              ::= { ipv6UdpMIBObjects 1 } -- eventually to be { udp 6 }?
  178.  
  179.           ipv6UdpEntry OBJECT-TYPE
  180.              SYNTAX      Ipv6UdpEntry
  181.              MAX-ACCESS  not-accessible
  182.              STATUS      current
  183.              DESCRIPTION
  184.               "Information about a particular current UDP listener.
  185.  
  186.            Note that conceptual rows in this table require an 
  187.            additional index object compared to udpTable, since 
  188.            IPv6 addresses are not guaranteed to be unique on the 
  189.            managed node."
  190.              INDEX   { ipv6UdpLocalAddress,
  191.                        ipv6UdpLocalPort,
  192.                ipv6UdpIfIndex }
  193.              ::= { ipv6UdpTable 1 }
  194.  
  195.           Ipv6UdpEntry ::=
  196.              SEQUENCE {
  197.                  ipv6UdpLocalAddress    Ipv6Address,
  198.                  ipv6UdpLocalPort       INTEGER (0..65535),
  199.          ipv6UdpIfIndex            Ipv6IfIndexOrZero
  200.               }
  201.  
  202.           ipv6UdpLocalAddress OBJECT-TYPE
  203.              SYNTAX     Ipv6Address
  204.              MAX-ACCESS read-only 
  205.              STATUS     current
  206.              DESCRIPTION
  207.               "The local IPv6 address for this UDP listener.
  208.                In the case of a UDP listener which is willing
  209.                to accept datagrams for any IPv6 address
  210.                associated with the managed node, the value ::0
  211.                is used."
  212.              ::= { ipv6UdpEntry 1 }
  213.  
  214.           ipv6UdpLocalPort OBJECT-TYPE
  215.              SYNTAX  INTEGER (0..65535)
  216.              MAX-ACCESS not-accessible
  217.              STATUS     current
  218.              DESCRIPTION
  219.               "The local port number for this UDP listener."
  220.              ::= { ipv6UdpEntry 2 }
  221.  
  222.       ipv6UdpIfIndex OBJECT-TYPE
  223.              SYNTAX     Ipv6IfIndexOrZero
  224.              MAX-ACCESS read-only 
  225.              STATUS     current
  226.              DESCRIPTION
  227.           "An index object used to disambiguate conceptual rows in
  228.            the table, since the ipv6UdpLocalAddress/ipv6UdpLocalPort 
  229.            pair may not be unique.
  230.  
  231.            This object identifies the local interface that is 
  232.            associated with ipv6UdpLocalAddress for this UDP listener.
  233.            If such a local interface cannot be determined, this object 
  234.            should take on the value 0.  (A possible example of this 
  235.            would be if the value of ipv6UdpLocalAddress is ::0.)
  236.  
  237.            The interface identified by a particular non-0 value of 
  238.            this index is the same interface as identified by the same 
  239.            value of ipv6IfIndex.
  240.  
  241.            The value of this object must remain constant during 
  242.            the life of this UDP endpoint."
  243.              ::= { ipv6UdpEntry 3 }
  244.  
  245.     --
  246.         -- conformance information
  247.     --
  248.  
  249.         ipv6UdpConformance OBJECT IDENTIFIER ::= { ipv6UdpMIB 2 }
  250.  
  251.         ipv6UdpCompliances OBJECT IDENTIFIER ::= { ipv6UdpConformance 1 }
  252.         ipv6UdpGroups      OBJECT IDENTIFIER ::= { ipv6UdpConformance 2 }
  253.  
  254.         -- compliance statements
  255.  
  256.         ipv6UdpCompliance MODULE-COMPLIANCE
  257.             STATUS  current
  258.             DESCRIPTION
  259.               "The compliance statement for SNMPv2 entities which
  260.               implement UDP over IPv6."
  261.             MODULE  -- this module
  262.                 MANDATORY-GROUPS { ipv6UdpGroup }
  263.             ::= { ipv6UdpCompliances 1 }
  264.  
  265.         ipv6UdpGroup OBJECT-GROUP
  266.             OBJECTS   { -- these are defined in UDP-MIB
  267.             udpInDatagrams,
  268.             udpNoPorts,
  269.             udpInErrors,
  270.             udpOutDatagrams,
  271.  
  272.             -- these are defined in this module
  273.                         ipv6UdpLocalAddress,
  274.             ipv6UdpLocalPort,
  275.             ipv6UdpIfIndex
  276.                       }
  277.             STATUS    current
  278.             DESCRIPTION
  279.                  "The group of objects providing management of 
  280.                   UDP over IPv6."
  281.             ::= { ipv6UdpGroups 1 }
  282.  
  283.          END
  284.  
  285. 7.  Acknowledgments
  286.  
  287.    This memo is a product of the IPng work group, and benefited especially
  288.    from the contributions of the following working group members:
  289.  
  290.         Dimitry Haskin          Bay Networks
  291.         Margaret Forsythe       Epilogue
  292.         Tim Hartrick            Mentat
  293.         Frank Solensky          FTP
  294.     Jack Mccann        DEC
  295.     
  296. 8.  References
  297.  
  298.    [1]  Information processing systems - Open Systems Interconnection -
  299.         Specification of Abstract Syntax Notation One (ASN.1),
  300.         International Organization for Standardization.  International
  301.         Standard 8824, (December, 1987).
  302.  
  303.    [2]  McCloghrie, K., Editor, "Structure of Management Information
  304.         for version 2 of the Simple Network Management Protocol
  305.         (SNMPv2)", RFC 1902, Cisco Systems, January 1996.
  306.  
  307.    [UDP MIB] 
  308.  
  309.        SNMPv2 Working Group, McCloghrie, K., Editor,
  310.        "SNMPv2 Management Information Base for the User  
  311.        Datagram Protocol using SMIv2", RFC 2013, November 1996.
  312.  
  313.    [IPV6 MIB TC]
  314.  
  315.        Haskin, D.,  and S. Onishi, "Management Information  Base
  316.        for IP Version 6: Textual Conventions and General Group",
  317.        Work in progress.
  318.  
  319.    [IPV6]
  320.  
  321.        Deering, S., and R. Hinden, "Internet Protocol, Version 6
  322.        (IPv6) Specification", RFC 1883, December 1995.
  323.  
  324. 9.  Security Considerations
  325.  
  326.    Certain management information defined  in  this  MIB  may  be
  327.    considered sensitive in some network environments.
  328.  
  329.    Therefore,  authentication  of  received  SNMP  requests   and
  330.    controlled access to management information should be employed
  331.    in such environments.
  332.  
  333. 10. Author's Address
  334.  
  335.       Mike Daniele
  336.       Digital Equipment Corporation
  337.       110 Spit Brook Rd
  338.       Nashua, NH 03062
  339.  
  340.       Phone: +1-603-881-1423
  341.       EMail: daniele@zk3.dec.com
  342.  
  343. Expires December, 1997
  344.