Blame mibs/ietf/RMON-MIB

Packit 022b05
RMON-MIB DEFINITIONS ::= BEGIN
Packit 022b05
Packit 022b05
    IMPORTS
Packit 022b05
        MODULE-IDENTITY, OBJECT-TYPE, OBJECT-IDENTITY,
Packit 022b05
        NOTIFICATION-TYPE, mib-2, Counter32,
Packit 022b05
        Integer32, TimeTicks                   FROM SNMPv2-SMI
Packit 022b05
Packit 022b05
        TEXTUAL-CONVENTION, DisplayString      FROM SNMPv2-TC
Packit 022b05
Packit 022b05
        MODULE-COMPLIANCE, OBJECT-GROUP,
Packit 022b05
        NOTIFICATION-GROUP                     FROM SNMPv2-CONF;
Packit 022b05
Packit 022b05
Packit 022b05
--  Remote Network Monitoring MIB
Packit 022b05
Packit 022b05
rmonMibModule MODULE-IDENTITY
Packit 022b05
    LAST-UPDATED "200005110000Z"  -- 11 May, 2000
Packit 022b05
    ORGANIZATION "IETF RMON MIB Working Group"
Packit 022b05
    CONTACT-INFO
Packit 022b05
        "Steve Waldbusser
Packit 022b05
        Phone: +1-650-948-6500
Packit 022b05
        Fax:   +1-650-745-0671
Packit 022b05
        Email: waldbusser@nextbeacon.com"
Packit 022b05
    DESCRIPTION
Packit 022b05
        "Remote network monitoring devices, often called
Packit 022b05
        monitors or probes, are instruments that exist for
Packit 022b05
        the purpose of managing a network. This MIB defines
Packit 022b05
        objects for managing remote network monitoring devices."
Packit 022b05
Packit 022b05
    REVISION "200005110000Z"    -- 11 May, 2000
Packit 022b05
    DESCRIPTION
Packit 022b05
        "Reformatted into SMIv2 format.
Packit 022b05
Packit 022b05
        This version published as RFC 2819."
Packit 022b05
Packit 022b05
    REVISION "199502010000Z" -- 1 Feb, 1995
Packit 022b05
    DESCRIPTION
Packit 022b05
        "Bug fixes, clarifications and minor changes based on
Packit 022b05
        implementation experience, published as RFC1757 [18].
Packit 022b05
Packit 022b05
        Two changes were made to object definitions:
Packit 022b05
Packit 022b05
        1) A new status bit has been defined for the
Packit 022b05
        captureBufferPacketStatus object, indicating that the
Packit 022b05
        packet order within the capture buffer may not be identical to
Packit 022b05
        the packet order as received off the wire.  This bit may only
Packit 022b05
        be used for packets transmitted by the probe.  Older NMS
Packit 022b05
        applications can safely ignore this status bit, which might be
Packit 022b05
        used by newer agents.
Packit 022b05
Packit 022b05
        2) The packetMatch trap has been removed.  This trap was never
Packit 022b05
        actually 'approved' and was not added to this document along
Packit 022b05
        with the risingAlarm and fallingAlarm traps. The packetMatch
Packit 022b05
        trap could not be throttled, which could cause disruption of
Packit 022b05
        normal network traffic under some circumstances. An NMS should
Packit 022b05
        configure a risingAlarm threshold on the appropriate
Packit 022b05
        channelMatches instance if a trap is desired for a packetMatch
Packit 022b05
        event. Note that logging of packetMatch events is still
Packit 022b05
        supported--only trap generation for such events has been
Packit 022b05
        removed.
Packit 022b05
Packit 022b05
        In addition, several clarifications to individual object
Packit 022b05
        definitions have been added to assist agent and NMS
Packit 022b05
        implementors:
Packit 022b05
Packit 022b05
        - global definition of 'good packets' and 'bad packets'
Packit 022b05
Packit 022b05
        - more detailed text governing conceptual row creation and
Packit 022b05
          modification
Packit 022b05
Packit 022b05
        - instructions for probes relating to interface changes and
Packit 022b05
          disruptions
Packit 022b05
Packit 022b05
        - clarification of some ethernet counter definitions
Packit 022b05
Packit 022b05
        - recommended formula for calculating network utilization
Packit 022b05
Packit 022b05
        - clarification of channel and captureBuffer behavior for some
Packit 022b05
          unusual conditions
Packit 022b05
Packit 022b05
        - examples of proper instance naming for each table"
Packit 022b05
Packit 022b05
    REVISION "199111010000Z"    -- 1 Nov, 1991
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The original version of this MIB, published as RFC1271."
Packit 022b05
    ::= { rmonConformance 8 }
Packit 022b05
Packit 022b05
    rmon    OBJECT IDENTIFIER ::= { mib-2 16 }
Packit 022b05
Packit 022b05
Packit 022b05
    -- textual conventions
Packit 022b05
Packit 022b05
OwnerString ::= TEXTUAL-CONVENTION
Packit 022b05
    STATUS current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "This data type is used to model an administratively
Packit 022b05
        assigned name of the owner of a resource. Implementations
Packit 022b05
        must accept values composed of well-formed NVT ASCII
Packit 022b05
        sequences. In addition, implementations should accept
Packit 022b05
        values composed of well-formed UTF-8 sequences.
Packit 022b05
Packit 022b05
        It is suggested that this name contain one or more of
Packit 022b05
        the following: IP address, management station name,
Packit 022b05
        network manager's name, location, or phone number.
Packit 022b05
        In some cases the agent itself will be the owner of
Packit 022b05
        an entry.  In these cases, this string shall be set
Packit 022b05
        to a string starting with 'monitor'.
Packit 022b05
Packit 022b05
        SNMP access control is articulated entirely in terms
Packit 022b05
        of the contents of MIB views; access to a particular
Packit 022b05
        SNMP object instance depends only upon its presence
Packit 022b05
        or absence in a particular MIB view and never upon
Packit 022b05
        its value or the value of related object instances.
Packit 022b05
        Thus, objects of this type afford resolution of
Packit 022b05
        resource contention only among cooperating
Packit 022b05
        managers; they realize no access control function
Packit 022b05
        with respect to uncooperative parties."
Packit 022b05
    SYNTAX OCTET STRING (SIZE (0..127))
Packit 022b05
Packit 022b05
EntryStatus ::= TEXTUAL-CONVENTION
Packit 022b05
    STATUS current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The status of a table entry.
Packit 022b05
Packit 022b05
        Setting this object to the value invalid(4) has the
Packit 022b05
        effect of invalidating the corresponding entry.
Packit 022b05
        That is, it effectively disassociates the mapping
Packit 022b05
        identified with said entry.
Packit 022b05
        It is an implementation-specific matter as to whether
Packit 022b05
        the agent removes an invalidated entry from the table.
Packit 022b05
        Accordingly, management stations must be prepared to
Packit 022b05
        receive tabular information from agents that corresponds
Packit 022b05
        to entries currently not in use.  Proper
Packit 022b05
        interpretation of such entries requires examination
Packit 022b05
        of the relevant EntryStatus object.
Packit 022b05
Packit 022b05
        An existing instance of this object cannot be set to
Packit 022b05
        createRequest(2).  This object may only be set to
Packit 022b05
        createRequest(2) when this instance is created.  When
Packit 022b05
        this object is created, the agent may wish to create
Packit 022b05
        supplemental object instances with default values
Packit 022b05
        to complete a conceptual row in this table.  Because the
Packit 022b05
        creation of these default objects is entirely at the option
Packit 022b05
        of the agent, the manager must not assume that any will be
Packit 022b05
        created, but may make use of any that are created.
Packit 022b05
        Immediately after completing the create operation, the agent
Packit 022b05
        must set this object to underCreation(3).
Packit 022b05
Packit 022b05
        When in the underCreation(3) state, an entry is allowed to
Packit 022b05
        exist in a possibly incomplete, possibly inconsistent state,
Packit 022b05
        usually to allow it to be modified in multiple PDUs.  When in
Packit 022b05
        this state, an entry is not fully active.
Packit 022b05
        Entries shall exist in the underCreation(3) state until
Packit 022b05
        the management station is finished configuring the entry
Packit 022b05
        and sets this object to valid(1) or aborts, setting this
Packit 022b05
        object to invalid(4).  If the agent determines that an
Packit 022b05
        entry has been in the underCreation(3) state for an
Packit 022b05
        abnormally long time, it may decide that the management
Packit 022b05
        station has crashed.  If the agent makes this decision,
Packit 022b05
        it may set this object to invalid(4) to reclaim the
Packit 022b05
        entry.  A prudent agent will understand that the
Packit 022b05
        management station may need to wait for human input
Packit 022b05
        and will allow for that possibility in its
Packit 022b05
        determination of this abnormally long period.
Packit 022b05
Packit 022b05
        An entry in the valid(1) state is fully configured and
Packit 022b05
        consistent and fully represents the configuration or
Packit 022b05
        operation such a row is intended to represent.  For
Packit 022b05
        example, it could be a statistical function that is
Packit 022b05
        configured and active, or a filter that is available
Packit 022b05
        in the list of filters processed by the packet capture
Packit 022b05
        process.
Packit 022b05
Packit 022b05
        A manager is restricted to changing the state of an entry in
Packit 022b05
        the following ways:
Packit 022b05
Packit 022b05
             To:       valid  createRequest  underCreation  invalid
Packit 022b05
        From:
Packit 022b05
        valid             OK             NO             OK       OK
Packit 022b05
        createRequest    N/A            N/A            N/A      N/A
Packit 022b05
        underCreation     OK             NO             OK       OK
Packit 022b05
        invalid           NO             NO             NO       OK
Packit 022b05
        nonExistent       NO             OK             NO       OK
Packit 022b05
Packit 022b05
        In the table above, it is not applicable to move the state
Packit 022b05
        from the createRequest state to any other state because the
Packit 022b05
        manager will never find the variable in that state.  The
Packit 022b05
        nonExistent state is not a value of the enumeration, rather
Packit 022b05
        it means that the entryStatus variable does not exist at all.
Packit 022b05
        An agent may allow an entryStatus variable to change state in
Packit 022b05
        additional ways, so long as the semantics of the states are
Packit 022b05
        followed.  This allowance is made to ease the implementation of
Packit 022b05
        the agent and is made despite the fact that managers should
Packit 022b05
        never exercise these additional state transitions."
Packit 022b05
    SYNTAX INTEGER {
Packit 022b05
               valid(1),
Packit 022b05
               createRequest(2),
Packit 022b05
               underCreation(3),
Packit 022b05
               invalid(4)
Packit 022b05
           }
Packit 022b05
Packit 022b05
    statistics        OBJECT IDENTIFIER ::= { rmon 1 }
Packit 022b05
    history           OBJECT IDENTIFIER ::= { rmon 2 }
Packit 022b05
    alarm             OBJECT IDENTIFIER ::= { rmon 3 }
Packit 022b05
    hosts             OBJECT IDENTIFIER ::= { rmon 4 }
Packit 022b05
    hostTopN          OBJECT IDENTIFIER ::= { rmon 5 }
Packit 022b05
    matrix            OBJECT IDENTIFIER ::= { rmon 6 }
Packit 022b05
    filter            OBJECT IDENTIFIER ::= { rmon 7 }
Packit 022b05
    capture           OBJECT IDENTIFIER ::= { rmon 8 }
Packit 022b05
    event             OBJECT IDENTIFIER ::= { rmon 9 }
Packit 022b05
    rmonConformance   OBJECT IDENTIFIER ::= { rmon 20 }
Packit 022b05
Packit 022b05
-- The Ethernet Statistics Group
Packit 022b05
--
Packit 022b05
-- Implementation of the Ethernet Statistics group is optional.
Packit 022b05
-- Consult the MODULE-COMPLIANCE macro for the authoritative
Packit 022b05
-- conformance information for this MIB.
Packit 022b05
--
Packit 022b05
-- The ethernet statistics group contains statistics measured by the
Packit 022b05
-- probe for each monitored interface on this device.  These
Packit 022b05
-- statistics take the form of free running counters that start from
Packit 022b05
-- zero when a valid entry is created.
Packit 022b05
--
Packit 022b05
-- This group currently has statistics defined only for
Packit 022b05
-- Ethernet interfaces.  Each etherStatsEntry contains statistics
Packit 022b05
-- for one Ethernet interface.  The probe must create one
Packit 022b05
-- etherStats entry for each monitored Ethernet interface
Packit 022b05
-- on the device.
Packit 022b05
Packit 022b05
etherStatsTable OBJECT-TYPE
Packit 022b05
    SYNTAX     SEQUENCE OF EtherStatsEntry
Packit 022b05
    MAX-ACCESS not-accessible
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A list of Ethernet statistics entries."
Packit 022b05
    ::= { statistics 1 }
Packit 022b05
Packit 022b05
etherStatsEntry OBJECT-TYPE
Packit 022b05
    SYNTAX     EtherStatsEntry
Packit 022b05
    MAX-ACCESS not-accessible
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A collection of statistics kept for a particular
Packit 022b05
        Ethernet interface.  As an example, an instance of the
Packit 022b05
        etherStatsPkts object might be named etherStatsPkts.1"
Packit 022b05
    INDEX { etherStatsIndex }
Packit 022b05
    ::= { etherStatsTable 1 }
Packit 022b05
Packit 022b05
EtherStatsEntry ::= SEQUENCE {
Packit 022b05
    etherStatsIndex                    Integer32,
Packit 022b05
    etherStatsDataSource               OBJECT IDENTIFIER,
Packit 022b05
    etherStatsDropEvents               Counter32,
Packit 022b05
    etherStatsOctets                   Counter32,
Packit 022b05
    etherStatsPkts                     Counter32,
Packit 022b05
    etherStatsBroadcastPkts            Counter32,
Packit 022b05
    etherStatsMulticastPkts            Counter32,
Packit 022b05
    etherStatsCRCAlignErrors           Counter32,
Packit 022b05
    etherStatsUndersizePkts            Counter32,
Packit 022b05
    etherStatsOversizePkts             Counter32,
Packit 022b05
    etherStatsFragments                Counter32,
Packit 022b05
    etherStatsJabbers                  Counter32,
Packit 022b05
    etherStatsCollisions               Counter32,
Packit 022b05
    etherStatsPkts64Octets             Counter32,
Packit 022b05
    etherStatsPkts65to127Octets        Counter32,
Packit 022b05
    etherStatsPkts128to255Octets       Counter32,
Packit 022b05
    etherStatsPkts256to511Octets       Counter32,
Packit 022b05
    etherStatsPkts512to1023Octets      Counter32,
Packit 022b05
    etherStatsPkts1024to1518Octets     Counter32,
Packit 022b05
    etherStatsOwner                    OwnerString,
Packit 022b05
    etherStatsStatus                   EntryStatus
Packit 022b05
}
Packit 022b05
Packit 022b05
etherStatsIndex OBJECT-TYPE
Packit 022b05
    SYNTAX     Integer32 (1..65535)
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The value of this object uniquely identifies this
Packit 022b05
        etherStats entry."
Packit 022b05
    ::= { etherStatsEntry 1 }
Packit 022b05
Packit 022b05
etherStatsDataSource OBJECT-TYPE
Packit 022b05
    SYNTAX     OBJECT IDENTIFIER
Packit 022b05
    MAX-ACCESS read-create
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "This object identifies the source of the data that
Packit 022b05
        this etherStats entry is configured to analyze.  This
Packit 022b05
        source can be any ethernet interface on this device.
Packit 022b05
        In order to identify a particular interface, this object
Packit 022b05
        shall identify the instance of the ifIndex object,
Packit 022b05
        defined in RFC 2233 [17], for the desired interface.
Packit 022b05
        For example, if an entry were to receive data from
Packit 022b05
        interface #1, this object would be set to ifIndex.1.
Packit 022b05
Packit 022b05
        The statistics in this group reflect all packets
Packit 022b05
        on the local network segment attached to the identified
Packit 022b05
        interface.
Packit 022b05
Packit 022b05
        An agent may or may not be able to tell if fundamental
Packit 022b05
        changes to the media of the interface have occurred and
Packit 022b05
        necessitate an invalidation of this entry.  For example, a
Packit 022b05
        hot-pluggable ethernet card could be pulled out and replaced
Packit 022b05
        by a token-ring card.  In such a case, if the agent has such
Packit 022b05
        knowledge of the change, it is recommended that it
Packit 022b05
        invalidate this entry.
Packit 022b05
Packit 022b05
        This object may not be modified if the associated
Packit 022b05
        etherStatsStatus object is equal to valid(1)."
Packit 022b05
    ::= { etherStatsEntry 2 }
Packit 022b05
Packit 022b05
etherStatsDropEvents OBJECT-TYPE
Packit 022b05
    SYNTAX     Counter32
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The total number of events in which packets
Packit 022b05
        were dropped by the probe due to lack of resources.
Packit 022b05
        Note that this number is not necessarily the number of
Packit 022b05
        packets dropped; it is just the number of times this
Packit 022b05
        condition has been detected."
Packit 022b05
    ::= { etherStatsEntry 3 }
Packit 022b05
Packit 022b05
etherStatsOctets OBJECT-TYPE
Packit 022b05
    SYNTAX     Counter32
Packit 022b05
    UNITS      "Octets"
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The total number of octets of data (including
Packit 022b05
        those in bad packets) received on the
Packit 022b05
        network (excluding framing bits but including
Packit 022b05
        FCS octets).
Packit 022b05
        This object can be used as a reasonable estimate of
Packit 022b05
        10-Megabit ethernet utilization.  If greater precision is
Packit 022b05
        desired, the etherStatsPkts and etherStatsOctets objects
Packit 022b05
        should be sampled before and after a common interval.  The
Packit 022b05
        differences in the sampled values are Pkts and Octets,
Packit 022b05
        respectively, and the number of seconds in the interval is
Packit 022b05
        Interval.  These values are used to calculate the Utilization
Packit 022b05
        as follows:
Packit 022b05
Packit 022b05
                         Pkts * (9.6 + 6.4) + (Octets * .8)
Packit 022b05
         Utilization = -------------------------------------
Packit 022b05
                                 Interval * 10,000
Packit 022b05
Packit 022b05
        The result of this equation is the value Utilization which
Packit 022b05
        is the percent utilization of the ethernet segment on a
Packit 022b05
        scale of 0 to 100 percent."
Packit 022b05
    ::= { etherStatsEntry 4 }
Packit 022b05
Packit 022b05
etherStatsPkts OBJECT-TYPE
Packit 022b05
    SYNTAX     Counter32
Packit 022b05
    UNITS      "Packets"
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The total number of packets (including bad packets,
Packit 022b05
        broadcast packets, and multicast packets) received."
Packit 022b05
    ::= { etherStatsEntry 5 }
Packit 022b05
Packit 022b05
etherStatsBroadcastPkts OBJECT-TYPE
Packit 022b05
    SYNTAX     Counter32
Packit 022b05
    UNITS      "Packets"
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The total number of good packets received that were
Packit 022b05
        directed to the broadcast address.  Note that this
Packit 022b05
        does not include multicast packets."
Packit 022b05
    ::= { etherStatsEntry 6 }
Packit 022b05
Packit 022b05
etherStatsMulticastPkts OBJECT-TYPE
Packit 022b05
    SYNTAX     Counter32
Packit 022b05
    UNITS      "Packets"
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The total number of good packets received that were
Packit 022b05
        directed to a multicast address.  Note that this number
Packit 022b05
        does not include packets directed to the broadcast
Packit 022b05
        address."
Packit 022b05
    ::= { etherStatsEntry 7 }
Packit 022b05
Packit 022b05
etherStatsCRCAlignErrors OBJECT-TYPE
Packit 022b05
    SYNTAX     Counter32
Packit 022b05
    UNITS      "Packets"
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The total number of packets received that
Packit 022b05
        had a length (excluding framing bits, but
Packit 022b05
        including FCS octets) of between 64 and 1518
Packit 022b05
        octets, inclusive, but had either a bad
Packit 022b05
        Frame Check Sequence (FCS) with an integral
Packit 022b05
        number of octets (FCS Error) or a bad FCS with
Packit 022b05
        a non-integral number of octets (Alignment Error)."
Packit 022b05
    ::= { etherStatsEntry 8 }
Packit 022b05
Packit 022b05
etherStatsUndersizePkts OBJECT-TYPE
Packit 022b05
    SYNTAX     Counter32
Packit 022b05
    UNITS      "Packets"
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The total number of packets received that were
Packit 022b05
        less than 64 octets long (excluding framing bits,
Packit 022b05
        but including FCS octets) and were otherwise well
Packit 022b05
        formed."
Packit 022b05
    ::= { etherStatsEntry 9 }
Packit 022b05
Packit 022b05
etherStatsOversizePkts OBJECT-TYPE
Packit 022b05
    SYNTAX     Counter32
Packit 022b05
    UNITS      "Packets"
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The total number of packets received that were
Packit 022b05
        longer than 1518 octets (excluding framing bits,
Packit 022b05
        but including FCS octets) and were otherwise
Packit 022b05
        well formed."
Packit 022b05
    ::= { etherStatsEntry 10 }
Packit 022b05
Packit 022b05
etherStatsFragments OBJECT-TYPE
Packit 022b05
    SYNTAX     Counter32
Packit 022b05
    UNITS      "Packets"
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The total number of packets received that were less than
Packit 022b05
        64 octets in length (excluding framing bits but including
Packit 022b05
        FCS octets) and had either a bad Frame Check Sequence
Packit 022b05
        (FCS) with an integral number of octets (FCS Error) or a
Packit 022b05
        bad FCS with a non-integral number of octets (Alignment
Packit 022b05
        Error).
Packit 022b05
Packit 022b05
        Note that it is entirely normal for etherStatsFragments to
Packit 022b05
        increment.  This is because it counts both runts (which are
Packit 022b05
        normal occurrences due to collisions) and noise hits."
Packit 022b05
    ::= { etherStatsEntry 11 }
Packit 022b05
Packit 022b05
etherStatsJabbers OBJECT-TYPE
Packit 022b05
    SYNTAX     Counter32
Packit 022b05
    UNITS      "Packets"
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The total number of packets received that were
Packit 022b05
        longer than 1518 octets (excluding framing bits,
Packit 022b05
        but including FCS octets), and had either a bad
Packit 022b05
        Frame Check Sequence (FCS) with an integral number
Packit 022b05
        of octets (FCS Error) or a bad FCS with a non-integral
Packit 022b05
        number of octets (Alignment Error).
Packit 022b05
Packit 022b05
        Note that this definition of jabber is different
Packit 022b05
        than the definition in IEEE-802.3 section 8.2.1.5
Packit 022b05
        (10BASE5) and section 10.3.1.4 (10BASE2).  These
Packit 022b05
        documents define jabber as the condition where any
Packit 022b05
        packet exceeds 20 ms.  The allowed range to detect
Packit 022b05
        jabber is between 20 ms and 150 ms."
Packit 022b05
    ::= { etherStatsEntry 12 }
Packit 022b05
Packit 022b05
etherStatsCollisions OBJECT-TYPE
Packit 022b05
    SYNTAX     Counter32
Packit 022b05
    UNITS      "Collisions"
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The best estimate of the total number of collisions
Packit 022b05
        on this Ethernet segment.
Packit 022b05
Packit 022b05
        The value returned will depend on the location of the
Packit 022b05
        RMON probe. Section 8.2.1.3 (10BASE-5) and section
Packit 022b05
        10.3.1.3 (10BASE-2) of IEEE standard 802.3 states that a
Packit 022b05
        station must detect a collision, in the receive mode, if
Packit 022b05
        three or more stations are transmitting simultaneously.  A
Packit 022b05
        repeater port must detect a collision when two or more
Packit 022b05
        stations are transmitting simultaneously.  Thus a probe
Packit 022b05
        placed on a repeater port could record more collisions
Packit 022b05
        than a probe connected to a station on the same segment
Packit 022b05
        would.
Packit 022b05
Packit 022b05
        Probe location plays a much smaller role when considering
Packit 022b05
        10BASE-T.  14.2.1.4 (10BASE-T) of IEEE standard 802.3
Packit 022b05
        defines a collision as the simultaneous presence of signals
Packit 022b05
        on the DO and RD circuits (transmitting and receiving
Packit 022b05
        at the same time).  A 10BASE-T station can only detect
Packit 022b05
        collisions when it is transmitting.  Thus probes placed on
Packit 022b05
        a station and a repeater, should report the same number of
Packit 022b05
        collisions.
Packit 022b05
Packit 022b05
        Note also that an RMON probe inside a repeater should
Packit 022b05
        ideally report collisions between the repeater and one or
Packit 022b05
        more other hosts (transmit collisions as defined by IEEE
Packit 022b05
        802.3k) plus receiver collisions observed on any coax
Packit 022b05
        segments to which the repeater is connected."
Packit 022b05
    ::= { etherStatsEntry 13 }
Packit 022b05
Packit 022b05
etherStatsPkts64Octets OBJECT-TYPE
Packit 022b05
    SYNTAX     Counter32
Packit 022b05
    UNITS      "Packets"
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The total number of packets (including bad
Packit 022b05
        packets) received that were 64 octets in length
Packit 022b05
        (excluding framing bits but including FCS octets)."
Packit 022b05
    ::= { etherStatsEntry 14 }
Packit 022b05
Packit 022b05
etherStatsPkts65to127Octets OBJECT-TYPE
Packit 022b05
    SYNTAX     Counter32
Packit 022b05
    UNITS      "Packets"
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The total number of packets (including bad
Packit 022b05
        packets) received that were between
Packit 022b05
        65 and 127 octets in length inclusive
Packit 022b05
        (excluding framing bits but including FCS octets)."
Packit 022b05
    ::= { etherStatsEntry 15 }
Packit 022b05
Packit 022b05
etherStatsPkts128to255Octets OBJECT-TYPE
Packit 022b05
    SYNTAX     Counter32
Packit 022b05
    UNITS      "Packets"
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The total number of packets (including bad
Packit 022b05
        packets) received that were between
Packit 022b05
        128 and 255 octets in length inclusive
Packit 022b05
        (excluding framing bits but including FCS octets)."
Packit 022b05
    ::= { etherStatsEntry 16 }
Packit 022b05
Packit 022b05
etherStatsPkts256to511Octets OBJECT-TYPE
Packit 022b05
    SYNTAX     Counter32
Packit 022b05
    UNITS      "Packets"
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The total number of packets (including bad
Packit 022b05
        packets) received that were between
Packit 022b05
        256 and 511 octets in length inclusive
Packit 022b05
        (excluding framing bits but including FCS octets)."
Packit 022b05
    ::= { etherStatsEntry 17 }
Packit 022b05
Packit 022b05
etherStatsPkts512to1023Octets OBJECT-TYPE
Packit 022b05
    SYNTAX     Counter32
Packit 022b05
    UNITS      "Packets"
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The total number of packets (including bad
Packit 022b05
        packets) received that were between
Packit 022b05
        512 and 1023 octets in length inclusive
Packit 022b05
        (excluding framing bits but including FCS octets)."
Packit 022b05
    ::= { etherStatsEntry 18 }
Packit 022b05
Packit 022b05
etherStatsPkts1024to1518Octets OBJECT-TYPE
Packit 022b05
    SYNTAX     Counter32
Packit 022b05
    UNITS      "Packets"
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The total number of packets (including bad
Packit 022b05
        packets) received that were between
Packit 022b05
        1024 and 1518 octets in length inclusive
Packit 022b05
        (excluding framing bits but including FCS octets)."
Packit 022b05
    ::= { etherStatsEntry 19 }
Packit 022b05
Packit 022b05
etherStatsOwner OBJECT-TYPE
Packit 022b05
    SYNTAX     OwnerString
Packit 022b05
    MAX-ACCESS read-create
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The entity that configured this entry and is therefore
Packit 022b05
        using the resources assigned to it."
Packit 022b05
    ::= { etherStatsEntry 20 }
Packit 022b05
Packit 022b05
etherStatsStatus OBJECT-TYPE
Packit 022b05
    SYNTAX     EntryStatus
Packit 022b05
    MAX-ACCESS read-create
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The status of this etherStats entry."
Packit 022b05
    ::= { etherStatsEntry 21 }
Packit 022b05
Packit 022b05
-- The History Control Group
Packit 022b05
Packit 022b05
-- Implementation of the History Control group is optional.
Packit 022b05
-- Consult the MODULE-COMPLIANCE macro for the authoritative
Packit 022b05
-- conformance information for this MIB.
Packit 022b05
--
Packit 022b05
-- The history control group controls the periodic statistical
Packit 022b05
-- sampling of data from various types of networks.  The
Packit 022b05
-- historyControlTable stores configuration entries that each
Packit 022b05
-- define an interface, polling period, and other parameters.
Packit 022b05
-- Once samples are taken, their data is stored in an entry
Packit 022b05
-- in a media-specific table.  Each such entry defines one
Packit 022b05
-- sample, and is associated with the historyControlEntry that
Packit 022b05
-- caused the sample to be taken.  Each counter in the
Packit 022b05
-- etherHistoryEntry counts the same event as its similarly-named
Packit 022b05
-- counterpart in the etherStatsEntry, except that each value here
Packit 022b05
-- is a cumulative sum during a sampling period.
Packit 022b05
--
Packit 022b05
-- If the probe keeps track of the time of day, it should start
Packit 022b05
-- the first sample of the history at a time such that
Packit 022b05
-- when the next hour of the day begins, a sample is
Packit 022b05
-- started at that instant.  This tends to make more
Packit 022b05
-- user-friendly reports, and enables comparison of reports
Packit 022b05
-- from different probes that have relatively accurate time
Packit 022b05
-- of day.
Packit 022b05
--
Packit 022b05
-- The probe is encouraged to add two history control entries
Packit 022b05
-- per monitored interface upon initialization that describe a short
Packit 022b05
-- term and a long term polling period.  Suggested parameters are 30
Packit 022b05
-- seconds for the short term polling period and 30 minutes for
Packit 022b05
-- the long term period.
Packit 022b05
Packit 022b05
historyControlTable OBJECT-TYPE
Packit 022b05
    SYNTAX     SEQUENCE OF HistoryControlEntry
Packit 022b05
    MAX-ACCESS not-accessible
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A list of history control entries."
Packit 022b05
    ::= { history 1 }
Packit 022b05
Packit 022b05
historyControlEntry OBJECT-TYPE
Packit 022b05
    SYNTAX     HistoryControlEntry
Packit 022b05
    MAX-ACCESS not-accessible
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A list of parameters that set up a periodic sampling of
Packit 022b05
        statistics.  As an example, an instance of the
Packit 022b05
        historyControlInterval object might be named
Packit 022b05
        historyControlInterval.2"
Packit 022b05
    INDEX { historyControlIndex }
Packit 022b05
    ::= { historyControlTable 1 }
Packit 022b05
Packit 022b05
HistoryControlEntry ::= SEQUENCE {
Packit 022b05
    historyControlIndex             Integer32,
Packit 022b05
    historyControlDataSource        OBJECT IDENTIFIER,
Packit 022b05
    historyControlBucketsRequested  Integer32,
Packit 022b05
    historyControlBucketsGranted    Integer32,
Packit 022b05
    historyControlInterval          Integer32,
Packit 022b05
    historyControlOwner             OwnerString,
Packit 022b05
    historyControlStatus            EntryStatus
Packit 022b05
}
Packit 022b05
Packit 022b05
historyControlIndex OBJECT-TYPE
Packit 022b05
    SYNTAX     Integer32 (1..65535)
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "An index that uniquely identifies an entry in the
Packit 022b05
        historyControl table.  Each such entry defines a
Packit 022b05
        set of samples at a particular interval for an
Packit 022b05
        interface on the device."
Packit 022b05
    ::= { historyControlEntry 1 }
Packit 022b05
Packit 022b05
historyControlDataSource OBJECT-TYPE
Packit 022b05
    SYNTAX     OBJECT IDENTIFIER
Packit 022b05
    MAX-ACCESS read-create
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "This object identifies the source of the data for
Packit 022b05
        which historical data was collected and
Packit 022b05
        placed in a media-specific table on behalf of this
Packit 022b05
        historyControlEntry.  This source can be any
Packit 022b05
        interface on this device.  In order to identify
Packit 022b05
        a particular interface, this object shall identify
Packit 022b05
        the instance of the ifIndex object, defined
Packit 022b05
        in  RFC 2233 [17], for the desired interface.
Packit 022b05
        For example, if an entry were to receive data from
Packit 022b05
        interface #1, this object would be set to ifIndex.1.
Packit 022b05
Packit 022b05
        The statistics in this group reflect all packets
Packit 022b05
        on the local network segment attached to the identified
Packit 022b05
        interface.
Packit 022b05
Packit 022b05
        An agent may or may not be able to tell if fundamental
Packit 022b05
        changes to the media of the interface have occurred and
Packit 022b05
        necessitate an invalidation of this entry.  For example, a
Packit 022b05
        hot-pluggable ethernet card could be pulled out and replaced
Packit 022b05
        by a token-ring card.  In such a case, if the agent has such
Packit 022b05
        knowledge of the change, it is recommended that it
Packit 022b05
        invalidate this entry.
Packit 022b05
Packit 022b05
        This object may not be modified if the associated
Packit 022b05
        historyControlStatus object is equal to valid(1)."
Packit 022b05
    ::= { historyControlEntry 2 }
Packit 022b05
Packit 022b05
historyControlBucketsRequested OBJECT-TYPE
Packit 022b05
    SYNTAX     Integer32 (1..65535)
Packit 022b05
    MAX-ACCESS read-create
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The requested number of discrete time intervals
Packit 022b05
        over which data is to be saved in the part of the
Packit 022b05
        media-specific table associated with this
Packit 022b05
        historyControlEntry.
Packit 022b05
Packit 022b05
        When this object is created or modified, the probe
Packit 022b05
        should set historyControlBucketsGranted as closely to
Packit 022b05
        this object as is possible for the particular probe
Packit 022b05
        implementation and available resources."
Packit 022b05
    DEFVAL { 50 }
Packit 022b05
    ::= { historyControlEntry 3 }
Packit 022b05
Packit 022b05
historyControlBucketsGranted OBJECT-TYPE
Packit 022b05
    SYNTAX     Integer32 (1..65535)
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The number of discrete sampling intervals
Packit 022b05
        over which data shall be saved in the part of
Packit 022b05
        the media-specific table associated with this
Packit 022b05
        historyControlEntry.
Packit 022b05
        When the associated historyControlBucketsRequested
Packit 022b05
        object is created or modified, the probe
Packit 022b05
        should set this object as closely to the requested
Packit 022b05
        value as is possible for the particular
Packit 022b05
        probe implementation and available resources.  The
Packit 022b05
        probe must not lower this value except as a result
Packit 022b05
        of a modification to the associated
Packit 022b05
        historyControlBucketsRequested object.
Packit 022b05
Packit 022b05
        There will be times when the actual number of
Packit 022b05
        buckets associated with this entry is less than
Packit 022b05
        the value of this object.  In this case, at the
Packit 022b05
        end of each sampling interval, a new bucket will
Packit 022b05
        be added to the media-specific table.
Packit 022b05
Packit 022b05
        When the number of buckets reaches the value of
Packit 022b05
        this object and a new bucket is to be added to the
Packit 022b05
        media-specific table, the oldest bucket associated
Packit 022b05
        with this historyControlEntry shall be deleted by
Packit 022b05
        the agent so that the new bucket can be added.
Packit 022b05
Packit 022b05
        When the value of this object changes to a value less
Packit 022b05
        than the current value, entries are deleted
Packit 022b05
        from the media-specific table associated with this
Packit 022b05
        historyControlEntry.  Enough of the oldest of these
Packit 022b05
        entries shall be deleted by the agent so that their
Packit 022b05
        number remains less than or equal to the new value of
Packit 022b05
        this object.
Packit 022b05
Packit 022b05
        When the value of this object changes to a value greater
Packit 022b05
        than the current value, the number of associated media-
Packit 022b05
        specific entries may be allowed to grow."
Packit 022b05
    ::= { historyControlEntry 4 }
Packit 022b05
Packit 022b05
historyControlInterval OBJECT-TYPE
Packit 022b05
    SYNTAX     Integer32 (1..3600)
Packit 022b05
    UNITS      "Seconds"
Packit 022b05
    MAX-ACCESS read-create
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The interval in seconds over which the data is
Packit 022b05
        sampled for each bucket in the part of the
Packit 022b05
        media-specific table associated with this
Packit 022b05
        historyControlEntry.  This interval can
Packit 022b05
        be set to any number of seconds between 1 and
Packit 022b05
        3600 (1 hour).
Packit 022b05
Packit 022b05
        Because the counters in a bucket may overflow at their
Packit 022b05
        maximum value with no indication, a prudent manager will
Packit 022b05
        take into account the possibility of overflow in any of
Packit 022b05
        the associated counters.  It is important to consider the
Packit 022b05
        minimum time in which any counter could overflow on a
Packit 022b05
        particular media type and set the historyControlInterval
Packit 022b05
        object to a value less than this interval.  This is
Packit 022b05
        typically most important for the 'octets' counter in any
Packit 022b05
        media-specific table.  For example, on an Ethernet
Packit 022b05
        network, the etherHistoryOctets counter could overflow
Packit 022b05
        in about one hour at the Ethernet's maximum
Packit 022b05
        utilization.
Packit 022b05
Packit 022b05
        This object may not be modified if the associated
Packit 022b05
        historyControlStatus object is equal to valid(1)."
Packit 022b05
    DEFVAL { 1800 }
Packit 022b05
    ::= { historyControlEntry 5 }
Packit 022b05
Packit 022b05
historyControlOwner OBJECT-TYPE
Packit 022b05
    SYNTAX     OwnerString
Packit 022b05
    MAX-ACCESS read-create
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The entity that configured this entry and is therefore
Packit 022b05
        using the resources assigned to it."
Packit 022b05
    ::= { historyControlEntry 6 }
Packit 022b05
Packit 022b05
historyControlStatus OBJECT-TYPE
Packit 022b05
    SYNTAX     EntryStatus
Packit 022b05
    MAX-ACCESS read-create
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The status of this historyControl entry.
Packit 022b05
Packit 022b05
        Each instance of the media-specific table associated
Packit 022b05
        with this historyControlEntry will be deleted by the agent
Packit 022b05
        if this historyControlEntry is not equal to valid(1)."
Packit 022b05
    ::= { historyControlEntry 7 }
Packit 022b05
Packit 022b05
-- The Ethernet History Group
Packit 022b05
Packit 022b05
-- Implementation of the Ethernet History group is optional.
Packit 022b05
-- Consult the MODULE-COMPLIANCE macro for the authoritative
Packit 022b05
-- conformance information for this MIB.
Packit 022b05
--
Packit 022b05
-- The Ethernet History group records periodic statistical samples
Packit 022b05
-- from a network and stores them for later retrieval.
Packit 022b05
-- Once samples are taken, their data is stored in an entry
Packit 022b05
-- in a media-specific table.  Each such entry defines one
Packit 022b05
Packit 022b05
-- sample, and is associated with the historyControlEntry that
Packit 022b05
-- caused the sample to be taken.  This group defines the
Packit 022b05
-- etherHistoryTable, for Ethernet networks.
Packit 022b05
--
Packit 022b05
Packit 022b05
etherHistoryTable OBJECT-TYPE
Packit 022b05
    SYNTAX     SEQUENCE OF EtherHistoryEntry
Packit 022b05
    MAX-ACCESS not-accessible
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A list of Ethernet history entries."
Packit 022b05
    ::= { history 2 }
Packit 022b05
Packit 022b05
etherHistoryEntry OBJECT-TYPE
Packit 022b05
    SYNTAX     EtherHistoryEntry
Packit 022b05
    MAX-ACCESS not-accessible
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "An historical sample of Ethernet statistics on a particular
Packit 022b05
        Ethernet interface.  This sample is associated with the
Packit 022b05
        historyControlEntry which set up the parameters for
Packit 022b05
        a regular collection of these samples.  As an example, an
Packit 022b05
        instance of the etherHistoryPkts object might be named
Packit 022b05
        etherHistoryPkts.2.89"
Packit 022b05
    INDEX { etherHistoryIndex , etherHistorySampleIndex }
Packit 022b05
    ::= { etherHistoryTable 1 }
Packit 022b05
Packit 022b05
EtherHistoryEntry ::= SEQUENCE {
Packit 022b05
    etherHistoryIndex                 Integer32,
Packit 022b05
    etherHistorySampleIndex           Integer32,
Packit 022b05
    etherHistoryIntervalStart         TimeTicks,
Packit 022b05
    etherHistoryDropEvents            Counter32,
Packit 022b05
    etherHistoryOctets                Counter32,
Packit 022b05
    etherHistoryPkts                  Counter32,
Packit 022b05
    etherHistoryBroadcastPkts         Counter32,
Packit 022b05
    etherHistoryMulticastPkts         Counter32,
Packit 022b05
    etherHistoryCRCAlignErrors        Counter32,
Packit 022b05
    etherHistoryUndersizePkts         Counter32,
Packit 022b05
    etherHistoryOversizePkts          Counter32,
Packit 022b05
    etherHistoryFragments             Counter32,
Packit 022b05
    etherHistoryJabbers               Counter32,
Packit 022b05
    etherHistoryCollisions            Counter32,
Packit 022b05
    etherHistoryUtilization           Integer32
Packit 022b05
}
Packit 022b05
Packit 022b05
etherHistoryIndex OBJECT-TYPE
Packit 022b05
    SYNTAX     Integer32 (1..65535)
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The history of which this entry is a part.  The
Packit 022b05
        history identified by a particular value of this
Packit 022b05
        index is the same history as identified
Packit 022b05
        by the same value of historyControlIndex."
Packit 022b05
    ::= { etherHistoryEntry 1 }
Packit 022b05
Packit 022b05
etherHistorySampleIndex OBJECT-TYPE
Packit 022b05
    SYNTAX     Integer32 (1..2147483647)
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "An index that uniquely identifies the particular
Packit 022b05
        sample this entry represents among all samples
Packit 022b05
        associated with the same historyControlEntry.
Packit 022b05
        This index starts at 1 and increases by one
Packit 022b05
        as each new sample is taken."
Packit 022b05
    ::= { etherHistoryEntry 2 }
Packit 022b05
Packit 022b05
etherHistoryIntervalStart OBJECT-TYPE
Packit 022b05
    SYNTAX     TimeTicks
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The value of sysUpTime at the start of the interval
Packit 022b05
        over which this sample was measured.  If the probe
Packit 022b05
        keeps track of the time of day, it should start
Packit 022b05
        the first sample of the history at a time such that
Packit 022b05
        when the next hour of the day begins, a sample is
Packit 022b05
        started at that instant.  Note that following this
Packit 022b05
        rule may require the probe to delay collecting the
Packit 022b05
        first sample of the history, as each sample must be
Packit 022b05
        of the same interval.  Also note that the sample which
Packit 022b05
        is currently being collected is not accessible in this
Packit 022b05
        table until the end of its interval."
Packit 022b05
    ::= { etherHistoryEntry 3 }
Packit 022b05
Packit 022b05
etherHistoryDropEvents OBJECT-TYPE
Packit 022b05
    SYNTAX     Counter32
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The total number of events in which packets
Packit 022b05
        were dropped by the probe due to lack of resources
Packit 022b05
        during this sampling interval.  Note that this number
Packit 022b05
        is not necessarily the number of packets dropped, it
Packit 022b05
        is just the number of times this condition has been
Packit 022b05
        detected."
Packit 022b05
    ::= { etherHistoryEntry 4 }
Packit 022b05
Packit 022b05
etherHistoryOctets OBJECT-TYPE
Packit 022b05
    SYNTAX     Counter32
Packit 022b05
    UNITS      "Octets"
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The total number of octets of data (including
Packit 022b05
        those in bad packets) received on the
Packit 022b05
        network (excluding framing bits but including
Packit 022b05
        FCS octets)."
Packit 022b05
    ::= { etherHistoryEntry 5 }
Packit 022b05
Packit 022b05
etherHistoryPkts OBJECT-TYPE
Packit 022b05
    SYNTAX     Counter32
Packit 022b05
    UNITS      "Packets"
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The number of packets (including bad packets)
Packit 022b05
        received during this sampling interval."
Packit 022b05
    ::= { etherHistoryEntry 6 }
Packit 022b05
Packit 022b05
etherHistoryBroadcastPkts OBJECT-TYPE
Packit 022b05
    SYNTAX     Counter32
Packit 022b05
    UNITS      "Packets"
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The number of good packets received during this
Packit 022b05
        sampling interval that were directed to the
Packit 022b05
        broadcast address."
Packit 022b05
    ::= { etherHistoryEntry 7 }
Packit 022b05
Packit 022b05
etherHistoryMulticastPkts OBJECT-TYPE
Packit 022b05
    SYNTAX     Counter32
Packit 022b05
    UNITS      "Packets"
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The number of good packets received during this
Packit 022b05
        sampling interval that were directed to a
Packit 022b05
        multicast address.  Note that this number does not
Packit 022b05
        include packets addressed to the broadcast address."
Packit 022b05
    ::= { etherHistoryEntry 8 }
Packit 022b05
Packit 022b05
etherHistoryCRCAlignErrors OBJECT-TYPE
Packit 022b05
    SYNTAX     Counter32
Packit 022b05
    UNITS      "Packets"
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The number of packets received during this
Packit 022b05
        sampling interval that had a length (excluding
Packit 022b05
        framing bits but including FCS octets) between
Packit 022b05
        64 and 1518 octets, inclusive, but had either a bad Frame
Packit 022b05
        Check Sequence (FCS) with an integral number of octets
Packit 022b05
        (FCS Error) or a bad FCS with a non-integral number
Packit 022b05
        of octets (Alignment Error)."
Packit 022b05
    ::= { etherHistoryEntry 9 }
Packit 022b05
Packit 022b05
etherHistoryUndersizePkts OBJECT-TYPE
Packit 022b05
    SYNTAX     Counter32
Packit 022b05
    UNITS      "Packets"
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The number of packets received during this
Packit 022b05
        sampling interval that were less than 64 octets
Packit 022b05
        long (excluding framing bits but including FCS
Packit 022b05
        octets) and were otherwise well formed."
Packit 022b05
    ::= { etherHistoryEntry 10 }
Packit 022b05
Packit 022b05
etherHistoryOversizePkts OBJECT-TYPE
Packit 022b05
    SYNTAX     Counter32
Packit 022b05
    UNITS      "Packets"
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The number of packets received during this
Packit 022b05
        sampling interval that were longer than 1518
Packit 022b05
        octets (excluding framing bits but including
Packit 022b05
        FCS octets) but were otherwise well formed."
Packit 022b05
    ::= { etherHistoryEntry 11 }
Packit 022b05
Packit 022b05
etherHistoryFragments OBJECT-TYPE
Packit 022b05
    SYNTAX     Counter32
Packit 022b05
    UNITS      "Packets"
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The total number of packets received during this
Packit 022b05
        sampling interval that were less than 64 octets in
Packit 022b05
        length (excluding framing bits but including FCS
Packit 022b05
        octets) had either a bad Frame Check Sequence (FCS)
Packit 022b05
        with an integral number of octets (FCS Error) or a bad
Packit 022b05
        FCS with a non-integral number of octets (Alignment
Packit 022b05
        Error).
Packit 022b05
Packit 022b05
        Note that it is entirely normal for etherHistoryFragments to
Packit 022b05
        increment.  This is because it counts both runts (which are
Packit 022b05
        normal occurrences due to collisions) and noise hits."
Packit 022b05
    ::= { etherHistoryEntry 12 }
Packit 022b05
Packit 022b05
etherHistoryJabbers OBJECT-TYPE
Packit 022b05
    SYNTAX     Counter32
Packit 022b05
    UNITS      "Packets"
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The number of packets received during this
Packit 022b05
        sampling interval that were longer than 1518 octets
Packit 022b05
        (excluding framing bits but including FCS octets),
Packit 022b05
        and  had either a bad Frame Check Sequence (FCS)
Packit 022b05
        with an integral number of octets (FCS Error) or
Packit 022b05
        a bad FCS with a non-integral number of octets
Packit 022b05
        (Alignment Error).
Packit 022b05
Packit 022b05
        Note that this definition of jabber is different
Packit 022b05
        than the definition in IEEE-802.3 section 8.2.1.5
Packit 022b05
        (10BASE5) and section 10.3.1.4 (10BASE2).  These
Packit 022b05
        documents define jabber as the condition where any
Packit 022b05
        packet exceeds 20 ms.  The allowed range to detect
Packit 022b05
        jabber is between 20 ms and 150 ms."
Packit 022b05
    ::= { etherHistoryEntry 13 }
Packit 022b05
Packit 022b05
etherHistoryCollisions OBJECT-TYPE
Packit 022b05
    SYNTAX     Counter32
Packit 022b05
    UNITS      "Collisions"
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The best estimate of the total number of collisions
Packit 022b05
        on this Ethernet segment during this sampling
Packit 022b05
        interval.
Packit 022b05
Packit 022b05
        The value returned will depend on the location of the
Packit 022b05
        RMON probe. Section 8.2.1.3 (10BASE-5) and section
Packit 022b05
        10.3.1.3 (10BASE-2) of IEEE standard 802.3 states that a
Packit 022b05
        station must detect a collision, in the receive mode, if
Packit 022b05
        three or more stations are transmitting simultaneously.  A
Packit 022b05
        repeater port must detect a collision when two or more
Packit 022b05
        stations are transmitting simultaneously.  Thus a probe
Packit 022b05
        placed on a repeater port could record more collisions
Packit 022b05
        than a probe connected to a station on the same segment
Packit 022b05
        would.
Packit 022b05
Packit 022b05
        Probe location plays a much smaller role when considering
Packit 022b05
        10BASE-T.  14.2.1.4 (10BASE-T) of IEEE standard 802.3
Packit 022b05
        defines a collision as the simultaneous presence of signals
Packit 022b05
        on the DO and RD circuits (transmitting and receiving
Packit 022b05
        at the same time).  A 10BASE-T station can only detect
Packit 022b05
        collisions when it is transmitting.  Thus probes placed on
Packit 022b05
        a station and a repeater, should report the same number of
Packit 022b05
        collisions.
Packit 022b05
Packit 022b05
        Note also that an RMON probe inside a repeater should
Packit 022b05
        ideally report collisions between the repeater and one or
Packit 022b05
        more other hosts (transmit collisions as defined by IEEE
Packit 022b05
        802.3k) plus receiver collisions observed on any coax
Packit 022b05
        segments to which the repeater is connected."
Packit 022b05
    ::= { etherHistoryEntry 14 }
Packit 022b05
Packit 022b05
etherHistoryUtilization OBJECT-TYPE
Packit 022b05
    SYNTAX     Integer32 (0..10000)
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The best estimate of the mean physical layer
Packit 022b05
        network utilization on this interface during this
Packit 022b05
        sampling interval, in hundredths of a percent."
Packit 022b05
    ::= { etherHistoryEntry 15 }
Packit 022b05
Packit 022b05
-- The Alarm Group
Packit 022b05
Packit 022b05
-- Implementation of the Alarm group is optional. The Alarm Group
Packit 022b05
-- requires the implementation of the Event group.
Packit 022b05
-- Consult the MODULE-COMPLIANCE macro for the authoritative
Packit 022b05
-- conformance information for this MIB.
Packit 022b05
--
Packit 022b05
-- The Alarm group periodically takes statistical samples from
Packit 022b05
-- variables in the probe and compares them to thresholds that have
Packit 022b05
-- been configured.  The alarm table stores configuration
Packit 022b05
-- entries that each define a variable, polling period, and
Packit 022b05
-- threshold parameters.  If a sample is found to cross the
Packit 022b05
-- threshold values, an event is generated.  Only variables that
Packit 022b05
-- resolve to an ASN.1 primitive type of INTEGER (INTEGER, Integer32,
Packit 022b05
-- Counter32, Counter64, Gauge32, or TimeTicks) may be monitored in
Packit 022b05
-- this way.
Packit 022b05
--
Packit 022b05
Packit 022b05
-- This function has a hysteresis mechanism to limit the generation
Packit 022b05
-- of events.  This mechanism generates one event as a threshold
Packit 022b05
-- is crossed in the appropriate direction.  No more events are
Packit 022b05
-- generated for that threshold until the opposite threshold is
Packit 022b05
-- crossed.
Packit 022b05
--
Packit 022b05
-- In the case of a sampling a deltaValue, a probe may implement
Packit 022b05
-- this mechanism with more precision if it takes a delta sample
Packit 022b05
-- twice per period, each time comparing the sum of the latest two
Packit 022b05
-- samples to the threshold.  This allows the detection of threshold
Packit 022b05
-- crossings that span the sampling boundary.  Note that this does
Packit 022b05
-- not require any special configuration of the threshold value.
Packit 022b05
-- It is suggested that probes implement this more precise algorithm.
Packit 022b05
Packit 022b05
alarmTable OBJECT-TYPE
Packit 022b05
    SYNTAX     SEQUENCE OF AlarmEntry
Packit 022b05
    MAX-ACCESS not-accessible
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A list of alarm entries."
Packit 022b05
    ::= { alarm 1 }
Packit 022b05
Packit 022b05
alarmEntry OBJECT-TYPE
Packit 022b05
    SYNTAX     AlarmEntry
Packit 022b05
    MAX-ACCESS not-accessible
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A list of parameters that set up a periodic checking
Packit 022b05
        for alarm conditions.  For example, an instance of the
Packit 022b05
        alarmValue object might be named alarmValue.8"
Packit 022b05
    INDEX { alarmIndex }
Packit 022b05
    ::= { alarmTable 1 }
Packit 022b05
Packit 022b05
AlarmEntry ::= SEQUENCE {
Packit 022b05
    alarmIndex                    Integer32,
Packit 022b05
    alarmInterval                 Integer32,
Packit 022b05
    alarmVariable                 OBJECT IDENTIFIER,
Packit 022b05
    alarmSampleType               INTEGER,
Packit 022b05
    alarmValue                    Integer32,
Packit 022b05
    alarmStartupAlarm             INTEGER,
Packit 022b05
    alarmRisingThreshold          Integer32,
Packit 022b05
    alarmFallingThreshold         Integer32,
Packit 022b05
    alarmRisingEventIndex         Integer32,
Packit 022b05
    alarmFallingEventIndex        Integer32,
Packit 022b05
    alarmOwner                    OwnerString,
Packit 022b05
    alarmStatus                   EntryStatus
Packit 022b05
}
Packit 022b05
Packit 022b05
alarmIndex OBJECT-TYPE
Packit 022b05
    SYNTAX     Integer32 (1..65535)
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "An index that uniquely identifies an entry in the
Packit 022b05
        alarm table.  Each such entry defines a
Packit 022b05
        diagnostic sample at a particular interval
Packit 022b05
        for an object on the device."
Packit 022b05
    ::= { alarmEntry 1 }
Packit 022b05
Packit 022b05
alarmInterval OBJECT-TYPE
Packit 022b05
    SYNTAX     Integer32
Packit 022b05
    UNITS      "Seconds"
Packit 022b05
    MAX-ACCESS read-create
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The interval in seconds over which the data is
Packit 022b05
        sampled and compared with the rising and falling
Packit 022b05
        thresholds.  When setting this variable, care
Packit 022b05
        should be taken in the case of deltaValue
Packit 022b05
        sampling - the interval should be set short enough
Packit 022b05
        that the sampled variable is very unlikely to
Packit 022b05
        increase or decrease by more than 2^31 - 1 during
Packit 022b05
        a single sampling interval.
Packit 022b05
Packit 022b05
        This object may not be modified if the associated
Packit 022b05
        alarmStatus object is equal to valid(1)."
Packit 022b05
    ::= { alarmEntry 2 }
Packit 022b05
Packit 022b05
alarmVariable OBJECT-TYPE
Packit 022b05
    SYNTAX     OBJECT IDENTIFIER
Packit 022b05
    MAX-ACCESS read-create
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The object identifier of the particular variable to be
Packit 022b05
        sampled.  Only variables that resolve to an ASN.1 primitive
Packit 022b05
        type of INTEGER (INTEGER, Integer32, Counter32, Counter64,
Packit 022b05
        Gauge, or TimeTicks) may be sampled.
Packit 022b05
Packit 022b05
        Because SNMP access control is articulated entirely
Packit 022b05
        in terms of the contents of MIB views, no access
Packit 022b05
        control mechanism exists that can restrict the value of
Packit 022b05
        this object to identify only those objects that exist
Packit 022b05
        in a particular MIB view.  Because there is thus no
Packit 022b05
        acceptable means of restricting the read access that
Packit 022b05
        could be obtained through the alarm mechanism, the
Packit 022b05
        probe must only grant write access to this object in
Packit 022b05
        those views that have read access to all objects on
Packit 022b05
        the probe.
Packit 022b05
Packit 022b05
        During a set operation, if the supplied variable name is
Packit 022b05
        not available in the selected MIB view, a badValue error
Packit 022b05
        must be returned.  If at any time the variable name of
Packit 022b05
        an established alarmEntry is no longer available in the
Packit 022b05
        selected MIB view, the probe must change the status of
Packit 022b05
        this alarmEntry to invalid(4).
Packit 022b05
Packit 022b05
        This object may not be modified if the associated
Packit 022b05
        alarmStatus object is equal to valid(1)."
Packit 022b05
    ::= { alarmEntry 3 }
Packit 022b05
Packit 022b05
alarmSampleType OBJECT-TYPE
Packit 022b05
    SYNTAX     INTEGER {
Packit 022b05
                 absoluteValue(1),
Packit 022b05
                 deltaValue(2)
Packit 022b05
               }
Packit 022b05
    MAX-ACCESS read-create
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The method of sampling the selected variable and
Packit 022b05
        calculating the value to be compared against the
Packit 022b05
        thresholds.  If the value of this object is
Packit 022b05
        absoluteValue(1), the value of the selected variable
Packit 022b05
        will be compared directly with the thresholds at the
Packit 022b05
        end of the sampling interval.  If the value of this
Packit 022b05
        object is deltaValue(2), the value of the selected
Packit 022b05
        variable at the last sample will be subtracted from
Packit 022b05
        the current value, and the difference compared with
Packit 022b05
        the thresholds.
Packit 022b05
Packit 022b05
        This object may not be modified if the associated
Packit 022b05
        alarmStatus object is equal to valid(1)."
Packit 022b05
    ::= { alarmEntry 4 }
Packit 022b05
Packit 022b05
alarmValue OBJECT-TYPE
Packit 022b05
    SYNTAX     Integer32
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The value of the statistic during the last sampling
Packit 022b05
        period.  For example, if the sample type is deltaValue,
Packit 022b05
        this value will be the difference between the samples
Packit 022b05
        at the beginning and end of the period.  If the sample
Packit 022b05
        type is absoluteValue, this value will be the sampled
Packit 022b05
        value at the end of the period.
Packit 022b05
        This is the value that is compared with the rising and
Packit 022b05
        falling thresholds.
Packit 022b05
Packit 022b05
        The value during the current sampling period is not
Packit 022b05
        made available until the period is completed and will
Packit 022b05
        remain available until the next period completes."
Packit 022b05
    ::= { alarmEntry 5 }
Packit 022b05
Packit 022b05
alarmStartupAlarm OBJECT-TYPE
Packit 022b05
    SYNTAX     INTEGER {
Packit 022b05
                 risingAlarm(1),
Packit 022b05
                 fallingAlarm(2),
Packit 022b05
                 risingOrFallingAlarm(3)
Packit 022b05
               }
Packit 022b05
    MAX-ACCESS read-create
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The alarm that may be sent when this entry is first
Packit 022b05
        set to valid.  If the first sample after this entry
Packit 022b05
        becomes valid is greater than or equal to the
Packit 022b05
        risingThreshold and alarmStartupAlarm is equal to
Packit 022b05
        risingAlarm(1) or risingOrFallingAlarm(3), then a single
Packit 022b05
        rising alarm will be generated.  If the first sample
Packit 022b05
        after this entry becomes valid is less than or equal
Packit 022b05
        to the fallingThreshold and alarmStartupAlarm is equal
Packit 022b05
        to fallingAlarm(2) or risingOrFallingAlarm(3), then a
Packit 022b05
        single falling alarm will be generated.
Packit 022b05
Packit 022b05
        This object may not be modified if the associated
Packit 022b05
        alarmStatus object is equal to valid(1)."
Packit 022b05
    ::= { alarmEntry 6 }
Packit 022b05
Packit 022b05
alarmRisingThreshold OBJECT-TYPE
Packit 022b05
    SYNTAX     Integer32
Packit 022b05
    MAX-ACCESS read-create
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A threshold for the sampled statistic.  When the current
Packit 022b05
        sampled value is greater than or equal to this threshold,
Packit 022b05
        and the value at the last sampling interval was less than
Packit 022b05
        this threshold, a single event will be generated.
Packit 022b05
        A single event will also be generated if the first
Packit 022b05
        sample after this entry becomes valid is greater than or
Packit 022b05
        equal to this threshold and the associated
Packit 022b05
        alarmStartupAlarm is equal to risingAlarm(1) or
Packit 022b05
        risingOrFallingAlarm(3).
Packit 022b05
Packit 022b05
        After a rising event is generated, another such event
Packit 022b05
        will not be generated until the sampled value
Packit 022b05
        falls below this threshold and reaches the
Packit 022b05
        alarmFallingThreshold.
Packit 022b05
Packit 022b05
        This object may not be modified if the associated
Packit 022b05
        alarmStatus object is equal to valid(1)."
Packit 022b05
    ::= { alarmEntry 7 }
Packit 022b05
Packit 022b05
alarmFallingThreshold OBJECT-TYPE
Packit 022b05
    SYNTAX     Integer32
Packit 022b05
    MAX-ACCESS read-create
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A threshold for the sampled statistic.  When the current
Packit 022b05
        sampled value is less than or equal to this threshold,
Packit 022b05
        and the value at the last sampling interval was greater than
Packit 022b05
        this threshold, a single event will be generated.
Packit 022b05
        A single event will also be generated if the first
Packit 022b05
        sample after this entry becomes valid is less than or
Packit 022b05
        equal to this threshold and the associated
Packit 022b05
        alarmStartupAlarm is equal to fallingAlarm(2) or
Packit 022b05
        risingOrFallingAlarm(3).
Packit 022b05
Packit 022b05
        After a falling event is generated, another such event
Packit 022b05
        will not be generated until the sampled value
Packit 022b05
        rises above this threshold and reaches the
Packit 022b05
        alarmRisingThreshold.
Packit 022b05
Packit 022b05
        This object may not be modified if the associated
Packit 022b05
        alarmStatus object is equal to valid(1)."
Packit 022b05
    ::= { alarmEntry 8 }
Packit 022b05
Packit 022b05
alarmRisingEventIndex OBJECT-TYPE
Packit 022b05
    SYNTAX     Integer32 (0..65535)
Packit 022b05
    MAX-ACCESS read-create
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The index of the eventEntry that is
Packit 022b05
        used when a rising threshold is crossed.  The
Packit 022b05
        eventEntry identified by a particular value of
Packit 022b05
        this index is the same as identified by the same value
Packit 022b05
        of the eventIndex object.  If there is no
Packit 022b05
        corresponding entry in the eventTable, then
Packit 022b05
        no association exists.  In particular, if this value
Packit 022b05
        is zero, no associated event will be generated, as
Packit 022b05
        zero is not a valid event index.
Packit 022b05
Packit 022b05
        This object may not be modified if the associated
Packit 022b05
        alarmStatus object is equal to valid(1)."
Packit 022b05
    ::= { alarmEntry 9 }
Packit 022b05
Packit 022b05
alarmFallingEventIndex OBJECT-TYPE
Packit 022b05
    SYNTAX     Integer32 (0..65535)
Packit 022b05
    MAX-ACCESS read-create
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The index of the eventEntry that is
Packit 022b05
        used when a falling threshold is crossed.  The
Packit 022b05
        eventEntry identified by a particular value of
Packit 022b05
        this index is the same as identified by the same value
Packit 022b05
        of the eventIndex object.  If there is no
Packit 022b05
        corresponding entry in the eventTable, then
Packit 022b05
        no association exists.  In particular, if this value
Packit 022b05
        is zero, no associated event will be generated, as
Packit 022b05
        zero is not a valid event index.
Packit 022b05
Packit 022b05
        This object may not be modified if the associated
Packit 022b05
        alarmStatus object is equal to valid(1)."
Packit 022b05
    ::= { alarmEntry 10 }
Packit 022b05
Packit 022b05
alarmOwner OBJECT-TYPE
Packit 022b05
    SYNTAX     OwnerString
Packit 022b05
    MAX-ACCESS read-create
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The entity that configured this entry and is therefore
Packit 022b05
        using the resources assigned to it."
Packit 022b05
    ::= { alarmEntry 11 }
Packit 022b05
Packit 022b05
alarmStatus OBJECT-TYPE
Packit 022b05
    SYNTAX     EntryStatus
Packit 022b05
    MAX-ACCESS read-create
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The status of this alarm entry."
Packit 022b05
    ::= { alarmEntry 12 }
Packit 022b05
Packit 022b05
-- The Host Group
Packit 022b05
Packit 022b05
-- Implementation of the Host group is optional.
Packit 022b05
-- Consult the MODULE-COMPLIANCE macro for the authoritative
Packit 022b05
-- conformance information for this MIB.
Packit 022b05
--
Packit 022b05
-- The host group discovers new hosts on the network by
Packit 022b05
-- keeping a list of source and destination MAC Addresses seen
Packit 022b05
-- in good packets.  For each of these addresses, the host group
Packit 022b05
Packit 022b05
-- keeps a set of statistics.  The hostControlTable controls
Packit 022b05
-- which interfaces this function is performed on, and contains
Packit 022b05
-- some information about the process.  On behalf of each
Packit 022b05
-- hostControlEntry, data is collected on an interface and placed
Packit 022b05
-- in both the hostTable and the hostTimeTable.  If the
Packit 022b05
-- monitoring device finds itself short of resources, it may
Packit 022b05
-- delete entries as needed.  It is suggested that the device
Packit 022b05
-- delete the least recently used entries first.
Packit 022b05
Packit 022b05
-- The hostTable contains entries for each address discovered on
Packit 022b05
-- a particular interface.  Each entry contains statistical
Packit 022b05
-- data about that host.  This table is indexed by the
Packit 022b05
-- MAC address of the host, through which a random access
Packit 022b05
-- may be achieved.
Packit 022b05
Packit 022b05
-- The hostTimeTable contains data in the same format as the
Packit 022b05
-- hostTable, and must contain the same set of hosts, but is
Packit 022b05
-- indexed using hostTimeCreationOrder rather than hostAddress.
Packit 022b05
-- The hostTimeCreationOrder is an integer which reflects
Packit 022b05
-- the relative order in which a particular entry was discovered
Packit 022b05
-- and thus inserted into the table.  As this order, and thus
Packit 022b05
-- the index, is among those entries currently in the table,
Packit 022b05
-- the index for a particular entry may change if an
Packit 022b05
-- (earlier) entry is deleted.  Thus the association between
Packit 022b05
-- hostTimeCreationOrder and hostTimeEntry may be broken at
Packit 022b05
-- any time.
Packit 022b05
Packit 022b05
-- The hostTimeTable has two important uses.  The first is the
Packit 022b05
-- fast download of this potentially large table.  Because the
Packit 022b05
-- index of this table runs from 1 to the size of the table,
Packit 022b05
-- inclusive, its values are predictable.  This allows very
Packit 022b05
-- efficient packing of variables into SNMP PDU's and allows
Packit 022b05
-- a table transfer to have multiple packets outstanding.
Packit 022b05
-- These benefits increase transfer rates tremendously.
Packit 022b05
Packit 022b05
-- The second use of the hostTimeTable is the efficient discovery
Packit 022b05
-- by the management station of new entries added to the table.
Packit 022b05
-- After the management station has downloaded the entire table,
Packit 022b05
-- it knows that new entries will be added immediately after the
Packit 022b05
-- end of the current table.  It can thus detect new entries there
Packit 022b05
-- and retrieve them easily.
Packit 022b05
Packit 022b05
-- Because the association between hostTimeCreationOrder and
Packit 022b05
-- hostTimeEntry may be broken at any time, the management
Packit 022b05
-- station must monitor the related hostControlLastDeleteTime
Packit 022b05
-- object.  When the management station thus detects a deletion,
Packit 022b05
-- it must assume that any such associations have been broken,
Packit 022b05
-- and invalidate any it has stored locally.  This includes
Packit 022b05
Packit 022b05
-- restarting any download of the hostTimeTable that may have been
Packit 022b05
-- in progress, as well as rediscovering the end of the
Packit 022b05
-- hostTimeTable so that it may detect new entries.  If the
Packit 022b05
-- management station does not detect the broken association,
Packit 022b05
-- it may continue to refer to a particular host by its
Packit 022b05
-- creationOrder while unwittingly retrieving the data associated
Packit 022b05
-- with another host entirely.  If this happens while downloading
Packit 022b05
-- the host table, the management station may fail to download
Packit 022b05
-- all of the entries in the table.
Packit 022b05
Packit 022b05
Packit 022b05
hostControlTable OBJECT-TYPE
Packit 022b05
    SYNTAX     SEQUENCE OF HostControlEntry
Packit 022b05
    MAX-ACCESS not-accessible
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A list of host table control entries."
Packit 022b05
    ::= { hosts 1 }
Packit 022b05
Packit 022b05
hostControlEntry OBJECT-TYPE
Packit 022b05
    SYNTAX     HostControlEntry
Packit 022b05
    MAX-ACCESS not-accessible
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A list of parameters that set up the discovery of hosts
Packit 022b05
        on a particular interface and the collection of statistics
Packit 022b05
        about these hosts.  For example, an instance of the
Packit 022b05
        hostControlTableSize object might be named
Packit 022b05
        hostControlTableSize.1"
Packit 022b05
    INDEX { hostControlIndex }
Packit 022b05
    ::= { hostControlTable 1 }
Packit 022b05
Packit 022b05
HostControlEntry ::= SEQUENCE {
Packit 022b05
Packit 022b05
    hostControlIndex            Integer32,
Packit 022b05
    hostControlDataSource       OBJECT IDENTIFIER,
Packit 022b05
    hostControlTableSize        Integer32,
Packit 022b05
    hostControlLastDeleteTime   TimeTicks,
Packit 022b05
    hostControlOwner            OwnerString,
Packit 022b05
    hostControlStatus           EntryStatus
Packit 022b05
}
Packit 022b05
Packit 022b05
hostControlIndex OBJECT-TYPE
Packit 022b05
    SYNTAX     Integer32 (1..65535)
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "An index that uniquely identifies an entry in the
Packit 022b05
        hostControl table.  Each such entry defines
Packit 022b05
        a function that discovers hosts on a particular interface
Packit 022b05
        and places statistics about them in the hostTable and
Packit 022b05
        the hostTimeTable on behalf of this hostControlEntry."
Packit 022b05
    ::= { hostControlEntry 1 }
Packit 022b05
Packit 022b05
hostControlDataSource OBJECT-TYPE
Packit 022b05
    SYNTAX     OBJECT IDENTIFIER
Packit 022b05
    MAX-ACCESS read-create
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "This object identifies the source of the data for
Packit 022b05
        this instance of the host function.  This source
Packit 022b05
        can be any interface on this device.  In order
Packit 022b05
        to identify a particular interface, this object shall
Packit 022b05
        identify the instance of the ifIndex object, defined
Packit 022b05
        in RFC 2233 [17], for the desired interface.
Packit 022b05
        For example, if an entry were to receive data from
Packit 022b05
        interface #1, this object would be set to ifIndex.1.
Packit 022b05
Packit 022b05
        The statistics in this group reflect all packets
Packit 022b05
        on the local network segment attached to the identified
Packit 022b05
        interface.
Packit 022b05
Packit 022b05
        An agent may or may not be able to tell if fundamental
Packit 022b05
        changes to the media of the interface have occurred and
Packit 022b05
        necessitate an invalidation of this entry.  For example, a
Packit 022b05
        hot-pluggable ethernet card could be pulled out and replaced
Packit 022b05
        by a token-ring card.  In such a case, if the agent has such
Packit 022b05
        knowledge of the change, it is recommended that it
Packit 022b05
        invalidate this entry.
Packit 022b05
Packit 022b05
        This object may not be modified if the associated
Packit 022b05
        hostControlStatus object is equal to valid(1)."
Packit 022b05
    ::= { hostControlEntry 2 }
Packit 022b05
Packit 022b05
hostControlTableSize OBJECT-TYPE
Packit 022b05
    SYNTAX     Integer32
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The number of hostEntries in the hostTable and the
Packit 022b05
        hostTimeTable associated with this hostControlEntry."
Packit 022b05
    ::= { hostControlEntry 3 }
Packit 022b05
Packit 022b05
hostControlLastDeleteTime OBJECT-TYPE
Packit 022b05
    SYNTAX     TimeTicks
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The value of sysUpTime when the last entry
Packit 022b05
        was deleted from the portion of the hostTable
Packit 022b05
        associated with this hostControlEntry.  If no
Packit 022b05
        deletions have occurred, this value shall be zero."
Packit 022b05
    ::= { hostControlEntry 4 }
Packit 022b05
Packit 022b05
hostControlOwner OBJECT-TYPE
Packit 022b05
    SYNTAX     OwnerString
Packit 022b05
    MAX-ACCESS read-create
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The entity that configured this entry and is therefore
Packit 022b05
        using the resources assigned to it."
Packit 022b05
    ::= { hostControlEntry 5 }
Packit 022b05
Packit 022b05
hostControlStatus OBJECT-TYPE
Packit 022b05
    SYNTAX     EntryStatus
Packit 022b05
    MAX-ACCESS read-create
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The status of this hostControl entry.
Packit 022b05
Packit 022b05
        If this object is not equal to valid(1), all associated
Packit 022b05
        entries in the hostTable, hostTimeTable, and the
Packit 022b05
        hostTopNTable shall be deleted by the agent."
Packit 022b05
    ::= { hostControlEntry 6 }
Packit 022b05
Packit 022b05
hostTable OBJECT-TYPE
Packit 022b05
    SYNTAX     SEQUENCE OF HostEntry
Packit 022b05
    MAX-ACCESS not-accessible
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A list of host entries."
Packit 022b05
    ::= { hosts 2 }
Packit 022b05
Packit 022b05
hostEntry OBJECT-TYPE
Packit 022b05
    SYNTAX     HostEntry
Packit 022b05
    MAX-ACCESS not-accessible
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A collection of statistics for a particular host that has
Packit 022b05
        been discovered on an interface of this device.  For example,
Packit 022b05
        an instance of the hostOutBroadcastPkts object might be
Packit 022b05
        named hostOutBroadcastPkts.1.6.8.0.32.27.3.176"
Packit 022b05
    INDEX { hostIndex, hostAddress }
Packit 022b05
    ::= { hostTable 1 }
Packit 022b05
Packit 022b05
HostEntry ::= SEQUENCE {
Packit 022b05
    hostAddress             OCTET STRING,
Packit 022b05
    hostCreationOrder       Integer32,
Packit 022b05
    hostIndex               Integer32,
Packit 022b05
    hostInPkts              Counter32,
Packit 022b05
    hostOutPkts             Counter32,
Packit 022b05
    hostInOctets            Counter32,
Packit 022b05
    hostOutOctets           Counter32,
Packit 022b05
    hostOutErrors           Counter32,
Packit 022b05
    hostOutBroadcastPkts    Counter32,
Packit 022b05
    hostOutMulticastPkts    Counter32
Packit 022b05
}
Packit 022b05
Packit 022b05
hostAddress OBJECT-TYPE
Packit 022b05
    SYNTAX     OCTET STRING
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The physical address of this host."
Packit 022b05
    ::= { hostEntry 1 }
Packit 022b05
Packit 022b05
hostCreationOrder OBJECT-TYPE
Packit 022b05
    SYNTAX     Integer32 (1..65535)
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "An index that defines the relative ordering of
Packit 022b05
        the creation time of hosts captured for a
Packit 022b05
        particular hostControlEntry.  This index shall
Packit 022b05
        be between 1 and N, where N is the value of
Packit 022b05
        the associated hostControlTableSize.  The ordering
Packit 022b05
        of the indexes is based on the order of each entry's
Packit 022b05
        insertion into the table, in which entries added earlier
Packit 022b05
        have a lower index value than entries added later.
Packit 022b05
Packit 022b05
        It is important to note that the order for a
Packit 022b05
        particular entry may change as an (earlier) entry
Packit 022b05
        is deleted from the table.  Because this order may
Packit 022b05
        change, management stations should make use of the
Packit 022b05
        hostControlLastDeleteTime variable in the
Packit 022b05
        hostControlEntry associated with the relevant
Packit 022b05
        portion of the hostTable.  By observing
Packit 022b05
        this variable, the management station may detect
Packit 022b05
        the circumstances where a previous association
Packit 022b05
        between a value of hostCreationOrder
Packit 022b05
        and a hostEntry may no longer hold."
Packit 022b05
    ::= { hostEntry 2 }
Packit 022b05
Packit 022b05
hostIndex OBJECT-TYPE
Packit 022b05
    SYNTAX     Integer32 (1..65535)
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The set of collected host statistics of which
Packit 022b05
        this entry is a part.  The set of hosts
Packit 022b05
        identified by a particular value of this
Packit 022b05
        index is associated with the hostControlEntry
Packit 022b05
        as identified by the same value of hostControlIndex."
Packit 022b05
    ::= { hostEntry 3 }
Packit 022b05
Packit 022b05
hostInPkts OBJECT-TYPE
Packit 022b05
    SYNTAX     Counter32
Packit 022b05
    UNITS      "Packets"
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The number of good packets transmitted to this
Packit 022b05
        address since it was added to the hostTable."
Packit 022b05
    ::= { hostEntry 4 }
Packit 022b05
Packit 022b05
hostOutPkts OBJECT-TYPE
Packit 022b05
    SYNTAX     Counter32
Packit 022b05
    UNITS      "Packets"
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The number of packets, including bad packets, transmitted
Packit 022b05
        by this address since it was added to the hostTable."
Packit 022b05
    ::= { hostEntry 5 }
Packit 022b05
Packit 022b05
hostInOctets OBJECT-TYPE
Packit 022b05
    SYNTAX     Counter32
Packit 022b05
    UNITS      "Octets"
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The number of octets transmitted to this address since
Packit 022b05
        it was added to the hostTable (excluding framing
Packit 022b05
        bits but including FCS octets), except for those
Packit 022b05
        octets in bad packets."
Packit 022b05
    ::= { hostEntry 6 }
Packit 022b05
Packit 022b05
hostOutOctets OBJECT-TYPE
Packit 022b05
    SYNTAX     Counter32
Packit 022b05
    UNITS      "Octets"
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The number of octets transmitted by this address since
Packit 022b05
        it was added to the hostTable (excluding framing
Packit 022b05
        bits but including FCS octets), including those
Packit 022b05
        octets in bad packets."
Packit 022b05
    ::= { hostEntry 7 }
Packit 022b05
Packit 022b05
hostOutErrors OBJECT-TYPE
Packit 022b05
    SYNTAX     Counter32
Packit 022b05
    UNITS      "Packets"
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The number of bad packets transmitted by this address
Packit 022b05
        since this host was added to the hostTable."
Packit 022b05
    ::= { hostEntry 8 }
Packit 022b05
Packit 022b05
hostOutBroadcastPkts OBJECT-TYPE
Packit 022b05
    SYNTAX     Counter32
Packit 022b05
    UNITS      "Packets"
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The number of good packets transmitted by this
Packit 022b05
        address that were directed to the broadcast address
Packit 022b05
        since this host was added to the hostTable."
Packit 022b05
    ::= { hostEntry 9 }
Packit 022b05
Packit 022b05
hostOutMulticastPkts OBJECT-TYPE
Packit 022b05
    SYNTAX     Counter32
Packit 022b05
    UNITS      "Packets"
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The number of good packets transmitted by this
Packit 022b05
        address that were directed to a multicast address
Packit 022b05
        since this host was added to the hostTable.
Packit 022b05
        Note that this number does not include packets
Packit 022b05
        directed to the broadcast address."
Packit 022b05
    ::= { hostEntry 10 }
Packit 022b05
Packit 022b05
-- host Time Table
Packit 022b05
Packit 022b05
hostTimeTable OBJECT-TYPE
Packit 022b05
    SYNTAX     SEQUENCE OF HostTimeEntry
Packit 022b05
    MAX-ACCESS not-accessible
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A list of time-ordered host table entries."
Packit 022b05
    ::= { hosts 3 }
Packit 022b05
Packit 022b05
hostTimeEntry OBJECT-TYPE
Packit 022b05
    SYNTAX     HostTimeEntry
Packit 022b05
    MAX-ACCESS not-accessible
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A collection of statistics for a particular host that has
Packit 022b05
        been discovered on an interface of this device.  This
Packit 022b05
        collection includes the relative ordering of the creation
Packit 022b05
        time of this object.  For example, an instance of the
Packit 022b05
        hostTimeOutBroadcastPkts object might be named
Packit 022b05
        hostTimeOutBroadcastPkts.1.687"
Packit 022b05
    INDEX { hostTimeIndex, hostTimeCreationOrder }
Packit 022b05
    ::= { hostTimeTable 1 }
Packit 022b05
Packit 022b05
HostTimeEntry ::= SEQUENCE {
Packit 022b05
    hostTimeAddress              OCTET STRING,
Packit 022b05
    hostTimeCreationOrder        Integer32,
Packit 022b05
    hostTimeIndex                Integer32,
Packit 022b05
    hostTimeInPkts               Counter32,
Packit 022b05
    hostTimeOutPkts              Counter32,
Packit 022b05
    hostTimeInOctets             Counter32,
Packit 022b05
    hostTimeOutOctets            Counter32,
Packit 022b05
    hostTimeOutErrors            Counter32,
Packit 022b05
    hostTimeOutBroadcastPkts     Counter32,
Packit 022b05
    hostTimeOutMulticastPkts     Counter32
Packit 022b05
}
Packit 022b05
Packit 022b05
hostTimeAddress OBJECT-TYPE
Packit 022b05
    SYNTAX     OCTET STRING
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The physical address of this host."
Packit 022b05
    ::= { hostTimeEntry 1 }
Packit 022b05
Packit 022b05
hostTimeCreationOrder OBJECT-TYPE
Packit 022b05
    SYNTAX     Integer32 (1..65535)
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "An index that uniquely identifies an entry in
Packit 022b05
        the hostTime table among those entries associated
Packit 022b05
        with the same hostControlEntry.  This index shall
Packit 022b05
        be between 1 and N, where N is the value of
Packit 022b05
        the associated hostControlTableSize.  The ordering
Packit 022b05
        of the indexes is based on the order of each entry's
Packit 022b05
        insertion into the table, in which entries added earlier
Packit 022b05
        have a lower index value than entries added later.
Packit 022b05
        Thus the management station has the ability to
Packit 022b05
        learn of new entries added to this table without
Packit 022b05
        downloading the entire table.
Packit 022b05
Packit 022b05
        It is important to note that the index for a
Packit 022b05
        particular entry may change as an (earlier) entry
Packit 022b05
        is deleted from the table.  Because this order may
Packit 022b05
        change, management stations should make use of the
Packit 022b05
        hostControlLastDeleteTime variable in the
Packit 022b05
        hostControlEntry associated with the relevant
Packit 022b05
        portion of the hostTimeTable.  By observing
Packit 022b05
        this variable, the management station may detect
Packit 022b05
        the circumstances where a download of the table
Packit 022b05
        may have missed entries, and where a previous
Packit 022b05
        association between a value of hostTimeCreationOrder
Packit 022b05
        and a hostTimeEntry may no longer hold."
Packit 022b05
    ::= { hostTimeEntry 2 }
Packit 022b05
Packit 022b05
hostTimeIndex OBJECT-TYPE
Packit 022b05
    SYNTAX     Integer32 (1..65535)
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The set of collected host statistics of which
Packit 022b05
        this entry is a part.  The set of hosts
Packit 022b05
        identified by a particular value of this
Packit 022b05
        index is associated with the hostControlEntry
Packit 022b05
        as identified by the same value of hostControlIndex."
Packit 022b05
    ::= { hostTimeEntry 3 }
Packit 022b05
Packit 022b05
hostTimeInPkts OBJECT-TYPE
Packit 022b05
    SYNTAX     Counter32
Packit 022b05
    UNITS      "Packets"
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The number of good packets transmitted to this
Packit 022b05
        address since it was added to the hostTimeTable."
Packit 022b05
    ::= { hostTimeEntry 4 }
Packit 022b05
Packit 022b05
hostTimeOutPkts OBJECT-TYPE
Packit 022b05
    SYNTAX     Counter32
Packit 022b05
    UNITS      "Packets"
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The number of packets, including bad packets, transmitted
Packit 022b05
        by this address since it was added to the hostTimeTable."
Packit 022b05
    ::= { hostTimeEntry 5 }
Packit 022b05
Packit 022b05
hostTimeInOctets OBJECT-TYPE
Packit 022b05
    SYNTAX     Counter32
Packit 022b05
    UNITS      "Octets"
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The number of octets transmitted to this address since
Packit 022b05
        it was added to the hostTimeTable (excluding framing
Packit 022b05
        bits but including FCS octets), except for those
Packit 022b05
        octets in bad packets."
Packit 022b05
    ::= { hostTimeEntry 6 }
Packit 022b05
Packit 022b05
hostTimeOutOctets OBJECT-TYPE
Packit 022b05
    SYNTAX     Counter32
Packit 022b05
    UNITS      "Octets"
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The number of octets transmitted by this address since
Packit 022b05
        it was added to the hostTimeTable (excluding framing
Packit 022b05
        bits but including FCS octets), including those
Packit 022b05
        octets in bad packets."
Packit 022b05
    ::= { hostTimeEntry 7 }
Packit 022b05
Packit 022b05
hostTimeOutErrors OBJECT-TYPE
Packit 022b05
    SYNTAX     Counter32
Packit 022b05
    UNITS      "Packets"
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The number of bad packets transmitted by this address
Packit 022b05
        since this host was added to the hostTimeTable."
Packit 022b05
    ::= { hostTimeEntry 8 }
Packit 022b05
Packit 022b05
hostTimeOutBroadcastPkts OBJECT-TYPE
Packit 022b05
    SYNTAX     Counter32
Packit 022b05
    UNITS      "Packets"
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The number of good packets transmitted by this
Packit 022b05
        address that were directed to the broadcast address
Packit 022b05
        since this host was added to the hostTimeTable."
Packit 022b05
    ::= { hostTimeEntry 9 }
Packit 022b05
Packit 022b05
hostTimeOutMulticastPkts OBJECT-TYPE
Packit 022b05
    SYNTAX     Counter32
Packit 022b05
    UNITS      "Packets"
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The number of good packets transmitted by this
Packit 022b05
        address that were directed to a multicast address
Packit 022b05
        since this host was added to the hostTimeTable.
Packit 022b05
        Note that this number does not include packets directed
Packit 022b05
        to the broadcast address."
Packit 022b05
    ::= { hostTimeEntry 10 }
Packit 022b05
Packit 022b05
-- The Host Top "N" Group
Packit 022b05
Packit 022b05
-- Implementation of the Host Top N group is optional. The Host Top N
Packit 022b05
-- group requires the implementation of the host group.
Packit 022b05
-- Consult the MODULE-COMPLIANCE macro for the authoritative
Packit 022b05
-- conformance information for this MIB.
Packit 022b05
--
Packit 022b05
-- The Host Top N group is used to prepare reports that describe
Packit 022b05
-- the hosts that top a list ordered by one of their statistics.
Packit 022b05
-- The available statistics are samples of one of their
Packit 022b05
-- base statistics, over an interval specified by the management
Packit 022b05
-- station.  Thus, these statistics are rate based.  The management
Packit 022b05
-- station also selects how many such hosts are reported.
Packit 022b05
Packit 022b05
-- The hostTopNControlTable is used to initiate the generation of
Packit 022b05
-- such a report.  The management station may select the parameters
Packit 022b05
-- of such a report, such as which interface, which statistic,
Packit 022b05
-- how many hosts, and the start and stop times of the sampling.
Packit 022b05
-- When the report is prepared, entries are created in the
Packit 022b05
-- hostTopNTable associated with the relevant hostTopNControlEntry.
Packit 022b05
-- These entries are static for each report after it has been
Packit 022b05
-- prepared.
Packit 022b05
Packit 022b05
hostTopNControlTable OBJECT-TYPE
Packit 022b05
    SYNTAX     SEQUENCE OF HostTopNControlEntry
Packit 022b05
    MAX-ACCESS not-accessible
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A list of top N host control entries."
Packit 022b05
    ::= { hostTopN 1 }
Packit 022b05
Packit 022b05
hostTopNControlEntry OBJECT-TYPE
Packit 022b05
    SYNTAX     HostTopNControlEntry
Packit 022b05
    MAX-ACCESS not-accessible
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A set of parameters that control the creation of a report
Packit 022b05
        of the top N hosts according to several metrics.  For
Packit 022b05
        example, an instance of the hostTopNDuration object might
Packit 022b05
        be named hostTopNDuration.3"
Packit 022b05
    INDEX { hostTopNControlIndex }
Packit 022b05
    ::= { hostTopNControlTable 1 }
Packit 022b05
Packit 022b05
HostTopNControlEntry ::= SEQUENCE {
Packit 022b05
    hostTopNControlIndex    Integer32,
Packit 022b05
    hostTopNHostIndex       Integer32,
Packit 022b05
    hostTopNRateBase        INTEGER,
Packit 022b05
    hostTopNTimeRemaining   Integer32,
Packit 022b05
    hostTopNDuration        Integer32,
Packit 022b05
    hostTopNRequestedSize   Integer32,
Packit 022b05
    hostTopNGrantedSize     Integer32,
Packit 022b05
    hostTopNStartTime       TimeTicks,
Packit 022b05
    hostTopNOwner           OwnerString,
Packit 022b05
    hostTopNStatus          EntryStatus
Packit 022b05
}
Packit 022b05
Packit 022b05
hostTopNControlIndex OBJECT-TYPE
Packit 022b05
    SYNTAX     Integer32 (1..65535)
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "An index that uniquely identifies an entry
Packit 022b05
        in the hostTopNControl table.  Each such
Packit 022b05
        entry defines one top N report prepared for
Packit 022b05
        one interface."
Packit 022b05
    ::= { hostTopNControlEntry 1 }
Packit 022b05
Packit 022b05
hostTopNHostIndex OBJECT-TYPE
Packit 022b05
    SYNTAX     Integer32 (1..65535)
Packit 022b05
    MAX-ACCESS read-create
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The host table for which a top N report will be prepared
Packit 022b05
        on behalf of this entry.  The host table identified by a
Packit 022b05
        particular value of this index is associated with the same
Packit 022b05
        host table as identified by the same value of
Packit 022b05
        hostIndex.
Packit 022b05
Packit 022b05
        This object may not be modified if the associated
Packit 022b05
        hostTopNStatus object is equal to valid(1)."
Packit 022b05
    ::= { hostTopNControlEntry 2 }
Packit 022b05
Packit 022b05
hostTopNRateBase OBJECT-TYPE
Packit 022b05
    SYNTAX     INTEGER {
Packit 022b05
                 hostTopNInPkts(1),
Packit 022b05
                 hostTopNOutPkts(2),
Packit 022b05
                 hostTopNInOctets(3),
Packit 022b05
                 hostTopNOutOctets(4),
Packit 022b05
                 hostTopNOutErrors(5),
Packit 022b05
                 hostTopNOutBroadcastPkts(6),
Packit 022b05
                 hostTopNOutMulticastPkts(7)
Packit 022b05
               }
Packit 022b05
    MAX-ACCESS read-create
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The variable for each host that the hostTopNRate
Packit 022b05
        variable is based upon.
Packit 022b05
Packit 022b05
        This object may not be modified if the associated
Packit 022b05
        hostTopNStatus object is equal to valid(1)."
Packit 022b05
    ::= { hostTopNControlEntry 3 }
Packit 022b05
Packit 022b05
hostTopNTimeRemaining OBJECT-TYPE
Packit 022b05
    SYNTAX     Integer32
Packit 022b05
    UNITS      "Seconds"
Packit 022b05
    MAX-ACCESS read-create
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The number of seconds left in the report currently being
Packit 022b05
        collected.  When this object is modified by the management
Packit 022b05
        station, a new collection is started, possibly aborting
Packit 022b05
        a currently running report.  The new value is used
Packit 022b05
        as the requested duration of this report, which is
Packit 022b05
        loaded into the associated hostTopNDuration object.
Packit 022b05
Packit 022b05
        When this object is set to a non-zero value, any
Packit 022b05
        associated hostTopNEntries shall be made
Packit 022b05
        inaccessible by the monitor.  While the value of this
Packit 022b05
        object is non-zero, it decrements by one per second until
Packit 022b05
        it reaches zero.  During this time, all associated
Packit 022b05
        hostTopNEntries shall remain inaccessible.  At the time
Packit 022b05
        that this object decrements to zero, the report is made
Packit 022b05
        accessible in the hostTopNTable.  Thus, the hostTopN
Packit 022b05
        table needs to be created only at the end of the collection
Packit 022b05
        interval."
Packit 022b05
    DEFVAL { 0 }
Packit 022b05
    ::= { hostTopNControlEntry 4 }
Packit 022b05
Packit 022b05
hostTopNDuration OBJECT-TYPE
Packit 022b05
    SYNTAX     Integer32
Packit 022b05
    UNITS      "Seconds"
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The number of seconds that this report has collected
Packit 022b05
        during the last sampling interval, or if this
Packit 022b05
        report is currently being collected, the number
Packit 022b05
        of seconds that this report is being collected
Packit 022b05
        during this sampling interval.
Packit 022b05
Packit 022b05
        When the associated hostTopNTimeRemaining object is set,
Packit 022b05
        this object shall be set by the probe to the same value
Packit 022b05
        and shall not be modified until the next time
Packit 022b05
        the hostTopNTimeRemaining is set.
Packit 022b05
Packit 022b05
        This value shall be zero if no reports have been
Packit 022b05
        requested for this hostTopNControlEntry."
Packit 022b05
    DEFVAL { 0 }
Packit 022b05
    ::= { hostTopNControlEntry 5 }
Packit 022b05
Packit 022b05
hostTopNRequestedSize OBJECT-TYPE
Packit 022b05
    SYNTAX     Integer32
Packit 022b05
    MAX-ACCESS read-create
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The maximum number of hosts requested for the top N
Packit 022b05
        table.
Packit 022b05
Packit 022b05
        When this object is created or modified, the probe
Packit 022b05
        should set hostTopNGrantedSize as closely to this
Packit 022b05
        object as is possible for the particular probe
Packit 022b05
        implementation and available resources."
Packit 022b05
    DEFVAL { 10 }
Packit 022b05
    ::= { hostTopNControlEntry 6 }
Packit 022b05
Packit 022b05
hostTopNGrantedSize OBJECT-TYPE
Packit 022b05
    SYNTAX     Integer32
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The maximum number of hosts in the top N table.
Packit 022b05
Packit 022b05
        When the associated hostTopNRequestedSize object is
Packit 022b05
        created or modified, the probe should set this
Packit 022b05
        object as closely to the requested value as is possible
Packit 022b05
        for the particular implementation and available
Packit 022b05
        resources. The probe must not lower this value except
Packit 022b05
        as a result of a set to the associated
Packit 022b05
        hostTopNRequestedSize object.
Packit 022b05
Packit 022b05
        Hosts with the highest value of hostTopNRate shall be
Packit 022b05
        placed in this table in decreasing order of this rate
Packit 022b05
        until there is no more room or until there are no more
Packit 022b05
        hosts."
Packit 022b05
    ::= { hostTopNControlEntry 7 }
Packit 022b05
Packit 022b05
hostTopNStartTime OBJECT-TYPE
Packit 022b05
    SYNTAX     TimeTicks
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The value of sysUpTime when this top N report was
Packit 022b05
        last started.  In other words, this is the time that
Packit 022b05
        the associated hostTopNTimeRemaining object was
Packit 022b05
        modified to start the requested report."
Packit 022b05
    ::= { hostTopNControlEntry 8 }
Packit 022b05
Packit 022b05
hostTopNOwner OBJECT-TYPE
Packit 022b05
    SYNTAX     OwnerString
Packit 022b05
    MAX-ACCESS read-create
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The entity that configured this entry and is therefore
Packit 022b05
        using the resources assigned to it."
Packit 022b05
    ::= { hostTopNControlEntry 9 }
Packit 022b05
Packit 022b05
hostTopNStatus OBJECT-TYPE
Packit 022b05
    SYNTAX     EntryStatus
Packit 022b05
    MAX-ACCESS read-create
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The status of this hostTopNControl entry.
Packit 022b05
Packit 022b05
        If this object is not equal to valid(1), all associated
Packit 022b05
        hostTopNEntries shall be deleted by the agent."
Packit 022b05
    ::= { hostTopNControlEntry 10 }
Packit 022b05
Packit 022b05
hostTopNTable OBJECT-TYPE
Packit 022b05
    SYNTAX     SEQUENCE OF HostTopNEntry
Packit 022b05
    MAX-ACCESS not-accessible
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A list of top N host entries."
Packit 022b05
    ::= { hostTopN 2 }
Packit 022b05
Packit 022b05
hostTopNEntry OBJECT-TYPE
Packit 022b05
    SYNTAX     HostTopNEntry
Packit 022b05
    MAX-ACCESS not-accessible
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A set of statistics for a host that is part of a top N
Packit 022b05
        report.  For example, an instance of the hostTopNRate
Packit 022b05
        object might be named hostTopNRate.3.10"
Packit 022b05
    INDEX { hostTopNReport, hostTopNIndex }
Packit 022b05
    ::= { hostTopNTable 1 }
Packit 022b05
Packit 022b05
HostTopNEntry ::= SEQUENCE {
Packit 022b05
    hostTopNReport                Integer32,
Packit 022b05
    hostTopNIndex                 Integer32,
Packit 022b05
    hostTopNAddress               OCTET STRING,
Packit 022b05
    hostTopNRate                  Integer32
Packit 022b05
}
Packit 022b05
Packit 022b05
hostTopNReport OBJECT-TYPE
Packit 022b05
    SYNTAX     Integer32 (1..65535)
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "This object identifies the top N report of which
Packit 022b05
        this entry is a part.  The set of hosts
Packit 022b05
        identified by a particular value of this
Packit 022b05
        object is part of the same report as identified
Packit 022b05
        by the same value of the hostTopNControlIndex object."
Packit 022b05
    ::= { hostTopNEntry 1 }
Packit 022b05
Packit 022b05
hostTopNIndex OBJECT-TYPE
Packit 022b05
    SYNTAX     Integer32 (1..65535)
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "An index that uniquely identifies an entry in
Packit 022b05
        the hostTopN table among those in the same report.
Packit 022b05
        This index is between 1 and N, where N is the
Packit 022b05
        number of entries in this table.  Increasing values
Packit 022b05
        of hostTopNIndex shall be assigned to entries with
Packit 022b05
        decreasing values of hostTopNRate until index N
Packit 022b05
        is assigned to the entry with the lowest value of
Packit 022b05
        hostTopNRate or there are no more hostTopNEntries."
Packit 022b05
    ::= { hostTopNEntry 2 }
Packit 022b05
Packit 022b05
hostTopNAddress OBJECT-TYPE
Packit 022b05
    SYNTAX     OCTET STRING
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The physical address of this host."
Packit 022b05
    ::= { hostTopNEntry 3 }
Packit 022b05
Packit 022b05
hostTopNRate OBJECT-TYPE
Packit 022b05
    SYNTAX     Integer32
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The amount of change in the selected variable
Packit 022b05
        during this sampling interval.  The selected
Packit 022b05
        variable is this host's instance of the object
Packit 022b05
        selected by hostTopNRateBase."
Packit 022b05
    ::= { hostTopNEntry 4 }
Packit 022b05
Packit 022b05
-- The Matrix Group
Packit 022b05
Packit 022b05
-- Implementation of the Matrix group is optional.
Packit 022b05
-- Consult the MODULE-COMPLIANCE macro for the authoritative
Packit 022b05
-- conformance information for this MIB.
Packit 022b05
--
Packit 022b05
-- The Matrix group consists of the matrixControlTable, matrixSDTable
Packit 022b05
-- and the matrixDSTable.  These tables store statistics for a
Packit 022b05
-- particular conversation between two addresses.  As the device
Packit 022b05
-- detects a new conversation, including those to a non-unicast
Packit 022b05
-- address, it creates a new entry in both of the matrix tables.
Packit 022b05
-- It must only create new entries based on information
Packit 022b05
-- received in good packets.  If the monitoring device finds
Packit 022b05
-- itself short of resources, it may delete entries as needed.
Packit 022b05
-- It is suggested that the device delete the least recently used
Packit 022b05
-- entries first.
Packit 022b05
Packit 022b05
matrixControlTable OBJECT-TYPE
Packit 022b05
    SYNTAX     SEQUENCE OF MatrixControlEntry
Packit 022b05
    MAX-ACCESS not-accessible
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A list of information entries for the
Packit 022b05
        traffic matrix on each interface."
Packit 022b05
    ::= { matrix 1 }
Packit 022b05
Packit 022b05
matrixControlEntry OBJECT-TYPE
Packit 022b05
    SYNTAX     MatrixControlEntry
Packit 022b05
    MAX-ACCESS not-accessible
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "Information about a traffic matrix on a particular
Packit 022b05
        interface.  For example, an instance of the
Packit 022b05
        matrixControlLastDeleteTime object might be named
Packit 022b05
        matrixControlLastDeleteTime.1"
Packit 022b05
    INDEX { matrixControlIndex }
Packit 022b05
    ::= { matrixControlTable 1 }
Packit 022b05
Packit 022b05
MatrixControlEntry ::= SEQUENCE {
Packit 022b05
    matrixControlIndex           Integer32,
Packit 022b05
    matrixControlDataSource      OBJECT IDENTIFIER,
Packit 022b05
    matrixControlTableSize       Integer32,
Packit 022b05
    matrixControlLastDeleteTime  TimeTicks,
Packit 022b05
    matrixControlOwner           OwnerString,
Packit 022b05
    matrixControlStatus          EntryStatus
Packit 022b05
}
Packit 022b05
Packit 022b05
matrixControlIndex OBJECT-TYPE
Packit 022b05
    SYNTAX     Integer32 (1..65535)
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "An index that uniquely identifies an entry in the
Packit 022b05
        matrixControl table.  Each such entry defines
Packit 022b05
        a function that discovers conversations on a particular
Packit 022b05
        interface and places statistics about them in the
Packit 022b05
        matrixSDTable and the matrixDSTable on behalf of this
Packit 022b05
        matrixControlEntry."
Packit 022b05
    ::= { matrixControlEntry 1 }
Packit 022b05
Packit 022b05
matrixControlDataSource OBJECT-TYPE
Packit 022b05
    SYNTAX     OBJECT IDENTIFIER
Packit 022b05
    MAX-ACCESS read-create
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "This object identifies the source of
Packit 022b05
        the data from which this entry creates a traffic matrix.
Packit 022b05
        This source can be any interface on this device.  In
Packit 022b05
        order to identify a particular interface, this object
Packit 022b05
        shall identify the instance of the ifIndex object,
Packit 022b05
        defined in RFC 2233 [17], for the desired
Packit 022b05
        interface.  For example, if an entry were to receive data
Packit 022b05
        from interface #1, this object would be set to ifIndex.1.
Packit 022b05
Packit 022b05
        The statistics in this group reflect all packets
Packit 022b05
        on the local network segment attached to the identified
Packit 022b05
        interface.
Packit 022b05
Packit 022b05
        An agent may or may not be able to tell if fundamental
Packit 022b05
        changes to the media of the interface have occurred and
Packit 022b05
        necessitate an invalidation of this entry.  For example, a
Packit 022b05
        hot-pluggable ethernet card could be pulled out and replaced
Packit 022b05
        by a token-ring card.  In such a case, if the agent has such
Packit 022b05
        knowledge of the change, it is recommended that it
Packit 022b05
        invalidate this entry.
Packit 022b05
Packit 022b05
        This object may not be modified if the associated
Packit 022b05
        matrixControlStatus object is equal to valid(1)."
Packit 022b05
    ::= { matrixControlEntry 2 }
Packit 022b05
Packit 022b05
matrixControlTableSize OBJECT-TYPE
Packit 022b05
    SYNTAX     Integer32
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The number of matrixSDEntries in the matrixSDTable
Packit 022b05
        for this interface.  This must also be the value of
Packit 022b05
        the number of entries in the matrixDSTable for this
Packit 022b05
        interface."
Packit 022b05
    ::= { matrixControlEntry 3 }
Packit 022b05
Packit 022b05
matrixControlLastDeleteTime OBJECT-TYPE
Packit 022b05
    SYNTAX     TimeTicks
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The value of sysUpTime when the last entry
Packit 022b05
        was deleted from the portion of the matrixSDTable
Packit 022b05
        or matrixDSTable associated with this matrixControlEntry.
Packit 022b05
        If no deletions have occurred, this value shall be
Packit 022b05
        zero."
Packit 022b05
    ::= { matrixControlEntry 4 }
Packit 022b05
Packit 022b05
matrixControlOwner OBJECT-TYPE
Packit 022b05
    SYNTAX     OwnerString
Packit 022b05
    MAX-ACCESS read-create
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The entity that configured this entry and is therefore
Packit 022b05
        using the resources assigned to it."
Packit 022b05
    ::= { matrixControlEntry 5 }
Packit 022b05
Packit 022b05
matrixControlStatus OBJECT-TYPE
Packit 022b05
    SYNTAX     EntryStatus
Packit 022b05
    MAX-ACCESS read-create
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The status of this matrixControl entry.
Packit 022b05
        If this object is not equal to valid(1), all associated
Packit 022b05
        entries in the matrixSDTable and the matrixDSTable
Packit 022b05
        shall be deleted by the agent."
Packit 022b05
    ::= { matrixControlEntry 6 }
Packit 022b05
Packit 022b05
matrixSDTable OBJECT-TYPE
Packit 022b05
    SYNTAX     SEQUENCE OF MatrixSDEntry
Packit 022b05
    MAX-ACCESS not-accessible
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A list of traffic matrix entries indexed by
Packit 022b05
        source and destination MAC address."
Packit 022b05
    ::= { matrix 2 }
Packit 022b05
Packit 022b05
matrixSDEntry OBJECT-TYPE
Packit 022b05
    SYNTAX     MatrixSDEntry
Packit 022b05
    MAX-ACCESS not-accessible
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A collection of statistics for communications between
Packit 022b05
        two addresses on a particular interface.  For example,
Packit 022b05
        an instance of the matrixSDPkts object might be named
Packit 022b05
        matrixSDPkts.1.6.8.0.32.27.3.176.6.8.0.32.10.8.113"
Packit 022b05
    INDEX { matrixSDIndex,
Packit 022b05
            matrixSDSourceAddress, matrixSDDestAddress }
Packit 022b05
    ::= { matrixSDTable 1 }
Packit 022b05
Packit 022b05
MatrixSDEntry ::= SEQUENCE {
Packit 022b05
    matrixSDSourceAddress       OCTET STRING,
Packit 022b05
    matrixSDDestAddress         OCTET STRING,
Packit 022b05
    matrixSDIndex               Integer32,
Packit 022b05
    matrixSDPkts                Counter32,
Packit 022b05
    matrixSDOctets              Counter32,
Packit 022b05
    matrixSDErrors              Counter32
Packit 022b05
}
Packit 022b05
Packit 022b05
matrixSDSourceAddress OBJECT-TYPE
Packit 022b05
    SYNTAX     OCTET STRING
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The source physical address."
Packit 022b05
    ::= { matrixSDEntry 1 }
Packit 022b05
Packit 022b05
matrixSDDestAddress OBJECT-TYPE
Packit 022b05
    SYNTAX     OCTET STRING
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The destination physical address."
Packit 022b05
    ::= { matrixSDEntry 2 }
Packit 022b05
Packit 022b05
matrixSDIndex OBJECT-TYPE
Packit 022b05
    SYNTAX     Integer32 (1..65535)
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The set of collected matrix statistics of which
Packit 022b05
        this entry is a part.  The set of matrix statistics
Packit 022b05
        identified by a particular value of this index
Packit 022b05
        is associated with the same matrixControlEntry
Packit 022b05
        as identified by the same value of matrixControlIndex."
Packit 022b05
    ::= { matrixSDEntry 3 }
Packit 022b05
Packit 022b05
matrixSDPkts OBJECT-TYPE
Packit 022b05
    SYNTAX     Counter32
Packit 022b05
    UNITS      "Packets"
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The number of packets transmitted from the source
Packit 022b05
        address to the destination address (this number includes
Packit 022b05
        bad packets)."
Packit 022b05
    ::= { matrixSDEntry 4 }
Packit 022b05
Packit 022b05
matrixSDOctets OBJECT-TYPE
Packit 022b05
    SYNTAX     Counter32
Packit 022b05
    UNITS      "Octets"
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The number of octets (excluding framing bits but
Packit 022b05
        including FCS octets) contained in all packets
Packit 022b05
        transmitted from the source address to the
Packit 022b05
        destination address."
Packit 022b05
    ::= { matrixSDEntry 5 }
Packit 022b05
Packit 022b05
matrixSDErrors OBJECT-TYPE
Packit 022b05
    SYNTAX     Counter32
Packit 022b05
    UNITS      "Packets"
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The number of bad packets transmitted from
Packit 022b05
        the source address to the destination address."
Packit 022b05
    ::= { matrixSDEntry 6 }
Packit 022b05
Packit 022b05
-- Traffic matrix tables from destination to source
Packit 022b05
Packit 022b05
matrixDSTable OBJECT-TYPE
Packit 022b05
    SYNTAX     SEQUENCE OF MatrixDSEntry
Packit 022b05
    MAX-ACCESS not-accessible
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A list of traffic matrix entries indexed by
Packit 022b05
        destination and source MAC address."
Packit 022b05
    ::= { matrix 3 }
Packit 022b05
Packit 022b05
matrixDSEntry OBJECT-TYPE
Packit 022b05
    SYNTAX     MatrixDSEntry
Packit 022b05
    MAX-ACCESS not-accessible
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A collection of statistics for communications between
Packit 022b05
        two addresses on a particular interface.  For example,
Packit 022b05
        an instance of the matrixSDPkts object might be named
Packit 022b05
        matrixSDPkts.1.6.8.0.32.10.8.113.6.8.0.32.27.3.176"
Packit 022b05
    INDEX { matrixDSIndex,
Packit 022b05
            matrixDSDestAddress, matrixDSSourceAddress }
Packit 022b05
    ::= { matrixDSTable 1 }
Packit 022b05
Packit 022b05
MatrixDSEntry ::= SEQUENCE {
Packit 022b05
    matrixDSSourceAddress       OCTET STRING,
Packit 022b05
    matrixDSDestAddress         OCTET STRING,
Packit 022b05
    matrixDSIndex               Integer32,
Packit 022b05
    matrixDSPkts                Counter32,
Packit 022b05
    matrixDSOctets              Counter32,
Packit 022b05
    matrixDSErrors              Counter32
Packit 022b05
}
Packit 022b05
Packit 022b05
matrixDSSourceAddress OBJECT-TYPE
Packit 022b05
    SYNTAX     OCTET STRING
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The source physical address."
Packit 022b05
    ::= { matrixDSEntry 1 }
Packit 022b05
Packit 022b05
matrixDSDestAddress OBJECT-TYPE
Packit 022b05
    SYNTAX     OCTET STRING
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The destination physical address."
Packit 022b05
    ::= { matrixDSEntry 2 }
Packit 022b05
Packit 022b05
matrixDSIndex OBJECT-TYPE
Packit 022b05
    SYNTAX     Integer32 (1..65535)
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The set of collected matrix statistics of which
Packit 022b05
        this entry is a part.  The set of matrix statistics
Packit 022b05
        identified by a particular value of this index
Packit 022b05
        is associated with the same matrixControlEntry
Packit 022b05
        as identified by the same value of matrixControlIndex."
Packit 022b05
    ::= { matrixDSEntry 3 }
Packit 022b05
Packit 022b05
matrixDSPkts OBJECT-TYPE
Packit 022b05
    SYNTAX     Counter32
Packit 022b05
    UNITS      "Packets"
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The number of packets transmitted from the source
Packit 022b05
        address to the destination address (this number includes
Packit 022b05
        bad packets)."
Packit 022b05
    ::= { matrixDSEntry 4 }
Packit 022b05
Packit 022b05
matrixDSOctets OBJECT-TYPE
Packit 022b05
    SYNTAX     Counter32
Packit 022b05
    UNITS      "Octets"
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The number of octets (excluding framing bits
Packit 022b05
        but including FCS octets) contained in all packets
Packit 022b05
        transmitted from the source address to the
Packit 022b05
        destination address."
Packit 022b05
    ::= { matrixDSEntry 5 }
Packit 022b05
Packit 022b05
matrixDSErrors OBJECT-TYPE
Packit 022b05
    SYNTAX     Counter32
Packit 022b05
    UNITS      "Packets"
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The number of bad packets transmitted from
Packit 022b05
        the source address to the destination address."
Packit 022b05
    ::= { matrixDSEntry 6 }
Packit 022b05
Packit 022b05
-- The Filter Group
Packit 022b05
Packit 022b05
-- Implementation of the Filter group is optional.
Packit 022b05
Packit 022b05
-- Consult the MODULE-COMPLIANCE macro for the authoritative
Packit 022b05
-- conformance information for this MIB.
Packit 022b05
--
Packit 022b05
-- The Filter group allows packets to be captured with an
Packit 022b05
-- arbitrary filter expression.  A logical data and
Packit 022b05
-- event stream or "channel" is formed by the packets
Packit 022b05
-- that match the filter expression.
Packit 022b05
--
Packit 022b05
-- This filter mechanism allows the creation of an arbitrary
Packit 022b05
-- logical expression with which to filter packets.  Each
Packit 022b05
-- filter associated with a channel is OR'ed with the others.
Packit 022b05
-- Within a filter, any bits checked in the data and status are
Packit 022b05
-- AND'ed with respect to other bits in the same filter.  The
Packit 022b05
-- NotMask also allows for checking for inequality.  Finally,
Packit 022b05
-- the channelAcceptType object allows for inversion of the
Packit 022b05
-- whole equation.
Packit 022b05
--
Packit 022b05
-- If a management station wishes to receive a trap to alert it
Packit 022b05
-- that new packets have been captured and are available for
Packit 022b05
-- download, it is recommended that it set up an alarm entry that
Packit 022b05
-- monitors the value of the relevant channelMatches instance.
Packit 022b05
--
Packit 022b05
-- The channel can be turned on or off, and can also
Packit 022b05
-- generate events when packets pass through it.
Packit 022b05
Packit 022b05
filterTable OBJECT-TYPE
Packit 022b05
    SYNTAX     SEQUENCE OF FilterEntry
Packit 022b05
    MAX-ACCESS not-accessible
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A list of packet filter entries."
Packit 022b05
    ::= { filter 1 }
Packit 022b05
Packit 022b05
filterEntry OBJECT-TYPE
Packit 022b05
    SYNTAX     FilterEntry
Packit 022b05
    MAX-ACCESS not-accessible
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A set of parameters for a packet filter applied on a
Packit 022b05
        particular interface.  As an example, an instance of the
Packit 022b05
        filterPktData object might be named filterPktData.12"
Packit 022b05
    INDEX { filterIndex }
Packit 022b05
    ::= { filterTable 1 }
Packit 022b05
Packit 022b05
FilterEntry ::= SEQUENCE {
Packit 022b05
    filterIndex                 Integer32,
Packit 022b05
    filterChannelIndex          Integer32,
Packit 022b05
    filterPktDataOffset         Integer32,
Packit 022b05
    filterPktData               OCTET STRING,
Packit 022b05
    filterPktDataMask           OCTET STRING,
Packit 022b05
    filterPktDataNotMask        OCTET STRING,
Packit 022b05
    filterPktStatus             Integer32,
Packit 022b05
    filterPktStatusMask         Integer32,
Packit 022b05
    filterPktStatusNotMask      Integer32,
Packit 022b05
    filterOwner                 OwnerString,
Packit 022b05
    filterStatus                EntryStatus
Packit 022b05
}
Packit 022b05
Packit 022b05
filterIndex OBJECT-TYPE
Packit 022b05
    SYNTAX     Integer32 (1..65535)
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "An index that uniquely identifies an entry
Packit 022b05
        in the filter table.  Each such entry defines
Packit 022b05
        one filter that is to be applied to every packet
Packit 022b05
        received on an interface."
Packit 022b05
    ::= { filterEntry 1 }
Packit 022b05
Packit 022b05
filterChannelIndex OBJECT-TYPE
Packit 022b05
    SYNTAX     Integer32 (1..65535)
Packit 022b05
    MAX-ACCESS read-create
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "This object identifies the channel of which this filter
Packit 022b05
        is a part.  The filters identified by a particular value
Packit 022b05
        of this object are associated with the same channel as
Packit 022b05
        identified by the same value of the channelIndex object."
Packit 022b05
    ::= { filterEntry 2 }
Packit 022b05
Packit 022b05
filterPktDataOffset OBJECT-TYPE
Packit 022b05
    SYNTAX     Integer32
Packit 022b05
    UNITS      "Octets"
Packit 022b05
    MAX-ACCESS read-create
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The offset from the beginning of each packet where
Packit 022b05
        a match of packet data will be attempted.  This offset
Packit 022b05
        is measured from the point in the physical layer
Packit 022b05
        packet after the framing bits, if any.  For example,
Packit 022b05
        in an Ethernet frame, this point is at the beginning of
Packit 022b05
        the destination MAC address.
Packit 022b05
Packit 022b05
        This object may not be modified if the associated
Packit 022b05
        filterStatus object is equal to valid(1)."
Packit 022b05
    DEFVAL { 0 }
Packit 022b05
    ::= { filterEntry 3 }
Packit 022b05
Packit 022b05
filterPktData OBJECT-TYPE
Packit 022b05
    SYNTAX     OCTET STRING
Packit 022b05
    MAX-ACCESS read-create
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The data that is to be matched with the input packet.
Packit 022b05
        For each packet received, this filter and the accompanying
Packit 022b05
        filterPktDataMask and filterPktDataNotMask will be
Packit 022b05
        adjusted for the offset.  The only bits relevant to this
Packit 022b05
        match algorithm are those that have the corresponding
Packit 022b05
        filterPktDataMask bit equal to one.  The following three
Packit 022b05
        rules are then applied to every packet:
Packit 022b05
Packit 022b05
        (1) If the packet is too short and does not have data
Packit 022b05
            corresponding to part of the filterPktData, the packet
Packit 022b05
            will fail this data match.
Packit 022b05
Packit 022b05
        (2) For each relevant bit from the packet with the
Packit 022b05
            corresponding filterPktDataNotMask bit set to zero, if
Packit 022b05
            the bit from the packet is not equal to the corresponding
Packit 022b05
            bit from the filterPktData, then the packet will fail
Packit 022b05
            this data match.
Packit 022b05
Packit 022b05
        (3) If for every relevant bit from the packet with the
Packit 022b05
            corresponding filterPktDataNotMask bit set to one, the
Packit 022b05
            bit from the packet is equal to the corresponding bit
Packit 022b05
            from the filterPktData, then the packet will fail this
Packit 022b05
            data match.
Packit 022b05
Packit 022b05
        Any packets that have not failed any of the three matches
Packit 022b05
        above have passed this data match.  In particular, a zero
Packit 022b05
        length filter will match any packet.
Packit 022b05
Packit 022b05
        This object may not be modified if the associated
Packit 022b05
        filterStatus object is equal to valid(1)."
Packit 022b05
    ::= { filterEntry 4 }
Packit 022b05
Packit 022b05
filterPktDataMask OBJECT-TYPE
Packit 022b05
    SYNTAX     OCTET STRING
Packit 022b05
    MAX-ACCESS read-create
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The mask that is applied to the match process.
Packit 022b05
        After adjusting this mask for the offset, only those
Packit 022b05
        bits in the received packet that correspond to bits set
Packit 022b05
        in this mask are relevant for further processing by the
Packit 022b05
        match algorithm.  The offset is applied to filterPktDataMask
Packit 022b05
        in the same way it is applied to the filter.  For the
Packit 022b05
        purposes of the matching algorithm, if the associated
Packit 022b05
        filterPktData object is longer than this mask, this mask is
Packit 022b05
        conceptually extended with '1' bits until it reaches the
Packit 022b05
        length of the filterPktData object.
Packit 022b05
Packit 022b05
        This object may not be modified if the associated
Packit 022b05
        filterStatus object is equal to valid(1)."
Packit 022b05
    ::= { filterEntry 5 }
Packit 022b05
Packit 022b05
filterPktDataNotMask OBJECT-TYPE
Packit 022b05
    SYNTAX     OCTET STRING
Packit 022b05
    MAX-ACCESS read-create
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The inversion mask that is applied to the match
Packit 022b05
        process.  After adjusting this mask for the offset,
Packit 022b05
        those relevant bits in the received packet that correspond
Packit 022b05
        to bits cleared in this mask must all be equal to their
Packit 022b05
        corresponding bits in the filterPktData object for the packet
Packit 022b05
        to be accepted.  In addition, at least one of those relevant
Packit 022b05
        bits in the received packet that correspond to bits set in
Packit 022b05
        this mask must be different to its corresponding bit in the
Packit 022b05
        filterPktData object.
Packit 022b05
Packit 022b05
        For the purposes of the matching algorithm, if the associated
Packit 022b05
        filterPktData object is longer than this mask, this mask is
Packit 022b05
        conceptually extended with '0' bits until it reaches the
Packit 022b05
        length of the filterPktData object.
Packit 022b05
Packit 022b05
        This object may not be modified if the associated
Packit 022b05
        filterStatus object is equal to valid(1)."
Packit 022b05
    ::= { filterEntry 6 }
Packit 022b05
Packit 022b05
filterPktStatus OBJECT-TYPE
Packit 022b05
    SYNTAX     Integer32
Packit 022b05
    MAX-ACCESS read-create
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The status that is to be matched with the input packet.
Packit 022b05
        The only bits relevant to this match algorithm are those that
Packit 022b05
        have the corresponding filterPktStatusMask bit equal to one.
Packit 022b05
        The following two rules are then applied to every packet:
Packit 022b05
Packit 022b05
        (1) For each relevant bit from the packet status with the
Packit 022b05
            corresponding filterPktStatusNotMask bit set to zero, if
Packit 022b05
            the bit from the packet status is not equal to the
Packit 022b05
            corresponding bit from the filterPktStatus, then the
Packit 022b05
            packet will fail this status match.
Packit 022b05
Packit 022b05
        (2) If for every relevant bit from the packet status with the
Packit 022b05
            corresponding filterPktStatusNotMask bit set to one, the
Packit 022b05
            bit from the packet status is equal to the corresponding
Packit 022b05
            bit from the filterPktStatus, then the packet will fail
Packit 022b05
            this status match.
Packit 022b05
Packit 022b05
        Any packets that have not failed either of the two matches
Packit 022b05
        above have passed this status match.  In particular, a zero
Packit 022b05
        length status filter will match any packet's status.
Packit 022b05
Packit 022b05
        The value of the packet status is a sum.  This sum
Packit 022b05
        initially takes the value zero.  Then, for each
Packit 022b05
        error, E, that has been discovered in this packet,
Packit 022b05
        2 raised to a value representing E is added to the sum.
Packit 022b05
        The errors and the bits that represent them are dependent
Packit 022b05
        on the media type of the interface that this channel
Packit 022b05
        is receiving packets from.
Packit 022b05
Packit 022b05
        The errors defined for a packet captured off of an
Packit 022b05
        Ethernet interface are as follows:
Packit 022b05
Packit 022b05
            bit #    Error
Packit 022b05
                0    Packet is longer than 1518 octets
Packit 022b05
                1    Packet is shorter than 64 octets
Packit 022b05
                2    Packet experienced a CRC or Alignment error
Packit 022b05
Packit 022b05
        For example, an Ethernet fragment would have a
Packit 022b05
        value of 6 (2^1 + 2^2).
Packit 022b05
Packit 022b05
        As this MIB is expanded to new media types, this object
Packit 022b05
        will have other media-specific errors defined.
Packit 022b05
Packit 022b05
        For the purposes of this status matching algorithm, if the
Packit 022b05
        packet status is longer than this filterPktStatus object,
Packit 022b05
        this object is conceptually extended with '0' bits until it
Packit 022b05
        reaches the size of the packet status.
Packit 022b05
Packit 022b05
        This object may not be modified if the associated
Packit 022b05
        filterStatus object is equal to valid(1)."
Packit 022b05
    ::= { filterEntry 7 }
Packit 022b05
Packit 022b05
filterPktStatusMask OBJECT-TYPE
Packit 022b05
    SYNTAX     Integer32
Packit 022b05
    MAX-ACCESS read-create
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The mask that is applied to the status match process.
Packit 022b05
        Only those bits in the received packet that correspond to
Packit 022b05
        bits set in this mask are relevant for further processing
Packit 022b05
        by the status match algorithm.  For the purposes
Packit 022b05
        of the matching algorithm, if the associated filterPktStatus
Packit 022b05
        object is longer than this mask, this mask is conceptually
Packit 022b05
        extended with '1' bits until it reaches the size of the
Packit 022b05
        filterPktStatus.  In addition, if a packet status is longer
Packit 022b05
        than this mask, this mask is conceptually extended with '0'
Packit 022b05
        bits until it reaches the size of the packet status.
Packit 022b05
Packit 022b05
        This object may not be modified if the associated
Packit 022b05
        filterStatus object is equal to valid(1)."
Packit 022b05
    ::= { filterEntry 8 }
Packit 022b05
Packit 022b05
filterPktStatusNotMask OBJECT-TYPE
Packit 022b05
    SYNTAX     Integer32
Packit 022b05
    MAX-ACCESS read-create
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The inversion mask that is applied to the status match
Packit 022b05
        process.  Those relevant bits in the received packet status
Packit 022b05
        that correspond to bits cleared in this mask must all be
Packit 022b05
        equal to their corresponding bits in the filterPktStatus
Packit 022b05
        object for the packet to be accepted.  In addition, at least
Packit 022b05
        one of those relevant bits in the received packet status
Packit 022b05
        that correspond to bits set in this mask must be different
Packit 022b05
        to its corresponding bit in the filterPktStatus object for
Packit 022b05
        the packet to be accepted.
Packit 022b05
Packit 022b05
        For the purposes of the matching algorithm, if the associated
Packit 022b05
        filterPktStatus object or a packet status is longer than this
Packit 022b05
        mask, this mask is conceptually extended with '0' bits until
Packit 022b05
        it reaches the longer of the lengths of the filterPktStatus
Packit 022b05
        object and the packet status.
Packit 022b05
Packit 022b05
        This object may not be modified if the associated
Packit 022b05
        filterStatus object is equal to valid(1)."
Packit 022b05
    ::= { filterEntry 9 }
Packit 022b05
Packit 022b05
filterOwner OBJECT-TYPE
Packit 022b05
    SYNTAX     OwnerString
Packit 022b05
    MAX-ACCESS read-create
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The entity that configured this entry and is therefore
Packit 022b05
        using the resources assigned to it."
Packit 022b05
    ::= { filterEntry 10 }
Packit 022b05
Packit 022b05
filterStatus OBJECT-TYPE
Packit 022b05
    SYNTAX     EntryStatus
Packit 022b05
    MAX-ACCESS read-create
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The status of this filter entry."
Packit 022b05
    ::= { filterEntry 11 }
Packit 022b05
Packit 022b05
channelTable OBJECT-TYPE
Packit 022b05
    SYNTAX     SEQUENCE OF ChannelEntry
Packit 022b05
    MAX-ACCESS not-accessible
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A list of packet channel entries."
Packit 022b05
    ::= { filter 2 }
Packit 022b05
Packit 022b05
channelEntry OBJECT-TYPE
Packit 022b05
    SYNTAX     ChannelEntry
Packit 022b05
    MAX-ACCESS not-accessible
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A set of parameters for a packet channel applied on a
Packit 022b05
        particular interface.  As an example, an instance of the
Packit 022b05
        channelMatches object might be named channelMatches.3"
Packit 022b05
    INDEX { channelIndex }
Packit 022b05
    ::= { channelTable 1 }
Packit 022b05
Packit 022b05
ChannelEntry ::= SEQUENCE {
Packit 022b05
    channelIndex                 Integer32,
Packit 022b05
    channelIfIndex               Integer32,
Packit 022b05
    channelAcceptType            INTEGER,
Packit 022b05
    channelDataControl           INTEGER,
Packit 022b05
    channelTurnOnEventIndex      Integer32,
Packit 022b05
    channelTurnOffEventIndex     Integer32,
Packit 022b05
    channelEventIndex            Integer32,
Packit 022b05
    channelEventStatus           INTEGER,
Packit 022b05
    channelMatches               Counter32,
Packit 022b05
    channelDescription           DisplayString,
Packit 022b05
    channelOwner                 OwnerString,
Packit 022b05
    channelStatus                EntryStatus
Packit 022b05
}
Packit 022b05
Packit 022b05
channelIndex OBJECT-TYPE
Packit 022b05
    SYNTAX     Integer32 (1..65535)
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "An index that uniquely identifies an entry in the channel
Packit 022b05
        table.  Each such entry defines one channel, a logical
Packit 022b05
        data and event stream.
Packit 022b05
Packit 022b05
        It is suggested that before creating a channel, an
Packit 022b05
        application should scan all instances of the
Packit 022b05
        filterChannelIndex object to make sure that there are no
Packit 022b05
        pre-existing filters that would be inadvertently be linked
Packit 022b05
        to the channel."
Packit 022b05
    ::= { channelEntry 1 }
Packit 022b05
Packit 022b05
channelIfIndex OBJECT-TYPE
Packit 022b05
    SYNTAX     Integer32 (1..65535)
Packit 022b05
    MAX-ACCESS read-create
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The value of this object uniquely identifies the
Packit 022b05
        interface on this remote network monitoring device to which
Packit 022b05
        the associated filters are applied to allow data into this
Packit 022b05
        channel.  The interface identified by a particular value
Packit 022b05
        of this object is the same interface as identified by the
Packit 022b05
        same value of the ifIndex object, defined in RFC 2233 [17].
Packit 022b05
Packit 022b05
        The filters in this group are applied to all packets on
Packit 022b05
        the local network segment attached to the identified
Packit 022b05
        interface.
Packit 022b05
Packit 022b05
        An agent may or may not be able to tell if fundamental
Packit 022b05
        changes to the media of the interface have occurred and
Packit 022b05
        necessitate an invalidation of this entry.  For example, a
Packit 022b05
        hot-pluggable ethernet card could be pulled out and replaced
Packit 022b05
        by a token-ring card.  In such a case, if the agent has such
Packit 022b05
        knowledge of the change, it is recommended that it
Packit 022b05
        invalidate this entry.
Packit 022b05
Packit 022b05
        This object may not be modified if the associated
Packit 022b05
        channelStatus object is equal to valid(1)."
Packit 022b05
    ::= { channelEntry 2 }
Packit 022b05
Packit 022b05
channelAcceptType OBJECT-TYPE
Packit 022b05
    SYNTAX     INTEGER {
Packit 022b05
                 acceptMatched(1),
Packit 022b05
                 acceptFailed(2)
Packit 022b05
               }
Packit 022b05
    MAX-ACCESS read-create
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "This object controls the action of the filters
Packit 022b05
        associated with this channel.  If this object is equal
Packit 022b05
        to acceptMatched(1), packets will be accepted to this
Packit 022b05
        channel if they are accepted by both the packet data and
Packit 022b05
        packet status matches of an associated filter.  If
Packit 022b05
        this object is equal to acceptFailed(2), packets will
Packit 022b05
        be accepted to this channel only if they fail either
Packit 022b05
        the packet data match or the packet status match of
Packit 022b05
        each of the associated filters.
Packit 022b05
Packit 022b05
        In particular, a channel with no associated filters will
Packit 022b05
        match no packets if set to acceptMatched(1) case and will
Packit 022b05
        match all packets in the acceptFailed(2) case.
Packit 022b05
Packit 022b05
        This object may not be modified if the associated
Packit 022b05
        channelStatus object is equal to valid(1)."
Packit 022b05
    ::= { channelEntry 3 }
Packit 022b05
Packit 022b05
channelDataControl OBJECT-TYPE
Packit 022b05
    SYNTAX     INTEGER {
Packit 022b05
                 on(1),
Packit 022b05
                 off(2)
Packit 022b05
               }
Packit 022b05
    MAX-ACCESS read-create
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "This object controls the flow of data through this channel.
Packit 022b05
        If this object is on(1), data, status and events flow
Packit 022b05
        through this channel.  If this object is off(2), data,
Packit 022b05
        status and events will not flow through this channel."
Packit 022b05
    DEFVAL { off }
Packit 022b05
    ::= { channelEntry 4 }
Packit 022b05
Packit 022b05
channelTurnOnEventIndex OBJECT-TYPE
Packit 022b05
    SYNTAX     Integer32 (0..65535)
Packit 022b05
    MAX-ACCESS read-create
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The value of this object identifies the event
Packit 022b05
        that is configured to turn the associated
Packit 022b05
        channelDataControl from off to on when the event is
Packit 022b05
        generated.  The event identified by a particular value
Packit 022b05
        of this object is the same event as identified by the
Packit 022b05
        same value of the eventIndex object.  If there is no
Packit 022b05
        corresponding entry in the eventTable, then no
Packit 022b05
        association exists.  In fact, if no event is intended
Packit 022b05
        for this channel, channelTurnOnEventIndex must be
Packit 022b05
        set to zero, a non-existent event index.
Packit 022b05
        This object may not be modified if the associated
Packit 022b05
        channelStatus object is equal to valid(1)."
Packit 022b05
    ::= { channelEntry 5 }
Packit 022b05
Packit 022b05
channelTurnOffEventIndex OBJECT-TYPE
Packit 022b05
    SYNTAX     Integer32 (0..65535)
Packit 022b05
    MAX-ACCESS read-create
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The value of this object identifies the event
Packit 022b05
        that is configured to turn the associated
Packit 022b05
        channelDataControl from on to off when the event is
Packit 022b05
        generated.  The event identified by a particular value
Packit 022b05
        of this object is the same event as identified by the
Packit 022b05
        same value of the eventIndex object.  If there is no
Packit 022b05
        corresponding entry in the eventTable, then no
Packit 022b05
        association exists.  In fact, if no event is intended
Packit 022b05
        for this channel, channelTurnOffEventIndex must be
Packit 022b05
        set to zero, a non-existent event index.
Packit 022b05
Packit 022b05
        This object may not be modified if the associated
Packit 022b05
        channelStatus object is equal to valid(1)."
Packit 022b05
    ::= { channelEntry 6 }
Packit 022b05
Packit 022b05
channelEventIndex OBJECT-TYPE
Packit 022b05
    SYNTAX     Integer32 (0..65535)
Packit 022b05
    MAX-ACCESS read-create
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The value of this object identifies the event
Packit 022b05
        that is configured to be generated when the
Packit 022b05
        associated channelDataControl is on and a packet
Packit 022b05
        is matched.  The event identified by a particular value
Packit 022b05
        of this object is the same event as identified by the
Packit 022b05
        same value of the eventIndex object.  If there is no
Packit 022b05
        corresponding entry in the eventTable, then no
Packit 022b05
        association exists.  In fact, if no event is intended
Packit 022b05
        for this channel, channelEventIndex must be
Packit 022b05
        set to zero, a non-existent event index.
Packit 022b05
Packit 022b05
        This object may not be modified if the associated
Packit 022b05
        channelStatus object is equal to valid(1)."
Packit 022b05
    ::= { channelEntry 7 }
Packit 022b05
Packit 022b05
channelEventStatus OBJECT-TYPE
Packit 022b05
    SYNTAX     INTEGER {
Packit 022b05
                 eventReady(1),
Packit 022b05
                 eventFired(2),
Packit 022b05
                 eventAlwaysReady(3)
Packit 022b05
               }
Packit 022b05
    MAX-ACCESS read-create
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The event status of this channel.
Packit 022b05
Packit 022b05
        If this channel is configured to generate events
Packit 022b05
        when packets are matched, a means of controlling
Packit 022b05
        the flow of those events is often needed.  When
Packit 022b05
        this object is equal to eventReady(1), a single
Packit 022b05
        event may be generated, after which this object
Packit 022b05
        will be set by the probe to eventFired(2).  While
Packit 022b05
        in the eventFired(2) state, no events will be
Packit 022b05
        generated until the object is modified to
Packit 022b05
        eventReady(1) (or eventAlwaysReady(3)).  The
Packit 022b05
        management station can thus easily respond to a
Packit 022b05
        notification of an event by re-enabling this object.
Packit 022b05
Packit 022b05
        If the management station wishes to disable this
Packit 022b05
        flow control and allow events to be generated
Packit 022b05
        at will, this object may be set to
Packit 022b05
        eventAlwaysReady(3).  Disabling the flow control
Packit 022b05
        is discouraged as it can result in high network
Packit 022b05
        traffic or other performance problems."
Packit 022b05
    DEFVAL { eventReady }
Packit 022b05
    ::= { channelEntry 8 }
Packit 022b05
Packit 022b05
channelMatches OBJECT-TYPE
Packit 022b05
    SYNTAX     Counter32
Packit 022b05
    UNITS      "Packets"
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The number of times this channel has matched a packet.
Packit 022b05
        Note that this object is updated even when
Packit 022b05
        channelDataControl is set to off."
Packit 022b05
    ::= { channelEntry 9 }
Packit 022b05
Packit 022b05
channelDescription OBJECT-TYPE
Packit 022b05
    SYNTAX     DisplayString (SIZE (0..127))
Packit 022b05
    MAX-ACCESS read-create
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A comment describing this channel."
Packit 022b05
    ::= { channelEntry 10 }
Packit 022b05
Packit 022b05
channelOwner OBJECT-TYPE
Packit 022b05
    SYNTAX     OwnerString
Packit 022b05
    MAX-ACCESS read-create
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The entity that configured this entry and is therefore
Packit 022b05
        using the resources assigned to it."
Packit 022b05
    ::= { channelEntry 11 }
Packit 022b05
Packit 022b05
channelStatus OBJECT-TYPE
Packit 022b05
    SYNTAX     EntryStatus
Packit 022b05
    MAX-ACCESS read-create
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The status of this channel entry."
Packit 022b05
    ::= { channelEntry 12 }
Packit 022b05
Packit 022b05
-- The Packet Capture Group
Packit 022b05
Packit 022b05
-- Implementation of the Packet Capture group is optional. The Packet
Packit 022b05
-- Capture Group requires implementation of the Filter Group.
Packit 022b05
-- Consult the MODULE-COMPLIANCE macro for the authoritative
Packit 022b05
-- conformance information for this MIB.
Packit 022b05
--
Packit 022b05
-- The Packet Capture group allows packets to be captured
Packit 022b05
-- upon a filter match.  The bufferControlTable controls
Packit 022b05
-- the captured packets output from a channel that is
Packit 022b05
-- associated with it.  The captured packets are placed
Packit 022b05
-- in entries in the captureBufferTable.  These entries are
Packit 022b05
-- associated with the bufferControlEntry on whose behalf they
Packit 022b05
-- were stored.
Packit 022b05
Packit 022b05
bufferControlTable OBJECT-TYPE
Packit 022b05
    SYNTAX     SEQUENCE OF BufferControlEntry
Packit 022b05
    MAX-ACCESS not-accessible
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A list of buffers control entries."
Packit 022b05
    ::= { capture 1 }
Packit 022b05
Packit 022b05
bufferControlEntry OBJECT-TYPE
Packit 022b05
    SYNTAX     BufferControlEntry
Packit 022b05
    MAX-ACCESS not-accessible
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A set of parameters that control the collection of a stream
Packit 022b05
        of packets that have matched filters.  As an example, an
Packit 022b05
        instance of the bufferControlCaptureSliceSize object might
Packit 022b05
        be named bufferControlCaptureSliceSize.3"
Packit 022b05
    INDEX { bufferControlIndex }
Packit 022b05
    ::= { bufferControlTable 1 }
Packit 022b05
Packit 022b05
BufferControlEntry ::= SEQUENCE {
Packit 022b05
    bufferControlIndex                Integer32,
Packit 022b05
    bufferControlChannelIndex         Integer32,
Packit 022b05
    bufferControlFullStatus           INTEGER,
Packit 022b05
    bufferControlFullAction           INTEGER,
Packit 022b05
    bufferControlCaptureSliceSize     Integer32,
Packit 022b05
    bufferControlDownloadSliceSize    Integer32,
Packit 022b05
    bufferControlDownloadOffset       Integer32,
Packit 022b05
    bufferControlMaxOctetsRequested   Integer32,
Packit 022b05
    bufferControlMaxOctetsGranted     Integer32,
Packit 022b05
    bufferControlCapturedPackets      Integer32,
Packit 022b05
    bufferControlTurnOnTime           TimeTicks,
Packit 022b05
    bufferControlOwner                OwnerString,
Packit 022b05
    bufferControlStatus               EntryStatus
Packit 022b05
}
Packit 022b05
Packit 022b05
bufferControlIndex OBJECT-TYPE
Packit 022b05
    SYNTAX     Integer32 (1..65535)
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "An index that uniquely identifies an entry
Packit 022b05
        in the bufferControl table.  The value of this
Packit 022b05
        index shall never be zero.  Each such
Packit 022b05
        entry defines one set of packets that is
Packit 022b05
        captured and controlled by one or more filters."
Packit 022b05
    ::= { bufferControlEntry 1 }
Packit 022b05
Packit 022b05
bufferControlChannelIndex OBJECT-TYPE
Packit 022b05
    SYNTAX     Integer32 (1..65535)
Packit 022b05
    MAX-ACCESS read-create
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "An index that identifies the channel that is the
Packit 022b05
        source of packets for this bufferControl table.
Packit 022b05
        The channel identified by a particular value of this
Packit 022b05
        index is the same as identified by the same value of
Packit 022b05
        the channelIndex object.
Packit 022b05
Packit 022b05
        This object may not be modified if the associated
Packit 022b05
        bufferControlStatus object is equal to valid(1)."
Packit 022b05
    ::= { bufferControlEntry 2 }
Packit 022b05
Packit 022b05
bufferControlFullStatus OBJECT-TYPE
Packit 022b05
    SYNTAX     INTEGER {
Packit 022b05
                 spaceAvailable(1),
Packit 022b05
                 full(2)
Packit 022b05
               }
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "This object shows whether the buffer has room to
Packit 022b05
        accept new packets or if it is full.
Packit 022b05
Packit 022b05
        If the status is spaceAvailable(1), the buffer is
Packit 022b05
        accepting new packets normally.  If the status is
Packit 022b05
        full(2) and the associated bufferControlFullAction
Packit 022b05
        object is wrapWhenFull, the buffer is accepting new
Packit 022b05
        packets by deleting enough of the oldest packets
Packit 022b05
        to make room for new ones as they arrive.  Otherwise,
Packit 022b05
        if the status is full(2) and the
Packit 022b05
        bufferControlFullAction object is lockWhenFull,
Packit 022b05
        then the buffer has stopped collecting packets.
Packit 022b05
Packit 022b05
        When this object is set to full(2) the probe must
Packit 022b05
        not later set it to spaceAvailable(1) except in the
Packit 022b05
        case of a significant gain in resources such as
Packit 022b05
        an increase of bufferControlOctetsGranted.  In
Packit 022b05
        particular, the wrap-mode action of deleting old
Packit 022b05
        packets to make room for newly arrived packets
Packit 022b05
        must not affect the value of this object."
Packit 022b05
    ::= { bufferControlEntry 3 }
Packit 022b05
Packit 022b05
bufferControlFullAction OBJECT-TYPE
Packit 022b05
    SYNTAX     INTEGER {
Packit 022b05
                 lockWhenFull(1),
Packit 022b05
                 wrapWhenFull(2)    -- FIFO
Packit 022b05
               }
Packit 022b05
    MAX-ACCESS read-create
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "Controls the action of the buffer when it
Packit 022b05
        reaches the full status.  When in the lockWhenFull(1)
Packit 022b05
        state and a packet is added to the buffer that
Packit 022b05
        fills the buffer, the bufferControlFullStatus will
Packit 022b05
        be set to full(2) and this buffer will stop capturing
Packit 022b05
        packets."
Packit 022b05
    ::= { bufferControlEntry 4 }
Packit 022b05
Packit 022b05
bufferControlCaptureSliceSize OBJECT-TYPE
Packit 022b05
    SYNTAX     Integer32
Packit 022b05
    UNITS      "Octets"
Packit 022b05
    MAX-ACCESS read-create
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The maximum number of octets of each packet
Packit 022b05
        that will be saved in this capture buffer.
Packit 022b05
        For example, if a 1500 octet packet is received by
Packit 022b05
        the probe and this object is set to 500, then only
Packit 022b05
        500 octets of the packet will be stored in the
Packit 022b05
        associated capture buffer.  If this variable is set
Packit 022b05
        to 0, the capture buffer will save as many octets
Packit 022b05
        as is possible.
Packit 022b05
Packit 022b05
        This object may not be modified if the associated
Packit 022b05
        bufferControlStatus object is equal to valid(1)."
Packit 022b05
    DEFVAL { 100 }
Packit 022b05
    ::= { bufferControlEntry 5 }
Packit 022b05
Packit 022b05
bufferControlDownloadSliceSize OBJECT-TYPE
Packit 022b05
    SYNTAX     Integer32
Packit 022b05
    UNITS      "Octets"
Packit 022b05
    MAX-ACCESS read-create
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The maximum number of octets of each packet
Packit 022b05
        in this capture buffer that will be returned in
Packit 022b05
        an SNMP retrieval of that packet.  For example,
Packit 022b05
        if 500 octets of a packet have been stored in the
Packit 022b05
        associated capture buffer, the associated
Packit 022b05
        bufferControlDownloadOffset is 0, and this
Packit 022b05
        object is set to 100, then the captureBufferPacket
Packit 022b05
        object that contains the packet will contain only
Packit 022b05
        the first 100 octets of the packet.
Packit 022b05
Packit 022b05
        A prudent manager will take into account possible
Packit 022b05
        interoperability or fragmentation problems that may
Packit 022b05
        occur if the download slice size is set too large.
Packit 022b05
        In particular, conformant SNMP implementations are not
Packit 022b05
        required to accept messages whose length exceeds 484
Packit 022b05
        octets, although they are encouraged to support larger
Packit 022b05
        datagrams whenever feasible."
Packit 022b05
    DEFVAL { 100 }
Packit 022b05
    ::= { bufferControlEntry 6 }
Packit 022b05
Packit 022b05
bufferControlDownloadOffset OBJECT-TYPE
Packit 022b05
    SYNTAX     Integer32
Packit 022b05
    UNITS      "Octets"
Packit 022b05
    MAX-ACCESS read-create
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The offset of the first octet of each packet
Packit 022b05
        in this capture buffer that will be returned in
Packit 022b05
        an SNMP retrieval of that packet.  For example,
Packit 022b05
        if 500 octets of a packet have been stored in the
Packit 022b05
        associated capture buffer and this object is set to
Packit 022b05
        100, then the captureBufferPacket object that
Packit 022b05
        contains the packet will contain bytes starting
Packit 022b05
        100 octets into the packet."
Packit 022b05
    DEFVAL { 0 }
Packit 022b05
    ::= { bufferControlEntry 7 }
Packit 022b05
Packit 022b05
bufferControlMaxOctetsRequested OBJECT-TYPE
Packit 022b05
    SYNTAX     Integer32
Packit 022b05
    UNITS      "Octets"
Packit 022b05
    MAX-ACCESS read-create
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The requested maximum number of octets to be
Packit 022b05
        saved in this captureBuffer, including any
Packit 022b05
        implementation-specific overhead. If this variable
Packit 022b05
        is set to -1, the capture buffer will save as many
Packit 022b05
        octets as is possible.
Packit 022b05
Packit 022b05
        When this object is created or modified, the probe
Packit 022b05
        should set bufferControlMaxOctetsGranted as closely
Packit 022b05
        to this object as is possible for the particular probe
Packit 022b05
        implementation and available resources.  However, if
Packit 022b05
        the object has the special value of -1, the probe
Packit 022b05
        must set bufferControlMaxOctetsGranted to -1."
Packit 022b05
    DEFVAL { -1 }
Packit 022b05
    ::= { bufferControlEntry 8 }
Packit 022b05
Packit 022b05
bufferControlMaxOctetsGranted OBJECT-TYPE
Packit 022b05
    SYNTAX     Integer32
Packit 022b05
    UNITS      "Octets"
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The maximum number of octets that can be
Packit 022b05
        saved in this captureBuffer, including overhead.
Packit 022b05
        If this variable is -1, the capture buffer will save
Packit 022b05
        as many octets as possible.
Packit 022b05
Packit 022b05
        When the bufferControlMaxOctetsRequested object is
Packit 022b05
        created or modified, the probe should set this object
Packit 022b05
        as closely to the requested value as is possible for the
Packit 022b05
        particular probe implementation and available resources.
Packit 022b05
        However, if the request object has the special value
Packit 022b05
        of -1, the probe must set this object to -1.
Packit 022b05
Packit 022b05
        The probe must not lower this value except as a result of
Packit 022b05
        a modification to the associated
Packit 022b05
        bufferControlMaxOctetsRequested object.
Packit 022b05
Packit 022b05
        When this maximum number of octets is reached
Packit 022b05
        and a new packet is to be added to this
Packit