Blame mibs/ietf/RMON2-MIB

Packit 022b05
RMON2-MIB DEFINITIONS ::= BEGIN
Packit 022b05
IMPORTS
Packit 022b05
    MODULE-IDENTITY, OBJECT-TYPE, Counter32, Integer32,
Packit 022b05
    Gauge32, IpAddress, TimeTicks, mib-2         FROM SNMPv2-SMI
Packit 022b05
    TEXTUAL-CONVENTION, RowStatus, DisplayString, TimeStamp
Packit 022b05
                                                 FROM SNMPv2-TC
Packit 022b05
    MODULE-COMPLIANCE, OBJECT-GROUP              FROM SNMPv2-CONF
Packit 022b05
    ifIndex                                      FROM IF-MIB
Packit 022b05
    OwnerString, statistics, history, hosts,
Packit 022b05
    matrix, filter, etherStatsEntry, historyControlEntry,
Packit 022b05
    hostControlEntry, matrixControlEntry, filterEntry,
Packit 022b05
    channelEntry                    FROM RMON-MIB
Packit 022b05
    tokenRing, tokenRingMLStatsEntry, tokenRingPStatsEntry,
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
    ringStationControlEntry, sourceRoutingStatsEntry
Packit 022b05
                                    FROM TOKEN-RING-RMON-MIB;
Packit 022b05
--  Remote Network Monitoring MIB
Packit 022b05
Packit 022b05
rmon MODULE-IDENTITY
Packit 022b05
    LAST-UPDATED "200605020000Z"    -- May 2, 2006
Packit 022b05
    ORGANIZATION "IETF RMON MIB Working Group"
Packit 022b05
    CONTACT-INFO
Packit 022b05
        "Author:
Packit 022b05
                     Steve Waldbusser
Packit 022b05
             Phone:  +1-650-948-6500
Packit 022b05
             Fax :   +1-650-745-0671
Packit 022b05
             Email:  waldbusser@nextbeacon.com
Packit 022b05
Packit 022b05
         Working Group Chair:
Packit 022b05
                     Andy Bierman
Packit 022b05
             E-mail: ietf@andybierman.com
Packit 022b05
Packit 022b05
         Working Group Mailing List: <rmonmib@ietf.org>
Packit 022b05
         To subscribe send email to: <rmonmib-request@ietf.org>    "
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The MIB module for managing remote monitoring
Packit 022b05
         device implementations.  This MIB module
Packit 022b05
         extends the architecture introduced in the original
Packit 022b05
         RMON MIB as specified in RFC 2819.
Packit 022b05
Packit 022b05
         Copyright (C) The Internet Society (2006).  This version of
Packit 022b05
         this MIB module is part of RFC 4502;  see the RFC itself for
Packit 022b05
         full legal notices."
Packit 022b05
Packit 022b05
    REVISION "200605020000Z"    -- May 2, 2006
Packit 022b05
    DESCRIPTION
Packit 022b05
        "This version updates the proposed-standard version of the
Packit 022b05
        RMON2 MIB (published as RFC 2021) by adding 2 new
Packit 022b05
        enumerations to the nlMatrixTopNControlRateBase object and
Packit 022b05
        4 new enumerations to the alMatrixTopNControlRateBase object.
Packit 022b05
        These new enumerations support the creation of high-capacity
Packit 022b05
        topN reports in the High Capacity RMON MIB [RFC3273].
Packit 022b05
Packit 022b05
        Additionally, the following objects have been deprecated, as
Packit 022b05
        they have not had enough independent implementations to
Packit 022b05
        demonstrate interoperability to meet the requirements of a
Packit 022b05
        Draft Standard:
Packit 022b05
Packit 022b05
        probeDownloadFile
Packit 022b05
        probeDownloadTFTPServer
Packit 022b05
        probeDownloadAction
Packit 022b05
        probeDownloadStatus
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
        serialMode
Packit 022b05
        serialProtocol
Packit 022b05
        serialTimeout
Packit 022b05
        serialModemInitString
Packit 022b05
        serialModemHangUpString
Packit 022b05
        serialModemConnectResp
Packit 022b05
        serialModemNoConnectResp
Packit 022b05
        serialDialoutTimeout
Packit 022b05
        serialStatus
Packit 022b05
        serialConnectDestIpAddress
Packit 022b05
        serialConnectType
Packit 022b05
        serialConnectDialString
Packit 022b05
        serialConnectSwitchConnectSeq
Packit 022b05
        serialConnectSwitchDisconnectSeq
Packit 022b05
        serialConnectSwitchResetSeq
Packit 022b05
        serialConnectOwner
Packit 022b05
        serialConnectStatus
Packit 022b05
        netConfigIPAddress
Packit 022b05
        netConfigSubnetMask
Packit 022b05
        netConfigStatus
Packit 022b05
        netDefaultGateway
Packit 022b05
        tokenRingMLStats2DroppedFrames
Packit 022b05
        tokenRingMLStats2CreateTime
Packit 022b05
        tokenRingPStats2DroppedFrames
Packit 022b05
        tokenRingPStats2CreateTime
Packit 022b05
        ringStationControl2DroppedFrames
Packit 022b05
        ringStationControl2CreateTime
Packit 022b05
        sourceRoutingStats2DroppedFrames
Packit 022b05
        sourceRoutingStats2CreateTime
Packit 022b05
        trapDestIndex
Packit 022b05
        trapDestCommunity
Packit 022b05
        trapDestProtocol
Packit 022b05
        trapDestAddress
Packit 022b05
        trapDestOwner
Packit 022b05
        trapDestStatus
Packit 022b05
Packit 022b05
        In addition, two corrections were made.  The LastCreateTime
Packit 022b05
        Textual Convention had been defined with a base type of
Packit 022b05
        another textual convention, which isn't allowed in SMIv2.  The
Packit 022b05
        definition has been modified to use TimeTicks as the base
Packit 022b05
        type.
Packit 022b05
Packit 022b05
        Further, the SerialConfigEntry SEQUENCE definition included
Packit 022b05
        sub-typing information that is not allowed in SMIv2.  This
Packit 022b05
        information has been deleted.  Ranges were added to a number of
Packit 022b05
        objects and textual-conventions to constrain their maximum
Packit 022b05
        (and sometimes minimum) sizes.  The addition of these ranges
Packit 022b05
        documents existing practice for these objects.  These objects
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
        are:
Packit 022b05
            ControlString
Packit 022b05
            protocolDirID
Packit 022b05
            protocolDirParameters
Packit 022b05
            addressMapNetworkAddress
Packit 022b05
            nlHostAddress
Packit 022b05
            nlMatrixSDSourceAddress
Packit 022b05
            nlMatrixSDDestAddress
Packit 022b05
            nlMatrixDSSourceAddress
Packit 022b05
            nlMatrixDSDestAddress
Packit 022b05
            nlMatrixTopNSourceAddress
Packit 022b05
            nlMatrixTopNDestAddress
Packit 022b05
            alHostEntry
Packit 022b05
            alMatrixSDEntry
Packit 022b05
            alMatrixDSEntry
Packit 022b05
            alMatrixTopNSourceAddress
Packit 022b05
            alMatrixTopNDestAddress
Packit 022b05
Packit 022b05
        Finally, the TimeFilter TC has been updated to encourage agent
Packit 022b05
        implementations that allow a MIB walk to behave well even when
Packit 022b05
        performed by an application that is not aware of the special
Packit 022b05
        TimeFilter semantics."
Packit 022b05
Packit 022b05
    REVISION "200207080000Z"        -- 08 July, 2002
Packit 022b05
    DESCRIPTION
Packit 022b05
        "Added new enumerations to support the High-Capacity RMON
Packit 022b05
        MIB as defined in RFC 3273.  Also fixed some typos and
Packit 022b05
        added clarifications."
Packit 022b05
Packit 022b05
    REVISION "199605270000Z"    -- 27 May, 1996
Packit 022b05
    DESCRIPTION
Packit 022b05
        "Original version.  Published as RFC 2021."
Packit 022b05
    ::= { mib-2 16 }
Packit 022b05
Packit 022b05
-- { rmon 1 } through { rmon 10 } are defined in RMON and
Packit 022b05
-- the Token Ring RMON MIB [RFC1513]
Packit 022b05
Packit 022b05
    protocolDir     OBJECT IDENTIFIER ::= { rmon 11 }
Packit 022b05
    protocolDist    OBJECT IDENTIFIER ::= { rmon 12 }
Packit 022b05
    addressMap      OBJECT IDENTIFIER ::= { rmon 13 }
Packit 022b05
    nlHost          OBJECT IDENTIFIER ::= { rmon 14 }
Packit 022b05
    nlMatrix        OBJECT IDENTIFIER ::= { rmon 15 }
Packit 022b05
    alHost          OBJECT IDENTIFIER ::= { rmon 16 }
Packit 022b05
    alMatrix        OBJECT IDENTIFIER ::= { rmon 17 }
Packit 022b05
    usrHistory      OBJECT IDENTIFIER ::= { rmon 18 }
Packit 022b05
    probeConfig     OBJECT IDENTIFIER ::= { rmon 19 }
Packit 022b05
    rmonConformance OBJECT IDENTIFIER ::= { rmon 20 }
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
-- Textual Conventions
Packit 022b05
Packit 022b05
ZeroBasedCounter32 ::= TEXTUAL-CONVENTION
Packit 022b05
    STATUS current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "This TC describes an object that counts events with the
Packit 022b05
        following semantics: objects of this type will be set to
Packit 022b05
        zero(0) on creation and will thereafter count appropriate
Packit 022b05
        events, wrapping back to zero(0) when the value 2^32 is
Packit 022b05
        reached.
Packit 022b05
Packit 022b05
        Provided that an application discovers the new object within
Packit 022b05
        the minimum time to wrap, it can use the initial value as a
Packit 022b05
        delta since it last polled the table of which this object is
Packit 022b05
        part.  It is important for a management station to be aware of
Packit 022b05
        this minimum time and the actual time between polls, and to
Packit 022b05
        discard data if the actual time is too long or there is no
Packit 022b05
        defined minimum time.
Packit 022b05
Packit 022b05
        Typically, this TC is used in tables where the INDEX space is
Packit 022b05
        constantly changing and/or the TimeFilter mechanism is in use."
Packit 022b05
    SYNTAX Gauge32
Packit 022b05
Packit 022b05
LastCreateTime ::= TEXTUAL-CONVENTION
Packit 022b05
    STATUS current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "This TC describes an object that stores the value of the
Packit 022b05
        sysUpTime object at the last time its entry was created.
Packit 022b05
Packit 022b05
        This can be used for polling applications to determine that an
Packit 022b05
        entry has been deleted and re-created between polls, causing
Packit 022b05
        an otherwise undetectable discontinuity in the data.
Packit 022b05
Packit 022b05
        If sysUpTime is reset to zero as a result of a re-
Packit 022b05
        initialization of the network management (sub)system, then
Packit 022b05
        the values of all LastCreateTime objects are also reset.
Packit 022b05
        However, after approximately 497 days without a re-
Packit 022b05
        initialization, the sysUpTime object will reach 2^^32-1 and
Packit 022b05
        then increment to zero; in this case, existing values
Packit 022b05
        of TimeStamp objects do not change.  This can lead to
Packit 022b05
        ambiguities in the value of TimeStamp objects."
Packit 022b05
    SYNTAX TimeTicks
Packit 022b05
Packit 022b05
TimeFilter ::= TEXTUAL-CONVENTION
Packit 022b05
  STATUS        current
Packit 022b05
  DESCRIPTION
Packit 022b05
      "To be used for the index to a table.  Allows an application
Packit 022b05
      to download only those rows changed since a particular time.
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
      Note that this is not a history mechanism.  Only current values
Packit 022b05
      of underlying objects are returned; saved instance values
Packit 022b05
      associated with particular values of sysUpTime are not.
Packit 022b05
Packit 022b05
      An entry is considered changed if the value of any object in the
Packit 022b05
      entry changes, if the row is created, or if any object in the
Packit 022b05
      entry is created or deleted.  Note that deleted entries cannot
Packit 022b05
      be detected or downloaded.
Packit 022b05
Packit 022b05
      A time-filtered conceptual table is created by inserting a
Packit 022b05
      single object of SYNTAX TimeFilter as the first INDEX component
Packit 022b05
      in a copy of an existing basic conceptual table (i.e., any
Packit 022b05
      SEQUENCE without a TimeFilter INDEX component).  Thus, for
Packit 022b05
      each conceptual entry 'I' in the basic table, there exists N
Packit 022b05
      conceptual entries in the time-filtered version, indexed N.I,
Packit 022b05
      where 'N' is equal to the value of sysUpTime.
Packit 022b05
Packit 022b05
      When an application retrieves conceptual instances from a
Packit 022b05
      time-filtered table, and an INDEX value is provided for the
Packit 022b05
      TimeFilter INDEX component 'N', the agent will only consider
Packit 022b05
      returning basic conceptual entries (e.g., 'fooColumn.N.I') if
Packit 022b05
      any column within the basic conceptual entry has changed since
Packit 022b05
      sysUpTime 'N'.  If not, the basic conceptual entry will
Packit 022b05
      be ignored for the particular retrieval operation.
Packit 022b05
Packit 022b05
      When sysUpTime is equal to zero, this table shall be empty.
Packit 022b05
Packit 022b05
      One conceptual entry exists for each past value of sysUpTime,
Packit 022b05
      except that the whole table is purged should sysUpTime wrap.
Packit 022b05
Packit 022b05
      As an entry in a time-filtered table is updated (i.e., one of
Packit 022b05
      the columns in the basic conceptual table is changed), new
Packit 022b05
      conceptual entries are also created in the time-filtered version
Packit 022b05
      (which still shares the now updated object values with all other
Packit 022b05
      instances).  The number of unique time-filtered instances that
Packit 022b05
      are created is determined by the value of sysUpTime at which the
Packit 022b05
      basic entry was last updated.  One unique instance will exist
Packit 022b05
      for each value of sysUpTime at the last update time for the row.
Packit 022b05
      However, a new TimeFilter index instance is created for each new
Packit 022b05
      sysUpTime value.  The TimeFilter index values not associated
Packit 022b05
      with entry updates are called duplicate time-filtered instances.
Packit 022b05
Packit 022b05
      After some deployment experience, it has been determined that
Packit 022b05
      a time-filtered table is more efficient if the agent
Packit 022b05
      stops a MIB walk operation by skipping over rows with a
Packit 022b05
      TimeFilter index value higher than the value in the received
Packit 022b05
      GetNext/GetBulk request.  That is, instead of incrementing a
Packit 022b05
      TimeFilter index value, the agent will continue to the next
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
      object or table.  As a consequence, GetNext or GetBulk
Packit 022b05
      operations will provide only one pass through a time-filtered
Packit 022b05
      table.
Packit 022b05
Packit 022b05
      It is suggested that an agent implement a time-filtered table
Packit 022b05
      in this manner to improve performance and avoid a MIB walk
Packit 022b05
      getting stuck in time-filtered tables.  It is, however, still
Packit 022b05
      acceptable for an agent to implement a time-filtered table in
Packit 022b05
      the traditional manner (i.e., every conceptual time-filtered
Packit 022b05
      instance is returned in GetNext and GetBulk PDU responses), and
Packit 022b05
      management applications must be able to deal with such
Packit 022b05
      traditional implementations.
Packit 022b05
Packit 022b05
      See the appendix for further discussion of this textual
Packit 022b05
      convention.
Packit 022b05
Packit 022b05
      The following example is provided to demonstrate TimeFilter
Packit 022b05
      behavior:
Packit 022b05
Packit 022b05
      Consider the following basic conceptual table, basicFooTable.
Packit 022b05
      (Note that the basic version of a time-filtered table may not
Packit 022b05
      actually be defined.)
Packit 022b05
Packit 022b05
          basicFooTable:
Packit 022b05
Packit 022b05
          basicFooTable ...
Packit 022b05
          INDEX { fooIndex }
Packit 022b05
Packit 022b05
          BasicFooEntry {
Packit 022b05
             fooIndex     Integer32,
Packit 022b05
             fooCounts    Counter32
Packit 022b05
          }
Packit 022b05
Packit 022b05
      For this example, the basicFooTable contains two static
Packit 022b05
      conceptual entries (fooIndex equals '1' and '2'), created at
Packit 022b05
      time zero.  It also contains one dynamic conceptual entry
Packit 022b05
      (fooIndex equals '3'), which is created at time '3' and deleted
Packit 022b05
      at time '7'.
Packit 022b05
Packit 022b05
      The time-filtered version of the basicFooTable could be defined
Packit 022b05
      as follows:
Packit 022b05
Packit 022b05
          FooTable:
Packit 022b05
Packit 022b05
          fooTable ...
Packit 022b05
          INDEX { fooTimeMark, fooIndex }
Packit 022b05
Packit 022b05
          FooEntry {
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
             fooTimeMark  TimeFilter,
Packit 022b05
             fooIndex     Integer32,
Packit 022b05
             fooCounts    Counter32
Packit 022b05
          }
Packit 022b05
Packit 022b05
Packit 022b05
      Note that entries exist in the time-filtered conceptual table
Packit 022b05
      only if they actually exist in the underlying (basic) table.
Packit 022b05
Packit 022b05
      For this example, the fooTable will have three underlying
Packit 022b05
      basic entries (fooIndex == 1, 2, and 3), with the following
Packit 022b05
      activity (for sysUpTime equal 0 to 9):
Packit 022b05
Packit 022b05
         - fooEntry.N.1 is created at time '0' and most recently
Packit 022b05
           updated at time '6' to the value '5'.
Packit 022b05
         - fooEntry.N.2 is created at time '0' and most recently
Packit 022b05
           updated at time '8' to the value '9'.
Packit 022b05
         - fooEntry.N.3 is created at time '3', updated at time '5'
Packit 022b05
           to the value '17', and deleted at time '7'.
Packit 022b05
Packit 022b05
     The following tables show the values that would be returned for
Packit 022b05
     MIB walk operations with various TimeFilter values, done at
Packit 022b05
     different times.  An application issues a retrieval request at
Packit 022b05
     time 'T', with a TimeFilter value, 'N' (typically set to a lower
Packit 022b05
     value, such as the value of sysUpTime at the last polling cycle).
Packit 022b05
Packit 022b05
     The following values would be returned in a MIB walk of
Packit 022b05
     fooCounts.N if T equals '0' and N equals '0':
Packit 022b05
Packit 022b05
           fooCounts.N.I    Value
Packit 022b05
           ==========================
Packit 022b05
           fooCounts.0.1    0
Packit 022b05
           fooCounts.0.2    0
Packit 022b05
Packit 022b05
       Note that nothing is returned for fooCounts.0.3, since that
Packit 022b05
       entry does not exist at sysUpTime equals '0'.
Packit 022b05
Packit 022b05
     The following values would be returned in a full (traditional) MIB
Packit 022b05
     walk of fooCounts.N if T equals '3' and N equals '0':
Packit 022b05
Packit 022b05
           fooCounts.N.I    Value
Packit 022b05
           =======================
Packit 022b05
           fooCounts.0.1    0
Packit 022b05
           fooCounts.0.2    0
Packit 022b05
           fooCounts.0.3    0
Packit 022b05
           fooCounts.1.3    0
Packit 022b05
           fooCounts.2.3    0
Packit 022b05
           fooCounts.3.3    0
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
       Note that there are no instances for T equals 1 or 2 for the
Packit 022b05
       first two values of N, as these entries did not change
Packit 022b05
       since they were created at time '0'.
Packit 022b05
Packit 022b05
       Note that the current value for 'fooCounts.N.3' is returned
Packit 022b05
       here, even for values of N less than '3' (when the entry was
Packit 022b05
       created).  The agent only considers the current existence of an
Packit 022b05
       entry in the TimeFilter algorithm, not the time when the entry
Packit 022b05
       was created.
Packit 022b05
Packit 022b05
       Note that the instances 'fooCounts.0.3', 'fooCounts.1.3',
Packit 022b05
       and 'fooCounts.2.3' are duplicates and can be suppressed by the
Packit 022b05
       agent in a MIB walk.
Packit 022b05
Packit 022b05
     The following values would be returned in a full (traditional)
Packit 022b05
     MIB walk of fooCounts.N if T equals '6' and N equals '3':
Packit 022b05
Packit 022b05
           fooCounts.N.I    Value
Packit 022b05
           =======================
Packit 022b05
           fooCounts.3.1    5
Packit 022b05
           fooCounts.3.3    17
Packit 022b05
           fooCounts.4.1    5
Packit 022b05
           fooCounts.4.3    17
Packit 022b05
           fooCounts.5.1    5
Packit 022b05
           fooCounts.5.3    17
Packit 022b05
           fooCounts.6.1    5
Packit 022b05
Packit 022b05
        Note that no instances for entry 'fooCounts.N.2' are returned,
Packit 022b05
        since it has not changed since time '3'.
Packit 022b05
Packit 022b05
        Note that all instances except 'fooCounts.5.3' and
Packit 022b05
        'fooCounts.6.1' are duplicates and can be suppressed by the
Packit 022b05
        agent in a MIB walk.
Packit 022b05
Packit 022b05
     The following values would be returned in a full (traditional)
Packit 022b05
     MIB walk of fooCounts.N if T equals '9' and N equals '6':
Packit 022b05
Packit 022b05
           fooCounts.N.I    Value
Packit 022b05
           =======================
Packit 022b05
           fooCounts.6.1    5
Packit 022b05
           fooCounts.6.2    9
Packit 022b05
           fooCounts.7.2    9
Packit 022b05
           fooCounts.8.2    9
Packit 022b05
Packit 022b05
        Note that no instances for entry 'fooCounts.N.3' are returned,
Packit 022b05
        since it was deleted at time '7'.
Packit 022b05
Packit 022b05
        Note that instances 'fooCounts.6.2' and 'fooCounts.7.2'
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
        are duplicates and can be suppressed by the agent in a MIB
Packit 022b05
        walk."
Packit 022b05
Packit 022b05
  SYNTAX    TimeTicks
Packit 022b05
Packit 022b05
DataSource ::= TEXTUAL-CONVENTION
Packit 022b05
    STATUS        current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "Identifies the source of the data that the associated
Packit 022b05
        function is configured to analyze.  This source can be any
Packit 022b05
        interface on this device.
Packit 022b05
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 [RFC2863], for the desired interface.
Packit 022b05
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
    SYNTAX      OBJECT IDENTIFIER
Packit 022b05
Packit 022b05
--
Packit 022b05
-- Protocol Directory Group
Packit 022b05
--
Packit 022b05
-- Lists the inventory of protocols the probe has the capability of
Packit 022b05
-- monitoring and allows the addition, deletion, and configuration of
Packit 022b05
-- entries in this list.
Packit 022b05
Packit 022b05
protocolDirLastChange OBJECT-TYPE
Packit 022b05
    SYNTAX      TimeStamp
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The value of sysUpTime at the time the protocol directory
Packit 022b05
        was last modified, either through insertions or deletions,
Packit 022b05
        or through modifications of the
Packit 022b05
        protocolDirAddressMapConfig, protocolDirHostConfig, or
Packit 022b05
        protocolDirMatrixConfig."
Packit 022b05
    ::= { protocolDir 1 }
Packit 022b05
Packit 022b05
protocolDirTable OBJECT-TYPE
Packit 022b05
    SYNTAX      SEQUENCE OF ProtocolDirEntry
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "This table lists the protocols that this agent has the
Packit 022b05
        capability to decode and count.  There is one entry in this
Packit 022b05
        table for each such protocol.  These protocols represent
Packit 022b05
        different network-layer, transport-layer, and higher-layer
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
        protocols.  The agent should boot up with this table
Packit 022b05
        preconfigured with those protocols that it knows about and
Packit 022b05
        wishes to monitor.  Implementations are strongly encouraged to
Packit 022b05
        support protocols higher than the network layer (at least for
Packit 022b05
        the protocol distribution group), even for implementations
Packit 022b05
        that don't support the application-layer groups."
Packit 022b05
    ::= { protocolDir 2 }
Packit 022b05
Packit 022b05
protocolDirEntry OBJECT-TYPE
Packit 022b05
    SYNTAX      ProtocolDirEntry
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A conceptual row in the protocolDirTable.
Packit 022b05
Packit 022b05
         An example of the indexing of this entry is
Packit 022b05
         protocolDirLocalIndex.8.0.0.0.1.0.0.8.0.2.0.0, which is the
Packit 022b05
         encoding of a length of 8, followed by 8 subids encoding the
Packit 022b05
         protocolDirID of 1.2048, followed by a length of 2 and the
Packit 022b05
         2 subids encoding zero-valued parameters.
Packit 022b05
Packit 022b05
         Note that some combinations of index values may result in an
Packit 022b05
         index that exceeds 128 sub-identifiers in length, which exceeds
Packit 022b05
         the maximum for the SNMP protocol.  Implementations should take
Packit 022b05
         care to avoid such combinations."
Packit 022b05
    INDEX { protocolDirID, protocolDirParameters }
Packit 022b05
    ::= { protocolDirTable  1 }
Packit 022b05
Packit 022b05
ProtocolDirEntry ::= SEQUENCE {
Packit 022b05
    protocolDirID                   OCTET STRING,
Packit 022b05
    protocolDirParameters           OCTET STRING,
Packit 022b05
    protocolDirLocalIndex           Integer32,
Packit 022b05
    protocolDirDescr                DisplayString,
Packit 022b05
    protocolDirType                 BITS,
Packit 022b05
    protocolDirAddressMapConfig     INTEGER,
Packit 022b05
    protocolDirHostConfig           INTEGER,
Packit 022b05
    protocolDirMatrixConfig         INTEGER,
Packit 022b05
    protocolDirOwner                OwnerString,
Packit 022b05
    protocolDirStatus               RowStatus
Packit 022b05
}
Packit 022b05
Packit 022b05
protocolDirID OBJECT-TYPE
Packit 022b05
    SYNTAX      OCTET STRING  (SIZE (4..128))
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A unique identifier for a particular protocol.  Standard
Packit 022b05
        identifiers will be defined in such a manner that they
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
        can often be used as specifications for new protocols - i.e.,
Packit 022b05
        a tree-structured assignment mechanism that matches the
Packit 022b05
        protocol encapsulation 'tree' and that has algorithmic
Packit 022b05
        assignment mechanisms for certain subtrees.  See RFC 2074 for
Packit 022b05
        more details.
Packit 022b05
Packit 022b05
        Despite the algorithmic mechanism, the probe will only place
Packit 022b05
        entries in here for those protocols it chooses to collect.  In
Packit 022b05
        other words, it need not populate this table with all
Packit 022b05
        possible ethernet protocol types, nor need it create them on
Packit 022b05
        the fly when it sees them.  Whether it does these
Packit 022b05
        things is a matter of product definition (cost/benefit,
Packit 022b05
        usability) and is up to the designer of the product.
Packit 022b05
Packit 022b05
        If an entry is written to this table with a protocolDirID that
Packit 022b05
        the agent doesn't understand, either directly or
Packit 022b05
        algorithmically, the SET request will be rejected with an
Packit 022b05
        inconsistentName or badValue (for SNMPv1) error."
Packit 022b05
    ::= { protocolDirEntry 1 }
Packit 022b05
Packit 022b05
protocolDirParameters OBJECT-TYPE
Packit 022b05
    SYNTAX      OCTET STRING (SIZE (1..32))
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A set of parameters for the associated protocolDirID.
Packit 022b05
        See the associated RMON2 Protocol Identifiers document
Packit 022b05
        for a description of the possible parameters.  There
Packit 022b05
        will be one octet in this string for each sub-identifier in
Packit 022b05
        the protocolDirID, and the parameters will appear here in the
Packit 022b05
        same order as the associated sub-identifiers appear in the
Packit 022b05
        protocolDirID.
Packit 022b05
Packit 022b05
        Every node in the protocolDirID tree has a different, optional
Packit 022b05
        set of parameters defined (that is, the definition of
Packit 022b05
        parameters for a node is optional).  The proper parameter
Packit 022b05
        value for each node is included in this string.  Note that the
Packit 022b05
        inclusion of a parameter value in this string for each node is
Packit 022b05
        not optional.  What is optional is that a node may have no
Packit 022b05
        parameters defined, in which case the parameter field for that
Packit 022b05
        node will be zero."
Packit 022b05
    ::= { protocolDirEntry 2 }
Packit 022b05
Packit 022b05
protocolDirLocalIndex OBJECT-TYPE
Packit 022b05
    SYNTAX      Integer32 (1..2147483647)
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
        "The locally arbitrary but unique identifier associated
Packit 022b05
        with this protocolDir entry.
Packit 022b05
Packit 022b05
        The value for each supported protocol must remain constant at
Packit 022b05
        least from one re-initialization of the entity's network
Packit 022b05
        management system to the next re-initialization, except that
Packit 022b05
        if a protocol is deleted and re-created, it must be re-created
Packit 022b05
        with a new value that has not been used since the last
Packit 022b05
        re-initialization.
Packit 022b05
Packit 022b05
        The specific value is meaningful only within a given SNMP
Packit 022b05
        entity.  A protocolDirLocalIndex must not be re-used until the
Packit 022b05
        next agent restart in the event that the protocol directory
Packit 022b05
        entry is deleted."
Packit 022b05
    ::= { protocolDirEntry 3 }
Packit 022b05
Packit 022b05
protocolDirDescr OBJECT-TYPE
Packit 022b05
    SYNTAX      DisplayString (SIZE (1..64))
Packit 022b05
    MAX-ACCESS  read-create
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A textual description of the protocol encapsulation.
Packit 022b05
        A probe may choose to describe only a subset of the
Packit 022b05
        entire encapsulation (e.g., only the highest layer).
Packit 022b05
Packit 022b05
        This object is intended for human consumption only.
Packit 022b05
Packit 022b05
        This object may not be modified if the associated
Packit 022b05
        protocolDirStatus object is equal to active(1)."
Packit 022b05
    ::= { protocolDirEntry 4 }
Packit 022b05
Packit 022b05
protocolDirType OBJECT-TYPE
Packit 022b05
    SYNTAX      BITS {
Packit 022b05
                    extensible(0),
Packit 022b05
                    addressRecognitionCapable(1)
Packit 022b05
                }
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "This object describes 2 attributes of this protocol
Packit 022b05
         directory entry.
Packit 022b05
Packit 022b05
         The presence or absence of the 'extensible' bit describes
Packit 022b05
         whether this protocol directory entry can be extended
Packit 022b05
         by the user by creating protocol directory entries that are
Packit 022b05
         children of this protocol.
Packit 022b05
Packit 022b05
         An example of an entry that will often allow extensibility is
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
         'ip.udp'.  The probe may automatically populate some children
Packit 022b05
         of this node, such as 'ip.udp.snmp' and 'ip.udp.dns'.
Packit 022b05
         A probe administrator or user may also populate additional
Packit 022b05
         children via remote SNMP requests that create entries in this
Packit 022b05
         table.  When a child node is added for a protocol for which the
Packit 022b05
         probe has no built-in support extending a parent node (for
Packit 022b05
         which the probe does have built-in support),
Packit 022b05
         that child node is not extendable.  This is termed 'limited
Packit 022b05
         extensibility'.
Packit 022b05
Packit 022b05
         When a child node is added through this extensibility
Packit 022b05
         mechanism, the values of protocolDirLocalIndex and
Packit 022b05
         protocolDirType shall be assigned by the agent.
Packit 022b05
Packit 022b05
         The other objects in the entry will be assigned by the
Packit 022b05
         manager who is creating the new entry.
Packit 022b05
Packit 022b05
         This object also describes whether this agent can
Packit 022b05
         recognize addresses for this protocol, should it be a
Packit 022b05
         network-level protocol.  That is, while a probe may be able
Packit 022b05
         to recognize packets of a particular network-layer protocol
Packit 022b05
         and count them, it takes additional logic to be able to
Packit 022b05
         recognize the addresses in this protocol and to populate
Packit 022b05
         network-layer or application-layer tables with the addresses
Packit 022b05
         in this protocol.  If this bit is set, the agent will
Packit 022b05
         recognize network-layer addresses for this protocol and
Packit 022b05
         populate the network- and application-layer host and matrix
Packit 022b05
         tables with these protocols.
Packit 022b05
Packit 022b05
         Note that when an entry is created, the agent will supply
Packit 022b05
         values for the bits that match the capabilities of the agent
Packit 022b05
         with respect to this protocol.  Note that since row creations
Packit 022b05
         usually exercise the limited extensibility feature, these
Packit 022b05
         bits will usually be set to zero."
Packit 022b05
    ::= { protocolDirEntry 5 }
Packit 022b05
Packit 022b05
protocolDirAddressMapConfig OBJECT-TYPE
Packit 022b05
    SYNTAX      INTEGER {
Packit 022b05
                    notSupported(1),
Packit 022b05
                    supportedOff(2),
Packit 022b05
                    supportedOn(3)
Packit 022b05
                }
Packit 022b05
    MAX-ACCESS  read-create
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "This object describes and configures the probe's support for
Packit 022b05
        address mapping for this protocol.  When the probe creates
Packit 022b05
        entries in this table for all protocols that it understands,
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
        it will set the entry to notSupported(1) if it doesn't have
Packit 022b05
        the capability to perform address mapping for the protocol or
Packit 022b05
        if this protocol is not a network-layer protocol.  When
Packit 022b05
        an entry is created in this table by a management operation as
Packit 022b05
        part of the limited extensibility feature, the probe must set
Packit 022b05
        this value to notSupported(1), because limited extensibility
Packit 022b05
        of the protocolDirTable does not extend to interpreting
Packit 022b05
        addresses of the extended protocols.
Packit 022b05
Packit 022b05
        If the value of this object is notSupported(1), the probe
Packit 022b05
        will not perform address mapping for this protocol and
Packit 022b05
        shall not allow this object to be changed to any other value.
Packit 022b05
        If the value of this object is supportedOn(3), the probe
Packit 022b05
        supports address mapping for this protocol and is configured
Packit 022b05
        to perform address mapping for this protocol for all
Packit 022b05
        addressMappingControlEntries and all interfaces.
Packit 022b05
        If the value of this object is supportedOff(2), the probe
Packit 022b05
        supports address mapping for this protocol but is configured
Packit 022b05
        to not perform address mapping for this protocol for any
Packit 022b05
        addressMappingControlEntries and all interfaces.
Packit 022b05
        Whenever this value changes from supportedOn(3) to
Packit 022b05
        supportedOff(2), the probe shall delete all related entries in
Packit 022b05
        the addressMappingTable."
Packit 022b05
    ::= { protocolDirEntry 6 }
Packit 022b05
Packit 022b05
protocolDirHostConfig OBJECT-TYPE
Packit 022b05
    SYNTAX      INTEGER {
Packit 022b05
                    notSupported(1),
Packit 022b05
                    supportedOff(2),
Packit 022b05
                    supportedOn(3)
Packit 022b05
                }
Packit 022b05
    MAX-ACCESS  read-create
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "This object describes and configures the probe's support for
Packit 022b05
        the network-layer and application-layer host tables for this
Packit 022b05
        protocol.  When the probe creates entries in this table for
Packit 022b05
        all protocols that it understands, it will set the entry to
Packit 022b05
        notSupported(1) if it doesn't have the capability to track the
Packit 022b05
        nlHostTable for this protocol or if the alHostTable is
Packit 022b05
        implemented but doesn't have the capability to track this
Packit 022b05
        protocol.  Note that if the alHostTable is implemented, the
Packit 022b05
        probe may only support a protocol if it is supported in both
Packit 022b05
        the nlHostTable and the alHostTable.
Packit 022b05
Packit 022b05
        If the associated protocolDirType object has the
Packit 022b05
        addressRecognitionCapable bit set, then this is a network-
Packit 022b05
        layer protocol for which the probe recognizes addresses, and
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
        thus the probe will populate the nlHostTable and alHostTable
Packit 022b05
        with addresses it discovers for this protocol.
Packit 022b05
Packit 022b05
        If the value of this object is notSupported(1), the probe
Packit 022b05
        will not track the nlHostTable or alHostTable for this
Packit 022b05
        protocol and shall not allow this object to be changed to any
Packit 022b05
        other value.  If the value of this object is supportedOn(3),
Packit 022b05
        the probe supports tracking of the nlHostTable and alHostTable
Packit 022b05
        for this protocol and is configured to track both tables
Packit 022b05
        for this protocol for all control entries and all interfaces.
Packit 022b05
        If the value of this object is supportedOff(2), the probe
Packit 022b05
        supports tracking of the nlHostTable and alHostTable for this
Packit 022b05
        protocol but is configured to not track these tables
Packit 022b05
        for any control entries or interfaces.
Packit 022b05
        Whenever this value changes from supportedOn(3) to
Packit 022b05
        supportedOff(2), the probe shall delete all related entries in
Packit 022b05
        the nlHostTable and alHostTable.
Packit 022b05
Packit 022b05
        Note that since each alHostEntry references 2 protocol
Packit 022b05
        directory entries, one for the network address and one for the
Packit 022b05
        type of the highest protocol recognized, an entry will
Packit 022b05
        only be created in that table if this value is supportedOn(3)
Packit 022b05
        for both protocols."
Packit 022b05
    ::= { protocolDirEntry 7 }
Packit 022b05
Packit 022b05
protocolDirMatrixConfig OBJECT-TYPE
Packit 022b05
    SYNTAX      INTEGER {
Packit 022b05
                    notSupported(1),
Packit 022b05
                    supportedOff(2),
Packit 022b05
                    supportedOn(3)
Packit 022b05
                }
Packit 022b05
    MAX-ACCESS  read-create
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "This object describes and configures the probe's support for
Packit 022b05
        the network-layer and application-layer matrix tables for this
Packit 022b05
        protocol.  When the probe creates entries in this table for
Packit 022b05
        all protocols that it understands, it will set the entry to
Packit 022b05
        notSupported(1) if it doesn't have the capability to track the
Packit 022b05
        nlMatrixTables for this protocol or if the alMatrixTables are
Packit 022b05
        implemented but don't have the capability to track this
Packit 022b05
        protocol.  Note that if the alMatrix tables are implemented,
Packit 022b05
        the probe may only support a protocol if it is supported in
Packit 022b05
        both of the nlMatrixTables and both of the
Packit 022b05
        alMatrixTables.
Packit 022b05
Packit 022b05
        If the associated protocolDirType object has the
Packit 022b05
        addressRecognitionCapable bit set, then this is a network-
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
        layer protocol for which the probe recognizes addresses, and
Packit 022b05
        thus the probe will populate both of the nlMatrixTables and
Packit 022b05
        both of the alMatrixTables with addresses it discovers for
Packit 022b05
        this protocol.
Packit 022b05
Packit 022b05
        If the value of this object is notSupported(1), the probe
Packit 022b05
        will not track either of the nlMatrixTables or the
Packit 022b05
        alMatrixTables for this protocol and shall not allow this
Packit 022b05
        object to be changed to any other value.  If the value of this
Packit 022b05
        object is supportedOn(3), the probe supports tracking of both
Packit 022b05
        of the nlMatrixTables and (if implemented) both of the
Packit 022b05
        alMatrixTables for this protocol and is configured to track
Packit 022b05
        these tables for this protocol for all control entries and all
Packit 022b05
        interfaces.  If the value of this object is supportedOff(2),
Packit 022b05
        the probe supports tracking of both of the nlMatrixTables and
Packit 022b05
        (if implemented) both of the alMatrixTables for this protocol
Packit 022b05
        but is configured to not track these tables for this
Packit 022b05
        protocol for any control entries or interfaces.
Packit 022b05
        Whenever this value changes from supportedOn(3) to
Packit 022b05
        supportedOff(2), the probe shall delete all related entries in
Packit 022b05
        the nlMatrixTables and the alMatrixTables.
Packit 022b05
Packit 022b05
        Note that since each alMatrixEntry references 2 protocol
Packit 022b05
        directory entries, one for the network address and one for the
Packit 022b05
        type of the highest protocol recognized, an entry will
Packit 022b05
        only be created in that table if this value is supportedOn(3)
Packit 022b05
        for both protocols."
Packit 022b05
    ::= { protocolDirEntry 8 }
Packit 022b05
Packit 022b05
protocolDirOwner OBJECT-TYPE
Packit 022b05
    SYNTAX      OwnerString
Packit 022b05
    MAX-ACCESS  read-create
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The entity that configured this entry and is
Packit 022b05
        therefore using the resources assigned to it."
Packit 022b05
    ::= { protocolDirEntry 9 }
Packit 022b05
Packit 022b05
protocolDirStatus OBJECT-TYPE
Packit 022b05
    SYNTAX      RowStatus
Packit 022b05
    MAX-ACCESS  read-create
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The status of this protocol directory entry.
Packit 022b05
Packit 022b05
        An entry may not exist in the active state unless all
Packit 022b05
        objects in the entry have an appropriate value.
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
        If this object is not equal to active(1), all associated
Packit 022b05
        entries in the nlHostTable, nlMatrixSDTable, nlMatrixDSTable,
Packit 022b05
        alHostTable, alMatrixSDTable, and alMatrixDSTable shall be
Packit 022b05
        deleted."
Packit 022b05
    ::= { protocolDirEntry 10 }
Packit 022b05
Packit 022b05
--
Packit 022b05
-- Protocol Distribution Group  (protocolDist)
Packit 022b05
--
Packit 022b05
-- Collects the relative amounts of octets and packets for the
Packit 022b05
-- different protocols detected on a network segment.
Packit 022b05
--    protocolDistControlTable,
Packit 022b05
--    protocolDistStatsTable
Packit 022b05
Packit 022b05
protocolDistControlTable OBJECT-TYPE
Packit 022b05
    SYNTAX      SEQUENCE OF ProtocolDistControlEntry
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "Controls the setup of protocol type distribution statistics
Packit 022b05
        tables.
Packit 022b05
Packit 022b05
        Implementations are encouraged to add an entry per monitored
Packit 022b05
        interface upon initialization so that a default collection
Packit 022b05
        of protocol statistics is available.
Packit 022b05
Packit 022b05
        Rationale:
Packit 022b05
        This table controls collection of very basic statistics
Packit 022b05
        for any or all of the protocols detected on a given interface.
Packit 022b05
        An NMS can use this table to quickly determine bandwidth
Packit 022b05
        allocation utilized by different protocols.
Packit 022b05
Packit 022b05
        A media-specific statistics collection could also
Packit 022b05
        be configured (e.g., etherStats, trPStats) to easily obtain
Packit 022b05
        total frame, octet, and droppedEvents for the same
Packit 022b05
        interface."
Packit 022b05
    ::= { protocolDist 1 }
Packit 022b05
Packit 022b05
protocolDistControlEntry OBJECT-TYPE
Packit 022b05
    SYNTAX      ProtocolDistControlEntry
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A conceptual row in the protocolDistControlTable.
Packit 022b05
Packit 022b05
         An example of the indexing of this entry is
Packit 022b05
         protocolDistControlDroppedFrames.7"
Packit 022b05
    INDEX { protocolDistControlIndex }
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
    ::= { protocolDistControlTable 1 }
Packit 022b05
Packit 022b05
ProtocolDistControlEntry ::= SEQUENCE {
Packit 022b05
    protocolDistControlIndex                Integer32,
Packit 022b05
    protocolDistControlDataSource           DataSource,
Packit 022b05
    protocolDistControlDroppedFrames        Counter32,
Packit 022b05
    protocolDistControlCreateTime           LastCreateTime,
Packit 022b05
    protocolDistControlOwner                OwnerString,
Packit 022b05
    protocolDistControlStatus               RowStatus
Packit 022b05
}
Packit 022b05
Packit 022b05
protocolDistControlIndex OBJECT-TYPE
Packit 022b05
    SYNTAX      Integer32 (1..65535)
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A unique index for this protocolDistControlEntry."
Packit 022b05
    ::= { protocolDistControlEntry 1 }
Packit 022b05
Packit 022b05
protocolDistControlDataSource OBJECT-TYPE
Packit 022b05
    SYNTAX      DataSource
Packit 022b05
    MAX-ACCESS  read-create
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The source of data for the this protocol distribution.
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
        protocolDistControlStatus object is equal to active(1)."
Packit 022b05
    ::= { protocolDistControlEntry 2 }
Packit 022b05
Packit 022b05
protocolDistControlDroppedFrames OBJECT-TYPE
Packit 022b05
    SYNTAX     Counter32
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
       "The total number of frames that were received by the probe
Packit 022b05
        and therefore not accounted for in the *StatsDropEvents, but
Packit 022b05
        that the probe chose not to count for this entry for
Packit 022b05
        whatever reason.  Most often, this event occurs when the probe
Packit 022b05
        is out of some resources and decides to shed load from this
Packit 022b05
        collection.
Packit 022b05
Packit 022b05
        This count does not include packets that were not counted
Packit 022b05
        because they had MAC-layer errors.
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
        Note that, unlike the dropEvents counter, this number is the
Packit 022b05
        exact number of frames dropped."
Packit 022b05
    ::= { protocolDistControlEntry 3 }
Packit 022b05
Packit 022b05
protocolDistControlCreateTime OBJECT-TYPE
Packit 022b05
    SYNTAX     LastCreateTime
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The value of sysUpTime when this control entry was last
Packit 022b05
        activated.  This can be used by the management station to
Packit 022b05
        ensure that the table has not been deleted and recreated
Packit 022b05
        between polls."
Packit 022b05
    ::= { protocolDistControlEntry 4 }
Packit 022b05
Packit 022b05
protocolDistControlOwner OBJECT-TYPE
Packit 022b05
    SYNTAX      OwnerString
Packit 022b05
    MAX-ACCESS  read-create
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The entity that configured this entry and is
Packit 022b05
        therefore using the resources assigned to it."
Packit 022b05
    ::= { protocolDistControlEntry 5 }
Packit 022b05
Packit 022b05
protocolDistControlStatus OBJECT-TYPE
Packit 022b05
    SYNTAX      RowStatus
Packit 022b05
    MAX-ACCESS  read-create
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The status of this row.
Packit 022b05
Packit 022b05
        An entry may not exist in the active state unless all
Packit 022b05
        objects in the entry have an appropriate value.
Packit 022b05
Packit 022b05
        If this object is not equal to active(1), all associated
Packit 022b05
        entries in the protocolDistStatsTable shall be deleted."
Packit 022b05
    ::= { protocolDistControlEntry 6 }
Packit 022b05
Packit 022b05
-- per interface protocol distribution statistics table
Packit 022b05
protocolDistStatsTable OBJECT-TYPE
Packit 022b05
    SYNTAX      SEQUENCE OF ProtocolDistStatsEntry
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "An entry is made in this table for every protocol in the
Packit 022b05
        protocolDirTable that has been seen in at least one packet.
Packit 022b05
        Counters are updated in this table for every protocol type
Packit 022b05
        that is encountered when parsing a packet, but no counters are
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
        updated for packets with MAC-layer errors.
Packit 022b05
Packit 022b05
        Note that if a protocolDirEntry is deleted, all associated
Packit 022b05
        entries in this table are removed."
Packit 022b05
    ::= { protocolDist 2 }
Packit 022b05
Packit 022b05
protocolDistStatsEntry OBJECT-TYPE
Packit 022b05
    SYNTAX      ProtocolDistStatsEntry
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A conceptual row in the protocolDistStatsTable.
Packit 022b05
Packit 022b05
        The index is composed of the protocolDistControlIndex of the
Packit 022b05
        associated protocolDistControlEntry, followed by the
Packit 022b05
        protocolDirLocalIndex of the associated protocol that this
Packit 022b05
        entry represents.  In other words, the index identifies the
Packit 022b05
        protocol distribution an entry is a part of and the
Packit 022b05
        particular protocol that it represents.
Packit 022b05
Packit 022b05
        An example of the indexing of this entry is
Packit 022b05
        protocolDistStatsPkts.1.18"
Packit 022b05
    INDEX { protocolDistControlIndex, protocolDirLocalIndex }
Packit 022b05
    ::= { protocolDistStatsTable 1 }
Packit 022b05
Packit 022b05
ProtocolDistStatsEntry ::= SEQUENCE {
Packit 022b05
    protocolDistStatsPkts                    ZeroBasedCounter32,
Packit 022b05
    protocolDistStatsOctets                  ZeroBasedCounter32
Packit 022b05
}
Packit 022b05
Packit 022b05
protocolDistStatsPkts OBJECT-TYPE
Packit 022b05
    SYNTAX      ZeroBasedCounter32
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The number of packets of this protocol type received
Packit 022b05
        without errors.  Note that this is the number of
Packit 022b05
        link-layer packets, so if a single network-layer packet
Packit 022b05
        is fragmented into several link-layer frames, this counter
Packit 022b05
        is incremented several times."
Packit 022b05
    ::= { protocolDistStatsEntry 1 }
Packit 022b05
Packit 022b05
protocolDistStatsOctets OBJECT-TYPE
Packit 022b05
    SYNTAX      ZeroBasedCounter32
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The number of octets in packets of this protocol type
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
        received since it was added to the protocolDistStatsTable
Packit 022b05
        (excluding framing bits, but including FCS octets), except for
Packit 022b05
        those octets in packets that contained errors.
Packit 022b05
Packit 022b05
        Note that this doesn't count just those octets in the
Packit 022b05
        particular protocol frames but includes the entire packet
Packit 022b05
        that contained the protocol."
Packit 022b05
    ::= { protocolDistStatsEntry 2 }
Packit 022b05
Packit 022b05
--
Packit 022b05
-- Address Map Group   (addressMap)
Packit 022b05
--
Packit 022b05
-- Lists MAC address to network address bindings discovered by the
Packit 022b05
-- probe and what interface they were last seen on.
Packit 022b05
--    addressMapControlTable
Packit 022b05
--    addressMapTable
Packit 022b05
Packit 022b05
addressMapInserts OBJECT-TYPE
Packit 022b05
    SYNTAX     Counter32
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The number of times an address mapping entry has been
Packit 022b05
        inserted into the addressMapTable.  If an entry is inserted,
Packit 022b05
        then deleted, and then inserted, this counter will be
Packit 022b05
        incremented by 2.
Packit 022b05
Packit 022b05
        Note that the table size can be determined by subtracting
Packit 022b05
        addressMapDeletes from addressMapInserts."
Packit 022b05
    ::= { addressMap 1 }
Packit 022b05
Packit 022b05
addressMapDeletes OBJECT-TYPE
Packit 022b05
    SYNTAX     Counter32
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The number of times an address mapping entry has been
Packit 022b05
        deleted from the addressMapTable (for any reason).  If
Packit 022b05
        an entry is deleted, then inserted, and then deleted, this
Packit 022b05
        counter will be incremented by 2.
Packit 022b05
Packit 022b05
        Note that the table size can be determined by subtracting
Packit 022b05
        addressMapDeletes from addressMapInserts."
Packit 022b05
    ::= { addressMap 2 }
Packit 022b05
Packit 022b05
addressMapMaxDesiredEntries OBJECT-TYPE
Packit 022b05
    SYNTAX      Integer32 (-1..2147483647)
Packit 022b05
    MAX-ACCESS  read-write
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The maximum number of entries that are desired in the
Packit 022b05
        addressMapTable.  The probe will not create more than
Packit 022b05
        this number of entries in the table but may choose to create
Packit 022b05
        fewer entries in this table for any reason, including the lack
Packit 022b05
        of resources.
Packit 022b05
Packit 022b05
        If this object is set to a value less than the current number
Packit 022b05
        of entries, enough entries are chosen in an
Packit 022b05
        implementation-dependent manner and deleted so that the number
Packit 022b05
        of entries in the table equals the value of this object.
Packit 022b05
Packit 022b05
        If this value is set to -1, the probe may create any number
Packit 022b05
        of entries in this table.
Packit 022b05
Packit 022b05
        This object may be used to control how resources are allocated
Packit 022b05
        on the probe for the various RMON functions."
Packit 022b05
    ::= { addressMap 3 }
Packit 022b05
Packit 022b05
addressMapControlTable OBJECT-TYPE
Packit 022b05
    SYNTAX      SEQUENCE OF AddressMapControlEntry
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A table to control the collection of mappings from network
Packit 022b05
         layer address to physical address to interface.
Packit 022b05
Packit 022b05
        Note that this is not like the typical RMON
Packit 022b05
        controlTable and dataTable in which each entry creates
Packit 022b05
        its own data table.  Each entry in this table enables the
Packit 022b05
        discovery of addresses on a new interface and the placement
Packit 022b05
        of address mappings into the central addressMapTable.
Packit 022b05
Packit 022b05
        Implementations are encouraged to add an entry per monitored
Packit 022b05
        interface upon initialization so that a default collection
Packit 022b05
        of address mappings is available."
Packit 022b05
    ::= { addressMap 4 }
Packit 022b05
Packit 022b05
addressMapControlEntry OBJECT-TYPE
Packit 022b05
    SYNTAX      AddressMapControlEntry
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A conceptual row in the addressMapControlTable.
Packit 022b05
Packit 022b05
        An example of the indexing of this entry is
Packit 022b05
        addressMapControlDroppedFrames.1"
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
    INDEX { addressMapControlIndex }
Packit 022b05
    ::= { addressMapControlTable 1 }
Packit 022b05
Packit 022b05
AddressMapControlEntry ::= SEQUENCE {
Packit 022b05
    addressMapControlIndex              Integer32,
Packit 022b05
    addressMapControlDataSource         DataSource,
Packit 022b05
    addressMapControlDroppedFrames      Counter32,
Packit 022b05
    addressMapControlOwner              OwnerString,
Packit 022b05
    addressMapControlStatus             RowStatus
Packit 022b05
}
Packit 022b05
Packit 022b05
addressMapControlIndex OBJECT-TYPE
Packit 022b05
    SYNTAX      Integer32 (1..65535)
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A unique index for this entry in the addressMapControlTable."
Packit 022b05
    ::= { addressMapControlEntry 1 }
Packit 022b05
Packit 022b05
addressMapControlDataSource OBJECT-TYPE
Packit 022b05
    SYNTAX      DataSource
Packit 022b05
    MAX-ACCESS  read-create
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The source of data for this addressMapControlEntry."
Packit 022b05
    ::= { addressMapControlEntry 2 }
Packit 022b05
Packit 022b05
addressMapControlDroppedFrames OBJECT-TYPE
Packit 022b05
    SYNTAX     Counter32
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
       "The total number of frames that were received by the probe
Packit 022b05
        and therefore not accounted for in the *StatsDropEvents, but
Packit 022b05
        that the probe chose not to count for this entry for
Packit 022b05
        whatever reason.  Most often, this event occurs when the probe
Packit 022b05
        is out of some resources and decides to shed load from this
Packit 022b05
        collection.
Packit 022b05
Packit 022b05
        This count does not include packets that were not counted
Packit 022b05
        because they had MAC-layer errors.
Packit 022b05
Packit 022b05
        Note that, unlike the dropEvents counter, this number is the
Packit 022b05
        exact number of frames dropped."
Packit 022b05
    ::= { addressMapControlEntry 3 }
Packit 022b05
Packit 022b05
addressMapControlOwner OBJECT-TYPE
Packit 022b05
    SYNTAX      OwnerString
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
    MAX-ACCESS  read-create
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The entity that configured this entry and is
Packit 022b05
        therefore using the resources assigned to it."
Packit 022b05
    ::= { addressMapControlEntry 4 }
Packit 022b05
Packit 022b05
addressMapControlStatus OBJECT-TYPE
Packit 022b05
    SYNTAX      RowStatus
Packit 022b05
    MAX-ACCESS  read-create
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The status of this addressMap control entry.
Packit 022b05
Packit 022b05
        An entry may not exist in the active state unless all
Packit 022b05
        objects in the entry have an appropriate value.
Packit 022b05
Packit 022b05
        If this object is not equal to active(1), all associated
Packit 022b05
        entries in the addressMapTable shall be deleted."
Packit 022b05
    ::= { addressMapControlEntry 5 }
Packit 022b05
Packit 022b05
addressMapTable OBJECT-TYPE
Packit 022b05
    SYNTAX      SEQUENCE OF AddressMapEntry
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A table of mappings from network layer address to physical
Packit 022b05
        address to interface.
Packit 022b05
Packit 022b05
        The probe will add entries to this table based on the source
Packit 022b05
        MAC and network addresses seen in packets without MAC-level
Packit 022b05
        errors.  The probe will populate this table for all protocols
Packit 022b05
        in the protocol directory table whose value of
Packit 022b05
        protocolDirAddressMapConfig is equal to supportedOn(3), and
Packit 022b05
        will delete any entries whose protocolDirEntry is deleted or
Packit 022b05
        has a protocolDirAddressMapConfig value of supportedOff(2)."
Packit 022b05
    ::= { addressMap 5 }
Packit 022b05
Packit 022b05
addressMapEntry OBJECT-TYPE
Packit 022b05
    SYNTAX      AddressMapEntry
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A conceptual row in the addressMapTable.
Packit 022b05
Packit 022b05
        The protocolDirLocalIndex in the index identifies the network
Packit 022b05
        layer protocol of the addressMapNetworkAddress.
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
        An example of the indexing of this entry is
Packit 022b05
        addressMapSource.783495.18.4.128.2.6.6.11.1.3.6.1.2.1.2.2.1.1.1.
Packit 022b05
Packit 022b05
        Note that some combinations of index values may result in an
Packit 022b05
        index that exceeds 128 sub-identifiers in length, which exceeds
Packit 022b05
        the maximum for the SNMP protocol.  Implementations should take
Packit 022b05
        care to avoid such combinations."
Packit 022b05
    INDEX { addressMapTimeMark, protocolDirLocalIndex,
Packit 022b05
            addressMapNetworkAddress, addressMapSource }
Packit 022b05
    ::= { addressMapTable 1 }
Packit 022b05
Packit 022b05
AddressMapEntry ::= SEQUENCE {
Packit 022b05
    addressMapTimeMark                 TimeFilter,
Packit 022b05
    addressMapNetworkAddress           OCTET STRING,
Packit 022b05
    addressMapSource                   OBJECT IDENTIFIER,
Packit 022b05
    addressMapPhysicalAddress          OCTET STRING,
Packit 022b05
    addressMapLastChange               TimeStamp
Packit 022b05
}
Packit 022b05
Packit 022b05
addressMapTimeMark OBJECT-TYPE
Packit 022b05
    SYNTAX      TimeFilter
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A TimeFilter for this entry.  See the TimeFilter textual
Packit 022b05
        convention to see how this works."
Packit 022b05
    ::= { addressMapEntry 1 }
Packit 022b05
Packit 022b05
addressMapNetworkAddress OBJECT-TYPE
Packit 022b05
    SYNTAX      OCTET STRING (SIZE (1..255))
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The network address for this relation.
Packit 022b05
Packit 022b05
        This is represented as an octet string with
Packit 022b05
        specific semantics and length as identified
Packit 022b05
        by the protocolDirLocalIndex component of the
Packit 022b05
        index.
Packit 022b05
Packit 022b05
        For example, if the protocolDirLocalIndex indicates an
Packit 022b05
        encapsulation of ip, this object is encoded as a length
Packit 022b05
        octet of 4, followed by the 4 octets of the IP address,
Packit 022b05
        in network byte order."
Packit 022b05
    ::= { addressMapEntry 2 }
Packit 022b05
Packit 022b05
addressMapSource OBJECT-TYPE
Packit 022b05
    SYNTAX      OBJECT IDENTIFIER
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The interface or port on which the associated network
Packit 022b05
         address was most recently seen.
Packit 022b05
Packit 022b05
        If this address mapping was discovered on an interface, this
Packit 022b05
        object shall identify the instance of the ifIndex
Packit 022b05
        object, defined in [RFC2863], 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
        If this address mapping was discovered on a port, this
Packit 022b05
        object shall identify the instance of the rptrGroupPortIndex
Packit 022b05
        object, defined in [RFC2108], for the desired port.
Packit 022b05
        For example, if an entry were to receive data from
Packit 022b05
        group #1, port #1, this object would be set to
Packit 022b05
        rptrGroupPortIndex.1.1.
Packit 022b05
Packit 022b05
        Note that while the dataSource associated with this entry
Packit 022b05
        may only point to index objects, this object may at times
Packit 022b05
        point to repeater port objects.  This situation occurs when
Packit 022b05
        the dataSource points to an interface that is a locally
Packit 022b05
        attached repeater and the agent has additional information
Packit 022b05
        about the source port of traffic seen on that repeater."
Packit 022b05
    ::= { addressMapEntry 3 }
Packit 022b05
Packit 022b05
addressMapPhysicalAddress OBJECT-TYPE
Packit 022b05
    SYNTAX      OCTET STRING
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The last source physical address on which the associated
Packit 022b05
        network address was seen.  If the protocol of the associated
Packit 022b05
        network address was encapsulated inside of a network-level or
Packit 022b05
        higher protocol, this will be the address of the next-lower
Packit 022b05
        protocol with the addressRecognitionCapable bit enabled and
Packit 022b05
        will be formatted as specified for that protocol."
Packit 022b05
    ::= { addressMapEntry 4 }
Packit 022b05
Packit 022b05
addressMapLastChange OBJECT-TYPE
Packit 022b05
    SYNTAX      TimeStamp
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The value of sysUpTime at the time this entry was last
Packit 022b05
        created or the values of the physical address changed.
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
        This can be used to help detect duplicate address problems, in
Packit 022b05
        which case this object will be updated frequently."
Packit 022b05
    ::= { addressMapEntry 5 }
Packit 022b05
Packit 022b05
--
Packit 022b05
-- Network Layer Host Group
Packit 022b05
--
Packit 022b05
-- Counts the amount of traffic sent from and to each network address
Packit 022b05
-- discovered by the probe.
Packit 022b05
-- Note that while the hlHostControlTable also has objects that
Packit 022b05
-- control an optional alHostTable, implementation of the alHostTable is
Packit 022b05
-- not required to fully implement this group.
Packit 022b05
Packit 022b05
hlHostControlTable OBJECT-TYPE
Packit 022b05
    SYNTAX      SEQUENCE OF HlHostControlEntry
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A list of higher-layer (i.e., non-MAC) host table control
Packit 022b05
        entries.
Packit 022b05
Packit 022b05
        These entries will enable the collection of the network- and
Packit 022b05
        application-level host tables indexed by network addresses.
Packit 022b05
        Both the network- and application-level host tables are
Packit 022b05
        controlled by this table so that they will both be created
Packit 022b05
        and deleted at the same time, further increasing the ease with
Packit 022b05
        which they can be implemented as a single datastore.  (Note that
Packit 022b05
        if an implementation stores application-layer host records in
Packit 022b05
        memory, it can derive network-layer host records from them.)
Packit 022b05
Packit 022b05
        Entries in the nlHostTable will be created on behalf of each
Packit 022b05
        entry in this table.  Additionally, if this probe implements
Packit 022b05
        the alHostTable, entries in the alHostTable will be created on
Packit 022b05
        behalf of each entry in this table.
Packit 022b05
Packit 022b05
        Implementations are encouraged to add an entry per monitored
Packit 022b05
        interface upon initialization so that a default collection
Packit 022b05
        of host statistics is available."
Packit 022b05
    ::= { nlHost 1 }
Packit 022b05
Packit 022b05
hlHostControlEntry OBJECT-TYPE
Packit 022b05
    SYNTAX      HlHostControlEntry
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A conceptual row in the hlHostControlTable.
Packit 022b05
Packit 022b05
        An example of the indexing of this entry is
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
        hlHostControlNlDroppedFrames.1"
Packit 022b05
    INDEX { hlHostControlIndex }
Packit 022b05
    ::= { hlHostControlTable 1 }
Packit 022b05
Packit 022b05
HlHostControlEntry ::= SEQUENCE {
Packit 022b05
    hlHostControlIndex               Integer32,
Packit 022b05
    hlHostControlDataSource          DataSource,
Packit 022b05
    hlHostControlNlDroppedFrames     Counter32,
Packit 022b05
    hlHostControlNlInserts           Counter32,
Packit 022b05
    hlHostControlNlDeletes           Counter32,
Packit 022b05
    hlHostControlNlMaxDesiredEntries Integer32,
Packit 022b05
    hlHostControlAlDroppedFrames     Counter32,
Packit 022b05
    hlHostControlAlInserts           Counter32,
Packit 022b05
    hlHostControlAlDeletes           Counter32,
Packit 022b05
    hlHostControlAlMaxDesiredEntries Integer32,
Packit 022b05
    hlHostControlOwner               OwnerString,
Packit 022b05
    hlHostControlStatus              RowStatus
Packit 022b05
}
Packit 022b05
Packit 022b05
hlHostControlIndex OBJECT-TYPE
Packit 022b05
    SYNTAX      Integer32 (1..65535)
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "An index that uniquely identifies an entry in the
Packit 022b05
        hlHostControlTable.  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
        nlHostTable, and optionally in the alHostTable, on
Packit 022b05
        behalf of this hlHostControlEntry."
Packit 022b05
    ::= { hlHostControlEntry 1 }
Packit 022b05
Packit 022b05
hlHostControlDataSource OBJECT-TYPE
Packit 022b05
    SYNTAX      DataSource
Packit 022b05
    MAX-ACCESS  read-create
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The source of data for the associated host tables.
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
        hlHostControlStatus object is equal to active(1)."
Packit 022b05
    ::= { hlHostControlEntry 2 }
Packit 022b05
Packit 022b05
hlHostControlNlDroppedFrames OBJECT-TYPE
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
    SYNTAX     Counter32
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
       "The total number of frames that were received by the probe
Packit 022b05
        and therefore not accounted for in the *StatsDropEvents, but
Packit 022b05
        that the probe chose not to count for the associated
Packit 022b05
        nlHost entries for whatever reason.  Most often, this event
Packit 022b05
        occurs when the probe is out of some resources and decides to
Packit 022b05
        shed load from this collection.
Packit 022b05
Packit 022b05
        This count does not include packets that were not counted
Packit 022b05
        because they had MAC-layer errors.
Packit 022b05
Packit 022b05
        Note that if the nlHostTable is inactive because no protocols
Packit 022b05
        are enabled in the protocol directory, this value should be 0.
Packit 022b05
Packit 022b05
        Note that, unlike the dropEvents counter, this number is the
Packit 022b05
        exact number of frames dropped."
Packit 022b05
    ::= { hlHostControlEntry 3 }
Packit 022b05
Packit 022b05
hlHostControlNlInserts OBJECT-TYPE
Packit 022b05
    SYNTAX     Counter32
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The number of times an nlHost entry has been
Packit 022b05
        inserted into the nlHost table.  If an entry is inserted, then
Packit 022b05
        deleted, and then inserted, this counter will be incremented
Packit 022b05
        by 2.
Packit 022b05
Packit 022b05
        To allow for efficient implementation strategies, agents may
Packit 022b05
        delay updating this object for short periods of time.  For
Packit 022b05
        example, an implementation strategy may allow internal
Packit 022b05
        data structures to differ from those visible via SNMP for
Packit 022b05
        short periods of time.  This counter may reflect the internal
Packit 022b05
        data structures for those short periods of time.
Packit 022b05
Packit 022b05
        Note that the table size can be determined by subtracting
Packit 022b05
        hlHostControlNlDeletes from hlHostControlNlInserts."
Packit 022b05
    ::= { hlHostControlEntry 4 }
Packit 022b05
Packit 022b05
hlHostControlNlDeletes OBJECT-TYPE
Packit 022b05
    SYNTAX     Counter32
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The number of times an nlHost entry has been
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
        deleted from the nlHost table (for any reason).  If an entry
Packit 022b05
        is deleted, then inserted, and then deleted, this counter will
Packit 022b05
        be incremented by 2.
Packit 022b05
Packit 022b05
        To allow for efficient implementation strategies, agents may
Packit 022b05
        delay updating this object for short periods of time.  For
Packit 022b05
        example, an implementation strategy may allow internal
Packit 022b05
        data structures to differ from those visible via SNMP for
Packit 022b05
        short periods of time.  This counter may reflect the internal
Packit 022b05
        data structures for those short periods of time.
Packit 022b05
Packit 022b05
        Note that the table size can be determined by subtracting
Packit 022b05
        hlHostControlNlDeletes from hlHostControlNlInserts."
Packit 022b05
    ::= { hlHostControlEntry 5 }
Packit 022b05
Packit 022b05
hlHostControlNlMaxDesiredEntries OBJECT-TYPE
Packit 022b05
    SYNTAX      Integer32 (-1..2147483647)
Packit 022b05
    MAX-ACCESS  read-create
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The maximum number of entries that are desired in the
Packit 022b05
        nlHostTable on behalf of this control entry.  The probe will
Packit 022b05
        not create more than this number of associated entries in the
Packit 022b05
        table but may choose to create fewer entries in this table
Packit 022b05
        for any reason, including the lack of resources.
Packit 022b05
Packit 022b05
        If this object is set to a value less than the current number
Packit 022b05
        of entries, enough entries are chosen in an
Packit 022b05
        implementation-dependent manner and deleted so that the number
Packit 022b05
        of entries in the table equals the value of this object.
Packit 022b05
Packit 022b05
        If this value is set to -1, the probe may create any number
Packit 022b05
        of entries in this table.  If the associated
Packit 022b05
        hlHostControlStatus object is equal to 'active', this
Packit 022b05
        object may not be modified.
Packit 022b05
Packit 022b05
        This object may be used to control how resources are allocated
Packit 022b05
        on the probe for the various RMON functions."
Packit 022b05
    ::= { hlHostControlEntry 6 }
Packit 022b05
Packit 022b05
hlHostControlAlDroppedFrames OBJECT-TYPE
Packit 022b05
    SYNTAX     Counter32
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
       "The total number of frames that were received by the probe
Packit 022b05
        and therefore not accounted for in the *StatsDropEvents, but
Packit 022b05
        that the probe chose not to count for the associated
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
        alHost entries for whatever reason.  Most often, this event
Packit 022b05
        occurs when the probe is out of some resources and decides to
Packit 022b05
        shed load from this collection.
Packit 022b05
Packit 022b05
        This count does not include packets that were not counted
Packit 022b05
        because they had MAC-layer errors.
Packit 022b05
Packit 022b05
        Note that if the alHostTable is not implemented or is inactive
Packit 022b05
        because no protocols are enabled in the protocol directory,
Packit 022b05
        this value should be 0.
Packit 022b05
Packit 022b05
        Note that, unlike the dropEvents counter, this number is the
Packit 022b05
        exact number of frames dropped."
Packit 022b05
    ::= { hlHostControlEntry 7 }
Packit 022b05
Packit 022b05
hlHostControlAlInserts OBJECT-TYPE
Packit 022b05
    SYNTAX     Counter32
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The number of times an alHost entry has been
Packit 022b05
        inserted into the alHost table.  If an entry is inserted, then
Packit 022b05
        deleted, and then inserted, this counter will be incremented
Packit 022b05
        by 2.
Packit 022b05
Packit 022b05
        To allow for efficient implementation strategies, agents may
Packit 022b05
        delay updating this object for short periods of time.  For
Packit 022b05
        example, an implementation strategy may allow internal
Packit 022b05
        data structures to differ from those visible via SNMP for
Packit 022b05
        short periods of time.  This counter may reflect the internal
Packit 022b05
        data structures for those short periods of time.
Packit 022b05
Packit 022b05
        Note that the table size can be determined by subtracting
Packit 022b05
        hlHostControlAlDeletes from hlHostControlAlInserts."
Packit 022b05
    ::= { hlHostControlEntry 8 }
Packit 022b05
Packit 022b05
hlHostControlAlDeletes OBJECT-TYPE
Packit 022b05
    SYNTAX     Counter32
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The number of times an alHost entry has been
Packit 022b05
        deleted from the alHost table (for any reason).  If an entry
Packit 022b05
        is deleted, then inserted, and then deleted, this counter will
Packit 022b05
        be incremented by 2.
Packit 022b05
Packit 022b05
        To allow for efficient implementation strategies, agents may
Packit 022b05
        delay updating this object for short periods of time.  For
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
        example, an implementation strategy may allow internal
Packit 022b05
        data structures to differ from those visible via SNMP for
Packit 022b05
        short periods of time.  This counter may reflect the internal
Packit 022b05
        data structures for those short periods of time.
Packit 022b05
Packit 022b05
        Note that the table size can be determined by subtracting
Packit 022b05
        hlHostControlAlDeletes from hlHostControlAlInserts."
Packit 022b05
    ::= { hlHostControlEntry 9 }
Packit 022b05
Packit 022b05
hlHostControlAlMaxDesiredEntries OBJECT-TYPE
Packit 022b05
    SYNTAX      Integer32 (-1..2147483647)
Packit 022b05
    MAX-ACCESS  read-create
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The maximum number of entries that are desired in the alHost
Packit 022b05
        table on behalf of this control entry.  The probe will not
Packit 022b05
        create more than this number of associated entries in the
Packit 022b05
        table but may choose to create fewer entries in this table
Packit 022b05
        for any reason, including the lack of resources.
Packit 022b05
Packit 022b05
        If this object is set to a value less than the current number
Packit 022b05
        of entries, enough entries are chosen in an
Packit 022b05
        implementation-dependent manner and deleted so that the number
Packit 022b05
        of entries in the table equals the value of this object.
Packit 022b05
Packit 022b05
        If this value is set to -1, the probe may create any number
Packit 022b05
        of entries in this table.  If the associated
Packit 022b05
        hlHostControlStatus object is equal to 'active', this
Packit 022b05
        object may not be modified.
Packit 022b05
Packit 022b05
        This object may be used to control how resources are allocated
Packit 022b05
        on the probe for the various RMON functions."
Packit 022b05
    ::= { hlHostControlEntry 10 }
Packit 022b05
Packit 022b05
hlHostControlOwner OBJECT-TYPE
Packit 022b05
    SYNTAX      OwnerString
Packit 022b05
    MAX-ACCESS  read-create
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The entity that configured this entry and is
Packit 022b05
        therefore using the resources assigned to it."
Packit 022b05
    ::= { hlHostControlEntry 11 }
Packit 022b05
Packit 022b05
hlHostControlStatus OBJECT-TYPE
Packit 022b05
    SYNTAX      RowStatus
Packit 022b05
    MAX-ACCESS  read-create
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
        "The status of this hlHostControlEntry.
Packit 022b05
Packit 022b05
        An entry may not exist in the active state unless all
Packit 022b05
        objects in the entry have an appropriate value.
Packit 022b05
Packit 022b05
        If this object is not equal to active(1), all associated
Packit 022b05
        entries in the nlHostTable and alHostTable shall be deleted."
Packit 022b05
    ::= { hlHostControlEntry 12 }
Packit 022b05
Packit 022b05
nlHostTable OBJECT-TYPE
Packit 022b05
    SYNTAX      SEQUENCE OF NlHostEntry
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A collection of statistics for a particular network layer
Packit 022b05
        address that has been discovered on an interface of this
Packit 022b05
        device.
Packit 022b05
Packit 022b05
        The probe will populate this table for all network layer
Packit 022b05
        protocols in the protocol directory table whose value of
Packit 022b05
        protocolDirHostConfig is equal to supportedOn(3), and
Packit 022b05
        will delete any entries whose protocolDirEntry is deleted or
Packit 022b05
        has a protocolDirHostConfig value of supportedOff(2).
Packit 022b05
Packit 022b05
        The probe will add to this table all addresses seen
Packit 022b05
        as the source or destination address in all packets with no
Packit 022b05
        MAC errors, and will increment octet and packet counts in the
Packit 022b05
        table for all packets with no MAC errors."
Packit 022b05
::= { nlHost 2 }
Packit 022b05
Packit 022b05
nlHostEntry OBJECT-TYPE
Packit 022b05
    SYNTAX      NlHostEntry
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A conceptual row in the nlHostTable.
Packit 022b05
Packit 022b05
        The hlHostControlIndex value in the index identifies the
Packit 022b05
        hlHostControlEntry on whose behalf this entry was created.
Packit 022b05
        The protocolDirLocalIndex value in the index identifies the
Packit 022b05
        network layer protocol of the nlHostAddress.
Packit 022b05
Packit 022b05
        An example of the indexing of this entry is
Packit 022b05
        nlHostOutPkts.1.783495.18.4.128.2.6.6.
Packit 022b05
Packit 022b05
        Note that some combinations of index values may result in an
Packit 022b05
        index that exceeds 128 sub-identifiers in length, which exceeds
Packit 022b05
        the maximum for the SNMP protocol.  Implementations should take
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
        care to avoid such combinations."
Packit 022b05
    INDEX { hlHostControlIndex, nlHostTimeMark,
Packit 022b05
            protocolDirLocalIndex, nlHostAddress }
Packit 022b05
    ::= { nlHostTable 1 }
Packit 022b05
Packit 022b05
NlHostEntry ::= SEQUENCE {
Packit 022b05
    nlHostTimeMark              TimeFilter,
Packit 022b05
    nlHostAddress               OCTET STRING,
Packit 022b05
    nlHostInPkts                ZeroBasedCounter32,
Packit 022b05
    nlHostOutPkts               ZeroBasedCounter32,
Packit 022b05
    nlHostInOctets              ZeroBasedCounter32,
Packit 022b05
    nlHostOutOctets             ZeroBasedCounter32,
Packit 022b05
    nlHostOutMacNonUnicastPkts  ZeroBasedCounter32,
Packit 022b05
    nlHostCreateTime            LastCreateTime
Packit 022b05
}
Packit 022b05
Packit 022b05
nlHostTimeMark OBJECT-TYPE
Packit 022b05
    SYNTAX      TimeFilter
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A TimeFilter for this entry.  See the TimeFilter textual
Packit 022b05
        convention to see how this works."
Packit 022b05
    ::= { nlHostEntry 1 }
Packit 022b05
Packit 022b05
nlHostAddress OBJECT-TYPE
Packit 022b05
    SYNTAX      OCTET STRING  (SIZE (1..255))
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The network address for this nlHostEntry.
Packit 022b05
Packit 022b05
        This is represented as an octet string with
Packit 022b05
        specific semantics and length as identified
Packit 022b05
        by the protocolDirLocalIndex component of the index.
Packit 022b05
Packit 022b05
        For example, if the protocolDirLocalIndex indicates an
Packit 022b05
        encapsulation of IP, this object is encoded as a length
Packit 022b05
        octet of 4, followed by the 4 octets of the IP address,
Packit 022b05
        in network byte order."
Packit 022b05
    ::= { nlHostEntry 2 }
Packit 022b05
Packit 022b05
nlHostInPkts OBJECT-TYPE
Packit 022b05
    SYNTAX      ZeroBasedCounter32
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The number of packets without errors transmitted to
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
        this address since it was added to the nlHostTable.  Note that
Packit 022b05
        this is the number of link-layer packets, so if a single
Packit 022b05
        network-layer packet is fragmented into several link-layer
Packit 022b05
        frames, this counter is incremented several times."
Packit 022b05
    ::= { nlHostEntry 3 }
Packit 022b05
Packit 022b05
nlHostOutPkts OBJECT-TYPE
Packit 022b05
    SYNTAX      ZeroBasedCounter32
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The number of packets without errors transmitted by
Packit 022b05
        this address since it was added to the nlHostTable.  Note that
Packit 022b05
        this is the number of link-layer packets, so if a single
Packit 022b05
        network-layer packet is fragmented into several link-layer
Packit 022b05
        frames, this counter is incremented several times."
Packit 022b05
    ::= { nlHostEntry 4 }
Packit 022b05
Packit 022b05
nlHostInOctets OBJECT-TYPE
Packit 022b05
    SYNTAX      ZeroBasedCounter32
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The number of octets transmitted to this address
Packit 022b05
        since it was added to the nlHostTable (excluding
Packit 022b05
        framing bits, but including FCS octets), excluding
Packit 022b05
        octets in packets that contained errors.
Packit 022b05
Packit 022b05
        Note that this doesn't count just those octets in the particular
Packit 022b05
        protocol frames but includes the entire packet that contained
Packit 022b05
        the protocol."
Packit 022b05
    ::= { nlHostEntry 5 }
Packit 022b05
Packit 022b05
nlHostOutOctets OBJECT-TYPE
Packit 022b05
    SYNTAX      ZeroBasedCounter32
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The number of octets transmitted by this address
Packit 022b05
        since it was added to the nlHostTable (excluding
Packit 022b05
        framing bits, but including FCS octets), excluding
Packit 022b05
        octets in packets that contained errors.
Packit 022b05
Packit 022b05
        Note that this doesn't count just those octets in the particular
Packit 022b05
        protocol frames but includes the entire packet that contained
Packit 022b05
        the protocol."
Packit 022b05
    ::= { nlHostEntry 6 }
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
nlHostOutMacNonUnicastPkts OBJECT-TYPE
Packit 022b05
    SYNTAX      ZeroBasedCounter32
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The number of packets without errors transmitted by this
Packit 022b05
        address that were directed to any MAC broadcast addresses
Packit 022b05
        or to any MAC multicast addresses since this host was
Packit 022b05
        added to the nlHostTable.  Note that this is the number of
Packit 022b05
        link-layer packets, so if a single network-layer packet is
Packit 022b05
        fragmented into several link-layer frames, this counter is
Packit 022b05
        incremented several times."
Packit 022b05
    ::= { nlHostEntry 7 }
Packit 022b05
Packit 022b05
nlHostCreateTime OBJECT-TYPE
Packit 022b05
    SYNTAX     LastCreateTime
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The value of sysUpTime when this entry was last activated.
Packit 022b05
        This can be used by the management station to ensure that the
Packit 022b05
        entry has not been deleted and recreated between polls."
Packit 022b05
    ::= { nlHostEntry 8 }
Packit 022b05
Packit 022b05
--
Packit 022b05
-- Network Layer Matrix Group
Packit 022b05
--
Packit 022b05
-- Counts the amount of traffic sent between each pair of network
Packit 022b05
-- addresses discovered by the probe.
Packit 022b05
-- Note that while the hlMatrixControlTable also has objects that
Packit 022b05
-- control optional alMatrixTables, implementation of the
Packit 022b05
-- alMatrixTables is not required to fully implement this group.
Packit 022b05
Packit 022b05
hlMatrixControlTable OBJECT-TYPE
Packit 022b05
    SYNTAX      SEQUENCE OF HlMatrixControlEntry
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A list of higher-layer (i.e., non-MAC) matrix control entries.
Packit 022b05
Packit 022b05
        These entries will enable the collection of the network- and
Packit 022b05
        application-level matrix tables containing conversation
Packit 022b05
        statistics indexed by pairs of network addresses.
Packit 022b05
        Both the network- and application-level matrix tables are
Packit 022b05
        controlled by this table so that they will both be created
Packit 022b05
        and deleted at the same time, further increasing the ease with
Packit 022b05
        which they can be implemented as a single datastore.  (Note that
Packit 022b05
        if an implementation stores application-layer matrix records
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
        in memory, it can derive network-layer matrix records from
Packit 022b05
        them.)
Packit 022b05
Packit 022b05
        Entries in the nlMatrixSDTable and nlMatrixDSTable will be
Packit 022b05
        created on behalf of each entry in this table.  Additionally,
Packit 022b05
        if this probe implements the alMatrix tables, entries in the
Packit 022b05
        alMatrix tables will be created on behalf of each entry in
Packit 022b05
        this table."
Packit 022b05
    ::= { nlMatrix 1 }
Packit 022b05
Packit 022b05
hlMatrixControlEntry OBJECT-TYPE
Packit 022b05
    SYNTAX      HlMatrixControlEntry
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A conceptual row in the hlMatrixControlTable.
Packit 022b05
Packit 022b05
        An example of indexing of this entry is
Packit 022b05
        hlMatrixControlNlDroppedFrames.1"
Packit 022b05
    INDEX { hlMatrixControlIndex }
Packit 022b05
    ::= { hlMatrixControlTable 1 }
Packit 022b05
Packit 022b05
HlMatrixControlEntry ::= SEQUENCE {
Packit 022b05
    hlMatrixControlIndex                  Integer32,
Packit 022b05
    hlMatrixControlDataSource             DataSource,
Packit 022b05
    hlMatrixControlNlDroppedFrames        Counter32,
Packit 022b05
    hlMatrixControlNlInserts              Counter32,
Packit 022b05
    hlMatrixControlNlDeletes              Counter32,
Packit 022b05
    hlMatrixControlNlMaxDesiredEntries    Integer32,
Packit 022b05
    hlMatrixControlAlDroppedFrames        Counter32,
Packit 022b05
    hlMatrixControlAlInserts              Counter32,
Packit 022b05
    hlMatrixControlAlDeletes              Counter32,
Packit 022b05
    hlMatrixControlAlMaxDesiredEntries    Integer32,
Packit 022b05
    hlMatrixControlOwner                  OwnerString,
Packit 022b05
    hlMatrixControlStatus                 RowStatus
Packit 022b05
}
Packit 022b05
Packit 022b05
hlMatrixControlIndex OBJECT-TYPE
Packit 022b05
    SYNTAX      Integer32 (1..65535)
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "An index that uniquely identifies an entry in the
Packit 022b05
        hlMatrixControlTable.  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
        nlMatrixSDTable and the nlMatrixDSTable, and optionally the
Packit 022b05
        alMatrixSDTable and alMatrixDSTable, on behalf of this
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
        hlMatrixControlEntry."
Packit 022b05
    ::= { hlMatrixControlEntry 1 }
Packit 022b05
Packit 022b05
hlMatrixControlDataSource OBJECT-TYPE
Packit 022b05
    SYNTAX      DataSource
Packit 022b05
    MAX-ACCESS  read-create
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The source of the data for the associated matrix tables.
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
        hlMatrixControlStatus object is equal to active(1)."
Packit 022b05
    ::= { hlMatrixControlEntry 2 }
Packit 022b05
Packit 022b05
hlMatrixControlNlDroppedFrames OBJECT-TYPE
Packit 022b05
    SYNTAX     Counter32
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
       "The total number of frames that were received by the probe
Packit 022b05
        and therefore not accounted for in the *StatsDropEvents, but
Packit 022b05
        that the probe chose not to count for this entry for
Packit 022b05
        whatever reason.  Most often, this event occurs when the probe
Packit 022b05
        is out of some resources and decides to shed load from this
Packit 022b05
        collection.
Packit 022b05
Packit 022b05
        This count does not include packets that were not counted
Packit 022b05
        because they had MAC-layer errors.
Packit 022b05
Packit 022b05
        Note that if the nlMatrixTables are inactive because no
Packit 022b05
        protocols are enabled in the protocol directory, this value
Packit 022b05
        should be 0.
Packit 022b05
Packit 022b05
        Note that, unlike the dropEvents counter, this number is the
Packit 022b05
        exact number of frames dropped."
Packit 022b05
    ::= { hlMatrixControlEntry 3 }
Packit 022b05
Packit 022b05
hlMatrixControlNlInserts OBJECT-TYPE
Packit 022b05
    SYNTAX     Counter32
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The number of times an nlMatrix entry has been
Packit 022b05
        inserted into the nlMatrix tables.  If an entry is inserted,
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
        then deleted, and then inserted, this counter will be
Packit 022b05
        incremented by 2.  The addition of a conversation into both
Packit 022b05
        the nlMatrixSDTable and nlMatrixDSTable shall be counted as
Packit 022b05
        two insertions (even though every addition into one table must
Packit 022b05
        be accompanied by an insertion into the other).
Packit 022b05
Packit 022b05
        To allow for efficient implementation strategies, agents may
Packit 022b05
        delay updating this object for short periods of time.  For
Packit 022b05
        example, an implementation strategy may allow internal
Packit 022b05
        data structures to differ from those visible via SNMP for
Packit 022b05
        short periods of time.  This counter may reflect the internal
Packit 022b05
        data structures for those short periods of time.
Packit 022b05
Packit 022b05
        Note that the sum of then nlMatrixSDTable and nlMatrixDSTable
Packit 022b05
        sizes can be determined by subtracting
Packit 022b05
        hlMatrixControlNlDeletes from hlMatrixControlNlInserts."
Packit 022b05
    ::= { hlMatrixControlEntry 4 }
Packit 022b05
Packit 022b05
hlMatrixControlNlDeletes OBJECT-TYPE
Packit 022b05
    SYNTAX     Counter32
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The number of times an nlMatrix entry has been
Packit 022b05
        deleted from the nlMatrix tables (for any reason).  If an
Packit 022b05
        entry is deleted, then inserted, and then deleted, this
Packit 022b05
        counter will be incremented by 2.  The deletion of a
Packit 022b05
        conversation from both the nlMatrixSDTable and nlMatrixDSTable
Packit 022b05
        shall be counted as two deletions (even though every deletion
Packit 022b05
        from one table must be accompanied by a deletion from the
Packit 022b05
        other).
Packit 022b05
Packit 022b05
        To allow for efficient implementation strategies, agents may
Packit 022b05
        delay updating this object for short periods of time.  For
Packit 022b05
        example, an implementation strategy may allow internal
Packit 022b05
        data structures to differ from those visible via SNMP for
Packit 022b05
        short periods of time.  This counter may reflect the internal
Packit 022b05
        data structures for those short periods of time.
Packit 022b05
Packit 022b05
        Note that the table size can be determined by subtracting
Packit 022b05
        hlMatrixControlNlDeletes from hlMatrixControlNlInserts."
Packit 022b05
    ::= { hlMatrixControlEntry 5 }
Packit 022b05
Packit 022b05
hlMatrixControlNlMaxDesiredEntries OBJECT-TYPE
Packit 022b05
    SYNTAX      Integer32 (-1..2147483647)
Packit 022b05
    MAX-ACCESS  read-create
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
        "The maximum number of entries that are desired in the
Packit 022b05
        nlMatrix tables on behalf of this control entry.  The probe
Packit 022b05
        will not create more than this number of associated entries in
Packit 022b05
        the table but may choose to create fewer entries in this
Packit 022b05
        table for any reason, including the lack of resources.
Packit 022b05
Packit 022b05
        If this object is set to a value less than the current number
Packit 022b05
        of entries, enough entries are chosen in an
Packit 022b05
        implementation-dependent manner and deleted so that the number
Packit 022b05
        of entries in the table equals the value of this object.
Packit 022b05
Packit 022b05
        If this value is set to -1, the probe may create any number
Packit 022b05
        of entries in this table.  If the associated
Packit 022b05
        hlMatrixControlStatus object is equal to 'active', this
Packit 022b05
        object may not be modified.
Packit 022b05
Packit 022b05
        This object may be used to control how resources are allocated
Packit 022b05
        on the probe for the various RMON functions."
Packit 022b05
    ::= { hlMatrixControlEntry 6 }
Packit 022b05
Packit 022b05
hlMatrixControlAlDroppedFrames OBJECT-TYPE
Packit 022b05
    SYNTAX     Counter32
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
       "The total number of frames that were received by the probe
Packit 022b05
        and therefore not accounted for in the *StatsDropEvents, but
Packit 022b05
        that the probe chose not to count for this entry for
Packit 022b05
        whatever reason.  Most often, this event occurs when the probe
Packit 022b05
        is out of some resources and decides to shed load from this
Packit 022b05
        collection.
Packit 022b05
Packit 022b05
        This count does not include packets that were not counted
Packit 022b05
        because they had MAC-layer errors.
Packit 022b05
Packit 022b05
        Note that if the alMatrixTables are not implemented or are
Packit 022b05
        inactive because no protocols are enabled in the protocol
Packit 022b05
        directory, this value should be 0.
Packit 022b05
Packit 022b05
        Note that, unlike the dropEvents counter, this number is the
Packit 022b05
        exact number of frames dropped."
Packit 022b05
    ::= { hlMatrixControlEntry 7 }
Packit 022b05
Packit 022b05
hlMatrixControlAlInserts OBJECT-TYPE
Packit 022b05
    SYNTAX     Counter32
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
        "The number of times an alMatrix entry has been
Packit 022b05
        inserted into the alMatrix tables.  If an entry is inserted,
Packit 022b05
        then deleted, and then inserted, this counter will be
Packit 022b05
        incremented by 2.  The addition of a conversation into both
Packit 022b05
        the alMatrixSDTable and alMatrixDSTable shall be counted as
Packit 022b05
        two insertions (even though every addition into one table must
Packit 022b05
        be accompanied by an insertion into the other).
Packit 022b05
Packit 022b05
        To allow for efficient implementation strategies, agents may
Packit 022b05
        delay updating this object for short periods of time.  For
Packit 022b05
        example, an implementation strategy may allow internal
Packit 022b05
        data structures to differ from those visible via SNMP for
Packit 022b05
        short periods of time.  This counter may reflect the internal
Packit 022b05
        data structures for those short periods of time.
Packit 022b05
Packit 022b05
        Note that the table size can be determined by subtracting
Packit 022b05
        hlMatrixControlAlDeletes from hlMatrixControlAlInserts."
Packit 022b05
    ::= { hlMatrixControlEntry 8 }
Packit 022b05
Packit 022b05
hlMatrixControlAlDeletes OBJECT-TYPE
Packit 022b05
    SYNTAX     Counter32
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The number of times an alMatrix entry has been
Packit 022b05
        deleted from the alMatrix tables.  If an entry is deleted,
Packit 022b05
        then inserted, and then deleted, this counter will be
Packit 022b05
        incremented by 2.  The deletion of a conversation from both
Packit 022b05
        the alMatrixSDTable and alMatrixDSTable shall be counted as
Packit 022b05
        two deletions (even though every deletion from one table must
Packit 022b05
        be accompanied by a deletion from the other).
Packit 022b05
Packit 022b05
        To allow for efficient implementation strategies, agents may
Packit 022b05
        delay updating this object for short periods of time.  For
Packit 022b05
        example, an implementation strategy may allow internal
Packit 022b05
        data structures to differ from those visible via SNMP for
Packit 022b05
        short periods of time.  This counter may reflect the internal
Packit 022b05
        data structures for those short periods of time.
Packit 022b05
Packit 022b05
        Note that the table size can be determined by subtracting
Packit 022b05
        hlMatrixControlAlDeletes from hlMatrixControlAlInserts."
Packit 022b05
    ::= { hlMatrixControlEntry 9 }
Packit 022b05
Packit 022b05
hlMatrixControlAlMaxDesiredEntries OBJECT-TYPE
Packit 022b05
    SYNTAX      Integer32 (-1..2147483647)
Packit 022b05
    MAX-ACCESS  read-create
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
        "The maximum number of entries that are desired in the
Packit 022b05
        alMatrix tables on behalf of this control entry.  The probe
Packit 022b05
        will not create more than this number of associated entries in
Packit 022b05
        the table but may choose to create fewer entries in this
Packit 022b05
        table for any reason, including the lack of resources.
Packit 022b05
Packit 022b05
        If this object is set to a value less than the current number
Packit 022b05
        of entries, enough entries are chosen in an
Packit 022b05
        implementation-dependent manner and deleted so that the number
Packit 022b05
        of entries in the table equals the value of this object.
Packit 022b05
Packit 022b05
        If this value is set to -1, the probe may create any number
Packit 022b05
        of entries in this table.  If the associated
Packit 022b05
        hlMatrixControlStatus object is equal to 'active', this
Packit 022b05
        object may not be modified.
Packit 022b05
Packit 022b05
        This object may be used to control how resources are allocated
Packit 022b05
        on the probe for the various RMON functions."
Packit 022b05
    ::= { hlMatrixControlEntry 10 }
Packit 022b05
Packit 022b05
hlMatrixControlOwner OBJECT-TYPE
Packit 022b05
    SYNTAX      OwnerString
Packit 022b05
    MAX-ACCESS  read-create
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The entity that configured this entry and is
Packit 022b05
        therefore using the resources assigned to it."
Packit 022b05
    ::= { hlMatrixControlEntry 11 }
Packit 022b05
Packit 022b05
hlMatrixControlStatus OBJECT-TYPE
Packit 022b05
    SYNTAX      RowStatus
Packit 022b05
    MAX-ACCESS  read-create
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The status of this hlMatrixControlEntry.
Packit 022b05
Packit 022b05
        An entry may not exist in the active state unless all
Packit 022b05
        objects in the entry have an appropriate value.
Packit 022b05
Packit 022b05
        If this object is not equal to active(1), all
Packit 022b05
        associated entries in the nlMatrixSDTable,
Packit 022b05
        nlMatrixDSTable, alMatrixSDTable, and alMatrixDSTable
Packit 022b05
        shall be deleted by the agent."
Packit 022b05
    ::= { hlMatrixControlEntry 12 }
Packit 022b05
Packit 022b05
nlMatrixSDTable OBJECT-TYPE
Packit 022b05
    SYNTAX      SEQUENCE OF NlMatrixSDEntry
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A list of traffic matrix entries that collect statistics for
Packit 022b05
        conversations between two network-level addresses.  This table
Packit 022b05
        is indexed first by the source address and then by the
Packit 022b05
        destination address to make it convenient to collect all
Packit 022b05
        conversations from a particular address.
Packit 022b05
Packit 022b05
        The probe will populate this table for all network layer
Packit 022b05
        protocols in the protocol directory table whose value of
Packit 022b05
        protocolDirMatrixConfig is equal to supportedOn(3), and
Packit 022b05
        will delete any entries whose protocolDirEntry is deleted or
Packit 022b05
        has a protocolDirMatrixConfig value of supportedOff(2).
Packit 022b05
Packit 022b05
        The probe will add to this table all pairs of addresses
Packit 022b05
        seen in all packets with no MAC errors and will increment
Packit 022b05
        octet and packet counts in the table for all packets with no
Packit 022b05
        MAC errors.
Packit 022b05
Packit 022b05
        Further, this table will only contain entries that have a
Packit 022b05
        corresponding entry in the nlMatrixDSTable with the same
Packit 022b05
        source address and destination address."
Packit 022b05
    ::= { nlMatrix 2 }
Packit 022b05
Packit 022b05
nlMatrixSDEntry OBJECT-TYPE
Packit 022b05
    SYNTAX      NlMatrixSDEntry
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A conceptual row in the nlMatrixSDTable.
Packit 022b05
Packit 022b05
        The hlMatrixControlIndex value in the index identifies the
Packit 022b05
        hlMatrixControlEntry on whose behalf this entry was created.
Packit 022b05
        The protocolDirLocalIndex value in the index identifies the
Packit 022b05
        network-layer protocol of the nlMatrixSDSourceAddress and
Packit 022b05
        nlMatrixSDDestAddress.
Packit 022b05
Packit 022b05
        An example of the indexing of this table is
Packit 022b05
        nlMatrixSDPkts.1.783495.18.4.128.2.6.6.4.128.2.6.7.
Packit 022b05
Packit 022b05
        Note that some combinations of index values may result in an
Packit 022b05
        index that exceeds 128 sub-identifiers in length, which exceeds
Packit 022b05
        the maximum for the SNMP protocol.  Implementations should take
Packit 022b05
        care to avoid such combinations."
Packit 022b05
    INDEX { hlMatrixControlIndex, nlMatrixSDTimeMark,
Packit 022b05
            protocolDirLocalIndex,
Packit 022b05
            nlMatrixSDSourceAddress, nlMatrixSDDestAddress }
Packit 022b05
    ::= { nlMatrixSDTable 1 }
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
NlMatrixSDEntry ::= SEQUENCE {
Packit 022b05
    nlMatrixSDTimeMark              TimeFilter,
Packit 022b05
    nlMatrixSDSourceAddress         OCTET STRING,
Packit 022b05
    nlMatrixSDDestAddress           OCTET STRING,
Packit 022b05
    nlMatrixSDPkts                  ZeroBasedCounter32,
Packit 022b05
    nlMatrixSDOctets                ZeroBasedCounter32,
Packit 022b05
    nlMatrixSDCreateTime            LastCreateTime
Packit 022b05
}
Packit 022b05
Packit 022b05
nlMatrixSDTimeMark OBJECT-TYPE
Packit 022b05
    SYNTAX      TimeFilter
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A TimeFilter for this entry.  See the TimeFilter textual
Packit 022b05
        convention to see how this works."
Packit 022b05
    ::= { nlMatrixSDEntry 1 }
Packit 022b05
Packit 022b05
nlMatrixSDSourceAddress OBJECT-TYPE
Packit 022b05
    SYNTAX      OCTET STRING  (SIZE (1..255))
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The network source address for this nlMatrixSDEntry.
Packit 022b05
Packit 022b05
        This is represented as an octet string with
Packit 022b05
        specific semantics and length as identified
Packit 022b05
        by the protocolDirLocalIndex component of the index.
Packit 022b05
Packit 022b05
        For example, if the protocolDirLocalIndex indicates an
Packit 022b05
        encapsulation of IP, this object is encoded as a length
Packit 022b05
        octet of 4, followed by the 4 octets of the IP address,
Packit 022b05
        in network byte order."
Packit 022b05
    ::= { nlMatrixSDEntry 2 }
Packit 022b05
Packit 022b05
nlMatrixSDDestAddress OBJECT-TYPE
Packit 022b05
    SYNTAX      OCTET STRING  (SIZE (1..255))
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The network destination address for this
Packit 022b05
        nlMatrixSDEntry.
Packit 022b05
Packit 022b05
        This is represented as an octet string with
Packit 022b05
        specific semantics and length as identified
Packit 022b05
        by the protocolDirLocalIndex component of the index.
Packit 022b05
Packit 022b05
        For example, if the protocolDirLocalIndex indicates an
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
        encapsulation of IP, this object is encoded as a length
Packit 022b05
        octet of 4, followed by the 4 octets of the IP address,
Packit 022b05
        in network byte order."
Packit 022b05
    ::= { nlMatrixSDEntry 3 }
Packit 022b05
Packit 022b05
nlMatrixSDPkts OBJECT-TYPE
Packit 022b05
    SYNTAX      ZeroBasedCounter32
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The number of packets without errors transmitted from the
Packit 022b05
        source address to the destination address since this entry was
Packit 022b05
        added to the nlMatrixSDTable.  Note that this is the number of
Packit 022b05
        link-layer packets, so if a single network-layer packet is
Packit 022b05
        fragmented into several link-layer frames, this counter is
Packit 022b05
        incremented several times."
Packit 022b05
    ::= { nlMatrixSDEntry 4 }
Packit 022b05
Packit 022b05
nlMatrixSDOctets OBJECT-TYPE
Packit 022b05
    SYNTAX      ZeroBasedCounter32
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The number of octets transmitted from the source address to
Packit 022b05
        the destination address since this entry was added to the
Packit 022b05
        nlMatrixSDTable (excluding framing bits, but
Packit 022b05
        including FCS octets), excluding octets in packets that
Packit 022b05
        contained errors.
Packit 022b05
Packit 022b05
        Note that this doesn't count just those octets in the particular
Packit 022b05
        protocol frames but includes the entire packet that contained
Packit 022b05
        the protocol."
Packit 022b05
    ::= { nlMatrixSDEntry 5 }
Packit 022b05
Packit 022b05
nlMatrixSDCreateTime OBJECT-TYPE
Packit 022b05
    SYNTAX     LastCreateTime
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The value of sysUpTime when this entry was last activated.
Packit 022b05
        This can be used by the management station to ensure that the
Packit 022b05
        entry has not been deleted and recreated between polls."
Packit 022b05
    ::= { nlMatrixSDEntry 6 }
Packit 022b05
Packit 022b05
Packit 022b05
-- Traffic matrix tables from destination to source
Packit 022b05
Packit 022b05
nlMatrixDSTable OBJECT-TYPE
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
    SYNTAX      SEQUENCE OF NlMatrixDSEntry
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A list of traffic matrix entries that collect statistics for
Packit 022b05
        conversations between two network-level addresses.  This table
Packit 022b05
        is indexed first by the destination address and then by the
Packit 022b05
        source address to make it convenient to collect all
Packit 022b05
        conversations to a particular address.
Packit 022b05
Packit 022b05
        The probe will populate this table for all network layer
Packit 022b05
        protocols in the protocol directory table whose value of
Packit 022b05
        protocolDirMatrixConfig is equal to supportedOn(3), and
Packit 022b05
        will delete any entries whose protocolDirEntry is deleted or
Packit 022b05
        has a protocolDirMatrixConfig value of supportedOff(2).
Packit 022b05
Packit 022b05
        The probe will add to this table all pairs of addresses
Packit 022b05
        seen in all packets with no MAC errors and will increment
Packit 022b05
        octet and packet counts in the table for all packets with no
Packit 022b05
        MAC errors.
Packit 022b05
Packit 022b05
        Further, this table will only contain entries that have a
Packit 022b05
        corresponding entry in the nlMatrixSDTable with the same
Packit 022b05
        source address and destination address."
Packit 022b05
    ::= { nlMatrix 3 }
Packit 022b05
Packit 022b05
nlMatrixDSEntry OBJECT-TYPE
Packit 022b05
    SYNTAX      NlMatrixDSEntry
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A conceptual row in the nlMatrixDSTable.
Packit 022b05
Packit 022b05
        The hlMatrixControlIndex value in the index identifies the
Packit 022b05
        hlMatrixControlEntry on whose behalf this entry was created.
Packit 022b05
        The protocolDirLocalIndex value in the index identifies the
Packit 022b05
        network-layer protocol of the nlMatrixDSSourceAddress and
Packit 022b05
        nlMatrixDSDestAddress.
Packit 022b05
Packit 022b05
        An example of the indexing of this table is
Packit 022b05
        nlMatrixDSPkts.1.783495.18.4.128.2.6.7.4.128.2.6.6.
Packit 022b05
Packit 022b05
        Note that some combinations of index values may result in an
Packit 022b05
        index that exceeds 128 sub-identifiers in length, which exceeds
Packit 022b05
        the maximum for the SNMP protocol.  Implementations should take
Packit 022b05
        care to avoid such combinations."
Packit 022b05
    INDEX { hlMatrixControlIndex, nlMatrixDSTimeMark,
Packit 022b05
            protocolDirLocalIndex,
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
            nlMatrixDSDestAddress, nlMatrixDSSourceAddress }
Packit 022b05
    ::= { nlMatrixDSTable 1 }
Packit 022b05
Packit 022b05
NlMatrixDSEntry ::= SEQUENCE {
Packit 022b05
    nlMatrixDSTimeMark                 TimeFilter,
Packit 022b05
    nlMatrixDSSourceAddress            OCTET STRING,
Packit 022b05
    nlMatrixDSDestAddress              OCTET STRING,
Packit 022b05
    nlMatrixDSPkts                     ZeroBasedCounter32,
Packit 022b05
    nlMatrixDSOctets                   ZeroBasedCounter32,
Packit 022b05
    nlMatrixDSCreateTime               LastCreateTime
Packit 022b05
}
Packit 022b05
Packit 022b05
nlMatrixDSTimeMark OBJECT-TYPE
Packit 022b05
    SYNTAX      TimeFilter
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A TimeFilter for this entry.  See the TimeFilter textual
Packit 022b05
        convention to see how this works."
Packit 022b05
    ::= { nlMatrixDSEntry 1 }
Packit 022b05
Packit 022b05
nlMatrixDSSourceAddress OBJECT-TYPE
Packit 022b05
    SYNTAX      OCTET STRING  (SIZE (1..255))
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The network source address for this nlMatrixDSEntry.
Packit 022b05
Packit 022b05
        This is represented as an octet string with
Packit 022b05
        specific semantics and length as identified
Packit 022b05
        by the protocolDirLocalIndex component of the index.
Packit 022b05
Packit 022b05
        For example, if the protocolDirLocalIndex indicates an
Packit 022b05
        encapsulation of IP, this object is encoded as a length
Packit 022b05
        octet of 4, followed by the 4 octets of the IP address,
Packit 022b05
        in network byte order."
Packit 022b05
    ::= { nlMatrixDSEntry 2 }
Packit 022b05
Packit 022b05
nlMatrixDSDestAddress OBJECT-TYPE
Packit 022b05
    SYNTAX      OCTET STRING  (SIZE (1..255))
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The network destination address for this
Packit 022b05
        nlMatrixDSEntry.
Packit 022b05
Packit 022b05
        This is represented as an octet string with
Packit 022b05
        specific semantics and length as identified
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
        by the protocolDirLocalIndex component of the index.
Packit 022b05
Packit 022b05
        For example, if the protocolDirLocalIndex indicates an
Packit 022b05
        encapsulation of IP, this object is encoded as a length
Packit 022b05
        octet of 4, followed by the 4 octets of the IP address,
Packit 022b05
        in network byte order."
Packit 022b05
    ::= { nlMatrixDSEntry 3 }
Packit 022b05
Packit 022b05
nlMatrixDSPkts OBJECT-TYPE
Packit 022b05
    SYNTAX      ZeroBasedCounter32
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The number of packets without errors transmitted from the
Packit 022b05
        source address to the destination address since this entry was
Packit 022b05
        added to the nlMatrixDSTable.  Note that this is the number of
Packit 022b05
        link-layer packets, so if a single network-layer packet is
Packit 022b05
        fragmented into several link-layer frames, this counter is
Packit 022b05
        incremented several times."
Packit 022b05
    ::= { nlMatrixDSEntry 4 }
Packit 022b05
Packit 022b05
nlMatrixDSOctets OBJECT-TYPE
Packit 022b05
    SYNTAX      ZeroBasedCounter32
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The number of octets transmitted from the source address
Packit 022b05
        to the destination address since this entry was added to the
Packit 022b05
        nlMatrixDSTable (excluding framing bits, but
Packit 022b05
        including FCS octets), excluding octets in packets that
Packit 022b05
        contained errors.
Packit 022b05
Packit 022b05
        Note that this doesn't count just those octets in the particular
Packit 022b05
        protocol frames but includes the entire packet that contained
Packit 022b05
        the protocol."
Packit 022b05
    ::= { nlMatrixDSEntry 5 }
Packit 022b05
Packit 022b05
nlMatrixDSCreateTime OBJECT-TYPE
Packit 022b05
    SYNTAX     LastCreateTime
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The value of sysUpTime when this entry was last activated.
Packit 022b05
        This can be used by the management station to ensure that the
Packit 022b05
        entry has not been deleted and recreated between polls."
Packit 022b05
    ::= { nlMatrixDSEntry 6 }
Packit 022b05
Packit 022b05
nlMatrixTopNControlTable OBJECT-TYPE
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
    SYNTAX      SEQUENCE OF NlMatrixTopNControlEntry
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A set of parameters that control the creation of a
Packit 022b05
        report of the top N matrix entries according to
Packit 022b05
        a selected metric."
Packit 022b05
    ::= { nlMatrix 4 }
Packit 022b05
Packit 022b05
nlMatrixTopNControlEntry OBJECT-TYPE
Packit 022b05
    SYNTAX      NlMatrixTopNControlEntry
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A conceptual row in the nlMatrixTopNControlTable.
Packit 022b05
Packit 022b05
        An example of the indexing of this table is
Packit 022b05
        nlMatrixTopNControlDuration.3"
Packit 022b05
    INDEX { nlMatrixTopNControlIndex }
Packit 022b05
    ::= { nlMatrixTopNControlTable 1 }
Packit 022b05
Packit 022b05
NlMatrixTopNControlEntry ::= SEQUENCE {
Packit 022b05
    nlMatrixTopNControlIndex            Integer32,
Packit 022b05
    nlMatrixTopNControlMatrixIndex      Integer32,
Packit 022b05
    nlMatrixTopNControlRateBase         INTEGER,
Packit 022b05
    nlMatrixTopNControlTimeRemaining    Integer32,
Packit 022b05
    nlMatrixTopNControlGeneratedReports Counter32,
Packit 022b05
    nlMatrixTopNControlDuration         Integer32,
Packit 022b05
    nlMatrixTopNControlRequestedSize    Integer32,
Packit 022b05
    nlMatrixTopNControlGrantedSize      Integer32,
Packit 022b05
    nlMatrixTopNControlStartTime        TimeStamp,
Packit 022b05
    nlMatrixTopNControlOwner            OwnerString,
Packit 022b05
    nlMatrixTopNControlStatus           RowStatus
Packit 022b05
}
Packit 022b05
Packit 022b05
nlMatrixTopNControlIndex OBJECT-TYPE
Packit 022b05
    SYNTAX     Integer32 (1..65535)
Packit 022b05
    MAX-ACCESS not-accessible
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "An index that uniquely identifies an entry
Packit 022b05
        in the nlMatrixTopNControlTable.  Each such
Packit 022b05
        entry defines one topN report prepared for
Packit 022b05
        one interface."
Packit 022b05
    ::= { nlMatrixTopNControlEntry 1 }
Packit 022b05
Packit 022b05
nlMatrixTopNControlMatrixIndex OBJECT-TYPE
Packit 022b05
    SYNTAX     Integer32 (1..65535)
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
    MAX-ACCESS read-create
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The nlMatrix[SD/DS] table for which a topN report will be
Packit 022b05
        prepared on behalf of this entry.  The nlMatrix[SD/DS] table
Packit 022b05
        is identified by the value of the hlMatrixControlIndex
Packit 022b05
        for that table - that value is used here to identify the
Packit 022b05
        particular table.
Packit 022b05
Packit 022b05
        This object may not be modified if the associated
Packit 022b05
        nlMatrixTopNControlStatus object is equal to active(1)."
Packit 022b05
    ::= { nlMatrixTopNControlEntry 2 }
Packit 022b05
Packit 022b05
nlMatrixTopNControlRateBase OBJECT-TYPE
Packit 022b05
    SYNTAX      INTEGER {
Packit 022b05
                    nlMatrixTopNPkts(1),
Packit 022b05
                    nlMatrixTopNOctets(2),
Packit 022b05
                    nlMatrixTopNHighCapacityPkts(3),
Packit 022b05
                    nlMatrixTopNHighCapacityOctets(4)
Packit 022b05
                }
Packit 022b05
    MAX-ACCESS read-create
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The variable for each nlMatrix[SD/DS] entry that the
Packit 022b05
        nlMatrixTopNEntries are sorted by, as well as a control
Packit 022b05
        for the table that the results will be reported in.
Packit 022b05
Packit 022b05
        This object may not be modified if the associated
Packit 022b05
        nlMatrixTopNControlStatus object is equal to active(1).
Packit 022b05
Packit 022b05
        If this value is less than or equal to 2, when the report
Packit 022b05
        is prepared, entries are created in the nlMatrixTopNTable
Packit 022b05
        associated with this object.
Packit 022b05
        If this value is greater than or equal to 3, when the report
Packit 022b05
        is prepared, entries are created in the
Packit 022b05
        nlMatrixTopNHighCapacityTable associated with this object."
Packit 022b05
    ::= { nlMatrixTopNControlEntry 3 }
Packit 022b05
Packit 022b05
nlMatrixTopNControlTimeRemaining OBJECT-TYPE
Packit 022b05
    SYNTAX     Integer32 (0..2147483647)
Packit 022b05
    MAX-ACCESS read-create
Packit 022b05
    STATUS     current
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
Packit 022b05
Packit 022b05
Packit 022b05
        report and is immediately loaded into the associated
Packit 022b05
        nlMatrixTopNControlDuration object.
Packit 022b05
Packit 022b05
        When the report finishes, the probe will automatically
Packit 022b05
        start another collection with the same initial value
Packit 022b05
        of nlMatrixTopNControlTimeRemaining.  Thus, the management
Packit 022b05
        station may simply read the resulting reports repeatedly,
Packit 022b05
        checking the startTime and duration each time to ensure that a
Packit 022b05
        report was not missed or that the report parameters were not
Packit 022b05
        changed.
Packit 022b05
Packit 022b05
        While the value of this object is non-zero, it decrements
Packit 022b05
        by one per second until it reaches zero.  At the time
Packit 022b05
        that this object decrements to zero, the report is made
Packit 022b05
        accessible in the nlMatrixTopNTable, overwriting any report
Packit 022b05
        that may be there.
Packit 022b05
Packit 022b05
        When this object is modified by the management station, any
Packit 022b05
        associated entries in the nlMatrixTopNTable shall be deleted.
Packit 022b05
Packit 022b05
        (Note that this is a different algorithm than the one used
Packit 022b05
        in the hostTopNTable)."
Packit 022b05
    DEFVAL { 1800 }
Packit 022b05
    ::= { nlMatrixTopNControlEntry 4 }
Packit 022b05
Packit 022b05
nlMatrixTopNControlGeneratedReports OBJECT-TYPE
Packit 022b05
    SYNTAX     Counter32
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The number of reports that have been generated by this entry."
Packit 022b05
    ::= { nlMatrixTopNControlEntry 5 }
Packit 022b05
Packit 022b05
nlMatrixTopNControlDuration OBJECT-TYPE
Packit 022b05
    SYNTAX     Integer32
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The number of seconds that this report has collected
Packit 022b05
        during the last sampling interval.
Packit 022b05
Packit 022b05
        When the associated nlMatrixTopNControlTimeRemaining 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 nlMatrixTopNControlTimeRemaining is set.
Packit 022b05
Packit 022b05
        This value shall be zero if no reports have been
Packit 022b05
        requested for this nlMatrixTopNControlEntry."
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
    ::= { nlMatrixTopNControlEntry 6 }
Packit 022b05
Packit 022b05
nlMatrixTopNControlRequestedSize OBJECT-TYPE
Packit 022b05
    SYNTAX     Integer32 (0..2147483647)
Packit 022b05
    MAX-ACCESS read-create
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The maximum number of matrix entries requested for this report.
Packit 022b05
Packit 022b05
        When this object is created or modified, the probe
Packit 022b05
        should set nlMatrixTopNControlGrantedSize as closely to this
Packit 022b05
        object as possible for the particular probe
Packit 022b05
        implementation and available resources."
Packit 022b05
    DEFVAL { 150 }
Packit 022b05
    ::= { nlMatrixTopNControlEntry 7 }
Packit 022b05
Packit 022b05
nlMatrixTopNControlGrantedSize OBJECT-TYPE
Packit 022b05
    SYNTAX     Integer32 (0..2147483647)
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The maximum number of matrix entries in this report.
Packit 022b05
Packit 022b05
        When the associated nlMatrixTopNControlRequestedSize object is
Packit 022b05
        created or modified, the probe should set this
Packit 022b05
        object as closely to the requested value as
Packit 022b05
        possible for the particular implementation and
Packit 022b05
        available resources.  The probe must not lower this
Packit 022b05
        value except as a side-effect of a set to the associated
Packit 022b05
        nlMatrixTopNControlRequestedSize object.
Packit 022b05
Packit 022b05
        If the value of nlMatrixTopNControlRateBase is equal to
Packit 022b05
        nlMatrixTopNPkts, when the next topN report is generated,
Packit 022b05
        matrix entries with the highest value of nlMatrixTopNPktRate
Packit 022b05
        shall be 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
        matrix entries.
Packit 022b05
Packit 022b05
        If the value of nlMatrixTopNControlRateBase is equal to
Packit 022b05
        nlMatrixTopNOctets, when the next topN report is generated,
Packit 022b05
        matrix entries with the highest value of nlMatrixTopNOctetRate
Packit 022b05
        shall be 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
        matrix entries.
Packit 022b05
Packit 022b05
        It is an implementation-specific matter how entries with the
Packit 022b05
        same value of nlMatrixTopNPktRate or nlMatrixTopNOctetRate are
Packit 022b05
        sorted.  It is also an implementation-specific matter as to
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
        whether zero-valued entries are available."
Packit 022b05
    ::= { nlMatrixTopNControlEntry 8 }
Packit 022b05
Packit 022b05
nlMatrixTopNControlStartTime OBJECT-TYPE
Packit 022b05
    SYNTAX     TimeStamp
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The value of sysUpTime when this topN report was
Packit 022b05
        last started.  In other words, this is the time that
Packit 022b05
        the associated nlMatrixTopNControlTimeRemaining object was
Packit 022b05
        modified to start the requested report or the time
Packit 022b05
        the report was last automatically (re)started.
Packit 022b05
Packit 022b05
        This object may be used by the management station to
Packit 022b05
        determine whether a report was missed."
Packit 022b05
    ::= { nlMatrixTopNControlEntry 9 }
Packit 022b05
Packit 022b05
nlMatrixTopNControlOwner OBJECT-TYPE
Packit 022b05
    SYNTAX     OwnerString
Packit 022b05
    MAX-ACCESS read-create
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The entity that configured this entry and is
Packit 022b05
        therefore using the resources assigned to it."
Packit 022b05
    ::= { nlMatrixTopNControlEntry 10 }
Packit 022b05
Packit 022b05
nlMatrixTopNControlStatus OBJECT-TYPE
Packit 022b05
    SYNTAX     RowStatus
Packit 022b05
    MAX-ACCESS read-create
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The status of this nlMatrixTopNControlEntry.
Packit 022b05
Packit 022b05
        An entry may not exist in the active state unless all
Packit 022b05
        objects in the entry have an appropriate value.
Packit 022b05
Packit 022b05
        If this object is not equal to active(1), all
Packit 022b05
        associated entries in the nlMatrixTopNTable shall be deleted
Packit 022b05
        by the agent."
Packit 022b05
    ::= { nlMatrixTopNControlEntry 11 }
Packit 022b05
Packit 022b05
nlMatrixTopNTable OBJECT-TYPE
Packit 022b05
    SYNTAX     SEQUENCE OF NlMatrixTopNEntry
Packit 022b05
    MAX-ACCESS not-accessible
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A set of statistics for those network-layer matrix entries
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
        that have counted the highest number of octets or packets."
Packit 022b05
    ::= { nlMatrix 5 }
Packit 022b05
Packit 022b05
nlMatrixTopNEntry OBJECT-TYPE
Packit 022b05
    SYNTAX     NlMatrixTopNEntry
Packit 022b05
    MAX-ACCESS not-accessible
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A conceptual row in the nlMatrixTopNTable.
Packit 022b05
Packit 022b05
        The nlMatrixTopNControlIndex value in the index identifies the
Packit 022b05
        nlMatrixTopNControlEntry on whose behalf this entry was
Packit 022b05
        created.
Packit 022b05
Packit 022b05
        An example of the indexing of this table is
Packit 022b05
        nlMatrixTopNPktRate.3.10"
Packit 022b05
    INDEX { nlMatrixTopNControlIndex, nlMatrixTopNIndex }
Packit 022b05
    ::= { nlMatrixTopNTable 1 }
Packit 022b05
Packit 022b05
NlMatrixTopNEntry ::= SEQUENCE {
Packit 022b05
    nlMatrixTopNIndex                 Integer32,
Packit 022b05
    nlMatrixTopNProtocolDirLocalIndex Integer32,
Packit 022b05
    nlMatrixTopNSourceAddress         OCTET STRING,
Packit 022b05
    nlMatrixTopNDestAddress           OCTET STRING,
Packit 022b05
    nlMatrixTopNPktRate               Gauge32,
Packit 022b05
    nlMatrixTopNReversePktRate        Gauge32,
Packit 022b05
    nlMatrixTopNOctetRate             Gauge32,
Packit 022b05
    nlMatrixTopNReverseOctetRate      Gauge32
Packit 022b05
}
Packit 022b05
Packit 022b05
nlMatrixTopNIndex OBJECT-TYPE
Packit 022b05
    SYNTAX     Integer32 (1..65535)
Packit 022b05
    MAX-ACCESS not-accessible
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "An index that uniquely identifies an entry in
Packit 022b05
        the nlMatrixTopNTable 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 report.
Packit 022b05
Packit 022b05
        If the value of nlMatrixTopNControlRateBase is equal to
Packit 022b05
        nlMatrixTopNPkts, increasing values of nlMatrixTopNIndex shall
Packit 022b05
        be assigned to entries with decreasing values of
Packit 022b05
        nlMatrixTopNPktRate until index N is assigned or there are no
Packit 022b05
        more nlMatrixTopNEntries.
Packit 022b05
Packit 022b05
        If the value of nlMatrixTopNControlRateBase is equal to
Packit 022b05
        nlMatrixTopNOctets, increasing values of nlMatrixTopNIndex
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
        shall be assigned to entries with decreasing values of
Packit 022b05
        nlMatrixTopNOctetRate until index N is assigned or there are
Packit 022b05
        no more nlMatrixTopNEntries."
Packit 022b05
    ::= { nlMatrixTopNEntry 1 }
Packit 022b05
Packit 022b05
nlMatrixTopNProtocolDirLocalIndex OBJECT-TYPE
Packit 022b05
    SYNTAX     Integer32 (1..2147483647)
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The protocolDirLocalIndex of the network-layer protocol of
Packit 022b05
        this entry's network address."
Packit 022b05
    ::= { nlMatrixTopNEntry 2 }
Packit 022b05
Packit 022b05
nlMatrixTopNSourceAddress OBJECT-TYPE
Packit 022b05
    SYNTAX     OCTET STRING  (SIZE (1..255))
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The network-layer address of the source host in this
Packit 022b05
        conversation.
Packit 022b05
Packit 022b05
        This is represented as an octet string with
Packit 022b05
        specific semantics and length as identified
Packit 022b05
        by the associated nlMatrixTopNProtocolDirLocalIndex.
Packit 022b05
Packit 022b05
        For example, if the protocolDirLocalIndex indicates an
Packit 022b05
        encapsulation of IP, this object is encoded as a length
Packit 022b05
        octet of 4, followed by the 4 octets of the IP address,
Packit 022b05
        in network byte order."
Packit 022b05
    ::= { nlMatrixTopNEntry 3 }
Packit 022b05
Packit 022b05
nlMatrixTopNDestAddress OBJECT-TYPE
Packit 022b05
    SYNTAX     OCTET STRING  (SIZE (1..255))
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The network-layer address of the destination host in this
Packit 022b05
        conversation.
Packit 022b05
Packit 022b05
        This is represented as an octet string with
Packit 022b05
        specific semantics and length as identified
Packit 022b05
        by the associated nlMatrixTopNProtocolDirLocalIndex.
Packit 022b05
Packit 022b05
        For example, if the nlMatrixTopNProtocolDirLocalIndex
Packit 022b05
        indicates an encapsulation of IP, this object is encoded as a
Packit 022b05
        length octet of 4, followed by the 4 octets of the IP address,
Packit 022b05
        in network byte order."
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
    ::= { nlMatrixTopNEntry 4 }
Packit 022b05
Packit 022b05
nlMatrixTopNPktRate OBJECT-TYPE
Packit 022b05
    SYNTAX     Gauge32
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The number of packets seen from the source host
Packit 022b05
        to the destination host during this sampling interval, counted
Packit 022b05
        using the rules for counting the nlMatrixSDPkts object.
Packit 022b05
        If the value of nlMatrixTopNControlRateBase is
Packit 022b05
        nlMatrixTopNPkts, this variable will be used to sort this
Packit 022b05
        report."
Packit 022b05
    ::= { nlMatrixTopNEntry 5 }
Packit 022b05
Packit 022b05
nlMatrixTopNReversePktRate OBJECT-TYPE
Packit 022b05
    SYNTAX     Gauge32
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The number of packets seen from the destination host to the
Packit 022b05
        source host during this sampling interval, counted
Packit 022b05
        using the rules for counting the nlMatrixSDPkts object.  (Note
Packit 022b05
        that the corresponding nlMatrixSDPkts object selected is the
Packit 022b05
        one whose source address is equal to nlMatrixTopNDestAddress
Packit 022b05
        and whose destination address is equal to
Packit 022b05
        nlMatrixTopNSourceAddress.)
Packit 022b05
Packit 022b05
        Note that if the value of nlMatrixTopNControlRateBase is equal
Packit 022b05
        to nlMatrixTopNPkts, the sort of topN entries is based
Packit 022b05
        entirely on nlMatrixTopNPktRate, and not on the value of this
Packit 022b05
        object."
Packit 022b05
    ::= { nlMatrixTopNEntry 6 }
Packit 022b05
Packit 022b05
nlMatrixTopNOctetRate OBJECT-TYPE
Packit 022b05
    SYNTAX     Gauge32
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The number of octets seen from the source host
Packit 022b05
        to the destination host during this sampling interval, counted
Packit 022b05
        using the rules for counting the nlMatrixSDOctets object.  If
Packit 022b05
        the value of nlMatrixTopNControlRateBase is
Packit 022b05
        nlMatrixTopNOctets, this variable will be used to sort this
Packit 022b05
        report."
Packit 022b05
    ::= { nlMatrixTopNEntry 7 }
Packit 022b05
Packit 022b05
nlMatrixTopNReverseOctetRate OBJECT-TYPE
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
    SYNTAX     Gauge32
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The number of octets seen from the destination host to the
Packit 022b05
        source host during this sampling interval, counted
Packit 022b05
        using the rules for counting the nlMatrixDSOctets object.  (Note
Packit 022b05
        that the corresponding nlMatrixSDOctets object selected is the
Packit 022b05
        one whose source address is equal to nlMatrixTopNDestAddress
Packit 022b05
        and whose destination address is equal to
Packit 022b05
        nlMatrixTopNSourceAddress.)
Packit 022b05
Packit 022b05
        Note that if the value of nlMatrixTopNControlRateBase is equal
Packit 022b05
        to nlMatrixTopNOctets, the sort of topN entries is based
Packit 022b05
        entirely on nlMatrixTopNOctetRate, and not on the value of
Packit 022b05
        this object."
Packit 022b05
    ::= { nlMatrixTopNEntry 8 }
Packit 022b05
Packit 022b05
-- Application Layer Functions
Packit 022b05
--
Packit 022b05
-- The application layer host, matrix, and matrixTopN functions report
Packit 022b05
-- on protocol usage at the network layer or higher.  Note that the
Packit 022b05
-- use of the term application layer does not imply that only
Packit 022b05
-- application-layer protocols are counted, rather it means that
Packit 022b05
-- protocols up to and including the application layer are supported.
Packit 022b05
Packit 022b05
--
Packit 022b05
-- Application Layer Host Group
Packit 022b05
--
Packit 022b05
-- Counts the amount of traffic, by protocol, sent from and to each
Packit 022b05
-- network address discovered by the probe.
Packit 022b05
-- Implementation of this group requires implementation of the Network
Packit 022b05
-- Layer Host Group.
Packit 022b05
Packit 022b05
alHostTable OBJECT-TYPE
Packit 022b05
    SYNTAX      SEQUENCE OF AlHostEntry
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A collection of statistics for a particular protocol from a
Packit 022b05
        particular network address that has been discovered on an
Packit 022b05
        interface of this device.
Packit 022b05
Packit 022b05
        The probe will populate this table for all protocols in the
Packit 022b05
        protocol directory table whose value of
Packit 022b05
        protocolDirHostConfig is equal to supportedOn(3), and
Packit 022b05
        will delete any entries whose protocolDirEntry is deleted or
Packit 022b05
        has a protocolDirHostConfig value of supportedOff(2).
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
        The probe will add to this table all addresses
Packit 022b05
        seen as the source or destination address in all packets with
Packit 022b05
        no MAC errors and will increment octet and packet counts in
Packit 022b05
        the table for all packets with no MAC errors.  Further,
Packit 022b05
        entries will only be added to this table if their address
Packit 022b05
        exists in the nlHostTable and will be deleted from this table
Packit 022b05
        if their address is deleted from the nlHostTable."
Packit 022b05
    ::= { alHost 1 }
Packit 022b05
Packit 022b05
alHostEntry OBJECT-TYPE
Packit 022b05
    SYNTAX      AlHostEntry
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A conceptual row in the alHostTable.
Packit 022b05
Packit 022b05
        The hlHostControlIndex value in the index identifies the
Packit 022b05
        hlHostControlEntry on whose behalf this entry was created.
Packit 022b05
        The first protocolDirLocalIndex value in the index identifies
Packit 022b05
        the network-layer protocol of the address.
Packit 022b05
        The nlHostAddress value in the index identifies the network-
Packit 022b05
        layer address of this entry.
Packit 022b05
        The second protocolDirLocalIndex value in the index identifies
Packit 022b05
        the protocol that is counted by this entry.
Packit 022b05
Packit 022b05
        An example of the indexing in this entry is
Packit 022b05
        alHostOutPkts.1.783495.18.4.128.2.6.6.34.
Packit 022b05
Packit 022b05
        Note that some combinations of index values may result in an
Packit 022b05
        index that exceeds 128 sub-identifiers in length, which exceeds
Packit 022b05
        the maximum for the SNMP protocol.  Implementations should take
Packit 022b05
        care to avoid such combinations."
Packit 022b05
    INDEX { hlHostControlIndex, alHostTimeMark,
Packit 022b05
            protocolDirLocalIndex, nlHostAddress,
Packit 022b05
            protocolDirLocalIndex }
Packit 022b05
    ::= { alHostTable 1 }
Packit 022b05
Packit 022b05
AlHostEntry ::= SEQUENCE {
Packit 022b05
    alHostTimeMark                 TimeFilter,
Packit 022b05
    alHostInPkts                   ZeroBasedCounter32,
Packit 022b05
    alHostOutPkts                  ZeroBasedCounter32,
Packit 022b05
    alHostInOctets                 ZeroBasedCounter32,
Packit 022b05
    alHostOutOctets                ZeroBasedCounter32,
Packit 022b05
    alHostCreateTime               LastCreateTime
Packit 022b05
}
Packit 022b05
Packit 022b05
alHostTimeMark OBJECT-TYPE
Packit 022b05
    SYNTAX      TimeFilter
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A TimeFilter for this entry.  See the TimeFilter textual
Packit 022b05
        convention to see how this works."
Packit 022b05
    ::= { alHostEntry 1 }
Packit 022b05
Packit 022b05
alHostInPkts OBJECT-TYPE
Packit 022b05
    SYNTAX      ZeroBasedCounter32
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The number of packets of this protocol type without errors
Packit 022b05
        transmitted to this address since it was added to the
Packit 022b05
        alHostTable.  Note that this is the number of link-layer
Packit 022b05
        packets, so if a single network-layer packet is fragmented
Packit 022b05
        into several link-layer frames, this counter is incremented
Packit 022b05
        several times."
Packit 022b05
    ::= { alHostEntry 2 }
Packit 022b05
Packit 022b05
alHostOutPkts OBJECT-TYPE
Packit 022b05
    SYNTAX      ZeroBasedCounter32
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The number of packets of this protocol type without errors
Packit 022b05
        transmitted by this address since it was added to the
Packit 022b05
        alHostTable.  Note that this is the number of link-layer
Packit 022b05
        packets, so if a single network-layer packet is fragmented
Packit 022b05
        into several link-layer frames, this counter is incremented
Packit 022b05
        several times."
Packit 022b05
     ::= { alHostEntry 3 }
Packit 022b05
Packit 022b05
alHostInOctets OBJECT-TYPE
Packit 022b05
    SYNTAX      ZeroBasedCounter32
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The number of octets transmitted to this address
Packit 022b05
        of this protocol type since it was added to the
Packit 022b05
        alHostTable (excluding framing bits, but including
Packit 022b05
        FCS octets), excluding octets in packets that
Packit 022b05
        contained errors.
Packit 022b05
Packit 022b05
        Note that this doesn't count just those octets in the particular
Packit 022b05
        protocol frames but includes the entire packet that contained
Packit 022b05
        the protocol."
Packit 022b05
    ::= { alHostEntry 4 }
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
alHostOutOctets OBJECT-TYPE
Packit 022b05
    SYNTAX      ZeroBasedCounter32
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The number of octets transmitted by this address
Packit 022b05
        of this protocol type since it was added to the
Packit 022b05
        alHostTable (excluding framing bits, but including
Packit 022b05
        FCS octets), excluding octets in packets that
Packit 022b05
        contained errors.
Packit 022b05
Packit 022b05
        Note that this doesn't count just those octets in the particular
Packit 022b05
        protocol frames but includes the entire packet that contained
Packit 022b05
        the protocol."
Packit 022b05
    ::= { alHostEntry 5 }
Packit 022b05
Packit 022b05
alHostCreateTime OBJECT-TYPE
Packit 022b05
    SYNTAX     LastCreateTime
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The value of sysUpTime when this entry was last activated.
Packit 022b05
        This can be used by the management station to ensure that the
Packit 022b05
        entry has not been deleted and recreated between polls."
Packit 022b05
    ::= { alHostEntry 6 }
Packit 022b05
Packit 022b05
--
Packit 022b05
-- Application Layer Matrix Group
Packit 022b05
--
Packit 022b05
-- Counts the amount of traffic, by protocol, sent between each pair
Packit 022b05
-- of network addresses discovered by the probe.
Packit 022b05
-- Implementation of this group requires implementation of the Network
Packit 022b05
-- Layer Matrix Group.
Packit 022b05
Packit 022b05
alMatrixSDTable OBJECT-TYPE
Packit 022b05
    SYNTAX      SEQUENCE OF AlMatrixSDEntry
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A list of application traffic matrix entries that collect
Packit 022b05
        statistics for conversations of a particular protocol between
Packit 022b05
        two network-level addresses.  This table is indexed first by
Packit 022b05
        the source address and then by the destination address to make
Packit 022b05
        it convenient to collect all statistics from a particular
Packit 022b05
        address.
Packit 022b05
Packit 022b05
        The probe will populate this table for all protocols in the
Packit 022b05
        protocol directory table whose value of
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
        protocolDirMatrixConfig is equal to supportedOn(3), and
Packit 022b05
        will delete any entries whose protocolDirEntry is deleted or
Packit 022b05
        has a protocolDirMatrixConfig value of supportedOff(2).
Packit 022b05
Packit 022b05
        The probe will add to this table all pairs of addresses for
Packit 022b05
        all protocols seen in all packets with no MAC errors and will
Packit 022b05
        increment octet and packet counts in the table for all packets
Packit 022b05
        with no MAC errors.  Further, entries will only be added to
Packit 022b05
        this table if their address pair exists in the nlMatrixSDTable
Packit 022b05
        and will be deleted from this table if the address pair is
Packit 022b05
        deleted from the nlMatrixSDTable."
Packit 022b05
    ::= { alMatrix 1 }
Packit 022b05
Packit 022b05
alMatrixSDEntry OBJECT-TYPE
Packit 022b05
    SYNTAX      AlMatrixSDEntry
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A conceptual row in the alMatrixSDTable.
Packit 022b05
Packit 022b05
        The hlMatrixControlIndex value in the index identifies the
Packit 022b05
        hlMatrixControlEntry on whose behalf this entry was created.
Packit 022b05
        The first protocolDirLocalIndex value in the index identifies
Packit 022b05
        the network-layer protocol of the nlMatrixSDSourceAddress and
Packit 022b05
        nlMatrixSDDestAddress.
Packit 022b05
        The nlMatrixSDSourceAddress value in the index identifies the
Packit 022b05
        network-layer address of the source host in this conversation.
Packit 022b05
        The nlMatrixSDDestAddress value in the index identifies the
Packit 022b05
        network-layer address of the destination host in this
Packit 022b05
        conversation.
Packit 022b05
        The second protocolDirLocalIndex value in the index identifies
Packit 022b05
        the protocol that is counted by this entry.
Packit 022b05
Packit 022b05
        An example of the indexing of this entry is
Packit 022b05
        alMatrixSDPkts.1.783495.18.4.128.2.6.6.4.128.2.6.7.34.
Packit 022b05
Packit 022b05
        Note that some combinations of index values may result in an
Packit 022b05
        index that exceeds 128 sub-identifiers in length, which exceeds
Packit 022b05
        the maximum for the SNMP protocol.  Implementations should take
Packit 022b05
        care to avoid such combinations."
Packit 022b05
    INDEX { hlMatrixControlIndex, alMatrixSDTimeMark,
Packit 022b05
            protocolDirLocalIndex,
Packit 022b05
            nlMatrixSDSourceAddress, nlMatrixSDDestAddress,
Packit 022b05
            protocolDirLocalIndex }
Packit 022b05
    ::= { alMatrixSDTable 1 }
Packit 022b05
Packit 022b05
AlMatrixSDEntry ::= SEQUENCE {
Packit 022b05
    alMatrixSDTimeMark                 TimeFilter,
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
    alMatrixSDPkts                     ZeroBasedCounter32,
Packit 022b05
    alMatrixSDOctets                   ZeroBasedCounter32,
Packit 022b05
    alMatrixSDCreateTime               LastCreateTime
Packit 022b05
}
Packit 022b05
Packit 022b05
alMatrixSDTimeMark OBJECT-TYPE
Packit 022b05
    SYNTAX      TimeFilter
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A TimeFilter for this entry.  See the TimeFilter textual
Packit 022b05
        convention to see how this works."
Packit 022b05
    ::= { alMatrixSDEntry 1 }
Packit 022b05
Packit 022b05
alMatrixSDPkts OBJECT-TYPE
Packit 022b05
    SYNTAX      ZeroBasedCounter32
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The number of packets of this protocol type without errors
Packit 022b05
        transmitted from the source address to the destination address
Packit 022b05
        since this entry was added to the alMatrixSDTable.  Note that
Packit 022b05
        this is the number of link-layer packets, so if a single
Packit 022b05
        network-layer packet is fragmented into several link-layer
Packit 022b05
        frames, this counter is incremented several times."
Packit 022b05
    ::= { alMatrixSDEntry 2 }
Packit 022b05
Packit 022b05
alMatrixSDOctets OBJECT-TYPE
Packit 022b05
    SYNTAX      ZeroBasedCounter32
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The number of octets in packets of this protocol type
Packit 022b05
        transmitted from the source address to the destination address
Packit 022b05
        since this entry was added to the alMatrixSDTable (excluding
Packit 022b05
        framing bits, but including FCS octets), excluding octets
Packit 022b05
        in packets that contained errors.
Packit 022b05
Packit 022b05
        Note that this doesn't count just those octets in the particular
Packit 022b05
        protocol frames but includes the entire packet that contained
Packit 022b05
        the protocol."
Packit 022b05
    ::= { alMatrixSDEntry 3 }
Packit 022b05
Packit 022b05
alMatrixSDCreateTime OBJECT-TYPE
Packit 022b05
    SYNTAX     LastCreateTime
Packit 022b05
    MAX-ACCESS read-only
Packit 022b05
    STATUS     current
Packit 022b05
    DESCRIPTION
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
        "The value of sysUpTime when this entry was last activated.
Packit 022b05
        This can be used by the management station to ensure that the
Packit 022b05
        entry has not been deleted and recreated between polls."
Packit 022b05
    ::= { alMatrixSDEntry 4 }
Packit 022b05
Packit 022b05
-- Traffic matrix tables from destination to source
Packit 022b05
Packit 022b05
alMatrixDSTable OBJECT-TYPE
Packit 022b05
    SYNTAX      SEQUENCE OF AlMatrixDSEntry
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A list of application traffic matrix entries that collect
Packit 022b05
        statistics for conversations of a particular protocol between
Packit 022b05
        two network-level addresses.  This table is indexed first by
Packit 022b05
        the destination address and then by the source address to make
Packit 022b05
        it convenient to collect all statistics to a particular
Packit 022b05
        address.
Packit 022b05
Packit 022b05
        The probe will populate this table for all protocols in the
Packit 022b05
        protocol directory table whose value of
Packit 022b05
        protocolDirMatrixConfig is equal to supportedOn(3), and
Packit 022b05
        will delete any entries whose protocolDirEntry is deleted or
Packit 022b05
        has a protocolDirMatrixConfig value of supportedOff(2).
Packit 022b05
Packit 022b05
        The probe will add to this table all pairs of addresses for
Packit 022b05
        all protocols seen in all packets with no MAC errors and will
Packit 022b05
        increment octet and packet counts in the table for all packets
Packit 022b05
        with no MAC errors.  Further, entries will only be added to
Packit 022b05
        this table if their address pair exists in the nlMatrixDSTable
Packit 022b05
        and will be deleted from this table if the address pair is
Packit 022b05
        deleted from the nlMatrixDSTable."
Packit 022b05
    ::= { alMatrix 2 }
Packit 022b05
Packit 022b05
alMatrixDSEntry OBJECT-TYPE
Packit 022b05
    SYNTAX      AlMatrixDSEntry
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A conceptual row in the alMatrixDSTable.
Packit 022b05
Packit 022b05
        The hlMatrixControlIndex value in the index identifies the
Packit 022b05
        hlMatrixControlEntry on whose behalf this entry was created.
Packit 022b05
        The first protocolDirLocalIndex value in the index identifies
Packit 022b05
        the network-layer protocol of the alMatrixDSSourceAddress and
Packit 022b05
        alMatrixDSDestAddress.
Packit 022b05
        The nlMatrixDSDestAddress value in the index identifies the
Packit 022b05
        network-layer address of the destination host in this
Packit 022b05
Packit 022b05
Packit 022b05
Packit 022b05
        conversation.
Packit 022b05
        The nlMatrixDSSourceAddress value in the index identifies the
Packit 022b05
        network-layer address of the source host in this conversation.
Packit 022b05
        The second protocolDirLocalIndex value in the index identifies
Packit 022b05
        the protocol that is counted by this entry.
Packit 022b05
Packit 022b05
        An example of the indexing of this entry is
Packit 022b05
        alMatrixDSPkts.1.783495.18.4.128.2.6.7.4.128.2.6.6.34.
Packit 022b05
Packit 022b05
        Note that some combinations of index values may result in an
Packit 022b05
        index that exceeds 128 sub-identifiers in length, which exceeds
Packit 022b05
        the maximum for the SNMP protocol.  Implementations should take
Packit 022b05
        care to avoid such combinations."
Packit 022b05
    INDEX { hlMatrixControlIndex, alMatrixDSTimeMark,
Packit 022b05
            protocolDirLocalIndex,
Packit 022b05
            nlMatrixDSDestAddress, nlMatrixDSSourceAddress,
Packit 022b05
            protocolDirLocalIndex }
Packit 022b05
    ::= { alMatrixDSTable 1 }
Packit 022b05
Packit 022b05
AlMatrixDSEntry ::= SEQUENCE {
Packit 022b05
    alMatrixDSTimeMark                 TimeFilter,
Packit 022b05
    alMatrixDSPkts                     ZeroBasedCounter32,
Packit 022b05
    alMatrixDSOctets                   ZeroBasedCounter32,
Packit 022b05
    alMatrixDSCreateTime               LastCreateTime
Packit 022b05
}
Packit 022b05
Packit 022b05
alMatrixDSTimeMark OBJECT-TYPE
Packit 022b05
    SYNTAX      TimeFilter
Packit 022b05
    MAX-ACCESS  not-accessible
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "A TimeFilter for this entry.  See the TimeFilter textual
Packit 022b05
        convention to see how this works."
Packit 022b05
    ::= { alMatrixDSEntry 1 }
Packit 022b05
Packit 022b05
alMatrixDSPkts OBJECT-TYPE
Packit 022b05
    SYNTAX      ZeroBasedCounter32
Packit 022b05
    MAX-ACCESS  read-only
Packit 022b05
    STATUS      current
Packit 022b05
    DESCRIPTION
Packit 022b05
        "The number of packets of this protocol type without errors
Packit 022b05
        transmitted from the source address to the destination address
Packit 022b05
        since this entry was added to the alMatrixDSTable.  Note that
Packit 022b05
        this is the number of link-layer packets, so if a single
Packit 022b05
        network-layer packet is fragmented into several link-layer
Packit 022b05
        frames, this counter is incremented several times."