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