SNMP-FRAMEWORK-MIB
上传用户:aonuowh
上传日期:2021-05-23
资源大小:35390k
文件大小:21k
源码类别:

SNMP编程

开发平台:

C/C++

  1.    SNMP-FRAMEWORK-MIB DEFINITIONS ::= BEGIN
  2.    IMPORTS
  3.        MODULE-IDENTITY, OBJECT-TYPE,
  4.        OBJECT-IDENTITY,
  5.        snmpModules                           FROM SNMPv2-SMI
  6.        TEXTUAL-CONVENTION                    FROM SNMPv2-TC
  7.        MODULE-COMPLIANCE, OBJECT-GROUP       FROM SNMPv2-CONF;
  8.    snmpFrameworkMIB MODULE-IDENTITY
  9.        LAST-UPDATED "9901190000Z"            -- 19 January 1999
  10.        ORGANIZATION "SNMPv3 Working Group"
  11.        CONTACT-INFO "WG-EMail:   snmpv3@tis.com
  12.                      Subscribe:  majordomo@tis.com
  13.                                  In message body:  subscribe snmpv3
  14.                      Chair:      Russ Mundy
  15.                                  TIS Labs at Network Associates
  16.                      postal:     3060 Washington Rd
  17.                                  Glenwood MD 21738
  18.                                  USA
  19.                      EMail:      mundy@tis.com
  20.                      phone:      +1 301-854-6889
  21.                      Co-editor   Dave Harrington
  22.                                  Cabletron Systems, Inc.
  23.                      postal:     Post Office Box 5005
  24.                                  Mail Stop: Durham
  25.                                  35 Industrial Way
  26.                                  Rochester, NH 03867-5005
  27.                                  USA
  28.                      EMail:      dbh@ctron.com
  29.                      phone:      +1 603-337-7357
  30.                      Co-editor   Randy Presuhn
  31.                                  BMC Software, Inc.
  32.                      postal:     965 Stewart Drive
  33.                                  Sunnyvale, CA 94086
  34.                                  USA
  35.                      EMail:      randy_presuhn@bmc.com
  36.                      phone:      +1 408-616-3100
  37.                      Co-editor:  Bert Wijnen
  38.                                  IBM T.J. Watson Research
  39.                      postal:     Schagen 33
  40.                                  3461 GL Linschoten
  41.                                  Netherlands
  42.                      EMail:      wijnen@vnet.ibm.com
  43.                      phone:      +31 348-432-794
  44.                     "
  45.        DESCRIPTION  "The SNMP Management Architecture MIB"
  46.    -- Revision History
  47.        REVISION     "9901190000Z"            -- 19 January 1999
  48.        DESCRIPTION  "Updated editors' addresses, fixed typos.
  49.                      Published as RFC2571.
  50.                     "
  51.        REVISION     "9711200000Z"            -- 20 November 1997
  52.        DESCRIPTION  "The initial version, published in RFC 2271.
  53.                     "
  54.        ::= { snmpModules 10 }
  55.    -- Textual Conventions used in the SNMP Management Architecture ***
  56.    SnmpEngineID ::= TEXTUAL-CONVENTION
  57.        STATUS       current
  58.        DESCRIPTION "An SNMP engine's administratively-unique identifier.
  59.                     Objects of this type are for identification, not for
  60.                     addressing, even though it is possible that an
  61.                     address may have been used in the generation of
  62.                     a specific value.
  63.                     The value for this object may not be all zeros or
  64.                     all 'ff'H or the empty (zero length) string.
  65.                     The initial value for this object may be configured
  66.                     via an operator console entry or via an algorithmic
  67.                     function.  In the latter case, the following
  68.                     example algorithm is recommended.
  69.                     In cases where there are multiple engines on the
  70.                     same system, the use of this algorithm is NOT
  71.                     appropriate, as it would result in all of those
  72.                     engines ending up with the same ID value.
  73.                     1) The very first bit is used to indicate how the
  74.                        rest of the data is composed.
  75.                        0 - as defined by enterprise using former methods
  76.                            that existed before SNMPv3. See item 2 below.
  77.                        1 - as defined by this architecture, see item 3
  78.                            below.
  79.                        Note that this allows existing uses of the
  80.                        engineID (also known as AgentID [RFC1910]) to
  81.                        co-exist with any new uses.
  82.                     2) The snmpEngineID has a length of 12 octets.
  83.                        The first four octets are set to the binary
  84.                        equivalent of the agent's SNMP management
  85.                        private enterprise number as assigned by the
  86.                        Internet Assigned Numbers Authority (IANA).
  87.                        For example, if Acme Networks has been assigned
  88.                        { enterprises 696 }, the first four octets would
  89.                        be assigned '000002b8'H.
  90.                        The remaining eight octets are determined via
  91.                        one or more enterprise-specific methods. Such
  92.                        methods must be designed so as to maximize the
  93.                        possibility that the value of this object will
  94.                        be unique in the agent's administrative domain.
  95.                        For example, it may be the IP address of the SNMP
  96.                        entity, or the MAC address of one of the
  97.                        interfaces, with each address suitably padded
  98.                        with random octets.  If multiple methods are
  99.                        defined, then it is recommended that the first
  100.                        octet indicate the method being used and the
  101.                        remaining octets be a function of the method.
  102.                     3) The length of the octet strings varies.
  103.                        The first four octets are set to the binary
  104.                        equivalent of the agent's SNMP management
  105.                        private enterprise number as assigned by the
  106.                        Internet Assigned Numbers Authority (IANA).
  107.                        For example, if Acme Networks has been assigned
  108.                        { enterprises 696 }, the first four octets would
  109.                        be assigned '000002b8'H.
  110.                        The very first bit is set to 1. For example, the
  111.                        above value for Acme Networks now changes to be
  112.                        '800002b8'H.
  113.                        The fifth octet indicates how the rest (6th and
  114.                        following octets) are formatted. The values for
  115.                        the fifth octet are:
  116.                          0     - reserved, unused.
  117.                          1     - IPv4 address (4 octets)
  118.                                  lowest non-special IP address
  119.                          2     - IPv6 address (16 octets)
  120.                                  lowest non-special IP address
  121.                          3     - MAC address (6 octets)
  122.                                  lowest IEEE MAC address, canonical
  123.                                  order
  124.                          4     - Text, administratively assigned
  125.                                  Maximum remaining length 27
  126.                          5     - Octets, administratively assigned
  127.                                  Maximum remaining length 27
  128.                          6-127 - reserved, unused
  129.                        127-255 - as defined by the enterprise
  130.                                  Maximum remaining length 27
  131.                    "
  132.        SYNTAX       OCTET STRING (SIZE(5..32))
  133.    SnmpSecurityModel ::= TEXTUAL-CONVENTION
  134.        STATUS       current
  135.        DESCRIPTION "An identifier that uniquely identifies a
  136.                     securityModel of the Security Subsystem within the
  137.                     SNMP Management Architecture.
  138.                     The values for securityModel are allocated as
  139.                     follows:
  140.                     - The zero value is reserved.
  141.                     - Values between 1 and 255, inclusive, are reserved
  142.                       for standards-track Security Models and are
  143.                       managed by the Internet Assigned Numbers Authority
  144.                       (IANA).
  145.                     - Values greater than 255 are allocated to
  146.                       enterprise-specific Security Models.  An
  147.                       enterprise-specific securityModel value is defined
  148.                       to be:
  149.                       enterpriseID * 256 + security model within
  150.                       enterprise
  151.                       For example, the fourth Security Model defined by
  152.                       the enterprise whose enterpriseID is 1 would be
  153.                       260.
  154.                     This scheme for allocation of securityModel
  155.                     values allows for a maximum of 255 standards-
  156.                     based Security Models, and for a maximum of
  157.                     255 Security Models per enterprise.
  158.                     It is believed that the assignment of new
  159.                     securityModel values will be rare in practice
  160.                     because the larger the number of simultaneously
  161.                     utilized Security Models, the larger the
  162.                     chance that interoperability will suffer.
  163.                     Consequently, it is believed that such a range
  164.                     will be sufficient.  In the unlikely event that
  165.                     the standards committee finds this number to be
  166.                     insufficient over time, an enterprise number
  167.                     can be allocated to obtain an additional 255
  168.                     possible values.
  169.                     Note that the most significant bit must be zero;
  170.                     hence, there are 23 bits allocated for various
  171.                     organizations to design and define non-standard
  172.                     securityModels.  This limits the ability to
  173.                     define new proprietary implementations of Security
  174.                     Models to the first 8,388,608 enterprises.
  175.                     It is worthwhile to note that, in its encoded
  176.                     form, the securityModel value will normally
  177.                     require only a single byte since, in practice,
  178.                     the leftmost bits will be zero for most messages
  179.                     and sign extension is suppressed by the encoding
  180.                     rules.
  181.                     As of this writing, there are several values
  182.                     of securityModel defined for use with SNMP or
  183.                     reserved for use with supporting MIB objects.
  184.                     They are as follows:
  185.                         0  reserved for 'any'
  186.                         1  reserved for SNMPv1
  187.                         2  reserved for SNMPv2c
  188.                         3  User-Based Security Model (USM)
  189.                    "
  190.        SYNTAX       INTEGER(0 .. 2147483647)
  191.    SnmpMessageProcessingModel ::= TEXTUAL-CONVENTION
  192.        STATUS       current
  193.        DESCRIPTION "An identifier that uniquely identifies a Message
  194.                     Processing Model of the Message Processing
  195.                     Subsystem within a SNMP Management Architecture.
  196.                     The values for messageProcessingModel are
  197.                     allocated as follows:
  198.                     - Values between 0 and 255, inclusive, are
  199.                       reserved for standards-track Message Processing
  200.                       Models and are managed by the Internet Assigned
  201.                       Numbers Authority (IANA).
  202.                     - Values greater than 255 are allocated to
  203.                       enterprise-specific Message Processing Models.
  204.                       An enterprise messageProcessingModel value is
  205.                       defined to be:
  206.                       enterpriseID * 256 +
  207.                            messageProcessingModel within enterprise
  208.                       For example, the fourth Message Processing Model
  209.                       defined by the enterprise whose enterpriseID
  210.                       is 1 would be 260.
  211.                     This scheme for allocating messageProcessingModel
  212.                     values allows for a maximum of 255 standards-
  213.                     based Message Processing Models, and for a
  214.                     maximum of 255 Message Processing Models per
  215.                     enterprise.
  216.                     It is believed that the assignment of new
  217.                     messageProcessingModel values will be rare
  218.                     in practice because the larger the number of
  219.                     simultaneously utilized Message Processing Models,
  220.                     the larger the chance that interoperability
  221.                     will suffer. It is believed that such a range
  222.                     will be sufficient.  In the unlikely event that
  223.                     the standards committee finds this number to be
  224.                     insufficient over time, an enterprise number
  225.                     can be allocated to obtain an additional 256
  226.                     possible values.
  227.                     Note that the most significant bit must be zero;
  228.                     hence, there are 23 bits allocated for various
  229.                     organizations to design and define non-standard
  230.                     messageProcessingModels.  This limits the ability
  231.                     to define new proprietary implementations of
  232.                     Message Processing Models to the first 8,388,608
  233.                     enterprises.
  234.                     It is worthwhile to note that, in its encoded
  235.                     form, the messageProcessingModel value will
  236.                     normally require only a single byte since, in
  237.                     practice, the leftmost bits will be zero for
  238.                     most messages and sign extension is suppressed
  239.                     by the encoding rules.
  240.                     As of this writing, there are several values of
  241.                     messageProcessingModel defined for use with SNMP.
  242.                     They are as follows:
  243.                         0  reserved for SNMPv1
  244.                         1  reserved for SNMPv2c
  245.                         2  reserved for SNMPv2u and SNMPv2*
  246.                         3  reserved for SNMPv3
  247.                    "
  248.        SYNTAX       INTEGER(0 .. 2147483647)
  249.    SnmpSecurityLevel ::= TEXTUAL-CONVENTION
  250.        STATUS       current
  251.        DESCRIPTION "A Level of Security at which SNMP messages can be
  252.                     sent or with which operations are being processed;
  253.                     in particular, one of:
  254.                       noAuthNoPriv - without authentication and
  255.                                      without privacy,
  256.                       authNoPriv   - with authentication but
  257.                                      without privacy,
  258.                       authPriv     - with authentication and
  259.                                      with privacy.
  260.                     These three values are ordered such that
  261.                     noAuthNoPriv is less than authNoPriv and
  262.                     authNoPriv is less than authPriv.
  263.                    "
  264.        SYNTAX       INTEGER { noAuthNoPriv(1),
  265.                               authNoPriv(2),
  266.                               authPriv(3)
  267.                             }
  268.    SnmpAdminString ::= TEXTUAL-CONVENTION
  269.        DISPLAY-HINT "255a"
  270.        STATUS       current
  271.        DESCRIPTION "An octet string containing administrative
  272.                     information, preferably in human-readable form.
  273.                     To facilitate internationalization, this
  274.                     information is represented using the ISO/IEC
  275.                     IS 10646-1 character set, encoded as an octet
  276.                     string using the UTF-8 transformation format
  277.                     described in [RFC2279].
  278.                     Since additional code points are added by
  279.                     amendments to the 10646 standard from time
  280.                     to time, implementations must be prepared to
  281.                     encounter any code point from 0x00000000 to
  282.                     0x7fffffff.  Byte sequences that do not
  283.                     correspond to the valid UTF-8 encoding of a
  284.                     code point or are outside this range are
  285.                     prohibited.
  286.                     The use of control codes should be avoided.
  287.                     When it is necessary to represent a newline,
  288.                     the control code sequence CR LF should be used.
  289.                     The use of leading or trailing white space should
  290.                     be avoided.
  291.                     For code points not directly supported by user
  292.                     interface hardware or software, an alternative
  293.                     means of entry and display, such as hexadecimal,
  294.                     may be provided.
  295.                     For information encoded in 7-bit US-ASCII,
  296.                     the UTF-8 encoding is identical to the
  297.                     US-ASCII encoding.
  298.                     UTF-8 may require multiple bytes to represent a
  299.                     single character / code point; thus the length
  300.                     of this object in octets may be different from
  301.                     the number of characters encoded.  Similarly,
  302.                     size constraints refer to the number of encoded
  303.                     octets, not the number of characters represented
  304.                     by an encoding.
  305.                     Note that when this TC is used for an object that
  306.                     is used or envisioned to be used as an index, then
  307.                     a SIZE restriction MUST be specified so that the
  308.                     number of sub-identifiers for any object instance
  309.                     does not exceed the limit of 128, as defined by
  310.                     [RFC1905].
  311.                     Note that the size of an SnmpAdminString object is
  312.                     measured in octets, not characters.
  313.                    "
  314.        SYNTAX       OCTET STRING (SIZE (0..255))
  315.    -- Administrative assignments ***************************************
  316.    snmpFrameworkAdmin
  317.        OBJECT IDENTIFIER ::= { snmpFrameworkMIB 1 }
  318.    snmpFrameworkMIBObjects
  319.        OBJECT IDENTIFIER ::= { snmpFrameworkMIB 2 }
  320.    snmpFrameworkMIBConformance
  321.        OBJECT IDENTIFIER ::= { snmpFrameworkMIB 3 }
  322.    -- the snmpEngine Group ********************************************
  323.    snmpEngine OBJECT IDENTIFIER ::= { snmpFrameworkMIBObjects 1 }
  324.    snmpEngineID     OBJECT-TYPE
  325.        SYNTAX       SnmpEngineID
  326.        MAX-ACCESS   read-only
  327.        STATUS       current
  328.        DESCRIPTION "An SNMP engine's administratively-unique identifier.
  329.                    "
  330.        ::= { snmpEngine 1 }
  331.    snmpEngineBoots  OBJECT-TYPE
  332.        SYNTAX       INTEGER (1..2147483647)
  333.        MAX-ACCESS   read-only
  334.        STATUS       current
  335.        DESCRIPTION "The number of times that the SNMP engine has
  336.                     (re-)initialized itself since snmpEngineID
  337.                     was last configured.
  338.                    "
  339.        ::= { snmpEngine 2 }
  340.    snmpEngineTime   OBJECT-TYPE
  341.        SYNTAX       INTEGER (0..2147483647)
  342.        UNITS        "seconds"
  343.        MAX-ACCESS   read-only
  344.        STATUS       current
  345.        DESCRIPTION "The number of seconds since the value of
  346.                     the snmpEngineBoots object last changed.
  347.                     When incrementing this object's value would
  348.                     cause it to exceed its maximum,
  349.                     snmpEngineBoots is incremented as if a
  350.                     re-initialization had occurred, and this
  351.                     object's value consequently reverts to zero.
  352.                    "
  353.        ::= { snmpEngine 3 }
  354.    snmpEngineMaxMessageSize OBJECT-TYPE
  355.        SYNTAX       INTEGER (484..2147483647)
  356.        MAX-ACCESS   read-only
  357.        STATUS       current
  358.        DESCRIPTION "The maximum length in octets of an SNMP message
  359.                     which this SNMP engine can send or receive and
  360.                     process, determined as the minimum of the maximum
  361.                     message size values supported among all of the
  362.                     transports available to and supported by the engine.
  363.                    "
  364.        ::= { snmpEngine 4 }
  365.    -- Registration Points for Authentication and Privacy Protocols **
  366.    snmpAuthProtocols OBJECT-IDENTITY
  367.        STATUS        current
  368.        DESCRIPTION  "Registration point for standards-track
  369.                      authentication protocols used in SNMP Management
  370.                      Frameworks.
  371.                     "
  372.        ::= { snmpFrameworkAdmin 1 }
  373.    snmpPrivProtocols OBJECT-IDENTITY
  374.        STATUS        current
  375.        DESCRIPTION  "Registration point for standards-track privacy
  376.                      protocols used in SNMP Management Frameworks.
  377.                     "
  378.        ::= { snmpFrameworkAdmin 2 }
  379.    -- Conformance information ******************************************
  380.    snmpFrameworkMIBCompliances
  381.                   OBJECT IDENTIFIER ::= {snmpFrameworkMIBConformance 1}
  382.    snmpFrameworkMIBGroups
  383.                   OBJECT IDENTIFIER ::= {snmpFrameworkMIBConformance 2}
  384.    -- compliance statements
  385.    snmpFrameworkMIBCompliance MODULE-COMPLIANCE
  386.        STATUS       current
  387.        DESCRIPTION "The compliance statement for SNMP engines which
  388.                     implement the SNMP Management Framework MIB.
  389.                    "
  390.        MODULE    -- this module
  391.            MANDATORY-GROUPS { snmpEngineGroup }
  392.        ::= { snmpFrameworkMIBCompliances 1 }
  393.    -- units of conformance
  394.    snmpEngineGroup OBJECT-GROUP
  395.        OBJECTS {
  396.                  snmpEngineID,
  397.                  snmpEngineBoots,
  398.                  snmpEngineTime,
  399.                  snmpEngineMaxMessageSize
  400.                }
  401.        STATUS       current
  402.        DESCRIPTION "A collection of objects for identifying and
  403.                     determining the configuration and current timeliness
  404.                     values of an SNMP engine.
  405.                    "
  406.        ::= { snmpFrameworkMIBGroups 1 }
  407.    END