home *** CD-ROM | disk | FTP | other *** search
/ The Hacker's Encyclopedia 1998 / hackers_encyclopedia.iso / rfc / 3 / rfc2013.txt < prev    next >
Encoding:
Text File  |  2003-06-11  |  9.1 KB  |  340 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7. Network Working Group                              K. McCloghrie, Editor
  8. Request for Comments: 2013                                 Cisco Systems
  9. Updates: 1213                                              November 1996
  10. Category: Standards Track
  11.  
  12.  
  13.                    SNMPv2 Management Information Base
  14.                for the User Datagram Protocol using SMIv2
  15.  
  16. Status of this Memo
  17.  
  18.    This document specifies an Internet standards track protocol for the
  19.    Internet community, and requests discussion and suggestions for
  20.    improvements.  Please refer to the current edition of the "Internet
  21.    Official Protocol Standards" (STD 1) for the standardization state
  22.    and status of this protocol.  Distribution of this memo is unlimited.
  23.  
  24. IESG Note:
  25.  
  26.    The IP, UDP, and TCP MIB modules currently support only IPv4.  These
  27.    three modules use the IpAddress type defined as an OCTET STRING of
  28.    length 4 to represent the IPv4 32-bit internet addresses.  (See RFC
  29.    1902, SMI for SNMPv2.)  They do not support the new 128-bit IPv6
  30.    internet addresses.
  31.  
  32. Table of Contents
  33.  
  34.    1. Introduction .................................................   1
  35.    2. Definitions ..................................................   2
  36.    2.1 The UDP Group ...............................................   3
  37.    2.2 Conformance Information .....................................   5
  38.    2.2.1 Compliance Statements .....................................   5
  39.    2.2.2 Units of Conformance ......................................   5
  40.    3. Acknowledgements .............................................   6
  41.    4. References ...................................................   6
  42.    5. Security Considerations ......................................   6
  43.    6. Editor's Address .............................................   6
  44.  
  45. 1.  Introduction
  46.  
  47.    A management system contains: several (potentially many) nodes, each
  48.    with a processing entity, termed an agent, which has access to
  49.    management instrumentation; at least one management station; and, a
  50.    management protocol, used to convey management information between
  51.    the agents and management stations.  Operations of the protocol are
  52.    carried out under an administrative framework which defines
  53.    authentication, authorization, access control, and privacy policies.
  54.  
  55.  
  56.  
  57.  
  58. McCloghrie                  Standards Track                     [Page 1]
  59.  
  60. RFC 2013                   SNMPv2 MIB for UDP              November 1996
  61.  
  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.    This document is the MIB module which defines managed objects for
  76.    managing implementations of the User Datagram Protocol (UDP) [3].
  77.  
  78.    The managed objects in this MIB module were originally defined using
  79.    the SNMPv1 framework as a part of MIB-II [4].  This document defines
  80.    the same objects for UDP using the SNMPv2 framework.
  81.  
  82. 2.  Definitions
  83.  
  84. UDP-MIB DEFINITIONS ::= BEGIN
  85.  
  86. IMPORTS
  87.     MODULE-IDENTITY, OBJECT-TYPE, Counter32,
  88.     IpAddress, mib-2                   FROM SNMPv2-SMI
  89.     MODULE-COMPLIANCE, OBJECT-GROUP    FROM SNMPv2-CONF;
  90.  
  91.  
  92. udpMIB MODULE-IDENTITY
  93.     LAST-UPDATED "9411010000Z"
  94.     ORGANIZATION "IETF SNMPv2 Working Group"
  95.     CONTACT-INFO
  96.             "        Keith McCloghrie
  97.  
  98.              Postal: Cisco Systems, Inc.
  99.                      170 West Tasman Drive
  100.                      San Jose, CA  95134-1706
  101.                      US
  102.  
  103.              Phone:  +1 408 526 5260
  104.              Email:  kzm@cisco.com"
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114. McCloghrie                  Standards Track                     [Page 2]
  115.  
  116. RFC 2013                   SNMPv2 MIB for UDP              November 1996
  117.  
  118.  
  119.     DESCRIPTION
  120.             "The MIB module for managing UDP implementations."
  121.     REVISION      "9103310000Z"
  122.     DESCRIPTION
  123.             "The initial revision of this MIB module was part of MIB-
  124.             II."
  125.     ::= { mib-2 50 }
  126.  
  127. -- the UDP group
  128.  
  129. udp      OBJECT IDENTIFIER ::= { mib-2 7 }
  130.  
  131. udpInDatagrams OBJECT-TYPE
  132.     SYNTAX      Counter32
  133.     MAX-ACCESS  read-only
  134.     STATUS      current
  135.     DESCRIPTION
  136.             "The total number of UDP datagrams delivered to UDP users."
  137.     ::= { udp 1 }
  138.  
  139. udpNoPorts OBJECT-TYPE
  140.     SYNTAX      Counter32
  141.     MAX-ACCESS  read-only
  142.     STATUS      current
  143.     DESCRIPTION
  144.             "The total number of received UDP datagrams for which there
  145.             was no application at the destination port."
  146.     ::= { udp 2 }
  147.  
  148. udpInErrors OBJECT-TYPE
  149.     SYNTAX      Counter32
  150.     MAX-ACCESS  read-only
  151.     STATUS      current
  152.     DESCRIPTION
  153.             "The number of received UDP datagrams that could not be
  154.             delivered for reasons other than the lack of an application
  155.             at the destination port."
  156.     ::= { udp 3 }
  157.  
  158. udpOutDatagrams OBJECT-TYPE
  159.     SYNTAX      Counter32
  160.     MAX-ACCESS  read-only
  161.     STATUS      current
  162.     DESCRIPTION
  163.             "The total number of UDP datagrams sent from this entity."
  164.     ::= { udp 4 }
  165.  
  166.  
  167.  
  168.  
  169.  
  170. McCloghrie                  Standards Track                     [Page 3]
  171.  
  172. RFC 2013                   SNMPv2 MIB for UDP              November 1996
  173.  
  174.  
  175. -- the UDP Listener table
  176.  
  177. -- The UDP listener table contains information about this
  178. -- entity's UDP end-points on which a local application is
  179. -- currently accepting datagrams.
  180.  
  181. udpTable OBJECT-TYPE
  182.     SYNTAX      SEQUENCE OF UdpEntry
  183.     MAX-ACCESS  not-accessible
  184.     STATUS      current
  185.     DESCRIPTION
  186.             "A table containing UDP listener information."
  187.     ::= { udp 5 }
  188.  
  189. udpEntry OBJECT-TYPE
  190.     SYNTAX      UdpEntry
  191.     MAX-ACCESS  not-accessible
  192.     STATUS      current
  193.     DESCRIPTION
  194.             "Information about a particular current UDP listener."
  195.     INDEX   { udpLocalAddress, udpLocalPort }
  196.     ::= { udpTable 1 }
  197.  
  198. UdpEntry ::= SEQUENCE {
  199.         udpLocalAddress  IpAddress,
  200.         udpLocalPort     INTEGER
  201.     }
  202.  
  203. udpLocalAddress OBJECT-TYPE
  204.     SYNTAX      IpAddress
  205.     MAX-ACCESS  read-only
  206.     STATUS      current
  207.     DESCRIPTION
  208.             "The local IP address for this UDP listener.  In the case of
  209.             a UDP listener which is willing to accept datagrams for any
  210.             IP interface associated with the node, the value 0.0.0.0 is
  211.             used."
  212.     ::= { udpEntry 1 }
  213.  
  214. udpLocalPort OBJECT-TYPE
  215.     SYNTAX      INTEGER (0..65535)
  216.     MAX-ACCESS  read-only
  217.     STATUS      current
  218.     DESCRIPTION
  219.             "The local port number for this UDP listener."
  220.     ::= { udpEntry 2 }
  221.  
  222.  
  223.  
  224.  
  225.  
  226. McCloghrie                  Standards Track                     [Page 4]
  227.  
  228. RFC 2013                   SNMPv2 MIB for UDP              November 1996
  229.  
  230.  
  231. -- conformance information
  232.  
  233. udpMIBConformance OBJECT IDENTIFIER ::= { udpMIB 2 }
  234.  
  235. udpMIBCompliances OBJECT IDENTIFIER ::= { udpMIBConformance 1 }
  236. udpMIBGroups      OBJECT IDENTIFIER ::= { udpMIBConformance 2 }
  237.  
  238. -- compliance statements
  239.  
  240. udpMIBCompliance MODULE-COMPLIANCE
  241.     STATUS  current
  242.     DESCRIPTION
  243.             "The compliance statement for SNMPv2 entities which
  244.             implement UDP."
  245.     MODULE  -- this module
  246.         MANDATORY-GROUPS { udpGroup
  247.                            }
  248.     ::= { udpMIBCompliances 1 }
  249.  
  250. -- units of conformance
  251.  
  252. udpGroup OBJECT-GROUP
  253.     OBJECTS   { udpInDatagrams, udpNoPorts,
  254.                 udpInErrors, udpOutDatagrams,
  255.                 udpLocalAddress, udpLocalPort }
  256.     STATUS    current
  257.     DESCRIPTION
  258.             "The udp group of objects providing for management of UDP
  259.             entities."
  260.     ::= { udpMIBGroups 1 }
  261.  
  262. END
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282. McCloghrie                  Standards Track                     [Page 5]
  283.  
  284. RFC 2013                   SNMPv2 MIB for UDP              November 1996
  285.  
  286.  
  287. 3.  Acknowledgements
  288.  
  289.    This document contains a modified subset of RFC 1213.
  290.  
  291. 4.  References
  292.  
  293.    [1]  Information processing systems - Open Systems Interconnection
  294.         Specification of Abstract Syntax Notation One (ASN.1),
  295.         International Organization for Standardization.  International
  296.         Standard 8824, (December, 1987).
  297.  
  298.    [2]  McCloghrie, K., Editor, "Structure of Management Information
  299.         for version 2 of the Simple Network Management Protocol
  300.         (SNMPv2)", RFC 1902, Cisco Systems, January 1996.
  301.  
  302.    [3]  Postel, J., "User Datagram Protocol", STD 6, RFC 768, USC-ISI,
  303.         August 1980.
  304.  
  305.    [4]  McCloghrie, K., and Rose, M., "Management Information Base for
  306.         Network Management of TCP/IP-based internets: MIB-II", STD 17,
  307.         RFC 1213, March 1991.
  308.  
  309. 5.  Security Considerations
  310.  
  311.    Security issues are not discussed in this memo.
  312.  
  313. 6.  Editor's Address
  314.  
  315.    Keith McCloghrie
  316.    Cisco Systems, Inc.
  317.    170 West Tasman Drive
  318.    San Jose, CA  95134-1706
  319.    US
  320.  
  321.    Phone: +1 408 526 5260
  322.    EMail: kzm@cisco.com
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338. McCloghrie                  Standards Track                     [Page 6]
  339.  
  340.