|
Packit |
022b05 |
RFC1271-MIB DEFINITIONS ::= BEGIN
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
IMPORTS
|
|
Packit |
022b05 |
Counter FROM RFC1155-SMI
|
|
Packit |
022b05 |
mib-2, DisplayString FROM RFC1213-MIB
|
|
Packit |
022b05 |
OBJECT-TYPE FROM RFC-1212;
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
-- This MIB module uses the extended OBJECT-TYPE macro as
|
|
Packit |
022b05 |
-- defined in [9].
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
-- Remote Network Monitoring MIB
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
rmon OBJECT IDENTIFIER ::= { mib-2 16 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
-- textual conventions
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
OwnerString ::= DisplayString
|
|
Packit |
022b05 |
-- This data type is used to model an administratively
|
|
Packit |
022b05 |
-- assigned name of the owner of a resource. This
|
|
Packit |
022b05 |
-- information is taken from the NVT ASCII character set.
|
|
Packit |
022b05 |
-- It is suggested that this name contain one or more
|
|
Packit |
022b05 |
-- of the following:
|
|
Packit |
022b05 |
-- IP address, management station name, network manager's
|
|
Packit |
022b05 |
-- 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 |
--
|
|
Packit |
022b05 |
-- SNMP access control is articulated entirely in terms of
|
|
Packit |
022b05 |
-- the contents of MIB views; access to a particular SNMP
|
|
Packit |
022b05 |
-- object instance depends only upon its presence or
|
|
Packit |
022b05 |
-- absence in a particular MIB view and never upon its
|
|
Packit |
022b05 |
-- value or the value of related object instances. Thus,
|
|
Packit |
022b05 |
-- objects of this type afford resolution of resource
|
|
Packit |
022b05 |
-- contention only among cooperating managers; they
|
|
Packit |
022b05 |
-- realize no access control function with respect
|
|
Packit |
022b05 |
-- to uncooperative parties.
|
|
Packit |
022b05 |
--
|
|
Packit |
022b05 |
-- By convention, objects with this syntax are declared
|
|
Packit |
022b05 |
-- as having
|
|
Packit |
022b05 |
--
|
|
Packit |
022b05 |
-- SIZE (0..127)
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
EntryStatus ::= INTEGER
|
|
Packit |
022b05 |
{ valid(1),
|
|
Packit |
022b05 |
createRequest(2),
|
|
Packit |
022b05 |
underCreation(3),
|
|
Packit |
022b05 |
invalid(4)
|
|
Packit |
022b05 |
}
|
|
Packit |
022b05 |
|
|
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 to complete a conceptual
|
|
Packit |
022b05 |
-- row in this table. Immediately after completing the
|
|
Packit |
022b05 |
-- create operation, the agent must set this object to
|
|
Packit |
022b05 |
-- underCreation(3).
|
|
Packit |
022b05 |
--
|
|
Packit |
022b05 |
-- Entries shall exist in the underCreation(3) state until
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
-- the management station is finished configuring the
|
|
Packit |
022b05 |
-- entry and sets this object to valid(1) or aborts,
|
|
Packit |
022b05 |
-- setting this object to invalid(4). If the agent
|
|
Packit |
022b05 |
-- determines that an entry has been in the
|
|
Packit |
022b05 |
-- underCreation(3) state for an abnormally long time,
|
|
Packit |
022b05 |
-- it may decide that the management station has
|
|
Packit |
022b05 |
-- 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 |
|
|
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 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
-- The Statistics Group
|
|
Packit |
022b05 |
--
|
|
Packit |
022b05 |
-- Implementation of the Statistics group is optional.
|
|
Packit |
022b05 |
--
|
|
Packit |
022b05 |
-- The 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
|
|
Packit |
022b05 |
-- start from 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
|
|
Packit |
022b05 |
-- statistics for one Ethernet interface. The probe must
|
|
Packit |
022b05 |
-- create one etherStats entry for each monitored Ethernet
|
|
Packit |
022b05 |
-- interface on the device.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
etherStatsTable OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX SEQUENCE OF EtherStatsEntry
|
|
Packit |
022b05 |
ACCESS not-accessible
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 |
ACCESS not-accessible
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"A collection of statistics kept for a particular
|
|
Packit |
022b05 |
Ethernet interface."
|
|
Packit |
022b05 |
INDEX { etherStatsIndex }
|
|
Packit |
022b05 |
::= { etherStatsTable 1 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
EtherStatsEntry ::= SEQUENCE {
|
|
Packit |
022b05 |
etherStatsIndex INTEGER (1..65535),
|
|
Packit |
022b05 |
etherStatsDataSource OBJECT IDENTIFIER,
|
|
Packit |
022b05 |
etherStatsDropEvents Counter,
|
|
Packit |
022b05 |
etherStatsOctets Counter,
|
|
Packit |
022b05 |
etherStatsPkts Counter,
|
|
Packit |
022b05 |
etherStatsBroadcastPkts Counter,
|
|
Packit |
022b05 |
etherStatsMulticastPkts Counter,
|
|
Packit |
022b05 |
etherStatsCRCAlignErrors Counter,
|
|
Packit |
022b05 |
etherStatsUndersizePkts Counter,
|
|
Packit |
022b05 |
etherStatsOversizePkts Counter,
|
|
Packit |
022b05 |
etherStatsFragments Counter,
|
|
Packit |
022b05 |
etherStatsJabbers Counter,
|
|
Packit |
022b05 |
etherStatsCollisions Counter,
|
|
Packit |
022b05 |
etherStatsPkts64Octets Counter,
|
|
Packit |
022b05 |
etherStatsPkts65to127Octets Counter,
|
|
Packit |
022b05 |
etherStatsPkts128to255Octets Counter,
|
|
Packit |
022b05 |
etherStatsPkts256to511Octets Counter,
|
|
Packit |
022b05 |
etherStatsPkts512to1023Octets Counter,
|
|
Packit |
022b05 |
etherStatsPkts1024to1518Octets Counter,
|
|
Packit |
022b05 |
etherStatsOwner OwnerString,
|
|
Packit |
022b05 |
etherStatsStatus INTEGER
|
|
Packit |
022b05 |
}
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
etherStatsIndex OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX INTEGER (1..65535)
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 |
ACCESS read-write
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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
|
|
Packit |
022b05 |
object shall identify the instance of the ifIndex
|
|
Packit |
022b05 |
object, defined in [4,6], 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
|
|
Packit |
022b05 |
identified interface.
|
|
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 Counter
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 Counter
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 |
::= { etherStatsEntry 4 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
etherStatsPkts OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX Counter
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The total number of packets (including error packets)
|
|
Packit |
022b05 |
received."
|
|
Packit |
022b05 |
::= { etherStatsEntry 5 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
etherStatsBroadcastPkts OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX Counter
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The total number of good packets received that were
|
|
Packit |
022b05 |
directed to the broadcast address."
|
|
Packit |
022b05 |
::= { etherStatsEntry 6 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
etherStatsMulticastPkts OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX Counter
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The total number of good packets received that were
|
|
Packit |
022b05 |
directed to a multicast address. Note that this
|
|
Packit |
022b05 |
number does not include packets directed to the
|
|
Packit |
022b05 |
broadcast address."
|
|
Packit |
022b05 |
::= { etherStatsEntry 7 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
etherStatsCRCAlignErrors OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX Counter
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 were not an integral number
|
|
Packit |
022b05 |
of octets in length or had a bad Frame Check
|
|
Packit |
022b05 |
Sequence (FCS)."
|
|
Packit |
022b05 |
::= { etherStatsEntry 8 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
etherStatsUndersizePkts OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX Counter
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 Counter
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 Counter
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The total number of packets received that were not an
|
|
Packit |
022b05 |
integral number of octets in length or that had a bad
|
|
Packit |
022b05 |
Frame Check Sequence (FCS), and were less than 64
|
|
Packit |
022b05 |
octets in length (excluding framing bits but
|
|
Packit |
022b05 |
including FCS octets)."
|
|
Packit |
022b05 |
::= { etherStatsEntry 11 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
etherStatsJabbers OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX Counter
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 not an
|
|
Packit |
022b05 |
integral number of octets in length or had
|
|
Packit |
022b05 |
a bad Frame Check Sequence (FCS)."
|
|
Packit |
022b05 |
::= { etherStatsEntry 12 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
etherStatsCollisions OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX Counter
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The best estimate of the total number of collisions
|
|
Packit |
022b05 |
on this Ethernet segment."
|
|
Packit |
022b05 |
::= { etherStatsEntry 13 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
etherStatsPkts64Octets OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX Counter
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The total number of packets (including error
|
|
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 Counter
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The total number of packets (including error
|
|
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 Counter
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The total number of packets (including error
|
|
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 Counter
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The total number of packets (including error
|
|
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 Counter
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The total number of packets (including error
|
|
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 Counter
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The total number of packets (including error
|
|
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 |
ACCESS read-write
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The entity that configured this entry and is
|
|
Packit |
022b05 |
therefore using the resources assigned to it."
|
|
Packit |
022b05 |
::= { etherStatsEntry 20 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
etherStatsStatus OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX EntryStatus
|
|
Packit |
022b05 |
ACCESS read-write
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The status of this etherStats entry."
|
|
Packit |
022b05 |
::= { etherStatsEntry 21 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
-- The History Group
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
-- Implementation of the History group is optional.
|
|
Packit |
022b05 |
--
|
|
Packit |
022b05 |
-- The history group records periodic statistical samples from
|
|
Packit |
022b05 |
-- a network and stores them for later retrieval. The
|
|
Packit |
022b05 |
-- historyControl table 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. Currently the only media-
|
|
Packit |
022b05 |
-- specific table defined is the etherHistoryTable, for
|
|
Packit |
022b05 |
-- Ethernet networks.
|
|
Packit |
022b05 |
--
|
|
Packit |
022b05 |
-- If the probe keeps track of the time of day, it should
|
|
Packit |
022b05 |
-- start 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 |
|
|
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 monitor is encouraged to add two history control entries
|
|
Packit |
022b05 |
-- per monitored interface upon initialization that describe
|
|
Packit |
022b05 |
-- a short term and a long term polling period. Suggested
|
|
Packit |
022b05 |
-- parameters are 30 seconds for the short term polling
|
|
Packit |
022b05 |
-- period and 30 minutes for the long term period.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
historyControlTable OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX SEQUENCE OF HistoryControlEntry
|
|
Packit |
022b05 |
ACCESS not-accessible
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 |
ACCESS not-accessible
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"A list of parameters that set up a periodic
|
|
Packit |
022b05 |
sampling of statistics."
|
|
Packit |
022b05 |
INDEX { historyControlIndex }
|
|
Packit |
022b05 |
::= { historyControlTable 1 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
HistoryControlEntry ::= SEQUENCE {
|
|
Packit |
022b05 |
historyControlIndex INTEGER (1..65535),
|
|
Packit |
022b05 |
historyControlDataSource OBJECT IDENTIFIER,
|
|
Packit |
022b05 |
historyControlBucketsRequested INTEGER (1..65535),
|
|
Packit |
022b05 |
historyControlBucketsGranted INTEGER (1..65535),
|
|
Packit |
022b05 |
historyControlInterval INTEGER (1..3600),
|
|
Packit |
022b05 |
historyControlOwner OwnerString,
|
|
Packit |
022b05 |
historyControlStatus INTEGER
|
|
Packit |
022b05 |
}
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
historyControlIndex OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX INTEGER (1..65535)
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 |
ACCESS read-write
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 [4,6], for the desired interface. For example,
|
|
Packit |
022b05 |
if an entry were to receive data from interface #1,
|
|
Packit |
022b05 |
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
|
|
Packit |
022b05 |
identified interface.
|
|
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 INTEGER (1..65535)
|
|
Packit |
022b05 |
ACCESS read-write
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 |
historyControl entry.
|
|
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 INTEGER (1..65535)
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 |
historyControl entry.
|
|
Packit |
022b05 |
|
|
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
|
|
Packit |
022b05 |
greater than the current value, the number of
|
|
Packit |
022b05 |
associated media-specific entries may be allowed
|
|
Packit |
022b05 |
to grow."
|
|
Packit |
022b05 |
::= { historyControlEntry 4 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
historyControlInterval OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX INTEGER (1..3600)
|
|
Packit |
022b05 |
ACCESS read-write
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 |
historyControl entry. 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
|
|
Packit |
022b05 |
will take into account the possibility of overflow
|
|
Packit |
022b05 |
in any of the associated counters. It is important
|
|
Packit |
022b05 |
to consider the minimum time in which any counter
|
|
Packit |
022b05 |
could overflow on a particular media type and set
|
|
Packit |
022b05 |
the historyControlInterval object to a value less
|
|
Packit |
022b05 |
than this interval. This is typically most
|
|
Packit |
022b05 |
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 |
ACCESS read-write
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 |
ACCESS read-write
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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
|
|
Packit |
022b05 |
agent if this historyControlEntry is not equal to
|
|
Packit |
022b05 |
valid(1)."
|
|
Packit |
022b05 |
::= { historyControlEntry 7 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
-- Ether History table
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
etherHistoryTable OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX SEQUENCE OF EtherHistoryEntry
|
|
Packit |
022b05 |
ACCESS not-accessible
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 |
ACCESS not-accessible
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"An historical sample of Ethernet statistics on a
|
|
Packit |
022b05 |
particular Ethernet interface. This sample is
|
|
Packit |
022b05 |
associated with the historyControlEntry which set
|
|
Packit |
022b05 |
up the parameters for a regular collection of these
|
|
Packit |
022b05 |
samples."
|
|
Packit |
022b05 |
INDEX { etherHistoryIndex , etherHistorySampleIndex }
|
|
Packit |
022b05 |
::= { etherHistoryTable 1 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
EtherHistoryEntry ::= SEQUENCE {
|
|
Packit |
022b05 |
etherHistoryIndex INTEGER (1..65535),
|
|
Packit |
022b05 |
etherHistorySampleIndex INTEGER,
|
|
Packit |
022b05 |
etherHistoryIntervalStart TimeTicks,
|
|
Packit |
022b05 |
etherHistoryDropEvents Counter,
|
|
Packit |
022b05 |
etherHistoryOctets Counter,
|
|
Packit |
022b05 |
etherHistoryPkts Counter,
|
|
Packit |
022b05 |
etherHistoryBroadcastPkts Counter,
|
|
Packit |
022b05 |
etherHistoryMulticastPkts Counter,
|
|
Packit |
022b05 |
etherHistoryCRCAlignErrors Counter,
|
|
Packit |
022b05 |
etherHistoryUndersizePkts Counter,
|
|
Packit |
022b05 |
etherHistoryOversizePkts Counter,
|
|
Packit |
022b05 |
etherHistoryFragments Counter,
|
|
Packit |
022b05 |
etherHistoryJabbers Counter,
|
|
Packit |
022b05 |
etherHistoryCollisions Counter,
|
|
Packit |
022b05 |
etherHistoryUtilization INTEGER (0..10000)
|
|
Packit |
022b05 |
}
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
etherHistoryIndex OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX INTEGER (1..65535)
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 INTEGER
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 Counter
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 interval. Note that this number is not
|
|
Packit |
022b05 |
necessarily the number of packets dropped, it is just
|
|
Packit |
022b05 |
the number of times this condition has been detected."
|
|
Packit |
022b05 |
::= { etherHistoryEntry 4 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
etherHistoryOctets OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX Counter
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 Counter
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The number of packets (including error packets)
|
|
Packit |
022b05 |
received during this sampling interval."
|
|
Packit |
022b05 |
::= { etherHistoryEntry 6 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
etherHistoryBroadcastPkts OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX Counter
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 Counter
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 Counter
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 were not an
|
|
Packit |
022b05 |
integral number of octets in length or had a
|
|
Packit |
022b05 |
bad Frame Check Sequence (FCS)."
|
|
Packit |
022b05 |
::= { etherHistoryEntry 9 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
etherHistoryUndersizePkts OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX Counter
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The number of packets received during this
|
|
Packit |
022b05 |
interval that were less than 64 octets long
|
|
Packit |
022b05 |
(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 Counter
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The number of packets received during this
|
|
Packit |
022b05 |
interval that were longer than 1518 octets
|
|
Packit |
022b05 |
(excluding framing bits but including FCS
|
|
Packit |
022b05 |
octets) but were otherwise well formed."
|
|
Packit |
022b05 |
::= { etherHistoryEntry 11 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
etherHistoryFragments OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX Counter
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The total number of packets received during this
|
|
Packit |
022b05 |
sampling interval that were not an integral
|
|
Packit |
022b05 |
number of octets in length or that
|
|
Packit |
022b05 |
had a bad Frame Check Sequence (FCS), and
|
|
Packit |
022b05 |
were less than 64 octets in length (excluding
|
|
Packit |
022b05 |
framing bits but including FCS octets)."
|
|
Packit |
022b05 |
::= { etherHistoryEntry 12 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
etherHistoryJabbers OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX Counter
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The number of packets received during this
|
|
Packit |
022b05 |
interval that were longer than 1518 octets
|
|
Packit |
022b05 |
(excluding framing bits but including FCS octets),
|
|
Packit |
022b05 |
and were not an integral number of octets in
|
|
Packit |
022b05 |
length or had a bad Frame Check Sequence (FCS)."
|
|
Packit |
022b05 |
::= { etherHistoryEntry 13 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
etherHistoryCollisions OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX Counter
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The best estimate of the total number of collisions
|
|
Packit |
022b05 |
on this Ethernet segment during this interval."
|
|
Packit |
022b05 |
::= { etherHistoryEntry 14 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
etherHistoryUtilization OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX INTEGER (0..10000)
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The best estimate of the mean physical layer
|
|
Packit |
022b05 |
network utilization on this interface during this
|
|
Packit |
022b05 |
interval, in hundredths of a percent."
|
|
Packit |
022b05 |
::= { etherHistoryEntry 15 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
-- The Alarm Group
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
-- Implementation of the Alarm group is optional.
|
|
Packit |
022b05 |
--
|
|
Packit |
022b05 |
-- The Alarm Group requires the implementation of the Event
|
|
Packit |
022b05 |
-- group.
|
|
Packit |
022b05 |
--
|
|
Packit |
022b05 |
-- The Alarm group periodically takes statistical samples from
|
|
Packit |
022b05 |
-- variables in the probe and compares them to thresholds
|
|
Packit |
022b05 |
-- that have been configured. The alarm table stores
|
|
Packit |
022b05 |
-- configuration entries that each define a variable,
|
|
Packit |
022b05 |
-- polling period, and threshold parameters. If a sample is
|
|
Packit |
022b05 |
-- found to cross the threshold values, an event is
|
|
Packit |
022b05 |
-- generated. Only variables that resolve to an ASN.1
|
|
Packit |
022b05 |
-- primitive type of INTEGER (INTEGER, Counter,
|
|
Packit |
022b05 |
-- Gauge, or TimeTicks) may be monitored in this way.
|
|
Packit |
022b05 |
--
|
|
Packit |
022b05 |
-- This function has a hysteresis mechanism to limit the
|
|
Packit |
022b05 |
-- generation of events. This mechanism generates one event
|
|
Packit |
022b05 |
-- as a threshold is crossed in the appropriate direction.
|
|
Packit |
022b05 |
-- No more events are generated for that threshold until the
|
|
Packit |
022b05 |
-- opposite threshold is crossed.
|
|
Packit |
022b05 |
--
|
|
Packit |
022b05 |
-- In the case of a sampling a deltaValue, a probe may
|
|
Packit |
022b05 |
-- implement this mechanism with more precision if it takes
|
|
Packit |
022b05 |
-- a delta sample twice per period, each time comparing the
|
|
Packit |
022b05 |
-- sum of the latest two samples to the threshold. This
|
|
Packit |
022b05 |
-- allows the detection of threshold crossings
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
-- that span the sampling boundary. Note that this does not
|
|
Packit |
022b05 |
-- require any special configuration of the threshold value.
|
|
Packit |
022b05 |
-- It is suggested that probes implement this more precise
|
|
Packit |
022b05 |
-- algorithm.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
alarmTable OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX SEQUENCE OF AlarmEntry
|
|
Packit |
022b05 |
ACCESS not-accessible
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 |
ACCESS not-accessible
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"A list of parameters that set up a periodic checking
|
|
Packit |
022b05 |
for alarm conditions."
|
|
Packit |
022b05 |
INDEX { alarmIndex }
|
|
Packit |
022b05 |
::= { alarmTable 1 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
AlarmEntry ::= SEQUENCE {
|
|
Packit |
022b05 |
alarmIndex INTEGER (1..65535),
|
|
Packit |
022b05 |
alarmInterval INTEGER,
|
|
Packit |
022b05 |
alarmVariable OBJECT IDENTIFIER,
|
|
Packit |
022b05 |
alarmSampleType INTEGER,
|
|
Packit |
022b05 |
alarmValue INTEGER,
|
|
Packit |
022b05 |
alarmStartupAlarm INTEGER,
|
|
Packit |
022b05 |
alarmRisingThreshold INTEGER,
|
|
Packit |
022b05 |
alarmFallingThreshold INTEGER,
|
|
Packit |
022b05 |
alarmRisingEventIndex INTEGER (1..65535),
|
|
Packit |
022b05 |
alarmFallingEventIndex INTEGER (1..65535),
|
|
Packit |
022b05 |
alarmOwner OwnerString,
|
|
Packit |
022b05 |
alarmStatus INTEGER
|
|
Packit |
022b05 |
}
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
alarmIndex OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX INTEGER (1..65535)
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 INTEGER
|
|
Packit |
022b05 |
ACCESS read-write
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 given to ensure that the variable being
|
|
Packit |
022b05 |
monitored will not exceed 2^31 - 1 and roll
|
|
Packit |
022b05 |
over the alarmValue object during the 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 |
ACCESS read-write
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The object identifier of the particular variable to
|
|
Packit |
022b05 |
be sampled. Only variables that resolve to an ASN.1
|
|
Packit |
022b05 |
primitive type of INTEGER (INTEGER, Counter, Gauge,
|
|
Packit |
022b05 |
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
|
|
Packit |
022b05 |
name is not available in the selected MIB view, a
|
|
Packit |
022b05 |
badValue error must be returned. If at any time
|
|
Packit |
022b05 |
the variable name of an established alarmEntry is
|
|
Packit |
022b05 |
no longer available in the selected MIB view, the
|
|
Packit |
022b05 |
probe must change the status of this alarmEntry
|
|
Packit |
022b05 |
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 |
ACCESS read-write
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 INTEGER
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The value of the statistic during the last sampling
|
|
Packit |
022b05 |
period. The value during the current sampling period
|
|
Packit |
022b05 |
is not made available until the period is completed."
|
|
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 |
ACCESS read-write
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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
|
|
Packit |
022b05 |
single rising alarm will be generated. If the first
|
|
Packit |
022b05 |
sample after this entry becomes valid is less than
|
|
Packit |
022b05 |
or equal to the fallingThreshold and
|
|
Packit |
022b05 |
alarmStartupAlarm is equal to fallingAlarm(2) or
|
|
Packit |
022b05 |
risingOrFallingAlarm(3), then a single falling
|
|
Packit |
022b05 |
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 INTEGER
|
|
Packit |
022b05 |
ACCESS read-write
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"A threshold for the sampled statistic. When the
|
|
Packit |
022b05 |
current sampled value is greater than or equal to
|
|
Packit |
022b05 |
this threshold, and the value at the last sampling
|
|
Packit |
022b05 |
interval was less than this threshold, a single
|
|
Packit |
022b05 |
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
|
|
Packit |
022b05 |
than or 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 INTEGER
|
|
Packit |
022b05 |
ACCESS read-write
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"A threshold for the sampled statistic. When the
|
|
Packit |
022b05 |
current sampled value is less than or equal to
|
|
Packit |
022b05 |
this threshold, and the value at the last sampling
|
|
Packit |
022b05 |
interval was greater than this threshold, a single
|
|
Packit |
022b05 |
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 INTEGER (0..65535)
|
|
Packit |
022b05 |
ACCESS read-write
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 INTEGER (0..65535)
|
|
Packit |
022b05 |
ACCESS read-write
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 |
ACCESS read-write
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The entity that configured this entry and is
|
|
Packit |
022b05 |
therefore using the resources assigned to it."
|
|
Packit |
022b05 |
::= { alarmEntry 11 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
alarmStatus OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX EntryStatus
|
|
Packit |
022b05 |
ACCESS read-write
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The status of this alarm entry."
|
|
Packit |
022b05 |
::= { alarmEntry 12 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
-- The Host Group
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
-- Implementation of the Host group is optional.
|
|
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
|
|
Packit |
022b05 |
-- group keeps a set of statistics. The hostControlTable
|
|
Packit |
022b05 |
-- controls which interfaces this function is performed on,
|
|
Packit |
022b05 |
-- and contains some information about the process. On
|
|
Packit |
022b05 |
-- behalf of each hostControlEntry, data is collected on an
|
|
Packit |
022b05 |
-- interface and placed both the hostTable and the
|
|
Packit |
022b05 |
-- hostTimeTable. If the monitoring device finds itself
|
|
Packit |
022b05 |
-- short of resources, it may delete entries as needed. It
|
|
Packit |
022b05 |
-- is suggested that the device delete the least recently
|
|
Packit |
022b05 |
-- used entries first.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
-- The hostTable contains entries for each address
|
|
Packit |
022b05 |
-- discovered on a particular interface. Each entry
|
|
Packit |
022b05 |
-- contains statistical data about that host. This table
|
|
Packit |
022b05 |
-- is indexed by the MAC address of the host, through
|
|
Packit |
022b05 |
-- which a random access 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
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
-- discovered and thus inserted into the table. As this
|
|
Packit |
022b05 |
-- order, and thus index, is among those entries currently
|
|
Packit |
022b05 |
-- in the table, the index for a particular entry may change
|
|
Packit |
022b05 |
-- if an (earlier) entry is deleted. Thus the association
|
|
Packit |
022b05 |
-- between hostTimeCreationOrder and hostTimeEntry may be
|
|
Packit |
022b05 |
-- broken at 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
|
|
Packit |
022b05 |
-- discovery by the management station of new entries added
|
|
Packit |
022b05 |
-- to the table. After the management station has
|
|
Packit |
022b05 |
-- downloaded the entire table, it knows that new entries
|
|
Packit |
022b05 |
-- will be added immediately after the end of the current
|
|
Packit |
022b05 |
-- 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 |
-- restarting any download of the hostTimeTable that may have
|
|
Packit |
022b05 |
-- been 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
|
|
Packit |
022b05 |
-- associated with another host entirely. If this happens
|
|
Packit |
022b05 |
-- while downloading the host table, the management station
|
|
Packit |
022b05 |
-- may fail to download all of the entries in the table.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
hostControlTable OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX SEQUENCE OF HostControlEntry
|
|
Packit |
022b05 |
ACCESS not-accessible
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 |
ACCESS not-accessible
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"A list of parameters that set up the discovery of
|
|
Packit |
022b05 |
hosts on a particular interface and the collection
|
|
Packit |
022b05 |
of statistics about these hosts."
|
|
Packit |
022b05 |
INDEX { hostControlIndex }
|
|
Packit |
022b05 |
::= { hostControlTable 1 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
HostControlEntry ::= SEQUENCE {
|
|
Packit |
022b05 |
hostControlIndex INTEGER (1..65535),
|
|
Packit |
022b05 |
hostControlDataSource OBJECT IDENTIFIER,
|
|
Packit |
022b05 |
hostControlTableSize INTEGER,
|
|
Packit |
022b05 |
hostControlLastDeleteTime TimeTicks,
|
|
Packit |
022b05 |
hostControlOwner OwnerString,
|
|
Packit |
022b05 |
hostControlStatus INTEGER
|
|
Packit |
022b05 |
}
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
hostControlIndex OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX INTEGER (1..65535)
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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
|
|
Packit |
022b05 |
interface and places statistics about them in the
|
|
Packit |
022b05 |
hostTable and the hostTimeTable on behalf of this
|
|
Packit |
022b05 |
hostControlEntry."
|
|
Packit |
022b05 |
::= { hostControlEntry 1 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
hostControlDataSource OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX OBJECT IDENTIFIER
|
|
Packit |
022b05 |
ACCESS read-write
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 [4,6], for the desired interface. For example,
|
|
Packit |
022b05 |
if an entry were to receive data from interface #1,
|
|
Packit |
022b05 |
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
|
|
Packit |
022b05 |
identified interface.
|
|
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 INTEGER
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 |
ACCESS read-write
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The entity that configured this entry and is
|
|
Packit |
022b05 |
therefore using the resources assigned to it."
|
|
Packit |
022b05 |
::= { hostControlEntry 5 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
hostControlStatus OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX EntryStatus
|
|
Packit |
022b05 |
ACCESS read-write
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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
|
|
Packit |
022b05 |
associated entries in the hostTable,
|
|
Packit |
022b05 |
hostTimeTable, and the hostTopNTable shall be
|
|
Packit |
022b05 |
deleted by the agent."
|
|
Packit |
022b05 |
::= { hostControlEntry 6 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
hostTable OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX SEQUENCE OF HostEntry
|
|
Packit |
022b05 |
ACCESS not-accessible
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 |
ACCESS not-accessible
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"A collection of statistics for a particular host
|
|
Packit |
022b05 |
that has been discovered on an interface of this
|
|
Packit |
022b05 |
device."
|
|
Packit |
022b05 |
INDEX { hostIndex, hostAddress }
|
|
Packit |
022b05 |
::= { hostTable 1 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
HostEntry ::= SEQUENCE {
|
|
Packit |
022b05 |
hostAddress OCTET STRING,
|
|
Packit |
022b05 |
hostCreationOrder INTEGER (1..65535),
|
|
Packit |
022b05 |
hostIndex INTEGER (1..65535),
|
|
Packit |
022b05 |
hostInPkts Counter,
|
|
Packit |
022b05 |
hostOutPkts Counter,
|
|
Packit |
022b05 |
hostInOctets Counter,
|
|
Packit |
022b05 |
hostOutOctets Counter,
|
|
Packit |
022b05 |
hostOutErrors Counter,
|
|
Packit |
022b05 |
hostOutBroadcastPkts Counter,
|
|
Packit |
022b05 |
hostOutMulticastPkts Counter
|
|
Packit |
022b05 |
}
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
hostAddress OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX OCTET STRING
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 INTEGER (1..65535)
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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
|
|
Packit |
022b05 |
earlier have a lower index value than entries added
|
|
Packit |
022b05 |
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 INTEGER (1..65535)
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 Counter
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The number of packets without errors transmitted to
|
|
Packit |
022b05 |
this address since it was added to the hostTable."
|
|
Packit |
022b05 |
::= { hostEntry 4 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
hostOutPkts OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX Counter
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The number of packets including errors 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 Counter
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The number of octets transmitted to this address
|
|
Packit |
022b05 |
since it was added to the hostTable (excluding
|
|
Packit |
022b05 |
framing bits but including FCS octets), except for
|
|
Packit |
022b05 |
those octets in packets that contained errors."
|
|
Packit |
022b05 |
::= { hostEntry 6 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
hostOutOctets OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX Counter
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The number of octets transmitted by this address
|
|
Packit |
022b05 |
since it was added to the hostTable (excluding
|
|
Packit |
022b05 |
framing bits but including FCS octets), including
|
|
Packit |
022b05 |
those octets in packets that contained errors."
|
|
Packit |
022b05 |
::= { hostEntry 7 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
hostOutErrors OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX Counter
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The number of error packets transmitted by this
|
|
Packit |
022b05 |
address since this host was added to the hostTable."
|
|
Packit |
022b05 |
::= { hostEntry 8 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
hostOutBroadcastPkts OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX Counter
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 Counter
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 |
|
|
Packit |
022b05 |
-- host Time Table
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
hostTimeTable OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX SEQUENCE OF HostTimeEntry
|
|
Packit |
022b05 |
ACCESS not-accessible
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 |
ACCESS not-accessible
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"A collection of statistics for a particular host
|
|
Packit |
022b05 |
that has been discovered on an interface of this
|
|
Packit |
022b05 |
device. This collection includes the relative
|
|
Packit |
022b05 |
ordering of the creation time of this object."
|
|
Packit |
022b05 |
INDEX { hostTimeIndex, hostTimeCreationOrder }
|
|
Packit |
022b05 |
::= { hostTimeTable 1 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
HostTimeEntry ::= SEQUENCE {
|
|
Packit |
022b05 |
hostTimeAddress OCTET STRING,
|
|
Packit |
022b05 |
hostTimeCreationOrder INTEGER (1..65535),
|
|
Packit |
022b05 |
hostTimeIndex INTEGER (1..65535),
|
|
Packit |
022b05 |
hostTimeInPkts Counter,
|
|
Packit |
022b05 |
hostTimeOutPkts Counter,
|
|
Packit |
022b05 |
hostTimeInOctets Counter,
|
|
Packit |
022b05 |
hostTimeOutOctets Counter,
|
|
Packit |
022b05 |
hostTimeOutErrors Counter,
|
|
Packit |
022b05 |
hostTimeOutBroadcastPkts Counter,
|
|
Packit |
022b05 |
hostTimeOutMulticastPkts Counter
|
|
Packit |
022b05 |
}
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
hostTimeAddress OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX OCTET STRING
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 INTEGER (1..65535)
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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
|
|
Packit |
022b05 |
earlier have a lower index value than entries added
|
|
Packit |
022b05 |
later. Thus the management station has the ability
|
|
Packit |
022b05 |
to 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 INTEGER (1..65535)
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 Counter
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The number of packets without errors transmitted to
|
|
Packit |
022b05 |
this address since it was added to the hostTimeTable."
|
|
Packit |
022b05 |
::= { hostTimeEntry 4 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
hostTimeOutPkts OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX Counter
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The number of packets including errors transmitted
|
|
Packit |
022b05 |
by this address since it was added to the
|
|
Packit |
022b05 |
hostTimeTable."
|
|
Packit |
022b05 |
::= { hostTimeEntry 5 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
hostTimeInOctets OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX Counter
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The number of octets transmitted to this address
|
|
Packit |
022b05 |
since it was added to the hostTimeTable (excluding
|
|
Packit |
022b05 |
framing bits but including FCS octets), except for
|
|
Packit |
022b05 |
those octets in packets that contained errors."
|
|
Packit |
022b05 |
::= { hostTimeEntry 6 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
hostTimeOutOctets OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX Counter
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 packets that contained errors."
|
|
Packit |
022b05 |
::= { hostTimeEntry 7 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
hostTimeOutErrors OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX Counter
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The number of error packets transmitted by this
|
|
Packit |
022b05 |
address since this host was added to the
|
|
Packit |
022b05 |
hostTimeTable."
|
|
Packit |
022b05 |
::= { hostTimeEntry 8 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
hostTimeOutBroadcastPkts OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX Counter
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 Counter
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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
|
|
Packit |
022b05 |
directed to the broadcast address."
|
|
Packit |
022b05 |
::= { hostTimeEntry 10 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
-- The Host Top "N" Group
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
-- Implementation of the Host Top N group is optional.
|
|
Packit |
022b05 |
--
|
|
Packit |
022b05 |
-- The Host Top N group requires the implementation of the
|
|
Packit |
022b05 |
-- host group.
|
|
Packit |
022b05 |
--
|
|
Packit |
022b05 |
-- The Host Top N group is used to prepare reports that
|
|
Packit |
022b05 |
-- describe the hosts that top a list ordered by one of
|
|
Packit |
022b05 |
-- their statistics. The available statistics are samples
|
|
Packit |
022b05 |
-- of one of their base statistics, over an interval
|
|
Packit |
022b05 |
-- specified by the management station. Thus, these
|
|
Packit |
022b05 |
-- 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
|
|
Packit |
022b05 |
-- of such a report. The management station may select the
|
|
Packit |
022b05 |
-- parameters of such a report, such as which interface,
|
|
Packit |
022b05 |
-- which statistic, how many hosts, and the start and stop
|
|
Packit |
022b05 |
-- times of the sampling. When the report is prepared,
|
|
Packit |
022b05 |
-- entries are created in the hostTopNTable associated with
|
|
Packit |
022b05 |
-- the relevant hostTopNControlEntry. These entries are
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
-- static for each report after it has been prepared.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
hostTopNControlTable OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX SEQUENCE OF HostTopNControlEntry
|
|
Packit |
022b05 |
ACCESS not-accessible
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 |
ACCESS not-accessible
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"A set of parameters that control the creation of a
|
|
Packit |
022b05 |
report of the top N hosts according to several
|
|
Packit |
022b05 |
metrics."
|
|
Packit |
022b05 |
INDEX { hostTopNControlIndex }
|
|
Packit |
022b05 |
::= { hostTopNControlTable 1 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
HostTopNControlEntry ::= SEQUENCE {
|
|
Packit |
022b05 |
hostTopNControlIndex INTEGER (1..65535),
|
|
Packit |
022b05 |
hostTopNHostIndex INTEGER (1..65535),
|
|
Packit |
022b05 |
hostTopNRateBase INTEGER,
|
|
Packit |
022b05 |
hostTopNTimeRemaining INTEGER,
|
|
Packit |
022b05 |
hostTopNDuration INTEGER,
|
|
Packit |
022b05 |
hostTopNRequestedSize INTEGER,
|
|
Packit |
022b05 |
hostTopNGrantedSize INTEGER,
|
|
Packit |
022b05 |
hostTopNStartTime TimeTicks,
|
|
Packit |
022b05 |
hostTopNOwner OwnerString,
|
|
Packit |
022b05 |
hostTopNStatus INTEGER
|
|
Packit |
022b05 |
}
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
hostTopNControlIndex OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX INTEGER (1..65535)
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 INTEGER (1..65535)
|
|
Packit |
022b05 |
ACCESS read-write
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The host table for which a top N report will be
|
|
Packit |
022b05 |
prepared on behalf of this entry. The host table
|
|
Packit |
022b05 |
identified by a particular value of this index is
|
|
Packit |
022b05 |
associated with the same host table as identified
|
|
Packit |
022b05 |
by the same value of 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 |
ACCESS read-write
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 INTEGER
|
|
Packit |
022b05 |
ACCESS read-write
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The number of seconds left in the report currently
|
|
Packit |
022b05 |
being collected. When this object is modified by
|
|
Packit |
022b05 |
the management station, a new collection is started,
|
|
Packit |
022b05 |
possibly aborting a currently running report. The
|
|
Packit |
022b05 |
new value is used as the requested duration of this
|
|
Packit |
022b05 |
report, which is loaded into the associated
|
|
Packit |
022b05 |
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
|
|
Packit |
022b05 |
until it reaches zero. During this time, all
|
|
Packit |
022b05 |
associated hostTopNEntries shall remain
|
|
Packit |
022b05 |
inaccessible. At the time that this object
|
|
Packit |
022b05 |
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
|
|
Packit |
022b05 |
collection interval."
|
|
Packit |
022b05 |
DEFVAL { 0 }
|
|
Packit |
022b05 |
::= { hostTopNControlEntry 4 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
hostTopNDuration OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX INTEGER
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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
|
|
Packit |
022b05 |
set, this object shall be set by the probe to the
|
|
Packit |
022b05 |
same value and shall not be modified until the next
|
|
Packit |
022b05 |
time 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 INTEGER
|
|
Packit |
022b05 |
ACCESS read-write
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 INTEGER
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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
|
|
Packit |
022b05 |
possible for the particular implementation and
|
|
Packit |
022b05 |
available resources. The probe must not lower this
|
|
Packit |
022b05 |
value except 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 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 |
ACCESS read-write
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The entity that configured this entry and is
|
|
Packit |
022b05 |
therefore using the resources assigned to it."
|
|
Packit |
022b05 |
::= { hostTopNControlEntry 9 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
hostTopNStatus OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX EntryStatus
|
|
Packit |
022b05 |
ACCESS read-write
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The status of this hostTopNControl entry.
|
|
Packit |
022b05 |
If this object is not equal to valid(1), all
|
|
Packit |
022b05 |
associated hostTopNEntries shall be deleted by
|
|
Packit |
022b05 |
the agent."
|
|
Packit |
022b05 |
::= { hostTopNControlEntry 10 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
hostTopNTable OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX SEQUENCE OF HostTopNEntry
|
|
Packit |
022b05 |
ACCESS not-accessible
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 |
ACCESS not-accessible
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"A set of statistics for a host that is part of a
|
|
Packit |
022b05 |
top N report."
|
|
Packit |
022b05 |
INDEX { hostTopNReport, hostTopNIndex }
|
|
Packit |
022b05 |
::= { hostTopNTable 1 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
HostTopNEntry ::= SEQUENCE {
|
|
Packit |
022b05 |
hostTopNReport INTEGER (1..65535),
|
|
Packit |
022b05 |
hostTopNIndex INTEGER (1..65535),
|
|
Packit |
022b05 |
hostTopNAddress OCTET STRING,
|
|
Packit |
022b05 |
hostTopNRate INTEGER
|
|
Packit |
022b05 |
}
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
hostTopNReport OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX INTEGER (1..65535)
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 INTEGER (1..65535)
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 INTEGER
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 |
|
|
Packit |
022b05 |
-- The Matrix Group
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
-- Implementation of the Matrix group is optional.
|
|
Packit |
022b05 |
--
|
|
Packit |
022b05 |
-- The Matrix group consists of the matrixControlTable,
|
|
Packit |
022b05 |
-- matrixSDTable and the matrixDSTable. These tables
|
|
Packit |
022b05 |
-- store statistics for a particular conversation between
|
|
Packit |
022b05 |
-- two addresses. As the device detects a new conversation,
|
|
Packit |
022b05 |
-- including those to a non-unicast address, it creates a
|
|
Packit |
022b05 |
-- 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
|
|
Packit |
022b05 |
-- used entries first.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
matrixControlTable OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX SEQUENCE OF MatrixControlEntry
|
|
Packit |
022b05 |
ACCESS not-accessible
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 |
ACCESS not-accessible
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"Information about a traffic matrix on a
|
|
Packit |
022b05 |
particular interface."
|
|
Packit |
022b05 |
INDEX { matrixControlIndex }
|
|
Packit |
022b05 |
::= { matrixControlTable 1 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
MatrixControlEntry ::= SEQUENCE {
|
|
Packit |
022b05 |
matrixControlIndex INTEGER (1..65535),
|
|
Packit |
022b05 |
matrixControlDataSource OBJECT IDENTIFIER,
|
|
Packit |
022b05 |
matrixControlTableSize INTEGER,
|
|
Packit |
022b05 |
matrixControlLastDeleteTime TimeTicks,
|
|
Packit |
022b05 |
matrixControlOwner OwnerString,
|
|
Packit |
022b05 |
matrixControlStatus INTEGER
|
|
Packit |
022b05 |
}
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
matrixControlIndex OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX INTEGER (1..65535)
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 |
ACCESS read-write
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 [4,6], for the desired interface. For
|
|
Packit |
022b05 |
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
|
|
Packit |
022b05 |
identified interface.
|
|
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 INTEGER
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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
|
|
Packit |
022b05 |
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 |
ACCESS read-write
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The entity that configured this entry and is
|
|
Packit |
022b05 |
therefore using the resources assigned to it."
|
|
Packit |
022b05 |
::= { matrixControlEntry 5 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
matrixControlStatus OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX EntryStatus
|
|
Packit |
022b05 |
ACCESS read-write
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The status of this matrixControl entry.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
If this object is not equal to valid(1), all
|
|
Packit |
022b05 |
associated entries in the matrixSDTable and the
|
|
Packit |
022b05 |
matrixDSTable 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 |
ACCESS not-accessible
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 |
ACCESS not-accessible
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"A collection of statistics for communications between
|
|
Packit |
022b05 |
two addresses on a particular interface."
|
|
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 INTEGER (1..65535),
|
|
Packit |
022b05 |
matrixSDPkts Counter,
|
|
Packit |
022b05 |
matrixSDOctets Counter,
|
|
Packit |
022b05 |
matrixSDErrors Counter
|
|
Packit |
022b05 |
}
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
matrixSDSourceAddress OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX OCTET STRING
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The destination physical address."
|
|
Packit |
022b05 |
::= { matrixSDEntry 2 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
matrixSDIndex OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX INTEGER (1..65535)
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 Counter
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The number of packets transmitted from the source
|
|
Packit |
022b05 |
address to the destination address (this number
|
|
Packit |
022b05 |
includes error packets)."
|
|
Packit |
022b05 |
::= { matrixSDEntry 4 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
matrixSDOctets OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX Counter
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 Counter
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The number of error packets transmitted from
|
|
Packit |
022b05 |
the source address to the destination address."
|
|
Packit |
022b05 |
::= { matrixSDEntry 6 }
|
|
Packit |
022b05 |
|
|
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 |
ACCESS not-accessible
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 |
ACCESS not-accessible
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"A collection of statistics for communications between
|
|
Packit |
022b05 |
two address on a particular interface."
|
|
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 INTEGER (1..65535),
|
|
Packit |
022b05 |
matrixDSPkts Counter,
|
|
Packit |
022b05 |
matrixDSOctets Counter,
|
|
Packit |
022b05 |
matrixDSErrors Counter
|
|
Packit |
022b05 |
}
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
matrixDSSourceAddress OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX OCTET STRING
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The destination physical address."
|
|
Packit |
022b05 |
::= { matrixDSEntry 2 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
matrixDSIndex OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX INTEGER (1..65535)
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 Counter
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The number of packets transmitted from the source
|
|
Packit |
022b05 |
address to the destination address (this number
|
|
Packit |
022b05 |
includes error packets)."
|
|
Packit |
022b05 |
::= { matrixDSEntry 4 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
matrixDSOctets OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX Counter
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 Counter
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The number of error packets transmitted from
|
|
Packit |
022b05 |
the source address to the destination address."
|
|
Packit |
022b05 |
::= { matrixDSEntry 6 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
-- The Filter Group
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
-- Implementation of the Filter group is optional.
|
|
Packit |
022b05 |
|
|
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 |
-- 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 |
ACCESS not-accessible
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 |
ACCESS not-accessible
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"A set of parameters for a packet filter applied on a
|
|
Packit |
022b05 |
particular interface."
|
|
Packit |
022b05 |
INDEX { filterIndex }
|
|
Packit |
022b05 |
::= { filterTable 1 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
FilterEntry ::= SEQUENCE {
|
|
Packit |
022b05 |
filterIndex INTEGER (1..65535),
|
|
Packit |
022b05 |
filterChannelIndex INTEGER (1..65535),
|
|
Packit |
022b05 |
filterPktDataOffset INTEGER,
|
|
Packit |
022b05 |
filterPktData OCTET STRING,
|
|
Packit |
022b05 |
filterPktDataMask OCTET STRING,
|
|
Packit |
022b05 |
filterPktDataNotMask OCTET STRING,
|
|
Packit |
022b05 |
filterPktStatus INTEGER,
|
|
Packit |
022b05 |
filterPktStatusMask INTEGER,
|
|
Packit |
022b05 |
filterPktStatusNotMask INTEGER,
|
|
Packit |
022b05 |
filterOwner OwnerString,
|
|
Packit |
022b05 |
filterStatus INTEGER
|
|
Packit |
022b05 |
}
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
filterIndex OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX INTEGER (1..65535)
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 INTEGER (1..65535)
|
|
Packit |
022b05 |
ACCESS read-write
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"This object identifies the channel of which this
|
|
Packit |
022b05 |
filter is a part. The filters identified by a
|
|
Packit |
022b05 |
particular value of this object are associated
|
|
Packit |
022b05 |
with the same channel as identified by the same
|
|
Packit |
022b05 |
value of the channelIndex object."
|
|
Packit |
022b05 |
::= { filterEntry 2 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
filterPktDataOffset OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX INTEGER
|
|
Packit |
022b05 |
ACCESS read-write
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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
|
|
Packit |
022b05 |
of 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 |
ACCESS read-write
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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
|
|
Packit |
022b05 |
accompanying filterPktDataMask and
|
|
Packit |
022b05 |
filterPktDataNotMask will be adjusted for the
|
|
Packit |
022b05 |
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
|
|
Packit |
022b05 |
three 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
|
|
Packit |
022b05 |
packet 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
|
|
Packit |
022b05 |
zero, if the bit from the packet is not equal to
|
|
Packit |
022b05 |
the corresponding bit from the filterPktData,
|
|
Packit |
022b05 |
then the packet will fail 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,
|
|
Packit |
022b05 |
the bit from the packet is equal to the
|
|
Packit |
022b05 |
corresponding bit from the filterPktData, then
|
|
Packit |
022b05 |
the packet will fail this data match.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
Any packets that have not failed any of the three
|
|
Packit |
022b05 |
matches above have passed this data match.
|
|
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 |
ACCESS read-write
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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
|
|
Packit |
022b05 |
set in this mask are relevant for further processing
|
|
Packit |
022b05 |
by the match algorithm. The offset is applied to
|
|
Packit |
022b05 |
filterPktDataMask in the same way it is applied to
|
|
Packit |
022b05 |
the filter. For the purposes of the matching
|
|
Packit |
022b05 |
algorithm, if the associated filterPktData object
|
|
Packit |
022b05 |
is longer than this mask, this mask is conceptually
|
|
Packit |
022b05 |
extended with '1' bits until it reaches the
|
|
Packit |
022b05 |
length of the filterPktData object.
|
|
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 |
ACCESS read-write
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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
|
|
Packit |
022b05 |
correspond to bits cleared in this mask must all
|
|
Packit |
022b05 |
be equal to their corresponding bits in the
|
|
Packit |
022b05 |
filterPktData object for the packet to be accepted.
|
|
Packit |
022b05 |
In addition, at least one of those relevant
|
|
Packit |
022b05 |
bits in the received packet that correspond to bits
|
|
Packit |
022b05 |
set in this mask must be different to its
|
|
Packit |
022b05 |
corresponding bit in the filterPktData object.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
For the purposes of the matching algorithm, if
|
|
Packit |
022b05 |
the associated filterPktData object is longer than
|
|
Packit |
022b05 |
this mask, this mask is conceptually extended with
|
|
Packit |
022b05 |
'0' bits until it reaches the length of the
|
|
Packit |
022b05 |
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 INTEGER
|
|
Packit |
022b05 |
ACCESS read-write
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The status that is to be matched with the input
|
|
Packit |
022b05 |
packet. The only bits relevant to this match
|
|
Packit |
022b05 |
algorithm are those that have the corresponding
|
|
Packit |
022b05 |
filterPktStatusMask bit equal to one.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
The following two rules are then applied to every
|
|
Packit |
022b05 |
packet:
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
(1) For each relevant bit from the packet status
|
|
Packit |
022b05 |
with the corresponding filterPktStatusNotMask
|
|
Packit |
022b05 |
bit set to zero, if the bit from the packet
|
|
Packit |
022b05 |
status is not equal to the corresponding bit
|
|
Packit |
022b05 |
from the filterPktStatus, then the packet will
|
|
Packit |
022b05 |
fail this status match.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
(2) If for every relevant bit from the packet status
|
|
Packit |
022b05 |
with the corresponding filterPktStatusNotMask
|
|
Packit |
022b05 |
bit set to one, the bit from the packet status
|
|
Packit |
022b05 |
is equal to the corresponding bit from the
|
|
Packit |
022b05 |
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
|
|
Packit |
022b05 |
matches above have passed this status match.
|
|
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
|
|
Packit |
022b05 |
dependent on the media type of the interface that
|
|
Packit |
022b05 |
this channel 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
|
|
Packit |
022b05 |
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
|
|
Packit |
022b05 |
object will have other media-specific errors defined.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
For the purposes of this status matching algorithm, if
|
|
Packit |
022b05 |
the packet status is longer than this
|
|
Packit |
022b05 |
object, filterPktStatus this object is conceptually
|
|
Packit |
022b05 |
extended with '0' bits until it reaches the size of
|
|
Packit |
022b05 |
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 INTEGER
|
|
Packit |
022b05 |
ACCESS read-write
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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
|
|
Packit |
022b05 |
to bits set in this mask are relevant for further
|
|
Packit |
022b05 |
processing by the status match algorithm. For the
|
|
Packit |
022b05 |
purposes of the matching algorithm, if the
|
|
Packit |
022b05 |
associated filterPktStatus object is longer than
|
|
Packit |
022b05 |
this mask, this mask is conceptually extended with
|
|
Packit |
022b05 |
'1' bits until it reaches the size of the
|
|
Packit |
022b05 |
filterPktStatus. In addition, if a packet status is
|
|
Packit |
022b05 |
longer than this mask, this mask is conceptually
|
|
Packit |
022b05 |
extended with '0' bits until it reaches the size of
|
|
Packit |
022b05 |
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 INTEGER
|
|
Packit |
022b05 |
ACCESS read-write
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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
|
|
Packit |
022b05 |
status that correspond to bits cleared in this mask
|
|
Packit |
022b05 |
must all be equal to their corresponding bits in the
|
|
Packit |
022b05 |
filterPktStatus object for the packet to be accepted.
|
|
Packit |
022b05 |
In addition, at least one of those relevant bits in the
|
|
Packit |
022b05 |
received packet status that correspond to bits set in
|
|
Packit |
022b05 |
this mask must be different to its corresponding bit
|
|
Packit |
022b05 |
in the filterPktStatus object for the packet to be
|
|
Packit |
022b05 |
accepted.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
For the purposes of the matching algorithm, if the
|
|
Packit |
022b05 |
associated filterPktStatus object or a packet status
|
|
Packit |
022b05 |
is longer than this mask, this mask is conceptually
|
|
Packit |
022b05 |
extended with '0' bits until it reaches the longer of
|
|
Packit |
022b05 |
the lengths of the filterPktStatus object and the
|
|
Packit |
022b05 |
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 |
ACCESS read-write
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The entity that configured this entry and is
|
|
Packit |
022b05 |
therefore using the resources assigned to it."
|
|
Packit |
022b05 |
::= { filterEntry 10 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
filterStatus OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX EntryStatus
|
|
Packit |
022b05 |
ACCESS read-write
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 |
ACCESS not-accessible
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 |
ACCESS not-accessible
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"A set of parameters for a packet channel applied on a
|
|
Packit |
022b05 |
particular interface."
|
|
Packit |
022b05 |
INDEX { channelIndex }
|
|
Packit |
022b05 |
::= { channelTable 1 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
ChannelEntry ::= SEQUENCE {
|
|
Packit |
022b05 |
channelIndex INTEGER (1..65535),
|
|
Packit |
022b05 |
channelIfIndex INTEGER (1..65535),
|
|
Packit |
022b05 |
channelAcceptType INTEGER,
|
|
Packit |
022b05 |
channelDataControl INTEGER,
|
|
Packit |
022b05 |
channelTurnOnEventIndex INTEGER (0..65535),
|
|
Packit |
022b05 |
channelTurnOffEventIndex INTEGER (0..65535),
|
|
Packit |
022b05 |
channelEventIndex INTEGER (0..65535),
|
|
Packit |
022b05 |
channelEventStatus INTEGER,
|
|
Packit |
022b05 |
channelMatches Counter,
|
|
Packit |
022b05 |
channelDescription DisplayString (SIZE (0..127)),
|
|
Packit |
022b05 |
channelOwner OwnerString,
|
|
Packit |
022b05 |
channelStatus INTEGER
|
|
Packit |
022b05 |
}
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
channelIndex OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX INTEGER (1..65535)
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"An index that uniquely identifies an entry
|
|
Packit |
022b05 |
in the channel table. Each such
|
|
Packit |
022b05 |
entry defines one channel, a logical data
|
|
Packit |
022b05 |
and event stream."
|
|
Packit |
022b05 |
::= { channelEntry 1 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
channelIfIndex OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX INTEGER (1..65535)
|
|
Packit |
022b05 |
ACCESS read-write
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The value of this object uniquely identifies the
|
|
Packit |
022b05 |
interface on this remote network monitoring device
|
|
Packit |
022b05 |
to which the associated filters are applied to allow
|
|
Packit |
022b05 |
data into this channel. The interface identified by
|
|
Packit |
022b05 |
a particular value of this object is the same
|
|
Packit |
022b05 |
interface as identified by the same value of the
|
|
Packit |
022b05 |
ifIndex object, defined in [4,6]. The filters in
|
|
Packit |
022b05 |
this group are applied to all packets on the local
|
|
Packit |
022b05 |
network segment attached to the identified
|
|
Packit |
022b05 |
interface.
|
|
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 |
ACCESS read-write
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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
|
|
Packit |
022b05 |
and 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 |
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 |
ACCESS read-write
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"This object controls the flow of data through this
|
|
Packit |
022b05 |
channel. If this object is on(1), data, status and
|
|
Packit |
022b05 |
events flow through this channel. If this object is
|
|
Packit |
022b05 |
off(2), data, status and events will not flow through
|
|
Packit |
022b05 |
this channel."
|
|
Packit |
022b05 |
DEFVAL { off }
|
|
Packit |
022b05 |
::= { channelEntry 4 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
channelTurnOnEventIndex OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX INTEGER (0..65535)
|
|
Packit |
022b05 |
ACCESS read-write
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 |
|
|
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 INTEGER (0..65535)
|
|
Packit |
022b05 |
ACCESS read-write
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 INTEGER (0..65535)
|
|
Packit |
022b05 |
ACCESS read-write
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 |
ACCESS read-write
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 Counter
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 |
ACCESS read-write
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 |
ACCESS read-write
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 |
ACCESS read-write
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The status of this channel entry."
|
|
Packit |
022b05 |
::= { channelEntry 12 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
-- The Packet Capture Group
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
-- Implementation of the Packet Capture group is optional.
|
|
Packit |
022b05 |
--
|
|
Packit |
022b05 |
-- The Packet Capture Group requires implementation of the
|
|
Packit |
022b05 |
-- Filter Group.
|
|
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 |
ACCESS not-accessible
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 |
ACCESS not-accessible
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"A set of parameters that control the collection of
|
|
Packit |
022b05 |
a stream of packets that have matched filters."
|
|
Packit |
022b05 |
INDEX { bufferControlIndex }
|
|
Packit |
022b05 |
::= { bufferControlTable 1 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
BufferControlEntry ::= SEQUENCE {
|
|
Packit |
022b05 |
bufferControlIndex INTEGER (1..65535),
|
|
Packit |
022b05 |
bufferControlChannelIndex INTEGER (1..65535),
|
|
Packit |
022b05 |
bufferControlFullStatus INTEGER,
|
|
Packit |
022b05 |
bufferControlFullAction INTEGER,
|
|
Packit |
022b05 |
bufferControlCaptureSliceSize INTEGER,
|
|
Packit |
022b05 |
bufferControlDownloadSliceSize INTEGER,
|
|
Packit |
022b05 |
bufferControlDownloadOffset INTEGER,
|
|
Packit |
022b05 |
bufferControlMaxOctetsRequested INTEGER,
|
|
Packit |
022b05 |
bufferControlMaxOctetsGranted INTEGER,
|
|
Packit |
022b05 |
bufferControlCapturedPackets INTEGER,
|
|
Packit |
022b05 |
bufferControlTurnOnTime TimeTicks,
|
|
Packit |
022b05 |
bufferControlOwner OwnerString,
|
|
Packit |
022b05 |
bufferControlStatus INTEGER
|
|
Packit |
022b05 |
}
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
bufferControlIndex OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX INTEGER (1..65535)
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 INTEGER (1..65535)
|
|
Packit |
022b05 |
ACCESS read-write
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 |
ACCESS read-write
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 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 INTEGER
|
|
Packit |
022b05 |
ACCESS read-write
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 INTEGER
|
|
Packit |
022b05 |
ACCESS read-write
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 INTEGER
|
|
Packit |
022b05 |
ACCESS read-write
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 INTEGER
|
|
Packit |
022b05 |
ACCESS read-write
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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 INTEGER
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
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
|
|
Packit |
022b05 |
the particular probe implementation and available
|
|
Packit |
022b05 |
resources. However, if the request object has the
|
|
Packit |
022b05 |
special value of -1, the probe must set this object
|
|
Packit |
022b05 |
to -1. The probe must not lower this value except
|
|
Packit |
022b05 |
as a result of 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 |
022b05 |
capture buffer and the corresponding
|
|
Packit |
022b05 |
bufferControlFullAction is set to wrapWhenFull(2),
|
|
Packit |
022b05 |
enough of the oldest packets associated with this
|
|
Packit |
022b05 |
capture buffer shall be deleted by the agent so
|
|
Packit |
022b05 |
that the new packet can be added. If the
|
|
Packit |
022b05 |
corresponding bufferControlFullAction is set to
|
|
Packit |
022b05 |
lockWhenFull(1), the new packet shall be discarded.
|
|
Packit |
022b05 |
In either case, the probe must set
|
|
Packit |
022b05 |
bufferControlFullStatus to full(2).
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
When the value of this object changes to a value less
|
|
Packit |
022b05 |
than the current value, entries are deleted from
|
|
Packit |
022b05 |
the captureBufferTable associated with this
|
|
Packit |
022b05 |
bufferControlEntry. Enough of the
|
|
Packit |
022b05 |
oldest of these captureBufferEntries shall be
|
|
Packit |
022b05 |
deleted by the agent so that the number of octets
|
|
Packit |
022b05 |
used 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
|
|
Packit |
022b05 |
captureBufferEntries may be allowed to grow."
|
|
Packit |
022b05 |
::= { bufferControlEntry 9 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
bufferControlCapturedPackets OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX INTEGER
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The number of packets currently in this captureBuffer."
|
|
Packit |
022b05 |
::= { bufferControlEntry 10 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
bufferControlTurnOnTime OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX TimeTicks
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The value of sysUpTime when this capture buffer was
|
|
Packit |
022b05 |
first turned on."
|
|
Packit |
022b05 |
::= { bufferControlEntry 11 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
bufferControlOwner OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX OwnerString
|
|
Packit |
022b05 |
ACCESS read-write
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The entity that configured this entry and is therefore
|
|
Packit |
022b05 |
using the resources assigned to it."
|
|
Packit |
022b05 |
::= { bufferControlEntry 12 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
bufferControlStatus OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX EntryStatus
|
|
Packit |
022b05 |
ACCESS read-write
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The status of this buffer Control Entry."
|
|
Packit |
022b05 |
::= { bufferControlEntry 13 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
captureBufferTable OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX SEQUENCE OF CaptureBufferEntry
|
|
Packit |
022b05 |
ACCESS not-accessible
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"A list of packets captured off of a channel."
|
|
Packit |
022b05 |
::= { capture 2 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
captureBufferEntry OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX CaptureBufferEntry
|
|
Packit |
022b05 |
ACCESS not-accessible
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"A packet captured off of an attached network."
|
|
Packit |
022b05 |
INDEX { captureBufferControlIndex, captureBufferIndex }
|
|
Packit |
022b05 |
::= { captureBufferTable 1 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
CaptureBufferEntry ::= SEQUENCE {
|
|
Packit |
022b05 |
captureBufferControlIndex INTEGER (1..65535),
|
|
Packit |
022b05 |
captureBufferIndex INTEGER,
|
|
Packit |
022b05 |
captureBufferPacketID INTEGER,
|
|
Packit |
022b05 |
captureBufferPacketData OCTET STRING,
|
|
Packit |
022b05 |
captureBufferPacketLength INTEGER,
|
|
Packit |
022b05 |
captureBufferPacketTime INTEGER,
|
|
Packit |
022b05 |
captureBufferPacketStatus INTEGER
|
|
Packit |
022b05 |
}
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
captureBufferControlIndex OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX INTEGER (1..65535)
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The index of the bufferControlEntry with which
|
|
Packit |
022b05 |
this packet is associated."
|
|
Packit |
022b05 |
::= { captureBufferEntry 1 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
captureBufferIndex OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX INTEGER
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"An index that uniquely identifies an entry
|
|
Packit |
022b05 |
in the captureBuffer table associated with a
|
|
Packit |
022b05 |
particular bufferControlEntry. This index will
|
|
Packit |
022b05 |
start at 1 and increase by one for each new packet
|
|
Packit |
022b05 |
added with the same captureBufferControlIndex."
|
|
Packit |
022b05 |
::= { captureBufferEntry 2 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
captureBufferPacketID OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX INTEGER
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"An index that describes the order of packets
|
|
Packit |
022b05 |
that are received on a particular interface.
|
|
Packit |
022b05 |
The packetID of a packet captured on an
|
|
Packit |
022b05 |
interface is defined to be greater than the
|
|
Packit |
022b05 |
packetID's of all packets captured previously on
|
|
Packit |
022b05 |
the same interface. As the captureBufferPacketID
|
|
Packit |
022b05 |
object has a maximum positive value of 2^31 - 1,
|
|
Packit |
022b05 |
any captureBufferPacketID object shall have the
|
|
Packit |
022b05 |
value of the associated packet's packetID mod 2^31."
|
|
Packit |
022b05 |
::= { captureBufferEntry 3 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
captureBufferPacketData OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX OCTET STRING
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The data inside the packet, starting at the beginning
|
|
Packit |
022b05 |
of the packet plus any offset specified in the
|
|
Packit |
022b05 |
associated bufferControlDownloadOffset, including any
|
|
Packit |
022b05 |
link level headers. The length of the data in this
|
|
Packit |
022b05 |
object is the minimum of the length of the captured
|
|
Packit |
022b05 |
packet minus the offset, the length of the associated
|
|
Packit |
022b05 |
bufferControlCaptureSliceSize minus the offset, and the
|
|
Packit |
022b05 |
associated bufferControlDownloadSliceSize. If this
|
|
Packit |
022b05 |
minimum is less than zero, this object shall have a
|
|
Packit |
022b05 |
length of zero."
|
|
Packit |
022b05 |
::= { captureBufferEntry 4 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
captureBufferPacketLength OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX INTEGER
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The actual length (off the wire) of the packet stored
|
|
Packit |
022b05 |
in this entry, including FCS octets."
|
|
Packit |
022b05 |
::= { captureBufferEntry 5 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
captureBufferPacketTime OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX INTEGER
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"The number of milliseconds that had passed since
|
|
Packit |
022b05 |
this capture buffer was first turned on when this
|
|
Packit |
022b05 |
packet was captured."
|
|
Packit |
022b05 |
::= { captureBufferEntry 6 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
captureBufferPacketStatus OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX INTEGER
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"A value which indicates the error status of this
|
|
Packit |
022b05 |
packet.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
The value of this object is defined in the same way as
|
|
Packit |
022b05 |
filterPacketStatus. The value 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 |
|
|
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
|
|
Packit |
022b05 |
error
|
|
Packit |
022b05 |
3 First packet in this capture buffer after
|
|
Packit |
022b05 |
it was detected that some packets were
|
|
Packit |
022b05 |
not processed correctly.
|
|
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 |
::= { captureBufferEntry 7 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
-- The Event Group
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
-- Implementation of the Event group is optional.
|
|
Packit |
022b05 |
--
|
|
Packit |
022b05 |
-- The Event group controls the generation and notification
|
|
Packit |
022b05 |
-- of events from this device. Each entry in the eventTable
|
|
Packit |
022b05 |
-- describes the parameters of the event that can be triggered.
|
|
Packit |
022b05 |
-- Each event entry is fired by an associated condition located
|
|
Packit |
022b05 |
-- elsewhere in the MIB. An event entry may also be associated
|
|
Packit |
022b05 |
-- with a function elsewhere in the MIB that will be executed
|
|
Packit |
022b05 |
-- when the event is generated. For example, a channel may
|
|
Packit |
022b05 |
-- be turned on or off by the firing of an event.
|
|
Packit |
022b05 |
--
|
|
Packit |
022b05 |
-- Each eventEntry may optionally specify that a log entry
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
-- be created on its behalf whenever the event occurs.
|
|
Packit |
022b05 |
-- Each entry may also specify that notification should
|
|
Packit |
022b05 |
-- occur by way of SNMP trap messages. In this case, the
|
|
Packit |
022b05 |
-- community for the trap message is given in the associated
|
|
Packit |
022b05 |
-- eventCommunity object. The enterprise and specific trap
|
|
Packit |
022b05 |
-- fields of the trap are determined by the condition that
|
|
Packit |
022b05 |
-- triggered the event. Three traps are defined in a companion
|
|
Packit |
022b05 |
-- document: risingAlarm, fallingAlarm, and packetMatch.
|
|
Packit |
022b05 |
-- If the eventTable is triggered by a condition specified
|
|
Packit |
022b05 |
-- elsewhere, the enterprise and specific trap fields
|
|
Packit |
022b05 |
-- must be specified for traps generated for that condition.
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
eventTable OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX SEQUENCE OF EventEntry
|
|
Packit |
022b05 |
ACCESS not-accessible
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"A list of events to be generated."
|
|
Packit |
022b05 |
::= { event 1 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
eventEntry OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX EventEntry
|
|
Packit |
022b05 |
ACCESS not-accessible
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"A set of parameters that describe an event to be
|
|
Packit |
022b05 |
generated when certain conditions are met."
|
|
Packit |
022b05 |
INDEX { eventIndex }
|
|
Packit |
022b05 |
::= { eventTable 1 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
EventEntry ::= SEQUENCE {
|
|
Packit |
022b05 |
eventIndex INTEGER (1..65535),
|
|
Packit |
022b05 |
eventDescription DisplayString (SIZE (0..127)),
|
|
Packit |
022b05 |
eventType INTEGER,
|
|
Packit |
022b05 |
eventCommunity OCTET STRING (SIZE (0..127)),
|
|
Packit |
022b05 |
eventLastTimeSent TimeTicks,
|
|
Packit |
022b05 |
eventOwner OwnerString,
|
|
Packit |
022b05 |
eventStatus INTEGER
|
|
Packit |
022b05 |
}
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
eventIndex OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX INTEGER (1..65535)
|
|
Packit |
022b05 |
ACCESS read-only
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"An index that uniquely identifies an entry in the
|
|
Packit |
022b05 |
event table. Each such entry defines one event that
|
|
Packit |
022b05 |
is to be generated when the appropriate conditions
|
|
Packit |
022b05 |
occur."
|
|
Packit |
022b05 |
::= { eventEntry 1 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
eventDescription OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX DisplayString (SIZE (0..127))
|
|
Packit |
022b05 |
ACCESS read-write
|
|
Packit |
022b05 |
STATUS mandatory
|
|
Packit |
022b05 |
DESCRIPTION
|
|
Packit |
022b05 |
"A comment describing this event entry."
|
|
Packit |
022b05 |
::= { eventEntry 2 }
|
|
Packit |
022b05 |
|
|
Packit |
022b05 |
eventType OBJECT-TYPE
|
|
Packit |
022b05 |
SYNTAX INTEGER {
|
|