rfc1442.txt

著名的RFC文档,其中有一些文档是已经翻译成中文的的.

          Network Working Group                                  J. Case
          Request for Comments: 1442                 SNMP Research, Inc.
                                                           K. McCloghrie
                                                      Hughes LAN Systems
                                                                 M. Rose
                                            Dover Beach Consulting, Inc.
                                                           S. Waldbusser
                                              Carnegie Mellon University
                                                              April 1993


                       Structure of Management Information
                               for version 2 of the
                   Simple Network Management Protocol (SNMPv2)


          Status of this Memo

          This RFC specifes an IAB standards track protocol for the
          Internet community, and requests discussion and suggestions
          for improvements.  Please refer to the current edition of the
          "IAB Official Protocol Standards" for the standardization
          state and status of this protocol.  Distribution of this memo
          is unlimited.


          Table of Contents


          1 Introduction ..........................................    2
          1.1 A Note on Terminology ...............................    3
          2 Definitions ...........................................    4
          3.1 The MODULE-IDENTITY macro ...........................    5
          3.2 Object Names and Syntaxes ...........................    7
          3.3 The OBJECT-TYPE macro ...............................   10
          3.5 The NOTIFICATION-TYPE macro .........................   12
          3 Information Modules ...................................   13
          3.1 Macro Invocation ....................................   13
          3.1.1 Textual Clauses ...................................   14
          3.2 IMPORTing Symbols ...................................   14
          4 Naming Hierarchy ......................................   16
          5 Mapping of the MODULE-IDENTITY macro ..................   17
          5.1 Mapping of the LAST-UPDATED clause ..................   17
          5.2 Mapping of the ORGANIZATION clause ..................   17
          5.3 Mapping of the CONTACT-INFO clause ..................   17
          5.4 Mapping of the DESCRIPTION clause ...................   17
          5.5 Mapping of the REVISION clause ......................   17
          5.6 Mapping of the DESCRIPTION clause ...................   18
          5.7 Mapping of the MODULE-IDENTITY value ................   18
          5.8 Usage Example .......................................   19



          Case, McCloghrie, Rose & Waldbusser                  [Page  i]





          RFC 1442                SMI for SNMPv2              April 1993


          6 Mapping of the OBJECT-IDENTITY macro ..................   20
          6.1 Mapping of the STATUS clause ........................   20
          6.2 Mapping of the DESCRIPTION clause ...................   20
          6.3 Mapping of the REFERENCE clause .....................   20
          6.4 Mapping of the OBJECT-IDENTITY value ................   20
          6.5 Usage Example .......................................   21
          7 Mapping of the OBJECT-TYPE macro ......................   22
          7.1 Mapping of the SYNTAX clause ........................   22
          7.1.1 Integer32 and INTEGER .............................   22
          7.1.2 OCTET STRING ......................................   23
          7.1.3 OBJECT IDENTIFIER .................................   23
          7.1.4 BIT STRING ........................................   23
          7.1.5 IpAddress .........................................   23
          7.1.6 Counter32 .........................................   24
          7.1.7 Gauge32 ...........................................   24
          7.1.8 TimeTicks .........................................   24
          7.1.9 Opaque ............................................   25
          7.1.10 NsapAddress ......................................   25
          7.1.11 Counter64 ........................................   26
          7.1.12 UInteger32 .......................................   26
          7.2 Mapping of the UNITS clause .........................   26
          7.3 Mapping of the MAX-ACCESS clause ....................   27
          7.4 Mapping of the STATUS clause ........................   27
          7.5 Mapping of the DESCRIPTION clause ...................   27
          7.6 Mapping of the REFERENCE clause .....................   28
          7.7 Mapping of the INDEX clause .........................   28
          7.7.1 Creation and Deletion of Conceptual Rows ..........   30
          7.8 Mapping of the AUGMENTS clause ......................   31
          7.8.1 Relation between INDEX and AUGMENTS clauses .......   31
          7.9 Mapping of the DEFVAL clause ........................   32
          7.10 Mapping of the OBJECT-TYPE value ...................   33
          7.11 Usage Example ......................................   35
          8 Mapping of the NOTIFICATION-TYPE macro ................   37
          8.1 Mapping of the OBJECTS clause .......................   37
          8.2 Mapping of the STATUS clause ........................   37
          8.3 Mapping of the DESCRIPTION clause ...................   37
          8.4 Mapping of the REFERENCE clause .....................   37
          8.5 Mapping of the NOTIFICATION-TYPE value ..............   38
          8.6 Usage Example .......................................   39
          9 Refined Syntax ........................................   40
          10 Extending an Information Module ......................   41
          10.1 Object Assignments .................................   41
          10.2 Object Definitions .................................   41
          10.3 Notification Definitions ...........................   42



          Case, McCloghrie, Rose & Waldbusser                  [Page ii]





          RFC 1442                SMI for SNMPv2              April 1993


          11 Appendix: de-OSIfying a MIB module ...................   43
          11.1 Managed Object Mapping .............................   43
          11.1.1 Mapping to the SYNTAX clause .....................   44
          11.1.2 Mapping to the UNITS clause ......................   45
          11.1.3 Mapping to the MAX-ACCESS clause .................   45
          11.1.4 Mapping to the STATUS clause .....................   45
          11.1.5 Mapping to the DESCRIPTION clause ................   45
          11.1.6 Mapping to the REFERENCE clause ..................   45
          11.1.7 Mapping to the INDEX clause ......................   45
          11.1.8 Mapping to the DEFVAL clause .....................   45
          11.2 Action Mapping .....................................   46
          11.2.1 Mapping to the SYNTAX clause .....................   46
          11.2.2 Mapping to the MAX-ACCESS clause .................   46
          11.2.3 Mapping to the STATUS clause .....................   46
          11.2.4 Mapping to the DESCRIPTION clause ................   46
          11.2.5 Mapping to the REFERENCE clause ..................   46
          11.3 Event Mapping ......................................   46
          11.3.1 Mapping to the STATUS clause .....................   47
          11.3.2 Mapping to the DESCRIPTION clause ................   47
          11.3.3 Mapping to the REFERENCE clause ..................   47
          12 Acknowledgements .....................................   48
          13 References ...........................................   52
          14 Security Considerations ..............................   54
          15 Authors' Addresses ...................................   54

























          Case, McCloghrie, Rose & Waldbusser                   [Page 1]





          RFC 1442                SMI for SNMPv2              April 1993


          1.  Introduction

          A network management system contains: several (potentially
          many) nodes, each with a processing entity, termed an agent,
          which has access to management instrumentation; at least one
          management station; and, a management protocol, used to convey
          management information between the agents and management
          stations.  Operations of the protocol are carried out under an
          administrative framework which defines both authentication and
          authorization policies.

          Network management stations execute management applications
          which monitor and control network elements.  Network elements
          are devices such as hosts, routers, terminal servers, etc.,
          which are monitored and controlled through access to their
          management information.

          Management information is viewed as a collection of managed
          objects, residing in a virtual information store, termed the
          Management Information Base (MIB).  Collections of related
          objects are defined in MIB modules.  These modules are written
          using a subset of OSI's Abstract Syntax Notation One (ASN.1)
          [1].  It is the purpose of this document, the Structure of
          Management Information (SMI), to define that subset.

          The SMI is divided into three parts: module definitions,
          object definitions, and, trap definitions.

          (1)  Module definitions are used when describing information
               modules.  An ASN.1 macro, MODULE-IDENTITY, is used to
               concisely convey the semantics of an information module.

          (2)  Object definitions are used when describing managed
               objects.  An ASN.1 macro, OBJECT-TYPE, is used to
               concisely convey the syntax and semantics of a managed
               object.

          (3)  Notification definitions are used when describing
               unsolicited transmissions of management information.  An
               ASN.1 macro, NOTIFICATION-TYPE, is used to concisely
               convey the syntax and semantics of a notification.









          Case, McCloghrie, Rose & Waldbusser                   [Page 2]





          RFC 1442                SMI for SNMPv2              April 1993


          1.1.  A Note on Terminology

          For the purpose of exposition, the original Internet-standard
          Network Management Framework, as described in RFCs 1155, 1157,
          and 1212, is termed the SNMP version 1 framework (SNMPv1).
          The current framework is termed the SNMP version 2 framework
          (SNMPv2).











































          Case, McCloghrie, Rose & Waldbusser                   [Page 3]





          RFC 1442                SMI for SNMPv2              April 1993


          2.  Definitions

          SNMPv2-SMI DEFINITIONS ::= BEGIN


          -- the path to the root

          internet       OBJECT IDENTIFIER ::= { iso 3 6 1 }

          directory      OBJECT IDENTIFIER ::= { internet 1 }

          mgmt           OBJECT IDENTIFIER ::= { internet 2 }

          experimental   OBJECT IDENTIFIER ::= { internet 3 }

          private        OBJECT IDENTIFIER ::= { internet 4 }
          enterprises    OBJECT IDENTIFIER ::= { private 1 }

          security       OBJECT IDENTIFIER ::= { internet 5 }

          snmpV2         OBJECT IDENTIFIER ::= { internet 6 }

          -- transport domains
          snmpDomains    OBJECT IDENTIFIER ::= { snmpV2 1 }

          -- transport proxies
          snmpProxys     OBJECT IDENTIFIER ::= { snmpV2 2 }

          -- module identities
          snmpModules    OBJECT IDENTIFIER ::= { snmpV2 3 }




















          Case, McCloghrie, Rose & Waldbusser                   [Page 4]





          RFC 1442                SMI for SNMPv2              April 1993


          -- definitions for information modules

          MODULE-IDENTITY MACRO ::=
          BEGIN
              TYPE NOTATION ::=
                            "LAST-UPDATED" value(Update UTCTime)
                            "ORGANIZATION" Text
                            "CONTACT-INFO" Text
                            "DESCRIPTION" Text
                            RevisionPart

              VALUE NOTATION ::=
                            value(VALUE OBJECT IDENTIFIER)

              RevisionPart ::=
                            Revisions
                          | empty
              Revisions ::=
                            Revision
                          | Revisions Revision
              Revision ::=
                            "REVISION" value(Update UTCTime)
                            "DESCRIPTION" Text

              -- uses the NVT ASCII character set
              Text ::= """" string """"
          END























          Case, McCloghrie, Rose & Waldbusser                   [Page 5]





          RFC 1442                SMI for SNMPv2              April 1993


          OBJECT-IDENTITY MACRO ::=
          BEGIN
              TYPE NOTATION ::=
                            "STATUS" Status
                            "DESCRIPTION" Text
                            ReferPart

              VALUE NOTATION ::=
                            value(VALUE OBJECT IDENTIFIER)

              Status ::=
                            "current"
                          | "obsolete"

              ReferPart ::=
                          "REFERENCE" Text
                        | empty

              Text ::= """" string """"
          END