1RMON2-MIB DEFINITIONS ::= BEGIN
2IMPORTS
3    MODULE-IDENTITY, OBJECT-TYPE, Counter32, Integer32,
4    Gauge32, IpAddress, TimeTicks, mib-2         FROM SNMPv2-SMI
5    TEXTUAL-CONVENTION, RowStatus, DisplayString, TimeStamp
6                                                 FROM SNMPv2-TC
7    MODULE-COMPLIANCE, OBJECT-GROUP              FROM SNMPv2-CONF
8    ifIndex                                      FROM IF-MIB
9    OwnerString, statistics, history, hosts,
10    matrix, filter, etherStatsEntry, historyControlEntry,
11    hostControlEntry, matrixControlEntry, filterEntry,
12    channelEntry                    FROM RMON-MIB
13    tokenRing, tokenRingMLStatsEntry, tokenRingPStatsEntry,
14    ringStationControlEntry, sourceRoutingStatsEntry
15                                    FROM TOKEN-RING-RMON-MIB;
16--  Remote Network Monitoring MIB
17
18rmon MODULE-IDENTITY
19    LAST-UPDATED "200605020000Z"    -- May 2, 2006
20    ORGANIZATION "IETF RMON MIB Working Group"
21    CONTACT-INFO
22        "Author:
23                     Steve Waldbusser
24             Phone:  +1-650-948-6500
25             Fax :   +1-650-745-0671
26             Email:  waldbusser@nextbeacon.com
27
28         Working Group Chair:
29                     Andy Bierman
30             E-mail: ietf@andybierman.com
31
32         Working Group Mailing List: <rmonmib@ietf.org>
33         To subscribe send email to: <rmonmib-request@ietf.org>    "
34    DESCRIPTION
35        "The MIB module for managing remote monitoring
36         device implementations.  This MIB module
37         extends the architecture introduced in the original
38         RMON MIB as specified in RFC 2819.
39
40         Copyright (C) The Internet Society (2006).  This version of
41         this MIB module is part of RFC 4502;  see the RFC itself for
42         full legal notices."
43
44    REVISION "200605020000Z"    -- May 2, 2006
45    DESCRIPTION
46        "This version updates the proposed-standard version of the
47        RMON2 MIB (published as RFC 2021) by adding 2 new
48        enumerations to the nlMatrixTopNControlRateBase object and
49        4 new enumerations to the alMatrixTopNControlRateBase object.
50        These new enumerations support the creation of high-capacity
51        topN reports in the High Capacity RMON MIB [RFC3273].
52
53        Additionally, the following objects have been deprecated, as
54        they have not had enough independent implementations to
55        demonstrate interoperability to meet the requirements of a
56        Draft Standard:
57
58        probeDownloadFile
59        probeDownloadTFTPServer
60        probeDownloadAction
61        probeDownloadStatus
62
63        serialMode
64        serialProtocol
65        serialTimeout
66        serialModemInitString
67        serialModemHangUpString
68        serialModemConnectResp
69        serialModemNoConnectResp
70        serialDialoutTimeout
71        serialStatus
72        serialConnectDestIpAddress
73        serialConnectType
74        serialConnectDialString
75        serialConnectSwitchConnectSeq
76        serialConnectSwitchDisconnectSeq
77        serialConnectSwitchResetSeq
78        serialConnectOwner
79        serialConnectStatus
80        netConfigIPAddress
81        netConfigSubnetMask
82        netConfigStatus
83        netDefaultGateway
84        tokenRingMLStats2DroppedFrames
85        tokenRingMLStats2CreateTime
86        tokenRingPStats2DroppedFrames
87        tokenRingPStats2CreateTime
88        ringStationControl2DroppedFrames
89        ringStationControl2CreateTime
90        sourceRoutingStats2DroppedFrames
91        sourceRoutingStats2CreateTime
92        trapDestIndex
93        trapDestCommunity
94        trapDestProtocol
95        trapDestAddress
96        trapDestOwner
97        trapDestStatus
98
99        In addition, two corrections were made.  The LastCreateTime
100        Textual Convention had been defined with a base type of
101        another textual convention, which isn't allowed in SMIv2.  The
102        definition has been modified to use TimeTicks as the base
103        type.
104
105        Further, the SerialConfigEntry SEQUENCE definition included
106        sub-typing information that is not allowed in SMIv2.  This
107        information has been deleted.  Ranges were added to a number of
108        objects and textual-conventions to constrain their maximum
109        (and sometimes minimum) sizes.  The addition of these ranges
110        documents existing practice for these objects.  These objects
111
112        are:
113            ControlString
114            protocolDirID
115            protocolDirParameters
116            addressMapNetworkAddress
117            nlHostAddress
118            nlMatrixSDSourceAddress
119            nlMatrixSDDestAddress
120            nlMatrixDSSourceAddress
121            nlMatrixDSDestAddress
122            nlMatrixTopNSourceAddress
123            nlMatrixTopNDestAddress
124            alHostEntry
125            alMatrixSDEntry
126            alMatrixDSEntry
127            alMatrixTopNSourceAddress
128            alMatrixTopNDestAddress
129
130        Finally, the TimeFilter TC has been updated to encourage agent
131        implementations that allow a MIB walk to behave well even when
132        performed by an application that is not aware of the special
133        TimeFilter semantics."
134
135    REVISION "200207080000Z"        -- 08 July, 2002
136    DESCRIPTION
137        "Added new enumerations to support the High-Capacity RMON
138        MIB as defined in RFC 3273.  Also fixed some typos and
139        added clarifications."
140
141    REVISION "199605270000Z"    -- 27 May, 1996
142    DESCRIPTION
143        "Original version.  Published as RFC 2021."
144    ::= { mib-2 16 }
145
146-- { rmon 1 } through { rmon 10 } are defined in RMON and
147-- the Token Ring RMON MIB [RFC1513]
148
149    protocolDir     OBJECT IDENTIFIER ::= { rmon 11 }
150    protocolDist    OBJECT IDENTIFIER ::= { rmon 12 }
151    addressMap      OBJECT IDENTIFIER ::= { rmon 13 }
152    nlHost          OBJECT IDENTIFIER ::= { rmon 14 }
153    nlMatrix        OBJECT IDENTIFIER ::= { rmon 15 }
154    alHost          OBJECT IDENTIFIER ::= { rmon 16 }
155    alMatrix        OBJECT IDENTIFIER ::= { rmon 17 }
156    usrHistory      OBJECT IDENTIFIER ::= { rmon 18 }
157    probeConfig     OBJECT IDENTIFIER ::= { rmon 19 }
158    rmonConformance OBJECT IDENTIFIER ::= { rmon 20 }
159
160-- Textual Conventions
161
162ZeroBasedCounter32 ::= TEXTUAL-CONVENTION
163    STATUS current
164    DESCRIPTION
165        "This TC describes an object that counts events with the
166        following semantics: objects of this type will be set to
167        zero(0) on creation and will thereafter count appropriate
168        events, wrapping back to zero(0) when the value 2^32 is
169        reached.
170
171        Provided that an application discovers the new object within
172        the minimum time to wrap, it can use the initial value as a
173        delta since it last polled the table of which this object is
174        part.  It is important for a management station to be aware of
175        this minimum time and the actual time between polls, and to
176        discard data if the actual time is too long or there is no
177        defined minimum time.
178
179        Typically, this TC is used in tables where the INDEX space is
180        constantly changing and/or the TimeFilter mechanism is in use."
181    SYNTAX Gauge32
182
183LastCreateTime ::= TEXTUAL-CONVENTION
184    STATUS current
185    DESCRIPTION
186        "This TC describes an object that stores the value of the
187        sysUpTime object at the last time its entry was created.
188
189        This can be used for polling applications to determine that an
190        entry has been deleted and re-created between polls, causing
191        an otherwise undetectable discontinuity in the data.
192
193        If sysUpTime is reset to zero as a result of a re-
194        initialization of the network management (sub)system, then
195        the values of all LastCreateTime objects are also reset.
196        However, after approximately 497 days without a re-
197        initialization, the sysUpTime object will reach 2^^32-1 and
198        then increment to zero; in this case, existing values
199        of TimeStamp objects do not change.  This can lead to
200        ambiguities in the value of TimeStamp objects."
201    SYNTAX TimeTicks
202
203TimeFilter ::= TEXTUAL-CONVENTION
204  STATUS        current
205  DESCRIPTION
206      "To be used for the index to a table.  Allows an application
207      to download only those rows changed since a particular time.
208
209      Note that this is not a history mechanism.  Only current values
210      of underlying objects are returned; saved instance values
211      associated with particular values of sysUpTime are not.
212
213      An entry is considered changed if the value of any object in the
214      entry changes, if the row is created, or if any object in the
215      entry is created or deleted.  Note that deleted entries cannot
216      be detected or downloaded.
217
218      A time-filtered conceptual table is created by inserting a
219      single object of SYNTAX TimeFilter as the first INDEX component
220      in a copy of an existing basic conceptual table (i.e., any
221      SEQUENCE without a TimeFilter INDEX component).  Thus, for
222      each conceptual entry 'I' in the basic table, there exists N
223      conceptual entries in the time-filtered version, indexed N.I,
224      where 'N' is equal to the value of sysUpTime.
225
226      When an application retrieves conceptual instances from a
227      time-filtered table, and an INDEX value is provided for the
228      TimeFilter INDEX component 'N', the agent will only consider
229      returning basic conceptual entries (e.g., 'fooColumn.N.I') if
230      any column within the basic conceptual entry has changed since
231      sysUpTime 'N'.  If not, the basic conceptual entry will
232      be ignored for the particular retrieval operation.
233
234      When sysUpTime is equal to zero, this table shall be empty.
235
236      One conceptual entry exists for each past value of sysUpTime,
237      except that the whole table is purged should sysUpTime wrap.
238
239      As an entry in a time-filtered table is updated (i.e., one of
240      the columns in the basic conceptual table is changed), new
241      conceptual entries are also created in the time-filtered version
242      (which still shares the now updated object values with all other
243      instances).  The number of unique time-filtered instances that
244      are created is determined by the value of sysUpTime at which the
245      basic entry was last updated.  One unique instance will exist
246      for each value of sysUpTime at the last update time for the row.
247      However, a new TimeFilter index instance is created for each new
248      sysUpTime value.  The TimeFilter index values not associated
249      with entry updates are called duplicate time-filtered instances.
250
251      After some deployment experience, it has been determined that
252      a time-filtered table is more efficient if the agent
253      stops a MIB walk operation by skipping over rows with a
254      TimeFilter index value higher than the value in the received
255      GetNext/GetBulk request.  That is, instead of incrementing a
256      TimeFilter index value, the agent will continue to the next
257
258      object or table.  As a consequence, GetNext or GetBulk
259      operations will provide only one pass through a time-filtered
260      table.
261
262      It is suggested that an agent implement a time-filtered table
263      in this manner to improve performance and avoid a MIB walk
264      getting stuck in time-filtered tables.  It is, however, still
265      acceptable for an agent to implement a time-filtered table in
266      the traditional manner (i.e., every conceptual time-filtered
267      instance is returned in GetNext and GetBulk PDU responses), and
268      management applications must be able to deal with such
269      traditional implementations.
270
271      See the appendix for further discussion of this textual
272      convention.
273
274      The following example is provided to demonstrate TimeFilter
275      behavior:
276
277      Consider the following basic conceptual table, basicFooTable.
278      (Note that the basic version of a time-filtered table may not
279      actually be defined.)
280
281          basicFooTable:
282
283          basicFooTable ...
284          INDEX { fooIndex }
285
286          BasicFooEntry {
287             fooIndex     Integer32,
288             fooCounts    Counter32
289          }
290
291      For this example, the basicFooTable contains two static
292      conceptual entries (fooIndex equals '1' and '2'), created at
293      time zero.  It also contains one dynamic conceptual entry
294      (fooIndex equals '3'), which is created at time '3' and deleted
295      at time '7'.
296
297      The time-filtered version of the basicFooTable could be defined
298      as follows:
299
300          FooTable:
301
302          fooTable ...
303          INDEX { fooTimeMark, fooIndex }
304
305          FooEntry {
306
307             fooTimeMark  TimeFilter,
308             fooIndex     Integer32,
309             fooCounts    Counter32
310          }
311
312      Note that entries exist in the time-filtered conceptual table
313      only if they actually exist in the underlying (basic) table.
314
315      For this example, the fooTable will have three underlying
316      basic entries (fooIndex == 1, 2, and 3), with the following
317      activity (for sysUpTime equal 0 to 9):
318
319         - fooEntry.N.1 is created at time '0' and most recently
320           updated at time '6' to the value '5'.
321         - fooEntry.N.2 is created at time '0' and most recently
322           updated at time '8' to the value '9'.
323         - fooEntry.N.3 is created at time '3', updated at time '5'
324           to the value '17', and deleted at time '7'.
325
326     The following tables show the values that would be returned for
327     MIB walk operations with various TimeFilter values, done at
328     different times.  An application issues a retrieval request at
329     time 'T', with a TimeFilter value, 'N' (typically set to a lower
330     value, such as the value of sysUpTime at the last polling cycle).
331
332     The following values would be returned in a MIB walk of
333     fooCounts.N if T equals '0' and N equals '0':
334
335           fooCounts.N.I    Value
336           ==========================
337           fooCounts.0.1    0
338           fooCounts.0.2    0
339
340       Note that nothing is returned for fooCounts.0.3, since that
341       entry does not exist at sysUpTime equals '0'.
342
343     The following values would be returned in a full (traditional) MIB
344     walk of fooCounts.N if T equals '3' and N equals '0':
345
346           fooCounts.N.I    Value
347           =======================
348           fooCounts.0.1    0
349           fooCounts.0.2    0
350           fooCounts.0.3    0
351           fooCounts.1.3    0
352           fooCounts.2.3    0
353           fooCounts.3.3    0
354
355       Note that there are no instances for T equals 1 or 2 for the
356       first two values of N, as these entries did not change
357       since they were created at time '0'.
358
359       Note that the current value for 'fooCounts.N.3' is returned
360       here, even for values of N less than '3' (when the entry was
361       created).  The agent only considers the current existence of an
362       entry in the TimeFilter algorithm, not the time when the entry
363       was created.
364
365       Note that the instances 'fooCounts.0.3', 'fooCounts.1.3',
366       and 'fooCounts.2.3' are duplicates and can be suppressed by the
367       agent in a MIB walk.
368
369     The following values would be returned in a full (traditional)
370     MIB walk of fooCounts.N if T equals '6' and N equals '3':
371
372           fooCounts.N.I    Value
373           =======================
374           fooCounts.3.1    5
375           fooCounts.3.3    17
376           fooCounts.4.1    5
377           fooCounts.4.3    17
378           fooCounts.5.1    5
379           fooCounts.5.3    17
380           fooCounts.6.1    5
381
382        Note that no instances for entry 'fooCounts.N.2' are returned,
383        since it has not changed since time '3'.
384
385        Note that all instances except 'fooCounts.5.3' and
386        'fooCounts.6.1' are duplicates and can be suppressed by the
387        agent in a MIB walk.
388
389     The following values would be returned in a full (traditional)
390     MIB walk of fooCounts.N if T equals '9' and N equals '6':
391
392           fooCounts.N.I    Value
393           =======================
394           fooCounts.6.1    5
395           fooCounts.6.2    9
396           fooCounts.7.2    9
397           fooCounts.8.2    9
398
399        Note that no instances for entry 'fooCounts.N.3' are returned,
400        since it was deleted at time '7'.
401
402        Note that instances 'fooCounts.6.2' and 'fooCounts.7.2'
403
404        are duplicates and can be suppressed by the agent in a MIB
405        walk."
406  SYNTAX    TimeTicks
407
408DataSource ::= TEXTUAL-CONVENTION
409    STATUS        current
410    DESCRIPTION
411        "Identifies the source of the data that the associated
412        function is configured to analyze.  This source can be any
413        interface on this device.
414
415        In order to identify a particular interface, this
416        object shall identify the instance of the ifIndex
417        object, defined in [RFC2863], for the desired interface.
418
419        For example, if an entry were to receive data from
420        interface #1, this object would be set to ifIndex.1."
421    SYNTAX      OBJECT IDENTIFIER
422
423--
424-- Protocol Directory Group
425--
426-- Lists the inventory of protocols the probe has the capability of
427-- monitoring and allows the addition, deletion, and configuration of
428-- entries in this list.
429
430protocolDirLastChange OBJECT-TYPE
431    SYNTAX      TimeStamp
432    MAX-ACCESS  read-only
433    STATUS      current
434    DESCRIPTION
435        "The value of sysUpTime at the time the protocol directory
436        was last modified, either through insertions or deletions,
437        or through modifications of the
438        protocolDirAddressMapConfig, protocolDirHostConfig, or
439        protocolDirMatrixConfig."
440    ::= { protocolDir 1 }
441
442protocolDirTable OBJECT-TYPE
443    SYNTAX      SEQUENCE OF ProtocolDirEntry
444    MAX-ACCESS  not-accessible
445    STATUS      current
446    DESCRIPTION
447        "This table lists the protocols that this agent has the
448        capability to decode and count.  There is one entry in this
449        table for each such protocol.  These protocols represent
450        different network-layer, transport-layer, and higher-layer
451
452        protocols.  The agent should boot up with this table
453        preconfigured with those protocols that it knows about and
454        wishes to monitor.  Implementations are strongly encouraged to
455        support protocols higher than the network layer (at least for
456        the protocol distribution group), even for implementations
457        that don't support the application-layer groups."
458    ::= { protocolDir 2 }
459
460protocolDirEntry OBJECT-TYPE
461    SYNTAX      ProtocolDirEntry
462    MAX-ACCESS  not-accessible
463    STATUS      current
464    DESCRIPTION
465        "A conceptual row in the protocolDirTable.
466
467         An example of the indexing of this entry is
468         protocolDirLocalIndex.8.0.0.0.1.0.0.8.0.2.0.0, which is the
469         encoding of a length of 8, followed by 8 subids encoding the
470         protocolDirID of 1.2048, followed by a length of 2 and the
471         2 subids encoding zero-valued parameters.
472
473         Note that some combinations of index values may result in an
474         index that exceeds 128 sub-identifiers in length, which exceeds
475         the maximum for the SNMP protocol.  Implementations should take
476         care to avoid such combinations."
477    INDEX { protocolDirID, protocolDirParameters }
478    ::= { protocolDirTable  1 }
479
480ProtocolDirEntry ::= SEQUENCE {
481    protocolDirID                   OCTET STRING,
482    protocolDirParameters           OCTET STRING,
483    protocolDirLocalIndex           Integer32,
484    protocolDirDescr                DisplayString,
485    protocolDirType                 BITS,
486    protocolDirAddressMapConfig     INTEGER,
487    protocolDirHostConfig           INTEGER,
488    protocolDirMatrixConfig         INTEGER,
489    protocolDirOwner                OwnerString,
490    protocolDirStatus               RowStatus
491}
492
493protocolDirID OBJECT-TYPE
494    SYNTAX      OCTET STRING  (SIZE (4..128))
495    MAX-ACCESS  not-accessible
496    STATUS      current
497    DESCRIPTION
498        "A unique identifier for a particular protocol.  Standard
499        identifiers will be defined in such a manner that they
500
501        can often be used as specifications for new protocols - i.e.,
502        a tree-structured assignment mechanism that matches the
503        protocol encapsulation 'tree' and that has algorithmic
504        assignment mechanisms for certain subtrees.  See RFC 2074 for
505        more details.
506
507        Despite the algorithmic mechanism, the probe will only place
508        entries in here for those protocols it chooses to collect.  In
509        other words, it need not populate this table with all
510        possible ethernet protocol types, nor need it create them on
511        the fly when it sees them.  Whether it does these
512        things is a matter of product definition (cost/benefit,
513        usability) and is up to the designer of the product.
514
515        If an entry is written to this table with a protocolDirID that
516        the agent doesn't understand, either directly or
517        algorithmically, the SET request will be rejected with an
518        inconsistentName or badValue (for SNMPv1) error."
519    ::= { protocolDirEntry 1 }
520
521protocolDirParameters OBJECT-TYPE
522    SYNTAX      OCTET STRING (SIZE (1..32))
523    MAX-ACCESS  not-accessible
524    STATUS      current
525    DESCRIPTION
526        "A set of parameters for the associated protocolDirID.
527        See the associated RMON2 Protocol Identifiers document
528        for a description of the possible parameters.  There
529        will be one octet in this string for each sub-identifier in
530        the protocolDirID, and the parameters will appear here in the
531        same order as the associated sub-identifiers appear in the
532        protocolDirID.
533
534        Every node in the protocolDirID tree has a different, optional
535        set of parameters defined (that is, the definition of
536        parameters for a node is optional).  The proper parameter
537        value for each node is included in this string.  Note that the
538        inclusion of a parameter value in this string for each node is
539        not optional.  What is optional is that a node may have no
540        parameters defined, in which case the parameter field for that
541        node will be zero."
542    ::= { protocolDirEntry 2 }
543
544protocolDirLocalIndex OBJECT-TYPE
545    SYNTAX      Integer32 (1..2147483647)
546    MAX-ACCESS  read-only
547    STATUS      current
548    DESCRIPTION
549        "The locally arbitrary but unique identifier associated
550        with this protocolDir entry.
551
552        The value for each supported protocol must remain constant at
553        least from one re-initialization of the entity's network
554        management system to the next re-initialization, except that
555        if a protocol is deleted and re-created, it must be re-created
556        with a new value that has not been used since the last
557        re-initialization.
558
559        The specific value is meaningful only within a given SNMP
560        entity.  A protocolDirLocalIndex must not be re-used until the
561        next agent restart in the event that the protocol directory
562        entry is deleted."
563    ::= { protocolDirEntry 3 }
564
565protocolDirDescr OBJECT-TYPE
566    SYNTAX      DisplayString (SIZE (1..64))
567    MAX-ACCESS  read-create
568    STATUS      current
569    DESCRIPTION
570        "A textual description of the protocol encapsulation.
571        A probe may choose to describe only a subset of the
572        entire encapsulation (e.g., only the highest layer).
573
574        This object is intended for human consumption only.
575
576        This object may not be modified if the associated
577        protocolDirStatus object is equal to active(1)."
578    ::= { protocolDirEntry 4 }
579
580protocolDirType OBJECT-TYPE
581    SYNTAX      BITS {
582                    extensible(0),
583                    addressRecognitionCapable(1)
584                }
585    MAX-ACCESS  read-only
586    STATUS      current
587    DESCRIPTION
588        "This object describes 2 attributes of this protocol
589         directory entry.
590
591         The presence or absence of the 'extensible' bit describes
592         whether this protocol directory entry can be extended
593         by the user by creating protocol directory entries that are
594         children of this protocol.
595
596         An example of an entry that will often allow extensibility is
597
598         'ip.udp'.  The probe may automatically populate some children
599         of this node, such as 'ip.udp.snmp' and 'ip.udp.dns'.
600         A probe administrator or user may also populate additional
601         children via remote SNMP requests that create entries in this
602         table.  When a child node is added for a protocol for which the
603         probe has no built-in support extending a parent node (for
604         which the probe does have built-in support),
605         that child node is not extendable.  This is termed 'limited
606         extensibility'.
607
608         When a child node is added through this extensibility
609         mechanism, the values of protocolDirLocalIndex and
610         protocolDirType shall be assigned by the agent.
611
612         The other objects in the entry will be assigned by the
613         manager who is creating the new entry.
614
615         This object also describes whether this agent can
616         recognize addresses for this protocol, should it be a
617         network-level protocol.  That is, while a probe may be able
618         to recognize packets of a particular network-layer protocol
619         and count them, it takes additional logic to be able to
620         recognize the addresses in this protocol and to populate
621         network-layer or application-layer tables with the addresses
622         in this protocol.  If this bit is set, the agent will
623         recognize network-layer addresses for this protocol and
624         populate the network- and application-layer host and matrix
625         tables with these protocols.
626
627         Note that when an entry is created, the agent will supply
628         values for the bits that match the capabilities of the agent
629         with respect to this protocol.  Note that since row creations
630         usually exercise the limited extensibility feature, these
631         bits will usually be set to zero."
632    ::= { protocolDirEntry 5 }
633
634protocolDirAddressMapConfig OBJECT-TYPE
635    SYNTAX      INTEGER {
636                    notSupported(1),
637                    supportedOff(2),
638                    supportedOn(3)
639                }
640    MAX-ACCESS  read-create
641    STATUS      current
642    DESCRIPTION
643        "This object describes and configures the probe's support for
644        address mapping for this protocol.  When the probe creates
645        entries in this table for all protocols that it understands,
646        it will set the entry to notSupported(1) if it doesn't have
647        the capability to perform address mapping for the protocol or
648        if this protocol is not a network-layer protocol.  When
649        an entry is created in this table by a management operation as
650        part of the limited extensibility feature, the probe must set
651        this value to notSupported(1), because limited extensibility
652        of the protocolDirTable does not extend to interpreting
653        addresses of the extended protocols.
654
655        If the value of this object is notSupported(1), the probe
656        will not perform address mapping for this protocol and
657        shall not allow this object to be changed to any other value.
658        If the value of this object is supportedOn(3), the probe
659        supports address mapping for this protocol and is configured
660        to perform address mapping for this protocol for all
661        addressMappingControlEntries and all interfaces.
662        If the value of this object is supportedOff(2), the probe
663        supports address mapping for this protocol but is configured
664        to not perform address mapping for this protocol for any
665        addressMappingControlEntries and all interfaces.
666        Whenever this value changes from supportedOn(3) to
667        supportedOff(2), the probe shall delete all related entries in
668        the addressMappingTable."
669    ::= { protocolDirEntry 6 }
670
671protocolDirHostConfig OBJECT-TYPE
672    SYNTAX      INTEGER {
673                    notSupported(1),
674                    supportedOff(2),
675                    supportedOn(3)
676                }
677    MAX-ACCESS  read-create
678    STATUS      current
679    DESCRIPTION
680        "This object describes and configures the probe's support for
681        the network-layer and application-layer host tables for this
682        protocol.  When the probe creates entries in this table for
683        all protocols that it understands, it will set the entry to
684        notSupported(1) if it doesn't have the capability to track the
685        nlHostTable for this protocol or if the alHostTable is
686        implemented but doesn't have the capability to track this
687        protocol.  Note that if the alHostTable is implemented, the
688        probe may only support a protocol if it is supported in both
689        the nlHostTable and the alHostTable.
690
691        If the associated protocolDirType object has the
692        addressRecognitionCapable bit set, then this is a network-
693        layer protocol for which the probe recognizes addresses, and
694
695        thus the probe will populate the nlHostTable and alHostTable
696        with addresses it discovers for this protocol.
697
698        If the value of this object is notSupported(1), the probe
699        will not track the nlHostTable or alHostTable for this
700        protocol and shall not allow this object to be changed to any
701        other value.  If the value of this object is supportedOn(3),
702        the probe supports tracking of the nlHostTable and alHostTable
703        for this protocol and is configured to track both tables
704        for this protocol for all control entries and all interfaces.
705        If the value of this object is supportedOff(2), the probe
706        supports tracking of the nlHostTable and alHostTable for this
707        protocol but is configured to not track these tables
708        for any control entries or interfaces.
709        Whenever this value changes from supportedOn(3) to
710        supportedOff(2), the probe shall delete all related entries in
711        the nlHostTable and alHostTable.
712
713        Note that since each alHostEntry references 2 protocol
714        directory entries, one for the network address and one for the
715        type of the highest protocol recognized, an entry will
716        only be created in that table if this value is supportedOn(3)
717        for both protocols."
718    ::= { protocolDirEntry 7 }
719
720protocolDirMatrixConfig OBJECT-TYPE
721    SYNTAX      INTEGER {
722                    notSupported(1),
723                    supportedOff(2),
724                    supportedOn(3)
725                }
726    MAX-ACCESS  read-create
727    STATUS      current
728    DESCRIPTION
729        "This object describes and configures the probe's support for
730        the network-layer and application-layer matrix tables for this
731        protocol.  When the probe creates entries in this table for
732        all protocols that it understands, it will set the entry to
733        notSupported(1) if it doesn't have the capability to track the
734        nlMatrixTables for this protocol or if the alMatrixTables are
735        implemented but don't have the capability to track this
736        protocol.  Note that if the alMatrix tables are implemented,
737        the probe may only support a protocol if it is supported in
738        both of the nlMatrixTables and both of the
739        alMatrixTables.
740
741        If the associated protocolDirType object has the
742        addressRecognitionCapable bit set, then this is a network-
743
744        layer protocol for which the probe recognizes addresses, and
745        thus the probe will populate both of the nlMatrixTables and
746        both of the alMatrixTables with addresses it discovers for
747        this protocol.
748
749        If the value of this object is notSupported(1), the probe
750        will not track either of the nlMatrixTables or the
751        alMatrixTables for this protocol and shall not allow this
752        object to be changed to any other value.  If the value of this
753        object is supportedOn(3), the probe supports tracking of both
754        of the nlMatrixTables and (if implemented) both of the
755        alMatrixTables for this protocol and is configured to track
756        these tables for this protocol for all control entries and all
757        interfaces.  If the value of this object is supportedOff(2),
758        the probe supports tracking of both of the nlMatrixTables and
759        (if implemented) both of the alMatrixTables for this protocol
760        but is configured to not track these tables for this
761        protocol for any control entries or interfaces.
762        Whenever this value changes from supportedOn(3) to
763        supportedOff(2), the probe shall delete all related entries in
764        the nlMatrixTables and the alMatrixTables.
765
766        Note that since each alMatrixEntry references 2 protocol
767        directory entries, one for the network address and one for the
768        type of the highest protocol recognized, an entry will
769        only be created in that table if this value is supportedOn(3)
770        for both protocols."
771    ::= { protocolDirEntry 8 }
772
773protocolDirOwner OBJECT-TYPE
774    SYNTAX      OwnerString
775    MAX-ACCESS  read-create
776    STATUS      current
777    DESCRIPTION
778        "The entity that configured this entry and is
779        therefore using the resources assigned to it."
780    ::= { protocolDirEntry 9 }
781
782protocolDirStatus OBJECT-TYPE
783    SYNTAX      RowStatus
784    MAX-ACCESS  read-create
785    STATUS      current
786    DESCRIPTION
787        "The status of this protocol directory entry.
788
789        An entry may not exist in the active state unless all
790        objects in the entry have an appropriate value.
791
792        If this object is not equal to active(1), all associated
793        entries in the nlHostTable, nlMatrixSDTable, nlMatrixDSTable,
794        alHostTable, alMatrixSDTable, and alMatrixDSTable shall be
795        deleted."
796    ::= { protocolDirEntry 10 }
797
798--
799-- Protocol Distribution Group  (protocolDist)
800--
801-- Collects the relative amounts of octets and packets for the
802-- different protocols detected on a network segment.
803--    protocolDistControlTable,
804--    protocolDistStatsTable
805
806protocolDistControlTable OBJECT-TYPE
807    SYNTAX      SEQUENCE OF ProtocolDistControlEntry
808    MAX-ACCESS  not-accessible
809    STATUS      current
810    DESCRIPTION
811        "Controls the setup of protocol type distribution statistics
812        tables.
813
814        Implementations are encouraged to add an entry per monitored
815        interface upon initialization so that a default collection
816        of protocol statistics is available.
817
818        Rationale:
819        This table controls collection of very basic statistics
820        for any or all of the protocols detected on a given interface.
821        An NMS can use this table to quickly determine bandwidth
822        allocation utilized by different protocols.
823
824        A media-specific statistics collection could also
825        be configured (e.g., etherStats, trPStats) to easily obtain
826        total frame, octet, and droppedEvents for the same
827        interface."
828    ::= { protocolDist 1 }
829
830protocolDistControlEntry OBJECT-TYPE
831    SYNTAX      ProtocolDistControlEntry
832    MAX-ACCESS  not-accessible
833    STATUS      current
834    DESCRIPTION
835        "A conceptual row in the protocolDistControlTable.
836
837         An example of the indexing of this entry is
838         protocolDistControlDroppedFrames.7"
839    INDEX { protocolDistControlIndex }
840    ::= { protocolDistControlTable 1 }
841
842ProtocolDistControlEntry ::= SEQUENCE {
843    protocolDistControlIndex                Integer32,
844    protocolDistControlDataSource           DataSource,
845    protocolDistControlDroppedFrames        Counter32,
846    protocolDistControlCreateTime           LastCreateTime,
847    protocolDistControlOwner                OwnerString,
848    protocolDistControlStatus               RowStatus
849}
850
851protocolDistControlIndex OBJECT-TYPE
852    SYNTAX      Integer32 (1..65535)
853    MAX-ACCESS  not-accessible
854    STATUS      current
855    DESCRIPTION
856        "A unique index for this protocolDistControlEntry."
857    ::= { protocolDistControlEntry 1 }
858
859protocolDistControlDataSource OBJECT-TYPE
860    SYNTAX      DataSource
861    MAX-ACCESS  read-create
862    STATUS      current
863    DESCRIPTION
864        "The source of data for the this protocol distribution.
865
866        The statistics in this group reflect all packets
867        on the local network segment attached to the
868        identified interface.
869
870        This object may not be modified if the associated
871        protocolDistControlStatus object is equal to active(1)."
872    ::= { protocolDistControlEntry 2 }
873
874protocolDistControlDroppedFrames OBJECT-TYPE
875    SYNTAX     Counter32
876    MAX-ACCESS read-only
877    STATUS     current
878    DESCRIPTION
879       "The total number of frames that were received by the probe
880        and therefore not accounted for in the *StatsDropEvents, but
881        that the probe chose not to count for this entry for
882        whatever reason.  Most often, this event occurs when the probe
883        is out of some resources and decides to shed load from this
884        collection.
885
886        This count does not include packets that were not counted
887        because they had MAC-layer errors.
888
889        Note that, unlike the dropEvents counter, this number is the
890        exact number of frames dropped."
891    ::= { protocolDistControlEntry 3 }
892
893protocolDistControlCreateTime OBJECT-TYPE
894    SYNTAX     LastCreateTime
895    MAX-ACCESS read-only
896    STATUS     current
897    DESCRIPTION
898        "The value of sysUpTime when this control entry was last
899        activated.  This can be used by the management station to
900        ensure that the table has not been deleted and recreated
901        between polls."
902    ::= { protocolDistControlEntry 4 }
903
904protocolDistControlOwner OBJECT-TYPE
905    SYNTAX      OwnerString
906    MAX-ACCESS  read-create
907    STATUS      current
908    DESCRIPTION
909        "The entity that configured this entry and is
910        therefore using the resources assigned to it."
911    ::= { protocolDistControlEntry 5 }
912
913protocolDistControlStatus OBJECT-TYPE
914    SYNTAX      RowStatus
915    MAX-ACCESS  read-create
916    STATUS      current
917    DESCRIPTION
918        "The status of this row.
919
920        An entry may not exist in the active state unless all
921        objects in the entry have an appropriate value.
922
923        If this object is not equal to active(1), all associated
924        entries in the protocolDistStatsTable shall be deleted."
925    ::= { protocolDistControlEntry 6 }
926
927-- per interface protocol distribution statistics table
928protocolDistStatsTable OBJECT-TYPE
929    SYNTAX      SEQUENCE OF ProtocolDistStatsEntry
930    MAX-ACCESS  not-accessible
931    STATUS      current
932    DESCRIPTION
933        "An entry is made in this table for every protocol in the
934        protocolDirTable that has been seen in at least one packet.
935        Counters are updated in this table for every protocol type
936        that is encountered when parsing a packet, but no counters are
937
938        updated for packets with MAC-layer errors.
939
940        Note that if a protocolDirEntry is deleted, all associated
941        entries in this table are removed."
942    ::= { protocolDist 2 }
943
944protocolDistStatsEntry OBJECT-TYPE
945    SYNTAX      ProtocolDistStatsEntry
946    MAX-ACCESS  not-accessible
947    STATUS      current
948    DESCRIPTION
949        "A conceptual row in the protocolDistStatsTable.
950
951        The index is composed of the protocolDistControlIndex of the
952        associated protocolDistControlEntry, followed by the
953        protocolDirLocalIndex of the associated protocol that this
954        entry represents.  In other words, the index identifies the
955        protocol distribution an entry is a part of and the
956        particular protocol that it represents.
957
958        An example of the indexing of this entry is
959        protocolDistStatsPkts.1.18"
960    INDEX { protocolDistControlIndex, protocolDirLocalIndex }
961    ::= { protocolDistStatsTable 1 }
962
963ProtocolDistStatsEntry ::= SEQUENCE {
964    protocolDistStatsPkts                    ZeroBasedCounter32,
965    protocolDistStatsOctets                  ZeroBasedCounter32
966}
967
968protocolDistStatsPkts OBJECT-TYPE
969    SYNTAX      ZeroBasedCounter32
970    MAX-ACCESS  read-only
971    STATUS      current
972    DESCRIPTION
973        "The number of packets of this protocol type received
974        without errors.  Note that this is the number of
975        link-layer packets, so if a single network-layer packet
976        is fragmented into several link-layer frames, this counter
977        is incremented several times."
978    ::= { protocolDistStatsEntry 1 }
979
980protocolDistStatsOctets OBJECT-TYPE
981    SYNTAX      ZeroBasedCounter32
982    MAX-ACCESS  read-only
983    STATUS      current
984    DESCRIPTION
985        "The number of octets in packets of this protocol type
986
987        received since it was added to the protocolDistStatsTable
988        (excluding framing bits, but including FCS octets), except for
989        those octets in packets that contained errors.
990
991        Note that this doesn't count just those octets in the
992        particular protocol frames but includes the entire packet
993        that contained the protocol."
994    ::= { protocolDistStatsEntry 2 }
995
996--
997-- Address Map Group   (addressMap)
998--
999-- Lists MAC address to network address bindings discovered by the
1000-- probe and what interface they were last seen on.
1001--    addressMapControlTable
1002--    addressMapTable
1003
1004addressMapInserts OBJECT-TYPE
1005    SYNTAX     Counter32
1006    MAX-ACCESS read-only
1007    STATUS     current
1008    DESCRIPTION
1009        "The number of times an address mapping entry has been
1010        inserted into the addressMapTable.  If an entry is inserted,
1011        then deleted, and then inserted, this counter will be
1012        incremented by 2.
1013
1014        Note that the table size can be determined by subtracting
1015        addressMapDeletes from addressMapInserts."
1016    ::= { addressMap 1 }
1017
1018addressMapDeletes OBJECT-TYPE
1019    SYNTAX     Counter32
1020    MAX-ACCESS read-only
1021    STATUS     current
1022    DESCRIPTION
1023        "The number of times an address mapping entry has been
1024        deleted from the addressMapTable (for any reason).  If
1025        an entry is deleted, then inserted, and then deleted, this
1026        counter will be incremented by 2.
1027
1028        Note that the table size can be determined by subtracting
1029        addressMapDeletes from addressMapInserts."
1030    ::= { addressMap 2 }
1031
1032addressMapMaxDesiredEntries OBJECT-TYPE
1033    SYNTAX      Integer32 (-1..2147483647)
1034    MAX-ACCESS  read-write
1035    STATUS      current
1036    DESCRIPTION
1037        "The maximum number of entries that are desired in the
1038        addressMapTable.  The probe will not create more than
1039        this number of entries in the table but may choose to create
1040        fewer entries in this table for any reason, including the lack
1041        of resources.
1042
1043        If this object is set to a value less than the current number
1044        of entries, enough entries are chosen in an
1045        implementation-dependent manner and deleted so that the number
1046        of entries in the table equals the value of this object.
1047
1048        If this value is set to -1, the probe may create any number
1049        of entries in this table.
1050
1051        This object may be used to control how resources are allocated
1052        on the probe for the various RMON functions."
1053    ::= { addressMap 3 }
1054
1055addressMapControlTable OBJECT-TYPE
1056    SYNTAX      SEQUENCE OF AddressMapControlEntry
1057    MAX-ACCESS  not-accessible
1058    STATUS      current
1059    DESCRIPTION
1060        "A table to control the collection of mappings from network
1061         layer address to physical address to interface.
1062
1063        Note that this is not like the typical RMON
1064        controlTable and dataTable in which each entry creates
1065        its own data table.  Each entry in this table enables the
1066        discovery of addresses on a new interface and the placement
1067        of address mappings into the central addressMapTable.
1068
1069        Implementations are encouraged to add an entry per monitored
1070        interface upon initialization so that a default collection
1071        of address mappings is available."
1072    ::= { addressMap 4 }
1073
1074addressMapControlEntry OBJECT-TYPE
1075    SYNTAX      AddressMapControlEntry
1076    MAX-ACCESS  not-accessible
1077    STATUS      current
1078    DESCRIPTION
1079        "A conceptual row in the addressMapControlTable.
1080
1081        An example of the indexing of this entry is
1082        addressMapControlDroppedFrames.1"
1083    INDEX { addressMapControlIndex }
1084    ::= { addressMapControlTable 1 }
1085
1086AddressMapControlEntry ::= SEQUENCE {
1087    addressMapControlIndex              Integer32,
1088    addressMapControlDataSource         DataSource,
1089    addressMapControlDroppedFrames      Counter32,
1090    addressMapControlOwner              OwnerString,
1091    addressMapControlStatus             RowStatus
1092}
1093
1094addressMapControlIndex OBJECT-TYPE
1095    SYNTAX      Integer32 (1..65535)
1096    MAX-ACCESS  not-accessible
1097    STATUS      current
1098    DESCRIPTION
1099        "A unique index for this entry in the addressMapControlTable."
1100    ::= { addressMapControlEntry 1 }
1101
1102addressMapControlDataSource OBJECT-TYPE
1103    SYNTAX      DataSource
1104    MAX-ACCESS  read-create
1105    STATUS      current
1106    DESCRIPTION
1107        "The source of data for this addressMapControlEntry."
1108    ::= { addressMapControlEntry 2 }
1109
1110addressMapControlDroppedFrames OBJECT-TYPE
1111    SYNTAX     Counter32
1112    MAX-ACCESS read-only
1113    STATUS     current
1114    DESCRIPTION
1115       "The total number of frames that were received by the probe
1116        and therefore not accounted for in the *StatsDropEvents, but
1117        that the probe chose not to count for this entry for
1118        whatever reason.  Most often, this event occurs when the probe
1119        is out of some resources and decides to shed load from this
1120        collection.
1121
1122        This count does not include packets that were not counted
1123        because they had MAC-layer errors.
1124
1125        Note that, unlike the dropEvents counter, this number is the
1126        exact number of frames dropped."
1127    ::= { addressMapControlEntry 3 }
1128
1129addressMapControlOwner OBJECT-TYPE
1130    SYNTAX      OwnerString
1131    MAX-ACCESS  read-create
1132    STATUS      current
1133    DESCRIPTION
1134        "The entity that configured this entry and is
1135        therefore using the resources assigned to it."
1136    ::= { addressMapControlEntry 4 }
1137
1138addressMapControlStatus OBJECT-TYPE
1139    SYNTAX      RowStatus
1140    MAX-ACCESS  read-create
1141    STATUS      current
1142    DESCRIPTION
1143        "The status of this addressMap control entry.
1144
1145        An entry may not exist in the active state unless all
1146        objects in the entry have an appropriate value.
1147
1148        If this object is not equal to active(1), all associated
1149        entries in the addressMapTable shall be deleted."
1150    ::= { addressMapControlEntry 5 }
1151
1152addressMapTable OBJECT-TYPE
1153    SYNTAX      SEQUENCE OF AddressMapEntry
1154    MAX-ACCESS  not-accessible
1155    STATUS      current
1156    DESCRIPTION
1157        "A table of mappings from network layer address to physical
1158        address to interface.
1159
1160        The probe will add entries to this table based on the source
1161        MAC and network addresses seen in packets without MAC-level
1162        errors.  The probe will populate this table for all protocols
1163        in the protocol directory table whose value of
1164        protocolDirAddressMapConfig is equal to supportedOn(3), and
1165        will delete any entries whose protocolDirEntry is deleted or
1166        has a protocolDirAddressMapConfig value of supportedOff(2)."
1167    ::= { addressMap 5 }
1168
1169addressMapEntry OBJECT-TYPE
1170    SYNTAX      AddressMapEntry
1171    MAX-ACCESS  not-accessible
1172    STATUS      current
1173    DESCRIPTION
1174        "A conceptual row in the addressMapTable.
1175
1176        The protocolDirLocalIndex in the index identifies the network
1177        layer protocol of the addressMapNetworkAddress.
1178
1179        An example of the indexing of this entry is
1180        addressMapSource.783495.18.4.128.2.6.6.11.1.3.6.1.2.1.2.2.1.1.1.
1181
1182        Note that some combinations of index values may result in an
1183        index that exceeds 128 sub-identifiers in length, which exceeds
1184        the maximum for the SNMP protocol.  Implementations should take
1185        care to avoid such combinations."
1186    INDEX { addressMapTimeMark, protocolDirLocalIndex,
1187            addressMapNetworkAddress, addressMapSource }
1188    ::= { addressMapTable 1 }
1189
1190AddressMapEntry ::= SEQUENCE {
1191    addressMapTimeMark                 TimeFilter,
1192    addressMapNetworkAddress           OCTET STRING,
1193    addressMapSource                   OBJECT IDENTIFIER,
1194    addressMapPhysicalAddress          OCTET STRING,
1195    addressMapLastChange               TimeStamp
1196}
1197
1198addressMapTimeMark OBJECT-TYPE
1199    SYNTAX      TimeFilter
1200    MAX-ACCESS  not-accessible
1201    STATUS      current
1202    DESCRIPTION
1203        "A TimeFilter for this entry.  See the TimeFilter textual
1204        convention to see how this works."
1205    ::= { addressMapEntry 1 }
1206
1207addressMapNetworkAddress OBJECT-TYPE
1208    SYNTAX      OCTET STRING (SIZE (1..255))
1209    MAX-ACCESS  not-accessible
1210    STATUS      current
1211    DESCRIPTION
1212        "The network address for this relation.
1213
1214        This is represented as an octet string with
1215        specific semantics and length as identified
1216        by the protocolDirLocalIndex component of the
1217        index.
1218
1219        For example, if the protocolDirLocalIndex indicates an
1220        encapsulation of ip, this object is encoded as a length
1221        octet of 4, followed by the 4 octets of the IP address,
1222        in network byte order."
1223    ::= { addressMapEntry 2 }
1224
1225addressMapSource OBJECT-TYPE
1226    SYNTAX      OBJECT IDENTIFIER
1227    MAX-ACCESS  not-accessible
1228    STATUS      current
1229    DESCRIPTION
1230        "The interface or port on which the associated network
1231         address was most recently seen.
1232
1233        If this address mapping was discovered on an interface, this
1234        object shall identify the instance of the ifIndex
1235        object, defined in [RFC2863], for the desired interface.
1236        For example, if an entry were to receive data from
1237        interface #1, this object would be set to ifIndex.1.
1238
1239        If this address mapping was discovered on a port, this
1240        object shall identify the instance of the rptrGroupPortIndex
1241        object, defined in [RFC2108], for the desired port.
1242        For example, if an entry were to receive data from
1243        group #1, port #1, this object would be set to
1244        rptrGroupPortIndex.1.1.
1245
1246        Note that while the dataSource associated with this entry
1247        may only point to index objects, this object may at times
1248        point to repeater port objects.  This situation occurs when
1249        the dataSource points to an interface that is a locally
1250        attached repeater and the agent has additional information
1251        about the source port of traffic seen on that repeater."
1252    ::= { addressMapEntry 3 }
1253
1254addressMapPhysicalAddress OBJECT-TYPE
1255    SYNTAX      OCTET STRING
1256    MAX-ACCESS  read-only
1257    STATUS      current
1258    DESCRIPTION
1259        "The last source physical address on which the associated
1260        network address was seen.  If the protocol of the associated
1261        network address was encapsulated inside of a network-level or
1262        higher protocol, this will be the address of the next-lower
1263        protocol with the addressRecognitionCapable bit enabled and
1264        will be formatted as specified for that protocol."
1265    ::= { addressMapEntry 4 }
1266
1267addressMapLastChange OBJECT-TYPE
1268    SYNTAX      TimeStamp
1269    MAX-ACCESS  read-only
1270    STATUS      current
1271    DESCRIPTION
1272        "The value of sysUpTime at the time this entry was last
1273        created or the values of the physical address changed.
1274
1275        This can be used to help detect duplicate address problems, in
1276        which case this object will be updated frequently."
1277    ::= { addressMapEntry 5 }
1278
1279--
1280-- Network Layer Host Group
1281--
1282-- Counts the amount of traffic sent from and to each network address
1283-- discovered by the probe.
1284-- Note that while the hlHostControlTable also has objects that
1285-- control an optional alHostTable, implementation of the alHostTable is
1286-- not required to fully implement this group.
1287
1288hlHostControlTable OBJECT-TYPE
1289    SYNTAX      SEQUENCE OF HlHostControlEntry
1290    MAX-ACCESS  not-accessible
1291    STATUS      current
1292    DESCRIPTION
1293        "A list of higher-layer (i.e., non-MAC) host table control
1294        entries.
1295
1296        These entries will enable the collection of the network- and
1297        application-level host tables indexed by network addresses.
1298        Both the network- and application-level host tables are
1299        controlled by this table so that they will both be created
1300        and deleted at the same time, further increasing the ease with
1301        which they can be implemented as a single datastore.  (Note that
1302        if an implementation stores application-layer host records in
1303        memory, it can derive network-layer host records from them.)
1304
1305        Entries in the nlHostTable will be created on behalf of each
1306        entry in this table.  Additionally, if this probe implements
1307        the alHostTable, entries in the alHostTable will be created on
1308        behalf of each entry in this table.
1309
1310        Implementations are encouraged to add an entry per monitored
1311        interface upon initialization so that a default collection
1312        of host statistics is available."
1313    ::= { nlHost 1 }
1314
1315hlHostControlEntry OBJECT-TYPE
1316    SYNTAX      HlHostControlEntry
1317    MAX-ACCESS  not-accessible
1318    STATUS      current
1319    DESCRIPTION
1320        "A conceptual row in the hlHostControlTable.
1321
1322        An example of the indexing of this entry is
1323
1324        hlHostControlNlDroppedFrames.1"
1325    INDEX { hlHostControlIndex }
1326    ::= { hlHostControlTable 1 }
1327
1328HlHostControlEntry ::= SEQUENCE {
1329    hlHostControlIndex               Integer32,
1330    hlHostControlDataSource          DataSource,
1331    hlHostControlNlDroppedFrames     Counter32,
1332    hlHostControlNlInserts           Counter32,
1333    hlHostControlNlDeletes           Counter32,
1334    hlHostControlNlMaxDesiredEntries Integer32,
1335    hlHostControlAlDroppedFrames     Counter32,
1336    hlHostControlAlInserts           Counter32,
1337    hlHostControlAlDeletes           Counter32,
1338    hlHostControlAlMaxDesiredEntries Integer32,
1339    hlHostControlOwner               OwnerString,
1340    hlHostControlStatus              RowStatus
1341}
1342
1343hlHostControlIndex OBJECT-TYPE
1344    SYNTAX      Integer32 (1..65535)
1345    MAX-ACCESS  not-accessible
1346    STATUS      current
1347    DESCRIPTION
1348        "An index that uniquely identifies an entry in the
1349        hlHostControlTable.  Each such entry defines
1350        a function that discovers hosts on a particular
1351        interface and places statistics about them in the
1352        nlHostTable, and optionally in the alHostTable, on
1353        behalf of this hlHostControlEntry."
1354    ::= { hlHostControlEntry 1 }
1355
1356hlHostControlDataSource OBJECT-TYPE
1357    SYNTAX      DataSource
1358    MAX-ACCESS  read-create
1359    STATUS      current
1360    DESCRIPTION
1361        "The source of data for the associated host tables.
1362
1363        The statistics in this group reflect all packets
1364        on the local network segment attached to the
1365        identified interface.
1366
1367        This object may not be modified if the associated
1368        hlHostControlStatus object is equal to active(1)."
1369    ::= { hlHostControlEntry 2 }
1370
1371hlHostControlNlDroppedFrames OBJECT-TYPE
1372    SYNTAX     Counter32
1373    MAX-ACCESS read-only
1374    STATUS     current
1375    DESCRIPTION
1376       "The total number of frames that were received by the probe
1377        and therefore not accounted for in the *StatsDropEvents, but
1378        that the probe chose not to count for the associated
1379        nlHost entries for whatever reason.  Most often, this event
1380        occurs when the probe is out of some resources and decides to
1381        shed load from this collection.
1382
1383        This count does not include packets that were not counted
1384        because they had MAC-layer errors.
1385
1386        Note that if the nlHostTable is inactive because no protocols
1387        are enabled in the protocol directory, this value should be 0.
1388
1389        Note that, unlike the dropEvents counter, this number is the
1390        exact number of frames dropped."
1391    ::= { hlHostControlEntry 3 }
1392
1393hlHostControlNlInserts OBJECT-TYPE
1394    SYNTAX     Counter32
1395    MAX-ACCESS read-only
1396    STATUS     current
1397    DESCRIPTION
1398        "The number of times an nlHost entry has been
1399        inserted into the nlHost table.  If an entry is inserted, then
1400        deleted, and then inserted, this counter will be incremented
1401        by 2.
1402
1403        To allow for efficient implementation strategies, agents may
1404        delay updating this object for short periods of time.  For
1405        example, an implementation strategy may allow internal
1406        data structures to differ from those visible via SNMP for
1407        short periods of time.  This counter may reflect the internal
1408        data structures for those short periods of time.
1409
1410        Note that the table size can be determined by subtracting
1411        hlHostControlNlDeletes from hlHostControlNlInserts."
1412    ::= { hlHostControlEntry 4 }
1413
1414hlHostControlNlDeletes OBJECT-TYPE
1415    SYNTAX     Counter32
1416    MAX-ACCESS read-only
1417    STATUS     current
1418    DESCRIPTION
1419        "The number of times an nlHost entry has been
1420
1421        deleted from the nlHost table (for any reason).  If an entry
1422        is deleted, then inserted, and then deleted, this counter will
1423        be incremented by 2.
1424
1425        To allow for efficient implementation strategies, agents may
1426        delay updating this object for short periods of time.  For
1427        example, an implementation strategy may allow internal
1428        data structures to differ from those visible via SNMP for
1429        short periods of time.  This counter may reflect the internal
1430        data structures for those short periods of time.
1431
1432        Note that the table size can be determined by subtracting
1433        hlHostControlNlDeletes from hlHostControlNlInserts."
1434    ::= { hlHostControlEntry 5 }
1435
1436hlHostControlNlMaxDesiredEntries OBJECT-TYPE
1437    SYNTAX      Integer32 (-1..2147483647)
1438    MAX-ACCESS  read-create
1439    STATUS      current
1440    DESCRIPTION
1441        "The maximum number of entries that are desired in the
1442        nlHostTable on behalf of this control entry.  The probe will
1443        not create more than this number of associated entries in the
1444        table but may choose to create fewer entries in this table
1445        for any reason, including the lack of resources.
1446
1447        If this object is set to a value less than the current number
1448        of entries, enough entries are chosen in an
1449        implementation-dependent manner and deleted so that the number
1450        of entries in the table equals the value of this object.
1451
1452        If this value is set to -1, the probe may create any number
1453        of entries in this table.  If the associated
1454        hlHostControlStatus object is equal to 'active', this
1455        object may not be modified.
1456
1457        This object may be used to control how resources are allocated
1458        on the probe for the various RMON functions."
1459    ::= { hlHostControlEntry 6 }
1460
1461hlHostControlAlDroppedFrames OBJECT-TYPE
1462    SYNTAX     Counter32
1463    MAX-ACCESS read-only
1464    STATUS     current
1465    DESCRIPTION
1466       "The total number of frames that were received by the probe
1467        and therefore not accounted for in the *StatsDropEvents, but
1468        that the probe chose not to count for the associated
1469
1470        alHost entries for whatever reason.  Most often, this event
1471        occurs when the probe is out of some resources and decides to
1472        shed load from this collection.
1473
1474        This count does not include packets that were not counted
1475        because they had MAC-layer errors.
1476
1477        Note that if the alHostTable is not implemented or is inactive
1478        because no protocols are enabled in the protocol directory,
1479        this value should be 0.
1480
1481        Note that, unlike the dropEvents counter, this number is the
1482        exact number of frames dropped."
1483    ::= { hlHostControlEntry 7 }
1484
1485hlHostControlAlInserts OBJECT-TYPE
1486    SYNTAX     Counter32
1487    MAX-ACCESS read-only
1488    STATUS     current
1489    DESCRIPTION
1490        "The number of times an alHost entry has been
1491        inserted into the alHost table.  If an entry is inserted, then
1492        deleted, and then inserted, this counter will be incremented
1493        by 2.
1494
1495        To allow for efficient implementation strategies, agents may
1496        delay updating this object for short periods of time.  For
1497        example, an implementation strategy may allow internal
1498        data structures to differ from those visible via SNMP for
1499        short periods of time.  This counter may reflect the internal
1500        data structures for those short periods of time.
1501
1502        Note that the table size can be determined by subtracting
1503        hlHostControlAlDeletes from hlHostControlAlInserts."
1504    ::= { hlHostControlEntry 8 }
1505
1506hlHostControlAlDeletes OBJECT-TYPE
1507    SYNTAX     Counter32
1508    MAX-ACCESS read-only
1509    STATUS     current
1510    DESCRIPTION
1511        "The number of times an alHost entry has been
1512        deleted from the alHost table (for any reason).  If an entry
1513        is deleted, then inserted, and then deleted, this counter will
1514        be incremented by 2.
1515
1516        To allow for efficient implementation strategies, agents may
1517        delay updating this object for short periods of time.  For
1518
1519        example, an implementation strategy may allow internal
1520        data structures to differ from those visible via SNMP for
1521        short periods of time.  This counter may reflect the internal
1522        data structures for those short periods of time.
1523
1524        Note that the table size can be determined by subtracting
1525        hlHostControlAlDeletes from hlHostControlAlInserts."
1526    ::= { hlHostControlEntry 9 }
1527
1528hlHostControlAlMaxDesiredEntries OBJECT-TYPE
1529    SYNTAX      Integer32 (-1..2147483647)
1530    MAX-ACCESS  read-create
1531    STATUS      current
1532    DESCRIPTION
1533        "The maximum number of entries that are desired in the alHost
1534        table on behalf of this control entry.  The probe will not
1535        create more than this number of associated entries in the
1536        table but may choose to create fewer entries in this table
1537        for any reason, including the lack of resources.
1538
1539        If this object is set to a value less than the current number
1540        of entries, enough entries are chosen in an
1541        implementation-dependent manner and deleted so that the number
1542        of entries in the table equals the value of this object.
1543
1544        If this value is set to -1, the probe may create any number
1545        of entries in this table.  If the associated
1546        hlHostControlStatus object is equal to 'active', this
1547        object may not be modified.
1548
1549        This object may be used to control how resources are allocated
1550        on the probe for the various RMON functions."
1551    ::= { hlHostControlEntry 10 }
1552
1553hlHostControlOwner OBJECT-TYPE
1554    SYNTAX      OwnerString
1555    MAX-ACCESS  read-create
1556    STATUS      current
1557    DESCRIPTION
1558        "The entity that configured this entry and is
1559        therefore using the resources assigned to it."
1560    ::= { hlHostControlEntry 11 }
1561
1562hlHostControlStatus OBJECT-TYPE
1563    SYNTAX      RowStatus
1564    MAX-ACCESS  read-create
1565    STATUS      current
1566    DESCRIPTION
1567        "The status of this hlHostControlEntry.
1568
1569        An entry may not exist in the active state unless all
1570        objects in the entry have an appropriate value.
1571
1572        If this object is not equal to active(1), all associated
1573        entries in the nlHostTable and alHostTable shall be deleted."
1574    ::= { hlHostControlEntry 12 }
1575
1576nlHostTable OBJECT-TYPE
1577    SYNTAX      SEQUENCE OF NlHostEntry
1578    MAX-ACCESS  not-accessible
1579    STATUS      current
1580    DESCRIPTION
1581        "A collection of statistics for a particular network layer
1582        address that has been discovered on an interface of this
1583        device.
1584
1585        The probe will populate this table for all network layer
1586        protocols in the protocol directory table whose value of
1587        protocolDirHostConfig is equal to supportedOn(3), and
1588        will delete any entries whose protocolDirEntry is deleted or
1589        has a protocolDirHostConfig value of supportedOff(2).
1590
1591        The probe will add to this table all addresses seen
1592        as the source or destination address in all packets with no
1593        MAC errors, and will increment octet and packet counts in the
1594        table for all packets with no MAC errors."
1595::= { nlHost 2 }
1596
1597nlHostEntry OBJECT-TYPE
1598    SYNTAX      NlHostEntry
1599    MAX-ACCESS  not-accessible
1600    STATUS      current
1601    DESCRIPTION
1602        "A conceptual row in the nlHostTable.
1603
1604        The hlHostControlIndex value in the index identifies the
1605        hlHostControlEntry on whose behalf this entry was created.
1606        The protocolDirLocalIndex value in the index identifies the
1607        network layer protocol of the nlHostAddress.
1608
1609        An example of the indexing of this entry is
1610        nlHostOutPkts.1.783495.18.4.128.2.6.6.
1611
1612        Note that some combinations of index values may result in an
1613        index that exceeds 128 sub-identifiers in length, which exceeds
1614        the maximum for the SNMP protocol.  Implementations should take
1615
1616        care to avoid such combinations."
1617    INDEX { hlHostControlIndex, nlHostTimeMark,
1618            protocolDirLocalIndex, nlHostAddress }
1619    ::= { nlHostTable 1 }
1620
1621NlHostEntry ::= SEQUENCE {
1622    nlHostTimeMark              TimeFilter,
1623    nlHostAddress               OCTET STRING,
1624    nlHostInPkts                ZeroBasedCounter32,
1625    nlHostOutPkts               ZeroBasedCounter32,
1626    nlHostInOctets              ZeroBasedCounter32,
1627    nlHostOutOctets             ZeroBasedCounter32,
1628    nlHostOutMacNonUnicastPkts  ZeroBasedCounter32,
1629    nlHostCreateTime            LastCreateTime
1630}
1631
1632nlHostTimeMark OBJECT-TYPE
1633    SYNTAX      TimeFilter
1634    MAX-ACCESS  not-accessible
1635    STATUS      current
1636    DESCRIPTION
1637        "A TimeFilter for this entry.  See the TimeFilter textual
1638        convention to see how this works."
1639    ::= { nlHostEntry 1 }
1640
1641nlHostAddress OBJECT-TYPE
1642    SYNTAX      OCTET STRING  (SIZE (1..255))
1643    MAX-ACCESS  not-accessible
1644    STATUS      current
1645    DESCRIPTION
1646        "The network address for this nlHostEntry.
1647
1648        This is represented as an octet string with
1649        specific semantics and length as identified
1650        by the protocolDirLocalIndex component of the index.
1651
1652        For example, if the protocolDirLocalIndex indicates an
1653        encapsulation of IP, this object is encoded as a length
1654        octet of 4, followed by the 4 octets of the IP address,
1655        in network byte order."
1656    ::= { nlHostEntry 2 }
1657
1658nlHostInPkts OBJECT-TYPE
1659    SYNTAX      ZeroBasedCounter32
1660    MAX-ACCESS  read-only
1661    STATUS      current
1662    DESCRIPTION
1663        "The number of packets without errors transmitted to
1664
1665        this address since it was added to the nlHostTable.  Note that
1666        this is the number of link-layer packets, so if a single
1667        network-layer packet is fragmented into several link-layer
1668        frames, this counter is incremented several times."
1669    ::= { nlHostEntry 3 }
1670
1671nlHostOutPkts OBJECT-TYPE
1672    SYNTAX      ZeroBasedCounter32
1673    MAX-ACCESS  read-only
1674    STATUS      current
1675    DESCRIPTION
1676        "The number of packets without errors transmitted by
1677        this address since it was added to the nlHostTable.  Note that
1678        this is the number of link-layer packets, so if a single
1679        network-layer packet is fragmented into several link-layer
1680        frames, this counter is incremented several times."
1681    ::= { nlHostEntry 4 }
1682
1683nlHostInOctets OBJECT-TYPE
1684    SYNTAX      ZeroBasedCounter32
1685    MAX-ACCESS  read-only
1686    STATUS      current
1687    DESCRIPTION
1688        "The number of octets transmitted to this address
1689        since it was added to the nlHostTable (excluding
1690        framing bits, but including FCS octets), excluding
1691        octets in packets that contained errors.
1692
1693        Note that this doesn't count just those octets in the particular
1694        protocol frames but includes the entire packet that contained
1695        the protocol."
1696    ::= { nlHostEntry 5 }
1697
1698nlHostOutOctets OBJECT-TYPE
1699    SYNTAX      ZeroBasedCounter32
1700    MAX-ACCESS  read-only
1701    STATUS      current
1702    DESCRIPTION
1703        "The number of octets transmitted by this address
1704        since it was added to the nlHostTable (excluding
1705        framing bits, but including FCS octets), excluding
1706        octets in packets that contained errors.
1707
1708        Note that this doesn't count just those octets in the particular
1709        protocol frames but includes the entire packet that contained
1710        the protocol."
1711    ::= { nlHostEntry 6 }
1712
1713nlHostOutMacNonUnicastPkts OBJECT-TYPE
1714    SYNTAX      ZeroBasedCounter32
1715    MAX-ACCESS  read-only
1716    STATUS      current
1717    DESCRIPTION
1718        "The number of packets without errors transmitted by this
1719        address that were directed to any MAC broadcast addresses
1720        or to any MAC multicast addresses since this host was
1721        added to the nlHostTable.  Note that this is the number of
1722        link-layer packets, so if a single network-layer packet is
1723        fragmented into several link-layer frames, this counter is
1724        incremented several times."
1725    ::= { nlHostEntry 7 }
1726
1727nlHostCreateTime OBJECT-TYPE
1728    SYNTAX     LastCreateTime
1729    MAX-ACCESS read-only
1730    STATUS     current
1731    DESCRIPTION
1732        "The value of sysUpTime when this entry was last activated.
1733        This can be used by the management station to ensure that the
1734        entry has not been deleted and recreated between polls."
1735    ::= { nlHostEntry 8 }
1736
1737--
1738-- Network Layer Matrix Group
1739--
1740-- Counts the amount of traffic sent between each pair of network
1741-- addresses discovered by the probe.
1742-- Note that while the hlMatrixControlTable also has objects that
1743-- control optional alMatrixTables, implementation of the
1744-- alMatrixTables is not required to fully implement this group.
1745
1746hlMatrixControlTable OBJECT-TYPE
1747    SYNTAX      SEQUENCE OF HlMatrixControlEntry
1748    MAX-ACCESS  not-accessible
1749    STATUS      current
1750    DESCRIPTION
1751        "A list of higher-layer (i.e., non-MAC) matrix control entries.
1752
1753        These entries will enable the collection of the network- and
1754        application-level matrix tables containing conversation
1755        statistics indexed by pairs of network addresses.
1756        Both the network- and application-level matrix tables are
1757        controlled by this table so that they will both be created
1758        and deleted at the same time, further increasing the ease with
1759        which they can be implemented as a single datastore.  (Note that
1760        if an implementation stores application-layer matrix records
1761
1762        in memory, it can derive network-layer matrix records from
1763        them.)
1764
1765        Entries in the nlMatrixSDTable and nlMatrixDSTable will be
1766        created on behalf of each entry in this table.  Additionally,
1767        if this probe implements the alMatrix tables, entries in the
1768        alMatrix tables will be created on behalf of each entry in
1769        this table."
1770    ::= { nlMatrix 1 }
1771
1772hlMatrixControlEntry OBJECT-TYPE
1773    SYNTAX      HlMatrixControlEntry
1774    MAX-ACCESS  not-accessible
1775    STATUS      current
1776    DESCRIPTION
1777        "A conceptual row in the hlMatrixControlTable.
1778
1779        An example of indexing of this entry is
1780        hlMatrixControlNlDroppedFrames.1"
1781    INDEX { hlMatrixControlIndex }
1782    ::= { hlMatrixControlTable 1 }
1783
1784HlMatrixControlEntry ::= SEQUENCE {
1785    hlMatrixControlIndex                  Integer32,
1786    hlMatrixControlDataSource             DataSource,
1787    hlMatrixControlNlDroppedFrames        Counter32,
1788    hlMatrixControlNlInserts              Counter32,
1789    hlMatrixControlNlDeletes              Counter32,
1790    hlMatrixControlNlMaxDesiredEntries    Integer32,
1791    hlMatrixControlAlDroppedFrames        Counter32,
1792    hlMatrixControlAlInserts              Counter32,
1793    hlMatrixControlAlDeletes              Counter32,
1794    hlMatrixControlAlMaxDesiredEntries    Integer32,
1795    hlMatrixControlOwner                  OwnerString,
1796    hlMatrixControlStatus                 RowStatus
1797}
1798
1799hlMatrixControlIndex OBJECT-TYPE
1800    SYNTAX      Integer32 (1..65535)
1801    MAX-ACCESS  not-accessible
1802    STATUS      current
1803    DESCRIPTION
1804        "An index that uniquely identifies an entry in the
1805        hlMatrixControlTable.  Each such entry defines
1806        a function that discovers conversations on a particular
1807        interface and places statistics about them in the
1808        nlMatrixSDTable and the nlMatrixDSTable, and optionally the
1809        alMatrixSDTable and alMatrixDSTable, on behalf of this
1810
1811        hlMatrixControlEntry."
1812    ::= { hlMatrixControlEntry 1 }
1813
1814hlMatrixControlDataSource OBJECT-TYPE
1815    SYNTAX      DataSource
1816    MAX-ACCESS  read-create
1817    STATUS      current
1818    DESCRIPTION
1819        "The source of the data for the associated matrix tables.
1820
1821        The statistics in this group reflect all packets
1822        on the local network segment attached to the
1823        identified interface.
1824
1825        This object may not be modified if the associated
1826        hlMatrixControlStatus object is equal to active(1)."
1827    ::= { hlMatrixControlEntry 2 }
1828
1829hlMatrixControlNlDroppedFrames OBJECT-TYPE
1830    SYNTAX     Counter32
1831    MAX-ACCESS read-only
1832    STATUS     current
1833    DESCRIPTION
1834       "The total number of frames that were received by the probe
1835        and therefore not accounted for in the *StatsDropEvents, but
1836        that the probe chose not to count for this entry for
1837        whatever reason.  Most often, this event occurs when the probe
1838        is out of some resources and decides to shed load from this
1839        collection.
1840
1841        This count does not include packets that were not counted
1842        because they had MAC-layer errors.
1843
1844        Note that if the nlMatrixTables are inactive because no
1845        protocols are enabled in the protocol directory, this value
1846        should be 0.
1847
1848        Note that, unlike the dropEvents counter, this number is the
1849        exact number of frames dropped."
1850    ::= { hlMatrixControlEntry 3 }
1851
1852hlMatrixControlNlInserts OBJECT-TYPE
1853    SYNTAX     Counter32
1854    MAX-ACCESS read-only
1855    STATUS     current
1856    DESCRIPTION
1857        "The number of times an nlMatrix entry has been
1858        inserted into the nlMatrix tables.  If an entry is inserted,
1859        then deleted, and then inserted, this counter will be
1860        incremented by 2.  The addition of a conversation into both
1861        the nlMatrixSDTable and nlMatrixDSTable shall be counted as
1862        two insertions (even though every addition into one table must
1863        be accompanied by an insertion into the other).
1864
1865        To allow for efficient implementation strategies, agents may
1866        delay updating this object for short periods of time.  For
1867        example, an implementation strategy may allow internal
1868        data structures to differ from those visible via SNMP for
1869        short periods of time.  This counter may reflect the internal
1870        data structures for those short periods of time.
1871
1872        Note that the sum of then nlMatrixSDTable and nlMatrixDSTable
1873        sizes can be determined by subtracting
1874        hlMatrixControlNlDeletes from hlMatrixControlNlInserts."
1875    ::= { hlMatrixControlEntry 4 }
1876
1877hlMatrixControlNlDeletes OBJECT-TYPE
1878    SYNTAX     Counter32
1879    MAX-ACCESS read-only
1880    STATUS     current
1881    DESCRIPTION
1882        "The number of times an nlMatrix entry has been
1883        deleted from the nlMatrix tables (for any reason).  If an
1884        entry is deleted, then inserted, and then deleted, this
1885        counter will be incremented by 2.  The deletion of a
1886        conversation from both the nlMatrixSDTable and nlMatrixDSTable
1887        shall be counted as two deletions (even though every deletion
1888        from one table must be accompanied by a deletion from the
1889        other).
1890
1891        To allow for efficient implementation strategies, agents may
1892        delay updating this object for short periods of time.  For
1893        example, an implementation strategy may allow internal
1894        data structures to differ from those visible via SNMP for
1895        short periods of time.  This counter may reflect the internal
1896        data structures for those short periods of time.
1897
1898        Note that the table size can be determined by subtracting
1899        hlMatrixControlNlDeletes from hlMatrixControlNlInserts."
1900    ::= { hlMatrixControlEntry 5 }
1901
1902hlMatrixControlNlMaxDesiredEntries OBJECT-TYPE
1903    SYNTAX      Integer32 (-1..2147483647)
1904    MAX-ACCESS  read-create
1905    STATUS      current
1906    DESCRIPTION
1907        "The maximum number of entries that are desired in the
1908        nlMatrix tables on behalf of this control entry.  The probe
1909        will not create more than this number of associated entries in
1910        the table but may choose to create fewer entries in this
1911        table for any reason, including the lack of resources.
1912
1913        If this object is set to a value less than the current number
1914        of entries, enough entries are chosen in an
1915        implementation-dependent manner and deleted so that the number
1916        of entries in the table equals the value of this object.
1917
1918        If this value is set to -1, the probe may create any number
1919        of entries in this table.  If the associated
1920        hlMatrixControlStatus object is equal to 'active', this
1921        object may not be modified.
1922
1923        This object may be used to control how resources are allocated
1924        on the probe for the various RMON functions."
1925    ::= { hlMatrixControlEntry 6 }
1926
1927hlMatrixControlAlDroppedFrames OBJECT-TYPE
1928    SYNTAX     Counter32
1929    MAX-ACCESS read-only
1930    STATUS     current
1931    DESCRIPTION
1932       "The total number of frames that were received by the probe
1933        and therefore not accounted for in the *StatsDropEvents, but
1934        that the probe chose not to count for this entry for
1935        whatever reason.  Most often, this event occurs when the probe
1936        is out of some resources and decides to shed load from this
1937        collection.
1938
1939        This count does not include packets that were not counted
1940        because they had MAC-layer errors.
1941
1942        Note that if the alMatrixTables are not implemented or are
1943        inactive because no protocols are enabled in the protocol
1944        directory, this value should be 0.
1945
1946        Note that, unlike the dropEvents counter, this number is the
1947        exact number of frames dropped."
1948    ::= { hlMatrixControlEntry 7 }
1949
1950hlMatrixControlAlInserts OBJECT-TYPE
1951    SYNTAX     Counter32
1952    MAX-ACCESS read-only
1953    STATUS     current
1954    DESCRIPTION
1955        "The number of times an alMatrix entry has been
1956        inserted into the alMatrix tables.  If an entry is inserted,
1957        then deleted, and then inserted, this counter will be
1958        incremented by 2.  The addition of a conversation into both
1959        the alMatrixSDTable and alMatrixDSTable shall be counted as
1960        two insertions (even though every addition into one table must
1961        be accompanied by an insertion into the other).
1962
1963        To allow for efficient implementation strategies, agents may
1964        delay updating this object for short periods of time.  For
1965        example, an implementation strategy may allow internal
1966        data structures to differ from those visible via SNMP for
1967        short periods of time.  This counter may reflect the internal
1968        data structures for those short periods of time.
1969
1970        Note that the table size can be determined by subtracting
1971        hlMatrixControlAlDeletes from hlMatrixControlAlInserts."
1972    ::= { hlMatrixControlEntry 8 }
1973
1974hlMatrixControlAlDeletes OBJECT-TYPE
1975    SYNTAX     Counter32
1976    MAX-ACCESS read-only
1977    STATUS     current
1978    DESCRIPTION
1979        "The number of times an alMatrix entry has been
1980        deleted from the alMatrix tables.  If an entry is deleted,
1981        then inserted, and then deleted, this counter will be
1982        incremented by 2.  The deletion of a conversation from both
1983        the alMatrixSDTable and alMatrixDSTable shall be counted as
1984        two deletions (even though every deletion from one table must
1985        be accompanied by a deletion from the other).
1986
1987        To allow for efficient implementation strategies, agents may
1988        delay updating this object for short periods of time.  For
1989        example, an implementation strategy may allow internal
1990        data structures to differ from those visible via SNMP for
1991        short periods of time.  This counter may reflect the internal
1992        data structures for those short periods of time.
1993
1994        Note that the table size can be determined by subtracting
1995        hlMatrixControlAlDeletes from hlMatrixControlAlInserts."
1996    ::= { hlMatrixControlEntry 9 }
1997
1998hlMatrixControlAlMaxDesiredEntries OBJECT-TYPE
1999    SYNTAX      Integer32 (-1..2147483647)
2000    MAX-ACCESS  read-create
2001    STATUS      current
2002    DESCRIPTION
2003        "The maximum number of entries that are desired in the
2004        alMatrix tables on behalf of this control entry.  The probe
2005        will not create more than this number of associated entries in
2006        the table but may choose to create fewer entries in this
2007        table for any reason, including the lack of resources.
2008
2009        If this object is set to a value less than the current number
2010        of entries, enough entries are chosen in an
2011        implementation-dependent manner and deleted so that the number
2012        of entries in the table equals the value of this object.
2013
2014        If this value is set to -1, the probe may create any number
2015        of entries in this table.  If the associated
2016        hlMatrixControlStatus object is equal to 'active', this
2017        object may not be modified.
2018
2019        This object may be used to control how resources are allocated
2020        on the probe for the various RMON functions."
2021    ::= { hlMatrixControlEntry 10 }
2022
2023hlMatrixControlOwner OBJECT-TYPE
2024    SYNTAX      OwnerString
2025    MAX-ACCESS  read-create
2026    STATUS      current
2027    DESCRIPTION
2028        "The entity that configured this entry and is
2029        therefore using the resources assigned to it."
2030    ::= { hlMatrixControlEntry 11 }
2031
2032hlMatrixControlStatus OBJECT-TYPE
2033    SYNTAX      RowStatus
2034    MAX-ACCESS  read-create
2035    STATUS      current
2036    DESCRIPTION
2037        "The status of this hlMatrixControlEntry.
2038
2039        An entry may not exist in the active state unless all
2040        objects in the entry have an appropriate value.
2041
2042        If this object is not equal to active(1), all
2043        associated entries in the nlMatrixSDTable,
2044        nlMatrixDSTable, alMatrixSDTable, and alMatrixDSTable
2045        shall be deleted by the agent."
2046    ::= { hlMatrixControlEntry 12 }
2047
2048nlMatrixSDTable OBJECT-TYPE
2049    SYNTAX      SEQUENCE OF NlMatrixSDEntry
2050    MAX-ACCESS  not-accessible
2051    STATUS      current
2052    DESCRIPTION
2053        "A list of traffic matrix entries that collect statistics for
2054        conversations between two network-level addresses.  This table
2055        is indexed first by the source address and then by the
2056        destination address to make it convenient to collect all
2057        conversations from a particular address.
2058
2059        The probe will populate this table for all network layer
2060        protocols in the protocol directory table whose value of
2061        protocolDirMatrixConfig is equal to supportedOn(3), and
2062        will delete any entries whose protocolDirEntry is deleted or
2063        has a protocolDirMatrixConfig value of supportedOff(2).
2064
2065        The probe will add to this table all pairs of addresses
2066        seen in all packets with no MAC errors and will increment
2067        octet and packet counts in the table for all packets with no
2068        MAC errors.
2069
2070        Further, this table will only contain entries that have a
2071        corresponding entry in the nlMatrixDSTable with the same
2072        source address and destination address."
2073    ::= { nlMatrix 2 }
2074
2075nlMatrixSDEntry OBJECT-TYPE
2076    SYNTAX      NlMatrixSDEntry
2077    MAX-ACCESS  not-accessible
2078    STATUS      current
2079    DESCRIPTION
2080        "A conceptual row in the nlMatrixSDTable.
2081
2082        The hlMatrixControlIndex value in the index identifies the
2083        hlMatrixControlEntry on whose behalf this entry was created.
2084        The protocolDirLocalIndex value in the index identifies the
2085        network-layer protocol of the nlMatrixSDSourceAddress and
2086        nlMatrixSDDestAddress.
2087
2088        An example of the indexing of this table is
2089        nlMatrixSDPkts.1.783495.18.4.128.2.6.6.4.128.2.6.7.
2090
2091        Note that some combinations of index values may result in an
2092        index that exceeds 128 sub-identifiers in length, which exceeds
2093        the maximum for the SNMP protocol.  Implementations should take
2094        care to avoid such combinations."
2095    INDEX { hlMatrixControlIndex, nlMatrixSDTimeMark,
2096            protocolDirLocalIndex,
2097            nlMatrixSDSourceAddress, nlMatrixSDDestAddress }
2098    ::= { nlMatrixSDTable 1 }
2099
2100NlMatrixSDEntry ::= SEQUENCE {
2101    nlMatrixSDTimeMark              TimeFilter,
2102    nlMatrixSDSourceAddress         OCTET STRING,
2103    nlMatrixSDDestAddress           OCTET STRING,
2104    nlMatrixSDPkts                  ZeroBasedCounter32,
2105    nlMatrixSDOctets                ZeroBasedCounter32,
2106    nlMatrixSDCreateTime            LastCreateTime
2107}
2108
2109nlMatrixSDTimeMark OBJECT-TYPE
2110    SYNTAX      TimeFilter
2111    MAX-ACCESS  not-accessible
2112    STATUS      current
2113    DESCRIPTION
2114        "A TimeFilter for this entry.  See the TimeFilter textual
2115        convention to see how this works."
2116    ::= { nlMatrixSDEntry 1 }
2117
2118nlMatrixSDSourceAddress OBJECT-TYPE
2119    SYNTAX      OCTET STRING  (SIZE (1..255))
2120    MAX-ACCESS  not-accessible
2121    STATUS      current
2122    DESCRIPTION
2123        "The network source address for this nlMatrixSDEntry.
2124
2125        This is represented as an octet string with
2126        specific semantics and length as identified
2127        by the protocolDirLocalIndex component of the index.
2128
2129        For example, if the protocolDirLocalIndex indicates an
2130        encapsulation of IP, this object is encoded as a length
2131        octet of 4, followed by the 4 octets of the IP address,
2132        in network byte order."
2133    ::= { nlMatrixSDEntry 2 }
2134
2135nlMatrixSDDestAddress OBJECT-TYPE
2136    SYNTAX      OCTET STRING  (SIZE (1..255))
2137    MAX-ACCESS  not-accessible
2138    STATUS      current
2139    DESCRIPTION
2140        "The network destination address for this
2141        nlMatrixSDEntry.
2142
2143        This is represented as an octet string with
2144        specific semantics and length as identified
2145        by the protocolDirLocalIndex component of the index.
2146
2147        For example, if the protocolDirLocalIndex indicates an
2148
2149        encapsulation of IP, this object is encoded as a length
2150        octet of 4, followed by the 4 octets of the IP address,
2151        in network byte order."
2152    ::= { nlMatrixSDEntry 3 }
2153
2154nlMatrixSDPkts OBJECT-TYPE
2155    SYNTAX      ZeroBasedCounter32
2156    MAX-ACCESS  read-only
2157    STATUS      current
2158    DESCRIPTION
2159        "The number of packets without errors transmitted from the
2160        source address to the destination address since this entry was
2161        added to the nlMatrixSDTable.  Note that this is the number of
2162        link-layer packets, so if a single network-layer packet is
2163        fragmented into several link-layer frames, this counter is
2164        incremented several times."
2165    ::= { nlMatrixSDEntry 4 }
2166
2167nlMatrixSDOctets OBJECT-TYPE
2168    SYNTAX      ZeroBasedCounter32
2169    MAX-ACCESS  read-only
2170    STATUS      current
2171    DESCRIPTION
2172        "The number of octets transmitted from the source address to
2173        the destination address since this entry was added to the
2174        nlMatrixSDTable (excluding framing bits, but
2175        including FCS octets), excluding octets in packets that
2176        contained errors.
2177
2178        Note that this doesn't count just those octets in the particular
2179        protocol frames but includes the entire packet that contained
2180        the protocol."
2181    ::= { nlMatrixSDEntry 5 }
2182
2183nlMatrixSDCreateTime OBJECT-TYPE
2184    SYNTAX     LastCreateTime
2185    MAX-ACCESS read-only
2186    STATUS     current
2187    DESCRIPTION
2188        "The value of sysUpTime when this entry was last activated.
2189        This can be used by the management station to ensure that the
2190        entry has not been deleted and recreated between polls."
2191    ::= { nlMatrixSDEntry 6 }
2192
2193-- Traffic matrix tables from destination to source
2194
2195nlMatrixDSTable OBJECT-TYPE
2196    SYNTAX      SEQUENCE OF NlMatrixDSEntry
2197    MAX-ACCESS  not-accessible
2198    STATUS      current
2199    DESCRIPTION
2200        "A list of traffic matrix entries that collect statistics for
2201        conversations between two network-level addresses.  This table
2202        is indexed first by the destination address and then by the
2203        source address to make it convenient to collect all
2204        conversations to a particular address.
2205
2206        The probe will populate this table for all network layer
2207        protocols in the protocol directory table whose value of
2208        protocolDirMatrixConfig is equal to supportedOn(3), and
2209        will delete any entries whose protocolDirEntry is deleted or
2210        has a protocolDirMatrixConfig value of supportedOff(2).
2211
2212        The probe will add to this table all pairs of addresses
2213        seen in all packets with no MAC errors and will increment
2214        octet and packet counts in the table for all packets with no
2215        MAC errors.
2216
2217        Further, this table will only contain entries that have a
2218        corresponding entry in the nlMatrixSDTable with the same
2219        source address and destination address."
2220    ::= { nlMatrix 3 }
2221
2222nlMatrixDSEntry OBJECT-TYPE
2223    SYNTAX      NlMatrixDSEntry
2224    MAX-ACCESS  not-accessible
2225    STATUS      current
2226    DESCRIPTION
2227        "A conceptual row in the nlMatrixDSTable.
2228
2229        The hlMatrixControlIndex value in the index identifies the
2230        hlMatrixControlEntry on whose behalf this entry was created.
2231        The protocolDirLocalIndex value in the index identifies the
2232        network-layer protocol of the nlMatrixDSSourceAddress and
2233        nlMatrixDSDestAddress.
2234
2235        An example of the indexing of this table is
2236        nlMatrixDSPkts.1.783495.18.4.128.2.6.7.4.128.2.6.6.
2237
2238        Note that some combinations of index values may result in an
2239        index that exceeds 128 sub-identifiers in length, which exceeds
2240        the maximum for the SNMP protocol.  Implementations should take
2241        care to avoid such combinations."
2242    INDEX { hlMatrixControlIndex, nlMatrixDSTimeMark,
2243            protocolDirLocalIndex,
2244            nlMatrixDSDestAddress, nlMatrixDSSourceAddress }
2245    ::= { nlMatrixDSTable 1 }
2246
2247NlMatrixDSEntry ::= SEQUENCE {
2248    nlMatrixDSTimeMark                 TimeFilter,
2249    nlMatrixDSSourceAddress            OCTET STRING,
2250    nlMatrixDSDestAddress              OCTET STRING,
2251    nlMatrixDSPkts                     ZeroBasedCounter32,
2252    nlMatrixDSOctets                   ZeroBasedCounter32,
2253    nlMatrixDSCreateTime               LastCreateTime
2254}
2255
2256nlMatrixDSTimeMark OBJECT-TYPE
2257    SYNTAX      TimeFilter
2258    MAX-ACCESS  not-accessible
2259    STATUS      current
2260    DESCRIPTION
2261        "A TimeFilter for this entry.  See the TimeFilter textual
2262        convention to see how this works."
2263    ::= { nlMatrixDSEntry 1 }
2264
2265nlMatrixDSSourceAddress OBJECT-TYPE
2266    SYNTAX      OCTET STRING  (SIZE (1..255))
2267    MAX-ACCESS  not-accessible
2268    STATUS      current
2269    DESCRIPTION
2270        "The network source address for this nlMatrixDSEntry.
2271
2272        This is represented as an octet string with
2273        specific semantics and length as identified
2274        by the protocolDirLocalIndex component of the index.
2275
2276        For example, if the protocolDirLocalIndex indicates an
2277        encapsulation of IP, this object is encoded as a length
2278        octet of 4, followed by the 4 octets of the IP address,
2279        in network byte order."
2280    ::= { nlMatrixDSEntry 2 }
2281
2282nlMatrixDSDestAddress OBJECT-TYPE
2283    SYNTAX      OCTET STRING  (SIZE (1..255))
2284    MAX-ACCESS  not-accessible
2285    STATUS      current
2286    DESCRIPTION
2287        "The network destination address for this
2288        nlMatrixDSEntry.
2289
2290        This is represented as an octet string with
2291        specific semantics and length as identified
2292
2293        by the protocolDirLocalIndex component of the index.
2294
2295        For example, if the protocolDirLocalIndex indicates an
2296        encapsulation of IP, this object is encoded as a length
2297        octet of 4, followed by the 4 octets of the IP address,
2298        in network byte order."
2299    ::= { nlMatrixDSEntry 3 }
2300
2301nlMatrixDSPkts OBJECT-TYPE
2302    SYNTAX      ZeroBasedCounter32
2303    MAX-ACCESS  read-only
2304    STATUS      current
2305    DESCRIPTION
2306        "The number of packets without errors transmitted from the
2307        source address to the destination address since this entry was
2308        added to the nlMatrixDSTable.  Note that this is the number of
2309        link-layer packets, so if a single network-layer packet is
2310        fragmented into several link-layer frames, this counter is
2311        incremented several times."
2312    ::= { nlMatrixDSEntry 4 }
2313
2314nlMatrixDSOctets OBJECT-TYPE
2315    SYNTAX      ZeroBasedCounter32
2316    MAX-ACCESS  read-only
2317    STATUS      current
2318    DESCRIPTION
2319        "The number of octets transmitted from the source address
2320        to the destination address since this entry was added to the
2321        nlMatrixDSTable (excluding framing bits, but
2322        including FCS octets), excluding octets in packets that
2323        contained errors.
2324
2325        Note that this doesn't count just those octets in the particular
2326        protocol frames but includes the entire packet that contained
2327        the protocol."
2328    ::= { nlMatrixDSEntry 5 }
2329
2330nlMatrixDSCreateTime OBJECT-TYPE
2331    SYNTAX     LastCreateTime
2332    MAX-ACCESS read-only
2333    STATUS     current
2334    DESCRIPTION
2335        "The value of sysUpTime when this entry was last activated.
2336        This can be used by the management station to ensure that the
2337        entry has not been deleted and recreated between polls."
2338    ::= { nlMatrixDSEntry 6 }
2339
2340nlMatrixTopNControlTable OBJECT-TYPE
2341    SYNTAX      SEQUENCE OF NlMatrixTopNControlEntry
2342    MAX-ACCESS  not-accessible
2343    STATUS      current
2344    DESCRIPTION
2345        "A set of parameters that control the creation of a
2346        report of the top N matrix entries according to
2347        a selected metric."
2348    ::= { nlMatrix 4 }
2349
2350nlMatrixTopNControlEntry OBJECT-TYPE
2351    SYNTAX      NlMatrixTopNControlEntry
2352    MAX-ACCESS  not-accessible
2353    STATUS      current
2354    DESCRIPTION
2355        "A conceptual row in the nlMatrixTopNControlTable.
2356
2357        An example of the indexing of this table is
2358        nlMatrixTopNControlDuration.3"
2359    INDEX { nlMatrixTopNControlIndex }
2360    ::= { nlMatrixTopNControlTable 1 }
2361
2362NlMatrixTopNControlEntry ::= SEQUENCE {
2363    nlMatrixTopNControlIndex            Integer32,
2364    nlMatrixTopNControlMatrixIndex      Integer32,
2365    nlMatrixTopNControlRateBase         INTEGER,
2366    nlMatrixTopNControlTimeRemaining    Integer32,
2367    nlMatrixTopNControlGeneratedReports Counter32,
2368    nlMatrixTopNControlDuration         Integer32,
2369    nlMatrixTopNControlRequestedSize    Integer32,
2370    nlMatrixTopNControlGrantedSize      Integer32,
2371    nlMatrixTopNControlStartTime        TimeStamp,
2372    nlMatrixTopNControlOwner            OwnerString,
2373    nlMatrixTopNControlStatus           RowStatus
2374}
2375
2376nlMatrixTopNControlIndex OBJECT-TYPE
2377    SYNTAX     Integer32 (1..65535)
2378    MAX-ACCESS not-accessible
2379    STATUS     current
2380    DESCRIPTION
2381        "An index that uniquely identifies an entry
2382        in the nlMatrixTopNControlTable.  Each such
2383        entry defines one topN report prepared for
2384        one interface."
2385    ::= { nlMatrixTopNControlEntry 1 }
2386
2387nlMatrixTopNControlMatrixIndex OBJECT-TYPE
2388    SYNTAX     Integer32 (1..65535)
2389    MAX-ACCESS read-create
2390    STATUS     current
2391    DESCRIPTION
2392        "The nlMatrix[SD/DS] table for which a topN report will be
2393        prepared on behalf of this entry.  The nlMatrix[SD/DS] table
2394        is identified by the value of the hlMatrixControlIndex
2395        for that table - that value is used here to identify the
2396        particular table.
2397
2398        This object may not be modified if the associated
2399        nlMatrixTopNControlStatus object is equal to active(1)."
2400    ::= { nlMatrixTopNControlEntry 2 }
2401
2402nlMatrixTopNControlRateBase OBJECT-TYPE
2403    SYNTAX      INTEGER {
2404                    nlMatrixTopNPkts(1),
2405                    nlMatrixTopNOctets(2),
2406                    nlMatrixTopNHighCapacityPkts(3),
2407                    nlMatrixTopNHighCapacityOctets(4)
2408                }
2409    MAX-ACCESS read-create
2410    STATUS     current
2411    DESCRIPTION
2412        "The variable for each nlMatrix[SD/DS] entry that the
2413        nlMatrixTopNEntries are sorted by, as well as a control
2414        for the table that the results will be reported in.
2415
2416        This object may not be modified if the associated
2417        nlMatrixTopNControlStatus object is equal to active(1).
2418
2419        If this value is less than or equal to 2, when the report
2420        is prepared, entries are created in the nlMatrixTopNTable
2421        associated with this object.
2422        If this value is greater than or equal to 3, when the report
2423        is prepared, entries are created in the
2424        nlMatrixTopNHighCapacityTable associated with this object."
2425    ::= { nlMatrixTopNControlEntry 3 }
2426
2427nlMatrixTopNControlTimeRemaining OBJECT-TYPE
2428    SYNTAX     Integer32 (0..2147483647)
2429    MAX-ACCESS read-create
2430    STATUS     current
2431    DESCRIPTION
2432        "The number of seconds left in the report currently
2433        being collected.  When this object is modified by
2434        the management station, a new collection is started,
2435        possibly aborting a currently running report.  The
2436        new value is used as the requested duration of this
2437
2438        report and is immediately loaded into the associated
2439        nlMatrixTopNControlDuration object.
2440
2441        When the report finishes, the probe will automatically
2442        start another collection with the same initial value
2443        of nlMatrixTopNControlTimeRemaining.  Thus, the management
2444        station may simply read the resulting reports repeatedly,
2445        checking the startTime and duration each time to ensure that a
2446        report was not missed or that the report parameters were not
2447        changed.
2448
2449        While the value of this object is non-zero, it decrements
2450        by one per second until it reaches zero.  At the time
2451        that this object decrements to zero, the report is made
2452        accessible in the nlMatrixTopNTable, overwriting any report
2453        that may be there.
2454
2455        When this object is modified by the management station, any
2456        associated entries in the nlMatrixTopNTable shall be deleted.
2457
2458        (Note that this is a different algorithm than the one used
2459        in the hostTopNTable)."
2460    DEFVAL { 1800 }
2461    ::= { nlMatrixTopNControlEntry 4 }
2462
2463nlMatrixTopNControlGeneratedReports OBJECT-TYPE
2464    SYNTAX     Counter32
2465    MAX-ACCESS read-only
2466    STATUS     current
2467    DESCRIPTION
2468        "The number of reports that have been generated by this entry."
2469    ::= { nlMatrixTopNControlEntry 5 }
2470
2471nlMatrixTopNControlDuration OBJECT-TYPE
2472    SYNTAX     Integer32
2473    MAX-ACCESS read-only
2474    STATUS     current
2475    DESCRIPTION
2476        "The number of seconds that this report has collected
2477        during the last sampling interval.
2478
2479        When the associated nlMatrixTopNControlTimeRemaining object is
2480        set, this object shall be set by the probe to the
2481        same value and shall not be modified until the next
2482        time the nlMatrixTopNControlTimeRemaining is set.
2483
2484        This value shall be zero if no reports have been
2485        requested for this nlMatrixTopNControlEntry."
2486    ::= { nlMatrixTopNControlEntry 6 }
2487
2488nlMatrixTopNControlRequestedSize OBJECT-TYPE
2489    SYNTAX     Integer32 (0..2147483647)
2490    MAX-ACCESS read-create
2491    STATUS     current
2492    DESCRIPTION
2493        "The maximum number of matrix entries requested for this report.
2494
2495        When this object is created or modified, the probe
2496        should set nlMatrixTopNControlGrantedSize as closely to this
2497        object as possible for the particular probe
2498        implementation and available resources."
2499    DEFVAL { 150 }
2500    ::= { nlMatrixTopNControlEntry 7 }
2501
2502nlMatrixTopNControlGrantedSize OBJECT-TYPE
2503    SYNTAX     Integer32 (0..2147483647)
2504    MAX-ACCESS read-only
2505    STATUS     current
2506    DESCRIPTION
2507        "The maximum number of matrix entries in this report.
2508
2509        When the associated nlMatrixTopNControlRequestedSize object is
2510        created or modified, the probe should set this
2511        object as closely to the requested value as
2512        possible for the particular implementation and
2513        available resources.  The probe must not lower this
2514        value except as a side-effect of a set to the associated
2515        nlMatrixTopNControlRequestedSize object.
2516
2517        If the value of nlMatrixTopNControlRateBase is equal to
2518        nlMatrixTopNPkts, when the next topN report is generated,
2519        matrix entries with the highest value of nlMatrixTopNPktRate
2520        shall be placed in this table in decreasing order of this rate
2521        until there is no more room or until there are no more
2522        matrix entries.
2523
2524        If the value of nlMatrixTopNControlRateBase is equal to
2525        nlMatrixTopNOctets, when the next topN report is generated,
2526        matrix entries with the highest value of nlMatrixTopNOctetRate
2527        shall be placed in this table in decreasing order of this rate
2528        until there is no more room or until there are no more
2529        matrix entries.
2530
2531        It is an implementation-specific matter how entries with the
2532        same value of nlMatrixTopNPktRate or nlMatrixTopNOctetRate are
2533        sorted.  It is also an implementation-specific matter as to
2534
2535        whether zero-valued entries are available."
2536    ::= { nlMatrixTopNControlEntry 8 }
2537
2538nlMatrixTopNControlStartTime OBJECT-TYPE
2539    SYNTAX     TimeStamp
2540    MAX-ACCESS read-only
2541    STATUS     current
2542    DESCRIPTION
2543        "The value of sysUpTime when this topN report was
2544        last started.  In other words, this is the time that
2545        the associated nlMatrixTopNControlTimeRemaining object was
2546        modified to start the requested report or the time
2547        the report was last automatically (re)started.
2548
2549        This object may be used by the management station to
2550        determine whether a report was missed."
2551    ::= { nlMatrixTopNControlEntry 9 }
2552
2553nlMatrixTopNControlOwner OBJECT-TYPE
2554    SYNTAX     OwnerString
2555    MAX-ACCESS read-create
2556    STATUS     current
2557    DESCRIPTION
2558        "The entity that configured this entry and is
2559        therefore using the resources assigned to it."
2560    ::= { nlMatrixTopNControlEntry 10 }
2561
2562nlMatrixTopNControlStatus OBJECT-TYPE
2563    SYNTAX     RowStatus
2564    MAX-ACCESS read-create
2565    STATUS     current
2566    DESCRIPTION
2567        "The status of this nlMatrixTopNControlEntry.
2568
2569        An entry may not exist in the active state unless all
2570        objects in the entry have an appropriate value.
2571
2572        If this object is not equal to active(1), all
2573        associated entries in the nlMatrixTopNTable shall be deleted
2574        by the agent."
2575    ::= { nlMatrixTopNControlEntry 11 }
2576
2577nlMatrixTopNTable OBJECT-TYPE
2578    SYNTAX     SEQUENCE OF NlMatrixTopNEntry
2579    MAX-ACCESS not-accessible
2580    STATUS     current
2581    DESCRIPTION
2582        "A set of statistics for those network-layer matrix entries
2583
2584        that have counted the highest number of octets or packets."
2585    ::= { nlMatrix 5 }
2586
2587nlMatrixTopNEntry OBJECT-TYPE
2588    SYNTAX     NlMatrixTopNEntry
2589    MAX-ACCESS not-accessible
2590    STATUS     current
2591    DESCRIPTION
2592        "A conceptual row in the nlMatrixTopNTable.
2593
2594        The nlMatrixTopNControlIndex value in the index identifies the
2595        nlMatrixTopNControlEntry on whose behalf this entry was
2596        created.
2597
2598        An example of the indexing of this table is
2599        nlMatrixTopNPktRate.3.10"
2600    INDEX { nlMatrixTopNControlIndex, nlMatrixTopNIndex }
2601    ::= { nlMatrixTopNTable 1 }
2602
2603NlMatrixTopNEntry ::= SEQUENCE {
2604    nlMatrixTopNIndex                 Integer32,
2605    nlMatrixTopNProtocolDirLocalIndex Integer32,
2606    nlMatrixTopNSourceAddress         OCTET STRING,
2607    nlMatrixTopNDestAddress           OCTET STRING,
2608    nlMatrixTopNPktRate               Gauge32,
2609    nlMatrixTopNReversePktRate        Gauge32,
2610    nlMatrixTopNOctetRate             Gauge32,
2611    nlMatrixTopNReverseOctetRate      Gauge32
2612}
2613
2614nlMatrixTopNIndex OBJECT-TYPE
2615    SYNTAX     Integer32 (1..65535)
2616    MAX-ACCESS not-accessible
2617    STATUS     current
2618    DESCRIPTION
2619        "An index that uniquely identifies an entry in
2620        the nlMatrixTopNTable among those in the same report.
2621        This index is between 1 and N, where N is the
2622        number of entries in this report.
2623
2624        If the value of nlMatrixTopNControlRateBase is equal to
2625        nlMatrixTopNPkts, increasing values of nlMatrixTopNIndex shall
2626        be assigned to entries with decreasing values of
2627        nlMatrixTopNPktRate until index N is assigned or there are no
2628        more nlMatrixTopNEntries.
2629
2630        If the value of nlMatrixTopNControlRateBase is equal to
2631        nlMatrixTopNOctets, increasing values of nlMatrixTopNIndex
2632
2633        shall be assigned to entries with decreasing values of
2634        nlMatrixTopNOctetRate until index N is assigned or there are
2635        no more nlMatrixTopNEntries."
2636    ::= { nlMatrixTopNEntry 1 }
2637
2638nlMatrixTopNProtocolDirLocalIndex OBJECT-TYPE
2639    SYNTAX     Integer32 (1..2147483647)
2640    MAX-ACCESS read-only
2641    STATUS     current
2642    DESCRIPTION
2643        "The protocolDirLocalIndex of the network-layer protocol of
2644        this entry's network address."
2645    ::= { nlMatrixTopNEntry 2 }
2646
2647nlMatrixTopNSourceAddress OBJECT-TYPE
2648    SYNTAX     OCTET STRING  (SIZE (1..255))
2649    MAX-ACCESS read-only
2650    STATUS     current
2651    DESCRIPTION
2652        "The network-layer address of the source host in this
2653        conversation.
2654
2655        This is represented as an octet string with
2656        specific semantics and length as identified
2657        by the associated nlMatrixTopNProtocolDirLocalIndex.
2658
2659        For example, if the protocolDirLocalIndex indicates an
2660        encapsulation of IP, this object is encoded as a length
2661        octet of 4, followed by the 4 octets of the IP address,
2662        in network byte order."
2663    ::= { nlMatrixTopNEntry 3 }
2664
2665nlMatrixTopNDestAddress OBJECT-TYPE
2666    SYNTAX     OCTET STRING  (SIZE (1..255))
2667    MAX-ACCESS read-only
2668    STATUS     current
2669    DESCRIPTION
2670        "The network-layer address of the destination host in this
2671        conversation.
2672
2673        This is represented as an octet string with
2674        specific semantics and length as identified
2675        by the associated nlMatrixTopNProtocolDirLocalIndex.
2676
2677        For example, if the nlMatrixTopNProtocolDirLocalIndex
2678        indicates an encapsulation of IP, this object is encoded as a
2679        length octet of 4, followed by the 4 octets of the IP address,
2680        in network byte order."
2681    ::= { nlMatrixTopNEntry 4 }
2682
2683nlMatrixTopNPktRate OBJECT-TYPE
2684    SYNTAX     Gauge32
2685    MAX-ACCESS read-only
2686    STATUS     current
2687    DESCRIPTION
2688        "The number of packets seen from the source host
2689        to the destination host during this sampling interval, counted
2690        using the rules for counting the nlMatrixSDPkts object.
2691        If the value of nlMatrixTopNControlRateBase is
2692        nlMatrixTopNPkts, this variable will be used to sort this
2693        report."
2694    ::= { nlMatrixTopNEntry 5 }
2695
2696nlMatrixTopNReversePktRate OBJECT-TYPE
2697    SYNTAX     Gauge32
2698    MAX-ACCESS read-only
2699    STATUS     current
2700    DESCRIPTION
2701        "The number of packets seen from the destination host to the
2702        source host during this sampling interval, counted
2703        using the rules for counting the nlMatrixSDPkts object.  (Note
2704        that the corresponding nlMatrixSDPkts object selected is the
2705        one whose source address is equal to nlMatrixTopNDestAddress
2706        and whose destination address is equal to
2707        nlMatrixTopNSourceAddress.)
2708
2709        Note that if the value of nlMatrixTopNControlRateBase is equal
2710        to nlMatrixTopNPkts, the sort of topN entries is based
2711        entirely on nlMatrixTopNPktRate, and not on the value of this
2712        object."
2713    ::= { nlMatrixTopNEntry 6 }
2714
2715nlMatrixTopNOctetRate OBJECT-TYPE
2716    SYNTAX     Gauge32
2717    MAX-ACCESS read-only
2718    STATUS     current
2719    DESCRIPTION
2720        "The number of octets seen from the source host
2721        to the destination host during this sampling interval, counted
2722        using the rules for counting the nlMatrixSDOctets object.  If
2723        the value of nlMatrixTopNControlRateBase is
2724        nlMatrixTopNOctets, this variable will be used to sort this
2725        report."
2726    ::= { nlMatrixTopNEntry 7 }
2727
2728nlMatrixTopNReverseOctetRate OBJECT-TYPE
2729    SYNTAX     Gauge32
2730    MAX-ACCESS read-only
2731    STATUS     current
2732    DESCRIPTION
2733        "The number of octets seen from the destination host to the
2734        source host during this sampling interval, counted
2735        using the rules for counting the nlMatrixDSOctets object.  (Note
2736        that the corresponding nlMatrixSDOctets object selected is the
2737        one whose source address is equal to nlMatrixTopNDestAddress
2738        and whose destination address is equal to
2739        nlMatrixTopNSourceAddress.)
2740
2741        Note that if the value of nlMatrixTopNControlRateBase is equal
2742        to nlMatrixTopNOctets, the sort of topN entries is based
2743        entirely on nlMatrixTopNOctetRate, and not on the value of
2744        this object."
2745    ::= { nlMatrixTopNEntry 8 }
2746
2747-- Application Layer Functions
2748--
2749-- The application layer host, matrix, and matrixTopN functions report
2750-- on protocol usage at the network layer or higher.  Note that the
2751-- use of the term application layer does not imply that only
2752-- application-layer protocols are counted, rather it means that
2753-- protocols up to and including the application layer are supported.
2754
2755--
2756-- Application Layer Host Group
2757--
2758-- Counts the amount of traffic, by protocol, sent from and to each
2759-- network address discovered by the probe.
2760-- Implementation of this group requires implementation of the Network
2761-- Layer Host Group.
2762
2763alHostTable OBJECT-TYPE
2764    SYNTAX      SEQUENCE OF AlHostEntry
2765    MAX-ACCESS  not-accessible
2766    STATUS      current
2767    DESCRIPTION
2768        "A collection of statistics for a particular protocol from a
2769        particular network address that has been discovered on an
2770        interface of this device.
2771
2772        The probe will populate this table for all protocols in the
2773        protocol directory table whose value of
2774        protocolDirHostConfig is equal to supportedOn(3), and
2775        will delete any entries whose protocolDirEntry is deleted or
2776        has a protocolDirHostConfig value of supportedOff(2).
2777
2778        The probe will add to this table all addresses
2779        seen as the source or destination address in all packets with
2780        no MAC errors and will increment octet and packet counts in
2781        the table for all packets with no MAC errors.  Further,
2782        entries will only be added to this table if their address
2783        exists in the nlHostTable and will be deleted from this table
2784        if their address is deleted from the nlHostTable."
2785    ::= { alHost 1 }
2786
2787alHostEntry OBJECT-TYPE
2788    SYNTAX      AlHostEntry
2789    MAX-ACCESS  not-accessible
2790    STATUS      current
2791    DESCRIPTION
2792        "A conceptual row in the alHostTable.
2793
2794        The hlHostControlIndex value in the index identifies the
2795        hlHostControlEntry on whose behalf this entry was created.
2796        The first protocolDirLocalIndex value in the index identifies
2797        the network-layer protocol of the address.
2798        The nlHostAddress value in the index identifies the network-
2799        layer address of this entry.
2800        The second protocolDirLocalIndex value in the index identifies
2801        the protocol that is counted by this entry.
2802
2803        An example of the indexing in this entry is
2804        alHostOutPkts.1.783495.18.4.128.2.6.6.34.
2805
2806        Note that some combinations of index values may result in an
2807        index that exceeds 128 sub-identifiers in length, which exceeds
2808        the maximum for the SNMP protocol.  Implementations should take
2809        care to avoid such combinations."
2810    INDEX { hlHostControlIndex, alHostTimeMark,
2811            protocolDirLocalIndex, nlHostAddress,
2812            protocolDirLocalIndex }
2813    ::= { alHostTable 1 }
2814
2815AlHostEntry ::= SEQUENCE {
2816    alHostTimeMark                 TimeFilter,
2817    alHostInPkts                   ZeroBasedCounter32,
2818    alHostOutPkts                  ZeroBasedCounter32,
2819    alHostInOctets                 ZeroBasedCounter32,
2820    alHostOutOctets                ZeroBasedCounter32,
2821    alHostCreateTime               LastCreateTime
2822}
2823
2824alHostTimeMark OBJECT-TYPE
2825    SYNTAX      TimeFilter
2826    MAX-ACCESS  not-accessible
2827    STATUS      current
2828    DESCRIPTION
2829        "A TimeFilter for this entry.  See the TimeFilter textual
2830        convention to see how this works."
2831    ::= { alHostEntry 1 }
2832
2833alHostInPkts OBJECT-TYPE
2834    SYNTAX      ZeroBasedCounter32
2835    MAX-ACCESS  read-only
2836    STATUS      current
2837    DESCRIPTION
2838        "The number of packets of this protocol type without errors
2839        transmitted to this address since it was added to the
2840        alHostTable.  Note that this is the number of link-layer
2841        packets, so if a single network-layer packet is fragmented
2842        into several link-layer frames, this counter is incremented
2843        several times."
2844    ::= { alHostEntry 2 }
2845
2846alHostOutPkts OBJECT-TYPE
2847    SYNTAX      ZeroBasedCounter32
2848    MAX-ACCESS  read-only
2849    STATUS      current
2850    DESCRIPTION
2851        "The number of packets of this protocol type without errors
2852        transmitted by this address since it was added to the
2853        alHostTable.  Note that this is the number of link-layer
2854        packets, so if a single network-layer packet is fragmented
2855        into several link-layer frames, this counter is incremented
2856        several times."
2857     ::= { alHostEntry 3 }
2858
2859alHostInOctets OBJECT-TYPE
2860    SYNTAX      ZeroBasedCounter32
2861    MAX-ACCESS  read-only
2862    STATUS      current
2863    DESCRIPTION
2864        "The number of octets transmitted to this address
2865        of this protocol type since it was added to the
2866        alHostTable (excluding framing bits, but including
2867        FCS octets), excluding octets in packets that
2868        contained errors.
2869
2870        Note that this doesn't count just those octets in the particular
2871        protocol frames but includes the entire packet that contained
2872        the protocol."
2873    ::= { alHostEntry 4 }
2874
2875alHostOutOctets OBJECT-TYPE
2876    SYNTAX      ZeroBasedCounter32
2877    MAX-ACCESS  read-only
2878    STATUS      current
2879    DESCRIPTION
2880        "The number of octets transmitted by this address
2881        of this protocol type since it was added to the
2882        alHostTable (excluding framing bits, but including
2883        FCS octets), excluding octets in packets that
2884        contained errors.
2885
2886        Note that this doesn't count just those octets in the particular
2887        protocol frames but includes the entire packet that contained
2888        the protocol."
2889    ::= { alHostEntry 5 }
2890
2891alHostCreateTime OBJECT-TYPE
2892    SYNTAX     LastCreateTime
2893    MAX-ACCESS read-only
2894    STATUS     current
2895    DESCRIPTION
2896        "The value of sysUpTime when this entry was last activated.
2897        This can be used by the management station to ensure that the
2898        entry has not been deleted and recreated between polls."
2899    ::= { alHostEntry 6 }
2900
2901--
2902-- Application Layer Matrix Group
2903--
2904-- Counts the amount of traffic, by protocol, sent between each pair
2905-- of network addresses discovered by the probe.
2906-- Implementation of this group requires implementation of the Network
2907-- Layer Matrix Group.
2908
2909alMatrixSDTable OBJECT-TYPE
2910    SYNTAX      SEQUENCE OF AlMatrixSDEntry
2911    MAX-ACCESS  not-accessible
2912    STATUS      current
2913    DESCRIPTION
2914        "A list of application traffic matrix entries that collect
2915        statistics for conversations of a particular protocol between
2916        two network-level addresses.  This table is indexed first by
2917        the source address and then by the destination address to make
2918        it convenient to collect all statistics from a particular
2919        address.
2920
2921        The probe will populate this table for all protocols in the
2922        protocol directory table whose value of
2923
2924        protocolDirMatrixConfig is equal to supportedOn(3), and
2925        will delete any entries whose protocolDirEntry is deleted or
2926        has a protocolDirMatrixConfig value of supportedOff(2).
2927
2928        The probe will add to this table all pairs of addresses for
2929        all protocols seen in all packets with no MAC errors and will
2930        increment octet and packet counts in the table for all packets
2931        with no MAC errors.  Further, entries will only be added to
2932        this table if their address pair exists in the nlMatrixSDTable
2933        and will be deleted from this table if the address pair is
2934        deleted from the nlMatrixSDTable."
2935    ::= { alMatrix 1 }
2936
2937alMatrixSDEntry OBJECT-TYPE
2938    SYNTAX      AlMatrixSDEntry
2939    MAX-ACCESS  not-accessible
2940    STATUS      current
2941    DESCRIPTION
2942        "A conceptual row in the alMatrixSDTable.
2943
2944        The hlMatrixControlIndex value in the index identifies the
2945        hlMatrixControlEntry on whose behalf this entry was created.
2946        The first protocolDirLocalIndex value in the index identifies
2947        the network-layer protocol of the nlMatrixSDSourceAddress and
2948        nlMatrixSDDestAddress.
2949        The nlMatrixSDSourceAddress value in the index identifies the
2950        network-layer address of the source host in this conversation.
2951        The nlMatrixSDDestAddress value in the index identifies the
2952        network-layer address of the destination host in this
2953        conversation.
2954        The second protocolDirLocalIndex value in the index identifies
2955        the protocol that is counted by this entry.
2956
2957        An example of the indexing of this entry is
2958        alMatrixSDPkts.1.783495.18.4.128.2.6.6.4.128.2.6.7.34.
2959
2960        Note that some combinations of index values may result in an
2961        index that exceeds 128 sub-identifiers in length, which exceeds
2962        the maximum for the SNMP protocol.  Implementations should take
2963        care to avoid such combinations."
2964    INDEX { hlMatrixControlIndex, alMatrixSDTimeMark,
2965            protocolDirLocalIndex,
2966            nlMatrixSDSourceAddress, nlMatrixSDDestAddress,
2967            protocolDirLocalIndex }
2968    ::= { alMatrixSDTable 1 }
2969
2970AlMatrixSDEntry ::= SEQUENCE {
2971    alMatrixSDTimeMark                 TimeFilter,
2972    alMatrixSDPkts                     ZeroBasedCounter32,
2973    alMatrixSDOctets                   ZeroBasedCounter32,
2974    alMatrixSDCreateTime               LastCreateTime
2975}
2976
2977alMatrixSDTimeMark OBJECT-TYPE
2978    SYNTAX      TimeFilter
2979    MAX-ACCESS  not-accessible
2980    STATUS      current
2981    DESCRIPTION
2982        "A TimeFilter for this entry.  See the TimeFilter textual
2983        convention to see how this works."
2984    ::= { alMatrixSDEntry 1 }
2985
2986alMatrixSDPkts OBJECT-TYPE
2987    SYNTAX      ZeroBasedCounter32
2988    MAX-ACCESS  read-only
2989    STATUS      current
2990    DESCRIPTION
2991        "The number of packets of this protocol type without errors
2992        transmitted from the source address to the destination address
2993        since this entry was added to the alMatrixSDTable.  Note that
2994        this is the number of link-layer packets, so if a single
2995        network-layer packet is fragmented into several link-layer
2996        frames, this counter is incremented several times."
2997    ::= { alMatrixSDEntry 2 }
2998
2999alMatrixSDOctets OBJECT-TYPE
3000    SYNTAX      ZeroBasedCounter32
3001    MAX-ACCESS  read-only
3002    STATUS      current
3003    DESCRIPTION
3004        "The number of octets in packets of this protocol type
3005        transmitted from the source address to the destination address
3006        since this entry was added to the alMatrixSDTable (excluding
3007        framing bits, but including FCS octets), excluding octets
3008        in packets that contained errors.
3009
3010        Note that this doesn't count just those octets in the particular
3011        protocol frames but includes the entire packet that contained
3012        the protocol."
3013    ::= { alMatrixSDEntry 3 }
3014
3015alMatrixSDCreateTime OBJECT-TYPE
3016    SYNTAX     LastCreateTime
3017    MAX-ACCESS read-only
3018    STATUS     current
3019    DESCRIPTION
3020        "The value of sysUpTime when this entry was last activated.
3021        This can be used by the management station to ensure that the
3022        entry has not been deleted and recreated between polls."
3023    ::= { alMatrixSDEntry 4 }
3024
3025-- Traffic matrix tables from destination to source
3026
3027alMatrixDSTable OBJECT-TYPE
3028    SYNTAX      SEQUENCE OF AlMatrixDSEntry
3029    MAX-ACCESS  not-accessible
3030    STATUS      current
3031    DESCRIPTION
3032        "A list of application traffic matrix entries that collect
3033        statistics for conversations of a particular protocol between
3034        two network-level addresses.  This table is indexed first by
3035        the destination address and then by the source address to make
3036        it convenient to collect all statistics to a particular
3037        address.
3038
3039        The probe will populate this table for all protocols in the
3040        protocol directory table whose value of
3041        protocolDirMatrixConfig is equal to supportedOn(3), and
3042        will delete any entries whose protocolDirEntry is deleted or
3043        has a protocolDirMatrixConfig value of supportedOff(2).
3044
3045        The probe will add to this table all pairs of addresses for
3046        all protocols seen in all packets with no MAC errors and will
3047        increment octet and packet counts in the table for all packets
3048        with no MAC errors.  Further, entries will only be added to
3049        this table if their address pair exists in the nlMatrixDSTable
3050        and will be deleted from this table if the address pair is
3051        deleted from the nlMatrixDSTable."
3052    ::= { alMatrix 2 }
3053
3054alMatrixDSEntry OBJECT-TYPE
3055    SYNTAX      AlMatrixDSEntry
3056    MAX-ACCESS  not-accessible
3057    STATUS      current
3058    DESCRIPTION
3059        "A conceptual row in the alMatrixDSTable.
3060
3061        The hlMatrixControlIndex value in the index identifies the
3062        hlMatrixControlEntry on whose behalf this entry was created.
3063        The first protocolDirLocalIndex value in the index identifies
3064        the network-layer protocol of the alMatrixDSSourceAddress and
3065        alMatrixDSDestAddress.
3066        The nlMatrixDSDestAddress value in the index identifies the
3067        network-layer address of the destination host in this
3068
3069        conversation.
3070        The nlMatrixDSSourceAddress value in the index identifies the
3071        network-layer address of the source host in this conversation.
3072        The second protocolDirLocalIndex value in the index identifies
3073        the protocol that is counted by this entry.
3074
3075        An example of the indexing of this entry is
3076        alMatrixDSPkts.1.783495.18.4.128.2.6.7.4.128.2.6.6.34.
3077
3078        Note that some combinations of index values may result in an
3079        index that exceeds 128 sub-identifiers in length, which exceeds
3080        the maximum for the SNMP protocol.  Implementations should take
3081        care to avoid such combinations."
3082    INDEX { hlMatrixControlIndex, alMatrixDSTimeMark,
3083            protocolDirLocalIndex,
3084            nlMatrixDSDestAddress, nlMatrixDSSourceAddress,
3085            protocolDirLocalIndex }
3086    ::= { alMatrixDSTable 1 }
3087
3088AlMatrixDSEntry ::= SEQUENCE {
3089    alMatrixDSTimeMark                 TimeFilter,
3090    alMatrixDSPkts                     ZeroBasedCounter32,
3091    alMatrixDSOctets                   ZeroBasedCounter32,
3092    alMatrixDSCreateTime               LastCreateTime
3093}
3094
3095alMatrixDSTimeMark OBJECT-TYPE
3096    SYNTAX      TimeFilter
3097    MAX-ACCESS  not-accessible
3098    STATUS      current
3099    DESCRIPTION
3100        "A TimeFilter for this entry.  See the TimeFilter textual
3101        convention to see how this works."
3102    ::= { alMatrixDSEntry 1 }
3103
3104alMatrixDSPkts OBJECT-TYPE
3105    SYNTAX      ZeroBasedCounter32
3106    MAX-ACCESS  read-only
3107    STATUS      current
3108    DESCRIPTION
3109        "The number of packets of this protocol type without errors
3110        transmitted from the source address to the destination address
3111        since this entry was added to the alMatrixDSTable.  Note that
3112        this is the number of link-layer packets, so if a single
3113        network-layer packet is fragmented into several link-layer
3114        frames, this counter is incremented several times."
3115    ::= { alMatrixDSEntry 2 }
3116
3117alMatrixDSOctets OBJECT-TYPE
3118    SYNTAX      ZeroBasedCounter32
3119    MAX-ACCESS  read-only
3120    STATUS      current
3121    DESCRIPTION
3122        "The number of octets in packets of this protocol type
3123        transmitted from the source address to the destination address
3124        since this entry was added to the alMatrixDSTable (excluding
3125        framing bits, but including FCS octets), excluding octets
3126        in packets that contained errors.
3127
3128        Note that this doesn't count just those octets in the particular
3129        protocol frames but includes the entire packet that contained
3130        the protocol."
3131    ::= { alMatrixDSEntry 3 }
3132
3133alMatrixDSCreateTime OBJECT-TYPE
3134    SYNTAX     LastCreateTime
3135    MAX-ACCESS read-only
3136    STATUS     current
3137    DESCRIPTION
3138        "The value of sysUpTime when this entry was last activated.
3139        This can be used by the management station to ensure that the
3140        entry has not been deleted and recreated between polls."
3141    ::= { alMatrixDSEntry 4 }
3142
3143alMatrixTopNControlTable OBJECT-TYPE
3144    SYNTAX      SEQUENCE OF AlMatrixTopNControlEntry
3145    MAX-ACCESS  not-accessible
3146    STATUS      current
3147    DESCRIPTION
3148        "A set of parameters that control the creation of a
3149        report of the top N matrix entries according to
3150        a selected metric."
3151    ::= { alMatrix 3 }
3152
3153alMatrixTopNControlEntry OBJECT-TYPE
3154    SYNTAX      AlMatrixTopNControlEntry
3155    MAX-ACCESS  not-accessible
3156    STATUS      current
3157    DESCRIPTION
3158        "A conceptual row in the alMatrixTopNControlTable.
3159
3160        An example of the indexing of this table is
3161        alMatrixTopNControlDuration.3"
3162    INDEX { alMatrixTopNControlIndex }
3163    ::= { alMatrixTopNControlTable 1 }
3164
3165AlMatrixTopNControlEntry ::= SEQUENCE {
3166    alMatrixTopNControlIndex            Integer32,
3167    alMatrixTopNControlMatrixIndex      Integer32,
3168    alMatrixTopNControlRateBase         INTEGER,
3169    alMatrixTopNControlTimeRemaining    Integer32,
3170    alMatrixTopNControlGeneratedReports Counter32,
3171    alMatrixTopNControlDuration         Integer32,
3172    alMatrixTopNControlRequestedSize    Integer32,
3173    alMatrixTopNControlGrantedSize      Integer32,
3174    alMatrixTopNControlStartTime        TimeStamp,
3175    alMatrixTopNControlOwner            OwnerString,
3176    alMatrixTopNControlStatus           RowStatus
3177}
3178
3179alMatrixTopNControlIndex OBJECT-TYPE
3180    SYNTAX     Integer32 (1..65535)
3181    MAX-ACCESS not-accessible
3182    STATUS     current
3183    DESCRIPTION
3184        "An index that uniquely identifies an entry
3185        in the alMatrixTopNControlTable.  Each such
3186        entry defines one topN report prepared for
3187        one interface."
3188    ::= { alMatrixTopNControlEntry 1 }
3189
3190alMatrixTopNControlMatrixIndex OBJECT-TYPE
3191    SYNTAX     Integer32 (1..65535)
3192    MAX-ACCESS read-create
3193    STATUS     current
3194    DESCRIPTION
3195        "The alMatrix[SD/DS] table for which a topN report will be
3196        prepared on behalf of this entry.  The alMatrix[SD/DS] table
3197        is identified by the value of the hlMatrixControlIndex
3198        for that table - that value is used here to identify the
3199        particular table.
3200
3201        This object may not be modified if the associated
3202        alMatrixTopNControlStatus object is equal to active(1)."
3203    ::= { alMatrixTopNControlEntry 2 }
3204
3205alMatrixTopNControlRateBase OBJECT-TYPE
3206    SYNTAX     INTEGER {
3207                  alMatrixTopNTerminalsPkts(1),
3208                  alMatrixTopNTerminalsOctets(2),
3209                  alMatrixTopNAllPkts(3),
3210                  alMatrixTopNAllOctets(4),
3211                  alMatrixTopNTerminalsHighCapacityPkts(5),
3212                  alMatrixTopNTerminalsHighCapacityOctets(6),
3213                  alMatrixTopNAllHighCapacityPkts(7),
3214                  alMatrixTopNAllHighCapacityOctets(8)
3215               }
3216    MAX-ACCESS read-create
3217    STATUS     current
3218    DESCRIPTION
3219        "This object controls which alMatrix[SD/DS] entry that the
3220        alMatrixTopNEntries are sorted by, which view of the matrix
3221        table that will be used, as well as which table the results
3222        will be reported in.
3223
3224        The values alMatrixTopNTerminalsPkts,
3225        alMatrixTopNTerminalsOctets,
3226        alMatrixTopNTerminalsHighCapacityPkts, and
3227        alMatrixTopNTerminalsHighCapacityOctets cause collection
3228        only from protocols that have no child protocols that are
3229        counted.  The values alMatrixTopNAllPkts,
3230        alMatrixTopNAllOctets, alMatrixTopNAllHighCapacityPkts, and
3231        alMatrixTopNAllHighCapacityOctets cause collection from all
3232        alMatrix entries.
3233
3234        This object may not be modified if the associated
3235        alMatrixTopNControlStatus object is equal to active(1)."
3236    ::= { alMatrixTopNControlEntry 3 }
3237
3238alMatrixTopNControlTimeRemaining OBJECT-TYPE
3239    SYNTAX     Integer32 (0..2147483647)
3240    MAX-ACCESS read-create
3241    STATUS     current
3242    DESCRIPTION
3243        "The number of seconds left in the report currently
3244        being collected.  When this object is modified by
3245        the management station, a new collection is started,
3246        possibly aborting a currently running report.  The
3247        new value is used as the requested duration of this
3248        report and is immediately loaded into the associated
3249        alMatrixTopNControlDuration object.
3250
3251        When the report finishes, the probe will automatically
3252        start another collection with the same initial value
3253        of alMatrixTopNControlTimeRemaining.  Thus, the management
3254        station may simply read the resulting reports repeatedly,
3255        checking the startTime and duration each time to ensure that a
3256        report was not missed or that the report parameters were not
3257        changed.
3258
3259        While the value of this object is non-zero, it decrements
3260        by one per second until it reaches zero.  At the time
3261
3262        that this object decrements to zero, the report is made
3263        accessible in the alMatrixTopNTable, overwriting any report
3264        that may be there.
3265
3266        When this object is modified by the management station, any
3267        associated entries in the alMatrixTopNTable shall be deleted.
3268
3269        (Note that this is a different algorithm than the one used
3270        in the hostTopNTable)."
3271    DEFVAL { 1800 }
3272    ::= { alMatrixTopNControlEntry 4 }
3273
3274alMatrixTopNControlGeneratedReports OBJECT-TYPE
3275    SYNTAX     Counter32
3276    MAX-ACCESS read-only
3277    STATUS     current
3278    DESCRIPTION
3279        "The number of reports that have been generated by this entry."
3280    ::= { alMatrixTopNControlEntry 5 }
3281
3282alMatrixTopNControlDuration OBJECT-TYPE
3283    SYNTAX     Integer32
3284    MAX-ACCESS read-only
3285    STATUS     current
3286    DESCRIPTION
3287        "The number of seconds that this report has collected
3288        during the last sampling interval.
3289
3290        When the associated alMatrixTopNControlTimeRemaining object
3291        is set, this object shall be set by the probe to the
3292        same value and shall not be modified until the next
3293        time the alMatrixTopNControlTimeRemaining is set.
3294
3295        This value shall be zero if no reports have been
3296        requested for this alMatrixTopNControlEntry."
3297    ::= { alMatrixTopNControlEntry 6 }
3298
3299alMatrixTopNControlRequestedSize OBJECT-TYPE
3300    SYNTAX     Integer32 (0..2147483647)
3301    MAX-ACCESS read-create
3302    STATUS     current
3303    DESCRIPTION
3304        "The maximum number of matrix entries requested for this report.
3305
3306        When this object is created or modified, the probe
3307        should set alMatrixTopNControlGrantedSize as closely to this
3308        object as possible for the particular probe
3309        implementation and available resources."
3310    DEFVAL { 150 }
3311    ::= { alMatrixTopNControlEntry 7 }
3312
3313alMatrixTopNControlGrantedSize OBJECT-TYPE
3314    SYNTAX     Integer32 (0..2147483647)
3315    MAX-ACCESS read-only
3316    STATUS     current
3317    DESCRIPTION
3318        "The maximum number of matrix entries in this report.
3319
3320        When the associated alMatrixTopNControlRequestedSize object
3321        is created or modified, the probe should set this
3322        object as closely to the requested value as
3323        possible for the particular implementation and
3324        available resources. The probe must not lower this
3325        value except as a side-effect of a set to the associated
3326        alMatrixTopNControlRequestedSize object.
3327
3328        If the value of alMatrixTopNControlRateBase is equal to
3329        alMatrixTopNTerminalsPkts or alMatrixTopNAllPkts, when the
3330        next topN report is generated, matrix entries with the highest
3331        value of alMatrixTopNPktRate shall be placed in this table in
3332        decreasing order of this rate until there is no more room or
3333        until there are no more matrix entries.
3334
3335        If the value of alMatrixTopNControlRateBase is equal to
3336        alMatrixTopNTerminalsOctets or alMatrixTopNAllOctets, when the
3337        next topN report is generated, matrix entries with the highest
3338        value of alMatrixTopNOctetRate shall be placed in this table
3339        in decreasing order of this rate until there is no more room
3340        or until there are no more matrix entries.
3341
3342        It is an implementation-specific matter how entries with the
3343        same value of alMatrixTopNPktRate or alMatrixTopNOctetRate are
3344        sorted.  It is also an implementation-specific matter as to
3345        whether zero-valued entries are available."
3346    ::= { alMatrixTopNControlEntry 8 }
3347
3348alMatrixTopNControlStartTime OBJECT-TYPE
3349    SYNTAX     TimeStamp
3350    MAX-ACCESS read-only
3351    STATUS     current
3352    DESCRIPTION
3353        "The value of sysUpTime when this topN report was
3354        last started.  In other words, this is the time that
3355        the associated alMatrixTopNControlTimeRemaining object
3356        was modified to start the requested report or the time
3357        the report was last automatically (re)started.
3358
3359        This object may be used by the management station to
3360        determine whether a report was missed."
3361    ::= { alMatrixTopNControlEntry 9 }
3362
3363alMatrixTopNControlOwner OBJECT-TYPE
3364    SYNTAX     OwnerString
3365    MAX-ACCESS read-create
3366    STATUS     current
3367    DESCRIPTION
3368        "The entity that configured this entry and is
3369        therefore using the resources assigned to it."
3370    ::= { alMatrixTopNControlEntry 10 }
3371
3372alMatrixTopNControlStatus OBJECT-TYPE
3373    SYNTAX     RowStatus
3374    MAX-ACCESS read-create
3375    STATUS     current
3376    DESCRIPTION
3377        "The status of this alMatrixTopNControlEntry.
3378
3379        An entry may not exist in the active state unless all
3380        objects in the entry have an appropriate value.
3381
3382        If this object is not equal to active(1), all
3383        associated entries in the alMatrixTopNTable shall be
3384        deleted by the agent."
3385    ::= { alMatrixTopNControlEntry 11 }
3386
3387alMatrixTopNTable OBJECT-TYPE
3388    SYNTAX     SEQUENCE OF AlMatrixTopNEntry
3389    MAX-ACCESS not-accessible
3390    STATUS     current
3391    DESCRIPTION
3392        "A set of statistics for those application-layer matrix
3393        entries that have counted the highest number of octets or
3394        packets."
3395    ::= { alMatrix 4 }
3396
3397alMatrixTopNEntry OBJECT-TYPE
3398    SYNTAX     AlMatrixTopNEntry
3399    MAX-ACCESS not-accessible
3400    STATUS     current
3401    DESCRIPTION
3402        "A conceptual row in the alMatrixTopNTable.
3403
3404        The alMatrixTopNControlIndex value in the index identifies
3405        the alMatrixTopNControlEntry on whose behalf this entry was
3406        created.
3407
3408        An example of the indexing of this table is
3409        alMatrixTopNPktRate.3.10"
3410    INDEX { alMatrixTopNControlIndex, alMatrixTopNIndex }
3411    ::= { alMatrixTopNTable 1 }
3412
3413AlMatrixTopNEntry ::= SEQUENCE {
3414    alMatrixTopNIndex                      Integer32,
3415    alMatrixTopNProtocolDirLocalIndex      Integer32,
3416    alMatrixTopNSourceAddress              OCTET STRING,
3417    alMatrixTopNDestAddress                OCTET STRING,
3418    alMatrixTopNAppProtocolDirLocalIndex   Integer32,
3419    alMatrixTopNPktRate                    Gauge32,
3420    alMatrixTopNReversePktRate             Gauge32,
3421    alMatrixTopNOctetRate                  Gauge32,
3422    alMatrixTopNReverseOctetRate           Gauge32
3423  }
3424
3425alMatrixTopNIndex OBJECT-TYPE
3426    SYNTAX     Integer32 (1..65535)
3427    MAX-ACCESS not-accessible
3428    STATUS     current
3429    DESCRIPTION
3430        "An index that uniquely identifies an entry in
3431        the alMatrixTopNTable among those in the same report.
3432
3433        This index is between 1 and N, where N is the
3434        number of entries in this report.
3435
3436        If the value of alMatrixTopNControlRateBase is equal to
3437        alMatrixTopNTerminalsPkts or alMatrixTopNAllPkts, increasing
3438        values of alMatrixTopNIndex shall be assigned to entries with
3439        decreasing values of alMatrixTopNPktRate until index N is
3440        assigned or there are no more alMatrixTopNEntries.
3441
3442        If the value of alMatrixTopNControlRateBase is equal to
3443        alMatrixTopNTerminalsOctets or alMatrixTopNAllOctets,
3444        increasing values of alMatrixTopNIndex shall be assigned to
3445        entries with decreasing values of alMatrixTopNOctetRate until
3446        index N is assigned or there are no more alMatrixTopNEntries."
3447    ::= { alMatrixTopNEntry 1 }
3448
3449alMatrixTopNProtocolDirLocalIndex OBJECT-TYPE
3450    SYNTAX     Integer32 (1..2147483647)
3451    MAX-ACCESS read-only
3452    STATUS     current
3453    DESCRIPTION
3454        "The protocolDirLocalIndex of the network-layer protocol of
3455        this entry's network address."
3456    ::= { alMatrixTopNEntry 2 }
3457
3458alMatrixTopNSourceAddress OBJECT-TYPE
3459    SYNTAX     OCTET STRING  (SIZE (1..255))
3460    MAX-ACCESS read-only
3461    STATUS     current
3462    DESCRIPTION
3463        "The network-layer address of the source host in this
3464        conversation.
3465
3466        This is represented as an octet string with
3467        specific semantics and length as identified
3468        by the associated alMatrixTopNProtocolDirLocalIndex.
3469
3470        For example, if the alMatrixTopNProtocolDirLocalIndex
3471        indicates an encapsulation of IP, this object is encoded as a
3472        length octet of 4, followed by the 4 octets of the IP address,
3473        in network byte order."
3474    ::= { alMatrixTopNEntry 3 }
3475
3476alMatrixTopNDestAddress OBJECT-TYPE
3477    SYNTAX     OCTET STRING  (SIZE (1..255))
3478    MAX-ACCESS read-only
3479    STATUS     current
3480    DESCRIPTION
3481        "The network-layer address of the destination host in this
3482        conversation.
3483
3484        This is represented as an octet string with
3485        specific semantics and length as identified
3486        by the associated alMatrixTopNProtocolDirLocalIndex.
3487
3488        For example, if the alMatrixTopNProtocolDirLocalIndex
3489        indicates an encapsulation of IP, this object is encoded as a
3490        length octet of 4, followed by the 4 octets of the IP address,
3491        in network byte order."
3492    ::= { alMatrixTopNEntry 4 }
3493
3494alMatrixTopNAppProtocolDirLocalIndex OBJECT-TYPE
3495    SYNTAX     Integer32 (1..2147483647)
3496    MAX-ACCESS read-only
3497    STATUS     current
3498    DESCRIPTION
3499        "The type of the protocol counted by this matrix entry."
3500    ::= { alMatrixTopNEntry 5 }
3501
3502alMatrixTopNPktRate OBJECT-TYPE
3503    SYNTAX     Gauge32
3504    MAX-ACCESS read-only
3505    STATUS     current
3506    DESCRIPTION
3507        "The number of packets seen of this protocol from the source
3508        host to the destination host during this sampling interval,
3509        counted using the rules for counting the alMatrixSDPkts
3510        object.
3511
3512        If the value of alMatrixTopNControlRateBase is
3513        alMatrixTopNTerminalsPkts or alMatrixTopNAllPkts, this
3514        variable will be used to sort this report."
3515    ::= { alMatrixTopNEntry 6 }
3516
3517alMatrixTopNReversePktRate OBJECT-TYPE
3518    SYNTAX     Gauge32
3519    MAX-ACCESS read-only
3520    STATUS     current
3521    DESCRIPTION
3522        "The number of packets seen of this protocol from the
3523        destination host to the source host during this sampling
3524        interval, counted using the rules for counting the
3525        alMatrixDSPkts object.  (Note that the corresponding
3526        alMatrixSDPkts object selected is the one whose source address
3527        is equal to alMatrixTopNDestAddress and whose destination
3528        address is equal to alMatrixTopNSourceAddress.)
3529
3530        Note that if the value of alMatrixTopNControlRateBase is equal
3531        to alMatrixTopNTerminalsPkts or alMatrixTopNAllPkts, the sort
3532        of topN entries is based entirely on alMatrixTopNPktRate, and
3533        not on the value of this object."
3534    ::= { alMatrixTopNEntry 7 }
3535
3536alMatrixTopNOctetRate OBJECT-TYPE
3537    SYNTAX     Gauge32
3538    MAX-ACCESS read-only
3539    STATUS     current
3540    DESCRIPTION
3541        "The number of octets seen of this protocol from the source
3542        host to the destination host during this sampling interval,
3543        counted using the rules for counting the alMatrixSDOctets
3544        object.
3545
3546        If the value of alMatrixTopNControlRateBase is
3547        alMatrixTopNTerminalsOctets or alMatrixTopNAllOctets, this
3548        variable will be used to sort this report."
3549    ::= { alMatrixTopNEntry 8 }
3550
3551alMatrixTopNReverseOctetRate OBJECT-TYPE
3552    SYNTAX     Gauge32
3553    MAX-ACCESS read-only
3554    STATUS     current
3555    DESCRIPTION
3556        "The number of octets seen of this protocol from the
3557        destination host to the source host during this sampling
3558        interval, counted using the rules for counting the
3559        alMatrixDSOctets object.  (Note that the corresponding
3560        alMatrixSDOctets object selected is the one whose source
3561        address is equal to alMatrixTopNDestAddress and whose
3562        destination address is equal to alMatrixTopNSourceAddress.)
3563
3564        Note that if the value of alMatrixTopNControlRateBase is equal
3565        to alMatrixTopNTerminalsOctets or alMatrixTopNAllOctets, the
3566        sort of topN entries is based entirely on
3567        alMatrixTopNOctetRate, and not on the value of this object."
3568    ::= { alMatrixTopNEntry 9 }
3569
3570--
3571-- User History Collection Group (usrHistory)
3572--
3573-- The usrHistory group combines mechanisms seen in the alarm and
3574-- history groups to provide user-specified history collection,
3575-- utilizing two additional control tables and one additional data
3576-- table.  This function has traditionally been done by NMS
3577-- applications, via periodic polling.  The usrHistory group allows
3578-- this task to be offloaded to an RMON probe.
3579--
3580-- Data (an ASN.1 INTEGER based object) is collected in the same
3581-- manner as any history data table (e.g., etherHistoryTable) except
3582-- that the user specifies the MIB instances to be collected.  Objects
3583-- are collected in bucket-groups, with the intent that all MIB
3584-- instances in the same bucket-group are collected as atomically as
3585-- possible by the RMON probe.
3586--
3587-- The usrHistoryControlTable is a one-dimensional read-create table.
3588-- Each row configures a collection of user history buckets, much
3589-- the same as a historyControlEntry, except that the creation of a
3590-- row in this table will cause one or more associated instances in
3591-- the usrHistoryObjectTable to be created.  The user specifies the
3592-- number of bucket elements (rows in the usrHistoryObjectTable)
3593-- requested, as well as the number of buckets requested.
3594--
3595-- The usrHistoryObjectTable is a 2-d read-write table.
3596-- Each row configures a single MIB instance to be collected.
3597-- All rows with the same major index constitute a bucket-group.
3598--
3599-- The usrHistoryTable is a 3-d read-only table containing
3600
3601-- the data of associated usrHistoryControlEntries.  Each
3602-- entry represents the value of a single MIB instance
3603-- during a specific sampling interval (or the rate of
3604-- change during the interval).
3605--
3606-- A sample value is stored in two objects - an absolute value and
3607-- a status object.  This allows numbers from -(2G-1) to +4G to be
3608-- stored.  The status object also indicates whether a sample is
3609-- valid.  This allows data collection to continue if periodic
3610-- retrieval of a particular instance fails for any reason.
3611--
3612-- Row Creation Order Relationships
3613--
3614-- The static nature of the usrHistoryObjectTable creates
3615-- some row creation/modification issues.  The rows in this
3616-- table need to be set before the associated
3617-- usrHistoryControlEntry can be activated.
3618--
3619-- Note that the usrHistoryObject entries associated with a
3620-- particular usrHistoryControlEntry are not required to
3621-- be active before the control entry is activated.  However,
3622-- the usrHistory data entries associated with an inactive
3623-- usrHistoryObject entry will be inactive (i.e.,
3624-- usrHistoryValStatus == valueNotAvailable).
3625--
3626
3627usrHistoryControlTable OBJECT-TYPE
3628    SYNTAX SEQUENCE OF UsrHistoryControlEntry
3629    MAX-ACCESS not-accessible
3630    STATUS current
3631    DESCRIPTION
3632        "A list of data-collection configuration entries."
3633    ::= { usrHistory 1 }
3634
3635usrHistoryControlEntry OBJECT-TYPE
3636    SYNTAX UsrHistoryControlEntry
3637    MAX-ACCESS not-accessible
3638    STATUS current
3639    DESCRIPTION
3640        "A list of parameters that set up a group of user-defined
3641        MIB objects to be sampled periodically (called a
3642        bucket-group).
3643
3644        For example, an instance of usrHistoryControlInterval
3645        might be named usrHistoryControlInterval.1"
3646    INDEX { usrHistoryControlIndex }
3647    ::= { usrHistoryControlTable 1 }
3648
3649UsrHistoryControlEntry ::= SEQUENCE {
3650    usrHistoryControlIndex             Integer32,
3651    usrHistoryControlObjects           Integer32,
3652    usrHistoryControlBucketsRequested  Integer32,
3653    usrHistoryControlBucketsGranted    Integer32,
3654    usrHistoryControlInterval          Integer32,
3655    usrHistoryControlOwner             OwnerString,
3656    usrHistoryControlStatus            RowStatus
3657}
3658
3659usrHistoryControlIndex OBJECT-TYPE
3660    SYNTAX Integer32 (1..65535)
3661    MAX-ACCESS not-accessible
3662    STATUS current
3663    DESCRIPTION
3664        "An index that uniquely identifies an entry in the
3665        usrHistoryControlTable.  Each such entry defines a
3666        set of samples at a particular interval for a specified
3667        set of MIB instances available from the managed system."
3668    ::= { usrHistoryControlEntry 1 }
3669
3670usrHistoryControlObjects OBJECT-TYPE
3671    SYNTAX Integer32 (1..65535)
3672    MAX-ACCESS read-create
3673    STATUS current
3674    DESCRIPTION
3675        "The number of MIB objects to be collected
3676        in the portion of usrHistoryTable associated with this
3677        usrHistoryControlEntry.
3678
3679        This object may not be modified if the associated instance
3680        of usrHistoryControlStatus is equal to active(1)."
3681    ::= { usrHistoryControlEntry 2 }
3682
3683usrHistoryControlBucketsRequested OBJECT-TYPE
3684    SYNTAX Integer32 (1..65535)
3685    MAX-ACCESS read-create
3686    STATUS current
3687    DESCRIPTION
3688        "The requested number of discrete time intervals
3689        over which data is to be saved in the part of the
3690        usrHistoryTable associated with this usrHistoryControlEntry.
3691
3692        When this object is created or modified, the probe
3693        should set usrHistoryControlBucketsGranted as closely to
3694        this object as possible for the particular probe
3695        implementation and available resources."
3696    DEFVAL { 50 }
3697    ::= { usrHistoryControlEntry 3 }
3698
3699usrHistoryControlBucketsGranted OBJECT-TYPE
3700    SYNTAX Integer32 (1..65535)
3701    MAX-ACCESS read-only
3702    STATUS current
3703    DESCRIPTION
3704        "The number of discrete sampling intervals
3705        over which data shall be saved in the part of
3706        the usrHistoryTable associated with this
3707        usrHistoryControlEntry.
3708
3709        When the associated usrHistoryControlBucketsRequested
3710        object is created or modified, the probe should set
3711        this object as closely to the requested value as
3712        possible for the particular probe implementation and
3713        available resources.  The probe must not lower this
3714        value except as a result of a modification to the associated
3715        usrHistoryControlBucketsRequested object.
3716
3717        The associated usrHistoryControlBucketsRequested object
3718        should be set before or at the same time as this object
3719        to allow the probe to accurately estimate the resources
3720        required for this usrHistoryControlEntry.
3721
3722        There will be times when the actual number of buckets
3723        associated with this entry is less than the value of
3724        this object.  In this case, at the end of each sampling
3725        interval, a new bucket will be added to the usrHistoryTable.
3726
3727        When the number of buckets reaches the value of this object
3728        and a new bucket is to be added to the usrHistoryTable,
3729        the oldest bucket associated with this usrHistoryControlEntry
3730        shall be deleted by the agent so that the new bucket can be
3731        added.
3732
3733        When the value of this object changes to a value less than
3734        the current value, entries are deleted from the
3735        usrHistoryTable associated with this usrHistoryControlEntry.
3736        Enough of the oldest of these entries shall be deleted by the
3737        agent so that their number remains less than or equal to the
3738        new value of this object.
3739
3740        When the value of this object changes to a value greater
3741        than the current value, the number of associated usrHistory
3742        entries may be allowed to grow."
3743    ::= { usrHistoryControlEntry 4 }
3744
3745usrHistoryControlInterval OBJECT-TYPE
3746    SYNTAX Integer32 (1..2147483647)
3747    MAX-ACCESS read-create
3748    STATUS current
3749    DESCRIPTION
3750        "The interval in seconds over which the data is
3751        sampled for each bucket in the part of the usrHistory
3752        table associated with this usrHistoryControlEntry.
3753
3754        Because the counters in a bucket may overflow at their
3755        maximum value with no indication, a prudent manager will
3756        take into account the possibility of overflow in any of
3757        the associated counters.  It is important to consider the
3758        minimum time in which any counter could overflow on a
3759        particular media type and to set the usrHistoryControlInterval
3760        object to a value less than this interval.
3761
3762        This object may not be modified if the associated
3763        usrHistoryControlStatus object is equal to active(1)."
3764    DEFVAL { 1800 }
3765    ::= { usrHistoryControlEntry 5 }
3766
3767usrHistoryControlOwner OBJECT-TYPE
3768    SYNTAX OwnerString
3769    MAX-ACCESS read-create
3770    STATUS current
3771    DESCRIPTION
3772        "The entity that configured this entry and is
3773        therefore using the resources assigned to it."
3774    ::= { usrHistoryControlEntry 6 }
3775
3776usrHistoryControlStatus OBJECT-TYPE
3777    SYNTAX RowStatus
3778    MAX-ACCESS read-create
3779    STATUS current
3780    DESCRIPTION
3781        "The status of this variable history control entry.
3782
3783        An entry may not exist in the active state unless all
3784        objects in the entry have an appropriate value.
3785
3786        If this object is not equal to active(1), all associated
3787        entries in the usrHistoryTable shall be deleted."
3788    ::= { usrHistoryControlEntry 7 }
3789
3790-- Object table
3791
3792usrHistoryObjectTable OBJECT-TYPE
3793    SYNTAX SEQUENCE OF UsrHistoryObjectEntry
3794    MAX-ACCESS not-accessible
3795    STATUS current
3796    DESCRIPTION
3797        "A list of data-collection configuration entries."
3798    ::= { usrHistory 2 }
3799
3800usrHistoryObjectEntry OBJECT-TYPE
3801    SYNTAX UsrHistoryObjectEntry
3802    MAX-ACCESS not-accessible
3803    STATUS current
3804    DESCRIPTION
3805        "A list of MIB instances to be sampled periodically.
3806
3807        Entries in this table are created when an associated
3808        usrHistoryControlObjects object is created.
3809
3810        The usrHistoryControlIndex value in the index is
3811        that of the associated usrHistoryControlEntry.
3812
3813        For example, an instance of usrHistoryObjectVariable might be
3814        usrHistoryObjectVariable.1.3"
3815    INDEX { usrHistoryControlIndex, usrHistoryObjectIndex }
3816    ::= { usrHistoryObjectTable 1 }
3817
3818UsrHistoryObjectEntry ::= SEQUENCE {
3819    usrHistoryObjectIndex             Integer32,
3820    usrHistoryObjectVariable          OBJECT IDENTIFIER,
3821    usrHistoryObjectSampleType        INTEGER
3822}
3823
3824usrHistoryObjectIndex OBJECT-TYPE
3825    SYNTAX Integer32 (1..65535)
3826    MAX-ACCESS not-accessible
3827    STATUS current
3828    DESCRIPTION
3829        "An index used to uniquely identify an entry in the
3830        usrHistoryObject table.  Each such entry defines a
3831        MIB instance to be collected periodically."
3832    ::= { usrHistoryObjectEntry 1 }
3833
3834usrHistoryObjectVariable OBJECT-TYPE
3835    SYNTAX OBJECT IDENTIFIER
3836    MAX-ACCESS read-create
3837    STATUS current
3838    DESCRIPTION
3839        "The object identifier of the particular variable to be
3840
3841        sampled.
3842
3843        Only variables that resolve to an ASN.1 primitive type of
3844        Integer32 (Integer32, Counter, Gauge, or TimeTicks) may be
3845        sampled.
3846
3847        Because SNMP access control is articulated entirely in terms
3848        of the contents of MIB views, no access control mechanism
3849        exists that can restrict the value of this object to identify
3850        only those objects that exist in a particular MIB view.
3851        Because there is thus no acceptable means of restricting the
3852        read access that could be obtained through the user history
3853        mechanism, the probe must only grant write access to this
3854        object in those views that have read access to all objects on
3855        the probe.  See USM [RFC3414] and VACM [RFC3415] for more
3856        information.
3857
3858        During a set operation, if the supplied variable name is not
3859        available in the selected MIB view, a badValue error must be
3860        returned.
3861
3862        This object may not be modified if the associated
3863        usrHistoryControlStatus object is equal to active(1)."
3864    ::= { usrHistoryObjectEntry 2 }
3865
3866usrHistoryObjectSampleType OBJECT-TYPE
3867    SYNTAX INTEGER {
3868               absoluteValue(1),
3869               deltaValue(2)
3870           }
3871    MAX-ACCESS read-create
3872    STATUS current
3873    DESCRIPTION
3874        "The method of sampling the selected variable for storage in
3875        the usrHistoryTable.
3876
3877        If the value of this object is absoluteValue(1), the value of
3878        the selected variable will be copied directly into the history
3879        bucket.
3880
3881        If the value of this object is deltaValue(2), the value of the
3882        selected variable at the last sample will be subtracted from
3883        the current value, and the difference will be stored in the
3884        history bucket.  If the associated usrHistoryObjectVariable
3885        instance could not be obtained at the previous sample
3886        interval, then a delta sample is not possible, and the value
3887        of the associated usrHistoryValStatus object for this interval
3888        will be valueNotAvailable(1).
3889
3890        This object may not be modified if the associated
3891        usrHistoryControlStatus object is equal to active(1)."
3892    ::= { usrHistoryObjectEntry 3 }
3893
3894-- data table
3895
3896usrHistoryTable OBJECT-TYPE
3897    SYNTAX SEQUENCE OF UsrHistoryEntry
3898    MAX-ACCESS not-accessible
3899    STATUS current
3900    DESCRIPTION
3901        "A list of user-defined history entries."
3902    ::= { usrHistory 3 }
3903
3904usrHistoryEntry OBJECT-TYPE
3905    SYNTAX UsrHistoryEntry
3906    MAX-ACCESS not-accessible
3907    STATUS current
3908    DESCRIPTION
3909        "A historical sample of user-defined variables.  This sample
3910        is associated with the usrHistoryControlEntry that set up the
3911        parameters for a regular collection of these samples.
3912
3913        The usrHistoryControlIndex value in the index identifies the
3914        usrHistoryControlEntry on whose behalf this entry was created.
3915        The usrHistoryObjectIndex value in the index identifies the
3916        usrHistoryObjectEntry on whose behalf this entry was created.
3917
3918        For example, an instance of usrHistoryAbsValue, which represents
3919        the 14th sample of a variable collected as specified by
3920        usrHistoryControlEntry.1 and usrHistoryObjectEntry.1.5,
3921        would be named usrHistoryAbsValue.1.14.5"
3922    INDEX { usrHistoryControlIndex, usrHistorySampleIndex,
3923            usrHistoryObjectIndex }
3924    ::= { usrHistoryTable 1 }
3925
3926UsrHistoryEntry ::= SEQUENCE {
3927    usrHistorySampleIndex   Integer32,
3928    usrHistoryIntervalStart TimeStamp,
3929    usrHistoryIntervalEnd   TimeStamp,
3930    usrHistoryAbsValue      Gauge32,
3931    usrHistoryValStatus     INTEGER
3932}
3933
3934usrHistorySampleIndex OBJECT-TYPE
3935    SYNTAX     Integer32 (1..2147483647)
3936    MAX-ACCESS not-accessible
3937    STATUS     current
3938    DESCRIPTION
3939        "An index that uniquely identifies the particular sample this
3940        entry represents among all samples associated with the same
3941        usrHistoryControlEntry.  This index starts at 1 and increases
3942        by one as each new sample is taken."
3943    ::= { usrHistoryEntry 1 }
3944
3945usrHistoryIntervalStart OBJECT-TYPE
3946    SYNTAX TimeStamp
3947    MAX-ACCESS read-only
3948    STATUS current
3949    DESCRIPTION
3950        "The value of sysUpTime at the start of the interval over
3951        which this sample was measured.  If the probe keeps track of
3952        the time of day, it should start the first sample of the
3953        history at a time such that when the next hour of the day
3954        begins, a sample is started at that instant.
3955
3956        Note that following this rule may require that the probe delay
3957        collecting the first sample of the history, as each sample
3958        must be of the same interval.  Also note that the sample that
3959        is currently being collected is not accessible in this table
3960        until the end of its interval."
3961    ::= { usrHistoryEntry 2 }
3962
3963usrHistoryIntervalEnd OBJECT-TYPE
3964    SYNTAX TimeStamp
3965    MAX-ACCESS read-only
3966    STATUS current
3967    DESCRIPTION
3968        "The value of sysUpTime at the end of the interval over which
3969        this sample was measured."
3970    ::= { usrHistoryEntry 3 }
3971
3972usrHistoryAbsValue OBJECT-TYPE
3973    SYNTAX Gauge32
3974    MAX-ACCESS read-only
3975    STATUS current
3976    DESCRIPTION
3977        "The absolute value (i.e., unsigned value) of the
3978        user-specified statistic during the last sampling period.  The
3979        value during the current sampling period is not made available
3980        until the period is completed.
3981
3982        To obtain the true value for this sampling interval, the
3983        associated instance of usrHistoryValStatus must be checked,
3984        and usrHistoryAbsValue adjusted as necessary.
3985
3986        If the MIB instance could not be accessed during the sampling
3987        interval, then this object will have a value of zero, and the
3988        associated instance of usrHistoryValStatus will be set to
3989        'valueNotAvailable(1)'.
3990
3991        The access control check prescribed in the definition of
3992        usrHistoryObjectVariable SHOULD be checked for each sampling
3993        interval.  If this check determines that access should not be
3994        allowed, then this object will have a value of zero, and the
3995        associated instance of usrHistoryValStatus will be set to
3996        'valueNotAvailable(1)'."
3997    ::= { usrHistoryEntry 4 }
3998
3999usrHistoryValStatus OBJECT-TYPE
4000    SYNTAX INTEGER {
4001        valueNotAvailable(1),
4002        valuePositive(2),
4003        valueNegative(3)
4004    }
4005    MAX-ACCESS read-only
4006    STATUS current
4007    DESCRIPTION
4008        "This object indicates the validity and sign of the data in
4009        the associated instance of usrHistoryAbsValue.
4010
4011        If the MIB instance could not be accessed during the sampling
4012        interval, then 'valueNotAvailable(1)' will be returned.
4013
4014        If the sample is valid and the actual value of the sample is
4015        greater than or equal to zero, then 'valuePositive(2)' is
4016        returned.
4017
4018        If the sample is valid and the actual value of the sample is
4019        less than zero, 'valueNegative(3)' will be returned.  The
4020        associated instance of usrHistoryAbsValue should be multiplied
4021        by -1 to obtain the true sample value."
4022    ::= { usrHistoryEntry 5 }
4023
4024-- The Probe Configuration Group
4025--
4026-- This group controls the configuration of various operating
4027-- parameters of the probe.
4028
4029ControlString ::= TEXTUAL-CONVENTION
4030    STATUS current
4031    DESCRIPTION
4032        "This data type is used to communicate with a modem or a
4033
4034        serial data switch.  A ControlString contains embedded
4035        commands to control how the device will interact with the
4036        remote device through the serial interface.  Commands are
4037        represented as two-character sequences beginning with
4038        the '^' character.
4039
4040        The following commands are recognized by the device (note
4041        that command characters are case sensitive):
4042
4043           ^s  Send string that follows, which is terminated by the
4044               next command or the end of string.
4045           ^c  Delay for the number of seconds that follows.  Toss
4046               out any data received rather than store it in a
4047               buffer for parsing.
4048           ^t  Set timeout to the value represented by the decimal
4049               digits that follow.  The default timeout is 20
4050               seconds.  Note that this timeout may be overridden
4051               by a smaller serialTimeout configured for the
4052               associated serial interface (see serialConfigTable).
4053           ^w  Wait for the reply string that follows, which is
4054               terminated by the next command or the end of string.
4055               Partial and case-insensitive matching is applied, i.e.,
4056               if the reply string (any case combination) is found
4057               anywhere in the received string, then the a match is
4058               found.  If the current timeout elapses without a match,
4059               then the remaining control string is ignored.
4060           ^!  The ^ character.
4061           ^d  Delay the number of seconds specified by the decimal
4062               digits that follow.
4063           ^b  Send break for the number of milliseconds specified by
4064               the decimal digits that follow.  If no digits follow,
4065               break will be enforced for 250 milliseconds by default.
4066
4067        The following ASCII control characters may be inserted into
4068        the '^s' send string or the '^w' reply string:
4069
4070           ^@    0x00
4071           ^A    0x01
4072            ..
4073           ^M    0x0D
4074            ..
4075           ^Z    0x1A
4076           ^[    0x1B
4077           ^    0x1C
4078           ^]    0x1D
4079           ^^    0x1E
4080           ^_    0x1F
4081
4082        Binary data may also be inserted into the data stream.  The
4083        control sequence for each byte of binary data is ^0x##, where
4084        ## is the hexadecimal representation of the data byte.  Two
4085        ASCII characters (0-9, a-f, A-F) must follow the '^0x'
4086        control prefix.  For example, '^0x0D^0x0A' is interpreted as a
4087        carriage return followed by a line feed."
4088    SYNTAX OCTET STRING (SIZE (0..255))
4089
4090probeCapabilities OBJECT-TYPE
4091    SYNTAX BITS {
4092        etherStats(0),
4093        historyControl(1),
4094        etherHistory(2),
4095        alarm(3),
4096        hosts(4),
4097        hostTopN(5),
4098        matrix(6),
4099        filter(7),
4100        capture(8),
4101        event(9),
4102        tokenRingMLStats(10),
4103        tokenRingPStats(11),
4104        tokenRingMLHistory(12),
4105        tokenRingPHistory(13),
4106        ringStation(14),
4107        ringStationOrder(15),
4108        ringStationConfig(16),
4109        sourceRouting(17),
4110        protocolDirectory(18),
4111        protocolDistribution(19),
4112        addressMapping(20),
4113        nlHost(21),
4114        nlMatrix(22),
4115        alHost(23),
4116        alMatrix(24),
4117        usrHistory(25),
4118        probeConfig(26)
4119    }
4120    MAX-ACCESS read-only
4121    STATUS current
4122    DESCRIPTION
4123        "An indication of the RMON MIB groups supported
4124        on at least one interface by this probe."
4125    ::= { probeConfig 1 }
4126
4127probeSoftwareRev  OBJECT-TYPE
4128    SYNTAX     DisplayString (SIZE(0..15))
4129    MAX-ACCESS read-only
4130    STATUS     current
4131    DESCRIPTION
4132        "The software revision of this device.  This string will have
4133        a zero length if the revision is unknown."
4134    ::= { probeConfig 2 }
4135
4136probeHardwareRev  OBJECT-TYPE
4137    SYNTAX     DisplayString (SIZE(0..31))
4138    MAX-ACCESS read-only
4139    STATUS     current
4140    DESCRIPTION
4141        "The hardware revision of this device.  This string will have
4142        a zero length if the revision is unknown."
4143    ::= { probeConfig 3 }
4144
4145probeDateTime  OBJECT-TYPE
4146    SYNTAX     OCTET STRING (SIZE (0 | 8 | 11))
4147    MAX-ACCESS read-write
4148    STATUS     current
4149    DESCRIPTION
4150        "Probe's current date and time.
4151
4152         field  octets  contents                  range
4153         -----  ------  --------                  -----
4154           1      1-2   year                      0..65536
4155           2       3    month                     1..12
4156           3       4    day                       1..31
4157           4       5    hour                      0..23
4158           5       6    minutes                   0..59
4159           6       7    seconds                   0..60
4160                         (use 60 for leap-second)
4161           7       8    deci-seconds              0..9
4162           8       9    direction from UTC        '+' / '-'
4163           9      10    hours from UTC            0..11
4164          10      11    minutes from UTC          0..59
4165
4166         For example, Tuesday May 26, 1992 at 1:30:15 PM
4167         EDT would be displayed as:
4168
4169                     1992-5-26,13:30:15.0,-4:0
4170
4171         Note that if only local time is known, then
4172         time zone information (fields 8-10) is not
4173         present, and that if no time information is known, the
4174         null string is returned."
4175    ::= { probeConfig 4 }
4176
4177probeResetControl  OBJECT-TYPE
4178    SYNTAX     INTEGER {
4179                    running(1),
4180                    warmBoot(2),
4181                    coldBoot(3)
4182              }
4183    MAX-ACCESS read-write
4184    STATUS     current
4185    DESCRIPTION
4186        "Setting this object to warmBoot(2) causes the device to
4187        restart the application software with current configuration
4188        parameters saved in non-volatile memory.  Setting this
4189        object to coldBoot(3) causes the device to reinitialize
4190        configuration parameters in non-volatile memory to default
4191        values and to restart the application software.  When the device
4192        is running normally, this variable has a value of
4193        running(1)."
4194    ::= { probeConfig 5 }
4195
4196-- The following download objects do not restrict an implementation
4197-- from implementing additional download mechanisms (controlled in an
4198-- implementation-specific manner).  Further, in the case where the RMON
4199-- agent shares a processor with other types of systems, the
4200-- implementation is not required to download those non-RMON functions
4201-- with this mechanism.
4202
4203probeDownloadFile  OBJECT-TYPE
4204    SYNTAX     DisplayString (SIZE(0..127))
4205    MAX-ACCESS read-write
4206    STATUS     deprecated
4207    DESCRIPTION
4208        "The file name to be downloaded from the TFTP server when a
4209        download is next requested via this MIB.  This value is set to
4210        the zero-length string when no file name has been specified.
4211
4212        This object has been deprecated, as it has not had enough
4213        independent implementations to demonstrate interoperability to
4214        meet the requirements of a Draft Standard."
4215    ::= { probeConfig 6 }
4216
4217probeDownloadTFTPServer  OBJECT-TYPE
4218    SYNTAX     IpAddress
4219    MAX-ACCESS read-write
4220    STATUS     deprecated
4221    DESCRIPTION
4222        "The IP address of the TFTP server that contains the boot
4223        image to load when a download is next requested via this MIB.
4224        This value is set to '0.0.0.0' when no IP address has been
4225
4226        specified.
4227
4228        This object has been deprecated, as it has not had enough
4229        independent implementations to demonstrate interoperability to
4230        meet the requirements of a Draft Standard."
4231    ::= { probeConfig 7 }
4232
4233probeDownloadAction  OBJECT-TYPE
4234    SYNTAX     INTEGER {
4235                  notDownloading(1),
4236                  downloadToPROM(2),
4237                  downloadToRAM(3)
4238               }
4239    MAX-ACCESS read-write
4240    STATUS     deprecated
4241    DESCRIPTION
4242        "When this object is set to downloadToRAM(3) or
4243        downloadToPROM(2), the device will discontinue its
4244        normal operation and begin download of the image specified
4245        by probeDownloadFile from the server specified by
4246        probeDownloadTFTPServer using the TFTP protocol.  If
4247        downloadToRAM(3) is specified, the new image is copied
4248        to RAM only (the old image remains unaltered in the flash
4249        EPROM).  If downloadToPROM(2) is specified,
4250        the new image is written to the flash EPROM
4251        memory after its checksum has been verified to be correct.
4252        When the download process is completed, the device will
4253        warm boot to restart the newly loaded application.
4254        When the device is not downloading, this object will have
4255        a value of notDownloading(1).
4256
4257        This object has been deprecated, as it has not had enough
4258        independent implementations to demonstrate interoperability to
4259        meet the requirements of a Draft Standard."
4260    ::= { probeConfig 8 }
4261
4262probeDownloadStatus  OBJECT-TYPE
4263    SYNTAX     INTEGER {
4264                    downloadSuccess(1),
4265                    downloadStatusUnknown(2),
4266                    downloadGeneralError(3),
4267                    downloadNoResponseFromServer(4),
4268                    downloadChecksumError(5),
4269                    downloadIncompatibleImage(6),
4270                    downloadTftpFileNotFound(7),
4271                    downloadTftpAccessViolation(8)
4272               }
4273    MAX-ACCESS read-only
4274    STATUS     deprecated
4275    DESCRIPTION
4276        "The status of the last download procedure, if any.  This
4277        object will have a value of downloadStatusUnknown(2) if no
4278        download process has been performed.
4279
4280        This object has been deprecated, as it has not had enough
4281        independent implementations to demonstrate interoperability to
4282        meet the requirements of a Draft Standard."
4283    ::= { probeConfig 9 }
4284
4285serialConfigTable  OBJECT-TYPE
4286    SYNTAX     SEQUENCE OF SerialConfigEntry
4287    MAX-ACCESS not-accessible
4288    STATUS     deprecated
4289    DESCRIPTION
4290        "A table of serial interface configuration entries.  This data
4291        will be stored in non-volatile memory and preserved across
4292        probe resets or power loss.
4293
4294        This table has been deprecated, as it has not had enough
4295        independent implementations to demonstrate interoperability to
4296        meet the requirements of a Draft Standard."
4297    ::= { probeConfig 10 }
4298
4299serialConfigEntry  OBJECT-TYPE
4300    SYNTAX     SerialConfigEntry
4301    MAX-ACCESS not-accessible
4302    STATUS     deprecated
4303    DESCRIPTION
4304        "A set of configuration parameters for a particular
4305        serial interface on this device.  If the device has no serial
4306        interfaces, this table is empty.
4307
4308        The index is composed of the ifIndex assigned to this serial
4309        line interface."
4310    INDEX  { ifIndex }
4311    ::= { serialConfigTable 1 }
4312
4313SerialConfigEntry ::= SEQUENCE {
4314    serialMode                   INTEGER,
4315    serialProtocol               INTEGER,
4316    serialTimeout                Integer32,
4317    serialModemInitString        ControlString,
4318    serialModemHangUpString      ControlString,
4319    serialModemConnectResp       DisplayString,
4320    serialModemNoConnectResp     DisplayString,
4321    serialDialoutTimeout         Integer32,
4322    serialStatus                 RowStatus
4323}
4324
4325serialMode  OBJECT-TYPE
4326    SYNTAX     INTEGER {
4327                   direct(1),
4328                   modem(2)
4329               }
4330    MAX-ACCESS read-create
4331    STATUS     deprecated
4332    DESCRIPTION
4333        "The type of incoming connection to be expected on this
4334         serial interface."
4335    DEFVAL { direct }
4336    ::= { serialConfigEntry 1 }
4337
4338serialProtocol  OBJECT-TYPE
4339    SYNTAX     INTEGER {
4340                   other(1),
4341                   slip(2),
4342                   ppp(3)
4343               }
4344    MAX-ACCESS read-create
4345    STATUS     deprecated
4346    DESCRIPTION
4347        "The type of data link encapsulation to be used on this
4348        serial interface."
4349    DEFVAL { slip }
4350    ::= { serialConfigEntry 2 }
4351
4352serialTimeout  OBJECT-TYPE
4353    SYNTAX     Integer32 (1..65535)
4354    MAX-ACCESS read-create
4355    STATUS     deprecated
4356    DESCRIPTION
4357        "This timeout value is used when the Management Station has
4358        initiated the conversation over the serial link.  This variable
4359        represents the number of seconds of inactivity allowed before
4360        terminating the connection on this serial interface.  Use the
4361        serialDialoutTimeout in the case where the probe has initiated
4362        the connection for the purpose of sending a trap."
4363    DEFVAL { 300 }
4364    ::= { serialConfigEntry 3 }
4365
4366serialModemInitString  OBJECT-TYPE
4367    SYNTAX     ControlString (SIZE (0..255))
4368    MAX-ACCESS read-create
4369    STATUS     deprecated
4370    DESCRIPTION
4371        "A control string that controls how a modem attached to this
4372        serial interface should be initialized.  The initialization
4373        is performed once during startup and again after each
4374        connection is terminated if the associated serialMode has the
4375        value of modem(2).
4376
4377        A control string that is appropriate for a wide variety of
4378        modems is: '^s^MATE0Q0V1X4 S0=1 S2=43^M'."
4379    ::= { serialConfigEntry 4 }
4380
4381serialModemHangUpString  OBJECT-TYPE
4382    SYNTAX     ControlString (SIZE (0..255))
4383    MAX-ACCESS read-create
4384    STATUS     deprecated
4385    DESCRIPTION
4386        "A control string that specifies how to disconnect a modem
4387         connection on this serial interface.  This object is only
4388         meaningful if the associated serialMode has the value
4389         of modem(2).
4390
4391         A control string that is appropriate for a wide variety of
4392         modems is: '^d2^s+++^d2^sATH0^M^d2'."
4393    ::= { serialConfigEntry 5 }
4394
4395serialModemConnectResp  OBJECT-TYPE
4396    SYNTAX     DisplayString (SIZE (0..255))
4397    MAX-ACCESS read-create
4398    STATUS     deprecated
4399    DESCRIPTION
4400        "An ASCII string containing substrings that describe the
4401        expected modem connection response code and associated bps
4402        rate.  The substrings are delimited by the first character
4403        in the string, for example:
4404           /CONNECT/300/CONNECT 1200/1200/CONNECT 2400/2400/
4405           CONNECT 4800/4800/CONNECT 9600/9600
4406        will be interpreted as:
4407            response code    bps rate
4408            CONNECT            300
4409            CONNECT 1200      1200
4410            CONNECT 2400      2400
4411            CONNECT 4800      4800
4412            CONNECT 9600      9600
4413        The agent will use the information in this string to adjust
4414        the bps rate of this serial interface once a modem connection
4415        is established.
4416
4417        A value that is appropriate for a wide variety of modems is:
4418
4419        '/CONNECT/300/CONNECT 1200/1200/CONNECT 2400/2400/
4420         CONNECT 4800/4800/CONNECT 9600/9600/CONNECT 14400/14400/
4421        CONNECT 19200/19200/CONNECT 38400/38400/'."
4422    ::= { serialConfigEntry 6 }
4423
4424serialModemNoConnectResp  OBJECT-TYPE
4425    SYNTAX     DisplayString (SIZE (0..255))
4426    MAX-ACCESS read-create
4427    STATUS     deprecated
4428    DESCRIPTION
4429        "An ASCII string containing response codes that may be
4430        generated by a modem to report the reason why a connection
4431        attempt has failed.  The response codes are delimited by
4432        the first character in the string, for example:
4433           /NO CARRIER/BUSY/NO DIALTONE/NO ANSWER/ERROR/
4434
4435        If one of these response codes is received via this serial
4436        interface while attempting to make a modem connection,
4437        the agent will issue the hang up command as specified by
4438        serialModemHangUpString.
4439
4440        A value that is appropriate for a wide variety of modems is:
4441        '/NO CARRIER/BUSY/NO DIALTONE/NO ANSWER/ERROR/'."
4442    ::= { serialConfigEntry 7 }
4443
4444serialDialoutTimeout  OBJECT-TYPE
4445    SYNTAX     Integer32 (1..65535)
4446    MAX-ACCESS read-create
4447    STATUS     deprecated
4448    DESCRIPTION
4449        "This timeout value is used when the probe initiates the
4450        serial connection with the intention of contacting a
4451        management station.  This variable represents the number
4452        of seconds of inactivity allowed before terminating the
4453        connection on this serial interface."
4454    DEFVAL { 20 }
4455    ::= { serialConfigEntry 8 }
4456
4457serialStatus  OBJECT-TYPE
4458    SYNTAX     RowStatus
4459    MAX-ACCESS read-create
4460    STATUS     deprecated
4461    DESCRIPTION
4462        "The status of this serialConfigEntry.
4463
4464        An entry may not exist in the active state unless all
4465        objects in the entry have an appropriate value."
4466    ::= { serialConfigEntry 9 }
4467
4468netConfigTable  OBJECT-TYPE
4469    SYNTAX     SEQUENCE OF NetConfigEntry
4470    MAX-ACCESS not-accessible
4471    STATUS     deprecated
4472    DESCRIPTION
4473        "A table of netConfigEntries.
4474
4475        This table has been deprecated, as it has not had enough
4476        independent implementations to demonstrate interoperability to
4477        meet the requirements of a Draft Standard."
4478    ::= { probeConfig 11 }
4479
4480netConfigEntry  OBJECT-TYPE
4481    SYNTAX     NetConfigEntry
4482    MAX-ACCESS not-accessible
4483    STATUS     deprecated
4484    DESCRIPTION
4485        "A set of configuration parameters for a particular
4486        network interface on this device.  If the device has no network
4487        interface, this table is empty.
4488
4489        The index is composed of the ifIndex assigned to the
4490        corresponding interface."
4491    INDEX  { ifIndex }
4492    ::= { netConfigTable 1 }
4493
4494NetConfigEntry ::= SEQUENCE {
4495    netConfigIPAddress         IpAddress,
4496    netConfigSubnetMask        IpAddress,
4497    netConfigStatus            RowStatus
4498}
4499
4500netConfigIPAddress  OBJECT-TYPE
4501    SYNTAX     IpAddress
4502    MAX-ACCESS read-create
4503    STATUS     deprecated
4504    DESCRIPTION
4505        "The IP address of this Net interface.  The default value
4506        for this object is 0.0.0.0.  If either the netConfigIPAddress
4507        or netConfigSubnetMask is 0.0.0.0, then when the device
4508        boots, it may use BOOTP to try to figure out what these
4509        values should be.  If BOOTP fails before the device
4510        can talk on the network, this value must be configured
4511        (e.g., through a terminal attached to the device).  If BOOTP is
4512        used, care should be taken to not send BOOTP broadcasts too
4513        frequently and to eventually send them very infrequently if no
4514        replies are received."
4515    ::= { netConfigEntry 1 }
4516
4517netConfigSubnetMask  OBJECT-TYPE
4518    SYNTAX     IpAddress
4519    MAX-ACCESS read-create
4520    STATUS     deprecated
4521    DESCRIPTION
4522        "The subnet mask of this Net interface.  The default value
4523        for this object is 0.0.0.0.  If either the netConfigIPAddress
4524        or netConfigSubnetMask is 0.0.0.0, then when the device
4525        boots, it may use BOOTP to try to figure out what these
4526        values should be.  If BOOTP fails before the device
4527        can talk on the network, this value must be configured
4528        (e.g., through a terminal attached to the device).  If BOOTP is
4529        used, care should be taken to not send BOOTP broadcasts too
4530        frequently and to eventually send them very infrequently if no
4531        replies are received."
4532    ::= { netConfigEntry 2 }
4533
4534netConfigStatus  OBJECT-TYPE
4535    SYNTAX     RowStatus
4536    MAX-ACCESS read-create
4537    STATUS     deprecated
4538    DESCRIPTION
4539        "The status of this netConfigEntry.
4540
4541        An entry may not exist in the active state unless all
4542        objects in the entry have an appropriate value."
4543    ::= { netConfigEntry 3 }
4544
4545netDefaultGateway  OBJECT-TYPE
4546    SYNTAX     IpAddress
4547    MAX-ACCESS read-write
4548    STATUS     deprecated
4549    DESCRIPTION
4550        "The IP Address of the default gateway.  If this value is
4551        undefined or unknown, it shall have the value 0.0.0.0."
4552    ::= { probeConfig 12 }
4553
4554-- Trap Destination Table
4555--
4556-- This table defines the destination addresses for traps generated
4557-- from the device.  This table maps a community to one or more trap
4558-- destination entries.
4559--
4560-- The same trap will be sent to all destinations specified in the
4561-- entries that have the same trapDestCommunity as the eventCommunity
4562-- (as defined by RMON MIB), as long as no access control mechanism
4563-- (e.g., VACM) prohibits sending to one or more of the destinations.
4564-- Information in this table will be stored in non-volatile memory.
4565
4566-- If the device has gone through a hard restart, this information
4567-- will be reset to its default state.
4568
4569trapDestTable  OBJECT-TYPE
4570    SYNTAX     SEQUENCE OF TrapDestEntry
4571    MAX-ACCESS not-accessible
4572    STATUS     deprecated
4573    DESCRIPTION
4574        "A list of trap destination entries."
4575    ::= { probeConfig 13 }
4576
4577trapDestEntry  OBJECT-TYPE
4578    SYNTAX     TrapDestEntry
4579    MAX-ACCESS not-accessible
4580    STATUS     deprecated
4581    DESCRIPTION
4582        "This entry includes a destination IP address to which
4583        traps are sent for this community."
4584    INDEX { trapDestIndex }
4585    ::= { trapDestTable 1 }
4586
4587TrapDestEntry ::= SEQUENCE {
4588    trapDestIndex               Integer32,
4589    trapDestCommunity           OCTET STRING,
4590    trapDestProtocol            INTEGER,
4591    trapDestAddress             OCTET STRING,
4592    trapDestOwner               OwnerString,
4593    trapDestStatus              RowStatus
4594}
4595
4596trapDestIndex  OBJECT-TYPE
4597    SYNTAX     Integer32 (1..65535)
4598    MAX-ACCESS not-accessible
4599    STATUS     deprecated
4600    DESCRIPTION
4601        "A value that uniquely identifies this trapDestEntry."
4602    ::= { trapDestEntry 1 }
4603
4604trapDestCommunity  OBJECT-TYPE
4605    SYNTAX     OCTET STRING (SIZE(0..127))
4606    MAX-ACCESS read-create
4607    STATUS     deprecated
4608    DESCRIPTION
4609        "A community to which this destination address belongs.
4610        This entry is associated with any eventEntries in the RMON
4611        MIB whose value of eventCommunity is equal to the value of
4612        this object.  Every time an associated event entry sends a
4613        trap due to an event, that trap will be sent to each
4614
4615        address in the trapDestTable with a trapDestCommunity equal
4616        to eventCommunity, as long as no access control mechanism
4617        precludes it (e.g., VACM).
4618
4619        This object may not be modified if the associated
4620        trapDestStatus object is equal to active(1)."
4621    ::= { trapDestEntry 2 }
4622
4623trapDestProtocol OBJECT-TYPE
4624    SYNTAX     INTEGER {
4625                    ip(1),
4626                    ipx(2)
4627                }
4628    MAX-ACCESS read-create
4629    STATUS     deprecated
4630    DESCRIPTION
4631        "The protocol with which this trap is to be sent."
4632    ::= { trapDestEntry 3 }
4633
4634trapDestAddress  OBJECT-TYPE
4635    SYNTAX     OCTET STRING
4636    MAX-ACCESS read-create
4637    STATUS     deprecated
4638    DESCRIPTION
4639        "The destination address for traps on behalf of this entry.
4640
4641        If the associated trapDestProtocol object is equal to ip(1),
4642        the encoding of this object is the same as the snmpUDPAddress
4643        textual convention in RFC 3417, 'Transport Mappings for the
4644         Simple Network Management Protocol (SNMP)' [RFC3417]:
4645          -- for a SnmpUDPAddress of length 6:
4646          --
4647          -- octets   contents        encoding
4648          --  1-4     IP-address      network-byte order
4649          --  5-6     UDP-port        network-byte order
4650
4651        If the associated trapDestProtocol object is equal to ipx(2),
4652        the encoding of this object is the same as the snmpIPXAddress
4653        textual convention in RFC 3417, 'Transport Mappings for the
4654         Simple Network Management Protocol (SNMP)' [RFC3417]:
4655          -- for a SnmpIPXAddress of length 12:
4656          --
4657          -- octets   contents            encoding
4658          --  1-4     network-number      network-byte order
4659          --  5-10    physical-address    network-byte order
4660          -- 11-12    socket-number       network-byte order
4661
4662        This object may not be modified if the associated
4663
4664        trapDestStatus object is equal to active(1)."
4665    ::= { trapDestEntry 4 }
4666
4667trapDestOwner  OBJECT-TYPE
4668    SYNTAX     OwnerString
4669    MAX-ACCESS read-create
4670    STATUS     deprecated
4671    DESCRIPTION
4672        "The entity that configured this entry and is
4673        therefore using the resources assigned to it."
4674    ::= { trapDestEntry 5 }
4675
4676trapDestStatus  OBJECT-TYPE
4677    SYNTAX     RowStatus
4678    MAX-ACCESS read-create
4679    STATUS     deprecated
4680    DESCRIPTION
4681        "The status of this trap destination entry.
4682
4683        An entry may not exist in the active state unless all
4684        objects in the entry have an appropriate value."
4685    ::= { trapDestEntry 6 }
4686
4687-- Serial Connection Table
4688--
4689-- The device may communicate with a management station using
4690-- SLIP.  In order for the device to send traps via SLIP, it must
4691-- be able to initiate a connection over the serial interface.  The
4692-- serialConnectionTable stores the parameters for such connection
4693-- initiation.
4694
4695serialConnectionTable  OBJECT-TYPE
4696    SYNTAX     SEQUENCE OF SerialConnectionEntry
4697    MAX-ACCESS not-accessible
4698    STATUS     deprecated
4699    DESCRIPTION
4700        "A list of serialConnectionEntries.
4701
4702        This table has been deprecated, as it has not had enough
4703        independent implementations to demonstrate interoperability
4704        to meet the requirements of a Draft Standard."
4705    ::= { probeConfig 14 }
4706
4707serialConnectionEntry  OBJECT-TYPE
4708    SYNTAX     SerialConnectionEntry
4709    MAX-ACCESS not-accessible
4710    STATUS     deprecated
4711    DESCRIPTION
4712        "Configuration for a SLIP link over a serial line."
4713    INDEX { serialConnectIndex }
4714    ::= { serialConnectionTable 1 }
4715
4716SerialConnectionEntry ::= SEQUENCE {
4717    serialConnectIndex                   Integer32,
4718    serialConnectDestIpAddress           IpAddress,
4719    serialConnectType                    INTEGER,
4720    serialConnectDialString              ControlString,
4721    serialConnectSwitchConnectSeq        ControlString,
4722    serialConnectSwitchDisconnectSeq     ControlString,
4723    serialConnectSwitchResetSeq          ControlString,
4724    serialConnectOwner                   OwnerString,
4725    serialConnectStatus                  RowStatus
4726}
4727
4728serialConnectIndex  OBJECT-TYPE
4729    SYNTAX     Integer32 (1..65535)
4730    MAX-ACCESS not-accessible
4731    STATUS     deprecated
4732    DESCRIPTION
4733        "A value that uniquely identifies this serialConnection
4734        entry."
4735    ::= { serialConnectionEntry 1 }
4736
4737serialConnectDestIpAddress  OBJECT-TYPE
4738    SYNTAX     IpAddress
4739    MAX-ACCESS read-create
4740    STATUS     deprecated
4741    DESCRIPTION
4742        "The IP Address that can be reached at the other end of this
4743        serial connection.
4744
4745        This object may not be modified if the associated
4746        serialConnectStatus object is equal to active(1)."
4747    ::= { serialConnectionEntry 2 }
4748
4749serialConnectType  OBJECT-TYPE
4750    SYNTAX     INTEGER {
4751                    direct(1),
4752                    modem(2),
4753                    switch(3),
4754                    modemSwitch(4)
4755               }
4756    MAX-ACCESS read-create
4757    STATUS     deprecated
4758    DESCRIPTION
4759        "The type of outgoing connection to be made.  If this object
4760        has the value direct(1), then a direct serial connection
4761        is assumed.  If this object has the value modem(2),
4762        then serialConnectDialString will be used to make a modem
4763        connection.  If this object has the value switch(3),
4764        then serialConnectSwitchConnectSeq will be used to establish
4765        the connection over a serial data switch, and
4766        serialConnectSwitchDisconnectSeq will be used to terminate
4767        the connection.  If this object has the value
4768        modem-switch(4), then a modem connection will be made first,
4769        followed by the switch connection.
4770
4771        This object may not be modified if the associated
4772        serialConnectStatus object is equal to active(1)."
4773    DEFVAL { direct }
4774    ::= { serialConnectionEntry 3 }
4775
4776serialConnectDialString  OBJECT-TYPE
4777    SYNTAX     ControlString (SIZE(0..255))
4778    MAX-ACCESS read-create
4779    STATUS     deprecated
4780    DESCRIPTION
4781        "A control string that specifies how to dial the phone
4782        number in order to establish a modem connection.  The
4783        string should include the dialing prefix and suffix.  For
4784        example: '^s^MATD9,888-1234^M' will instruct the Probe
4785        to send a carriage return, followed by the dialing prefix
4786        'ATD', the phone number '9,888-1234', and a carriage
4787        return as the dialing suffix.
4788
4789        This object may not be modified if the associated
4790        serialConnectStatus object is equal to active(1)."
4791    ::= { serialConnectionEntry 4 }
4792
4793serialConnectSwitchConnectSeq  OBJECT-TYPE
4794    SYNTAX     ControlString (SIZE(0..255))
4795    MAX-ACCESS read-create
4796    STATUS     deprecated
4797    DESCRIPTION
4798        "A control string that specifies how to establish a
4799        data switch connection.
4800
4801        This object may not be modified if the associated
4802        serialConnectStatus object is equal to active(1)."
4803     ::= { serialConnectionEntry 5 }
4804
4805serialConnectSwitchDisconnectSeq  OBJECT-TYPE
4806    SYNTAX     ControlString (SIZE(0..255))
4807    MAX-ACCESS read-create
4808    STATUS     deprecated
4809    DESCRIPTION
4810        "A control string that specifies how to terminate a
4811        data switch connection.
4812
4813        This object may not be modified if the associated
4814        serialConnectStatus object is equal to active(1)."
4815    ::= { serialConnectionEntry 6 }
4816
4817serialConnectSwitchResetSeq  OBJECT-TYPE
4818    SYNTAX     ControlString (SIZE(0..255))
4819    MAX-ACCESS read-create
4820    STATUS     deprecated
4821    DESCRIPTION
4822        "A control string that specifies how to reset a data
4823        switch in the event of a timeout.
4824
4825        This object may not be modified if the associated
4826        serialConnectStatus object is equal to active(1)."
4827    ::= { serialConnectionEntry 7 }
4828
4829serialConnectOwner  OBJECT-TYPE
4830    SYNTAX     OwnerString
4831    MAX-ACCESS read-create
4832    STATUS     deprecated
4833    DESCRIPTION
4834        "The entity that configured this entry and is
4835        therefore using the resources assigned to it."
4836    ::= { serialConnectionEntry 8 }
4837
4838serialConnectStatus  OBJECT-TYPE
4839    SYNTAX     RowStatus
4840    MAX-ACCESS read-create
4841    STATUS     deprecated
4842    DESCRIPTION
4843        "The status of this serialConnectionEntry.
4844
4845        If the manager attempts to set this object to active(1) when
4846        the serialConnectType is set to modem(2) or modem-switch(4)
4847        and the serialConnectDialString is a zero-length string or
4848        cannot be correctly parsed as a ConnectString, the set
4849        request will be rejected with badValue(3).
4850
4851        If the manager attempts to set this object to active(1) when
4852        the serialConnectType is set to switch(3) or modem-switch(4)
4853        and the serialConnectSwitchConnectSeq,
4854        the serialConnectSwitchDisconnectSeq, or
4855
4856        the serialConnectSwitchResetSeq is a zero-length string
4857        or cannot be correctly parsed as a ConnectString, the set
4858        request will be rejected with badValue(3).
4859
4860        An entry may not exist in the active state unless all
4861        objects in the entry have an appropriate value."
4862    ::= { serialConnectionEntry 9 }
4863
4864--
4865-- Extensions to the RMON 1 MIB for RMON 2 devices
4866--
4867-- These extensions include the standard LastCreateTime Textual
4868-- Convention for all control tables, as well as an augmentation of
4869-- the filter entry that provides variable-length offsets into
4870-- packets.
4871
4872-- Each of the following, except for filterDroppedFrames, is a
4873-- read-only object which, if implemented, automatically appears when
4874-- the RMON1 row it is associated with is created.
4875
4876etherStats2Table  OBJECT-TYPE
4877    SYNTAX     SEQUENCE OF EtherStats2Entry
4878    MAX-ACCESS not-accessible
4879    STATUS     current
4880    DESCRIPTION
4881        "Contains the RMON-2 augmentations to RMON-1."
4882    ::= { statistics 4 }
4883
4884etherStats2Entry  OBJECT-TYPE
4885    SYNTAX     EtherStats2Entry
4886    MAX-ACCESS not-accessible
4887    STATUS     current
4888    DESCRIPTION
4889        "Contains the RMON-2 augmentations to RMON-1."
4890    AUGMENTS { etherStatsEntry }
4891    ::= { etherStats2Table 1 }
4892
4893EtherStats2Entry ::= SEQUENCE {
4894    etherStatsDroppedFrames     Counter32,
4895    etherStatsCreateTime        LastCreateTime
4896}
4897
4898etherStatsDroppedFrames OBJECT-TYPE
4899    SYNTAX     Counter32
4900    MAX-ACCESS read-only
4901    STATUS     current
4902    DESCRIPTION
4903       "The total number of frames that were received by the probe
4904        and therefore not accounted for in the *StatsDropEvents, but
4905        that the probe chose not to count for this entry for
4906        whatever reason.  Most often, this event occurs when the
4907        probe is out of some resources and decides to shed load from
4908        this collection.
4909
4910        This count does not include packets that were not counted
4911        because they had MAC-layer errors.
4912
4913        Note that, unlike the dropEvents counter, this number is the
4914        exact number of frames dropped."
4915    ::= { etherStats2Entry 1 }
4916
4917etherStatsCreateTime OBJECT-TYPE
4918    SYNTAX     LastCreateTime
4919    MAX-ACCESS read-only
4920    STATUS     current
4921    DESCRIPTION
4922        "The value of sysUpTime when this control entry was last
4923        activated.  This can be used by the management station to
4924        ensure that the table has not been deleted and recreated
4925        between polls."
4926    ::= { etherStats2Entry 2 }
4927
4928historyControl2Table  OBJECT-TYPE
4929    SYNTAX     SEQUENCE OF HistoryControl2Entry
4930    MAX-ACCESS not-accessible
4931    STATUS     current
4932    DESCRIPTION
4933        "Contains the RMON-2 augmentations to RMON-1."
4934    ::= { history 5 }
4935
4936historyControl2Entry  OBJECT-TYPE
4937    SYNTAX     HistoryControl2Entry
4938    MAX-ACCESS not-accessible
4939    STATUS     current
4940    DESCRIPTION
4941        "Contains the RMON-2 augmentations to RMON-1."
4942    AUGMENTS { historyControlEntry }
4943    ::= { historyControl2Table 1 }
4944
4945HistoryControl2Entry ::= SEQUENCE {
4946    historyControlDroppedFrames Counter32
4947}
4948
4949historyControlDroppedFrames OBJECT-TYPE
4950    SYNTAX     Counter32
4951    MAX-ACCESS read-only
4952    STATUS     current
4953    DESCRIPTION
4954       "The total number of frames that were received by the probe
4955        and therefore not accounted for in the *StatsDropEvents, but
4956        that the probe chose not to count for this entry for
4957        whatever reason.  Most often, this event occurs when the
4958        probe is out of some resources and decides to shed load from
4959        this collection.
4960
4961        This count does not include packets that were not counted
4962        because they had MAC-layer errors.
4963
4964        Note that, unlike the dropEvents counter, this number is the
4965        exact number of frames dropped."
4966    ::= { historyControl2Entry 1 }
4967
4968hostControl2Table  OBJECT-TYPE
4969    SYNTAX     SEQUENCE OF HostControl2Entry
4970    MAX-ACCESS not-accessible
4971    STATUS     current
4972    DESCRIPTION
4973        "Contains the RMON-2 augmentations to RMON-1."
4974    ::= { hosts 4 }
4975
4976hostControl2Entry  OBJECT-TYPE
4977    SYNTAX     HostControl2Entry
4978    MAX-ACCESS not-accessible
4979    STATUS     current
4980    DESCRIPTION
4981        "Contains the RMON-2 augmentations to RMON-1."
4982    AUGMENTS { hostControlEntry }
4983    ::= { hostControl2Table 1 }
4984
4985HostControl2Entry ::= SEQUENCE {
4986    hostControlDroppedFrames    Counter32,
4987    hostControlCreateTime       LastCreateTime
4988}
4989
4990hostControlDroppedFrames OBJECT-TYPE
4991    SYNTAX     Counter32
4992    MAX-ACCESS read-only
4993    STATUS     current
4994    DESCRIPTION
4995       "The total number of frames that were received by the probe
4996        and therefore not accounted for in the *StatsDropEvents, but
4997        that the probe chose not to count for this entry for
4998        whatever reason.  Most often, this event occurs when the
4999
5000        probe is out of some resources and decides to shed load from
5001        this collection.
5002
5003        This count does not include packets that were not counted
5004        because they had MAC-layer errors.
5005
5006        Note that, unlike the dropEvents counter, this number is the
5007        exact number of frames dropped."
5008    ::= { hostControl2Entry 1 }
5009
5010hostControlCreateTime OBJECT-TYPE
5011    SYNTAX     LastCreateTime
5012    MAX-ACCESS read-only
5013    STATUS     current
5014    DESCRIPTION
5015        "The value of sysUpTime when this control entry was last
5016        activated.  This can be used by the management station to
5017        ensure that the table has not been deleted and recreated
5018        between polls."
5019    ::= { hostControl2Entry 2 }
5020
5021matrixControl2Table  OBJECT-TYPE
5022    SYNTAX     SEQUENCE OF MatrixControl2Entry
5023    MAX-ACCESS not-accessible
5024    STATUS     current
5025    DESCRIPTION
5026        "Contains the RMON-2 augmentations to RMON-1."
5027    ::= { matrix 4 }
5028
5029matrixControl2Entry  OBJECT-TYPE
5030    SYNTAX     MatrixControl2Entry
5031    MAX-ACCESS not-accessible
5032    STATUS     current
5033    DESCRIPTION
5034        "Contains the RMON-2 augmentations to RMON-1."
5035    AUGMENTS { matrixControlEntry }
5036    ::= { matrixControl2Table 1 }
5037
5038MatrixControl2Entry ::= SEQUENCE {
5039    matrixControlDroppedFrames  Counter32,
5040    matrixControlCreateTime     LastCreateTime
5041}
5042
5043matrixControlDroppedFrames OBJECT-TYPE
5044    SYNTAX     Counter32
5045    MAX-ACCESS read-only
5046    STATUS     current
5047    DESCRIPTION
5048       "The total number of frames that were received by the probe
5049        and therefore not accounted for in the *StatsDropEvents, but
5050        that the probe chose not to count for this entry for
5051        whatever reason.  Most often, this event occurs when the
5052        probe is out of some resources and decides to shed load from
5053        this collection.
5054
5055        This count does not include packets that were not counted
5056        because they had MAC-layer errors.
5057
5058        Note that, unlike the dropEvents counter, this number is the
5059        exact number of frames dropped."
5060    ::= { matrixControl2Entry 1 }
5061
5062matrixControlCreateTime OBJECT-TYPE
5063    SYNTAX     LastCreateTime
5064    MAX-ACCESS read-only
5065    STATUS     current
5066    DESCRIPTION
5067        "The value of sysUpTime when this control entry was last
5068        activated.  This can be used by the management station to
5069        ensure that the table has not been deleted and recreated
5070        between polls."
5071    ::= { matrixControl2Entry 2 }
5072
5073channel2Table  OBJECT-TYPE
5074    SYNTAX     SEQUENCE OF Channel2Entry
5075    MAX-ACCESS not-accessible
5076    STATUS     current
5077    DESCRIPTION
5078        "Contains the RMON-2 augmentations to RMON-1."
5079    ::= { filter 3 }
5080
5081channel2Entry  OBJECT-TYPE
5082    SYNTAX     Channel2Entry
5083    MAX-ACCESS not-accessible
5084    STATUS     current
5085    DESCRIPTION
5086        "Contains the RMON-2 augmentations to RMON-1."
5087    AUGMENTS { channelEntry }
5088    ::= { channel2Table 1 }
5089
5090Channel2Entry ::= SEQUENCE {
5091    channelDroppedFrames    Counter32,
5092    channelCreateTime       LastCreateTime
5093}
5094
5095channelDroppedFrames OBJECT-TYPE
5096    SYNTAX     Counter32
5097    MAX-ACCESS read-only
5098    STATUS     current
5099    DESCRIPTION
5100       "The total number of frames that were received by the probe
5101        and therefore not accounted for in the *StatsDropEvents, but
5102        that the probe chose not to count for this entry for
5103        whatever reason.  Most often, this event occurs when the
5104        probe is out of some resources and decides to shed load from
5105        this collection.
5106
5107        This count does not include packets that were not counted
5108        because they had MAC-layer errors.
5109
5110        Note that, unlike the dropEvents counter, this number is the
5111        exact number of frames dropped."
5112    ::= { channel2Entry 1 }
5113
5114channelCreateTime OBJECT-TYPE
5115    SYNTAX     LastCreateTime
5116    MAX-ACCESS read-only
5117    STATUS     current
5118    DESCRIPTION
5119        "The value of sysUpTime when this control entry was last
5120        activated.  This can be used by the management station to
5121        ensure that the table has not been deleted and recreated
5122        between polls."
5123    ::= { channel2Entry 2 }
5124
5125tokenRingMLStats2Table  OBJECT-TYPE
5126    SYNTAX     SEQUENCE OF TokenRingMLStats2Entry
5127    MAX-ACCESS not-accessible
5128    STATUS     deprecated
5129    DESCRIPTION
5130        "Contains the RMON-2 augmentations to RMON-1.
5131
5132        This table has been deprecated, as it has not had enough
5133        independent implementations to demonstrate interoperability
5134        to meet the requirements of a Draft Standard."
5135    ::= { statistics 5 }
5136
5137tokenRingMLStats2Entry  OBJECT-TYPE
5138    SYNTAX     TokenRingMLStats2Entry
5139    MAX-ACCESS not-accessible
5140    STATUS     deprecated
5141    DESCRIPTION
5142        "Contains the RMON-2 augmentations to RMON-1."
5143    AUGMENTS { tokenRingMLStatsEntry }
5144    ::= { tokenRingMLStats2Table 1 }
5145
5146TokenRingMLStats2Entry ::= SEQUENCE {
5147    tokenRingMLStatsDroppedFrames       Counter32,
5148    tokenRingMLStatsCreateTime          LastCreateTime
5149}
5150
5151tokenRingMLStatsDroppedFrames OBJECT-TYPE
5152    SYNTAX     Counter32
5153    MAX-ACCESS read-only
5154    STATUS     deprecated
5155    DESCRIPTION
5156       "The total number of frames that were received by the probe
5157        and therefore not accounted for in the *StatsDropEvents, but
5158        that the probe chose not to count for this entry for
5159        whatever reason.  Most often, this event occurs when the
5160        probe is out of some resources and decides to shed load from
5161        this collection.
5162
5163        This count does not include packets that were not counted
5164        because they had MAC-layer errors.
5165
5166        Note that, unlike the dropEvents counter, this number is the
5167        exact number of frames dropped."
5168    ::= { tokenRingMLStats2Entry 1 }
5169
5170tokenRingMLStatsCreateTime OBJECT-TYPE
5171    SYNTAX     LastCreateTime
5172    MAX-ACCESS read-only
5173    STATUS     deprecated
5174    DESCRIPTION
5175        "The value of sysUpTime when this control entry was last
5176        activated.  This can be used by the management station to
5177        ensure that the table has not been deleted and recreated
5178        between polls."
5179    ::= { tokenRingMLStats2Entry 2 }
5180
5181tokenRingPStats2Table  OBJECT-TYPE
5182    SYNTAX     SEQUENCE OF TokenRingPStats2Entry
5183    MAX-ACCESS not-accessible
5184    STATUS     deprecated
5185    DESCRIPTION
5186        "Contains the RMON-2 augmentations to RMON-1.
5187
5188        This table has been deprecated, as it has not had enough
5189        independent implementations to demonstrate interoperability
5190        to meet the requirements of a Draft Standard."
5191    ::= { statistics 6 }
5192
5193tokenRingPStats2Entry  OBJECT-TYPE
5194    SYNTAX     TokenRingPStats2Entry
5195    MAX-ACCESS not-accessible
5196    STATUS     deprecated
5197    DESCRIPTION
5198        "Contains the RMON-2 augmentations to RMON-1."
5199    AUGMENTS {  tokenRingPStatsEntry }
5200    ::= { tokenRingPStats2Table 1 }
5201
5202TokenRingPStats2Entry ::= SEQUENCE {
5203    tokenRingPStatsDroppedFrames    Counter32,
5204    tokenRingPStatsCreateTime       LastCreateTime
5205}
5206
5207tokenRingPStatsDroppedFrames OBJECT-TYPE
5208    SYNTAX     Counter32
5209    MAX-ACCESS read-only
5210    STATUS     deprecated
5211    DESCRIPTION
5212       "The total number of frames that were received by the probe
5213        and therefore not accounted for in the *StatsDropEvents, but
5214        that the probe chose not to count for this entry for
5215        whatever reason.  Most often, this event occurs when the
5216        probe is out of some resources and decides to shed load from
5217        this collection.
5218
5219        This count does not include packets that were not counted
5220        because they had MAC-layer errors.
5221
5222        Note that, unlike the dropEvents counter, this number is the
5223        exact number of frames dropped."
5224    ::= { tokenRingPStats2Entry 1 }
5225
5226tokenRingPStatsCreateTime OBJECT-TYPE
5227    SYNTAX     LastCreateTime
5228    MAX-ACCESS read-only
5229    STATUS     deprecated
5230    DESCRIPTION
5231        "The value of sysUpTime when this control entry was last
5232        activated.  This can be used by the management station to
5233        ensure that the table has not been deleted and recreated
5234        between polls."
5235    ::= { tokenRingPStats2Entry 2 }
5236
5237ringStationControl2Table  OBJECT-TYPE
5238    SYNTAX     SEQUENCE OF RingStationControl2Entry
5239    MAX-ACCESS not-accessible
5240    STATUS     deprecated
5241    DESCRIPTION
5242        "Contains the RMON-2 augmentations to RMON-1.
5243
5244        This table has been deprecated, as it has not had enough
5245        independent implementations to demonstrate interoperability
5246        to meet the requirements of a Draft Standard."
5247    ::= { tokenRing 7 }
5248
5249ringStationControl2Entry  OBJECT-TYPE
5250    SYNTAX     RingStationControl2Entry
5251    MAX-ACCESS not-accessible
5252    STATUS     deprecated
5253    DESCRIPTION
5254        "Contains the RMON-2 augmentations to RMON-1."
5255    AUGMENTS { ringStationControlEntry }
5256    ::= { ringStationControl2Table 1 }
5257
5258RingStationControl2Entry ::= SEQUENCE {
5259    ringStationControlDroppedFrames Counter32,
5260    ringStationControlCreateTime    LastCreateTime
5261}
5262
5263ringStationControlDroppedFrames OBJECT-TYPE
5264    SYNTAX     Counter32
5265    MAX-ACCESS read-only
5266    STATUS     deprecated
5267    DESCRIPTION
5268       "The total number of frames that were received by the probe
5269        and therefore not accounted for in the *StatsDropEvents, but
5270        that the probe chose not to count for this entry for
5271        whatever reason.  Most often, this event occurs when the
5272        probe is out of some resources and decides to shed load from
5273        this collection.
5274
5275        This count does not include packets that were not counted
5276        because they had MAC-layer errors.
5277
5278        Note that, unlike the dropEvents counter, this number is the
5279        exact number of frames dropped."
5280    ::= { ringStationControl2Entry 1 }
5281
5282ringStationControlCreateTime OBJECT-TYPE
5283    SYNTAX     LastCreateTime
5284    MAX-ACCESS read-only
5285    STATUS     deprecated
5286    DESCRIPTION
5287        "The value of sysUpTime when this control entry was last
5288        activated.  This can be used by the management station to
5289
5290        ensure that the table has not been deleted and recreated
5291        between polls."
5292    ::= { ringStationControl2Entry 2 }
5293
5294sourceRoutingStats2Table  OBJECT-TYPE
5295    SYNTAX     SEQUENCE OF SourceRoutingStats2Entry
5296    MAX-ACCESS not-accessible
5297    STATUS     deprecated
5298    DESCRIPTION
5299        "Contains the RMON-2 augmentations to RMON-1.
5300
5301        This table has been deprecated, as it has not had enough
5302        independent implementations to demonstrate interoperability
5303        to meet the requirements of a Draft Standard."
5304    ::= { tokenRing 8 }
5305
5306sourceRoutingStats2Entry  OBJECT-TYPE
5307    SYNTAX     SourceRoutingStats2Entry
5308    MAX-ACCESS not-accessible
5309    STATUS     deprecated
5310    DESCRIPTION
5311        "Contains the RMON-2 augmentations to RMON-1."
5312    AUGMENTS { sourceRoutingStatsEntry }
5313    ::= { sourceRoutingStats2Table 1 }
5314
5315SourceRoutingStats2Entry ::= SEQUENCE {
5316    sourceRoutingStatsDroppedFrames Counter32,
5317    sourceRoutingStatsCreateTime    LastCreateTime
5318}
5319
5320sourceRoutingStatsDroppedFrames OBJECT-TYPE
5321    SYNTAX     Counter32
5322    MAX-ACCESS read-only
5323    STATUS     deprecated
5324    DESCRIPTION
5325       "The total number of frames that were received by the probe
5326        and therefore not accounted for in the *StatsDropEvents, but
5327        that the probe chose not to count for this entry for
5328        whatever reason.  Most often, this event occurs when the
5329        probe is out of some resources and decides to shed load from
5330        this collection.
5331
5332        This count does not include packets that were not counted
5333        because they had MAC-layer errors.
5334
5335        Note that, unlike the dropEvents counter, this number is the
5336        exact number of frames dropped."
5337    ::= { sourceRoutingStats2Entry 1 }
5338
5339sourceRoutingStatsCreateTime OBJECT-TYPE
5340    SYNTAX     LastCreateTime
5341    MAX-ACCESS read-only
5342    STATUS     deprecated
5343    DESCRIPTION
5344        "The value of sysUpTime when this control entry was last
5345        activated.  This can be used by the management station to
5346        ensure that the table has not been deleted and recreated
5347        between polls."
5348    ::= { sourceRoutingStats2Entry 2 }
5349
5350filter2Table OBJECT-TYPE
5351    SYNTAX     SEQUENCE OF Filter2Entry
5352    MAX-ACCESS not-accessible
5353    STATUS     current
5354    DESCRIPTION
5355        "Provides a variable-length packet filter feature to the
5356        RMON-1 filter table."
5357    ::= { filter 4 }
5358
5359filter2Entry OBJECT-TYPE
5360    SYNTAX     Filter2Entry
5361    MAX-ACCESS not-accessible
5362    STATUS     current
5363    DESCRIPTION
5364        "Provides a variable-length packet filter feature to the
5365        RMON-1 filter table."
5366    AUGMENTS { filterEntry }
5367    ::= { filter2Table 1 }
5368
5369Filter2Entry ::= SEQUENCE {
5370    filterProtocolDirDataLocalIndex     Integer32,
5371    filterProtocolDirLocalIndex         Integer32
5372}
5373
5374filterProtocolDirDataLocalIndex OBJECT-TYPE
5375    SYNTAX     Integer32 (0..2147483647)
5376    MAX-ACCESS read-create
5377    STATUS     current
5378    DESCRIPTION
5379        "When this object is set to a non-zero value, the filter that
5380        it is associated with performs the following operations on
5381        every packet:
5382
5383        1) If the packet doesn't match the protocol directory entry
5384           identified by this object, discard the packet and exit
5385           (i.e., discard the packet if it is not of the identified
5386           protocol).
5387
5388        2) If the associated filterProtocolDirLocalIndex is non-zero
5389           and the packet doesn't match the protocol directory
5390           entry identified by that object, discard the packet and
5391           exit.
5392        3) If the packet matches, perform the regular filter
5393           algorithm as if the beginning of this named protocol is
5394           the beginning of the packet, potentially applying the
5395           filterOffset value to move further into the packet."
5396    DEFVAL { 0 }
5397    ::= { filter2Entry 1 }
5398
5399filterProtocolDirLocalIndex OBJECT-TYPE
5400    SYNTAX     Integer32 (0..2147483647)
5401    MAX-ACCESS read-create
5402    STATUS     current
5403    DESCRIPTION
5404        "When this object is set to a non-zero value, the filter that
5405        it is associated with will discard the packet if the packet
5406        doesn't match this protocol directory entry."
5407    DEFVAL { 0 }
5408    ::= { filter2Entry 2 }
5409
5410-- Conformance Macros
5411
5412rmon2MIBCompliances OBJECT IDENTIFIER ::= { rmonConformance 1 }
5413rmon2MIBGroups      OBJECT IDENTIFIER ::= { rmonConformance 2 }
5414
5415rmon2MIBCompliance MODULE-COMPLIANCE
5416    STATUS  current
5417    DESCRIPTION
5418        "Describes the requirements for conformance to
5419        the RMON2 MIB"
5420    MODULE  -- this module
5421        MANDATORY-GROUPS { protocolDirectoryGroup,
5422                           protocolDistributionGroup,
5423                           addressMapGroup,
5424                           nlHostGroup,
5425                           nlMatrixGroup,
5426                           usrHistoryGroup,
5427                           probeInformationGroup }
5428
5429        OBJECT nlMatrixTopNControlRateBase
5430            SYNTAX      INTEGER {
5431                          nlMatrixTopNPkts(1),
5432                          nlMatrixTopNOctets(2)
5433                        }
5434            DESCRIPTION
5435                "Conformance to RMON2 requires only support for these
5436                values of nlMatrixTopNControlRateBase."
5437
5438        GROUP   rmon1EnhancementGroup
5439            DESCRIPTION
5440                "The rmon1EnhancementGroup is mandatory for systems
5441                that implement RMON [RFC2819]."
5442        GROUP  rmon1EthernetEnhancementGroup
5443            DESCRIPTION
5444                "The rmon1EthernetEnhancementGroup is optional and is
5445                appropriate for systems that implement the Ethernet
5446                group of RMON [RFC2819]."
5447    ::= { rmon2MIBCompliances 1 }
5448
5449rmon2MIBApplicationLayerCompliance MODULE-COMPLIANCE
5450    STATUS  current
5451    DESCRIPTION
5452        "Describes the requirements for conformance to
5453        the RMON2 MIB with Application-Layer Enhancements."
5454    MODULE  -- this module
5455        MANDATORY-GROUPS { protocolDirectoryGroup,
5456                           protocolDistributionGroup,
5457                           addressMapGroup,
5458                           nlHostGroup,
5459                           nlMatrixGroup,
5460                           alHostGroup,
5461                           alMatrixGroup,
5462                           usrHistoryGroup,
5463                           probeInformationGroup }
5464
5465        OBJECT nlMatrixTopNControlRateBase
5466            SYNTAX      INTEGER {
5467                          nlMatrixTopNPkts(1),
5468                          nlMatrixTopNOctets(2)
5469                        }
5470            DESCRIPTION
5471                "Conformance to RMON2 requires only support for these
5472                values of nlMatrixTopNControlRateBase."
5473
5474        OBJECT alMatrixTopNControlRateBase
5475            SYNTAX     INTEGER {
5476                           alMatrixTopNTerminalsPkts(1),
5477                           alMatrixTopNTerminalsOctets(2),
5478                           alMatrixTopNAllPkts(3),
5479                           alMatrixTopNAllOctets(4)
5480                       }
5481            DESCRIPTION
5482                "Conformance to RMON2 requires only support for these
5483
5484                values of alMatrixTopNControlRateBase."
5485
5486        GROUP   rmon1EnhancementGroup
5487            DESCRIPTION
5488                "The rmon1EnhancementGroup is mandatory for systems
5489                that implement RMON [RFC2819]."
5490        GROUP  rmon1EthernetEnhancementGroup
5491            DESCRIPTION
5492                "The rmon1EthernetEnhancementGroup is optional and is
5493                appropriate for systems that implement the Ethernet
5494                group of RMON [RFC2819]."
5495    ::= { rmon2MIBCompliances 2 }
5496
5497protocolDirectoryGroup OBJECT-GROUP
5498    OBJECTS { protocolDirLastChange,
5499              protocolDirLocalIndex, protocolDirDescr,
5500              protocolDirType, protocolDirAddressMapConfig,
5501              protocolDirHostConfig, protocolDirMatrixConfig,
5502              protocolDirOwner, protocolDirStatus }
5503    STATUS  current
5504    DESCRIPTION
5505        "Lists the inventory of protocols the probe has the
5506        capability of monitoring and allows the addition, deletion,
5507        and configuration of entries in this list."
5508    ::= { rmon2MIBGroups 1 }
5509
5510protocolDistributionGroup OBJECT-GROUP
5511    OBJECTS { protocolDistControlDataSource,
5512              protocolDistControlDroppedFrames,
5513              protocolDistControlCreateTime,
5514              protocolDistControlOwner, protocolDistControlStatus,
5515              protocolDistStatsPkts, protocolDistStatsOctets }
5516    STATUS  current
5517    DESCRIPTION
5518        "Collects the relative amounts of octets and packets for the
5519        different protocols detected on a network segment."
5520    ::= { rmon2MIBGroups 2 }
5521
5522addressMapGroup OBJECT-GROUP
5523    OBJECTS { addressMapInserts, addressMapDeletes,
5524              addressMapMaxDesiredEntries,
5525              addressMapControlDataSource,
5526              addressMapControlDroppedFrames,
5527              addressMapControlOwner, addressMapControlStatus,
5528              addressMapPhysicalAddress,
5529              addressMapLastChange }
5530    STATUS  current
5531    DESCRIPTION
5532        "Lists MAC address to network address bindings discovered by
5533        the probe and what interface they were last seen on."
5534    ::= { rmon2MIBGroups 3 }
5535
5536nlHostGroup OBJECT-GROUP
5537    OBJECTS { hlHostControlDataSource,
5538              hlHostControlNlDroppedFrames, hlHostControlNlInserts,
5539              hlHostControlNlDeletes,
5540              hlHostControlNlMaxDesiredEntries,
5541              hlHostControlAlDroppedFrames, hlHostControlAlInserts,
5542              hlHostControlAlDeletes,
5543              hlHostControlAlMaxDesiredEntries, hlHostControlOwner,
5544              hlHostControlStatus, nlHostInPkts, nlHostOutPkts,
5545              nlHostInOctets, nlHostOutOctets,
5546              nlHostOutMacNonUnicastPkts, nlHostCreateTime }
5547    STATUS  current
5548    DESCRIPTION
5549        "Counts the amount of traffic sent from and to each network
5550        address discovered by the probe.  Note that while the
5551        hlHostControlTable also has objects that control an optional
5552        alHostTable, implementation of the alHostTable is not
5553        required to fully implement this group."
5554    ::= { rmon2MIBGroups 4 }
5555
5556nlMatrixGroup OBJECT-GROUP
5557    OBJECTS { hlMatrixControlDataSource,
5558              hlMatrixControlNlDroppedFrames,
5559              hlMatrixControlNlInserts, hlMatrixControlNlDeletes,
5560              hlMatrixControlNlMaxDesiredEntries,
5561              hlMatrixControlAlDroppedFrames,
5562              hlMatrixControlAlInserts, hlMatrixControlAlDeletes,
5563              hlMatrixControlAlMaxDesiredEntries,
5564              hlMatrixControlOwner, hlMatrixControlStatus,
5565              nlMatrixSDPkts, nlMatrixSDOctets, nlMatrixSDCreateTime,
5566              nlMatrixDSPkts, nlMatrixDSOctets, nlMatrixDSCreateTime,
5567              nlMatrixTopNControlMatrixIndex,
5568              nlMatrixTopNControlRateBase,
5569              nlMatrixTopNControlTimeRemaining,
5570              nlMatrixTopNControlGeneratedReports,
5571              nlMatrixTopNControlDuration,
5572              nlMatrixTopNControlRequestedSize,
5573              nlMatrixTopNControlGrantedSize,
5574              nlMatrixTopNControlStartTime,
5575              nlMatrixTopNControlOwner, nlMatrixTopNControlStatus,
5576              nlMatrixTopNProtocolDirLocalIndex,
5577              nlMatrixTopNSourceAddress, nlMatrixTopNDestAddress,
5578              nlMatrixTopNPktRate, nlMatrixTopNReversePktRate,
5579              nlMatrixTopNOctetRate, nlMatrixTopNReverseOctetRate }
5580    STATUS  current
5581    DESCRIPTION
5582        "Counts the amount of traffic sent between each pair of
5583        network addresses discovered by the probe.  Note that while
5584        the hlMatrixControlTable also has objects that control
5585        optional alMatrixTables, implementation of the
5586        alMatrixTables is not required to fully implement this
5587        group."
5588     ::= { rmon2MIBGroups 5 }
5589
5590alHostGroup OBJECT-GROUP
5591    OBJECTS { alHostInPkts, alHostOutPkts,
5592              alHostInOctets, alHostOutOctets, alHostCreateTime }
5593    STATUS  current
5594    DESCRIPTION
5595        "Counts the amount of traffic, by protocol, sent from and to
5596        each network address discovered by the probe.  Implementation
5597        of this group requires implementation of the Network-Layer
5598        Host Group."
5599    ::= { rmon2MIBGroups 6 }
5600
5601alMatrixGroup OBJECT-GROUP
5602    OBJECTS { alMatrixSDPkts, alMatrixSDOctets, alMatrixSDCreateTime,
5603              alMatrixDSPkts, alMatrixDSOctets, alMatrixDSCreateTime,
5604              alMatrixTopNControlMatrixIndex,
5605              alMatrixTopNControlRateBase,
5606              alMatrixTopNControlTimeRemaining,
5607              alMatrixTopNControlGeneratedReports,
5608              alMatrixTopNControlDuration,
5609              alMatrixTopNControlRequestedSize,
5610              alMatrixTopNControlGrantedSize,
5611              alMatrixTopNControlStartTime,
5612              alMatrixTopNControlOwner, alMatrixTopNControlStatus,
5613              alMatrixTopNProtocolDirLocalIndex,
5614              alMatrixTopNSourceAddress, alMatrixTopNDestAddress,
5615              alMatrixTopNAppProtocolDirLocalIndex,
5616              alMatrixTopNPktRate, alMatrixTopNReversePktRate,
5617              alMatrixTopNOctetRate, alMatrixTopNReverseOctetRate }
5618    STATUS  current
5619    DESCRIPTION
5620        "Counts the amount of traffic, by protocol, sent between each
5621        pair of network addresses discovered by the
5622        probe.  Implementation of this group requires implementation
5623        of the Network-Layer Matrix Group."
5624    ::= { rmon2MIBGroups 7 }
5625
5626usrHistoryGroup OBJECT-GROUP
5627
5628    OBJECTS { usrHistoryControlObjects,
5629              usrHistoryControlBucketsRequested,
5630              usrHistoryControlBucketsGranted,
5631              usrHistoryControlInterval,
5632              usrHistoryControlOwner, usrHistoryControlStatus,
5633              usrHistoryObjectVariable, usrHistoryObjectSampleType,
5634              usrHistoryIntervalStart, usrHistoryIntervalEnd,
5635              usrHistoryAbsValue, usrHistoryValStatus }
5636    STATUS  current
5637    DESCRIPTION
5638        "The usrHistoryGroup provides user-defined collection of
5639        historical information from MIB objects on the probe."
5640    ::= { rmon2MIBGroups 8 }
5641
5642probeInformationGroup OBJECT-GROUP
5643    OBJECTS { probeCapabilities,
5644              probeSoftwareRev, probeHardwareRev, probeDateTime }
5645    STATUS  current
5646    DESCRIPTION
5647        "This group describes various operating parameters of the
5648        probe and controls the local time of the probe."
5649    ::= { rmon2MIBGroups 9 }
5650
5651probeConfigurationGroup OBJECT-GROUP
5652    OBJECTS { probeResetControl, probeDownloadFile,
5653              probeDownloadTFTPServer, probeDownloadAction,
5654              probeDownloadStatus,
5655              serialMode, serialProtocol, serialTimeout,
5656              serialModemInitString, serialModemHangUpString,
5657              serialModemConnectResp, serialModemNoConnectResp,
5658              serialDialoutTimeout, serialStatus,
5659              netConfigIPAddress, netConfigSubnetMask,
5660              netConfigStatus, netDefaultGateway,
5661              trapDestCommunity, trapDestProtocol, trapDestAddress,
5662              trapDestOwner, trapDestStatus,
5663              serialConnectDestIpAddress, serialConnectType,
5664              serialConnectDialString, serialConnectSwitchConnectSeq,
5665              serialConnectSwitchDisconnectSeq,
5666              serialConnectSwitchResetSeq,
5667              serialConnectOwner, serialConnectStatus }
5668    STATUS  deprecated
5669    DESCRIPTION
5670        "This group controls the configuration of various operating
5671        parameters of the probe.  This group is not referenced by any
5672        MODULE-COMPLIANCE macro because it is 'grandfathered' from
5673        more recent MIB review rules that would require it."
5674    ::= { rmon2MIBGroups 10 }
5675
5676rmon1EnhancementGroup OBJECT-GROUP
5677    OBJECTS { historyControlDroppedFrames, hostControlDroppedFrames,
5678              hostControlCreateTime, matrixControlDroppedFrames,
5679              matrixControlCreateTime, channelDroppedFrames,
5680              channelCreateTime, filterProtocolDirDataLocalIndex,
5681              filterProtocolDirLocalIndex }
5682    STATUS  current
5683    DESCRIPTION
5684        "This group adds some enhancements to RMON-1 that help
5685        management stations."
5686    ::= { rmon2MIBGroups 11 }
5687
5688rmon1EthernetEnhancementGroup OBJECT-GROUP
5689    OBJECTS { etherStatsDroppedFrames, etherStatsCreateTime }
5690    STATUS  current
5691    DESCRIPTION
5692        "This group adds some enhancements to RMON-1 that help
5693        management stations."
5694    ::= { rmon2MIBGroups 12 }
5695
5696rmon1TokenRingEnhancementGroup OBJECT-GROUP
5697    OBJECTS { tokenRingMLStatsDroppedFrames,
5698              tokenRingMLStatsCreateTime,
5699              tokenRingPStatsDroppedFrames, tokenRingPStatsCreateTime,
5700              ringStationControlDroppedFrames,
5701              ringStationControlCreateTime,
5702              sourceRoutingStatsDroppedFrames,
5703              sourceRoutingStatsCreateTime }
5704    STATUS  deprecated
5705    DESCRIPTION
5706        "This group adds some enhancements to RMON-1 that help
5707        management stations.  This group is not referenced by any
5708        MODULE-COMPLIANCE macro because it is 'grandfathered' from
5709        more recent MIB review rules that would require it."
5710    ::= { rmon2MIBGroups 13 }
5711END
5712