1OTP-SNMPEA-MIB(7)                     MIB                    OTP-SNMPEA-MIB(7)
2
3
4
5OTP-SNMPEA-MIB DEFINITIONS ::= BEGIN
6
7IMPORTS
8    MODULE-IDENTITY, OBJECT-TYPE,
9    Integer32, IpAddress
10        FROM SNMPv2-SMI
11    DisplayString, RowStatus, StorageType
12        FROM SNMPv2-TC
13    MODULE-COMPLIANCE, OBJECT-GROUP
14        FROM SNMPv2-CONF
15    otpModules, otpApplications
16        FROM OTP-REG
17    ;
18
19otpSnmpeaModule MODULE-IDENTITY
20    LAST-UPDATED  "0305130000Z"
21    ORGANIZATION  "Ericsson"
22    CONTACT-INFO
23        "Contact:  Erlang Support see license agreement for Erlang/OTP."
24    DESCRIPTION
25        "This MIB module defines MIB objects for the SNMPEA
26        component in OTP."
27
28    REVISION    "0305130000Z"
29    DESCRIPTION
30        "Changed CONTACT-INFO as it was outdated, made it more generic
31     to avoid such changes in the future."
32
33    REVISION    "9808280000Z"
34    DESCRIPTION
35        "Since there are standard MIBs in the SNMPv3 framework that
36        implements the functionality defined in this MIB, all objects in
37        this MIB is now obsolete.  There are still a few OID assignments
38        defined in this MIB.
39
40        Removed intCommunityTable; replaced by snmpCommunityTable in
41        SNMP-COMMUNITY-MIB.
42
43        Removed intAddressTable; replaced by SNMP-TARGET-MIB.
44
45     Removed intAgentMaxPacketSize, replaced by snmpEngineMaxPacketSize
46        in SNMP-FRAMEWORK-MIB.
47
48        Removed intAgentIpAddress and intAgentUDPPort.
49
50        Removed intViewTable, replaced by SNMP-VIEW-BASED-ACM-MIB."
51
52    REVISION    "9804160000Z"
53    DESCRIPTION
54        "Updated to support MIBs from SNMPv3.  Since SNMPv3 standardizes
55        some of the functionality provided by this MIB, we're using the
56        standard instead.
57
58        Removed intTrapDestTable; replaced by SNMP-TARGET-MIB and
59     SNMP-NOTIFICATION-MIB."
60
61    REVISION    "9709220900Z"
62    DESCRIPTION
63        "The initial version of this MIB module.  It is the old
64        INTERNAL-MIB renamed."
65    ::= { otpModules 5 }
66
67otpSnmpeaMIB    OBJECT IDENTIFIER ::= { otpApplications 3 }
68otpSnmpeaMIBConformance
69                OBJECT IDENTIFIER ::= { otpSnmpeaMIB 1 }
70otpSnmpeaMIBObjects
71                OBJECT IDENTIFIER ::= { otpSnmpeaMIB 2 }
72
73snmpeaAdm       OBJECT IDENTIFIER ::= { otpSnmpeaMIBObjects 1}
74community       OBJECT IDENTIFIER ::= { snmpeaAdm 1 }
75trap            OBJECT IDENTIFIER ::= { snmpeaAdm 2 }
76view            OBJECT IDENTIFIER ::= { snmpeaAdm 3 }
77
78
79-- Obsolete objects
80
81-- The Administration Group
82--
83-- This group consists of objects to configure the access for
84-- managers to the MIB tree.
85--
86-- These objects were previously defined in INTERNAL-MIB
87
88intCommunityTable OBJECT-TYPE
89    SYNTAX      SEQUENCE OF IntCommunityEntry
90    MAX-ACCESS  not-accessible
91    STATUS      obsolete
92    DESCRIPTION
93        "This table defines access for the different
94        communities.
95
96        When a request comes from a certain ip address,
97        referring to a community string, the mib view
98        and access corresponding to these are looked up
99        in this table. Then the operation is validatated against
100        the access, and all requested objects validated against
101        the mib view."
102    ::= { community 1 }
103
104intCommunityEntry OBJECT-TYPE
105    SYNTAX      IntCommunityEntry
106    MAX-ACCESS  not-accessible
107    STATUS      obsolete
108    DESCRIPTION
109        ""
110    INDEX   { intCommunityDestination, intCommunityString }
111    ::= { intCommunityTable 1 }
112
113IntCommunityEntry ::=
114    SEQUENCE {
115      intCommunityDestination   IpAddress,
116      intCommunityString        DisplayString,
117      intCommunityViewIndex     Integer32,
118      intCommunityAccess        INTEGER,
119      intCommunityStatus        RowStatus
120    }
121
122intCommunityDestination OBJECT-TYPE
123    SYNTAX      IpAddress
124    MAX-ACCESS  not-accessible
125    STATUS      obsolete
126    DESCRIPTION
127        "The ip address of a management station. The special
128        ip address {0.0.0.0} is a wildcard, meaning all possible
129        ip addresses. In this way, access can be granted to all
130        ip addressed for some communities."
131    ::= { intCommunityEntry 1 }
132
133intCommunityString OBJECT-TYPE
134    SYNTAX      DisplayString
135    MAX-ACCESS  not-accessible
136    STATUS      obsolete
137    DESCRIPTION
138        "The community string, defining the community."
139    ::= { intCommunityEntry 2 }
140
141intCommunityViewIndex OBJECT-TYPE
142    SYNTAX      Integer32
143    MAX-ACCESS  read-create
144    STATUS      obsolete
145    DESCRIPTION
146        "Identifies a mib view.  Index into the
147        intViewTable."
148    ::= { intCommunityEntry 3 }
149
150intCommunityAccess OBJECT-TYPE
151    SYNTAX      INTEGER { read(1), readWrite(2) }
152    MAX-ACCESS  read-create
153    STATUS      obsolete
154    DESCRIPTION
155        "Defines which operations the manager can perform
156        on the objects in the mib view."
157    ::= { intCommunityEntry 4 }
158
159intCommunityStatus OBJECT-TYPE
160    SYNTAX      RowStatus
161    MAX-ACCESS  read-create
162    STATUS      obsolete
163    DESCRIPTION
164        "The status of this conceptual row in the
165        intCommunityTable."
166    ::= { intCommunityEntry 5 }
167
168intAgentIpAddress OBJECT-TYPE
169    SYNTAX      IpAddress
170    MAX-ACCESS  read-only
171    STATUS      obsolete
172    DESCRIPTION
173        "The IP address of this agent."
174    ::= { community 2 }
175
176intAgentUDPPort OBJECT-TYPE
177    SYNTAX      Integer32
178    MAX-ACCESS  read-only
179    STATUS      obsolete
180    DESCRIPTION
181        "The UDP port the agent listens to."
182    ::= { community 3 }
183
184intAgentMaxPacketSize OBJECT-TYPE
185    SYNTAX      Integer32 (484..65535)
186    MAX-ACCESS  read-only
187    STATUS      obsolete
188    DESCRIPTION
189        "The maximum packet size in bytes this agent will send to a
190        manager."
191    ::= { community 4 }
192
193
194intAddressTable OBJECT-TYPE
195    SYNTAX      SEQUENCE OF IntAddressEntry
196    MAX-ACCESS  not-accessible
197    STATUS      obsolete
198    DESCRIPTION
199        "This table holds UDP related information on each known
200        management station."
201    ::= { community 5 }
202
203
204intAddressEntry OBJECT-TYPE
205    SYNTAX      IntAddressEntry
206    MAX-ACCESS  not-accessible
207    STATUS      obsolete
208    DESCRIPTION
209        ""
210    INDEX   { intAddressDestination }
211    ::= { intAddressTable 1 }
212
213IntAddressEntry ::=
214    SEQUENCE {
215      intAddressDestination     IpAddress,
216      intAddressUDPPort         Integer32,
217      intAddressMaxPacketSize   Integer32 (484..65535),
218      intAddressStatus          RowStatus
219    }
220
221intAddressDestination OBJECT-TYPE
222    SYNTAX      IpAddress
223    MAX-ACCESS  not-accessible
224    STATUS      obsolete
225    DESCRIPTION
226        "The ip address of the management station."
227    ::= { intAddressEntry 1 }
228
229intAddressUDPPort OBJECT-TYPE
230    SYNTAX      Integer32
231    MAX-ACCESS  read-create
232    STATUS      obsolete
233    DESCRIPTION
234        "The UDP port to which traps will be sent to
235        this destination."
236    DEFVAL { 162 }
237    ::= { intAddressEntry 2 }
238
239intAddressMaxPacketSize OBJECT-TYPE
240    SYNTAX      Integer32 (484..65535)
241    MAX-ACCESS  read-create
242    STATUS      obsolete
243    DESCRIPTION
244        "The maximum packet size in bytes for Messages
245        sent to this destination.  The max size of a packet
246        sent to this destination will be the minumim of
247        this variable and agentMaxPacketSize.0."
248    ::= { intAddressEntry 3 }
249
250intAddressStatus OBJECT-TYPE
251    SYNTAX      RowStatus
252    MAX-ACCESS  read-create
253    STATUS      obsolete
254    DESCRIPTION
255        "The status of this conceptual row in the
256        intAddressTable."
257    ::= { intAddressEntry 4 }
258
259intTrapDestTable OBJECT-TYPE
260    SYNTAX      SEQUENCE OF IntTrapDestEntry
261    MAX-ACCESS  not-accessible
262    STATUS      obsolete
263    DESCRIPTION
264        "The intTrapDestTable defines to which destination all traps
265        for a specific community should be sent."
266    ::= { trap 1 }
267
268intTrapDestEntry OBJECT-TYPE
269    SYNTAX      IntTrapDestEntry
270    MAX-ACCESS  not-accessible
271    STATUS      obsolete
272    DESCRIPTION
273        ""
274    INDEX   { intTrapDestCommunityString, intTrapDestDestination }
275    ::= { intTrapDestTable 1 }
276
277IntTrapDestEntry ::=
278    SEQUENCE {
279      intTrapDestCommunityString    DisplayString,
280      intTrapDestDestination        IpAddress,
281      intTrapDestStatus             RowStatus,
282      intTrapDestSnmpVersion        INTEGER
283    }
284
285intTrapDestCommunityString OBJECT-TYPE
286    SYNTAX      DisplayString (SIZE (0..255))
287    MAX-ACCESS  not-accessible
288    STATUS      obsolete
289    DESCRIPTION
290        ""
291    ::= { intTrapDestEntry 1 }
292
293intTrapDestDestination OBJECT-TYPE
294    SYNTAX      IpAddress
295    MAX-ACCESS  not-accessible
296    STATUS      obsolete
297    DESCRIPTION
298        ""
299    ::= { intTrapDestEntry 2 }
300
301intTrapDestStatus OBJECT-TYPE
302    SYNTAX      RowStatus
303    MAX-ACCESS  read-create
304    STATUS      obsolete
305    DESCRIPTION
306        "The status of this conceptual row in the
307        intTrapDestTable."
308    ::= { intTrapDestEntry 3 }
309
310intTrapDestSnmpVersion OBJECT-TYPE
311    SYNTAX      INTEGER { v1(1), v2(2) }
312    MAX-ACCESS  read-create
313    STATUS      obsolete
314    DESCRIPTION
315        "The SNMP version of the manager.  If it is v1,
316        SNMPv1Traps are sent.  If it is v2, SNMPv2Traps are sent"
317    ::= { intTrapDestEntry 4 }
318
319intViewTable OBJECT-TYPE
320    SYNTAX      SEQUENCE OF IntViewEntry
321    MAX-ACCESS  not-accessible
322    STATUS      obsolete
323    DESCRIPTION
324        "Locally held information about the MIB views
325        known to this agent.
326
327        Each MIB view is defined by two
328        collections of view subtrees: the included view
329        subtrees, and the excluded view subtrees.  Every
330        such subtree, both included and excluded, is
331        defined in this table.
332
333        To determine if a particular object instance is in
334        a particular MIB view, compare the object
335        instance's OBJECT IDENTIFIER with each of the MIB
336        view's entries in this table.  If none match, then
337        the object instance is not in the MIB view.  If
338        one or more match, then the object instance is
339        included in, or excluded from, the MIB view
340        according to the value of viewType in the entry
341        whose value of viewSubtree has the most sub-
342        identifiers.  If multiple entries match and have
343        the same number of sub-identifiers, then the
344        lexicographically greatest instance of viewType
345        determines the inclusion or exclusion.
346
347        An object instance's OBJECT IDENTIFIER X matches
348        an entry in this table when the number of sub-
349        identifiers in X is at least as many as in the
350        value of viewSubtree for the entry, and each sub-
351        identifier in the value of viewSubtree matches its
352        corresponding sub-identifier in X.  Two sub-
353        identifiers match either if the corresponding bit
354        of viewMask is zero (the 'wild card' value), or if
355        they are equal.
356
357        Due to this 'wild card' capability, we introduce
358        the term, a 'family' of view subtrees, to refer to
359        the set of subtrees defined by a particular
360        combination of values of viewSubtree and viewMask.
361        In the case where no 'wild card' is defined in
362        viewMask, the family of view subtrees reduces to a
363        single view subtree."
364    ::= { view 1 }
365
366intViewEntry OBJECT-TYPE
367    SYNTAX      IntViewEntry
368    MAX-ACCESS  not-accessible
369    STATUS      obsolete
370    DESCRIPTION
371        "Information on a particular family of view
372        subtrees included in or excluded from a particular
373        MIB view.
374
375        Implementations must not restrict the number of
376        families of view subtrees for a given MIB view,
377        except as dictated by resource constraints on the
378        overall number of entries in the viewTable."
379    INDEX   { intViewIndex, intViewSubtree }
380    ::= { intViewTable 1 }
381
382IntViewEntry ::=
383    SEQUENCE {
384      intViewIndex          Integer32,
385      intViewSubtree        OBJECT IDENTIFIER,
386      intViewMask           OCTET STRING,
387      intViewType           INTEGER,
388      intViewStorageType    StorageType,
389      intViewStatus         RowStatus
390    }
391
392
393intViewIndex OBJECT-TYPE
394    SYNTAX      Integer32 (1..65535)
395    MAX-ACCESS  not-accessible
396    STATUS      obsolete
397    DESCRIPTION
398        "A unique value for each MIB view.  The value for
399        each MIB view must remain constant at least from
400        one re-initialization of the entity's network
401        management system to the next re-initialization."
402    ::= { intViewEntry 1 }
403
404intViewSubtree OBJECT-TYPE
405    SYNTAX      OBJECT IDENTIFIER
406    MAX-ACCESS  not-accessible
407    STATUS      obsolete
408    DESCRIPTION
409        "A MIB subtree."
410    ::= { intViewEntry 2 }
411
412intViewMask OBJECT-TYPE
413    SYNTAX      OCTET STRING (SIZE (0..16))
414    MAX-ACCESS  read-create
415    STATUS      obsolete
416    DESCRIPTION
417        "The bit mask which, in combination with the
418        corresponding instance of viewSubtree, defines a
419        family of view subtrees.
420
421        Each bit of this bit mask corresponds to a sub-
422        identifier of viewSubtree, with the most
423        significant bit of the i-th octet of this octet
424        string value (extended if necessary, see below)
425        corresponding to the (8*i - 7)-th sub-identifier,
426        and the least significant bit of the i-th octet of
427        this octet string corresponding to the (8*i)-th
428        sub-identifier, where i is in the range 1 through
429        16.
430
431        Each bit of this bit mask specifies whether or not
432        the corresponding sub-identifiers must match when
433        determining if an OBJECT IDENTIFIER is in this
434        family of view subtrees; a '1' indicates that an
435        exact match must occur; a '0' indicates 'wild
436        card', i.e., any sub-identifier value matches.
437
438
439        Thus, the OBJECT IDENTIFIER X of an object
440        instance is contained in a family of view subtrees
441        if the following criteria are met:
442
443               for each sub-identifier of the value of
444               viewSubtree, either:
445
446                the i-th bit of viewMask is 0, or
447
448                the i-th sub-identifier of X is equal to
449                the i-th sub-identifier of the value of
450                viewSubtree.
451
452        If the value of this bit mask is M bits long and
453        there are more than M sub-identifiers in the
454        corresponding instance of viewSubtree, then the
455        bit mask is extended with 1's to be the required
456        length.
457
458        Note that when the value of this object is the
459        zero-length string, this extension rule results in
460        a mask of all-1's being used (i.e., no 'wild
461        card'), and the family of view subtrees is the one
462        view subtree uniquely identified by the
463        corresponding instance of viewSubtree."
464    DEFVAL      { ''H }
465    ::= { intViewEntry 3 }
466
467
468intViewType OBJECT-TYPE
469    SYNTAX      INTEGER {
470        included(1),
471        excluded(2)
472        }
473    MAX-ACCESS  read-create
474    STATUS      obsolete
475    DESCRIPTION
476        "The status of a particular family of view
477        subtrees within the particular
478        MIB view.  The value 'included(1)' indicates that
479        the corresponding instances of viewSubtree and
480        viewMask define a family of view subtrees included
481        in the MIB view.  The  value 'excluded(2)'
482        indicates that the corresponding instances of
483        viewSubtree and viewMask define a family of view
484        subtrees excluded from the MIB view."
485    DEFVAL      { included }
486    ::= { intViewEntry 4 }
487
488intViewStorageType OBJECT-TYPE
489    SYNTAX      StorageType
490    MAX-ACCESS  read-create
491    STATUS      obsolete
492    DESCRIPTION
493        "The storage type for this conceptual row in the
494        intViewTable."
495    DEFVAL      { nonVolatile }
496    ::= { intViewEntry 5 }
497
498intViewStatus OBJECT-TYPE
499    SYNTAX      RowStatus
500    MAX-ACCESS  read-create
501    STATUS      obsolete
502    DESCRIPTION
503        "The status of this conceptual row in the
504        intViewTable."
505    ::= { intViewEntry 6 }
506
507-- conformance information
508
509otpSnmpeaMIBCompliances
510                OBJECT IDENTIFIER ::= { otpSnmpeaMIBConformance 1 }
511otpSnmpeaMIBGroups
512                OBJECT IDENTIFIER ::= { otpSnmpeaMIBConformance 2 }
513
514
515-- compliance statements
516
517otpSnmpeaBasicCompliance MODULE-COMPLIANCE
518    STATUS  obsolete
519    DESCRIPTION
520        "The compliance statement for SNMPv2 entities which
521        implement the OTP-SNMPEA-MIB."
522    MODULE  -- this module
523        MANDATORY-GROUPS { addressGroup }
524    ::= { otpSnmpeaMIBCompliances 1 }
525
526
527-- units of conformance
528
529communityGroup OBJECT-GROUP
530    OBJECTS { intCommunityViewIndex,
531              intCommunityAccess,
532              intCommunityStatus }
533    STATUS  obsolete
534    DESCRIPTION
535        "A collection of objects providing basic instrumentation
536        of the load of the OTP system."
537    ::= { otpSnmpeaMIBGroups 1 }
538
539addressGroup OBJECT-GROUP
540    OBJECTS { intAgentIpAddress,
541              intAgentUDPPort,
542              intAgentMaxPacketSize,
543              intAddressUDPPort,
544              intAddressMaxPacketSize,
545              intAddressStatus }
546    STATUS  obsolete
547    DESCRIPTION
548        "A collection of objects providing basic instrumentation
549        of the load of the OTP system."
550    ::= { otpSnmpeaMIBGroups 2 }
551
552trapGroup OBJECT-GROUP
553    OBJECTS { intTrapDestStatus,
554              intTrapDestSnmpVersion }
555    STATUS  obsolete
556    DESCRIPTION
557        "A collection of objects providing basic instrumentation
558        of the load of the OTP system."
559    ::= { otpSnmpeaMIBGroups 3 }
560
561viewGroup OBJECT-GROUP
562    OBJECTS { intViewMask,
563              intViewType,
564              intViewStorageType,
565              intViewStatus }
566    STATUS  obsolete
567    DESCRIPTION
568        "A collection of objects providing basic instrumentation
569        of the load of the OTP system."
570    ::= { otpSnmpeaMIBGroups 4 }
571
572
573END
574
575
576
577
578Erlang/OTP                           SNMP                    OTP-SNMPEA-MIB(7)
Impressum