Blame mibs/ietf/RFC1271-MIB

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 {
Packit 022b05
                      none(1),
Packit 022b05
                      log(2),
Packit 022b05
                      snmp-trap(3),    -- send an SNMP trap
Packit 022b05
                      log-and-trap(4)
Packit 022b05
              }
Packit 022b05
              ACCESS read-write
Packit 022b05
              STATUS mandatory
Packit 022b05
              DESCRIPTION
Packit 022b05
                  "The type of notification that the probe will make
Packit 022b05
                  about this event.  In the case of log, an entry is
Packit 022b05
                  made in the log table for each event.  In the case of
Packit 022b05
                  snmp-trap, an SNMP trap is sent to one or more
Packit 022b05
                  management stations."
Packit 022b05
              ::= { eventEntry 3 }
Packit 022b05
 
Packit 022b05
          eventCommunity OBJECT-TYPE
Packit 022b05
              SYNTAX OCTET STRING (SIZE (0..127))
Packit 022b05
              ACCESS read-write
Packit 022b05
              STATUS mandatory
Packit 022b05
              DESCRIPTION
Packit 022b05
                  "If an SNMP trap is to be sent, it will be sent to
Packit 022b05
                  the SNMP community specified by this octet string.
Packit 022b05
                  In the future this table will be extended to include
Packit 022b05
                  the party security mechanism.  This object shall be
Packit 022b05
                  set to a string of length zero if it is intended that
Packit 022b05
                  that mechanism be used to specify the destination of
Packit 022b05
                  the trap."
Packit 022b05
              ::= { eventEntry 4 }
Packit 022b05
 
Packit 022b05
          eventLastTimeSent 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 time this event
Packit 022b05
                  entry last generated an event.  If this entry has
Packit 022b05
                  not generated any events, this value will be
Packit 022b05
                  zero."
Packit 022b05
              ::= { eventEntry 5 }
Packit 022b05
 
Packit 022b05
          eventOwner 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
 
Packit 022b05
                  If this object contains a string starting with 'monitor'
Packit 022b05
                  and has associated entries in the log table, all
Packit 022b05
                  connected management stations should retrieve those
Packit 022b05
                  log entries, as they may have significance to all
Packit 022b05
                  management stations connected to this device"
Packit 022b05
              ::= { eventEntry 6 }
Packit 022b05
 
Packit 022b05
          eventStatus OBJECT-TYPE
Packit 022b05
              SYNTAX EntryStatus
Packit 022b05
              ACCESS read-write
Packit 022b05
              STATUS mandatory
Packit 022b05
              DESCRIPTION
Packit 022b05
                  "The status of this event entry.
Packit 022b05
 
Packit 022b05
                  If this object is not equal to valid(1), all associated
Packit 022b05
                  log entries shall be deleted by the agent."
Packit 022b05
              ::= { eventEntry 7 }
Packit 022b05
 
Packit 022b05
          --
Packit 022b05
          logTable OBJECT-TYPE
Packit 022b05
              SYNTAX SEQUENCE OF LogEntry
Packit 022b05
              ACCESS not-accessible
Packit 022b05
              STATUS mandatory
Packit 022b05
              DESCRIPTION
Packit 022b05
                  "A list of events that have been logged."
Packit 022b05
              ::= { event 2 }
Packit 022b05
 
Packit 022b05
          logEntry OBJECT-TYPE
Packit 022b05
              SYNTAX LogEntry
Packit 022b05
              ACCESS not-accessible
Packit 022b05
              STATUS mandatory
Packit 022b05
              DESCRIPTION
Packit 022b05
                  "A set of data describing an event that has been
Packit 022b05
                  logged."
Packit 022b05
              INDEX { logEventIndex, logIndex }
Packit 022b05
              ::= { logTable 1 }
Packit 022b05
 
Packit 022b05
          LogEntry ::= SEQUENCE {
Packit 022b05
              logEventIndex           INTEGER (1..65535),
Packit 022b05
              logIndex                INTEGER,
Packit 022b05
              logTime                 TimeTicks,
Packit 022b05
              logDescription          DisplayString (SIZE (0..255))
Packit 022b05
          }
Packit 022b05
 
Packit 022b05
          logEventIndex OBJECT-TYPE
Packit 022b05
              SYNTAX INTEGER (1..65535)
Packit 022b05
              ACCESS read-only
Packit 022b05
              STATUS mandatory
Packit 022b05
              DESCRIPTION
Packit 022b05
                  "The event entry that generated this log
Packit 022b05
                  entry.  The log identified by a particular
Packit 022b05
                  value of this index is associated with the same
Packit 022b05
                  eventEntry as identified by the same value
Packit 022b05
                  of eventIndex."
Packit 022b05
              ::= { logEntry 1 }
Packit 022b05
 
Packit 022b05
          logIndex 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 log table amongst those generated by the
Packit 022b05
                  same eventEntries.  These indexes are
Packit 022b05
                  assigned beginning with 1 and increase by one
Packit 022b05
                  with each new log entry.  The association
Packit 022b05
                  between values of logIndex and logEntries
Packit 022b05
                  is fixed for the lifetime of each logEntry.
Packit 022b05
                  The agent may choose to delete the oldest
Packit 022b05
                  instances of logEntry as required because of
Packit 022b05
                  lack of memory.  It is an implementation-specific
Packit 022b05
                  matter as to when this deletion may occur."
Packit 022b05
              ::= { logEntry 2 }
Packit 022b05
 
Packit 022b05
          logTime 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 log entry was
Packit 022b05
                  created."
Packit 022b05
              ::= { logEntry 3 }
Packit 022b05
Packit 022b05
          logDescription OBJECT-TYPE
Packit 022b05
              SYNTAX DisplayString (SIZE (0..255))
Packit 022b05
              ACCESS read-only
Packit 022b05
              STATUS mandatory
Packit 022b05
              DESCRIPTION
Packit 022b05
                  "An implementation dependent description of the
Packit 022b05
                  event that activated this log entry."
Packit 022b05
              ::= { logEntry 4 }
Packit 022b05
 
Packit 022b05
          END