home *** CD-ROM | disk | FTP | other *** search
/ Chip 2001 January / Chip_2001-01_cd1.bin / tema / php / php4-win.exe / mibs / SNMP-COMMUNITY-MIB.txt < prev    next >
Text File  |  1999-11-14  |  14KB  |  429 lines
  1. SNMP-COMMUNITY-MIB DEFINITIONS ::= BEGIN
  2.  
  3. IMPORTS
  4.     IpAddress,
  5.     MODULE-IDENTITY,
  6.     OBJECT-TYPE,
  7.     Integer32,
  8.     snmpModules
  9.     FROM SNMPv2-SMI
  10.     RowStatus,
  11.     StorageType
  12.     FROM SNMPv2-TC
  13.     SnmpAdminString,
  14.     SnmpEngineID
  15.     FROM SNMP-FRAMEWORK-MIB
  16.     SnmpTagValue,
  17.     snmpTargetAddrEntry
  18.     FROM SNMP-TARGET-MIB
  19.     MODULE-COMPLIANCE,
  20.     OBJECT-GROUP
  21.     FROM SNMPv2-CONF;
  22.  
  23. snmpCommunityMIB MODULE-IDENTITY
  24.     LAST-UPDATED "199910050000Z"          -- 5 Oct 1999, midnight
  25.     ORGANIZATION "SNMPv3 Working Group"
  26.     CONTACT-INFO "WG-email:   snmpv3@lists.tislabs.com
  27.           Subscribe:  majordomo@lists.tislabs.com
  28.                   In msg body:  subscribe snmpv3
  29.  
  30.           Chair:      Russ Mundy
  31.                   TIS Labs at Network Associates
  32.           Postal:     3060 Washington Rd
  33.                   Glenwood MD 21738
  34.                   USA
  35.           Email:      mundy@tislabs.com
  36.           Phone:      +1-301-854-6889
  37.  
  38.           Co-editor:  Rob Frye
  39.                   MCI WorldCom
  40.           Postal:     2100 Reston Parkway, Suite 600
  41.                   Reston, VA 20191
  42.                   USA
  43.           E-mail:     Rob.Frye@wcom.com
  44.           Phone:      +1 703 715 7225
  45.  
  46.           Co-editor:  David B. Levi
  47.                   Nortel Networks
  48.           Postal:     3505 Kesterwood Drive
  49.                   Knoxville, TN 37918
  50.           E-mail:     dlevi@nortelnetworks.com
  51.           Phone:      +1 423 686 0432
  52.  
  53.           Co-editor:  Shawn A. Routhier
  54.                   Integrated Systems Inc.
  55.           Postal:     333 North Ave 4th Floor
  56.                   Wakefield, MA 01880
  57.           E-mail:     sar@epilogue.com
  58.           Phone:      +1 781 245 0804
  59.  
  60.           Co-editor:  Bert Wijnen
  61.                   IBM T. J. Watson Research
  62.           Postal:     Schagen 33
  63.                   3461 GL Linschoten
  64.                   Netherlands
  65.           Email:      wijnen@vnet.ibm.com
  66.           Phone:      +31-348-432-794
  67.          "
  68.  
  69.     DESCRIPTION
  70.         "This MIB module defines objects to help support coexistence
  71.          between SNMPv1, SNMPv2c, and SNMPv3."
  72.     REVISION "199905130000Z" -- 13 May 1999
  73.     DESCRIPTION "The Initial Revision"
  74.     REVISION "199910050000Z" -- 5 Oct 1999 (same as LAST-UPDATED)
  75.     DESCRIPTION "This version published as RFC xxxx"
  76.          -- RFC-editor assigns xxxx
  77.     ::= { snmpModules 18 }
  78.  
  79. -- Administrative assignments ****************************************
  80.  
  81. snmpCommunityMIBObjects     OBJECT IDENTIFIER ::= { snmpCommunityMIB 1 }
  82. snmpCommunityMIBConformance OBJECT IDENTIFIER ::= { snmpCommunityMIB 2 }
  83.  
  84. --
  85. -- The snmpCommunityTable contains a database of community strings.
  86. -- This table provides mappings between community strings, and the
  87. -- parameters required for View-based Access Control.
  88. --
  89.  
  90. snmpCommunityTable OBJECT-TYPE
  91.     SYNTAX       SEQUENCE OF SnmpCommunityEntry
  92.     MAX-ACCESS   not-accessible
  93.     STATUS       current
  94.     DESCRIPTION
  95.     "The table of community strings configured in the SNMP
  96.      engine's Local Configuration Datastore (LCD)."
  97.     ::= { snmpCommunityMIBObjects 1 }
  98.  
  99. snmpCommunityEntry OBJECT-TYPE
  100.     SYNTAX       SnmpCommunityEntry
  101.     MAX-ACCESS   not-accessible
  102.     STATUS       current
  103.     DESCRIPTION
  104.     "Information about a particular community string."
  105.     INDEX       { IMPLIED snmpCommunityIndex }
  106.     ::= { snmpCommunityTable 1 }
  107.  
  108. SnmpCommunityEntry ::= SEQUENCE {
  109.     snmpCommunityIndex               SnmpAdminString,
  110.     snmpCommunityName                OCTET STRING,
  111.     snmpCommunitySecurityName        SnmpAdminString,
  112.     snmpCommunityContextEngineID     SnmpEngineID,
  113.     snmpCommunityContextName         SnmpAdminString,
  114.     snmpCommunityTransportTag        SnmpTagValue,
  115.     snmpCommunityStorageType         StorageType,
  116.     snmpCommunityStatus              RowStatus
  117. }
  118.  
  119. snmpCommunityIndex OBJECT-TYPE
  120.     SYNTAX      SnmpAdminString (SIZE(1..32))
  121.     MAX-ACCESS  not-accessible
  122.     STATUS      current
  123.     DESCRIPTION
  124.     "The unique index value of a row in this table."
  125.     ::= { snmpCommunityEntry 1 }
  126.  
  127. snmpCommunityName OBJECT-TYPE
  128.     SYNTAX       OCTET STRING
  129.     MAX-ACCESS   read-create
  130.     STATUS       current
  131.     DESCRIPTION
  132.     "The community string for which a row in this table
  133.      represents a configuration."
  134.     ::= { snmpCommunityEntry 2 }
  135.  
  136. snmpCommunitySecurityName OBJECT-TYPE
  137.     SYNTAX       SnmpAdminString (SIZE(1..32))
  138.     MAX-ACCESS   read-create
  139.     STATUS       current
  140.     DESCRIPTION
  141.     "A human readable string representing the corresponding
  142.      value of snmpCommunityName in a Security Model
  143.      independent format."
  144.     ::= { snmpCommunityEntry 3 }
  145.  
  146. snmpCommunityContextEngineID OBJECT-TYPE
  147.     SYNTAX       SnmpEngineID
  148.     MAX-ACCESS   read-create
  149.     STATUS       current
  150.     DESCRIPTION
  151.     "The contextEngineID indicating the location of the
  152.      context in which management information is accessed
  153.      when using the community string specified by the
  154.      corresponding instance of snmpCommunityName.
  155.  
  156.      The default value is the snmpEngineID of the entity in
  157.      which this object is instantiated."
  158.     ::= { snmpCommunityEntry 4 }
  159.  
  160. snmpCommunityContextName OBJECT-TYPE
  161.     SYNTAX       SnmpAdminString (SIZE(0..32))
  162.     MAX-ACCESS   read-create
  163.     STATUS       current
  164.     DESCRIPTION
  165.     "The context in which management information is accessed
  166.      when using the community string specified by the corresponding
  167.      instance of snmpCommunityName."
  168.     DEFVAL      { ''H }   -- the empty string
  169.     ::= { snmpCommunityEntry 5 }
  170.  
  171. snmpCommunityTransportTag OBJECT-TYPE
  172.     SYNTAX       SnmpTagValue
  173.     MAX-ACCESS   read-create
  174.     STATUS       current
  175.     DESCRIPTION
  176.     "This object specifies a set of transport endpoints
  177.      from which a command responder application will accept
  178.      management requests.  If a management request containing
  179.      this community is received on a transport endpoint other
  180.      than the transport endpoints identified by this object,
  181.      the request is deemed unauthentic.
  182.  
  183.      The transports identified by this object are specified
  184.      in the snmpTargetAddrTable.  Entries in that table
  185.      whose snmpTargetAddrTagList contains this tag value
  186.      are identified.
  187.  
  188.      If the value of this object has zero-length, transport
  189.      endpoints are not checked when authenticating messages
  190.      containing this community string."
  191.     DEFVAL      { ''H }   -- the empty string
  192.     ::= { snmpCommunityEntry 6 }
  193.  
  194. snmpCommunityStorageType OBJECT-TYPE
  195.     SYNTAX       StorageType
  196.     MAX-ACCESS   read-create
  197.     STATUS       current
  198.     DESCRIPTION
  199.     "The storage type for this conceptual row in the
  200.      snmpCommunityTable.  Conceptual rows having the value
  201.      'permanent' need not allow write-access to any
  202.      columnar object in the row."
  203.     ::= { snmpCommunityEntry 7 }
  204.  
  205. snmpCommunityStatus OBJECT-TYPE
  206.     SYNTAX       RowStatus
  207.     MAX-ACCESS   read-create
  208.     STATUS       current
  209.     DESCRIPTION
  210.     "The status of this conceptual row in the snmpCommunityTable.
  211.  
  212.      An entry in this table is not qualified for activation
  213.      until instances of all corresponding columns have been
  214.      initialized, either through default values, or through
  215.      Set operations.  The snmpCommunityName and
  216.      snmpCommunitySecurityName objects must be explicitly set.
  217.  
  218.      There is no restriction on setting columns in this table
  219.      when the value of snmpCommunityStatus is active(1)."
  220.     ::= { snmpCommunityEntry 8 }
  221.  
  222. --
  223. -- The snmpTargetAddrExtTable
  224. --
  225.  
  226. snmpTargetAddrExtTable OBJECT-TYPE
  227.     SYNTAX       SEQUENCE OF SnmpTargetAddrExtEntry
  228.     MAX-ACCESS   not-accessible
  229.     STATUS       current
  230.     DESCRIPTION
  231.     "The table of mask and mms values associated with the
  232.      snmpTargetAddrTable.
  233.  
  234.      The snmpTargetAddrExtTable augments the
  235.      snmpTargetAddrTable with a transport address mask value
  236.      and a maximum message size value.  The transport address
  237.      mask allows entries in the snmpTargetAddrTable to define
  238.      a set of addresses instead of just a single address.
  239.      The maximum message size value allows the maximum
  240.      message size of another SNMP entity to be configured for
  241.      use in SNMPv1 (and SNMPv2c) transactions, where the
  242.      message format does not specify a maximum message size."
  243.     ::= { snmpCommunityMIBObjects 2 }
  244.  
  245. snmpTargetAddrExtEntry OBJECT-TYPE
  246.     SYNTAX       SnmpTargetAddrExtEntry
  247.     MAX-ACCESS   not-accessible
  248.     STATUS       current
  249.     DESCRIPTION
  250.     "Information about a particular mask and mms value."
  251.     AUGMENTS       { snmpTargetAddrEntry }
  252.     ::= { snmpTargetAddrExtTable 1 }
  253.  
  254. SnmpTargetAddrExtEntry ::= SEQUENCE {
  255.     snmpTargetAddrTMask              OCTET STRING,
  256.     snmpTargetAddrMMS                Integer32
  257. }
  258.  
  259. snmpTargetAddrTMask OBJECT-TYPE
  260.     SYNTAX      OCTET STRING (SIZE (0..255))
  261.     MAX-ACCESS  read-create
  262.     STATUS      current
  263.     DESCRIPTION
  264.     "The mask value associated with an entry in the
  265.      snmpTargetAddrTable.  The value of this object must
  266.      have the same length as the corresponding instance of
  267.      snmpTargetAddrTAddress, or must have length 0.  An
  268.      attempt to set it to any other value will result in
  269.      an inconsistentValue error.
  270.  
  271.      The value of this object allows an entry in the
  272.      snmpTargetAddrTable to specify multiple addresses.
  273.  
  274.      The mask value is used to select which bits of
  275.      a transport address must match bits of the corresponding
  276.      instance of snmpTargetAddrTAddress, in order for the
  277.      transport address to match a particular entry in the
  278.      snmpTargetAddrTable.  Bits which are 1 in the mask
  279.      value indicate bits in the transport address which
  280.      must match bits in the snmpTargetAddrTAddress value.
  281.      Bits which are 0 in the mask indicate bits in the
  282.      transport address which need not match.  If the
  283.      length of the mask is 0, the mask should be treated
  284.      as if all its bits were 1 and its length were equal
  285.      to the length of the corresponding value of
  286.      snmpTargetAddrTable.
  287.  
  288.      This object may not be modified while the value of the
  289.      corresponding instance of snmpTargetAddrRowStatus is
  290.      active(1).  An attempt to set this object in this case
  291.      will result in an inconsistentValue error."
  292.     DEFVAL { ''H }
  293.     ::= { snmpTargetAddrExtEntry 1 }
  294.  
  295. snmpTargetAddrMMS OBJECT-TYPE
  296.     SYNTAX      Integer32 (0|484..2147483647)
  297.     MAX-ACCESS  read-create
  298.     STATUS      current
  299.     DESCRIPTION
  300.     "The maximum message size value associated with an entry
  301.      in the snmpTargetAddrTable."
  302.     DEFVAL { 484 }
  303.     ::= { snmpTargetAddrExtEntry 2 }
  304.  
  305. --
  306. -- The snmpTrapAddress and snmpTrapCommunity objects are included
  307. -- in notifications that are forwarded by a proxy, which were
  308. -- originally received as SNMPv1 Trap messages.
  309. --
  310.  
  311. snmpTrapAddress OBJECT-TYPE
  312.     SYNTAX      IpAddress
  313.     MAX-ACCESS  accessible-for-notify
  314.     STATUS      current
  315.     DESCRIPTION
  316.     "The value of the agent-addr field of a Trap PDU which
  317.      is forwarded by a proxy forwarder application using
  318.      an SNMP version other than SNMPv1.  The value of this
  319.      object SHOULD contain the value of the agent-addr field
  320.      from the original Trap PDU as generated by an SNMPv1
  321.      agent."
  322.     ::= { snmpCommunityMIBObjects 3 }
  323.  
  324. snmpTrapCommunity OBJECT-TYPE
  325.     SYNTAX      OCTET STRING
  326.     MAX-ACCESS  accessible-for-notify
  327.     STATUS      current
  328.     DESCRIPTION
  329.     "The value of the community string field of an SNMPv1
  330.      message containing a Trap PDU which is forwarded by a
  331.      a proxy forwarder application using an SNMP version
  332.      other than SNMPv1.  The value of this object SHOULD
  333.      contain the value of the community string field from
  334.      the original SNMPv1 message containing a Trap PDU as
  335.      generated by an SNMPv1 agent."
  336.     ::= { snmpCommunityMIBObjects 4 }
  337.  
  338. -- Conformance Information *******************************************
  339.  
  340. snmpCommunityMIBCompliances OBJECT IDENTIFIER
  341.                 ::= { snmpCommunityMIBConformance 1 }
  342. snmpCommunityMIBGroups      OBJECT IDENTIFIER
  343.                 ::= { snmpCommunityMIBConformance 2 }
  344.  
  345. -- Compliance statements
  346.  
  347. snmpCommunityMIBCompliance MODULE-COMPLIANCE
  348.     STATUS       current
  349.     DESCRIPTION
  350.     "The compliance statement for SNMP engines which
  351.      implement the SNMP-COMMUNITY-MIB."
  352.  
  353.     MODULE       -- this module
  354.     MANDATORY-GROUPS { snmpCommunityGroup }
  355.  
  356.     OBJECT           snmpCommunityName
  357.     MIN-ACCESS       read-only
  358.     DESCRIPTION     "Write access is not required."
  359.  
  360.     OBJECT           snmpCommunitySecurityName
  361.     MIN-ACCESS       read-only
  362.     DESCRIPTION     "Write access is not required."
  363.  
  364.     OBJECT           snmpCommunityContextEngineID
  365.     MIN-ACCESS       read-only
  366.     DESCRIPTION     "Write access is not required."
  367.  
  368.     OBJECT           snmpCommunityContextName
  369.     MIN-ACCESS       read-only
  370.     DESCRIPTION     "Write access is not required."
  371.  
  372.     OBJECT           snmpCommunityTransportTag
  373.     MIN-ACCESS       read-only
  374.     DESCRIPTION     "Write access is not required."
  375.  
  376.     OBJECT           snmpCommunityStorageType
  377.     MIN-ACCESS       read-only
  378.     DESCRIPTION     "Write access is not required."
  379.  
  380.     OBJECT           snmpCommunityStatus
  381.     MIN-ACCESS       read-only
  382.     DESCRIPTION     "Write access is not required."
  383.  
  384.     ::= { snmpCommunityMIBCompliances 1 }
  385.  
  386. snmpProxyTrapForwardCompliance MODULE-COMPLIANCE
  387.     STATUS       current
  388.     DESCRIPTION
  389.     "The compliance statement for SNMP engines which
  390.      contain a proxy forwarding application which is
  391.      capable of forwarding SNMPv1 traps using SNMPv2c
  392.      or SNMPv3."
  393.     MODULE       -- this module
  394.     MANDATORY-GROUPS { snmpProxyTrapForwardGroup }
  395.     ::= { snmpCommunityMIBCompliances 2 }
  396.  
  397. snmpCommunityGroup OBJECT-GROUP
  398.     OBJECTS {
  399.     snmpCommunityName,
  400.     snmpCommunitySecurityName,
  401.     snmpCommunityContextEngineID,
  402.     snmpCommunityContextName,
  403.     snmpCommunityTransportTag,
  404.     snmpCommunityStorageType,
  405.     snmpCommunityStatus,
  406.     snmpTargetAddrTMask,
  407.     snmpTargetAddrMMS
  408.     }
  409.     STATUS       current
  410.     DESCRIPTION
  411.     "A collection of objects providing for configuration
  412.      of community strings for SNMPv1 (and SNMPv2c) usage."
  413.     ::= { snmpCommunityMIBGroups 1 }
  414.  
  415. snmpProxyTrapForwardGroup OBJECT-GROUP
  416.     OBJECTS {
  417.     snmpTrapAddress,
  418.     snmpTrapCommunity
  419.     }
  420.     STATUS       current
  421.     DESCRIPTION
  422.     "Objects which are used by proxy forwarding applications
  423.      when translating traps between SNMP versions.  These are
  424.      used to preserve SNMPv1-specific information when
  425.      translating to SNMPv2c or SNMPv3."
  426.     ::= { snmpCommunityMIBGroups 3 }
  427.  
  428. END
  429.