home *** CD-ROM | disk | FTP | other *** search
/ Thomson (Residential) / TGSTPv7203.iso / mac / SNMP_MIBs / snmpv3 / SNMP-COMMUNITY-MIB.mib < prev    next >
Text File  |  2008-02-08  |  19KB  |  529 lines
  1. -- file: SNMP-COMMUNITY-MIB.my
  2. -- Extracted from RFC3584 by MG-SOFT Corp.
  3. -- Changes:
  4. --      No changes needed.
  5. -- http://www.mg-soft.com/
  6.  
  7. SNMP-COMMUNITY-MIB DEFINITIONS ::= BEGIN
  8.  
  9.       IMPORTS
  10.           IpAddress,
  11.           MODULE-IDENTITY,
  12.           OBJECT-TYPE,
  13.           Integer32,
  14.           snmpModules
  15.               FROM SNMPv2-SMI
  16.           RowStatus,
  17.           StorageType
  18.               FROM SNMPv2-TC
  19.           SnmpAdminString,
  20.           SnmpEngineID
  21.               FROM SNMP-FRAMEWORK-MIB
  22.           SnmpTagValue,
  23.           snmpTargetAddrEntry
  24.               FROM SNMP-TARGET-MIB
  25.           MODULE-COMPLIANCE,
  26.           OBJECT-GROUP
  27.               FROM SNMPv2-CONF;
  28.  
  29.       snmpCommunityMIB MODULE-IDENTITY
  30.           LAST-UPDATED "200308060000Z"        -- 06 Aug 2003, midnight
  31.     ORGANIZATION "SNMPv3 Working Group"
  32.     CONTACT-INFO "WG-email:   snmpv3@lists.tislabs.com
  33.                   Subscribe:  majordomo@lists.tislabs.com
  34.                               In msg body:  subscribe snmpv3
  35.  
  36.                   Co-Chair:   Russ Mundy
  37.                               SPARTA, Inc
  38.                   Postal:     7075 Samuel Morse Drive
  39.                               Columbia, MD 21045
  40.                               USA
  41.                   EMail:      mundy@tislabs.com
  42.                   Phone:      +1 410-872-1515
  43.  
  44.                   Co-Chair:   David Harrington
  45.                               Enterasys Networks
  46.                   Postal:     35 Industrial Way
  47.                               P. O. Box 5005
  48.                               Rochester, New Hampshire 03866-5005
  49.                               USA
  50.                   EMail:      dbh@enterasys.com
  51.                   Phone:      +1 603-337-2614
  52.  
  53.                   Co-editor:  Rob Frye
  54.                               Vibrant Solutions
  55.  
  56.  
  57.                   Postal:     2711 Prosperity Ave
  58.                               Fairfax, Virginia 22031
  59.                               USA
  60.                   E-mail:     rfrye@vibrant-1.com
  61.                   Phone:      +1-703-270-2000
  62.  
  63.                   Co-editor:  David B. Levi
  64.                               Nortel Networks
  65.                   Postal:     3505 Kesterwood Drive
  66.                               Knoxville, Tennessee 37918
  67.                   E-mail:     dlevi@nortelnetworks.com
  68.                   Phone:      +1 865 686 0432
  69.  
  70.                   Co-editor:  Shawn A. Routhier
  71.                               Wind River Systems, Inc.
  72.                   Postal:     500 Wind River Way
  73.                               Alameda, CA 94501
  74.                   E-mail:     sar@epilogue.com
  75.                   Phone:      +1 510 749 2095
  76.  
  77.                   Co-editor:  Bert Wijnen
  78.                               Lucent Technologies
  79.                   Postal:     Schagen 33
  80.                               3461 GL Linschoten
  81.                               Netherlands
  82.                   Email:      bwijnen@lucent.com
  83.                   Phone:      +31-348-407-775
  84.                  "
  85.  
  86.         DESCRIPTION
  87.             "This MIB module defines objects to help support
  88.              coexistence between SNMPv1, SNMPv2c, and SNMPv3.
  89.  
  90.              Copyright (C) The Internet Society (2003) This
  91.              version of this MIB module is part of RFC 3584;
  92.              see the RFC itself for full legal notices."
  93.  
  94.         REVISION "200308060000Z" -- 06 Aug 2003
  95.         DESCRIPTION
  96.             "Updated the LAST-UPDATED, CONTACT-INFO, and REVISION
  97.              clauses and added a copyright notice to the
  98.              DESCRIPTION clause of the MIB module's
  99.              MODULE-IDENTITY invocation.
  100.  
  101.              Updated the description of snmpCommunityTransportTag
  102.              to make it consistent with the rest of the document.
  103.  
  104.              Updated the description of `snmpTargetAddrMMS' to
  105.  
  106.  
  107.              clarify that a value of 0 means that the maximum
  108.              message size is unknown.
  109.  
  110.              Changed the name of 'snmpCommunityGroup' to
  111.              snmpCommunityTableGroup to avoid a name conflict
  112.              with the SNMPv2-MIB.
  113.  
  114.              Updated DESCRIPTION of snmpCommunityName.
  115.  
  116.              Updated DESCRIPTION of snmpTrapCommunity.
  117.  
  118.              Added snmpCommunityMIBFullCompliance.
  119.  
  120.              This version published as RFC 3584."
  121.  
  122.         REVISION "200003060000Z" -- 6 Mar 2000
  123.         DESCRIPTION "This version published as RFC 2576."
  124.  
  125.     ::= { snmpModules 18 }
  126.  
  127. -- Administrative assignments ************************************
  128.  
  129. snmpCommunityMIBObjects
  130.         OBJECT IDENTIFIER ::= { snmpCommunityMIB 1 }
  131.  
  132. snmpCommunityMIBConformance
  133.         OBJECT IDENTIFIER ::= { snmpCommunityMIB 2 }
  134.  
  135. --
  136. -- The snmpCommunityTable contains a database of community
  137. -- strings.  This table provides mappings between community
  138. -- strings, and the parameters required for View-based Access
  139. -- Control.
  140. --
  141.  
  142. snmpCommunityTable OBJECT-TYPE
  143.     SYNTAX       SEQUENCE OF SnmpCommunityEntry
  144.     MAX-ACCESS   not-accessible
  145.     STATUS       current
  146.     DESCRIPTION
  147.         "The table of community strings configured in the SNMP
  148.          engine's Local Configuration Datastore (LCD)."
  149.     ::= { snmpCommunityMIBObjects 1 }
  150.  
  151. snmpCommunityEntry OBJECT-TYPE
  152.     SYNTAX       SnmpCommunityEntry
  153.     MAX-ACCESS   not-accessible
  154.     STATUS       current
  155.  
  156.  
  157.     DESCRIPTION
  158.         "Information about a particular community string."
  159.     INDEX       { IMPLIED snmpCommunityIndex }
  160.     ::= { snmpCommunityTable 1 }
  161.  
  162. SnmpCommunityEntry ::= SEQUENCE {
  163.     snmpCommunityIndex               SnmpAdminString,
  164.     snmpCommunityName                OCTET STRING,
  165.     snmpCommunitySecurityName        SnmpAdminString,
  166.     snmpCommunityContextEngineID     SnmpEngineID,
  167.     snmpCommunityContextName         SnmpAdminString,
  168.     snmpCommunityTransportTag        SnmpTagValue,
  169.     snmpCommunityStorageType         StorageType,
  170.     snmpCommunityStatus              RowStatus
  171. }
  172.  
  173. snmpCommunityIndex OBJECT-TYPE
  174.     SYNTAX      SnmpAdminString (SIZE(1..32))
  175.     MAX-ACCESS  not-accessible
  176.     STATUS      current
  177.     DESCRIPTION
  178.         "The unique index value of a row in this table."
  179.     ::= { snmpCommunityEntry 1 }
  180.  
  181. snmpCommunityName OBJECT-TYPE
  182.     SYNTAX       OCTET STRING
  183.     MAX-ACCESS   read-create
  184.     STATUS       current
  185.     DESCRIPTION
  186.         "The community string for which a row in this table
  187.          represents a configuration.  There is no SIZE constraint
  188.          specified for this object because RFC 1157 does not
  189.          impose any explicit limitation on the length of community
  190.          strings (their size is constrained indirectly by the
  191.          SNMP message size)."
  192.     ::= { snmpCommunityEntry 2 }
  193.  
  194. snmpCommunitySecurityName OBJECT-TYPE
  195.     SYNTAX       SnmpAdminString (SIZE(1..32))
  196.     MAX-ACCESS   read-create
  197.     STATUS       current
  198.     DESCRIPTION
  199.         "A human readable string representing the corresponding
  200.          value of snmpCommunityName in a Security Model
  201.          independent format."
  202.     ::= { snmpCommunityEntry 3 }
  203.  
  204. snmpCommunityContextEngineID OBJECT-TYPE
  205.  
  206.  
  207.     SYNTAX       SnmpEngineID
  208.     MAX-ACCESS   read-create
  209.     STATUS       current
  210.     DESCRIPTION
  211.         "The contextEngineID indicating the location of the
  212.          context in which management information is accessed
  213.          when using the community string specified by the
  214.          corresponding instance of snmpCommunityName.
  215.  
  216.          The default value is the snmpEngineID of the entity in
  217.          which this object is instantiated."
  218.     ::= { snmpCommunityEntry 4 }
  219.  
  220. snmpCommunityContextName OBJECT-TYPE
  221.     SYNTAX       SnmpAdminString (SIZE(0..32))
  222.     MAX-ACCESS   read-create
  223.     STATUS       current
  224.     DESCRIPTION
  225.         "The context in which management information is accessed
  226.          when using the community string specified by the
  227.          corresponding instance of snmpCommunityName."
  228.     DEFVAL      { ''H }   -- the empty string
  229.     ::= { snmpCommunityEntry 5 }
  230.  
  231. snmpCommunityTransportTag OBJECT-TYPE
  232.     SYNTAX       SnmpTagValue
  233.     MAX-ACCESS   read-create
  234.     STATUS       current
  235.     DESCRIPTION
  236.         "This object specifies a set of transport endpoints
  237.          which are used in two ways:
  238.             - to specify the transport endpoints from which an
  239.               SNMP entity will accept management requests, and
  240.             - to specify the transport endpoints to which a
  241.               notification may be sent using the community
  242.               string matching the corresponding instance of
  243.               snmpCommunityName.
  244.          In either case, if the value of this object has
  245.          zero-length, transport endpoints are not checked when
  246.          either authenticating messages containing this community
  247.          string, nor when generating notifications.
  248.  
  249.          The transports identified by this object are specified
  250.          in the snmpTargetAddrTable.  Entries in that table
  251.          whose snmpTargetAddrTagList contains this tag value
  252.          are identified.
  253.  
  254.          If a management request containing a community string
  255.  
  256.  
  257.          that matches the corresponding instance of
  258.          snmpCommunityName is received on a transport endpoint
  259.          other than the transport endpoints identified by this
  260.          object the request is deemed unauthentic.
  261.  
  262.          When a notification is to be sent using an entry in
  263.          this table, if the destination transport endpoint of
  264.          the notification does not match one of the transport
  265.          endpoints selected by this object, the notification
  266.          is not sent."
  267.     DEFVAL      { ''H }   -- the empty string
  268.     ::= { snmpCommunityEntry 6 }
  269.  
  270. snmpCommunityStorageType OBJECT-TYPE
  271.     SYNTAX       StorageType
  272.     MAX-ACCESS   read-create
  273.     STATUS       current
  274.     DESCRIPTION
  275.         "The storage type for this conceptual row in the
  276.          snmpCommunityTable.  Conceptual rows having the value
  277.          'permanent' need not allow write-access to any
  278.          columnar object in the row."
  279.     ::= { snmpCommunityEntry 7 }
  280.  
  281. snmpCommunityStatus OBJECT-TYPE
  282.     SYNTAX       RowStatus
  283.     MAX-ACCESS   read-create
  284.     STATUS       current
  285.     DESCRIPTION
  286.         "The status of this conceptual row in the
  287.          snmpCommunityTable.
  288.  
  289.          An entry in this table is not qualified for activation
  290.          until instances of all corresponding columns have been
  291.          initialized, either through default values, or through
  292.          Set operations.  The snmpCommunityName and
  293.          snmpCommunitySecurityName objects must be explicitly set.
  294.  
  295.          There is no restriction on setting columns in this table
  296.          when the value of snmpCommunityStatus is active(1)."
  297.     ::= { snmpCommunityEntry 8 }
  298.  
  299. --
  300. -- The snmpTargetAddrExtTable
  301. --
  302.  
  303. snmpTargetAddrExtTable OBJECT-TYPE
  304.     SYNTAX       SEQUENCE OF SnmpTargetAddrExtEntry
  305.  
  306.  
  307.     MAX-ACCESS   not-accessible
  308.     STATUS       current
  309.     DESCRIPTION
  310.         "The table of mask and maximum message size (mms) values
  311.          associated with the snmpTargetAddrTable.
  312.  
  313.          The snmpTargetAddrExtTable augments the
  314.          snmpTargetAddrTable with a transport address mask value
  315.          and a maximum message size value.  The transport address
  316.          mask allows entries in the snmpTargetAddrTable to define
  317.          a set of addresses instead of just a single address.
  318.          The maximum message size value allows the maximum
  319.          message size of another SNMP entity to be configured for
  320.          use in SNMPv1 (and SNMPv2c) transactions, where the
  321.          message format does not specify a maximum message size."
  322.     ::= { snmpCommunityMIBObjects 2 }
  323.  
  324. snmpTargetAddrExtEntry OBJECT-TYPE
  325.     SYNTAX       SnmpTargetAddrExtEntry
  326.     MAX-ACCESS   not-accessible
  327.     STATUS       current
  328.     DESCRIPTION
  329.         "Information about a particular mask and mms value."
  330.     AUGMENTS       { snmpTargetAddrEntry }
  331.     ::= { snmpTargetAddrExtTable 1 }
  332.  
  333. SnmpTargetAddrExtEntry ::= SEQUENCE {
  334.     snmpTargetAddrTMask              OCTET STRING,
  335.     snmpTargetAddrMMS                Integer32
  336. }
  337.  
  338. snmpTargetAddrTMask OBJECT-TYPE
  339.     SYNTAX      OCTET STRING (SIZE (0..255))
  340.     MAX-ACCESS  read-create
  341.     STATUS      current
  342.     DESCRIPTION
  343.         "The mask value associated with an entry in the
  344.          snmpTargetAddrTable.  The value of this object must
  345.          have the same length as the corresponding instance of
  346.          snmpTargetAddrTAddress, or must have length 0.  An
  347.          attempt to set it to any other value will result in
  348.          an inconsistentValue error.
  349.  
  350.          The value of this object allows an entry in the
  351.          snmpTargetAddrTable to specify multiple addresses.
  352.          The mask value is used to select which bits of
  353.          a transport address must match bits of the corresponding
  354.          instance of snmpTargetAddrTAddress, in order for the
  355.  
  356.  
  357.          transport address to match a particular entry in the
  358.          snmpTargetAddrTable.  Bits which are 1 in the mask
  359.          value indicate bits in the transport address which
  360.          must match bits in the snmpTargetAddrTAddress value.
  361.          Bits which are 0 in the mask indicate bits in the
  362.          transport address which need not match.  If the
  363.          length of the mask is 0, the mask should be treated
  364.          as if all its bits were 1 and its length were equal
  365.          to the length of the corresponding value of
  366.          snmpTargetAddrTable.
  367.  
  368.          This object may not be modified while the value of the
  369.          corresponding instance of snmpTargetAddrRowStatus is
  370.          active(1).  An attempt to set this object in this case
  371.          will result in an inconsistentValue error."
  372.     DEFVAL { ''H }
  373.     ::= { snmpTargetAddrExtEntry 1 }
  374.  
  375. snmpTargetAddrMMS OBJECT-TYPE
  376.     SYNTAX      Integer32 (0|484..2147483647)
  377.     MAX-ACCESS  read-create
  378.     STATUS      current
  379.     DESCRIPTION
  380.         "The maximum message size value associated with an entry
  381.          in the snmpTargetAddrTable.  Note that a value of 0 means
  382.          that the maximum message size is unknown."
  383.     DEFVAL { 484 }
  384.     ::= { snmpTargetAddrExtEntry 2 }
  385.  
  386. --
  387. -- The snmpTrapAddress and snmpTrapCommunity objects are included
  388. -- in notifications that are forwarded by a proxy, which were
  389. -- originally received as SNMPv1 Trap messages.
  390. --
  391.  
  392. snmpTrapAddress OBJECT-TYPE
  393.     SYNTAX      IpAddress
  394.     MAX-ACCESS  accessible-for-notify
  395.     STATUS      current
  396.     DESCRIPTION
  397.         "The value of the agent-addr field of a Trap PDU which
  398.          is forwarded by a proxy forwarder application using
  399.          an SNMP version other than SNMPv1.  The value of this
  400.          object SHOULD contain the value of the agent-addr field
  401.          from the original Trap PDU as generated by an SNMPv1
  402.          agent."
  403.     ::= { snmpCommunityMIBObjects 3 }
  404.  
  405.  
  406. snmpTrapCommunity OBJECT-TYPE
  407.     SYNTAX      OCTET STRING
  408.     MAX-ACCESS  accessible-for-notify
  409.     STATUS      current
  410.     DESCRIPTION
  411.         "The value of the community string field of an SNMPv1
  412.          message containing a Trap PDU which is forwarded by a
  413.          a proxy forwarder application using an SNMP version
  414.          other than SNMPv1.  The value of this object SHOULD
  415.          contain the value of the community string field from
  416.          the original SNMPv1 message containing a Trap PDU as
  417.          generated by an SNMPv1 agent.  There is no SIZE
  418.          constraint specified for this object because RFC 1157
  419.          does not impose any explicit limitation on the length
  420.          of community strings (their size is constrained
  421.          indirectly by the SNMP message size)."
  422.     ::= { snmpCommunityMIBObjects 4 }
  423.  
  424. -- Conformance Information **************************************
  425.  
  426. snmpCommunityMIBCompliances OBJECT IDENTIFIER
  427.                             ::= { snmpCommunityMIBConformance 1 }
  428. snmpCommunityMIBGroups      OBJECT IDENTIFIER
  429.                             ::= { snmpCommunityMIBConformance 2 }
  430.  
  431. -- Compliance statements
  432.  
  433. snmpCommunityMIBCompliance MODULE-COMPLIANCE
  434.     STATUS       current
  435.     DESCRIPTION
  436.         "The compliance statement for SNMP engines which
  437.          implement the SNMP-COMMUNITY-MIB."
  438.  
  439.     MODULE       -- this module
  440.         MANDATORY-GROUPS { snmpCommunityTableGroup }
  441.  
  442.         OBJECT           snmpCommunityName
  443.         MIN-ACCESS       read-only
  444.         DESCRIPTION     "Write access is not required."
  445.  
  446.         OBJECT           snmpCommunitySecurityName
  447.         MIN-ACCESS       read-only
  448.         DESCRIPTION     "Write access is not required."
  449.  
  450.         OBJECT           snmpCommunityContextEngineID
  451.         MIN-ACCESS       read-only
  452.         DESCRIPTION     "Write access is not required."
  453.  
  454.  
  455.         OBJECT           snmpCommunityContextName
  456.         MIN-ACCESS       read-only
  457.         DESCRIPTION     "Write access is not required."
  458.  
  459.         OBJECT           snmpCommunityTransportTag
  460.         MIN-ACCESS       read-only
  461.         DESCRIPTION     "Write access is not required."
  462.  
  463.         OBJECT           snmpCommunityStorageType
  464.         MIN-ACCESS       read-only
  465.         DESCRIPTION     "Write access is not required."
  466.  
  467.         OBJECT           snmpCommunityStatus
  468.         MIN-ACCESS       read-only
  469.         DESCRIPTION     "Write access is not required."
  470.  
  471.     ::= { snmpCommunityMIBCompliances 1 }
  472.  
  473. snmpProxyTrapForwardCompliance MODULE-COMPLIANCE
  474.     STATUS       current
  475.     DESCRIPTION
  476.         "The compliance statement for SNMP engines which
  477.          contain a proxy forwarding application which is
  478.          capable of forwarding SNMPv1 traps using SNMPv2c
  479.          or SNMPv3."
  480.     MODULE       -- this module
  481.         MANDATORY-GROUPS { snmpProxyTrapForwardGroup }
  482.     ::= { snmpCommunityMIBCompliances 2 }
  483.  
  484. snmpCommunityMIBFullCompliance MODULE-COMPLIANCE
  485.     STATUS       current
  486.     DESCRIPTION
  487.         "The compliance statement for SNMP engines which
  488.          implement the SNMP-COMMUNITY-MIB with full read-create
  489.          access."
  490.  
  491.     MODULE       -- this module
  492.         MANDATORY-GROUPS { snmpCommunityTableGroup }
  493.     ::= { snmpCommunityMIBCompliances 3 }
  494.  
  495. snmpCommunityTableGroup OBJECT-GROUP
  496.     OBJECTS {
  497.         snmpCommunityName,
  498.         snmpCommunitySecurityName,
  499.         snmpCommunityContextEngineID,
  500.         snmpCommunityContextName,
  501.         snmpCommunityTransportTag,
  502.         snmpCommunityStorageType,
  503.  
  504.  
  505.         snmpCommunityStatus,
  506.         snmpTargetAddrTMask,
  507.         snmpTargetAddrMMS
  508.     }
  509.     STATUS       current
  510.     DESCRIPTION
  511.         "A collection of objects providing for configuration
  512.          of community strings for SNMPv1 (and SNMPv2c) usage."
  513.     ::= { snmpCommunityMIBGroups 1 }
  514.  
  515. snmpProxyTrapForwardGroup OBJECT-GROUP
  516.     OBJECTS {
  517.         snmpTrapAddress,
  518.         snmpTrapCommunity
  519.     }
  520.     STATUS       current
  521.     DESCRIPTION
  522.         "Objects which are used by proxy forwarding applications
  523.          when translating traps between SNMP versions.  These are
  524.          used to preserve SNMPv1-specific information when
  525.          translating to SNMPv2c or SNMPv3."
  526.     ::= { snmpCommunityMIBGroups 3 }
  527.  
  528. END
  529.