home *** CD-ROM | disk | FTP | other *** search
/ Thomson (Residential) / TGSTPv7203.iso / mac / SNMP_MIBs / extended / RMON-MIB.mib < prev    next >
Text File  |  2008-02-08  |  152KB  |  4,356 lines
  1.  RMON-MIB DEFINITIONS ::= BEGIN
  2.  
  3.      IMPORTS
  4.          MODULE-IDENTITY, OBJECT-TYPE, OBJECT-IDENTITY,
  5.          NOTIFICATION-TYPE, mib-2, Counter32,
  6.          Integer32, TimeTicks                   FROM SNMPv2-SMI
  7.  
  8.          TEXTUAL-CONVENTION, DisplayString      FROM SNMPv2-TC
  9.  
  10.          MODULE-COMPLIANCE, OBJECT-GROUP,
  11.          NOTIFICATION-GROUP                     FROM SNMPv2-CONF;
  12.  
  13.  
  14.  --  Remote Network Monitoring MIB
  15.  
  16.  rmonMibModule MODULE-IDENTITY
  17.      LAST-UPDATED "200005110000Z"  -- 11 May, 2000
  18.      ORGANIZATION "IETF RMON MIB Working Group"
  19.      CONTACT-INFO
  20.          "Steve Waldbusser
  21.          Phone: +1-650-948-6500
  22.          Fax:   +1-650-745-0671
  23.          Email: waldbusser@nextbeacon.com"
  24.      DESCRIPTION
  25.          "Remote network monitoring devices, often called
  26.          monitors or probes, are instruments that exist for
  27.          the purpose of managing a network. This MIB defines
  28.          objects for managing remote network monitoring devices."
  29.  
  30.      REVISION "200005110000Z"    -- 11 May, 2000
  31.      DESCRIPTION
  32.          "Reformatted into SMIv2 format.
  33.  
  34.          This version published as RFC 2819."
  35.  
  36.      REVISION "199502010000Z" -- 1 Feb, 1995
  37.      DESCRIPTION
  38.          "Bug fixes, clarifications and minor changes based on
  39.          implementation experience, published as RFC1757 [18].
  40.  
  41.          Two changes were made to object definitions:
  42.  
  43.          1) A new status bit has been defined for the
  44.          captureBufferPacketStatus object, indicating that the
  45.          packet order within the capture buffer may not be identical to
  46.          the packet order as received off the wire.  This bit may only
  47.  
  48.  
  49.  
  50.  
  51.  
  52.          be used for packets transmitted by the probe.  Older NMS
  53.          applications can safely ignore this status bit, which might be
  54.          used by newer agents.
  55.  
  56.          2) The packetMatch trap has been removed.  This trap was never
  57.          actually 'approved' and was not added to this document along
  58.          with the risingAlarm and fallingAlarm traps. The packetMatch
  59.          trap could not be throttled, which could cause disruption of
  60.          normal network traffic under some circumstances. An NMS should
  61.          configure a risingAlarm threshold on the appropriate
  62.          channelMatches instance if a trap is desired for a packetMatch
  63.          event. Note that logging of packetMatch events is still
  64.          supported--only trap generation for such events has been
  65.          removed.
  66.  
  67.          In addition, several clarifications to individual object
  68.          definitions have been added to assist agent and NMS
  69.          implementors:
  70.  
  71.          - global definition of 'good packets' and 'bad packets'
  72.  
  73.          - more detailed text governing conceptual row creation and
  74.            modification
  75.  
  76.          - instructions for probes relating to interface changes and
  77.            disruptions
  78.  
  79.          - clarification of some ethernet counter definitions
  80.  
  81.          - recommended formula for calculating network utilization
  82.  
  83.          - clarification of channel and captureBuffer behavior for some
  84.            unusual conditions
  85.  
  86.          - examples of proper instance naming for each table"
  87.  
  88.      REVISION "199111010000Z"    -- 1 Nov, 1991
  89.      DESCRIPTION
  90.          "The original version of this MIB, published as RFC1271."
  91.      ::= { rmonConformance 8 }
  92.  
  93.      rmon    OBJECT IDENTIFIER ::= { mib-2 16 }
  94.  
  95.  
  96.      -- textual conventions
  97.  
  98.  OwnerString ::= TEXTUAL-CONVENTION
  99.      STATUS current
  100.  
  101.  
  102.  
  103.  
  104.  
  105.      DESCRIPTION
  106.          "This data type is used to model an administratively
  107.          assigned name of the owner of a resource. Implementations
  108.          must accept values composed of well-formed NVT ASCII
  109.          sequences. In addition, implementations should accept
  110.          values composed of well-formed UTF-8 sequences.
  111.  
  112.          It is suggested that this name contain one or more of
  113.          the following: IP address, management station name,
  114.          network manager's name, location, or phone number.
  115.          In some cases the agent itself will be the owner of
  116.          an entry.  In these cases, this string shall be set
  117.          to a string starting with 'monitor'.
  118.  
  119.          SNMP access control is articulated entirely in terms
  120.          of the contents of MIB views; access to a particular
  121.          SNMP object instance depends only upon its presence
  122.          or absence in a particular MIB view and never upon
  123.          its value or the value of related object instances.
  124.          Thus, objects of this type afford resolution of
  125.          resource contention only among cooperating
  126.          managers; they realize no access control function
  127.          with respect to uncooperative parties."
  128.      SYNTAX OCTET STRING (SIZE (0..127))
  129.  
  130.  EntryStatus ::= TEXTUAL-CONVENTION
  131.      STATUS current
  132.      DESCRIPTION
  133.          "The status of a table entry.
  134.  
  135.          Setting this object to the value invalid(4) has the
  136.          effect of invalidating the corresponding entry.
  137.          That is, it effectively disassociates the mapping
  138.          identified with said entry.
  139.          It is an implementation-specific matter as to whether
  140.          the agent removes an invalidated entry from the table.
  141.          Accordingly, management stations must be prepared to
  142.          receive tabular information from agents that corresponds
  143.          to entries currently not in use.  Proper
  144.          interpretation of such entries requires examination
  145.          of the relevant EntryStatus object.
  146.  
  147.          An existing instance of this object cannot be set to
  148.          createRequest(2).  This object may only be set to
  149.          createRequest(2) when this instance is created.  When
  150.          this object is created, the agent may wish to create
  151.          supplemental object instances with default values
  152.          to complete a conceptual row in this table.  Because the
  153.  
  154.  
  155.  
  156.  
  157.  
  158.          creation of these default objects is entirely at the option
  159.          of the agent, the manager must not assume that any will be
  160.          created, but may make use of any that are created.
  161.          Immediately after completing the create operation, the agent
  162.          must set this object to underCreation(3).
  163.  
  164.          When in the underCreation(3) state, an entry is allowed to
  165.          exist in a possibly incomplete, possibly inconsistent state,
  166.          usually to allow it to be modified in multiple PDUs.  When in
  167.          this state, an entry is not fully active.
  168.          Entries shall exist in the underCreation(3) state until
  169.          the management station is finished configuring the entry
  170.          and sets this object to valid(1) or aborts, setting this
  171.          object to invalid(4).  If the agent determines that an
  172.          entry has been in the underCreation(3) state for an
  173.          abnormally long time, it may decide that the management
  174.          station has crashed.  If the agent makes this decision,
  175.          it may set this object to invalid(4) to reclaim the
  176.          entry.  A prudent agent will understand that the
  177.          management station may need to wait for human input
  178.          and will allow for that possibility in its
  179.          determination of this abnormally long period.
  180.  
  181.          An entry in the valid(1) state is fully configured and
  182.          consistent and fully represents the configuration or
  183.          operation such a row is intended to represent.  For
  184.          example, it could be a statistical function that is
  185.          configured and active, or a filter that is available
  186.          in the list of filters processed by the packet capture
  187.          process.
  188.  
  189.          A manager is restricted to changing the state of an entry in
  190.          the following ways:
  191.  
  192.               To:       valid  createRequest  underCreation  invalid
  193.          From:
  194.          valid             OK             NO             OK       OK
  195.          createRequest    N/A            N/A            N/A      N/A
  196.          underCreation     OK             NO             OK       OK
  197.          invalid           NO             NO             NO       OK
  198.          nonExistent       NO             OK             NO       OK
  199.  
  200.          In the table above, it is not applicable to move the state
  201.          from the createRequest state to any other state because the
  202.          manager will never find the variable in that state.  The
  203.          nonExistent state is not a value of the enumeration, rather
  204.          it means that the entryStatus variable does not exist at all.
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.          An agent may allow an entryStatus variable to change state in
  212.          additional ways, so long as the semantics of the states are
  213.          followed.  This allowance is made to ease the implementation of
  214.          the agent and is made despite the fact that managers should
  215.          never exercise these additional state transitions."
  216.      SYNTAX INTEGER {
  217.                 valid(1),
  218.                 createRequest(2),
  219.                 underCreation(3),
  220.                 invalid(4)
  221.             }
  222.  
  223.      statistics        OBJECT IDENTIFIER ::= { rmon 1 }
  224.      history           OBJECT IDENTIFIER ::= { rmon 2 }
  225.      alarm             OBJECT IDENTIFIER ::= { rmon 3 }
  226.      hosts             OBJECT IDENTIFIER ::= { rmon 4 }
  227.      hostTopN          OBJECT IDENTIFIER ::= { rmon 5 }
  228.      matrix            OBJECT IDENTIFIER ::= { rmon 6 }
  229.      filter            OBJECT IDENTIFIER ::= { rmon 7 }
  230.      capture           OBJECT IDENTIFIER ::= { rmon 8 }
  231.      event             OBJECT IDENTIFIER ::= { rmon 9 }
  232.      rmonConformance   OBJECT IDENTIFIER ::= { rmon 20 }
  233.  
  234.  -- The Ethernet Statistics Group
  235.  --
  236.  -- Implementation of the Ethernet Statistics group is optional.
  237.  -- Consult the MODULE-COMPLIANCE macro for the authoritative
  238.  -- conformance information for this MIB.
  239.  --
  240.  -- The ethernet statistics group contains statistics measured by the
  241.  -- probe for each monitored interface on this device.  These
  242.  -- statistics take the form of free running counters that start from
  243.  -- zero when a valid entry is created.
  244.  --
  245.  -- This group currently has statistics defined only for
  246.  -- Ethernet interfaces.  Each etherStatsEntry contains statistics
  247.  -- for one Ethernet interface.  The probe must create one
  248.  -- etherStats entry for each monitored Ethernet interface
  249.  -- on the device.
  250.  
  251.  etherStatsTable OBJECT-TYPE
  252.      SYNTAX     SEQUENCE OF EtherStatsEntry
  253.      MAX-ACCESS not-accessible
  254.      STATUS     current
  255.      DESCRIPTION
  256.          "A list of Ethernet statistics entries."
  257.      ::= { statistics 1 }
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  etherStatsEntry OBJECT-TYPE
  265.      SYNTAX     EtherStatsEntry
  266.      MAX-ACCESS not-accessible
  267.      STATUS     current
  268.      DESCRIPTION
  269.          "A collection of statistics kept for a particular
  270.          Ethernet interface.  As an example, an instance of the
  271.          etherStatsPkts object might be named etherStatsPkts.1"
  272.      INDEX { etherStatsIndex }
  273.      ::= { etherStatsTable 1 }
  274.  
  275.  EtherStatsEntry ::= SEQUENCE {
  276.      etherStatsIndex                    Integer32,
  277.      etherStatsDataSource               OBJECT IDENTIFIER,
  278.      etherStatsDropEvents               Counter32,
  279.      etherStatsOctets                   Counter32,
  280.      etherStatsPkts                     Counter32,
  281.      etherStatsBroadcastPkts            Counter32,
  282.      etherStatsMulticastPkts            Counter32,
  283.      etherStatsCRCAlignErrors           Counter32,
  284.      etherStatsUndersizePkts            Counter32,
  285.      etherStatsOversizePkts             Counter32,
  286.      etherStatsFragments                Counter32,
  287.      etherStatsJabbers                  Counter32,
  288.      etherStatsCollisions               Counter32,
  289.      etherStatsPkts64Octets             Counter32,
  290.      etherStatsPkts65to127Octets        Counter32,
  291.      etherStatsPkts128to255Octets       Counter32,
  292.      etherStatsPkts256to511Octets       Counter32,
  293.      etherStatsPkts512to1023Octets      Counter32,
  294.      etherStatsPkts1024to1518Octets     Counter32,
  295.      etherStatsOwner                    OwnerString,
  296.      etherStatsStatus                   EntryStatus
  297.  }
  298.  
  299.  etherStatsIndex OBJECT-TYPE
  300.      SYNTAX     Integer32 (1..65535)
  301.      MAX-ACCESS read-only
  302.      STATUS     current
  303.      DESCRIPTION
  304.          "The value of this object uniquely identifies this
  305.          etherStats entry."
  306.      ::= { etherStatsEntry 1 }
  307.  
  308.  etherStatsDataSource OBJECT-TYPE
  309.      SYNTAX     OBJECT IDENTIFIER
  310.      MAX-ACCESS read-create
  311.      STATUS     current
  312.  
  313.  
  314.  
  315.  
  316.  
  317.      DESCRIPTION
  318.          "This object identifies the source of the data that
  319.          this etherStats entry is configured to analyze.  This
  320.          source can be any ethernet interface on this device.
  321.          In order to identify a particular interface, this object
  322.          shall identify the instance of the ifIndex object,
  323.          defined in RFC 2233 [17], for the desired interface.
  324.          For example, if an entry were to receive data from
  325.          interface #1, this object would be set to ifIndex.1.
  326.  
  327.          The statistics in this group reflect all packets
  328.          on the local network segment attached to the identified
  329.          interface.
  330.  
  331.          An agent may or may not be able to tell if fundamental
  332.          changes to the media of the interface have occurred and
  333.          necessitate an invalidation of this entry.  For example, a
  334.          hot-pluggable ethernet card could be pulled out and replaced
  335.          by a token-ring card.  In such a case, if the agent has such
  336.          knowledge of the change, it is recommended that it
  337.          invalidate this entry.
  338.  
  339.          This object may not be modified if the associated
  340.          etherStatsStatus object is equal to valid(1)."
  341.      ::= { etherStatsEntry 2 }
  342.  
  343.  etherStatsDropEvents OBJECT-TYPE
  344.      SYNTAX     Counter32
  345.      MAX-ACCESS read-only
  346.      STATUS     current
  347.      DESCRIPTION
  348.          "The total number of events in which packets
  349.          were dropped by the probe due to lack of resources.
  350.          Note that this number is not necessarily the number of
  351.          packets dropped; it is just the number of times this
  352.          condition has been detected."
  353.      ::= { etherStatsEntry 3 }
  354.  
  355.  etherStatsOctets OBJECT-TYPE
  356.      SYNTAX     Counter32
  357.      UNITS      "Octets"
  358.      MAX-ACCESS read-only
  359.      STATUS     current
  360.      DESCRIPTION
  361.          "The total number of octets of data (including
  362.          those in bad packets) received on the
  363.          network (excluding framing bits but including
  364.          FCS octets).
  365.  
  366.  
  367.  
  368.  
  369.  
  370.          This object can be used as a reasonable estimate of
  371.          10-Megabit ethernet utilization.  If greater precision is
  372.          desired, the etherStatsPkts and etherStatsOctets objects
  373.          should be sampled before and after a common interval.  The
  374.          differences in the sampled values are Pkts and Octets,
  375.          respectively, and the number of seconds in the interval is
  376.          Interval.  These values are used to calculate the Utilization
  377.          as follows:
  378.  
  379.                           Pkts * (9.6 + 6.4) + (Octets * .8)
  380.           Utilization = -------------------------------------
  381.                                   Interval * 10,000
  382.  
  383.          The result of this equation is the value Utilization which
  384.          is the percent utilization of the ethernet segment on a
  385.          scale of 0 to 100 percent."
  386.      ::= { etherStatsEntry 4 }
  387.  
  388.  etherStatsPkts OBJECT-TYPE
  389.      SYNTAX     Counter32
  390.      UNITS      "Packets"
  391.      MAX-ACCESS read-only
  392.      STATUS     current
  393.      DESCRIPTION
  394.          "The total number of packets (including bad packets,
  395.          broadcast packets, and multicast packets) received."
  396.      ::= { etherStatsEntry 5 }
  397.  
  398.  etherStatsBroadcastPkts OBJECT-TYPE
  399.      SYNTAX     Counter32
  400.      UNITS      "Packets"
  401.      MAX-ACCESS read-only
  402.      STATUS     current
  403.      DESCRIPTION
  404.          "The total number of good packets received that were
  405.          directed to the broadcast address.  Note that this
  406.          does not include multicast packets."
  407.      ::= { etherStatsEntry 6 }
  408.  
  409.  etherStatsMulticastPkts OBJECT-TYPE
  410.      SYNTAX     Counter32
  411.      UNITS      "Packets"
  412.      MAX-ACCESS read-only
  413.      STATUS     current
  414.      DESCRIPTION
  415.          "The total number of good packets received that were
  416.          directed to a multicast address.  Note that this number
  417.          does not include packets directed to the broadcast
  418.  
  419.  
  420.  
  421.  
  422.  
  423.          address."
  424.      ::= { etherStatsEntry 7 }
  425.  
  426.  etherStatsCRCAlignErrors OBJECT-TYPE
  427.      SYNTAX     Counter32
  428.      UNITS      "Packets"
  429.      MAX-ACCESS read-only
  430.      STATUS     current
  431.      DESCRIPTION
  432.          "The total number of packets received that
  433.          had a length (excluding framing bits, but
  434.          including FCS octets) of between 64 and 1518
  435.          octets, inclusive, but had either a bad
  436.          Frame Check Sequence (FCS) with an integral
  437.          number of octets (FCS Error) or a bad FCS with
  438.          a non-integral number of octets (Alignment Error)."
  439.      ::= { etherStatsEntry 8 }
  440.  
  441.  etherStatsUndersizePkts OBJECT-TYPE
  442.      SYNTAX     Counter32
  443.      UNITS      "Packets"
  444.      MAX-ACCESS read-only
  445.      STATUS     current
  446.      DESCRIPTION
  447.          "The total number of packets received that were
  448.          less than 64 octets long (excluding framing bits,
  449.          but including FCS octets) and were otherwise well
  450.          formed."
  451.      ::= { etherStatsEntry 9 }
  452.  
  453.  etherStatsOversizePkts OBJECT-TYPE
  454.      SYNTAX     Counter32
  455.      UNITS      "Packets"
  456.      MAX-ACCESS read-only
  457.      STATUS     current
  458.      DESCRIPTION
  459.          "The total number of packets received that were
  460.          longer than 1518 octets (excluding framing bits,
  461.          but including FCS octets) and were otherwise
  462.          well formed."
  463.      ::= { etherStatsEntry 10 }
  464.  
  465.  etherStatsFragments OBJECT-TYPE
  466.      SYNTAX     Counter32
  467.      UNITS      "Packets"
  468.      MAX-ACCESS read-only
  469.      STATUS     current
  470.      DESCRIPTION
  471.  
  472.  
  473.  
  474.  
  475.  
  476.          "The total number of packets received that were less than
  477.          64 octets in length (excluding framing bits but including
  478.          FCS octets) and had either a bad Frame Check Sequence
  479.          (FCS) with an integral number of octets (FCS Error) or a
  480.          bad FCS with a non-integral number of octets (Alignment
  481.          Error).
  482.  
  483.          Note that it is entirely normal for etherStatsFragments to
  484.          increment.  This is because it counts both runts (which are
  485.          normal occurrences due to collisions) and noise hits."
  486.      ::= { etherStatsEntry 11 }
  487.  
  488.  etherStatsJabbers OBJECT-TYPE
  489.      SYNTAX     Counter32
  490.      UNITS      "Packets"
  491.      MAX-ACCESS read-only
  492.      STATUS     current
  493.      DESCRIPTION
  494.          "The total number of packets received that were
  495.          longer than 1518 octets (excluding framing bits,
  496.          but including FCS octets), and had either a bad
  497.          Frame Check Sequence (FCS) with an integral number
  498.          of octets (FCS Error) or a bad FCS with a non-integral
  499.          number of octets (Alignment Error).
  500.  
  501.          Note that this definition of jabber is different
  502.          than the definition in IEEE-802.3 section 8.2.1.5
  503.          (10BASE5) and section 10.3.1.4 (10BASE2).  These
  504.          documents define jabber as the condition where any
  505.          packet exceeds 20 ms.  The allowed range to detect
  506.          jabber is between 20 ms and 150 ms."
  507.      ::= { etherStatsEntry 12 }
  508.  
  509.  etherStatsCollisions OBJECT-TYPE
  510.      SYNTAX     Counter32
  511.      UNITS      "Collisions"
  512.      MAX-ACCESS read-only
  513.      STATUS     current
  514.      DESCRIPTION
  515.          "The best estimate of the total number of collisions
  516.          on this Ethernet segment.
  517.  
  518.          The value returned will depend on the location of the
  519.          RMON probe. Section 8.2.1.3 (10BASE-5) and section
  520.          10.3.1.3 (10BASE-2) of IEEE standard 802.3 states that a
  521.          station must detect a collision, in the receive mode, if
  522.          three or more stations are transmitting simultaneously.  A
  523.          repeater port must detect a collision when two or more
  524.  
  525.  
  526.  
  527.  
  528.  
  529.          stations are transmitting simultaneously.  Thus a probe
  530.          placed on a repeater port could record more collisions
  531.          than a probe connected to a station on the same segment
  532.          would.
  533.  
  534.          Probe location plays a much smaller role when considering
  535.          10BASE-T.  14.2.1.4 (10BASE-T) of IEEE standard 802.3
  536.          defines a collision as the simultaneous presence of signals
  537.          on the DO and RD circuits (transmitting and receiving
  538.          at the same time).  A 10BASE-T station can only detect
  539.          collisions when it is transmitting.  Thus probes placed on
  540.          a station and a repeater, should report the same number of
  541.          collisions.
  542.  
  543.          Note also that an RMON probe inside a repeater should
  544.          ideally report collisions between the repeater and one or
  545.          more other hosts (transmit collisions as defined by IEEE
  546.          802.3k) plus receiver collisions observed on any coax
  547.          segments to which the repeater is connected."
  548.      ::= { etherStatsEntry 13 }
  549.  
  550.  etherStatsPkts64Octets OBJECT-TYPE
  551.      SYNTAX     Counter32
  552.      UNITS      "Packets"
  553.      MAX-ACCESS read-only
  554.      STATUS     current
  555.      DESCRIPTION
  556.          "The total number of packets (including bad
  557.          packets) received that were 64 octets in length
  558.          (excluding framing bits but including FCS octets)."
  559.      ::= { etherStatsEntry 14 }
  560.  
  561.  etherStatsPkts65to127Octets OBJECT-TYPE
  562.      SYNTAX     Counter32
  563.      UNITS      "Packets"
  564.      MAX-ACCESS read-only
  565.      STATUS     current
  566.      DESCRIPTION
  567.          "The total number of packets (including bad
  568.          packets) received that were between
  569.          65 and 127 octets in length inclusive
  570.          (excluding framing bits but including FCS octets)."
  571.      ::= { etherStatsEntry 15 }
  572.  
  573.  etherStatsPkts128to255Octets OBJECT-TYPE
  574.      SYNTAX     Counter32
  575.      UNITS      "Packets"
  576.      MAX-ACCESS read-only
  577.  
  578.  
  579.  
  580.  
  581.  
  582.      STATUS     current
  583.      DESCRIPTION
  584.          "The total number of packets (including bad
  585.          packets) received that were between
  586.          128 and 255 octets in length inclusive
  587.          (excluding framing bits but including FCS octets)."
  588.      ::= { etherStatsEntry 16 }
  589.  
  590.  etherStatsPkts256to511Octets OBJECT-TYPE
  591.      SYNTAX     Counter32
  592.      UNITS      "Packets"
  593.      MAX-ACCESS read-only
  594.      STATUS     current
  595.      DESCRIPTION
  596.          "The total number of packets (including bad
  597.          packets) received that were between
  598.          256 and 511 octets in length inclusive
  599.          (excluding framing bits but including FCS octets)."
  600.      ::= { etherStatsEntry 17 }
  601.  
  602.  etherStatsPkts512to1023Octets OBJECT-TYPE
  603.      SYNTAX     Counter32
  604.      UNITS      "Packets"
  605.      MAX-ACCESS read-only
  606.      STATUS     current
  607.      DESCRIPTION
  608.          "The total number of packets (including bad
  609.          packets) received that were between
  610.          512 and 1023 octets in length inclusive
  611.          (excluding framing bits but including FCS octets)."
  612.      ::= { etherStatsEntry 18 }
  613.  
  614.  etherStatsPkts1024to1518Octets OBJECT-TYPE
  615.      SYNTAX     Counter32
  616.      UNITS      "Packets"
  617.      MAX-ACCESS read-only
  618.      STATUS     current
  619.      DESCRIPTION
  620.          "The total number of packets (including bad
  621.          packets) received that were between
  622.          1024 and 1518 octets in length inclusive
  623.          (excluding framing bits but including FCS octets)."
  624.      ::= { etherStatsEntry 19 }
  625.  
  626.  etherStatsOwner OBJECT-TYPE
  627.      SYNTAX     OwnerString
  628.      MAX-ACCESS read-create
  629.      STATUS     current
  630.  
  631.  
  632.  
  633.  
  634.  
  635.      DESCRIPTION
  636.          "The entity that configured this entry and is therefore
  637.          using the resources assigned to it."
  638.      ::= { etherStatsEntry 20 }
  639.  
  640.  etherStatsStatus OBJECT-TYPE
  641.      SYNTAX     EntryStatus
  642.      MAX-ACCESS read-create
  643.      STATUS     current
  644.      DESCRIPTION
  645.          "The status of this etherStats entry."
  646.      ::= { etherStatsEntry 21 }
  647.  
  648.  -- The History Control Group
  649.  
  650.  -- Implementation of the History Control group is optional.
  651.  -- Consult the MODULE-COMPLIANCE macro for the authoritative
  652.  -- conformance information for this MIB.
  653.  --
  654.  -- The history control group controls the periodic statistical
  655.  -- sampling of data from various types of networks.  The
  656.  -- historyControlTable stores configuration entries that each
  657.  -- define an interface, polling period, and other parameters.
  658.  -- Once samples are taken, their data is stored in an entry
  659.  -- in a media-specific table.  Each such entry defines one
  660.  -- sample, and is associated with the historyControlEntry that
  661.  -- caused the sample to be taken.  Each counter in the
  662.  -- etherHistoryEntry counts the same event as its similarly-named
  663.  -- counterpart in the etherStatsEntry, except that each value here
  664.  -- is a cumulative sum during a sampling period.
  665.  --
  666.  -- If the probe keeps track of the time of day, it should start
  667.  -- the first sample of the history at a time such that
  668.  -- when the next hour of the day begins, a sample is
  669.  -- started at that instant.  This tends to make more
  670.  -- user-friendly reports, and enables comparison of reports
  671.  -- from different probes that have relatively accurate time
  672.  -- of day.
  673.  --
  674.  -- The probe is encouraged to add two history control entries
  675.  -- per monitored interface upon initialization that describe a short
  676.  -- term and a long term polling period.  Suggested parameters are 30
  677.  -- seconds for the short term polling period and 30 minutes for
  678.  -- the long term period.
  679.  
  680.  historyControlTable OBJECT-TYPE
  681.      SYNTAX     SEQUENCE OF HistoryControlEntry
  682.      MAX-ACCESS not-accessible
  683.  
  684.  
  685.  
  686.  
  687.  
  688.      STATUS     current
  689.      DESCRIPTION
  690.          "A list of history control entries."
  691.      ::= { history 1 }
  692.  
  693.  historyControlEntry OBJECT-TYPE
  694.      SYNTAX     HistoryControlEntry
  695.      MAX-ACCESS not-accessible
  696.      STATUS     current
  697.      DESCRIPTION
  698.          "A list of parameters that set up a periodic sampling of
  699.          statistics.  As an example, an instance of the
  700.          historyControlInterval object might be named
  701.          historyControlInterval.2"
  702.      INDEX { historyControlIndex }
  703.      ::= { historyControlTable 1 }
  704.  
  705.  HistoryControlEntry ::= SEQUENCE {
  706.      historyControlIndex             Integer32,
  707.      historyControlDataSource        OBJECT IDENTIFIER,
  708.      historyControlBucketsRequested  Integer32,
  709.      historyControlBucketsGranted    Integer32,
  710.      historyControlInterval          Integer32,
  711.      historyControlOwner             OwnerString,
  712.      historyControlStatus            EntryStatus
  713.  }
  714.  
  715.  historyControlIndex OBJECT-TYPE
  716.      SYNTAX     Integer32 (1..65535)
  717.      MAX-ACCESS read-only
  718.      STATUS     current
  719.      DESCRIPTION
  720.          "An index that uniquely identifies an entry in the
  721.          historyControl table.  Each such entry defines a
  722.          set of samples at a particular interval for an
  723.          interface on the device."
  724.      ::= { historyControlEntry 1 }
  725.  
  726.  historyControlDataSource OBJECT-TYPE
  727.      SYNTAX     OBJECT IDENTIFIER
  728.      MAX-ACCESS read-create
  729.      STATUS     current
  730.      DESCRIPTION
  731.          "This object identifies the source of the data for
  732.          which historical data was collected and
  733.          placed in a media-specific table on behalf of this
  734.          historyControlEntry.  This source can be any
  735.          interface on this device.  In order to identify
  736.  
  737.  
  738.  
  739.  
  740.  
  741.          a particular interface, this object shall identify
  742.          the instance of the ifIndex object, defined
  743.          in  RFC 2233 [17], for the desired interface.
  744.          For example, if an entry were to receive data from
  745.          interface #1, this object would be set to ifIndex.1.
  746.  
  747.          The statistics in this group reflect all packets
  748.          on the local network segment attached to the identified
  749.          interface.
  750.  
  751.          An agent may or may not be able to tell if fundamental
  752.          changes to the media of the interface have occurred and
  753.          necessitate an invalidation of this entry.  For example, a
  754.          hot-pluggable ethernet card could be pulled out and replaced
  755.          by a token-ring card.  In such a case, if the agent has such
  756.          knowledge of the change, it is recommended that it
  757.          invalidate this entry.
  758.  
  759.          This object may not be modified if the associated
  760.          historyControlStatus object is equal to valid(1)."
  761.      ::= { historyControlEntry 2 }
  762.  
  763.  historyControlBucketsRequested OBJECT-TYPE
  764.      SYNTAX     Integer32 (1..65535)
  765.      MAX-ACCESS read-create
  766.      STATUS     current
  767.      DESCRIPTION
  768.          "The requested number of discrete time intervals
  769.          over which data is to be saved in the part of the
  770.          media-specific table associated with this
  771.          historyControlEntry.
  772.  
  773.          When this object is created or modified, the probe
  774.          should set historyControlBucketsGranted as closely to
  775.          this object as is possible for the particular probe
  776.          implementation and available resources."
  777.      DEFVAL { 50 }
  778.      ::= { historyControlEntry 3 }
  779.  
  780.  historyControlBucketsGranted OBJECT-TYPE
  781.      SYNTAX     Integer32 (1..65535)
  782.      MAX-ACCESS read-only
  783.      STATUS     current
  784.      DESCRIPTION
  785.          "The number of discrete sampling intervals
  786.          over which data shall be saved in the part of
  787.          the media-specific table associated with this
  788.          historyControlEntry.
  789.  
  790.  
  791.  
  792.  
  793.  
  794.          When the associated historyControlBucketsRequested
  795.          object is created or modified, the probe
  796.          should set this object as closely to the requested
  797.          value as is possible for the particular
  798.          probe implementation and available resources.  The
  799.          probe must not lower this value except as a result
  800.          of a modification to the associated
  801.          historyControlBucketsRequested object.
  802.  
  803.          There will be times when the actual number of
  804.          buckets associated with this entry is less than
  805.          the value of this object.  In this case, at the
  806.          end of each sampling interval, a new bucket will
  807.          be added to the media-specific table.
  808.  
  809.          When the number of buckets reaches the value of
  810.          this object and a new bucket is to be added to the
  811.          media-specific table, the oldest bucket associated
  812.          with this historyControlEntry shall be deleted by
  813.          the agent so that the new bucket can be added.
  814.  
  815.          When the value of this object changes to a value less
  816.          than the current value, entries are deleted
  817.          from the media-specific table associated with this
  818.          historyControlEntry.  Enough of the oldest of these
  819.          entries shall be deleted by the agent so that their
  820.          number remains less than or equal to the new value of
  821.          this object.
  822.  
  823.          When the value of this object changes to a value greater
  824.          than the current value, the number of associated media-
  825.          specific entries may be allowed to grow."
  826.      ::= { historyControlEntry 4 }
  827.  
  828.  historyControlInterval OBJECT-TYPE
  829.      SYNTAX     Integer32 (1..3600)
  830.      UNITS      "Seconds"
  831.      MAX-ACCESS read-create
  832.      STATUS     current
  833.      DESCRIPTION
  834.          "The interval in seconds over which the data is
  835.          sampled for each bucket in the part of the
  836.          media-specific table associated with this
  837.          historyControlEntry.  This interval can
  838.          be set to any number of seconds between 1 and
  839.          3600 (1 hour).
  840.  
  841.          Because the counters in a bucket may overflow at their
  842.  
  843.  
  844.  
  845.  
  846.  
  847.          maximum value with no indication, a prudent manager will
  848.          take into account the possibility of overflow in any of
  849.          the associated counters.  It is important to consider the
  850.          minimum time in which any counter could overflow on a
  851.          particular media type and set the historyControlInterval
  852.          object to a value less than this interval.  This is
  853.          typically most important for the 'octets' counter in any
  854.          media-specific table.  For example, on an Ethernet
  855.          network, the etherHistoryOctets counter could overflow
  856.          in about one hour at the Ethernet's maximum
  857.          utilization.
  858.  
  859.          This object may not be modified if the associated
  860.          historyControlStatus object is equal to valid(1)."
  861.      DEFVAL { 1800 }
  862.      ::= { historyControlEntry 5 }
  863.  
  864.  historyControlOwner OBJECT-TYPE
  865.      SYNTAX     OwnerString
  866.      MAX-ACCESS read-create
  867.      STATUS     current
  868.      DESCRIPTION
  869.          "The entity that configured this entry and is therefore
  870.          using the resources assigned to it."
  871.      ::= { historyControlEntry 6 }
  872.  
  873.  historyControlStatus OBJECT-TYPE
  874.      SYNTAX     EntryStatus
  875.      MAX-ACCESS read-create
  876.      STATUS     current
  877.      DESCRIPTION
  878.          "The status of this historyControl entry.
  879.  
  880.          Each instance of the media-specific table associated
  881.          with this historyControlEntry will be deleted by the agent
  882.          if this historyControlEntry is not equal to valid(1)."
  883.      ::= { historyControlEntry 7 }
  884.  
  885.  -- The Ethernet History Group
  886.  
  887.  -- Implementation of the Ethernet History group is optional.
  888.  -- Consult the MODULE-COMPLIANCE macro for the authoritative
  889.  -- conformance information for this MIB.
  890.  --
  891.  -- The Ethernet History group records periodic statistical samples
  892.  -- from a network and stores them for later retrieval.
  893.  -- Once samples are taken, their data is stored in an entry
  894.  -- in a media-specific table.  Each such entry defines one
  895.  
  896.  
  897.  
  898.  
  899.  
  900.  -- sample, and is associated with the historyControlEntry that
  901.  -- caused the sample to be taken.  This group defines the
  902.  -- etherHistoryTable, for Ethernet networks.
  903.  --
  904.  
  905.  etherHistoryTable OBJECT-TYPE
  906.      SYNTAX     SEQUENCE OF EtherHistoryEntry
  907.      MAX-ACCESS not-accessible
  908.      STATUS     current
  909.      DESCRIPTION
  910.          "A list of Ethernet history entries."
  911.      ::= { history 2 }
  912.  
  913.  etherHistoryEntry OBJECT-TYPE
  914.      SYNTAX     EtherHistoryEntry
  915.      MAX-ACCESS not-accessible
  916.      STATUS     current
  917.      DESCRIPTION
  918.          "An historical sample of Ethernet statistics on a particular
  919.          Ethernet interface.  This sample is associated with the
  920.          historyControlEntry which set up the parameters for
  921.          a regular collection of these samples.  As an example, an
  922.          instance of the etherHistoryPkts object might be named
  923.          etherHistoryPkts.2.89"
  924.      INDEX { etherHistoryIndex , etherHistorySampleIndex }
  925.      ::= { etherHistoryTable 1 }
  926.  
  927.  EtherHistoryEntry ::= SEQUENCE {
  928.      etherHistoryIndex                 Integer32,
  929.      etherHistorySampleIndex           Integer32,
  930.      etherHistoryIntervalStart         TimeTicks,
  931.      etherHistoryDropEvents            Counter32,
  932.      etherHistoryOctets                Counter32,
  933.      etherHistoryPkts                  Counter32,
  934.      etherHistoryBroadcastPkts         Counter32,
  935.      etherHistoryMulticastPkts         Counter32,
  936.      etherHistoryCRCAlignErrors        Counter32,
  937.      etherHistoryUndersizePkts         Counter32,
  938.      etherHistoryOversizePkts          Counter32,
  939.      etherHistoryFragments             Counter32,
  940.      etherHistoryJabbers               Counter32,
  941.      etherHistoryCollisions            Counter32,
  942.      etherHistoryUtilization           Integer32
  943.  }
  944.  
  945.  etherHistoryIndex OBJECT-TYPE
  946.      SYNTAX     Integer32 (1..65535)
  947.      MAX-ACCESS read-only
  948.  
  949.  
  950.  
  951.  
  952.  
  953.      STATUS     current
  954.      DESCRIPTION
  955.          "The history of which this entry is a part.  The
  956.          history identified by a particular value of this
  957.          index is the same history as identified
  958.          by the same value of historyControlIndex."
  959.      ::= { etherHistoryEntry 1 }
  960.  
  961.  etherHistorySampleIndex OBJECT-TYPE
  962.      SYNTAX     Integer32 (1..2147483647)
  963.      MAX-ACCESS read-only
  964.      STATUS     current
  965.      DESCRIPTION
  966.          "An index that uniquely identifies the particular
  967.          sample this entry represents among all samples
  968.          associated with the same historyControlEntry.
  969.          This index starts at 1 and increases by one
  970.          as each new sample is taken."
  971.      ::= { etherHistoryEntry 2 }
  972.  
  973.  etherHistoryIntervalStart OBJECT-TYPE
  974.      SYNTAX     TimeTicks
  975.      MAX-ACCESS read-only
  976.      STATUS     current
  977.      DESCRIPTION
  978.          "The value of sysUpTime at the start of the interval
  979.          over which this sample was measured.  If the probe
  980.          keeps track of the time of day, it should start
  981.          the first sample of the history at a time such that
  982.          when the next hour of the day begins, a sample is
  983.          started at that instant.  Note that following this
  984.          rule may require the probe to delay collecting the
  985.          first sample of the history, as each sample must be
  986.          of the same interval.  Also note that the sample which
  987.          is currently being collected is not accessible in this
  988.          table until the end of its interval."
  989.      ::= { etherHistoryEntry 3 }
  990.  
  991.  etherHistoryDropEvents OBJECT-TYPE
  992.      SYNTAX     Counter32
  993.      MAX-ACCESS read-only
  994.      STATUS     current
  995.      DESCRIPTION
  996.          "The total number of events in which packets
  997.          were dropped by the probe due to lack of resources
  998.          during this sampling interval.  Note that this number
  999.          is not necessarily the number of packets dropped, it
  1000.          is just the number of times this condition has been
  1001.  
  1002.  
  1003.  
  1004.  
  1005.  
  1006.          detected."
  1007.      ::= { etherHistoryEntry 4 }
  1008.  
  1009.  etherHistoryOctets OBJECT-TYPE
  1010.      SYNTAX     Counter32
  1011.      UNITS      "Octets"
  1012.      MAX-ACCESS read-only
  1013.      STATUS     current
  1014.      DESCRIPTION
  1015.          "The total number of octets of data (including
  1016.          those in bad packets) received on the
  1017.          network (excluding framing bits but including
  1018.          FCS octets)."
  1019.      ::= { etherHistoryEntry 5 }
  1020.  
  1021.  etherHistoryPkts OBJECT-TYPE
  1022.      SYNTAX     Counter32
  1023.      UNITS      "Packets"
  1024.      MAX-ACCESS read-only
  1025.      STATUS     current
  1026.      DESCRIPTION
  1027.          "The number of packets (including bad packets)
  1028.          received during this sampling interval."
  1029.      ::= { etherHistoryEntry 6 }
  1030.  
  1031.  etherHistoryBroadcastPkts OBJECT-TYPE
  1032.      SYNTAX     Counter32
  1033.      UNITS      "Packets"
  1034.      MAX-ACCESS read-only
  1035.      STATUS     current
  1036.      DESCRIPTION
  1037.          "The number of good packets received during this
  1038.          sampling interval that were directed to the
  1039.          broadcast address."
  1040.      ::= { etherHistoryEntry 7 }
  1041.  
  1042.  etherHistoryMulticastPkts OBJECT-TYPE
  1043.      SYNTAX     Counter32
  1044.      UNITS      "Packets"
  1045.      MAX-ACCESS read-only
  1046.      STATUS     current
  1047.      DESCRIPTION
  1048.          "The number of good packets received during this
  1049.          sampling interval that were directed to a
  1050.          multicast address.  Note that this number does not
  1051.          include packets addressed to the broadcast address."
  1052.      ::= { etherHistoryEntry 8 }
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  etherHistoryCRCAlignErrors OBJECT-TYPE
  1060.      SYNTAX     Counter32
  1061.      UNITS      "Packets"
  1062.      MAX-ACCESS read-only
  1063.      STATUS     current
  1064.      DESCRIPTION
  1065.          "The number of packets received during this
  1066.          sampling interval that had a length (excluding
  1067.          framing bits but including FCS octets) between
  1068.          64 and 1518 octets, inclusive, but had either a bad Frame
  1069.          Check Sequence (FCS) with an integral number of octets
  1070.          (FCS Error) or a bad FCS with a non-integral number
  1071.          of octets (Alignment Error)."
  1072.      ::= { etherHistoryEntry 9 }
  1073.  
  1074.  etherHistoryUndersizePkts OBJECT-TYPE
  1075.      SYNTAX     Counter32
  1076.      UNITS      "Packets"
  1077.      MAX-ACCESS read-only
  1078.      STATUS     current
  1079.      DESCRIPTION
  1080.          "The number of packets received during this
  1081.          sampling interval that were less than 64 octets
  1082.          long (excluding framing bits but including FCS
  1083.          octets) and were otherwise well formed."
  1084.      ::= { etherHistoryEntry 10 }
  1085.  
  1086.  etherHistoryOversizePkts OBJECT-TYPE
  1087.      SYNTAX     Counter32
  1088.      UNITS      "Packets"
  1089.      MAX-ACCESS read-only
  1090.      STATUS     current
  1091.      DESCRIPTION
  1092.          "The number of packets received during this
  1093.          sampling interval that were longer than 1518
  1094.          octets (excluding framing bits but including
  1095.          FCS octets) but were otherwise well formed."
  1096.      ::= { etherHistoryEntry 11 }
  1097.  
  1098.  etherHistoryFragments OBJECT-TYPE
  1099.      SYNTAX     Counter32
  1100.      UNITS      "Packets"
  1101.      MAX-ACCESS read-only
  1102.      STATUS     current
  1103.      DESCRIPTION
  1104.          "The total number of packets received during this
  1105.          sampling interval that were less than 64 octets in
  1106.          length (excluding framing bits but including FCS
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.          octets) had either a bad Frame Check Sequence (FCS)
  1113.          with an integral number of octets (FCS Error) or a bad
  1114.          FCS with a non-integral number of octets (Alignment
  1115.          Error).
  1116.  
  1117.          Note that it is entirely normal for etherHistoryFragments to
  1118.          increment.  This is because it counts both runts (which are
  1119.          normal occurrences due to collisions) and noise hits."
  1120.      ::= { etherHistoryEntry 12 }
  1121.  
  1122.  etherHistoryJabbers OBJECT-TYPE
  1123.      SYNTAX     Counter32
  1124.      UNITS      "Packets"
  1125.      MAX-ACCESS read-only
  1126.      STATUS     current
  1127.      DESCRIPTION
  1128.          "The number of packets received during this
  1129.          sampling interval that were longer than 1518 octets
  1130.          (excluding framing bits but including FCS octets),
  1131.          and  had either a bad Frame Check Sequence (FCS)
  1132.          with an integral number of octets (FCS Error) or
  1133.          a bad FCS with a non-integral number of octets
  1134.          (Alignment Error).
  1135.  
  1136.          Note that this definition of jabber is different
  1137.          than the definition in IEEE-802.3 section 8.2.1.5
  1138.          (10BASE5) and section 10.3.1.4 (10BASE2).  These
  1139.          documents define jabber as the condition where any
  1140.          packet exceeds 20 ms.  The allowed range to detect
  1141.          jabber is between 20 ms and 150 ms."
  1142.      ::= { etherHistoryEntry 13 }
  1143.  
  1144.  etherHistoryCollisions OBJECT-TYPE
  1145.      SYNTAX     Counter32
  1146.      UNITS      "Collisions"
  1147.      MAX-ACCESS read-only
  1148.      STATUS     current
  1149.      DESCRIPTION
  1150.          "The best estimate of the total number of collisions
  1151.          on this Ethernet segment during this sampling
  1152.          interval.
  1153.  
  1154.          The value returned will depend on the location of the
  1155.          RMON probe. Section 8.2.1.3 (10BASE-5) and section
  1156.          10.3.1.3 (10BASE-2) of IEEE standard 802.3 states that a
  1157.          station must detect a collision, in the receive mode, if
  1158.          three or more stations are transmitting simultaneously.  A
  1159.          repeater port must detect a collision when two or more
  1160.  
  1161.  
  1162.  
  1163.  
  1164.  
  1165.          stations are transmitting simultaneously.  Thus a probe
  1166.          placed on a repeater port could record more collisions
  1167.          than a probe connected to a station on the same segment
  1168.          would.
  1169.  
  1170.          Probe location plays a much smaller role when considering
  1171.          10BASE-T.  14.2.1.4 (10BASE-T) of IEEE standard 802.3
  1172.          defines a collision as the simultaneous presence of signals
  1173.          on the DO and RD circuits (transmitting and receiving
  1174.          at the same time).  A 10BASE-T station can only detect
  1175.          collisions when it is transmitting.  Thus probes placed on
  1176.          a station and a repeater, should report the same number of
  1177.          collisions.
  1178.  
  1179.          Note also that an RMON probe inside a repeater should
  1180.          ideally report collisions between the repeater and one or
  1181.          more other hosts (transmit collisions as defined by IEEE
  1182.          802.3k) plus receiver collisions observed on any coax
  1183.          segments to which the repeater is connected."
  1184.      ::= { etherHistoryEntry 14 }
  1185.  
  1186.  etherHistoryUtilization OBJECT-TYPE
  1187.      SYNTAX     Integer32 (0..10000)
  1188.      MAX-ACCESS read-only
  1189.      STATUS     current
  1190.      DESCRIPTION
  1191.          "The best estimate of the mean physical layer
  1192.          network utilization on this interface during this
  1193.          sampling interval, in hundredths of a percent."
  1194.      ::= { etherHistoryEntry 15 }
  1195.  
  1196.  -- The Alarm Group
  1197.  
  1198.  -- Implementation of the Alarm group is optional. The Alarm Group
  1199.  -- requires the implementation of the Event group.
  1200.  -- Consult the MODULE-COMPLIANCE macro for the authoritative
  1201.  -- conformance information for this MIB.
  1202.  --
  1203.  -- The Alarm group periodically takes statistical samples from
  1204.  -- variables in the probe and compares them to thresholds that have
  1205.  -- been configured.  The alarm table stores configuration
  1206.  -- entries that each define a variable, polling period, and
  1207.  -- threshold parameters.  If a sample is found to cross the
  1208.  -- threshold values, an event is generated.  Only variables that
  1209.  -- resolve to an ASN.1 primitive type of INTEGER (INTEGER, Integer32,
  1210.  -- Counter32, Counter64, Gauge32, or TimeTicks) may be monitored in
  1211.  -- this way.
  1212.  --
  1213.  
  1214.  
  1215.  
  1216.  
  1217.  
  1218.  -- This function has a hysteresis mechanism to limit the generation
  1219.  -- of events.  This mechanism generates one event as a threshold
  1220.  -- is crossed in the appropriate direction.  No more events are
  1221.  -- generated for that threshold until the opposite threshold is
  1222.  -- crossed.
  1223.  --
  1224.  -- In the case of a sampling a deltaValue, a probe may implement
  1225.  -- this mechanism with more precision if it takes a delta sample
  1226.  -- twice per period, each time comparing the sum of the latest two
  1227.  -- samples to the threshold.  This allows the detection of threshold
  1228.  -- crossings that span the sampling boundary.  Note that this does
  1229.  -- not require any special configuration of the threshold value.
  1230.  -- It is suggested that probes implement this more precise algorithm.
  1231.  
  1232.  alarmTable OBJECT-TYPE
  1233.      SYNTAX     SEQUENCE OF AlarmEntry
  1234.      MAX-ACCESS not-accessible
  1235.      STATUS     current
  1236.      DESCRIPTION
  1237.          "A list of alarm entries."
  1238.      ::= { alarm 1 }
  1239.  
  1240.  alarmEntry OBJECT-TYPE
  1241.      SYNTAX     AlarmEntry
  1242.      MAX-ACCESS not-accessible
  1243.      STATUS     current
  1244.      DESCRIPTION
  1245.          "A list of parameters that set up a periodic checking
  1246.          for alarm conditions.  For example, an instance of the
  1247.          alarmValue object might be named alarmValue.8"
  1248.      INDEX { alarmIndex }
  1249.      ::= { alarmTable 1 }
  1250.  
  1251.  AlarmEntry ::= SEQUENCE {
  1252.      alarmIndex                    Integer32,
  1253.      alarmInterval                 Integer32,
  1254.      alarmVariable                 OBJECT IDENTIFIER,
  1255.      alarmSampleType               INTEGER,
  1256.      alarmValue                    Integer32,
  1257.      alarmStartupAlarm             INTEGER,
  1258.      alarmRisingThreshold          Integer32,
  1259.      alarmFallingThreshold         Integer32,
  1260.      alarmRisingEventIndex         Integer32,
  1261.      alarmFallingEventIndex        Integer32,
  1262.      alarmOwner                    OwnerString,
  1263.      alarmStatus                   EntryStatus
  1264.  }
  1265.  
  1266.  
  1267.  
  1268.  
  1269.  
  1270.  
  1271.  alarmIndex OBJECT-TYPE
  1272.      SYNTAX     Integer32 (1..65535)
  1273.      MAX-ACCESS read-only
  1274.      STATUS     current
  1275.      DESCRIPTION
  1276.          "An index that uniquely identifies an entry in the
  1277.          alarm table.  Each such entry defines a
  1278.          diagnostic sample at a particular interval
  1279.          for an object on the device."
  1280.      ::= { alarmEntry 1 }
  1281.  
  1282.  alarmInterval OBJECT-TYPE
  1283.      SYNTAX     Integer32
  1284.      UNITS      "Seconds"
  1285.      MAX-ACCESS read-create
  1286.      STATUS     current
  1287.      DESCRIPTION
  1288.          "The interval in seconds over which the data is
  1289.          sampled and compared with the rising and falling
  1290.          thresholds.  When setting this variable, care
  1291.          should be taken in the case of deltaValue
  1292.          sampling - the interval should be set short enough
  1293.          that the sampled variable is very unlikely to
  1294.          increase or decrease by more than 2^31 - 1 during
  1295.          a single sampling interval.
  1296.  
  1297.          This object may not be modified if the associated
  1298.          alarmStatus object is equal to valid(1)."
  1299.      ::= { alarmEntry 2 }
  1300.  
  1301.  alarmVariable OBJECT-TYPE
  1302.      SYNTAX     OBJECT IDENTIFIER
  1303.      MAX-ACCESS read-create
  1304.      STATUS     current
  1305.      DESCRIPTION
  1306.          "The object identifier of the particular variable to be
  1307.          sampled.  Only variables that resolve to an ASN.1 primitive
  1308.          type of INTEGER (INTEGER, Integer32, Counter32, Counter64,
  1309.          Gauge, or TimeTicks) may be sampled.
  1310.  
  1311.          Because SNMP access control is articulated entirely
  1312.          in terms of the contents of MIB views, no access
  1313.          control mechanism exists that can restrict the value of
  1314.          this object to identify only those objects that exist
  1315.          in a particular MIB view.  Because there is thus no
  1316.          acceptable means of restricting the read access that
  1317.          could be obtained through the alarm mechanism, the
  1318.          probe must only grant write access to this object in
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324.          those views that have read access to all objects on
  1325.          the probe.
  1326.  
  1327.          During a set operation, if the supplied variable name is
  1328.          not available in the selected MIB view, a badValue error
  1329.          must be returned.  If at any time the variable name of
  1330.          an established alarmEntry is no longer available in the
  1331.          selected MIB view, the probe must change the status of
  1332.          this alarmEntry to invalid(4).
  1333.  
  1334.          This object may not be modified if the associated
  1335.          alarmStatus object is equal to valid(1)."
  1336.      ::= { alarmEntry 3 }
  1337.  
  1338.  alarmSampleType OBJECT-TYPE
  1339.      SYNTAX     INTEGER {
  1340.                   absoluteValue(1),
  1341.                   deltaValue(2)
  1342.                 }
  1343.      MAX-ACCESS read-create
  1344.      STATUS     current
  1345.      DESCRIPTION
  1346.          "The method of sampling the selected variable and
  1347.          calculating the value to be compared against the
  1348.          thresholds.  If the value of this object is
  1349.          absoluteValue(1), the value of the selected variable
  1350.          will be compared directly with the thresholds at the
  1351.          end of the sampling interval.  If the value of this
  1352.          object is deltaValue(2), the value of the selected
  1353.          variable at the last sample will be subtracted from
  1354.          the current value, and the difference compared with
  1355.          the thresholds.
  1356.  
  1357.          This object may not be modified if the associated
  1358.          alarmStatus object is equal to valid(1)."
  1359.      ::= { alarmEntry 4 }
  1360.  
  1361.  alarmValue OBJECT-TYPE
  1362.      SYNTAX     Integer32
  1363.      MAX-ACCESS read-only
  1364.      STATUS     current
  1365.      DESCRIPTION
  1366.          "The value of the statistic during the last sampling
  1367.          period.  For example, if the sample type is deltaValue,
  1368.          this value will be the difference between the samples
  1369.          at the beginning and end of the period.  If the sample
  1370.          type is absoluteValue, this value will be the sampled
  1371.          value at the end of the period.
  1372.  
  1373.  
  1374.  
  1375.  
  1376.  
  1377.          This is the value that is compared with the rising and
  1378.          falling thresholds.
  1379.  
  1380.          The value during the current sampling period is not
  1381.          made available until the period is completed and will
  1382.          remain available until the next period completes."
  1383.      ::= { alarmEntry 5 }
  1384.  
  1385.  alarmStartupAlarm OBJECT-TYPE
  1386.      SYNTAX     INTEGER {
  1387.                   risingAlarm(1),
  1388.                   fallingAlarm(2),
  1389.                   risingOrFallingAlarm(3)
  1390.                 }
  1391.      MAX-ACCESS read-create
  1392.      STATUS     current
  1393.      DESCRIPTION
  1394.          "The alarm that may be sent when this entry is first
  1395.          set to valid.  If the first sample after this entry
  1396.          becomes valid is greater than or equal to the
  1397.          risingThreshold and alarmStartupAlarm is equal to
  1398.          risingAlarm(1) or risingOrFallingAlarm(3), then a single
  1399.          rising alarm will be generated.  If the first sample
  1400.          after this entry becomes valid is less than or equal
  1401.          to the fallingThreshold and alarmStartupAlarm is equal
  1402.          to fallingAlarm(2) or risingOrFallingAlarm(3), then a
  1403.          single falling alarm will be generated.
  1404.  
  1405.          This object may not be modified if the associated
  1406.          alarmStatus object is equal to valid(1)."
  1407.      ::= { alarmEntry 6 }
  1408.  
  1409.  alarmRisingThreshold OBJECT-TYPE
  1410.      SYNTAX     Integer32
  1411.      MAX-ACCESS read-create
  1412.      STATUS     current
  1413.      DESCRIPTION
  1414.          "A threshold for the sampled statistic.  When the current
  1415.          sampled value is greater than or equal to this threshold,
  1416.          and the value at the last sampling interval was less than
  1417.          this threshold, a single event will be generated.
  1418.          A single event will also be generated if the first
  1419.          sample after this entry becomes valid is greater than or
  1420.          equal to this threshold and the associated
  1421.          alarmStartupAlarm is equal to risingAlarm(1) or
  1422.          risingOrFallingAlarm(3).
  1423.  
  1424.          After a rising event is generated, another such event
  1425.  
  1426.  
  1427.  
  1428.  
  1429.  
  1430.          will not be generated until the sampled value
  1431.          falls below this threshold and reaches the
  1432.          alarmFallingThreshold.
  1433.  
  1434.          This object may not be modified if the associated
  1435.          alarmStatus object is equal to valid(1)."
  1436.      ::= { alarmEntry 7 }
  1437.  
  1438.  alarmFallingThreshold OBJECT-TYPE
  1439.      SYNTAX     Integer32
  1440.      MAX-ACCESS read-create
  1441.      STATUS     current
  1442.      DESCRIPTION
  1443.          "A threshold for the sampled statistic.  When the current
  1444.          sampled value is less than or equal to this threshold,
  1445.          and the value at the last sampling interval was greater than
  1446.          this threshold, a single event will be generated.
  1447.          A single event will also be generated if the first
  1448.          sample after this entry becomes valid is less than or
  1449.          equal to this threshold and the associated
  1450.          alarmStartupAlarm is equal to fallingAlarm(2) or
  1451.          risingOrFallingAlarm(3).
  1452.  
  1453.          After a falling event is generated, another such event
  1454.          will not be generated until the sampled value
  1455.          rises above this threshold and reaches the
  1456.          alarmRisingThreshold.
  1457.  
  1458.          This object may not be modified if the associated
  1459.          alarmStatus object is equal to valid(1)."
  1460.      ::= { alarmEntry 8 }
  1461.  
  1462.  alarmRisingEventIndex OBJECT-TYPE
  1463.      SYNTAX     Integer32 (0..65535)
  1464.      MAX-ACCESS read-create
  1465.      STATUS     current
  1466.      DESCRIPTION
  1467.          "The index of the eventEntry that is
  1468.          used when a rising threshold is crossed.  The
  1469.          eventEntry identified by a particular value of
  1470.          this index is the same as identified by the same value
  1471.          of the eventIndex object.  If there is no
  1472.          corresponding entry in the eventTable, then
  1473.          no association exists.  In particular, if this value
  1474.          is zero, no associated event will be generated, as
  1475.          zero is not a valid event index.
  1476.  
  1477.          This object may not be modified if the associated
  1478.  
  1479.  
  1480.  
  1481.  
  1482.  
  1483.          alarmStatus object is equal to valid(1)."
  1484.      ::= { alarmEntry 9 }
  1485.  
  1486.  alarmFallingEventIndex OBJECT-TYPE
  1487.      SYNTAX     Integer32 (0..65535)
  1488.      MAX-ACCESS read-create
  1489.      STATUS     current
  1490.      DESCRIPTION
  1491.          "The index of the eventEntry that is
  1492.          used when a falling threshold is crossed.  The
  1493.          eventEntry identified by a particular value of
  1494.          this index is the same as identified by the same value
  1495.          of the eventIndex object.  If there is no
  1496.          corresponding entry in the eventTable, then
  1497.          no association exists.  In particular, if this value
  1498.          is zero, no associated event will be generated, as
  1499.          zero is not a valid event index.
  1500.  
  1501.          This object may not be modified if the associated
  1502.          alarmStatus object is equal to valid(1)."
  1503.      ::= { alarmEntry 10 }
  1504.  
  1505.  alarmOwner OBJECT-TYPE
  1506.      SYNTAX     OwnerString
  1507.      MAX-ACCESS read-create
  1508.      STATUS     current
  1509.      DESCRIPTION
  1510.          "The entity that configured this entry and is therefore
  1511.          using the resources assigned to it."
  1512.      ::= { alarmEntry 11 }
  1513.  
  1514.  alarmStatus OBJECT-TYPE
  1515.      SYNTAX     EntryStatus
  1516.      MAX-ACCESS read-create
  1517.      STATUS     current
  1518.      DESCRIPTION
  1519.          "The status of this alarm entry."
  1520.      ::= { alarmEntry 12 }
  1521.  
  1522.  -- The Host Group
  1523.  
  1524.  -- Implementation of the Host group is optional.
  1525.  -- Consult the MODULE-COMPLIANCE macro for the authoritative
  1526.  -- conformance information for this MIB.
  1527.  --
  1528.  -- The host group discovers new hosts on the network by
  1529.  -- keeping a list of source and destination MAC Addresses seen
  1530.  -- in good packets.  For each of these addresses, the host group
  1531.  
  1532.  
  1533.  
  1534.  
  1535.  
  1536.  -- keeps a set of statistics.  The hostControlTable controls
  1537.  -- which interfaces this function is performed on, and contains
  1538.  -- some information about the process.  On behalf of each
  1539.  -- hostControlEntry, data is collected on an interface and placed
  1540.  -- in both the hostTable and the hostTimeTable.  If the
  1541.  -- monitoring device finds itself short of resources, it may
  1542.  -- delete entries as needed.  It is suggested that the device
  1543.  -- delete the least recently used entries first.
  1544.  
  1545.  -- The hostTable contains entries for each address discovered on
  1546.  -- a particular interface.  Each entry contains statistical
  1547.  -- data about that host.  This table is indexed by the
  1548.  -- MAC address of the host, through which a random access
  1549.  -- may be achieved.
  1550.  
  1551.  -- The hostTimeTable contains data in the same format as the
  1552.  -- hostTable, and must contain the same set of hosts, but is
  1553.  -- indexed using hostTimeCreationOrder rather than hostAddress.
  1554.  -- The hostTimeCreationOrder is an integer which reflects
  1555.  -- the relative order in which a particular entry was discovered
  1556.  -- and thus inserted into the table.  As this order, and thus
  1557.  -- the index, is among those entries currently in the table,
  1558.  -- the index for a particular entry may change if an
  1559.  -- (earlier) entry is deleted.  Thus the association between
  1560.  -- hostTimeCreationOrder and hostTimeEntry may be broken at
  1561.  -- any time.
  1562.  
  1563.  -- The hostTimeTable has two important uses.  The first is the
  1564.  -- fast download of this potentially large table.  Because the
  1565.  -- index of this table runs from 1 to the size of the table,
  1566.  -- inclusive, its values are predictable.  This allows very
  1567.  -- efficient packing of variables into SNMP PDU's and allows
  1568.  -- a table transfer to have multiple packets outstanding.
  1569.  -- These benefits increase transfer rates tremendously.
  1570.  
  1571.  -- The second use of the hostTimeTable is the efficient discovery
  1572.  -- by the management station of new entries added to the table.
  1573.  -- After the management station has downloaded the entire table,
  1574.  -- it knows that new entries will be added immediately after the
  1575.  -- end of the current table.  It can thus detect new entries there
  1576.  -- and retrieve them easily.
  1577.  
  1578.  -- Because the association between hostTimeCreationOrder and
  1579.  -- hostTimeEntry may be broken at any time, the management
  1580.  -- station must monitor the related hostControlLastDeleteTime
  1581.  -- object.  When the management station thus detects a deletion,
  1582.  -- it must assume that any such associations have been broken,
  1583.  -- and invalidate any it has stored locally.  This includes
  1584.  
  1585.  
  1586.  
  1587.  
  1588.  
  1589.  -- restarting any download of the hostTimeTable that may have been
  1590.  -- in progress, as well as rediscovering the end of the
  1591.  -- hostTimeTable so that it may detect new entries.  If the
  1592.  -- management station does not detect the broken association,
  1593.  -- it may continue to refer to a particular host by its
  1594.  -- creationOrder while unwittingly retrieving the data associated
  1595.  -- with another host entirely.  If this happens while downloading
  1596.  -- the host table, the management station may fail to download
  1597.  -- all of the entries in the table.
  1598.  
  1599.  
  1600.  hostControlTable OBJECT-TYPE
  1601.      SYNTAX     SEQUENCE OF HostControlEntry
  1602.      MAX-ACCESS not-accessible
  1603.      STATUS     current
  1604.      DESCRIPTION
  1605.          "A list of host table control entries."
  1606.      ::= { hosts 1 }
  1607.  
  1608.  hostControlEntry OBJECT-TYPE
  1609.      SYNTAX     HostControlEntry
  1610.      MAX-ACCESS not-accessible
  1611.      STATUS     current
  1612.      DESCRIPTION
  1613.          "A list of parameters that set up the discovery of hosts
  1614.          on a particular interface and the collection of statistics
  1615.          about these hosts.  For example, an instance of the
  1616.          hostControlTableSize object might be named
  1617.          hostControlTableSize.1"
  1618.      INDEX { hostControlIndex }
  1619.      ::= { hostControlTable 1 }
  1620.  
  1621.  HostControlEntry ::= SEQUENCE {
  1622.  
  1623.      hostControlIndex            Integer32,
  1624.      hostControlDataSource       OBJECT IDENTIFIER,
  1625.      hostControlTableSize        Integer32,
  1626.      hostControlLastDeleteTime   TimeTicks,
  1627.      hostControlOwner            OwnerString,
  1628.      hostControlStatus           EntryStatus
  1629.  }
  1630.  
  1631.  hostControlIndex OBJECT-TYPE
  1632.      SYNTAX     Integer32 (1..65535)
  1633.      MAX-ACCESS read-only
  1634.      STATUS     current
  1635.      DESCRIPTION
  1636.          "An index that uniquely identifies an entry in the
  1637.  
  1638.  
  1639.  
  1640.  
  1641.  
  1642.          hostControl table.  Each such entry defines
  1643.          a function that discovers hosts on a particular interface
  1644.          and places statistics about them in the hostTable and
  1645.          the hostTimeTable on behalf of this hostControlEntry."
  1646.      ::= { hostControlEntry 1 }
  1647.  
  1648.  hostControlDataSource OBJECT-TYPE
  1649.      SYNTAX     OBJECT IDENTIFIER
  1650.      MAX-ACCESS read-create
  1651.      STATUS     current
  1652.      DESCRIPTION
  1653.          "This object identifies the source of the data for
  1654.          this instance of the host function.  This source
  1655.          can be any interface on this device.  In order
  1656.          to identify a particular interface, this object shall
  1657.          identify the instance of the ifIndex object, defined
  1658.          in RFC 2233 [17], for the desired interface.
  1659.          For example, if an entry were to receive data from
  1660.          interface #1, this object would be set to ifIndex.1.
  1661.  
  1662.          The statistics in this group reflect all packets
  1663.          on the local network segment attached to the identified
  1664.          interface.
  1665.  
  1666.          An agent may or may not be able to tell if fundamental
  1667.          changes to the media of the interface have occurred and
  1668.          necessitate an invalidation of this entry.  For example, a
  1669.          hot-pluggable ethernet card could be pulled out and replaced
  1670.          by a token-ring card.  In such a case, if the agent has such
  1671.          knowledge of the change, it is recommended that it
  1672.          invalidate this entry.
  1673.  
  1674.          This object may not be modified if the associated
  1675.          hostControlStatus object is equal to valid(1)."
  1676.      ::= { hostControlEntry 2 }
  1677.  
  1678.  hostControlTableSize OBJECT-TYPE
  1679.      SYNTAX     Integer32
  1680.      MAX-ACCESS read-only
  1681.      STATUS     current
  1682.      DESCRIPTION
  1683.          "The number of hostEntries in the hostTable and the
  1684.          hostTimeTable associated with this hostControlEntry."
  1685.      ::= { hostControlEntry 3 }
  1686.  
  1687.  hostControlLastDeleteTime OBJECT-TYPE
  1688.      SYNTAX     TimeTicks
  1689.      MAX-ACCESS read-only
  1690.  
  1691.  
  1692.  
  1693.  
  1694.  
  1695.      STATUS     current
  1696.      DESCRIPTION
  1697.          "The value of sysUpTime when the last entry
  1698.          was deleted from the portion of the hostTable
  1699.          associated with this hostControlEntry.  If no
  1700.          deletions have occurred, this value shall be zero."
  1701.      ::= { hostControlEntry 4 }
  1702.  
  1703.  hostControlOwner OBJECT-TYPE
  1704.      SYNTAX     OwnerString
  1705.      MAX-ACCESS read-create
  1706.      STATUS     current
  1707.      DESCRIPTION
  1708.          "The entity that configured this entry and is therefore
  1709.          using the resources assigned to it."
  1710.      ::= { hostControlEntry 5 }
  1711.  
  1712.  hostControlStatus OBJECT-TYPE
  1713.      SYNTAX     EntryStatus
  1714.      MAX-ACCESS read-create
  1715.      STATUS     current
  1716.      DESCRIPTION
  1717.          "The status of this hostControl entry.
  1718.  
  1719.          If this object is not equal to valid(1), all associated
  1720.          entries in the hostTable, hostTimeTable, and the
  1721.          hostTopNTable shall be deleted by the agent."
  1722.      ::= { hostControlEntry 6 }
  1723.  
  1724.  hostTable OBJECT-TYPE
  1725.      SYNTAX     SEQUENCE OF HostEntry
  1726.      MAX-ACCESS not-accessible
  1727.      STATUS     current
  1728.      DESCRIPTION
  1729.          "A list of host entries."
  1730.      ::= { hosts 2 }
  1731.  
  1732.  hostEntry OBJECT-TYPE
  1733.      SYNTAX     HostEntry
  1734.      MAX-ACCESS not-accessible
  1735.      STATUS     current
  1736.      DESCRIPTION
  1737.          "A collection of statistics for a particular host that has
  1738.          been discovered on an interface of this device.  For example,
  1739.          an instance of the hostOutBroadcastPkts object might be
  1740.          named hostOutBroadcastPkts.1.6.8.0.32.27.3.176"
  1741.      INDEX { hostIndex, hostAddress }
  1742.      ::= { hostTable 1 }
  1743.  
  1744.  
  1745.  
  1746.  
  1747.  
  1748.  HostEntry ::= SEQUENCE {
  1749.      hostAddress             OCTET STRING,
  1750.      hostCreationOrder       Integer32,
  1751.      hostIndex               Integer32,
  1752.      hostInPkts              Counter32,
  1753.      hostOutPkts             Counter32,
  1754.      hostInOctets            Counter32,
  1755.      hostOutOctets           Counter32,
  1756.      hostOutErrors           Counter32,
  1757.      hostOutBroadcastPkts    Counter32,
  1758.      hostOutMulticastPkts    Counter32
  1759.  }
  1760.  
  1761.  hostAddress OBJECT-TYPE
  1762.      SYNTAX     OCTET STRING
  1763.      MAX-ACCESS read-only
  1764.      STATUS     current
  1765.      DESCRIPTION
  1766.          "The physical address of this host."
  1767.      ::= { hostEntry 1 }
  1768.  
  1769.  hostCreationOrder OBJECT-TYPE
  1770.      SYNTAX     Integer32 (1..65535)
  1771.      MAX-ACCESS read-only
  1772.      STATUS     current
  1773.      DESCRIPTION
  1774.          "An index that defines the relative ordering of
  1775.          the creation time of hosts captured for a
  1776.          particular hostControlEntry.  This index shall
  1777.          be between 1 and N, where N is the value of
  1778.          the associated hostControlTableSize.  The ordering
  1779.          of the indexes is based on the order of each entry's
  1780.          insertion into the table, in which entries added earlier
  1781.          have a lower index value than entries added later.
  1782.  
  1783.          It is important to note that the order for a
  1784.          particular entry may change as an (earlier) entry
  1785.          is deleted from the table.  Because this order may
  1786.          change, management stations should make use of the
  1787.          hostControlLastDeleteTime variable in the
  1788.          hostControlEntry associated with the relevant
  1789.          portion of the hostTable.  By observing
  1790.          this variable, the management station may detect
  1791.          the circumstances where a previous association
  1792.          between a value of hostCreationOrder
  1793.          and a hostEntry may no longer hold."
  1794.      ::= { hostEntry 2 }
  1795.  
  1796.  
  1797.  
  1798.  
  1799.  
  1800.  
  1801.  hostIndex OBJECT-TYPE
  1802.      SYNTAX     Integer32 (1..65535)
  1803.      MAX-ACCESS read-only
  1804.      STATUS     current
  1805.      DESCRIPTION
  1806.          "The set of collected host statistics of which
  1807.          this entry is a part.  The set of hosts
  1808.          identified by a particular value of this
  1809.          index is associated with the hostControlEntry
  1810.          as identified by the same value of hostControlIndex."
  1811.      ::= { hostEntry 3 }
  1812.  
  1813.  hostInPkts OBJECT-TYPE
  1814.      SYNTAX     Counter32
  1815.      UNITS      "Packets"
  1816.      MAX-ACCESS read-only
  1817.      STATUS     current
  1818.      DESCRIPTION
  1819.          "The number of good packets transmitted to this
  1820.          address since it was added to the hostTable."
  1821.      ::= { hostEntry 4 }
  1822.  
  1823.  hostOutPkts OBJECT-TYPE
  1824.      SYNTAX     Counter32
  1825.      UNITS      "Packets"
  1826.      MAX-ACCESS read-only
  1827.      STATUS     current
  1828.      DESCRIPTION
  1829.          "The number of packets, including bad packets, transmitted
  1830.          by this address since it was added to the hostTable."
  1831.      ::= { hostEntry 5 }
  1832.  
  1833.  hostInOctets OBJECT-TYPE
  1834.      SYNTAX     Counter32
  1835.      UNITS      "Octets"
  1836.      MAX-ACCESS read-only
  1837.      STATUS     current
  1838.      DESCRIPTION
  1839.          "The number of octets transmitted to this address since
  1840.          it was added to the hostTable (excluding framing
  1841.          bits but including FCS octets), except for those
  1842.          octets in bad packets."
  1843.      ::= { hostEntry 6 }
  1844.  
  1845.  hostOutOctets OBJECT-TYPE
  1846.      SYNTAX     Counter32
  1847.      UNITS      "Octets"
  1848.      MAX-ACCESS read-only
  1849.  
  1850.  
  1851.  
  1852.  
  1853.  
  1854.      STATUS     current
  1855.      DESCRIPTION
  1856.          "The number of octets transmitted by this address since
  1857.          it was added to the hostTable (excluding framing
  1858.          bits but including FCS octets), including those
  1859.          octets in bad packets."
  1860.      ::= { hostEntry 7 }
  1861.  
  1862.  hostOutErrors OBJECT-TYPE
  1863.      SYNTAX     Counter32
  1864.      UNITS      "Packets"
  1865.      MAX-ACCESS read-only
  1866.      STATUS     current
  1867.      DESCRIPTION
  1868.          "The number of bad packets transmitted by this address
  1869.          since this host was added to the hostTable."
  1870.      ::= { hostEntry 8 }
  1871.  
  1872.  hostOutBroadcastPkts OBJECT-TYPE
  1873.      SYNTAX     Counter32
  1874.      UNITS      "Packets"
  1875.      MAX-ACCESS read-only
  1876.      STATUS     current
  1877.      DESCRIPTION
  1878.          "The number of good packets transmitted by this
  1879.          address that were directed to the broadcast address
  1880.          since this host was added to the hostTable."
  1881.      ::= { hostEntry 9 }
  1882.  
  1883.  hostOutMulticastPkts OBJECT-TYPE
  1884.      SYNTAX     Counter32
  1885.      UNITS      "Packets"
  1886.      MAX-ACCESS read-only
  1887.      STATUS     current
  1888.      DESCRIPTION
  1889.          "The number of good packets transmitted by this
  1890.          address that were directed to a multicast address
  1891.          since this host was added to the hostTable.
  1892.          Note that this number does not include packets
  1893.          directed to the broadcast address."
  1894.      ::= { hostEntry 10 }
  1895.  
  1896.  -- host Time Table
  1897.  
  1898.  hostTimeTable OBJECT-TYPE
  1899.      SYNTAX     SEQUENCE OF HostTimeEntry
  1900.      MAX-ACCESS not-accessible
  1901.      STATUS     current
  1902.  
  1903.  
  1904.  
  1905.  
  1906.  
  1907.      DESCRIPTION
  1908.          "A list of time-ordered host table entries."
  1909.      ::= { hosts 3 }
  1910.  
  1911.  hostTimeEntry OBJECT-TYPE
  1912.      SYNTAX     HostTimeEntry
  1913.      MAX-ACCESS not-accessible
  1914.      STATUS     current
  1915.      DESCRIPTION
  1916.          "A collection of statistics for a particular host that has
  1917.          been discovered on an interface of this device.  This
  1918.          collection includes the relative ordering of the creation
  1919.          time of this object.  For example, an instance of the
  1920.          hostTimeOutBroadcastPkts object might be named
  1921.          hostTimeOutBroadcastPkts.1.687"
  1922.      INDEX { hostTimeIndex, hostTimeCreationOrder }
  1923.      ::= { hostTimeTable 1 }
  1924.  
  1925.  HostTimeEntry ::= SEQUENCE {
  1926.      hostTimeAddress              OCTET STRING,
  1927.      hostTimeCreationOrder        Integer32,
  1928.      hostTimeIndex                Integer32,
  1929.      hostTimeInPkts               Counter32,
  1930.      hostTimeOutPkts              Counter32,
  1931.      hostTimeInOctets             Counter32,
  1932.      hostTimeOutOctets            Counter32,
  1933.      hostTimeOutErrors            Counter32,
  1934.      hostTimeOutBroadcastPkts     Counter32,
  1935.      hostTimeOutMulticastPkts     Counter32
  1936.  }
  1937.  
  1938.  hostTimeAddress OBJECT-TYPE
  1939.      SYNTAX     OCTET STRING
  1940.      MAX-ACCESS read-only
  1941.      STATUS     current
  1942.      DESCRIPTION
  1943.          "The physical address of this host."
  1944.      ::= { hostTimeEntry 1 }
  1945.  
  1946.  hostTimeCreationOrder OBJECT-TYPE
  1947.      SYNTAX     Integer32 (1..65535)
  1948.      MAX-ACCESS read-only
  1949.      STATUS     current
  1950.      DESCRIPTION
  1951.          "An index that uniquely identifies an entry in
  1952.          the hostTime table among those entries associated
  1953.          with the same hostControlEntry.  This index shall
  1954.          be between 1 and N, where N is the value of
  1955.  
  1956.  
  1957.  
  1958.  
  1959.  
  1960.          the associated hostControlTableSize.  The ordering
  1961.          of the indexes is based on the order of each entry's
  1962.          insertion into the table, in which entries added earlier
  1963.          have a lower index value than entries added later.
  1964.          Thus the management station has the ability to
  1965.          learn of new entries added to this table without
  1966.          downloading the entire table.
  1967.  
  1968.          It is important to note that the index for a
  1969.          particular entry may change as an (earlier) entry
  1970.          is deleted from the table.  Because this order may
  1971.          change, management stations should make use of the
  1972.          hostControlLastDeleteTime variable in the
  1973.          hostControlEntry associated with the relevant
  1974.          portion of the hostTimeTable.  By observing
  1975.          this variable, the management station may detect
  1976.          the circumstances where a download of the table
  1977.          may have missed entries, and where a previous
  1978.          association between a value of hostTimeCreationOrder
  1979.          and a hostTimeEntry may no longer hold."
  1980.      ::= { hostTimeEntry 2 }
  1981.  
  1982.  hostTimeIndex OBJECT-TYPE
  1983.      SYNTAX     Integer32 (1..65535)
  1984.      MAX-ACCESS read-only
  1985.      STATUS     current
  1986.      DESCRIPTION
  1987.          "The set of collected host statistics of which
  1988.          this entry is a part.  The set of hosts
  1989.          identified by a particular value of this
  1990.          index is associated with the hostControlEntry
  1991.          as identified by the same value of hostControlIndex."
  1992.      ::= { hostTimeEntry 3 }
  1993.  
  1994.  hostTimeInPkts OBJECT-TYPE
  1995.      SYNTAX     Counter32
  1996.      UNITS      "Packets"
  1997.      MAX-ACCESS read-only
  1998.      STATUS     current
  1999.      DESCRIPTION
  2000.          "The number of good packets transmitted to this
  2001.          address since it was added to the hostTimeTable."
  2002.      ::= { hostTimeEntry 4 }
  2003.  
  2004.  hostTimeOutPkts OBJECT-TYPE
  2005.      SYNTAX     Counter32
  2006.      UNITS      "Packets"
  2007.      MAX-ACCESS read-only
  2008.  
  2009.  
  2010.  
  2011.  
  2012.  
  2013.      STATUS     current
  2014.      DESCRIPTION
  2015.          "The number of packets, including bad packets, transmitted
  2016.          by this address since it was added to the hostTimeTable."
  2017.      ::= { hostTimeEntry 5 }
  2018.  
  2019.  hostTimeInOctets OBJECT-TYPE
  2020.      SYNTAX     Counter32
  2021.      UNITS      "Octets"
  2022.      MAX-ACCESS read-only
  2023.      STATUS     current
  2024.      DESCRIPTION
  2025.          "The number of octets transmitted to this address since
  2026.          it was added to the hostTimeTable (excluding framing
  2027.          bits but including FCS octets), except for those
  2028.          octets in bad packets."
  2029.      ::= { hostTimeEntry 6 }
  2030.  
  2031.  hostTimeOutOctets OBJECT-TYPE
  2032.      SYNTAX     Counter32
  2033.      UNITS      "Octets"
  2034.      MAX-ACCESS read-only
  2035.      STATUS     current
  2036.      DESCRIPTION
  2037.          "The number of octets transmitted by this address since
  2038.          it was added to the hostTimeTable (excluding framing
  2039.          bits but including FCS octets), including those
  2040.          octets in bad packets."
  2041.      ::= { hostTimeEntry 7 }
  2042.  
  2043.  hostTimeOutErrors OBJECT-TYPE
  2044.      SYNTAX     Counter32
  2045.      UNITS      "Packets"
  2046.      MAX-ACCESS read-only
  2047.      STATUS     current
  2048.      DESCRIPTION
  2049.          "The number of bad packets transmitted by this address
  2050.          since this host was added to the hostTimeTable."
  2051.      ::= { hostTimeEntry 8 }
  2052.  
  2053.  hostTimeOutBroadcastPkts OBJECT-TYPE
  2054.      SYNTAX     Counter32
  2055.      UNITS      "Packets"
  2056.      MAX-ACCESS read-only
  2057.      STATUS     current
  2058.      DESCRIPTION
  2059.          "The number of good packets transmitted by this
  2060.          address that were directed to the broadcast address
  2061.  
  2062.  
  2063.  
  2064.  
  2065.  
  2066.          since this host was added to the hostTimeTable."
  2067.      ::= { hostTimeEntry 9 }
  2068.  
  2069.  hostTimeOutMulticastPkts OBJECT-TYPE
  2070.      SYNTAX     Counter32
  2071.      UNITS      "Packets"
  2072.      MAX-ACCESS read-only
  2073.      STATUS     current
  2074.      DESCRIPTION
  2075.          "The number of good packets transmitted by this
  2076.          address that were directed to a multicast address
  2077.          since this host was added to the hostTimeTable.
  2078.          Note that this number does not include packets directed
  2079.          to the broadcast address."
  2080.      ::= { hostTimeEntry 10 }
  2081.  
  2082.  -- The Host Top "N" Group
  2083.  
  2084.  -- Implementation of the Host Top N group is optional. The Host Top N
  2085.  -- group requires the implementation of the host group.
  2086.  -- Consult the MODULE-COMPLIANCE macro for the authoritative
  2087.  -- conformance information for this MIB.
  2088.  --
  2089.  -- The Host Top N group is used to prepare reports that describe
  2090.  -- the hosts that top a list ordered by one of their statistics.
  2091.  -- The available statistics are samples of one of their
  2092.  -- base statistics, over an interval specified by the management
  2093.  -- station.  Thus, these statistics are rate based.  The management
  2094.  -- station also selects how many such hosts are reported.
  2095.  
  2096.  -- The hostTopNControlTable is used to initiate the generation of
  2097.  -- such a report.  The management station may select the parameters
  2098.  -- of such a report, such as which interface, which statistic,
  2099.  -- how many hosts, and the start and stop times of the sampling.
  2100.  -- When the report is prepared, entries are created in the
  2101.  -- hostTopNTable associated with the relevant hostTopNControlEntry.
  2102.  -- These entries are static for each report after it has been
  2103.  -- prepared.
  2104.  
  2105.  hostTopNControlTable OBJECT-TYPE
  2106.      SYNTAX     SEQUENCE OF HostTopNControlEntry
  2107.      MAX-ACCESS not-accessible
  2108.      STATUS     current
  2109.      DESCRIPTION
  2110.          "A list of top N host control entries."
  2111.      ::= { hostTopN 1 }
  2112.  
  2113.  hostTopNControlEntry OBJECT-TYPE
  2114.  
  2115.  
  2116.  
  2117.  
  2118.  
  2119.      SYNTAX     HostTopNControlEntry
  2120.      MAX-ACCESS not-accessible
  2121.      STATUS     current
  2122.      DESCRIPTION
  2123.          "A set of parameters that control the creation of a report
  2124.          of the top N hosts according to several metrics.  For
  2125.          example, an instance of the hostTopNDuration object might
  2126.          be named hostTopNDuration.3"
  2127.      INDEX { hostTopNControlIndex }
  2128.      ::= { hostTopNControlTable 1 }
  2129.  
  2130.  HostTopNControlEntry ::= SEQUENCE {
  2131.      hostTopNControlIndex    Integer32,
  2132.      hostTopNHostIndex       Integer32,
  2133.      hostTopNRateBase        INTEGER,
  2134.      hostTopNTimeRemaining   Integer32,
  2135.      hostTopNDuration        Integer32,
  2136.      hostTopNRequestedSize   Integer32,
  2137.      hostTopNGrantedSize     Integer32,
  2138.      hostTopNStartTime       TimeTicks,
  2139.      hostTopNOwner           OwnerString,
  2140.      hostTopNStatus          EntryStatus
  2141.  }
  2142.  
  2143.  hostTopNControlIndex OBJECT-TYPE
  2144.      SYNTAX     Integer32 (1..65535)
  2145.      MAX-ACCESS read-only
  2146.      STATUS     current
  2147.      DESCRIPTION
  2148.          "An index that uniquely identifies an entry
  2149.          in the hostTopNControl table.  Each such
  2150.          entry defines one top N report prepared for
  2151.          one interface."
  2152.      ::= { hostTopNControlEntry 1 }
  2153.  
  2154.  hostTopNHostIndex OBJECT-TYPE
  2155.      SYNTAX     Integer32 (1..65535)
  2156.      MAX-ACCESS read-create
  2157.      STATUS     current
  2158.      DESCRIPTION
  2159.          "The host table for which a top N report will be prepared
  2160.          on behalf of this entry.  The host table identified by a
  2161.          particular value of this index is associated with the same
  2162.          host table as identified by the same value of
  2163.          hostIndex.
  2164.  
  2165.          This object may not be modified if the associated
  2166.          hostTopNStatus object is equal to valid(1)."
  2167.  
  2168.  
  2169.  
  2170.  
  2171.  
  2172.      ::= { hostTopNControlEntry 2 }
  2173.  
  2174.  hostTopNRateBase OBJECT-TYPE
  2175.      SYNTAX     INTEGER {
  2176.                   hostTopNInPkts(1),
  2177.                   hostTopNOutPkts(2),
  2178.                   hostTopNInOctets(3),
  2179.                   hostTopNOutOctets(4),
  2180.                   hostTopNOutErrors(5),
  2181.                   hostTopNOutBroadcastPkts(6),
  2182.                   hostTopNOutMulticastPkts(7)
  2183.                 }
  2184.      MAX-ACCESS read-create
  2185.      STATUS     current
  2186.      DESCRIPTION
  2187.          "The variable for each host that the hostTopNRate
  2188.          variable is based upon.
  2189.  
  2190.          This object may not be modified if the associated
  2191.          hostTopNStatus object is equal to valid(1)."
  2192.      ::= { hostTopNControlEntry 3 }
  2193.  
  2194.  hostTopNTimeRemaining OBJECT-TYPE
  2195.      SYNTAX     Integer32
  2196.      UNITS      "Seconds"
  2197.      MAX-ACCESS read-create
  2198.      STATUS     current
  2199.      DESCRIPTION
  2200.          "The number of seconds left in the report currently being
  2201.          collected.  When this object is modified by the management
  2202.          station, a new collection is started, possibly aborting
  2203.          a currently running report.  The new value is used
  2204.          as the requested duration of this report, which is
  2205.          loaded into the associated hostTopNDuration object.
  2206.  
  2207.          When this object is set to a non-zero value, any
  2208.          associated hostTopNEntries shall be made
  2209.          inaccessible by the monitor.  While the value of this
  2210.          object is non-zero, it decrements by one per second until
  2211.          it reaches zero.  During this time, all associated
  2212.          hostTopNEntries shall remain inaccessible.  At the time
  2213.          that this object decrements to zero, the report is made
  2214.          accessible in the hostTopNTable.  Thus, the hostTopN
  2215.          table needs to be created only at the end of the collection
  2216.          interval."
  2217.      DEFVAL { 0 }
  2218.      ::= { hostTopNControlEntry 4 }
  2219.  
  2220.  
  2221.  
  2222.  
  2223.  
  2224.  
  2225.  hostTopNDuration OBJECT-TYPE
  2226.      SYNTAX     Integer32
  2227.      UNITS      "Seconds"
  2228.      MAX-ACCESS read-only
  2229.      STATUS     current
  2230.      DESCRIPTION
  2231.          "The number of seconds that this report has collected
  2232.          during the last sampling interval, or if this
  2233.          report is currently being collected, the number
  2234.          of seconds that this report is being collected
  2235.          during this sampling interval.
  2236.  
  2237.          When the associated hostTopNTimeRemaining object is set,
  2238.          this object shall be set by the probe to the same value
  2239.          and shall not be modified until the next time
  2240.          the hostTopNTimeRemaining is set.
  2241.  
  2242.          This value shall be zero if no reports have been
  2243.          requested for this hostTopNControlEntry."
  2244.      DEFVAL { 0 }
  2245.      ::= { hostTopNControlEntry 5 }
  2246.  
  2247.  hostTopNRequestedSize OBJECT-TYPE
  2248.      SYNTAX     Integer32
  2249.      MAX-ACCESS read-create
  2250.      STATUS     current
  2251.      DESCRIPTION
  2252.          "The maximum number of hosts requested for the top N
  2253.          table.
  2254.  
  2255.          When this object is created or modified, the probe
  2256.          should set hostTopNGrantedSize as closely to this
  2257.          object as is possible for the particular probe
  2258.          implementation and available resources."
  2259.      DEFVAL { 10 }
  2260.      ::= { hostTopNControlEntry 6 }
  2261.  
  2262.  hostTopNGrantedSize OBJECT-TYPE
  2263.      SYNTAX     Integer32
  2264.      MAX-ACCESS read-only
  2265.      STATUS     current
  2266.      DESCRIPTION
  2267.          "The maximum number of hosts in the top N table.
  2268.  
  2269.          When the associated hostTopNRequestedSize object is
  2270.          created or modified, the probe should set this
  2271.          object as closely to the requested value as is possible
  2272.          for the particular implementation and available
  2273.  
  2274.  
  2275.  
  2276.  
  2277.  
  2278.          resources. The probe must not lower this value except
  2279.          as a result of a set to the associated
  2280.          hostTopNRequestedSize object.
  2281.  
  2282.          Hosts with the highest value of hostTopNRate shall be
  2283.          placed in this table in decreasing order of this rate
  2284.          until there is no more room or until there are no more
  2285.          hosts."
  2286.      ::= { hostTopNControlEntry 7 }
  2287.  
  2288.  hostTopNStartTime OBJECT-TYPE
  2289.      SYNTAX     TimeTicks
  2290.      MAX-ACCESS read-only
  2291.      STATUS     current
  2292.      DESCRIPTION
  2293.          "The value of sysUpTime when this top N report was
  2294.          last started.  In other words, this is the time that
  2295.          the associated hostTopNTimeRemaining object was
  2296.          modified to start the requested report."
  2297.      ::= { hostTopNControlEntry 8 }
  2298.  
  2299.  hostTopNOwner OBJECT-TYPE
  2300.      SYNTAX     OwnerString
  2301.      MAX-ACCESS read-create
  2302.      STATUS     current
  2303.      DESCRIPTION
  2304.          "The entity that configured this entry and is therefore
  2305.          using the resources assigned to it."
  2306.      ::= { hostTopNControlEntry 9 }
  2307.  
  2308.  hostTopNStatus OBJECT-TYPE
  2309.      SYNTAX     EntryStatus
  2310.      MAX-ACCESS read-create
  2311.      STATUS     current
  2312.      DESCRIPTION
  2313.          "The status of this hostTopNControl entry.
  2314.  
  2315.          If this object is not equal to valid(1), all associated
  2316.          hostTopNEntries shall be deleted by the agent."
  2317.      ::= { hostTopNControlEntry 10 }
  2318.  
  2319.  hostTopNTable OBJECT-TYPE
  2320.      SYNTAX     SEQUENCE OF HostTopNEntry
  2321.      MAX-ACCESS not-accessible
  2322.      STATUS     current
  2323.      DESCRIPTION
  2324.          "A list of top N host entries."
  2325.      ::= { hostTopN 2 }
  2326.  
  2327.  
  2328.  
  2329.  
  2330.  
  2331.  hostTopNEntry OBJECT-TYPE
  2332.      SYNTAX     HostTopNEntry
  2333.      MAX-ACCESS not-accessible
  2334.      STATUS     current
  2335.      DESCRIPTION
  2336.          "A set of statistics for a host that is part of a top N
  2337.          report.  For example, an instance of the hostTopNRate
  2338.          object might be named hostTopNRate.3.10"
  2339.      INDEX { hostTopNReport, hostTopNIndex }
  2340.      ::= { hostTopNTable 1 }
  2341.  
  2342.  HostTopNEntry ::= SEQUENCE {
  2343.      hostTopNReport                Integer32,
  2344.      hostTopNIndex                 Integer32,
  2345.      hostTopNAddress               OCTET STRING,
  2346.      hostTopNRate                  Integer32
  2347.  }
  2348.  
  2349.  hostTopNReport OBJECT-TYPE
  2350.      SYNTAX     Integer32 (1..65535)
  2351.      MAX-ACCESS read-only
  2352.      STATUS     current
  2353.      DESCRIPTION
  2354.          "This object identifies the top N report of which
  2355.          this entry is a part.  The set of hosts
  2356.          identified by a particular value of this
  2357.          object is part of the same report as identified
  2358.          by the same value of the hostTopNControlIndex object."
  2359.      ::= { hostTopNEntry 1 }
  2360.  
  2361.  hostTopNIndex OBJECT-TYPE
  2362.      SYNTAX     Integer32 (1..65535)
  2363.      MAX-ACCESS read-only
  2364.      STATUS     current
  2365.      DESCRIPTION
  2366.          "An index that uniquely identifies an entry in
  2367.          the hostTopN table among those in the same report.
  2368.          This index is between 1 and N, where N is the
  2369.          number of entries in this table.  Increasing values
  2370.          of hostTopNIndex shall be assigned to entries with
  2371.          decreasing values of hostTopNRate until index N
  2372.          is assigned to the entry with the lowest value of
  2373.          hostTopNRate or there are no more hostTopNEntries."
  2374.      ::= { hostTopNEntry 2 }
  2375.  
  2376.  hostTopNAddress OBJECT-TYPE
  2377.      SYNTAX     OCTET STRING
  2378.      MAX-ACCESS read-only
  2379.  
  2380.  
  2381.  
  2382.  
  2383.  
  2384.      STATUS     current
  2385.      DESCRIPTION
  2386.          "The physical address of this host."
  2387.      ::= { hostTopNEntry 3 }
  2388.  
  2389.  hostTopNRate OBJECT-TYPE
  2390.      SYNTAX     Integer32
  2391.      MAX-ACCESS read-only
  2392.      STATUS     current
  2393.      DESCRIPTION
  2394.          "The amount of change in the selected variable
  2395.          during this sampling interval.  The selected
  2396.          variable is this host's instance of the object
  2397.          selected by hostTopNRateBase."
  2398.      ::= { hostTopNEntry 4 }
  2399.  
  2400.  -- The Matrix Group
  2401.  
  2402.  -- Implementation of the Matrix group is optional.
  2403.  -- Consult the MODULE-COMPLIANCE macro for the authoritative
  2404.  -- conformance information for this MIB.
  2405.  --
  2406.  -- The Matrix group consists of the matrixControlTable, matrixSDTable
  2407.  -- and the matrixDSTable.  These tables store statistics for a
  2408.  -- particular conversation between two addresses.  As the device
  2409.  -- detects a new conversation, including those to a non-unicast
  2410.  -- address, it creates a new entry in both of the matrix tables.
  2411.  -- It must only create new entries based on information
  2412.  -- received in good packets.  If the monitoring device finds
  2413.  -- itself short of resources, it may delete entries as needed.
  2414.  -- It is suggested that the device delete the least recently used
  2415.  -- entries first.
  2416.  
  2417.  matrixControlTable OBJECT-TYPE
  2418.      SYNTAX     SEQUENCE OF MatrixControlEntry
  2419.      MAX-ACCESS not-accessible
  2420.      STATUS     current
  2421.      DESCRIPTION
  2422.          "A list of information entries for the
  2423.          traffic matrix on each interface."
  2424.      ::= { matrix 1 }
  2425.  
  2426.  matrixControlEntry OBJECT-TYPE
  2427.      SYNTAX     MatrixControlEntry
  2428.      MAX-ACCESS not-accessible
  2429.      STATUS     current
  2430.      DESCRIPTION
  2431.          "Information about a traffic matrix on a particular
  2432.  
  2433.  
  2434.  
  2435.  
  2436.  
  2437.          interface.  For example, an instance of the
  2438.          matrixControlLastDeleteTime object might be named
  2439.          matrixControlLastDeleteTime.1"
  2440.      INDEX { matrixControlIndex }
  2441.      ::= { matrixControlTable 1 }
  2442.  
  2443.  MatrixControlEntry ::= SEQUENCE {
  2444.      matrixControlIndex           Integer32,
  2445.      matrixControlDataSource      OBJECT IDENTIFIER,
  2446.      matrixControlTableSize       Integer32,
  2447.      matrixControlLastDeleteTime  TimeTicks,
  2448.      matrixControlOwner           OwnerString,
  2449.      matrixControlStatus          EntryStatus
  2450.  }
  2451.  
  2452.  matrixControlIndex OBJECT-TYPE
  2453.      SYNTAX     Integer32 (1..65535)
  2454.      MAX-ACCESS read-only
  2455.      STATUS     current
  2456.      DESCRIPTION
  2457.          "An index that uniquely identifies an entry in the
  2458.          matrixControl table.  Each such entry defines
  2459.          a function that discovers conversations on a particular
  2460.          interface and places statistics about them in the
  2461.          matrixSDTable and the matrixDSTable on behalf of this
  2462.          matrixControlEntry."
  2463.      ::= { matrixControlEntry 1 }
  2464.  
  2465.  matrixControlDataSource OBJECT-TYPE
  2466.      SYNTAX     OBJECT IDENTIFIER
  2467.      MAX-ACCESS read-create
  2468.      STATUS     current
  2469.      DESCRIPTION
  2470.          "This object identifies the source of
  2471.          the data from which this entry creates a traffic matrix.
  2472.          This source can be any interface on this device.  In
  2473.          order to identify a particular interface, this object
  2474.          shall identify the instance of the ifIndex object,
  2475.          defined in RFC 2233 [17], for the desired
  2476.          interface.  For example, if an entry were to receive data
  2477.          from interface #1, this object would be set to ifIndex.1.
  2478.  
  2479.          The statistics in this group reflect all packets
  2480.          on the local network segment attached to the identified
  2481.          interface.
  2482.  
  2483.          An agent may or may not be able to tell if fundamental
  2484.          changes to the media of the interface have occurred and
  2485.  
  2486.  
  2487.  
  2488.  
  2489.  
  2490.          necessitate an invalidation of this entry.  For example, a
  2491.          hot-pluggable ethernet card could be pulled out and replaced
  2492.          by a token-ring card.  In such a case, if the agent has such
  2493.          knowledge of the change, it is recommended that it
  2494.          invalidate this entry.
  2495.  
  2496.          This object may not be modified if the associated
  2497.          matrixControlStatus object is equal to valid(1)."
  2498.      ::= { matrixControlEntry 2 }
  2499.  
  2500.  matrixControlTableSize OBJECT-TYPE
  2501.      SYNTAX     Integer32
  2502.      MAX-ACCESS read-only
  2503.      STATUS     current
  2504.      DESCRIPTION
  2505.          "The number of matrixSDEntries in the matrixSDTable
  2506.          for this interface.  This must also be the value of
  2507.          the number of entries in the matrixDSTable for this
  2508.          interface."
  2509.      ::= { matrixControlEntry 3 }
  2510.  
  2511.  matrixControlLastDeleteTime OBJECT-TYPE
  2512.      SYNTAX     TimeTicks
  2513.      MAX-ACCESS read-only
  2514.      STATUS     current
  2515.      DESCRIPTION
  2516.          "The value of sysUpTime when the last entry
  2517.          was deleted from the portion of the matrixSDTable
  2518.          or matrixDSTable associated with this matrixControlEntry.
  2519.          If no deletions have occurred, this value shall be
  2520.          zero."
  2521.      ::= { matrixControlEntry 4 }
  2522.  
  2523.  matrixControlOwner OBJECT-TYPE
  2524.      SYNTAX     OwnerString
  2525.      MAX-ACCESS read-create
  2526.      STATUS     current
  2527.      DESCRIPTION
  2528.          "The entity that configured this entry and is therefore
  2529.          using the resources assigned to it."
  2530.      ::= { matrixControlEntry 5 }
  2531.  
  2532.  matrixControlStatus OBJECT-TYPE
  2533.      SYNTAX     EntryStatus
  2534.      MAX-ACCESS read-create
  2535.      STATUS     current
  2536.      DESCRIPTION
  2537.          "The status of this matrixControl entry.
  2538.  
  2539.  
  2540.  
  2541.  
  2542.  
  2543.          If this object is not equal to valid(1), all associated
  2544.          entries in the matrixSDTable and the matrixDSTable
  2545.          shall be deleted by the agent."
  2546.      ::= { matrixControlEntry 6 }
  2547.  
  2548.  matrixSDTable OBJECT-TYPE
  2549.      SYNTAX     SEQUENCE OF MatrixSDEntry
  2550.      MAX-ACCESS not-accessible
  2551.      STATUS     current
  2552.      DESCRIPTION
  2553.          "A list of traffic matrix entries indexed by
  2554.          source and destination MAC address."
  2555.      ::= { matrix 2 }
  2556.  
  2557.  matrixSDEntry OBJECT-TYPE
  2558.      SYNTAX     MatrixSDEntry
  2559.      MAX-ACCESS not-accessible
  2560.      STATUS     current
  2561.      DESCRIPTION
  2562.          "A collection of statistics for communications between
  2563.          two addresses on a particular interface.  For example,
  2564.          an instance of the matrixSDPkts object might be named
  2565.          matrixSDPkts.1.6.8.0.32.27.3.176.6.8.0.32.10.8.113"
  2566.      INDEX { matrixSDIndex,
  2567.              matrixSDSourceAddress, matrixSDDestAddress }
  2568.      ::= { matrixSDTable 1 }
  2569.  
  2570.  MatrixSDEntry ::= SEQUENCE {
  2571.      matrixSDSourceAddress       OCTET STRING,
  2572.      matrixSDDestAddress         OCTET STRING,
  2573.      matrixSDIndex               Integer32,
  2574.      matrixSDPkts                Counter32,
  2575.      matrixSDOctets              Counter32,
  2576.      matrixSDErrors              Counter32
  2577.  }
  2578.  
  2579.  matrixSDSourceAddress OBJECT-TYPE
  2580.      SYNTAX     OCTET STRING
  2581.      MAX-ACCESS read-only
  2582.      STATUS     current
  2583.      DESCRIPTION
  2584.          "The source physical address."
  2585.      ::= { matrixSDEntry 1 }
  2586.  
  2587.  matrixSDDestAddress OBJECT-TYPE
  2588.      SYNTAX     OCTET STRING
  2589.      MAX-ACCESS read-only
  2590.      STATUS     current
  2591.  
  2592.  
  2593.  
  2594.  
  2595.  
  2596.      DESCRIPTION
  2597.          "The destination physical address."
  2598.      ::= { matrixSDEntry 2 }
  2599.  
  2600.  matrixSDIndex OBJECT-TYPE
  2601.      SYNTAX     Integer32 (1..65535)
  2602.      MAX-ACCESS read-only
  2603.      STATUS     current
  2604.      DESCRIPTION
  2605.          "The set of collected matrix statistics of which
  2606.          this entry is a part.  The set of matrix statistics
  2607.          identified by a particular value of this index
  2608.          is associated with the same matrixControlEntry
  2609.          as identified by the same value of matrixControlIndex."
  2610.      ::= { matrixSDEntry 3 }
  2611.  
  2612.  matrixSDPkts OBJECT-TYPE
  2613.      SYNTAX     Counter32
  2614.      UNITS      "Packets"
  2615.      MAX-ACCESS read-only
  2616.      STATUS     current
  2617.      DESCRIPTION
  2618.          "The number of packets transmitted from the source
  2619.          address to the destination address (this number includes
  2620.          bad packets)."
  2621.      ::= { matrixSDEntry 4 }
  2622.  
  2623.  matrixSDOctets OBJECT-TYPE
  2624.      SYNTAX     Counter32
  2625.      UNITS      "Octets"
  2626.      MAX-ACCESS read-only
  2627.      STATUS     current
  2628.      DESCRIPTION
  2629.          "The number of octets (excluding framing bits but
  2630.          including FCS octets) contained in all packets
  2631.          transmitted from the source address to the
  2632.          destination address."
  2633.      ::= { matrixSDEntry 5 }
  2634.  
  2635.  matrixSDErrors OBJECT-TYPE
  2636.      SYNTAX     Counter32
  2637.      UNITS      "Packets"
  2638.      MAX-ACCESS read-only
  2639.      STATUS     current
  2640.      DESCRIPTION
  2641.          "The number of bad packets transmitted from
  2642.          the source address to the destination address."
  2643.      ::= { matrixSDEntry 6 }
  2644.  
  2645.  
  2646.  
  2647.  
  2648.  
  2649.  -- Traffic matrix tables from destination to source
  2650.  
  2651.  matrixDSTable OBJECT-TYPE
  2652.      SYNTAX     SEQUENCE OF MatrixDSEntry
  2653.      MAX-ACCESS not-accessible
  2654.      STATUS     current
  2655.      DESCRIPTION
  2656.          "A list of traffic matrix entries indexed by
  2657.          destination and source MAC address."
  2658.      ::= { matrix 3 }
  2659.  
  2660.  matrixDSEntry OBJECT-TYPE
  2661.      SYNTAX     MatrixDSEntry
  2662.      MAX-ACCESS not-accessible
  2663.      STATUS     current
  2664.      DESCRIPTION
  2665.          "A collection of statistics for communications between
  2666.          two addresses on a particular interface.  For example,
  2667.          an instance of the matrixSDPkts object might be named
  2668.          matrixSDPkts.1.6.8.0.32.10.8.113.6.8.0.32.27.3.176"
  2669.      INDEX { matrixDSIndex,
  2670.              matrixDSDestAddress, matrixDSSourceAddress }
  2671.      ::= { matrixDSTable 1 }
  2672.  
  2673.  MatrixDSEntry ::= SEQUENCE {
  2674.      matrixDSSourceAddress       OCTET STRING,
  2675.      matrixDSDestAddress         OCTET STRING,
  2676.      matrixDSIndex               Integer32,
  2677.      matrixDSPkts                Counter32,
  2678.      matrixDSOctets              Counter32,
  2679.      matrixDSErrors              Counter32
  2680.  }
  2681.  
  2682.  matrixDSSourceAddress OBJECT-TYPE
  2683.      SYNTAX     OCTET STRING
  2684.      MAX-ACCESS read-only
  2685.      STATUS     current
  2686.      DESCRIPTION
  2687.          "The source physical address."
  2688.      ::= { matrixDSEntry 1 }
  2689.  
  2690.  matrixDSDestAddress OBJECT-TYPE
  2691.      SYNTAX     OCTET STRING
  2692.      MAX-ACCESS read-only
  2693.      STATUS     current
  2694.      DESCRIPTION
  2695.          "The destination physical address."
  2696.      ::= { matrixDSEntry 2 }
  2697.  
  2698.  
  2699.  
  2700.  
  2701.  
  2702.  matrixDSIndex OBJECT-TYPE
  2703.      SYNTAX     Integer32 (1..65535)
  2704.      MAX-ACCESS read-only
  2705.      STATUS     current
  2706.      DESCRIPTION
  2707.          "The set of collected matrix statistics of which
  2708.          this entry is a part.  The set of matrix statistics
  2709.          identified by a particular value of this index
  2710.          is associated with the same matrixControlEntry
  2711.          as identified by the same value of matrixControlIndex."
  2712.      ::= { matrixDSEntry 3 }
  2713.  
  2714.  matrixDSPkts OBJECT-TYPE
  2715.      SYNTAX     Counter32
  2716.      UNITS      "Packets"
  2717.      MAX-ACCESS read-only
  2718.      STATUS     current
  2719.      DESCRIPTION
  2720.          "The number of packets transmitted from the source
  2721.          address to the destination address (this number includes
  2722.          bad packets)."
  2723.      ::= { matrixDSEntry 4 }
  2724.  
  2725.  matrixDSOctets OBJECT-TYPE
  2726.      SYNTAX     Counter32
  2727.      UNITS      "Octets"
  2728.      MAX-ACCESS read-only
  2729.      STATUS     current
  2730.      DESCRIPTION
  2731.          "The number of octets (excluding framing bits
  2732.          but including FCS octets) contained in all packets
  2733.          transmitted from the source address to the
  2734.          destination address."
  2735.      ::= { matrixDSEntry 5 }
  2736.  
  2737.  matrixDSErrors OBJECT-TYPE
  2738.      SYNTAX     Counter32
  2739.      UNITS      "Packets"
  2740.      MAX-ACCESS read-only
  2741.      STATUS     current
  2742.      DESCRIPTION
  2743.          "The number of bad packets transmitted from
  2744.          the source address to the destination address."
  2745.      ::= { matrixDSEntry 6 }
  2746.  
  2747.  -- The Filter Group
  2748.  
  2749.  -- Implementation of the Filter group is optional.
  2750.  
  2751.  
  2752.  
  2753.  
  2754.  
  2755.  -- Consult the MODULE-COMPLIANCE macro for the authoritative
  2756.  -- conformance information for this MIB.
  2757.  --
  2758.  -- The Filter group allows packets to be captured with an
  2759.  -- arbitrary filter expression.  A logical data and
  2760.  -- event stream or "channel" is formed by the packets
  2761.  -- that match the filter expression.
  2762.  --
  2763.  -- This filter mechanism allows the creation of an arbitrary
  2764.  -- logical expression with which to filter packets.  Each
  2765.  -- filter associated with a channel is OR'ed with the others.
  2766.  -- Within a filter, any bits checked in the data and status are
  2767.  -- AND'ed with respect to other bits in the same filter.  The
  2768.  -- NotMask also allows for checking for inequality.  Finally,
  2769.  -- the channelAcceptType object allows for inversion of the
  2770.  -- whole equation.
  2771.  --
  2772.  -- If a management station wishes to receive a trap to alert it
  2773.  -- that new packets have been captured and are available for
  2774.  -- download, it is recommended that it set up an alarm entry that
  2775.  -- monitors the value of the relevant channelMatches instance.
  2776.  --
  2777.  -- The channel can be turned on or off, and can also
  2778.  -- generate events when packets pass through it.
  2779.  
  2780.  filterTable OBJECT-TYPE
  2781.      SYNTAX     SEQUENCE OF FilterEntry
  2782.      MAX-ACCESS not-accessible
  2783.      STATUS     current
  2784.      DESCRIPTION
  2785.          "A list of packet filter entries."
  2786.      ::= { filter 1 }
  2787.  
  2788.  filterEntry OBJECT-TYPE
  2789.      SYNTAX     FilterEntry
  2790.      MAX-ACCESS not-accessible
  2791.      STATUS     current
  2792.      DESCRIPTION
  2793.          "A set of parameters for a packet filter applied on a
  2794.          particular interface.  As an example, an instance of the
  2795.          filterPktData object might be named filterPktData.12"
  2796.      INDEX { filterIndex }
  2797.      ::= { filterTable 1 }
  2798.  
  2799.  FilterEntry ::= SEQUENCE {
  2800.      filterIndex                 Integer32,
  2801.      filterChannelIndex          Integer32,
  2802.      filterPktDataOffset         Integer32,
  2803.  
  2804.  
  2805.  
  2806.  
  2807.  
  2808.      filterPktData               OCTET STRING,
  2809.      filterPktDataMask           OCTET STRING,
  2810.      filterPktDataNotMask        OCTET STRING,
  2811.      filterPktStatus             Integer32,
  2812.      filterPktStatusMask         Integer32,
  2813.      filterPktStatusNotMask      Integer32,
  2814.      filterOwner                 OwnerString,
  2815.      filterStatus                EntryStatus
  2816.  }
  2817.  
  2818.  filterIndex OBJECT-TYPE
  2819.      SYNTAX     Integer32 (1..65535)
  2820.      MAX-ACCESS read-only
  2821.      STATUS     current
  2822.      DESCRIPTION
  2823.          "An index that uniquely identifies an entry
  2824.          in the filter table.  Each such entry defines
  2825.          one filter that is to be applied to every packet
  2826.          received on an interface."
  2827.      ::= { filterEntry 1 }
  2828.  
  2829.  filterChannelIndex OBJECT-TYPE
  2830.      SYNTAX     Integer32 (1..65535)
  2831.      MAX-ACCESS read-create
  2832.      STATUS     current
  2833.      DESCRIPTION
  2834.          "This object identifies the channel of which this filter
  2835.          is a part.  The filters identified by a particular value
  2836.          of this object are associated with the same channel as
  2837.          identified by the same value of the channelIndex object."
  2838.      ::= { filterEntry 2 }
  2839.  
  2840.  filterPktDataOffset OBJECT-TYPE
  2841.      SYNTAX     Integer32
  2842.      UNITS      "Octets"
  2843.      MAX-ACCESS read-create
  2844.      STATUS     current
  2845.      DESCRIPTION
  2846.          "The offset from the beginning of each packet where
  2847.          a match of packet data will be attempted.  This offset
  2848.          is measured from the point in the physical layer
  2849.          packet after the framing bits, if any.  For example,
  2850.          in an Ethernet frame, this point is at the beginning of
  2851.          the destination MAC address.
  2852.  
  2853.          This object may not be modified if the associated
  2854.          filterStatus object is equal to valid(1)."
  2855.      DEFVAL { 0 }
  2856.  
  2857.  
  2858.  
  2859.  
  2860.  
  2861.      ::= { filterEntry 3 }
  2862.  
  2863.  filterPktData OBJECT-TYPE
  2864.      SYNTAX     OCTET STRING
  2865.      MAX-ACCESS read-create
  2866.      STATUS     current
  2867.      DESCRIPTION
  2868.          "The data that is to be matched with the input packet.
  2869.          For each packet received, this filter and the accompanying
  2870.          filterPktDataMask and filterPktDataNotMask will be
  2871.          adjusted for the offset.  The only bits relevant to this
  2872.          match algorithm are those that have the corresponding
  2873.          filterPktDataMask bit equal to one.  The following three
  2874.          rules are then applied to every packet:
  2875.  
  2876.          (1) If the packet is too short and does not have data
  2877.              corresponding to part of the filterPktData, the packet
  2878.              will fail this data match.
  2879.  
  2880.          (2) For each relevant bit from the packet with the
  2881.              corresponding filterPktDataNotMask bit set to zero, if
  2882.              the bit from the packet is not equal to the corresponding
  2883.              bit from the filterPktData, then the packet will fail
  2884.              this data match.
  2885.  
  2886.          (3) If for every relevant bit from the packet with the
  2887.              corresponding filterPktDataNotMask bit set to one, the
  2888.              bit from the packet is equal to the corresponding bit
  2889.              from the filterPktData, then the packet will fail this
  2890.              data match.
  2891.  
  2892.          Any packets that have not failed any of the three matches
  2893.          above have passed this data match.  In particular, a zero
  2894.          length filter will match any packet.
  2895.  
  2896.          This object may not be modified if the associated
  2897.          filterStatus object is equal to valid(1)."
  2898.      ::= { filterEntry 4 }
  2899.  
  2900.  filterPktDataMask OBJECT-TYPE
  2901.      SYNTAX     OCTET STRING
  2902.      MAX-ACCESS read-create
  2903.      STATUS     current
  2904.      DESCRIPTION
  2905.          "The mask that is applied to the match process.
  2906.          After adjusting this mask for the offset, only those
  2907.          bits in the received packet that correspond to bits set
  2908.          in this mask are relevant for further processing by the
  2909.  
  2910.  
  2911.  
  2912.  
  2913.  
  2914.          match algorithm.  The offset is applied to filterPktDataMask
  2915.          in the same way it is applied to the filter.  For the
  2916.          purposes of the matching algorithm, if the associated
  2917.          filterPktData object is longer than this mask, this mask is
  2918.          conceptually extended with '1' bits until it reaches the
  2919.          length of the filterPktData object.
  2920.  
  2921.          This object may not be modified if the associated
  2922.          filterStatus object is equal to valid(1)."
  2923.      ::= { filterEntry 5 }
  2924.  
  2925.  filterPktDataNotMask OBJECT-TYPE
  2926.      SYNTAX     OCTET STRING
  2927.      MAX-ACCESS read-create
  2928.      STATUS     current
  2929.      DESCRIPTION
  2930.          "The inversion mask that is applied to the match
  2931.          process.  After adjusting this mask for the offset,
  2932.          those relevant bits in the received packet that correspond
  2933.          to bits cleared in this mask must all be equal to their
  2934.          corresponding bits in the filterPktData object for the packet
  2935.          to be accepted.  In addition, at least one of those relevant
  2936.          bits in the received packet that correspond to bits set in
  2937.          this mask must be different to its corresponding bit in the
  2938.          filterPktData object.
  2939.  
  2940.          For the purposes of the matching algorithm, if the associated
  2941.          filterPktData object is longer than this mask, this mask is
  2942.          conceptually extended with '0' bits until it reaches the
  2943.          length of the filterPktData object.
  2944.  
  2945.          This object may not be modified if the associated
  2946.          filterStatus object is equal to valid(1)."
  2947.      ::= { filterEntry 6 }
  2948.  
  2949.  filterPktStatus OBJECT-TYPE
  2950.      SYNTAX     Integer32
  2951.      MAX-ACCESS read-create
  2952.      STATUS     current
  2953.      DESCRIPTION
  2954.          "The status that is to be matched with the input packet.
  2955.          The only bits relevant to this match algorithm are those that
  2956.          have the corresponding filterPktStatusMask bit equal to one.
  2957.          The following two rules are then applied to every packet:
  2958.  
  2959.          (1) For each relevant bit from the packet status with the
  2960.              corresponding filterPktStatusNotMask bit set to zero, if
  2961.              the bit from the packet status is not equal to the
  2962.  
  2963.  
  2964.  
  2965.  
  2966.  
  2967.              corresponding bit from the filterPktStatus, then the
  2968.              packet will fail this status match.
  2969.  
  2970.          (2) If for every relevant bit from the packet status with the
  2971.              corresponding filterPktStatusNotMask bit set to one, the
  2972.              bit from the packet status is equal to the corresponding
  2973.              bit from the filterPktStatus, then the packet will fail
  2974.              this status match.
  2975.  
  2976.          Any packets that have not failed either of the two matches
  2977.          above have passed this status match.  In particular, a zero
  2978.          length status filter will match any packet's status.
  2979.  
  2980.          The value of the packet status is a sum.  This sum
  2981.          initially takes the value zero.  Then, for each
  2982.          error, E, that has been discovered in this packet,
  2983.          2 raised to a value representing E is added to the sum.
  2984.          The errors and the bits that represent them are dependent
  2985.          on the media type of the interface that this channel
  2986.          is receiving packets from.
  2987.  
  2988.          The errors defined for a packet captured off of an
  2989.          Ethernet interface are as follows:
  2990.  
  2991.              bit #    Error
  2992.                  0    Packet is longer than 1518 octets
  2993.                  1    Packet is shorter than 64 octets
  2994.                  2    Packet experienced a CRC or Alignment error
  2995.  
  2996.          For example, an Ethernet fragment would have a
  2997.          value of 6 (2^1 + 2^2).
  2998.  
  2999.          As this MIB is expanded to new media types, this object
  3000.          will have other media-specific errors defined.
  3001.  
  3002.          For the purposes of this status matching algorithm, if the
  3003.          packet status is longer than this filterPktStatus object,
  3004.          this object is conceptually extended with '0' bits until it
  3005.          reaches the size of the packet status.
  3006.  
  3007.          This object may not be modified if the associated
  3008.          filterStatus object is equal to valid(1)."
  3009.      ::= { filterEntry 7 }
  3010.  
  3011.  filterPktStatusMask OBJECT-TYPE
  3012.      SYNTAX     Integer32
  3013.      MAX-ACCESS read-create
  3014.      STATUS     current
  3015.  
  3016.  
  3017.  
  3018.  
  3019.  
  3020.      DESCRIPTION
  3021.          "The mask that is applied to the status match process.
  3022.          Only those bits in the received packet that correspond to
  3023.          bits set in this mask are relevant for further processing
  3024.          by the status match algorithm.  For the purposes
  3025.          of the matching algorithm, if the associated filterPktStatus
  3026.          object is longer than this mask, this mask is conceptually
  3027.          extended with '1' bits until it reaches the size of the
  3028.          filterPktStatus.  In addition, if a packet status is longer
  3029.          than this mask, this mask is conceptually extended with '0'
  3030.          bits until it reaches the size of the packet status.
  3031.  
  3032.          This object may not be modified if the associated
  3033.          filterStatus object is equal to valid(1)."
  3034.      ::= { filterEntry 8 }
  3035.  
  3036.  filterPktStatusNotMask OBJECT-TYPE
  3037.      SYNTAX     Integer32
  3038.      MAX-ACCESS read-create
  3039.      STATUS     current
  3040.      DESCRIPTION
  3041.          "The inversion mask that is applied to the status match
  3042.          process.  Those relevant bits in the received packet status
  3043.          that correspond to bits cleared in this mask must all be
  3044.          equal to their corresponding bits in the filterPktStatus
  3045.          object for the packet to be accepted.  In addition, at least
  3046.          one of those relevant bits in the received packet status
  3047.          that correspond to bits set in this mask must be different
  3048.          to its corresponding bit in the filterPktStatus object for
  3049.          the packet to be accepted.
  3050.  
  3051.          For the purposes of the matching algorithm, if the associated
  3052.          filterPktStatus object or a packet status is longer than this
  3053.          mask, this mask is conceptually extended with '0' bits until
  3054.          it reaches the longer of the lengths of the filterPktStatus
  3055.          object and the packet status.
  3056.  
  3057.          This object may not be modified if the associated
  3058.          filterStatus object is equal to valid(1)."
  3059.      ::= { filterEntry 9 }
  3060.  
  3061.  filterOwner OBJECT-TYPE
  3062.      SYNTAX     OwnerString
  3063.      MAX-ACCESS read-create
  3064.      STATUS     current
  3065.      DESCRIPTION
  3066.          "The entity that configured this entry and is therefore
  3067.          using the resources assigned to it."
  3068.  
  3069.  
  3070.  
  3071.  
  3072.  
  3073.      ::= { filterEntry 10 }
  3074.  
  3075.  filterStatus OBJECT-TYPE
  3076.      SYNTAX     EntryStatus
  3077.      MAX-ACCESS read-create
  3078.      STATUS     current
  3079.      DESCRIPTION
  3080.          "The status of this filter entry."
  3081.      ::= { filterEntry 11 }
  3082.  
  3083.  channelTable OBJECT-TYPE
  3084.      SYNTAX     SEQUENCE OF ChannelEntry
  3085.      MAX-ACCESS not-accessible
  3086.      STATUS     current
  3087.      DESCRIPTION
  3088.          "A list of packet channel entries."
  3089.      ::= { filter 2 }
  3090.  
  3091.  channelEntry OBJECT-TYPE
  3092.      SYNTAX     ChannelEntry
  3093.      MAX-ACCESS not-accessible
  3094.      STATUS     current
  3095.      DESCRIPTION
  3096.          "A set of parameters for a packet channel applied on a
  3097.          particular interface.  As an example, an instance of the
  3098.          channelMatches object might be named channelMatches.3"
  3099.      INDEX { channelIndex }
  3100.      ::= { channelTable 1 }
  3101.  
  3102.  ChannelEntry ::= SEQUENCE {
  3103.      channelIndex                 Integer32,
  3104.      channelIfIndex               Integer32,
  3105.      channelAcceptType            INTEGER,
  3106.      channelDataControl           INTEGER,
  3107.      channelTurnOnEventIndex      Integer32,
  3108.      channelTurnOffEventIndex     Integer32,
  3109.      channelEventIndex            Integer32,
  3110.      channelEventStatus           INTEGER,
  3111.      channelMatches               Counter32,
  3112.      channelDescription           DisplayString,
  3113.      channelOwner                 OwnerString,
  3114.      channelStatus                EntryStatus
  3115.  }
  3116.  
  3117.  channelIndex OBJECT-TYPE
  3118.      SYNTAX     Integer32 (1..65535)
  3119.      MAX-ACCESS read-only
  3120.      STATUS     current
  3121.  
  3122.  
  3123.  
  3124.  
  3125.  
  3126.      DESCRIPTION
  3127.          "An index that uniquely identifies an entry in the channel
  3128.          table.  Each such entry defines one channel, a logical
  3129.          data and event stream.
  3130.  
  3131.          It is suggested that before creating a channel, an
  3132.          application should scan all instances of the
  3133.          filterChannelIndex object to make sure that there are no
  3134.          pre-existing filters that would be inadvertently be linked
  3135.          to the channel."
  3136.      ::= { channelEntry 1 }
  3137.  
  3138.  channelIfIndex OBJECT-TYPE
  3139.      SYNTAX     Integer32 (1..65535)
  3140.      MAX-ACCESS read-create
  3141.      STATUS     current
  3142.      DESCRIPTION
  3143.          "The value of this object uniquely identifies the
  3144.          interface on this remote network monitoring device to which
  3145.          the associated filters are applied to allow data into this
  3146.          channel.  The interface identified by a particular value
  3147.          of this object is the same interface as identified by the
  3148.          same value of the ifIndex object, defined in RFC 2233 [17].
  3149.  
  3150.          The filters in this group are applied to all packets on
  3151.          the local network segment attached to the identified
  3152.          interface.
  3153.  
  3154.          An agent may or may not be able to tell if fundamental
  3155.          changes to the media of the interface have occurred and
  3156.          necessitate an invalidation of this entry.  For example, a
  3157.          hot-pluggable ethernet card could be pulled out and replaced
  3158.          by a token-ring card.  In such a case, if the agent has such
  3159.          knowledge of the change, it is recommended that it
  3160.          invalidate this entry.
  3161.  
  3162.          This object may not be modified if the associated
  3163.          channelStatus object is equal to valid(1)."
  3164.      ::= { channelEntry 2 }
  3165.  
  3166.  channelAcceptType OBJECT-TYPE
  3167.      SYNTAX     INTEGER {
  3168.                   acceptMatched(1),
  3169.                   acceptFailed(2)
  3170.                 }
  3171.      MAX-ACCESS read-create
  3172.      STATUS     current
  3173.      DESCRIPTION
  3174.  
  3175.  
  3176.  
  3177.  
  3178.  
  3179.          "This object controls the action of the filters
  3180.          associated with this channel.  If this object is equal
  3181.          to acceptMatched(1), packets will be accepted to this
  3182.          channel if they are accepted by both the packet data and
  3183.          packet status matches of an associated filter.  If
  3184.          this object is equal to acceptFailed(2), packets will
  3185.          be accepted to this channel only if they fail either
  3186.          the packet data match or the packet status match of
  3187.          each of the associated filters.
  3188.  
  3189.          In particular, a channel with no associated filters will
  3190.          match no packets if set to acceptMatched(1) case and will
  3191.          match all packets in the acceptFailed(2) case.
  3192.  
  3193.          This object may not be modified if the associated
  3194.          channelStatus object is equal to valid(1)."
  3195.      ::= { channelEntry 3 }
  3196.  
  3197.  channelDataControl OBJECT-TYPE
  3198.      SYNTAX     INTEGER {
  3199.                   on(1),
  3200.                   off(2)
  3201.                 }
  3202.      MAX-ACCESS read-create
  3203.      STATUS     current
  3204.      DESCRIPTION
  3205.          "This object controls the flow of data through this channel.
  3206.          If this object is on(1), data, status and events flow
  3207.          through this channel.  If this object is off(2), data,
  3208.          status and events will not flow through this channel."
  3209.      DEFVAL { off }
  3210.      ::= { channelEntry 4 }
  3211.  
  3212.  channelTurnOnEventIndex OBJECT-TYPE
  3213.      SYNTAX     Integer32 (0..65535)
  3214.      MAX-ACCESS read-create
  3215.      STATUS     current
  3216.      DESCRIPTION
  3217.          "The value of this object identifies the event
  3218.          that is configured to turn the associated
  3219.          channelDataControl from off to on when the event is
  3220.          generated.  The event identified by a particular value
  3221.          of this object is the same event as identified by the
  3222.          same value of the eventIndex object.  If there is no
  3223.          corresponding entry in the eventTable, then no
  3224.          association exists.  In fact, if no event is intended
  3225.          for this channel, channelTurnOnEventIndex must be
  3226.          set to zero, a non-existent event index.
  3227.  
  3228.  
  3229.  
  3230.  
  3231.  
  3232.          This object may not be modified if the associated
  3233.          channelStatus object is equal to valid(1)."
  3234.      ::= { channelEntry 5 }
  3235.  
  3236.  channelTurnOffEventIndex OBJECT-TYPE
  3237.      SYNTAX     Integer32 (0..65535)
  3238.      MAX-ACCESS read-create
  3239.      STATUS     current
  3240.      DESCRIPTION
  3241.          "The value of this object identifies the event
  3242.          that is configured to turn the associated
  3243.          channelDataControl from on to off when the event is
  3244.          generated.  The event identified by a particular value
  3245.          of this object is the same event as identified by the
  3246.          same value of the eventIndex object.  If there is no
  3247.          corresponding entry in the eventTable, then no
  3248.          association exists.  In fact, if no event is intended
  3249.          for this channel, channelTurnOffEventIndex must be
  3250.          set to zero, a non-existent event index.
  3251.  
  3252.          This object may not be modified if the associated
  3253.          channelStatus object is equal to valid(1)."
  3254.      ::= { channelEntry 6 }
  3255.  
  3256.  channelEventIndex OBJECT-TYPE
  3257.      SYNTAX     Integer32 (0..65535)
  3258.      MAX-ACCESS read-create
  3259.      STATUS     current
  3260.      DESCRIPTION
  3261.          "The value of this object identifies the event
  3262.          that is configured to be generated when the
  3263.          associated channelDataControl is on and a packet
  3264.          is matched.  The event identified by a particular value
  3265.          of this object is the same event as identified by the
  3266.          same value of the eventIndex object.  If there is no
  3267.          corresponding entry in the eventTable, then no
  3268.          association exists.  In fact, if no event is intended
  3269.          for this channel, channelEventIndex must be
  3270.          set to zero, a non-existent event index.
  3271.  
  3272.          This object may not be modified if the associated
  3273.          channelStatus object is equal to valid(1)."
  3274.      ::= { channelEntry 7 }
  3275.  
  3276.  channelEventStatus OBJECT-TYPE
  3277.      SYNTAX     INTEGER {
  3278.                   eventReady(1),
  3279.                   eventFired(2),
  3280.  
  3281.  
  3282.  
  3283.  
  3284.  
  3285.                   eventAlwaysReady(3)
  3286.                 }
  3287.      MAX-ACCESS read-create
  3288.      STATUS     current
  3289.      DESCRIPTION
  3290.          "The event status of this channel.
  3291.  
  3292.          If this channel is configured to generate events
  3293.          when packets are matched, a means of controlling
  3294.          the flow of those events is often needed.  When
  3295.          this object is equal to eventReady(1), a single
  3296.          event may be generated, after which this object
  3297.          will be set by the probe to eventFired(2).  While
  3298.          in the eventFired(2) state, no events will be
  3299.          generated until the object is modified to
  3300.          eventReady(1) (or eventAlwaysReady(3)).  The
  3301.          management station can thus easily respond to a
  3302.          notification of an event by re-enabling this object.
  3303.  
  3304.          If the management station wishes to disable this
  3305.          flow control and allow events to be generated
  3306.          at will, this object may be set to
  3307.          eventAlwaysReady(3).  Disabling the flow control
  3308.          is discouraged as it can result in high network
  3309.          traffic or other performance problems."
  3310.      DEFVAL { eventReady }
  3311.      ::= { channelEntry 8 }
  3312.  
  3313.  channelMatches OBJECT-TYPE
  3314.      SYNTAX     Counter32
  3315.      UNITS      "Packets"
  3316.      MAX-ACCESS read-only
  3317.      STATUS     current
  3318.      DESCRIPTION
  3319.          "The number of times this channel has matched a packet.
  3320.          Note that this object is updated even when
  3321.          channelDataControl is set to off."
  3322.      ::= { channelEntry 9 }
  3323.  
  3324.  channelDescription OBJECT-TYPE
  3325.      SYNTAX     DisplayString (SIZE (0..127))
  3326.      MAX-ACCESS read-create
  3327.      STATUS     current
  3328.      DESCRIPTION
  3329.          "A comment describing this channel."
  3330.      ::= { channelEntry 10 }
  3331.  
  3332.  channelOwner OBJECT-TYPE
  3333.  
  3334.  
  3335.  
  3336.  
  3337.  
  3338.      SYNTAX     OwnerString
  3339.      MAX-ACCESS read-create
  3340.      STATUS     current
  3341.      DESCRIPTION
  3342.          "The entity that configured this entry and is therefore
  3343.          using the resources assigned to it."
  3344.      ::= { channelEntry 11 }
  3345.  
  3346.  channelStatus OBJECT-TYPE
  3347.      SYNTAX     EntryStatus
  3348.      MAX-ACCESS read-create
  3349.      STATUS     current
  3350.      DESCRIPTION
  3351.          "The status of this channel entry."
  3352.      ::= { channelEntry 12 }
  3353.  
  3354.  -- The Packet Capture Group
  3355.  
  3356.  -- Implementation of the Packet Capture group is optional. The Packet
  3357.  -- Capture Group requires implementation of the Filter Group.
  3358.  -- Consult the MODULE-COMPLIANCE macro for the authoritative
  3359.  -- conformance information for this MIB.
  3360.  --
  3361.  -- The Packet Capture group allows packets to be captured
  3362.  -- upon a filter match.  The bufferControlTable controls
  3363.  -- the captured packets output from a channel that is
  3364.  -- associated with it.  The captured packets are placed
  3365.  -- in entries in the captureBufferTable.  These entries are
  3366.  -- associated with the bufferControlEntry on whose behalf they
  3367.  -- were stored.
  3368.  
  3369.  bufferControlTable OBJECT-TYPE
  3370.      SYNTAX     SEQUENCE OF BufferControlEntry
  3371.      MAX-ACCESS not-accessible
  3372.      STATUS     current
  3373.      DESCRIPTION
  3374.          "A list of buffers control entries."
  3375.      ::= { capture 1 }
  3376.  
  3377.  bufferControlEntry OBJECT-TYPE
  3378.      SYNTAX     BufferControlEntry
  3379.      MAX-ACCESS not-accessible
  3380.      STATUS     current
  3381.      DESCRIPTION
  3382.          "A set of parameters that control the collection of a stream
  3383.          of packets that have matched filters.  As an example, an
  3384.          instance of the bufferControlCaptureSliceSize object might
  3385.          be named bufferControlCaptureSliceSize.3"
  3386.  
  3387.  
  3388.  
  3389.  
  3390.  
  3391.      INDEX { bufferControlIndex }
  3392.      ::= { bufferControlTable 1 }
  3393.  
  3394.  BufferControlEntry ::= SEQUENCE {
  3395.      bufferControlIndex                Integer32,
  3396.      bufferControlChannelIndex         Integer32,
  3397.      bufferControlFullStatus           INTEGER,
  3398.      bufferControlFullAction           INTEGER,
  3399.      bufferControlCaptureSliceSize     Integer32,
  3400.      bufferControlDownloadSliceSize    Integer32,
  3401.      bufferControlDownloadOffset       Integer32,
  3402.      bufferControlMaxOctetsRequested   Integer32,
  3403.      bufferControlMaxOctetsGranted     Integer32,
  3404.      bufferControlCapturedPackets      Integer32,
  3405.      bufferControlTurnOnTime           TimeTicks,
  3406.      bufferControlOwner                OwnerString,
  3407.      bufferControlStatus               EntryStatus
  3408.  }
  3409.  
  3410.  bufferControlIndex OBJECT-TYPE
  3411.      SYNTAX     Integer32 (1..65535)
  3412.      MAX-ACCESS read-only
  3413.      STATUS     current
  3414.      DESCRIPTION
  3415.          "An index that uniquely identifies an entry
  3416.          in the bufferControl table.  The value of this
  3417.          index shall never be zero.  Each such
  3418.          entry defines one set of packets that is
  3419.          captured and controlled by one or more filters."
  3420.      ::= { bufferControlEntry 1 }
  3421.  
  3422.  bufferControlChannelIndex OBJECT-TYPE
  3423.      SYNTAX     Integer32 (1..65535)
  3424.      MAX-ACCESS read-create
  3425.      STATUS     current
  3426.      DESCRIPTION
  3427.          "An index that identifies the channel that is the
  3428.          source of packets for this bufferControl table.
  3429.          The channel identified by a particular value of this
  3430.          index is the same as identified by the same value of
  3431.          the channelIndex object.
  3432.  
  3433.          This object may not be modified if the associated
  3434.          bufferControlStatus object is equal to valid(1)."
  3435.      ::= { bufferControlEntry 2 }
  3436.  
  3437.  bufferControlFullStatus OBJECT-TYPE
  3438.      SYNTAX     INTEGER {
  3439.  
  3440.  
  3441.  
  3442.  
  3443.  
  3444.                   spaceAvailable(1),
  3445.                   full(2)
  3446.                 }
  3447.      MAX-ACCESS read-only
  3448.      STATUS     current
  3449.      DESCRIPTION
  3450.          "This object shows whether the buffer has room to
  3451.          accept new packets or if it is full.
  3452.  
  3453.          If the status is spaceAvailable(1), the buffer is
  3454.          accepting new packets normally.  If the status is
  3455.          full(2) and the associated bufferControlFullAction
  3456.          object is wrapWhenFull, the buffer is accepting new
  3457.          packets by deleting enough of the oldest packets
  3458.          to make room for new ones as they arrive.  Otherwise,
  3459.          if the status is full(2) and the
  3460.          bufferControlFullAction object is lockWhenFull,
  3461.          then the buffer has stopped collecting packets.
  3462.  
  3463.          When this object is set to full(2) the probe must
  3464.          not later set it to spaceAvailable(1) except in the
  3465.          case of a significant gain in resources such as
  3466.          an increase of bufferControlOctetsGranted.  In
  3467.          particular, the wrap-mode action of deleting old
  3468.          packets to make room for newly arrived packets
  3469.          must not affect the value of this object."
  3470.      ::= { bufferControlEntry 3 }
  3471.  
  3472.  bufferControlFullAction OBJECT-TYPE
  3473.      SYNTAX     INTEGER {
  3474.                   lockWhenFull(1),
  3475.                   wrapWhenFull(2)    -- FIFO
  3476.                 }
  3477.      MAX-ACCESS read-create
  3478.      STATUS     current
  3479.      DESCRIPTION
  3480.          "Controls the action of the buffer when it
  3481.          reaches the full status.  When in the lockWhenFull(1)
  3482.          state and a packet is added to the buffer that
  3483.          fills the buffer, the bufferControlFullStatus will
  3484.          be set to full(2) and this buffer will stop capturing
  3485.          packets."
  3486.      ::= { bufferControlEntry 4 }
  3487.  
  3488.  bufferControlCaptureSliceSize OBJECT-TYPE
  3489.      SYNTAX     Integer32
  3490.      UNITS      "Octets"
  3491.      MAX-ACCESS read-create
  3492.  
  3493.  
  3494.  
  3495.  
  3496.  
  3497.      STATUS     current
  3498.      DESCRIPTION
  3499.          "The maximum number of octets of each packet
  3500.          that will be saved in this capture buffer.
  3501.          For example, if a 1500 octet packet is received by
  3502.          the probe and this object is set to 500, then only
  3503.          500 octets of the packet will be stored in the
  3504.          associated capture buffer.  If this variable is set
  3505.          to 0, the capture buffer will save as many octets
  3506.          as is possible.
  3507.  
  3508.          This object may not be modified if the associated
  3509.          bufferControlStatus object is equal to valid(1)."
  3510.      DEFVAL { 100 }
  3511.      ::= { bufferControlEntry 5 }
  3512.  
  3513.  bufferControlDownloadSliceSize OBJECT-TYPE
  3514.      SYNTAX     Integer32
  3515.      UNITS      "Octets"
  3516.      MAX-ACCESS read-create
  3517.      STATUS     current
  3518.      DESCRIPTION
  3519.          "The maximum number of octets of each packet
  3520.          in this capture buffer that will be returned in
  3521.          an SNMP retrieval of that packet.  For example,
  3522.          if 500 octets of a packet have been stored in the
  3523.          associated capture buffer, the associated
  3524.          bufferControlDownloadOffset is 0, and this
  3525.          object is set to 100, then the captureBufferPacket
  3526.          object that contains the packet will contain only
  3527.          the first 100 octets of the packet.
  3528.  
  3529.          A prudent manager will take into account possible
  3530.          interoperability or fragmentation problems that may
  3531.          occur if the download slice size is set too large.
  3532.          In particular, conformant SNMP implementations are not
  3533.          required to accept messages whose length exceeds 484
  3534.          octets, although they are encouraged to support larger
  3535.          datagrams whenever feasible."
  3536.      DEFVAL { 100 }
  3537.      ::= { bufferControlEntry 6 }
  3538.  
  3539.  bufferControlDownloadOffset OBJECT-TYPE
  3540.      SYNTAX     Integer32
  3541.      UNITS      "Octets"
  3542.      MAX-ACCESS read-create
  3543.      STATUS     current
  3544.      DESCRIPTION
  3545.  
  3546.  
  3547.  
  3548.  
  3549.  
  3550.          "The offset of the first octet of each packet
  3551.          in this capture buffer that will be returned in
  3552.          an SNMP retrieval of that packet.  For example,
  3553.          if 500 octets of a packet have been stored in the
  3554.          associated capture buffer and this object is set to
  3555.          100, then the captureBufferPacket object that
  3556.          contains the packet will contain bytes starting
  3557.          100 octets into the packet."
  3558.      DEFVAL { 0 }
  3559.      ::= { bufferControlEntry 7 }
  3560.  
  3561.  bufferControlMaxOctetsRequested OBJECT-TYPE
  3562.      SYNTAX     Integer32
  3563.      UNITS      "Octets"
  3564.      MAX-ACCESS read-create
  3565.      STATUS     current
  3566.      DESCRIPTION
  3567.          "The requested maximum number of octets to be
  3568.          saved in this captureBuffer, including any
  3569.          implementation-specific overhead. If this variable
  3570.          is set to -1, the capture buffer will save as many
  3571.          octets as is possible.
  3572.  
  3573.          When this object is created or modified, the probe
  3574.          should set bufferControlMaxOctetsGranted as closely
  3575.          to this object as is possible for the particular probe
  3576.          implementation and available resources.  However, if
  3577.          the object has the special value of -1, the probe
  3578.          must set bufferControlMaxOctetsGranted to -1."
  3579.      DEFVAL { -1 }
  3580.      ::= { bufferControlEntry 8 }
  3581.  
  3582.  bufferControlMaxOctetsGranted OBJECT-TYPE
  3583.      SYNTAX     Integer32
  3584.      UNITS      "Octets"
  3585.      MAX-ACCESS read-only
  3586.      STATUS     current
  3587.      DESCRIPTION
  3588.          "The maximum number of octets that can be
  3589.          saved in this captureBuffer, including overhead.
  3590.          If this variable is -1, the capture buffer will save
  3591.          as many octets as possible.
  3592.  
  3593.          When the bufferControlMaxOctetsRequested object is
  3594.          created or modified, the probe should set this object
  3595.          as closely to the requested value as is possible for the
  3596.          particular probe implementation and available resources.
  3597.          However, if the request object has the special value
  3598.  
  3599.  
  3600.  
  3601.  
  3602.  
  3603.          of -1, the probe must set this object to -1.
  3604.  
  3605.          The probe must not lower this value except as a result of
  3606.          a modification to the associated
  3607.          bufferControlMaxOctetsRequested object.
  3608.  
  3609.          When this maximum number of octets is reached
  3610.          and a new packet is to be added to this
  3611.          capture buffer and the corresponding
  3612.          bufferControlFullAction is set to wrapWhenFull(2),
  3613.          enough of the oldest packets associated with this
  3614.          capture buffer shall be deleted by the agent so
  3615.          that the new packet can be added.  If the corresponding
  3616.          bufferControlFullAction is set to lockWhenFull(1),
  3617.          the new packet shall be discarded.  In either case,
  3618.          the probe must set bufferControlFullStatus to
  3619.          full(2).
  3620.  
  3621.          When the value of this object changes to a value less
  3622.          than the current value, entries are deleted from
  3623.          the captureBufferTable associated with this
  3624.          bufferControlEntry.  Enough of the
  3625.          oldest of these captureBufferEntries shall be
  3626.          deleted by the agent so that the number of octets
  3627.          used remains less than or equal to the new value of
  3628.          this object.
  3629.  
  3630.          When the value of this object changes to a value greater
  3631.          than the current value, the number of associated
  3632.          captureBufferEntries may be allowed to grow."
  3633.      ::= { bufferControlEntry 9 }
  3634.  
  3635.  bufferControlCapturedPackets OBJECT-TYPE
  3636.      SYNTAX     Integer32
  3637.      UNITS      "Packets"
  3638.      MAX-ACCESS read-only
  3639.      STATUS     current
  3640.      DESCRIPTION
  3641.          "The number of packets currently in this captureBuffer."
  3642.      ::= { bufferControlEntry 10 }
  3643.  
  3644.  bufferControlTurnOnTime OBJECT-TYPE
  3645.      SYNTAX     TimeTicks
  3646.      MAX-ACCESS read-only
  3647.      STATUS     current
  3648.      DESCRIPTION
  3649.          "The value of sysUpTime when this capture buffer was
  3650.          first turned on."
  3651.  
  3652.  
  3653.  
  3654.  
  3655.  
  3656.      ::= { bufferControlEntry 11 }
  3657.  
  3658.  bufferControlOwner OBJECT-TYPE
  3659.      SYNTAX     OwnerString
  3660.      MAX-ACCESS read-create
  3661.      STATUS     current
  3662.      DESCRIPTION
  3663.          "The entity that configured this entry and is therefore
  3664.          using the resources assigned to it."
  3665.      ::= { bufferControlEntry 12 }
  3666.  
  3667.  bufferControlStatus OBJECT-TYPE
  3668.      SYNTAX     EntryStatus
  3669.      MAX-ACCESS read-create
  3670.      STATUS     current
  3671.      DESCRIPTION
  3672.          "The status of this buffer Control Entry."
  3673.      ::= { bufferControlEntry 13 }
  3674.  
  3675.  captureBufferTable OBJECT-TYPE
  3676.      SYNTAX     SEQUENCE OF CaptureBufferEntry
  3677.      MAX-ACCESS not-accessible
  3678.      STATUS     current
  3679.      DESCRIPTION
  3680.          "A list of packets captured off of a channel."
  3681.      ::= { capture 2 }
  3682.  
  3683.  captureBufferEntry OBJECT-TYPE
  3684.      SYNTAX     CaptureBufferEntry
  3685.      MAX-ACCESS not-accessible
  3686.      STATUS     current
  3687.      DESCRIPTION
  3688.          "A packet captured off of an attached network.  As an
  3689.          example, an instance of the captureBufferPacketData
  3690.          object might be named captureBufferPacketData.3.1783"
  3691.      INDEX { captureBufferControlIndex, captureBufferIndex }
  3692.      ::= { captureBufferTable 1 }
  3693.  
  3694.  CaptureBufferEntry ::= SEQUENCE {
  3695.      captureBufferControlIndex   Integer32,
  3696.      captureBufferIndex          Integer32,
  3697.      captureBufferPacketID       Integer32,
  3698.      captureBufferPacketData     OCTET STRING,
  3699.      captureBufferPacketLength   Integer32,
  3700.      captureBufferPacketTime     Integer32,
  3701.      captureBufferPacketStatus   Integer32
  3702.  }
  3703.  
  3704.  
  3705.  
  3706.  
  3707.  
  3708.  
  3709.  captureBufferControlIndex OBJECT-TYPE
  3710.      SYNTAX     Integer32 (1..65535)
  3711.      MAX-ACCESS read-only
  3712.      STATUS     current
  3713.      DESCRIPTION
  3714.          "The index of the bufferControlEntry with which
  3715.          this packet is associated."
  3716.      ::= { captureBufferEntry 1 }
  3717.  
  3718.  captureBufferIndex OBJECT-TYPE
  3719.      SYNTAX     Integer32 (1..2147483647)
  3720.      MAX-ACCESS read-only
  3721.      STATUS     current
  3722.      DESCRIPTION
  3723.          "An index that uniquely identifies an entry
  3724.          in the captureBuffer table associated with a
  3725.          particular bufferControlEntry.  This index will
  3726.          start at 1 and increase by one for each new packet
  3727.          added with the same captureBufferControlIndex.
  3728.  
  3729.          Should this value reach 2147483647, the next packet
  3730.          added with the same captureBufferControlIndex shall
  3731.          cause this value to wrap around to 1."
  3732.      ::= { captureBufferEntry 2 }
  3733.  
  3734.  captureBufferPacketID OBJECT-TYPE
  3735.      SYNTAX     Integer32
  3736.      MAX-ACCESS read-only
  3737.      STATUS     current
  3738.      DESCRIPTION
  3739.          "An index that describes the order of packets
  3740.          that are received on a particular interface.
  3741.          The packetID of a packet captured on an
  3742.          interface is defined to be greater than the
  3743.          packetID's of all packets captured previously on
  3744.          the same interface.  As the captureBufferPacketID
  3745.          object has a maximum positive value of 2^31 - 1,
  3746.          any captureBufferPacketID object shall have the
  3747.          value of the associated packet's packetID mod 2^31."
  3748.      ::= { captureBufferEntry 3 }
  3749.  
  3750.  captureBufferPacketData OBJECT-TYPE
  3751.      SYNTAX     OCTET STRING
  3752.      MAX-ACCESS read-only
  3753.      STATUS     current
  3754.      DESCRIPTION
  3755.          "The data inside the packet, starting at the beginning
  3756.          of the packet plus any offset specified in the
  3757.  
  3758.  
  3759.  
  3760.  
  3761.  
  3762.          associated bufferControlDownloadOffset, including any
  3763.          link level headers.  The length of the data in this object
  3764.          is the minimum of the length of the captured packet minus
  3765.          the offset, the length of the associated
  3766.          bufferControlCaptureSliceSize minus the offset, and the
  3767.          associated bufferControlDownloadSliceSize.  If this minimum
  3768.          is less than zero, this object shall have a length of zero."
  3769.      ::= { captureBufferEntry 4 }
  3770.  
  3771.  captureBufferPacketLength OBJECT-TYPE
  3772.      SYNTAX     Integer32
  3773.      UNITS      "Octets"
  3774.      MAX-ACCESS read-only
  3775.      STATUS     current
  3776.      DESCRIPTION
  3777.          "The actual length (off the wire) of the packet stored
  3778.          in this entry, including FCS octets."
  3779.      ::= { captureBufferEntry 5 }
  3780.  
  3781.  captureBufferPacketTime OBJECT-TYPE
  3782.      SYNTAX     Integer32
  3783.      UNITS      "Milliseconds"
  3784.      MAX-ACCESS read-only
  3785.      STATUS     current
  3786.      DESCRIPTION
  3787.          "The number of milliseconds that had passed since
  3788.          this capture buffer was first turned on when this
  3789.          packet was captured."
  3790.      ::= { captureBufferEntry 6 }
  3791.  
  3792.  captureBufferPacketStatus OBJECT-TYPE
  3793.      SYNTAX     Integer32
  3794.      MAX-ACCESS read-only
  3795.      STATUS     current
  3796.      DESCRIPTION
  3797.          "A value which indicates the error status of this packet.
  3798.  
  3799.          The value of this object is defined in the same way as
  3800.          filterPktStatus.  The value is a sum.  This sum
  3801.          initially takes the value zero.  Then, for each
  3802.          error, E, that has been discovered in this packet,
  3803.          2 raised to a value representing E is added to the sum.
  3804.  
  3805.          The errors defined for a packet captured off of an
  3806.          Ethernet interface are as follows:
  3807.  
  3808.              bit #    Error
  3809.                  0    Packet is longer than 1518 octets
  3810.  
  3811.  
  3812.  
  3813.  
  3814.  
  3815.                  1    Packet is shorter than 64 octets
  3816.                  2    Packet experienced a CRC or Alignment error
  3817.                  3    First packet in this capture buffer after
  3818.                       it was detected that some packets were
  3819.                       not processed correctly.
  3820.                  4    Packet's order in buffer is only approximate
  3821.                       (May only be set for packets sent from
  3822.                       the probe)
  3823.  
  3824.          For example, an Ethernet fragment would have a
  3825.          value of 6 (2^1 + 2^2).
  3826.  
  3827.          As this MIB is expanded to new media types, this object
  3828.          will have other media-specific errors defined."
  3829.      ::= { captureBufferEntry 7 }
  3830.  
  3831.  -- The Event Group
  3832.  
  3833.  -- Implementation of the Event group is optional.
  3834.  -- Consult the MODULE-COMPLIANCE macro for the authoritative
  3835.  -- conformance information for this MIB.
  3836.  --
  3837.  -- The Event group controls the generation and notification
  3838.  -- of events from this device.  Each entry in the eventTable
  3839.  -- describes the parameters of the event that can be triggered.
  3840.  -- Each event entry is fired by an associated condition located
  3841.  -- elsewhere in the MIB.  An event entry may also be associated
  3842.  -- with a function elsewhere in the MIB that will be executed
  3843.  -- when the event is generated.  For example, a channel may
  3844.  -- be turned on or off by the firing of an event.
  3845.  --
  3846.  -- Each eventEntry may optionally specify that a log entry
  3847.  -- be created on its behalf whenever the event occurs.
  3848.  -- Each entry may also specify that notification should
  3849.  -- occur by way of SNMP trap messages.  In this case, the
  3850.  -- community for the trap message is given in the associated
  3851.  -- eventCommunity object.  The enterprise and specific trap
  3852.  -- fields of the trap are determined by the condition that
  3853.  -- triggered the event.  Two traps are defined: risingAlarm and
  3854.  -- fallingAlarm.  If the eventTable is triggered by a condition
  3855.  -- specified elsewhere, the enterprise and specific trap fields
  3856.  -- must be specified for traps generated for that condition.
  3857.  
  3858.  eventTable OBJECT-TYPE
  3859.      SYNTAX     SEQUENCE OF EventEntry
  3860.      MAX-ACCESS not-accessible
  3861.      STATUS     current
  3862.      DESCRIPTION
  3863.  
  3864.  
  3865.  
  3866.  
  3867.  
  3868.          "A list of events to be generated."
  3869.      ::= { event 1 }
  3870.  
  3871.  eventEntry OBJECT-TYPE
  3872.      SYNTAX     EventEntry
  3873.      MAX-ACCESS not-accessible
  3874.      STATUS     current
  3875.      DESCRIPTION
  3876.          "A set of parameters that describe an event to be generated
  3877.          when certain conditions are met.  As an example, an instance
  3878.          of the eventLastTimeSent object might be named
  3879.          eventLastTimeSent.6"
  3880.      INDEX { eventIndex }
  3881.      ::= { eventTable 1 }
  3882.  
  3883.  EventEntry ::= SEQUENCE {
  3884.      eventIndex          Integer32,
  3885.      eventDescription    DisplayString,
  3886.      eventType           INTEGER,
  3887.      eventCommunity      OCTET STRING,
  3888.      eventLastTimeSent   TimeTicks,
  3889.      eventOwner          OwnerString,
  3890.      eventStatus         EntryStatus
  3891.  }
  3892.  
  3893.  eventIndex OBJECT-TYPE
  3894.      SYNTAX     Integer32 (1..65535)
  3895.      MAX-ACCESS read-only
  3896.      STATUS     current
  3897.      DESCRIPTION
  3898.          "An index that uniquely identifies an entry in the
  3899.          event table.  Each such entry defines one event that
  3900.          is to be generated when the appropriate conditions
  3901.          occur."
  3902.      ::= { eventEntry 1 }
  3903.  
  3904.  eventDescription OBJECT-TYPE
  3905.      SYNTAX     DisplayString (SIZE (0..127))
  3906.      MAX-ACCESS read-create
  3907.      STATUS     current
  3908.      DESCRIPTION
  3909.          "A comment describing this event entry."
  3910.      ::= { eventEntry 2 }
  3911.  
  3912.  eventType OBJECT-TYPE
  3913.      SYNTAX     INTEGER {
  3914.                   none(1),
  3915.                   log(2),
  3916.  
  3917.  
  3918.  
  3919.  
  3920.  
  3921.                   snmptrap(3),    -- send an SNMP trap
  3922.                   logandtrap(4)
  3923.                 }
  3924.      MAX-ACCESS read-create
  3925.      STATUS     current
  3926.      DESCRIPTION
  3927.          "The type of notification that the probe will make
  3928.          about this event.  In the case of log, an entry is
  3929.          made in the log table for each event.  In the case of
  3930.          snmp-trap, an SNMP trap is sent to one or more
  3931.          management stations."
  3932.      ::= { eventEntry 3 }
  3933.  
  3934.  eventCommunity OBJECT-TYPE
  3935.      SYNTAX     OCTET STRING (SIZE (0..127))
  3936.      MAX-ACCESS read-create
  3937.      STATUS     current
  3938.      DESCRIPTION
  3939.          "If an SNMP trap is to be sent, it will be sent to
  3940.          the SNMP community specified by this octet string."
  3941.      ::= { eventEntry 4 }
  3942.  
  3943.  eventLastTimeSent OBJECT-TYPE
  3944.      SYNTAX     TimeTicks
  3945.      MAX-ACCESS read-only
  3946.      STATUS     current
  3947.      DESCRIPTION
  3948.          "The value of sysUpTime at the time this event
  3949.          entry last generated an event.  If this entry has
  3950.          not generated any events, this value will be
  3951.          zero."
  3952.      ::= { eventEntry 5 }
  3953.  
  3954.  eventOwner OBJECT-TYPE
  3955.      SYNTAX     OwnerString
  3956.      MAX-ACCESS read-create
  3957.      STATUS     current
  3958.      DESCRIPTION
  3959.          "The entity that configured this entry and is therefore
  3960.          using the resources assigned to it.
  3961.  
  3962.          If this object contains a string starting with 'monitor'
  3963.          and has associated entries in the log table, all connected
  3964.          management stations should retrieve those log entries,
  3965.          as they may have significance to all management stations
  3966.          connected to this device"
  3967.      ::= { eventEntry 6 }
  3968.  
  3969.  
  3970.  
  3971.  
  3972.  
  3973.  
  3974.  eventStatus OBJECT-TYPE
  3975.      SYNTAX     EntryStatus
  3976.      MAX-ACCESS read-create
  3977.      STATUS     current
  3978.      DESCRIPTION
  3979.          "The status of this event entry.
  3980.  
  3981.          If this object is not equal to valid(1), all associated
  3982.          log entries shall be deleted by the agent."
  3983.      ::= { eventEntry 7 }
  3984.  
  3985.  --
  3986.  logTable OBJECT-TYPE
  3987.      SYNTAX     SEQUENCE OF LogEntry
  3988.      MAX-ACCESS not-accessible
  3989.      STATUS     current
  3990.      DESCRIPTION
  3991.          "A list of events that have been logged."
  3992.      ::= { event 2 }
  3993.  
  3994.  logEntry OBJECT-TYPE
  3995.      SYNTAX     LogEntry
  3996.      MAX-ACCESS not-accessible
  3997.      STATUS     current
  3998.      DESCRIPTION
  3999.          "A set of data describing an event that has been
  4000.          logged.  For example, an instance of the logDescription
  4001.          object might be named logDescription.6.47"
  4002.      INDEX { logEventIndex, logIndex }
  4003.      ::= { logTable 1 }
  4004.  
  4005.  LogEntry ::= SEQUENCE {
  4006.      logEventIndex           Integer32,
  4007.      logIndex                Integer32,
  4008.      logTime                 TimeTicks,
  4009.      logDescription          DisplayString
  4010.  }
  4011.  
  4012.  logEventIndex OBJECT-TYPE
  4013.      SYNTAX     Integer32 (1..65535)
  4014.      MAX-ACCESS read-only
  4015.      STATUS     current
  4016.      DESCRIPTION
  4017.          "The event entry that generated this log
  4018.          entry.  The log identified by a particular
  4019.          value of this index is associated with the same
  4020.          eventEntry as identified by the same value
  4021.          of eventIndex."
  4022.  
  4023.  
  4024.  
  4025.  
  4026.  
  4027.      ::= { logEntry 1 }
  4028.  
  4029.  logIndex OBJECT-TYPE
  4030.      SYNTAX     Integer32 (1..2147483647)
  4031.      MAX-ACCESS read-only
  4032.      STATUS     current
  4033.      DESCRIPTION
  4034.          "An index that uniquely identifies an entry
  4035.          in the log table amongst those generated by the
  4036.          same eventEntries.  These indexes are
  4037.          assigned beginning with 1 and increase by one
  4038.          with each new log entry.  The association
  4039.          between values of logIndex and logEntries
  4040.          is fixed for the lifetime of each logEntry.
  4041.          The agent may choose to delete the oldest
  4042.          instances of logEntry as required because of
  4043.          lack of memory.  It is an implementation-specific
  4044.          matter as to when this deletion may occur."
  4045.      ::= { logEntry 2 }
  4046.  
  4047.  logTime OBJECT-TYPE
  4048.      SYNTAX     TimeTicks
  4049.      MAX-ACCESS read-only
  4050.      STATUS     current
  4051.      DESCRIPTION
  4052.          "The value of sysUpTime when this log entry was created."
  4053.      ::= { logEntry 3 }
  4054.  
  4055.  logDescription OBJECT-TYPE
  4056.      SYNTAX     DisplayString (SIZE (0..255))
  4057.      MAX-ACCESS read-only
  4058.      STATUS     current
  4059.      DESCRIPTION
  4060.          "An implementation dependent description of the
  4061.          event that activated this log entry."
  4062.      ::= { logEntry 4 }
  4063.  
  4064.  --  Remote Network Monitoring Traps
  4065.  
  4066.  rmonEventsV2 OBJECT-IDENTITY
  4067.      STATUS      current
  4068.      DESCRIPTION "Definition point for RMON notifications."
  4069.      ::= { rmon 0 }
  4070.  
  4071.  risingAlarm NOTIFICATION-TYPE
  4072.      OBJECTS  { alarmIndex, alarmVariable, alarmSampleType,
  4073.                 alarmValue, alarmRisingThreshold }
  4074.      STATUS   current
  4075.  
  4076.  
  4077.  
  4078.  
  4079.  
  4080.      DESCRIPTION
  4081.          "The SNMP trap that is generated when an alarm
  4082.          entry crosses its rising threshold and generates
  4083.          an event that is configured for sending SNMP
  4084.          traps."
  4085.      ::= { rmonEventsV2 1 }
  4086.  
  4087.  fallingAlarm NOTIFICATION-TYPE
  4088.      OBJECTS { alarmIndex, alarmVariable, alarmSampleType,
  4089.                alarmValue, alarmFallingThreshold }
  4090.      STATUS    current
  4091.      DESCRIPTION
  4092.          "The SNMP trap that is generated when an alarm
  4093.          entry crosses its falling threshold and generates
  4094.          an event that is configured for sending SNMP
  4095.          traps."
  4096.      ::= { rmonEventsV2 2 }
  4097.  
  4098.  -- Conformance information
  4099.  
  4100.  rmonCompliances OBJECT IDENTIFIER ::= { rmonConformance 9 }
  4101.  rmonGroups      OBJECT IDENTIFIER ::= { rmonConformance 10 }
  4102.  
  4103.  -- Compliance Statements
  4104.  rmonCompliance MODULE-COMPLIANCE
  4105.      STATUS current
  4106.      DESCRIPTION
  4107.          "The requirements for conformance to the RMON MIB. At least
  4108.          one of the groups in this module must be implemented to
  4109.          conform to the RMON MIB. Implementations of this MIB
  4110.          must also implement the system group of MIB-II [16] and the
  4111.          IF-MIB [17]."
  4112.      MODULE -- this module
  4113.  
  4114.        GROUP rmonEtherStatsGroup
  4115.            DESCRIPTION
  4116.                "The RMON Ethernet Statistics Group is optional."
  4117.  
  4118.        GROUP rmonHistoryControlGroup
  4119.            DESCRIPTION
  4120.                "The RMON History Control Group is optional."
  4121.  
  4122.        GROUP rmonEthernetHistoryGroup
  4123.            DESCRIPTION
  4124.                "The RMON Ethernet History Group is optional."
  4125.  
  4126.        GROUP rmonAlarmGroup
  4127.            DESCRIPTION
  4128.  
  4129.  
  4130.  
  4131.  
  4132.  
  4133.                "The RMON Alarm Group is optional."
  4134.  
  4135.        GROUP rmonHostGroup
  4136.            DESCRIPTION
  4137.                "The RMON Host Group is mandatory when the
  4138.                rmonHostTopNGroup is implemented."
  4139.  
  4140.        GROUP rmonHostTopNGroup
  4141.            DESCRIPTION
  4142.                "The RMON Host Top N Group is optional."
  4143.  
  4144.        GROUP rmonMatrixGroup
  4145.            DESCRIPTION
  4146.                "The RMON Matrix Group is optional."
  4147.  
  4148.        GROUP rmonFilterGroup
  4149.            DESCRIPTION
  4150.                "The RMON Filter Group is mandatory when the
  4151.                rmonPacketCaptureGroup is implemented."
  4152.  
  4153.        GROUP rmonPacketCaptureGroup
  4154.            DESCRIPTION
  4155.                "The RMON Packet Capture Group is optional."
  4156.  
  4157.        GROUP rmonEventGroup
  4158.            DESCRIPTION
  4159.                "The RMON Event Group is mandatory when the
  4160.                rmonAlarmGroup is implemented."
  4161.      ::= { rmonCompliances 1 }
  4162.  
  4163.      rmonEtherStatsGroup OBJECT-GROUP
  4164.          OBJECTS {
  4165.              etherStatsIndex, etherStatsDataSource,
  4166.              etherStatsDropEvents, etherStatsOctets, etherStatsPkts,
  4167.              etherStatsBroadcastPkts, etherStatsMulticastPkts,
  4168.              etherStatsCRCAlignErrors, etherStatsUndersizePkts,
  4169.              etherStatsOversizePkts, etherStatsFragments,
  4170.              etherStatsJabbers, etherStatsCollisions,
  4171.              etherStatsPkts64Octets, etherStatsPkts65to127Octets,
  4172.              etherStatsPkts128to255Octets,
  4173.              etherStatsPkts256to511Octets,
  4174.              etherStatsPkts512to1023Octets,
  4175.              etherStatsPkts1024to1518Octets,
  4176.              etherStatsOwner, etherStatsStatus
  4177.          }
  4178.          STATUS current
  4179.          DESCRIPTION
  4180.              "The RMON Ethernet Statistics Group."
  4181.  
  4182.  
  4183.  
  4184.  
  4185.  
  4186.          ::= { rmonGroups 1 }
  4187.  
  4188.      rmonHistoryControlGroup OBJECT-GROUP
  4189.          OBJECTS {
  4190.              historyControlIndex, historyControlDataSource,
  4191.              historyControlBucketsRequested,
  4192.              historyControlBucketsGranted, historyControlInterval,
  4193.              historyControlOwner, historyControlStatus
  4194.          }
  4195.          STATUS current
  4196.          DESCRIPTION
  4197.              "The RMON History Control Group."
  4198.          ::= { rmonGroups 2 }
  4199.  
  4200.      rmonEthernetHistoryGroup OBJECT-GROUP
  4201.          OBJECTS {
  4202.              etherHistoryIndex, etherHistorySampleIndex,
  4203.              etherHistoryIntervalStart, etherHistoryDropEvents,
  4204.              etherHistoryOctets, etherHistoryPkts,
  4205.              etherHistoryBroadcastPkts, etherHistoryMulticastPkts,
  4206.              etherHistoryCRCAlignErrors, etherHistoryUndersizePkts,
  4207.              etherHistoryOversizePkts, etherHistoryFragments,
  4208.              etherHistoryJabbers, etherHistoryCollisions,
  4209.              etherHistoryUtilization
  4210.          }
  4211.          STATUS current
  4212.          DESCRIPTION
  4213.              "The RMON Ethernet History Group."
  4214.          ::= { rmonGroups 3 }
  4215.  
  4216.      rmonAlarmGroup OBJECT-GROUP
  4217.          OBJECTS {
  4218.              alarmIndex, alarmInterval, alarmVariable,
  4219.              alarmSampleType, alarmValue, alarmStartupAlarm,
  4220.              alarmRisingThreshold, alarmFallingThreshold,
  4221.              alarmRisingEventIndex, alarmFallingEventIndex,
  4222.              alarmOwner, alarmStatus
  4223.          }
  4224.          STATUS current
  4225.          DESCRIPTION
  4226.              "The RMON Alarm Group."
  4227.          ::= { rmonGroups 4 }
  4228.  
  4229.      rmonHostGroup OBJECT-GROUP
  4230.          OBJECTS {
  4231.              hostControlIndex, hostControlDataSource,
  4232.              hostControlTableSize, hostControlLastDeleteTime,
  4233.              hostControlOwner, hostControlStatus,
  4234.  
  4235.  
  4236.  
  4237.  
  4238.  
  4239.              hostAddress, hostCreationOrder, hostIndex,
  4240.              hostInPkts, hostOutPkts, hostInOctets,
  4241.              hostOutOctets, hostOutErrors, hostOutBroadcastPkts,
  4242.              hostOutMulticastPkts, hostTimeAddress,
  4243.              hostTimeCreationOrder, hostTimeIndex,
  4244.              hostTimeInPkts, hostTimeOutPkts, hostTimeInOctets,
  4245.              hostTimeOutOctets, hostTimeOutErrors,
  4246.              hostTimeOutBroadcastPkts, hostTimeOutMulticastPkts
  4247.          }
  4248.          STATUS current
  4249.          DESCRIPTION
  4250.              "The RMON Host Group."
  4251.          ::= { rmonGroups 5 }
  4252.  
  4253.      rmonHostTopNGroup OBJECT-GROUP
  4254.          OBJECTS {
  4255.              hostTopNControlIndex, hostTopNHostIndex,
  4256.              hostTopNRateBase, hostTopNTimeRemaining,
  4257.              hostTopNDuration, hostTopNRequestedSize,
  4258.              hostTopNGrantedSize, hostTopNStartTime,
  4259.              hostTopNOwner, hostTopNStatus,
  4260.              hostTopNReport, hostTopNIndex,
  4261.              hostTopNAddress, hostTopNRate
  4262.          }
  4263.          STATUS current
  4264.          DESCRIPTION
  4265.              "The RMON Host Top 'N' Group."
  4266.          ::= { rmonGroups 6 }
  4267.  
  4268.      rmonMatrixGroup OBJECT-GROUP
  4269.          OBJECTS {
  4270.              matrixControlIndex, matrixControlDataSource,
  4271.              matrixControlTableSize, matrixControlLastDeleteTime,
  4272.              matrixControlOwner, matrixControlStatus,
  4273.              matrixSDSourceAddress, matrixSDDestAddress,
  4274.              matrixSDIndex, matrixSDPkts,
  4275.              matrixSDOctets, matrixSDErrors,
  4276.              matrixDSSourceAddress, matrixDSDestAddress,
  4277.              matrixDSIndex, matrixDSPkts,
  4278.              matrixDSOctets, matrixDSErrors
  4279.          }
  4280.          STATUS current
  4281.          DESCRIPTION
  4282.              "The RMON Matrix Group."
  4283.          ::= { rmonGroups 7 }
  4284.  
  4285.      rmonFilterGroup OBJECT-GROUP
  4286.          OBJECTS {
  4287.  
  4288.  
  4289.  
  4290.  
  4291.  
  4292.              filterIndex, filterChannelIndex, filterPktDataOffset,
  4293.              filterPktData, filterPktDataMask,
  4294.              filterPktDataNotMask, filterPktStatus,
  4295.              filterPktStatusMask, filterPktStatusNotMask,
  4296.              filterOwner, filterStatus,
  4297.              channelIndex, channelIfIndex, channelAcceptType,
  4298.              channelDataControl, channelTurnOnEventIndex,
  4299.              channelTurnOffEventIndex, channelEventIndex,
  4300.              channelEventStatus, channelMatches,
  4301.              channelDescription, channelOwner, channelStatus
  4302.          }
  4303.          STATUS current
  4304.          DESCRIPTION
  4305.              "The RMON Filter Group."
  4306.          ::= { rmonGroups 8 }
  4307.  
  4308.      rmonPacketCaptureGroup OBJECT-GROUP
  4309.          OBJECTS {
  4310.              bufferControlIndex, bufferControlChannelIndex,
  4311.              bufferControlFullStatus, bufferControlFullAction,
  4312.              bufferControlCaptureSliceSize,
  4313.              bufferControlDownloadSliceSize,
  4314.              bufferControlDownloadOffset,
  4315.              bufferControlMaxOctetsRequested,
  4316.              bufferControlMaxOctetsGranted,
  4317.              bufferControlCapturedPackets,
  4318.              bufferControlTurnOnTime,
  4319.              bufferControlOwner, bufferControlStatus,
  4320.              captureBufferControlIndex, captureBufferIndex,
  4321.              captureBufferPacketID, captureBufferPacketData,
  4322.              captureBufferPacketLength, captureBufferPacketTime,
  4323.              captureBufferPacketStatus
  4324.          }
  4325.          STATUS current
  4326.          DESCRIPTION
  4327.              "The RMON Packet Capture Group."
  4328.          ::= { rmonGroups 9 }
  4329.  
  4330.      rmonEventGroup OBJECT-GROUP
  4331.          OBJECTS {
  4332.              eventIndex, eventDescription, eventType,
  4333.              eventCommunity, eventLastTimeSent,
  4334.              eventOwner, eventStatus,
  4335.              logEventIndex, logIndex, logTime,
  4336.              logDescription
  4337.          }
  4338.          STATUS current
  4339.          DESCRIPTION
  4340.  
  4341.  
  4342.  
  4343.  
  4344.  
  4345.              "The RMON Event Group."
  4346.          ::= { rmonGroups 10 }
  4347.  
  4348.      rmonNotificationGroup NOTIFICATION-GROUP
  4349.          NOTIFICATIONS { risingAlarm, fallingAlarm }
  4350.          STATUS        current
  4351.          DESCRIPTION
  4352.              "The RMON Notification Group."
  4353.          ::= { rmonGroups 11 }
  4354.  END
  4355.  
  4356.