Blame mibs/IF-MIB.txt

Packit fcad23
IF-MIB DEFINITIONS ::= BEGIN
Packit fcad23
Packit fcad23
IMPORTS
Packit fcad23
    MODULE-IDENTITY, OBJECT-TYPE, Counter32, Gauge32, Counter64,
Packit fcad23
    Integer32, TimeTicks, mib-2,
Packit fcad23
    NOTIFICATION-TYPE                        FROM SNMPv2-SMI
Packit fcad23
    TEXTUAL-CONVENTION, DisplayString,
Packit fcad23
    PhysAddress, TruthValue, RowStatus,
Packit fcad23
    TimeStamp, AutonomousType, TestAndIncr   FROM SNMPv2-TC
Packit fcad23
    MODULE-COMPLIANCE, OBJECT-GROUP,
Packit fcad23
    NOTIFICATION-GROUP                       FROM SNMPv2-CONF
Packit fcad23
    snmpTraps                                FROM SNMPv2-MIB
Packit fcad23
    IANAifType                               FROM IANAifType-MIB;
Packit fcad23
Packit fcad23
ifMIB MODULE-IDENTITY
Packit fcad23
    LAST-UPDATED "200006140000Z"
Packit fcad23
    ORGANIZATION "IETF Interfaces MIB Working Group"
Packit fcad23
    CONTACT-INFO
Packit fcad23
            "   Keith McCloghrie
Packit fcad23
                Cisco Systems, Inc.
Packit fcad23
                170 West Tasman Drive
Packit fcad23
                San Jose, CA  95134-1706
Packit fcad23
                US
Packit fcad23
Packit fcad23
                408-526-5260
Packit fcad23
                kzm@cisco.com"
Packit fcad23
    DESCRIPTION
Packit fcad23
            "The MIB module to describe generic objects for network
Packit fcad23
            interface sub-layers.  This MIB is an updated version of
Packit fcad23
            MIB-II's ifTable, and incorporates the extensions defined in
Packit fcad23
            RFC 1229."
Packit fcad23
Packit fcad23
    REVISION      "200006140000Z"
Packit fcad23
    DESCRIPTION
Packit fcad23
            "Clarifications agreed upon by the Interfaces MIB WG, and
Packit fcad23
            published as RFC 2863."
Packit fcad23
    REVISION      "199602282155Z"
Packit fcad23
    DESCRIPTION
Packit fcad23
            "Revisions made by the Interfaces MIB WG, and published in
Packit fcad23
            RFC 2233."
Packit fcad23
    REVISION      "199311082155Z"
Packit fcad23
    DESCRIPTION
Packit fcad23
            "Initial revision, published as part of RFC 1573."
Packit fcad23
    ::= { mib-2 31 }
Packit fcad23
Packit fcad23
ifMIBObjects OBJECT IDENTIFIER ::= { ifMIB 1 }
Packit fcad23
Packit fcad23
interfaces   OBJECT IDENTIFIER ::= { mib-2 2 }
Packit fcad23
Packit fcad23
--
Packit fcad23
-- Textual Conventions
Packit fcad23
--
Packit fcad23
Packit fcad23
-- OwnerString has the same semantics as used in RFC 1271
Packit fcad23
Packit fcad23
OwnerString ::= TEXTUAL-CONVENTION
Packit fcad23
    DISPLAY-HINT "255a"
Packit fcad23
    STATUS       deprecated
Packit fcad23
    DESCRIPTION
Packit fcad23
            "This data type is used to model an administratively
Packit fcad23
            assigned name of the owner of a resource.  This information
Packit fcad23
            is taken from the NVT ASCII character set.  It is suggested
Packit fcad23
            that this name contain one or more of the following: ASCII
Packit fcad23
            form of the manager station's transport address, management
Packit fcad23
            station name (e.g., domain name), network management
Packit fcad23
            personnel's name, location, or phone number.  In some cases
Packit fcad23
            the agent itself will be the owner of an entry.  In these
Packit fcad23
            cases, this string shall be set to a string starting with
Packit fcad23
            'agent'."
Packit fcad23
    SYNTAX       OCTET STRING (SIZE(0..255))
Packit fcad23
Packit fcad23
-- InterfaceIndex contains the semantics of ifIndex and should be used
Packit fcad23
-- for any objects defined in other MIB modules that need these semantics.
Packit fcad23
Packit fcad23
InterfaceIndex ::= TEXTUAL-CONVENTION
Packit fcad23
    DISPLAY-HINT "d"
Packit fcad23
    STATUS       current
Packit fcad23
    DESCRIPTION
Packit fcad23
            "A unique value, greater than zero, for each interface or
Packit fcad23
            interface sub-layer in the managed system.  It is
Packit fcad23
            recommended that values are assigned contiguously starting
Packit fcad23
            from 1.  The value for each interface sub-layer must remain
Packit fcad23
            constant at least from one re-initialization of the entity's
Packit fcad23
            network management system to the next re-initialization."
Packit fcad23
    SYNTAX       Integer32 (1..2147483647)
Packit fcad23
Packit fcad23
InterfaceIndexOrZero ::= TEXTUAL-CONVENTION
Packit fcad23
    DISPLAY-HINT "d"
Packit fcad23
    STATUS       current
Packit fcad23
    DESCRIPTION
Packit fcad23
            "This textual convention is an extension of the
Packit fcad23
            InterfaceIndex convention.  The latter defines a greater
Packit fcad23
            than zero value used to identify an interface or interface
Packit fcad23
            sub-layer in the managed system.  This extension permits the
Packit fcad23
            additional value of zero.  the value zero is object-specific
Packit fcad23
            and must therefore be defined as part of the description of
Packit fcad23
            any object which uses this syntax.  Examples of the usage of
Packit fcad23
            zero might include situations where interface was unknown,
Packit fcad23
            or when none or all interfaces need to be referenced."
Packit fcad23
    SYNTAX       Integer32 (0..2147483647)
Packit fcad23
Packit fcad23
ifNumber  OBJECT-TYPE
Packit fcad23
    SYNTAX      Integer32
Packit fcad23
    MAX-ACCESS  read-only
Packit fcad23
    STATUS      current
Packit fcad23
    DESCRIPTION
Packit fcad23
            "The number of network interfaces (regardless of their
Packit fcad23
            current state) present on this system."
Packit fcad23
    ::= { interfaces 1 }
Packit fcad23
Packit fcad23
ifTableLastChange  OBJECT-TYPE
Packit fcad23
    SYNTAX      TimeTicks
Packit fcad23
    MAX-ACCESS  read-only
Packit fcad23
    STATUS      current
Packit fcad23
    DESCRIPTION
Packit fcad23
            "The value of sysUpTime at the time of the last creation or
Packit fcad23
            deletion of an entry in the ifTable.  If the number of
Packit fcad23
            entries has been unchanged since the last re-initialization
Packit fcad23
            of the local network management subsystem, then this object
Packit fcad23
            contains a zero value."
Packit fcad23
    ::= { ifMIBObjects 5 }
Packit fcad23
Packit fcad23
-- the Interfaces table
Packit fcad23
Packit fcad23
-- The Interfaces table contains information on the entity's
Packit fcad23
Packit fcad23
-- interfaces.  Each sub-layer below the internetwork-layer
Packit fcad23
-- of a network interface is considered to be an interface.
Packit fcad23
Packit fcad23
ifTable OBJECT-TYPE
Packit fcad23
    SYNTAX      SEQUENCE OF IfEntry
Packit fcad23
    MAX-ACCESS  not-accessible
Packit fcad23
    STATUS      current
Packit fcad23
    DESCRIPTION
Packit fcad23
            "A list of interface entries.  The number of entries is
Packit fcad23
            given by the value of ifNumber."
Packit fcad23
    ::= { interfaces 2 }
Packit fcad23
Packit fcad23
ifEntry OBJECT-TYPE
Packit fcad23
    SYNTAX      IfEntry
Packit fcad23
    MAX-ACCESS  not-accessible
Packit fcad23
    STATUS      current
Packit fcad23
    DESCRIPTION
Packit fcad23
            "An entry containing management information applicable to a
Packit fcad23
            particular interface."
Packit fcad23
    INDEX   { ifIndex }
Packit fcad23
    ::= { ifTable 1 }
Packit fcad23
Packit fcad23
IfEntry ::=
Packit fcad23
    SEQUENCE {
Packit fcad23
        ifIndex                 InterfaceIndex,
Packit fcad23
        ifDescr                 DisplayString,
Packit fcad23
        ifType                  IANAifType,
Packit fcad23
        ifMtu                   Integer32,
Packit fcad23
        ifSpeed                 Gauge32,
Packit fcad23
        ifPhysAddress           PhysAddress,
Packit fcad23
        ifAdminStatus           INTEGER,
Packit fcad23
        ifOperStatus            INTEGER,
Packit fcad23
        ifLastChange            TimeTicks,
Packit fcad23
        ifInOctets              Counter32,
Packit fcad23
        ifInUcastPkts           Counter32,
Packit fcad23
        ifInNUcastPkts          Counter32,  -- deprecated
Packit fcad23
        ifInDiscards            Counter32,
Packit fcad23
        ifInErrors              Counter32,
Packit fcad23
        ifInUnknownProtos       Counter32,
Packit fcad23
        ifOutOctets             Counter32,
Packit fcad23
        ifOutUcastPkts          Counter32,
Packit fcad23
        ifOutNUcastPkts         Counter32,  -- deprecated
Packit fcad23
        ifOutDiscards           Counter32,
Packit fcad23
        ifOutErrors             Counter32,
Packit fcad23
        ifOutQLen               Gauge32,    -- deprecated
Packit fcad23
        ifSpecific              OBJECT IDENTIFIER -- deprecated
Packit fcad23
    }
Packit fcad23
Packit fcad23
ifIndex OBJECT-TYPE
Packit fcad23
    SYNTAX      InterfaceIndex
Packit fcad23
    MAX-ACCESS  read-only
Packit fcad23
    STATUS      current
Packit fcad23
    DESCRIPTION
Packit fcad23
            "A unique value, greater than zero, for each interface.  It
Packit fcad23
            is recommended that values are assigned contiguously
Packit fcad23
            starting from 1.  The value for each interface sub-layer
Packit fcad23
            must remain constant at least from one re-initialization of
Packit fcad23
            the entity's network management system to the next re-
Packit fcad23
            initialization."
Packit fcad23
    ::= { ifEntry 1 }
Packit fcad23
Packit fcad23
ifDescr OBJECT-TYPE
Packit fcad23
    SYNTAX      DisplayString (SIZE (0..255))
Packit fcad23
    MAX-ACCESS  read-only
Packit fcad23
    STATUS      current
Packit fcad23
    DESCRIPTION
Packit fcad23
            "A textual string containing information about the
Packit fcad23
            interface.  This string should include the name of the
Packit fcad23
            manufacturer, the product name and the version of the
Packit fcad23
            interface hardware/software."
Packit fcad23
    ::= { ifEntry 2 }
Packit fcad23
Packit fcad23
ifType OBJECT-TYPE
Packit fcad23
    SYNTAX      IANAifType
Packit fcad23
    MAX-ACCESS  read-only
Packit fcad23
    STATUS      current
Packit fcad23
    DESCRIPTION
Packit fcad23
            "The type of interface.  Additional values for ifType are
Packit fcad23
            assigned by the Internet Assigned Numbers Authority (IANA),
Packit fcad23
            through updating the syntax of the IANAifType textual
Packit fcad23
            convention."
Packit fcad23
    ::= { ifEntry 3 }
Packit fcad23
Packit fcad23
ifMtu OBJECT-TYPE
Packit fcad23
    SYNTAX      Integer32
Packit fcad23
    MAX-ACCESS  read-only
Packit fcad23
    STATUS      current
Packit fcad23
    DESCRIPTION
Packit fcad23
            "The size of the largest packet which can be sent/received
Packit fcad23
            on the interface, specified in octets.  For interfaces that
Packit fcad23
            are used for transmitting network datagrams, this is the
Packit fcad23
            size of the largest network datagram that can be sent on the
Packit fcad23
            interface."
Packit fcad23
    ::= { ifEntry 4 }
Packit fcad23
Packit fcad23
ifSpeed OBJECT-TYPE
Packit fcad23
    SYNTAX      Gauge32
Packit fcad23
    MAX-ACCESS  read-only
Packit fcad23
    STATUS      current
Packit fcad23
    DESCRIPTION
Packit fcad23
            "An estimate of the interface's current bandwidth in bits
Packit fcad23
            per second.  For interfaces which do not vary in bandwidth
Packit fcad23
            or for those where no accurate estimation can be made, this
Packit fcad23
            object should contain the nominal bandwidth.  If the
Packit fcad23
            bandwidth of the interface is greater than the maximum value
Packit fcad23
            reportable by this object then this object should report its
Packit fcad23
            maximum value (4,294,967,295) and ifHighSpeed must be used
Packit fcad23
            to report the interace's speed.  For a sub-layer which has
Packit fcad23
            no concept of bandwidth, this object should be zero."
Packit fcad23
    ::= { ifEntry 5 }
Packit fcad23
Packit fcad23
ifPhysAddress OBJECT-TYPE
Packit fcad23
    SYNTAX      PhysAddress
Packit fcad23
    MAX-ACCESS  read-only
Packit fcad23
    STATUS      current
Packit fcad23
    DESCRIPTION
Packit fcad23
            "The interface's address at its protocol sub-layer.  For
Packit fcad23
            example, for an 802.x interface, this object normally
Packit fcad23
            contains a MAC address.  The interface's media-specific MIB
Packit fcad23
            must define the bit and byte ordering and the format of the
Packit fcad23
            value of this object.  For interfaces which do not have such
Packit fcad23
            an address (e.g., a serial line), this object should contain
Packit fcad23
            an octet string of zero length."
Packit fcad23
    ::= { ifEntry 6 }
Packit fcad23
Packit fcad23
ifAdminStatus OBJECT-TYPE
Packit fcad23
    SYNTAX  INTEGER {
Packit fcad23
                up(1),       -- ready to pass packets
Packit fcad23
                down(2),
Packit fcad23
                testing(3)   -- in some test mode
Packit fcad23
            }
Packit fcad23
    MAX-ACCESS  read-write
Packit fcad23
    STATUS      current
Packit fcad23
    DESCRIPTION
Packit fcad23
            "The desired state of the interface.  The testing(3) state
Packit fcad23
            indicates that no operational packets can be passed.  When a
Packit fcad23
            managed system initializes, all interfaces start with
Packit fcad23
            ifAdminStatus in the down(2) state.  As a result of either
Packit fcad23
            explicit management action or per configuration information
Packit fcad23
            retained by the managed system, ifAdminStatus is then
Packit fcad23
            changed to either the up(1) or testing(3) states (or remains
Packit fcad23
            in the down(2) state)."
Packit fcad23
    ::= { ifEntry 7 }
Packit fcad23
Packit fcad23
ifOperStatus OBJECT-TYPE
Packit fcad23
    SYNTAX  INTEGER {
Packit fcad23
                up(1),        -- ready to pass packets
Packit fcad23
                down(2),
Packit fcad23
                testing(3),   -- in some test mode
Packit fcad23
                unknown(4),   -- status can not be determined
Packit fcad23
                              -- for some reason.
Packit fcad23
                dormant(5),
Packit fcad23
                notPresent(6),    -- some component is missing
Packit fcad23
                lowerLayerDown(7) -- down due to state of
Packit fcad23
                                  -- lower-layer interface(s)
Packit fcad23
            }
Packit fcad23
    MAX-ACCESS  read-only
Packit fcad23
    STATUS      current
Packit fcad23
    DESCRIPTION
Packit fcad23
            "The current operational state of the interface.  The
Packit fcad23
            testing(3) state indicates that no operational packets can
Packit fcad23
            be passed.  If ifAdminStatus is down(2) then ifOperStatus
Packit fcad23
            should be down(2).  If ifAdminStatus is changed to up(1)
Packit fcad23
            then ifOperStatus should change to up(1) if the interface is
Packit fcad23
            ready to transmit and receive network traffic; it should
Packit fcad23
            change to dormant(5) if the interface is waiting for
Packit fcad23
            external actions (such as a serial line waiting for an
Packit fcad23
            incoming connection); it should remain in the down(2) state
Packit fcad23
            if and only if there is a fault that prevents it from going
Packit fcad23
            to the up(1) state; it should remain in the notPresent(6)
Packit fcad23
            state if the interface has missing (typically, hardware)
Packit fcad23
            components."
Packit fcad23
    ::= { ifEntry 8 }
Packit fcad23
Packit fcad23
ifLastChange OBJECT-TYPE
Packit fcad23
    SYNTAX      TimeTicks
Packit fcad23
    MAX-ACCESS  read-only
Packit fcad23
    STATUS      current
Packit fcad23
    DESCRIPTION
Packit fcad23
            "The value of sysUpTime at the time the interface entered
Packit fcad23
            its current operational state.  If the current state was
Packit fcad23
            entered prior to the last re-initialization of the local
Packit fcad23
            network management subsystem, then this object contains a
Packit fcad23
            zero value."
Packit fcad23
    ::= { ifEntry 9 }
Packit fcad23
Packit fcad23
ifInOctets OBJECT-TYPE
Packit fcad23
    SYNTAX      Counter32
Packit fcad23
    MAX-ACCESS  read-only
Packit fcad23
    STATUS      current
Packit fcad23
    DESCRIPTION
Packit fcad23
            "The total number of octets received on the interface,
Packit fcad23
            including framing characters.
Packit fcad23
Packit fcad23
            Discontinuities in the value of this counter can occur at
Packit fcad23
            re-initialization of the management system, and at other
Packit fcad23
            times as indicated by the value of
Packit fcad23
            ifCounterDiscontinuityTime."
Packit fcad23
    ::= { ifEntry 10 }
Packit fcad23
Packit fcad23
ifInUcastPkts OBJECT-TYPE
Packit fcad23
    SYNTAX      Counter32
Packit fcad23
    MAX-ACCESS  read-only
Packit fcad23
    STATUS      current
Packit fcad23
    DESCRIPTION
Packit fcad23
            "The number of packets, delivered by this sub-layer to a
Packit fcad23
            higher (sub-)layer, which were not addressed to a multicast
Packit fcad23
            or broadcast address at this sub-layer.
Packit fcad23
Packit fcad23
            Discontinuities in the value of this counter can occur at
Packit fcad23
            re-initialization of the management system, and at other
Packit fcad23
            times as indicated by the value of
Packit fcad23
            ifCounterDiscontinuityTime."
Packit fcad23
    ::= { ifEntry 11 }
Packit fcad23
Packit fcad23
ifInNUcastPkts OBJECT-TYPE
Packit fcad23
    SYNTAX  Counter32
Packit fcad23
    MAX-ACCESS  read-only
Packit fcad23
    STATUS      deprecated
Packit fcad23
    DESCRIPTION
Packit fcad23
            "The number of packets, delivered by this sub-layer to a
Packit fcad23
            higher (sub-)layer, which were addressed to a multicast or
Packit fcad23
            broadcast address at this sub-layer.
Packit fcad23
Packit fcad23
            Discontinuities in the value of this counter can occur at
Packit fcad23
            re-initialization of the management system, and at other
Packit fcad23
            times as indicated by the value of
Packit fcad23
            ifCounterDiscontinuityTime.
Packit fcad23
Packit fcad23
            This object is deprecated in favour of ifInMulticastPkts and
Packit fcad23
            ifInBroadcastPkts."
Packit fcad23
    ::= { ifEntry 12 }
Packit fcad23
Packit fcad23
ifInDiscards OBJECT-TYPE
Packit fcad23
    SYNTAX      Counter32
Packit fcad23
    MAX-ACCESS  read-only
Packit fcad23
    STATUS      current
Packit fcad23
    DESCRIPTION
Packit fcad23
            "The number of inbound packets which were chosen to be
Packit fcad23
            discarded even though no errors had been detected to prevent
Packit fcad23
Packit fcad23
            their being deliverable to a higher-layer protocol.  One
Packit fcad23
            possible reason for discarding such a packet could be to
Packit fcad23
            free up buffer space.
Packit fcad23
Packit fcad23
            Discontinuities in the value of this counter can occur at
Packit fcad23
            re-initialization of the management system, and at other
Packit fcad23
            times as indicated by the value of
Packit fcad23
            ifCounterDiscontinuityTime."
Packit fcad23
    ::= { ifEntry 13 }
Packit fcad23
Packit fcad23
ifInErrors OBJECT-TYPE
Packit fcad23
    SYNTAX      Counter32
Packit fcad23
    MAX-ACCESS  read-only
Packit fcad23
    STATUS      current
Packit fcad23
    DESCRIPTION
Packit fcad23
            "For packet-oriented interfaces, the number of inbound
Packit fcad23
            packets that contained errors preventing them from being
Packit fcad23
            deliverable to a higher-layer protocol.  For character-
Packit fcad23
            oriented or fixed-length interfaces, the number of inbound
Packit fcad23
            transmission units that contained errors preventing them
Packit fcad23
            from being deliverable to a higher-layer protocol.
Packit fcad23
Packit fcad23
            Discontinuities in the value of this counter can occur at
Packit fcad23
            re-initialization of the management system, and at other
Packit fcad23
            times as indicated by the value of
Packit fcad23
            ifCounterDiscontinuityTime."
Packit fcad23
    ::= { ifEntry 14 }
Packit fcad23
Packit fcad23
ifInUnknownProtos OBJECT-TYPE
Packit fcad23
    SYNTAX      Counter32
Packit fcad23
    MAX-ACCESS  read-only
Packit fcad23
    STATUS      current
Packit fcad23
    DESCRIPTION
Packit fcad23
            "For packet-oriented interfaces, the number of packets
Packit fcad23
            received via the interface which were discarded because of
Packit fcad23
            an unknown or unsupported protocol.  For character-oriented
Packit fcad23
            or fixed-length interfaces that support protocol
Packit fcad23
            multiplexing the number of transmission units received via
Packit fcad23
            the interface which were discarded because of an unknown or
Packit fcad23
            unsupported protocol.  For any interface that does not
Packit fcad23
            support protocol multiplexing, this counter will always be
Packit fcad23
            0.
Packit fcad23
Packit fcad23
            Discontinuities in the value of this counter can occur at
Packit fcad23
            re-initialization of the management system, and at other
Packit fcad23
            times as indicated by the value of
Packit fcad23
            ifCounterDiscontinuityTime."
Packit fcad23
    ::= { ifEntry 15 }
Packit fcad23
Packit fcad23
ifOutOctets OBJECT-TYPE
Packit fcad23
    SYNTAX      Counter32
Packit fcad23
    MAX-ACCESS  read-only
Packit fcad23
    STATUS      current
Packit fcad23
    DESCRIPTION
Packit fcad23
            "The total number of octets transmitted out of the
Packit fcad23
            interface, including framing characters.
Packit fcad23
Packit fcad23
            Discontinuities in the value of this counter can occur at
Packit fcad23
            re-initialization of the management system, and at other
Packit fcad23
            times as indicated by the value of
Packit fcad23
            ifCounterDiscontinuityTime."
Packit fcad23
    ::= { ifEntry 16 }
Packit fcad23
Packit fcad23
ifOutUcastPkts OBJECT-TYPE
Packit fcad23
    SYNTAX      Counter32
Packit fcad23
    MAX-ACCESS  read-only
Packit fcad23
    STATUS      current
Packit fcad23
    DESCRIPTION
Packit fcad23
            "The total number of packets that higher-level protocols
Packit fcad23
            requested be transmitted, and which were not addressed to a
Packit fcad23
            multicast or broadcast address at this sub-layer, including
Packit fcad23
            those that were discarded or not sent.
Packit fcad23
Packit fcad23
            Discontinuities in the value of this counter can occur at
Packit fcad23
            re-initialization of the management system, and at other
Packit fcad23
            times as indicated by the value of
Packit fcad23
            ifCounterDiscontinuityTime."
Packit fcad23
    ::= { ifEntry 17 }
Packit fcad23
Packit fcad23
ifOutNUcastPkts OBJECT-TYPE
Packit fcad23
    SYNTAX      Counter32
Packit fcad23
    MAX-ACCESS  read-only
Packit fcad23
    STATUS      deprecated
Packit fcad23
    DESCRIPTION
Packit fcad23
            "The total number of packets that higher-level protocols
Packit fcad23
            requested be transmitted, and which were addressed to a
Packit fcad23
            multicast or broadcast address at this sub-layer, including
Packit fcad23
            those that were discarded or not sent.
Packit fcad23
Packit fcad23
            Discontinuities in the value of this counter can occur at
Packit fcad23
            re-initialization of the management system, and at other
Packit fcad23
            times as indicated by the value of
Packit fcad23
            ifCounterDiscontinuityTime.
Packit fcad23
Packit fcad23
            This object is deprecated in favour of ifOutMulticastPkts
Packit fcad23
            and ifOutBroadcastPkts."
Packit fcad23
    ::= { ifEntry 18 }
Packit fcad23
Packit fcad23
ifOutDiscards OBJECT-TYPE
Packit fcad23
    SYNTAX      Counter32
Packit fcad23
    MAX-ACCESS  read-only
Packit fcad23
    STATUS      current
Packit fcad23
    DESCRIPTION
Packit fcad23
            "The number of outbound packets which were chosen to be
Packit fcad23
            discarded even though no errors had been detected to prevent
Packit fcad23
            their being transmitted.  One possible reason for discarding
Packit fcad23
            such a packet could be to free up buffer space.
Packit fcad23
Packit fcad23
            Discontinuities in the value of this counter can occur at
Packit fcad23
            re-initialization of the management system, and at other
Packit fcad23
            times as indicated by the value of
Packit fcad23
            ifCounterDiscontinuityTime."
Packit fcad23
    ::= { ifEntry 19 }
Packit fcad23
Packit fcad23
ifOutErrors OBJECT-TYPE
Packit fcad23
    SYNTAX      Counter32
Packit fcad23
    MAX-ACCESS  read-only
Packit fcad23
    STATUS      current
Packit fcad23
    DESCRIPTION
Packit fcad23
            "For packet-oriented interfaces, the number of outbound
Packit fcad23
            packets that could not be transmitted because of errors.
Packit fcad23
            For character-oriented or fixed-length interfaces, the
Packit fcad23
            number of outbound transmission units that could not be
Packit fcad23
            transmitted because of errors.
Packit fcad23
Packit fcad23
            Discontinuities in the value of this counter can occur at
Packit fcad23
            re-initialization of the management system, and at other
Packit fcad23
            times as indicated by the value of
Packit fcad23
            ifCounterDiscontinuityTime."
Packit fcad23
    ::= { ifEntry 20 }
Packit fcad23
Packit fcad23
ifOutQLen OBJECT-TYPE
Packit fcad23
    SYNTAX      Gauge32
Packit fcad23
    MAX-ACCESS  read-only
Packit fcad23
    STATUS      deprecated
Packit fcad23
    DESCRIPTION
Packit fcad23
            "The length of the output packet queue (in packets)."
Packit fcad23
    ::= { ifEntry 21 }
Packit fcad23
Packit fcad23
ifSpecific OBJECT-TYPE
Packit fcad23
    SYNTAX      OBJECT IDENTIFIER
Packit fcad23
    MAX-ACCESS  read-only
Packit fcad23
    STATUS      deprecated
Packit fcad23
    DESCRIPTION
Packit fcad23
            "A reference to MIB definitions specific to the particular
Packit fcad23
            media being used to realize the interface.  It is
Packit fcad23
Packit fcad23
            recommended that this value point to an instance of a MIB
Packit fcad23
            object in the media-specific MIB, i.e., that this object
Packit fcad23
            have the semantics associated with the InstancePointer
Packit fcad23
            textual convention defined in RFC 2579.  In fact, it is
Packit fcad23
            recommended that the media-specific MIB specify what value
Packit fcad23
            ifSpecific should/can take for values of ifType.  If no MIB
Packit fcad23
            definitions specific to the particular media are available,
Packit fcad23
            the value should be set to the OBJECT IDENTIFIER { 0 0 }."
Packit fcad23
    ::= { ifEntry 22 }
Packit fcad23
Packit fcad23
--
Packit fcad23
--   Extension to the interface table
Packit fcad23
--
Packit fcad23
-- This table replaces the ifExtnsTable table.
Packit fcad23
--
Packit fcad23
Packit fcad23
ifXTable        OBJECT-TYPE
Packit fcad23
    SYNTAX      SEQUENCE OF IfXEntry
Packit fcad23
    MAX-ACCESS  not-accessible
Packit fcad23
    STATUS      current
Packit fcad23
    DESCRIPTION
Packit fcad23
            "A list of interface entries.  The number of entries is
Packit fcad23
            given by the value of ifNumber.  This table contains
Packit fcad23
            additional objects for the interface table."
Packit fcad23
    ::= { ifMIBObjects 1 }
Packit fcad23
Packit fcad23
ifXEntry        OBJECT-TYPE
Packit fcad23
    SYNTAX      IfXEntry
Packit fcad23
    MAX-ACCESS  not-accessible
Packit fcad23
    STATUS      current
Packit fcad23
    DESCRIPTION
Packit fcad23
            "An entry containing additional management information
Packit fcad23
            applicable to a particular interface."
Packit fcad23
    AUGMENTS    { ifEntry }
Packit fcad23
    ::= { ifXTable 1 }
Packit fcad23
Packit fcad23
IfXEntry ::=
Packit fcad23
    SEQUENCE {
Packit fcad23
        ifName                  DisplayString,
Packit fcad23
        ifInMulticastPkts       Counter32,
Packit fcad23
        ifInBroadcastPkts       Counter32,
Packit fcad23
        ifOutMulticastPkts      Counter32,
Packit fcad23
        ifOutBroadcastPkts      Counter32,
Packit fcad23
        ifHCInOctets            Counter64,
Packit fcad23
        ifHCInUcastPkts         Counter64,
Packit fcad23
        ifHCInMulticastPkts     Counter64,
Packit fcad23
        ifHCInBroadcastPkts     Counter64,
Packit fcad23
        ifHCOutOctets           Counter64,
Packit fcad23
        ifHCOutUcastPkts        Counter64,
Packit fcad23
        ifHCOutMulticastPkts    Counter64,
Packit fcad23
        ifHCOutBroadcastPkts    Counter64,
Packit fcad23
        ifLinkUpDownTrapEnable  INTEGER,
Packit fcad23
        ifHighSpeed             Gauge32,
Packit fcad23
        ifPromiscuousMode       TruthValue,
Packit fcad23
        ifConnectorPresent      TruthValue,
Packit fcad23
        ifAlias                 DisplayString,
Packit fcad23
        ifCounterDiscontinuityTime TimeStamp
Packit fcad23
    }
Packit fcad23
Packit fcad23
ifName OBJECT-TYPE
Packit fcad23
    SYNTAX      DisplayString
Packit fcad23
    MAX-ACCESS  read-only
Packit fcad23
    STATUS      current
Packit fcad23
    DESCRIPTION
Packit fcad23
            "The textual name of the interface.  The value of this
Packit fcad23
            object should be the name of the interface as assigned by
Packit fcad23
            the local device and should be suitable for use in commands
Packit fcad23
            entered at the device's `console'.  This might be a text
Packit fcad23
            name, such as `le0' or a simple port number, such as `1',
Packit fcad23
            depending on the interface naming syntax of the device.  If
Packit fcad23
            several entries in the ifTable together represent a single
Packit fcad23
            interface as named by the device, then each will have the
Packit fcad23
            same value of ifName.  Note that for an agent which responds
Packit fcad23
            to SNMP queries concerning an interface on some other
Packit fcad23
            (proxied) device, then the value of ifName for such an
Packit fcad23
            interface is the proxied device's local name for it.
Packit fcad23
Packit fcad23
            If there is no local name, or this object is otherwise not
Packit fcad23
            applicable, then this object contains a zero-length string."
Packit fcad23
    ::= { ifXEntry 1 }
Packit fcad23
Packit fcad23
ifInMulticastPkts OBJECT-TYPE
Packit fcad23
    SYNTAX      Counter32
Packit fcad23
    MAX-ACCESS  read-only
Packit fcad23
    STATUS      current
Packit fcad23
    DESCRIPTION
Packit fcad23
            "The number of packets, delivered by this sub-layer to a
Packit fcad23
            higher (sub-)layer, which were addressed to a multicast
Packit fcad23
            address at this sub-layer.  For a MAC layer protocol, this
Packit fcad23
            includes both Group and Functional addresses.
Packit fcad23
Packit fcad23
            Discontinuities in the value of this counter can occur at
Packit fcad23
            re-initialization of the management system, and at other
Packit fcad23
Packit fcad23
            times as indicated by the value of
Packit fcad23
            ifCounterDiscontinuityTime."
Packit fcad23
    ::= { ifXEntry 2 }
Packit fcad23
Packit fcad23
ifInBroadcastPkts OBJECT-TYPE
Packit fcad23
    SYNTAX      Counter32
Packit fcad23
    MAX-ACCESS  read-only
Packit fcad23
    STATUS      current
Packit fcad23
    DESCRIPTION
Packit fcad23
            "The number of packets, delivered by this sub-layer to a
Packit fcad23
            higher (sub-)layer, which were addressed to a broadcast
Packit fcad23
            address at this sub-layer.
Packit fcad23
Packit fcad23
            Discontinuities in the value of this counter can occur at
Packit fcad23
            re-initialization of the management system, and at other
Packit fcad23
            times as indicated by the value of
Packit fcad23
            ifCounterDiscontinuityTime."
Packit fcad23
    ::= { ifXEntry 3 }
Packit fcad23
Packit fcad23
ifOutMulticastPkts OBJECT-TYPE
Packit fcad23
    SYNTAX      Counter32
Packit fcad23
    MAX-ACCESS  read-only
Packit fcad23
    STATUS      current
Packit fcad23
    DESCRIPTION
Packit fcad23
            "The total number of packets that higher-level protocols
Packit fcad23
            requested be transmitted, and which were addressed to a
Packit fcad23
            multicast address at this sub-layer, including those that
Packit fcad23
            were discarded or not sent.  For a MAC layer protocol, this
Packit fcad23
            includes both Group and Functional addresses.
Packit fcad23
Packit fcad23
            Discontinuities in the value of this counter can occur at
Packit fcad23
            re-initialization of the management system, and at other
Packit fcad23
            times as indicated by the value of
Packit fcad23
            ifCounterDiscontinuityTime."
Packit fcad23
    ::= { ifXEntry 4 }
Packit fcad23
Packit fcad23
ifOutBroadcastPkts OBJECT-TYPE
Packit fcad23
    SYNTAX      Counter32
Packit fcad23
    MAX-ACCESS  read-only
Packit fcad23
    STATUS      current
Packit fcad23
    DESCRIPTION
Packit fcad23
            "The total number of packets that higher-level protocols
Packit fcad23
            requested be transmitted, and which were addressed to a
Packit fcad23
            broadcast address at this sub-layer, including those that
Packit fcad23
            were discarded or not sent.
Packit fcad23
Packit fcad23
            Discontinuities in the value of this counter can occur at
Packit fcad23
            re-initialization of the management system, and at other
Packit fcad23
Packit fcad23
            times as indicated by the value of
Packit fcad23
            ifCounterDiscontinuityTime."
Packit fcad23
    ::= { ifXEntry 5 }
Packit fcad23
Packit fcad23
--
Packit fcad23
-- High Capacity Counter objects.  These objects are all
Packit fcad23
-- 64 bit versions of the "basic" ifTable counters.  These
Packit fcad23
-- objects all have the same basic semantics as their 32-bit
Packit fcad23
-- counterparts, however, their syntax has been extended
Packit fcad23
-- to 64 bits.
Packit fcad23
--
Packit fcad23
Packit fcad23
ifHCInOctets OBJECT-TYPE
Packit fcad23
    SYNTAX      Counter64
Packit fcad23
    MAX-ACCESS  read-only
Packit fcad23
    STATUS      current
Packit fcad23
    DESCRIPTION
Packit fcad23
            "The total number of octets received on the interface,
Packit fcad23
            including framing characters.  This object is a 64-bit
Packit fcad23
            version of ifInOctets.
Packit fcad23
Packit fcad23
            Discontinuities in the value of this counter can occur at
Packit fcad23
            re-initialization of the management system, and at other
Packit fcad23
            times as indicated by the value of
Packit fcad23
            ifCounterDiscontinuityTime."
Packit fcad23
    ::= { ifXEntry 6 }
Packit fcad23
Packit fcad23
ifHCInUcastPkts OBJECT-TYPE
Packit fcad23
    SYNTAX      Counter64
Packit fcad23
    MAX-ACCESS  read-only
Packit fcad23
    STATUS      current
Packit fcad23
    DESCRIPTION
Packit fcad23
            "The number of packets, delivered by this sub-layer to a
Packit fcad23
            higher (sub-)layer, which were not addressed to a multicast
Packit fcad23
            or broadcast address at this sub-layer.  This object is a
Packit fcad23
            64-bit version of ifInUcastPkts.
Packit fcad23
Packit fcad23
            Discontinuities in the value of this counter can occur at
Packit fcad23
            re-initialization of the management system, and at other
Packit fcad23
            times as indicated by the value of
Packit fcad23
            ifCounterDiscontinuityTime."
Packit fcad23
    ::= { ifXEntry 7 }
Packit fcad23
Packit fcad23
ifHCInMulticastPkts OBJECT-TYPE
Packit fcad23
    SYNTAX      Counter64
Packit fcad23
    MAX-ACCESS  read-only
Packit fcad23
    STATUS      current
Packit fcad23
    DESCRIPTION
Packit fcad23
            "The number of packets, delivered by this sub-layer to a
Packit fcad23
            higher (sub-)layer, which were addressed to a multicast
Packit fcad23
            address at this sub-layer.  For a MAC layer protocol, this
Packit fcad23
            includes both Group and Functional addresses.  This object
Packit fcad23
            is a 64-bit version of ifInMulticastPkts.
Packit fcad23
Packit fcad23
            Discontinuities in the value of this counter can occur at
Packit fcad23
            re-initialization of the management system, and at other
Packit fcad23
            times as indicated by the value of
Packit fcad23
            ifCounterDiscontinuityTime."
Packit fcad23
    ::= { ifXEntry 8 }
Packit fcad23
Packit fcad23
ifHCInBroadcastPkts OBJECT-TYPE
Packit fcad23
    SYNTAX      Counter64
Packit fcad23
    MAX-ACCESS  read-only
Packit fcad23
    STATUS      current
Packit fcad23
    DESCRIPTION
Packit fcad23
            "The number of packets, delivered by this sub-layer to a
Packit fcad23
            higher (sub-)layer, which were addressed to a broadcast
Packit fcad23
            address at this sub-layer.  This object is a 64-bit version
Packit fcad23
            of ifInBroadcastPkts.
Packit fcad23
Packit fcad23
            Discontinuities in the value of this counter can occur at
Packit fcad23
            re-initialization of the management system, and at other
Packit fcad23
            times as indicated by the value of
Packit fcad23
            ifCounterDiscontinuityTime."
Packit fcad23
    ::= { ifXEntry 9 }
Packit fcad23
Packit fcad23
ifHCOutOctets OBJECT-TYPE
Packit fcad23
    SYNTAX      Counter64
Packit fcad23
    MAX-ACCESS  read-only
Packit fcad23
    STATUS      current
Packit fcad23
    DESCRIPTION
Packit fcad23
            "The total number of octets transmitted out of the
Packit fcad23
            interface, including framing characters.  This object is a
Packit fcad23
            64-bit version of ifOutOctets.
Packit fcad23
Packit fcad23
            Discontinuities in the value of this counter can occur at
Packit fcad23
            re-initialization of the management system, and at other
Packit fcad23
            times as indicated by the value of
Packit fcad23
            ifCounterDiscontinuityTime."
Packit fcad23
    ::= { ifXEntry 10 }
Packit fcad23
Packit fcad23
ifHCOutUcastPkts OBJECT-TYPE
Packit fcad23
    SYNTAX      Counter64
Packit fcad23
    MAX-ACCESS  read-only
Packit fcad23
    STATUS      current
Packit fcad23
    DESCRIPTION
Packit fcad23
            "The total number of packets that higher-level protocols
Packit fcad23
            requested be transmitted, and which were not addressed to a
Packit fcad23
            multicast or broadcast address at this sub-layer, including
Packit fcad23
            those that were discarded or not sent.  This object is a
Packit fcad23
            64-bit version of ifOutUcastPkts.
Packit fcad23
Packit fcad23
            Discontinuities in the value of this counter can occur at
Packit fcad23
            re-initialization of the management system, and at other
Packit fcad23
            times as indicated by the value of
Packit fcad23
            ifCounterDiscontinuityTime."
Packit fcad23
    ::= { ifXEntry 11 }
Packit fcad23
Packit fcad23
ifHCOutMulticastPkts OBJECT-TYPE
Packit fcad23
    SYNTAX      Counter64
Packit fcad23
    MAX-ACCESS  read-only
Packit fcad23
    STATUS      current
Packit fcad23
    DESCRIPTION
Packit fcad23
            "The total number of packets that higher-level protocols
Packit fcad23
            requested be transmitted, and which were addressed to a
Packit fcad23
            multicast address at this sub-layer, including those that
Packit fcad23
            were discarded or not sent.  For a MAC layer protocol, this
Packit fcad23
            includes both Group and Functional addresses.  This object
Packit fcad23
            is a 64-bit version of ifOutMulticastPkts.
Packit fcad23
Packit fcad23
            Discontinuities in the value of this counter can occur at
Packit fcad23
            re-initialization of the management system, and at other
Packit fcad23
            times as indicated by the value of
Packit fcad23
            ifCounterDiscontinuityTime."
Packit fcad23
    ::= { ifXEntry 12 }
Packit fcad23
Packit fcad23
ifHCOutBroadcastPkts OBJECT-TYPE
Packit fcad23
    SYNTAX      Counter64
Packit fcad23
    MAX-ACCESS  read-only
Packit fcad23
    STATUS      current
Packit fcad23
    DESCRIPTION
Packit fcad23
            "The total number of packets that higher-level protocols
Packit fcad23
            requested be transmitted, and which were addressed to a
Packit fcad23
            broadcast address at this sub-layer, including those that
Packit fcad23
            were discarded or not sent.  This object is a 64-bit version
Packit fcad23
            of ifOutBroadcastPkts.
Packit fcad23
Packit fcad23
            Discontinuities in the value of this counter can occur at
Packit fcad23
            re-initialization of the management system, and at other
Packit fcad23
            times as indicated by the value of
Packit fcad23
            ifCounterDiscontinuityTime."
Packit fcad23
    ::= { ifXEntry 13 }
Packit fcad23
Packit fcad23
ifLinkUpDownTrapEnable  OBJECT-TYPE
Packit fcad23
    SYNTAX      INTEGER { enabled(1), disabled(2) }
Packit fcad23
    MAX-ACCESS  read-write
Packit fcad23
    STATUS      current
Packit fcad23
    DESCRIPTION
Packit fcad23
            "Indicates whether linkUp/linkDown traps should be generated
Packit fcad23
            for this interface.
Packit fcad23
Packit fcad23
            By default, this object should have the value enabled(1) for
Packit fcad23
            interfaces which do not operate on 'top' of any other
Packit fcad23
            interface (as defined in the ifStackTable), and disabled(2)
Packit fcad23
            otherwise."
Packit fcad23
    ::= { ifXEntry 14 }
Packit fcad23
Packit fcad23
ifHighSpeed OBJECT-TYPE
Packit fcad23
    SYNTAX      Gauge32
Packit fcad23
    MAX-ACCESS  read-only
Packit fcad23
    STATUS      current
Packit fcad23
    DESCRIPTION
Packit fcad23
            "An estimate of the interface's current bandwidth in units
Packit fcad23
            of 1,000,000 bits per second.  If this object reports a
Packit fcad23
            value of `n' then the speed of the interface is somewhere in
Packit fcad23
            the range of `n-500,000' to `n+499,999'.  For interfaces
Packit fcad23
            which do not vary in bandwidth or for those where no
Packit fcad23
            accurate estimation can be made, this object should contain
Packit fcad23
            the nominal bandwidth.  For a sub-layer which has no concept
Packit fcad23
            of bandwidth, this object should be zero."
Packit fcad23
    ::= { ifXEntry 15 }
Packit fcad23
Packit fcad23
ifPromiscuousMode  OBJECT-TYPE
Packit fcad23
    SYNTAX      TruthValue
Packit fcad23
    MAX-ACCESS  read-write
Packit fcad23
    STATUS      current
Packit fcad23
    DESCRIPTION
Packit fcad23
            "This object has a value of false(2) if this interface only
Packit fcad23
            accepts packets/frames that are addressed to this station.
Packit fcad23
            This object has a value of true(1) when the station accepts
Packit fcad23
            all packets/frames transmitted on the media.  The value
Packit fcad23
            true(1) is only legal on certain types of media.  If legal,
Packit fcad23
            setting this object to a value of true(1) may require the
Packit fcad23
            interface to be reset before becoming effective.
Packit fcad23
Packit fcad23
            The value of ifPromiscuousMode does not affect the reception
Packit fcad23
            of broadcast and multicast packets/frames by the interface."
Packit fcad23
    ::= { ifXEntry 16 }
Packit fcad23
Packit fcad23
ifConnectorPresent   OBJECT-TYPE
Packit fcad23
    SYNTAX      TruthValue
Packit fcad23
    MAX-ACCESS  read-only
Packit fcad23
    STATUS      current
Packit fcad23
    DESCRIPTION
Packit fcad23
            "This object has the value 'true(1)' if the interface
Packit fcad23
            sublayer has a physical connector and the value 'false(2)'
Packit fcad23
            otherwise."
Packit fcad23
    ::= { ifXEntry 17 }
Packit fcad23
Packit fcad23
ifAlias   OBJECT-TYPE
Packit fcad23
    SYNTAX      DisplayString (SIZE(0..64))
Packit fcad23
    MAX-ACCESS  read-write
Packit fcad23
    STATUS      current
Packit fcad23
    DESCRIPTION
Packit fcad23
            "This object is an 'alias' name for the interface as
Packit fcad23
            specified by a network manager, and provides a non-volatile
Packit fcad23
            'handle' for the interface.
Packit fcad23
Packit fcad23
            On the first instantiation of an interface, the value of
Packit fcad23
            ifAlias associated with that interface is the zero-length
Packit fcad23
            string.  As and when a value is written into an instance of
Packit fcad23
            ifAlias through a network management set operation, then the
Packit fcad23
            agent must retain the supplied value in the ifAlias instance
Packit fcad23
            associated with the same interface for as long as that
Packit fcad23
            interface remains instantiated, including across all re-
Packit fcad23
            initializations/reboots of the network management system,
Packit fcad23
            including those which result in a change of the interface's
Packit fcad23
            ifIndex value.
Packit fcad23
Packit fcad23
            An example of the value which a network manager might store
Packit fcad23
            in this object for a WAN interface is the (Telco's) circuit
Packit fcad23
            number/identifier of the interface.
Packit fcad23
Packit fcad23
            Some agents may support write-access only for interfaces
Packit fcad23
            having particular values of ifType.  An agent which supports
Packit fcad23
            write access to this object is required to keep the value in
Packit fcad23
            non-volatile storage, but it may limit the length of new
Packit fcad23
            values depending on how much storage is already occupied by
Packit fcad23
            the current values for other interfaces."
Packit fcad23
    ::= { ifXEntry 18 }
Packit fcad23
Packit fcad23
ifCounterDiscontinuityTime OBJECT-TYPE
Packit fcad23
    SYNTAX      TimeStamp
Packit fcad23
    MAX-ACCESS  read-only
Packit fcad23
    STATUS      current
Packit fcad23
    DESCRIPTION
Packit fcad23
            "The value of sysUpTime on the most recent occasion at which
Packit fcad23
            any one or more of this interface's counters suffered a
Packit fcad23
            discontinuity.  The relevant counters are the specific
Packit fcad23
            instances associated with this interface of any Counter32 or
Packit fcad23
Packit fcad23
            Counter64 object contained in the ifTable or ifXTable.  If
Packit fcad23
            no such discontinuities have occurred since the last re-
Packit fcad23
            initialization of the local management subsystem, then this
Packit fcad23
            object contains a zero value."
Packit fcad23
    ::= { ifXEntry 19 }
Packit fcad23
Packit fcad23
--           The Interface Stack Group
Packit fcad23
--
Packit fcad23
-- Implementation of this group is optional, but strongly recommended
Packit fcad23
-- for all systems
Packit fcad23
--
Packit fcad23
Packit fcad23
ifStackTable  OBJECT-TYPE
Packit fcad23
     SYNTAX        SEQUENCE OF IfStackEntry
Packit fcad23
     MAX-ACCESS    not-accessible
Packit fcad23
     STATUS        current
Packit fcad23
     DESCRIPTION
Packit fcad23
            "The table containing information on the relationships
Packit fcad23
            between the multiple sub-layers of network interfaces.  In
Packit fcad23
            particular, it contains information on which sub-layers run
Packit fcad23
            'on top of' which other sub-layers, where each sub-layer
Packit fcad23
            corresponds to a conceptual row in the ifTable.  For
Packit fcad23
            example, when the sub-layer with ifIndex value x runs over
Packit fcad23
            the sub-layer with ifIndex value y, then this table
Packit fcad23
            contains:
Packit fcad23
Packit fcad23
              ifStackStatus.x.y=active
Packit fcad23
Packit fcad23
            For each ifIndex value, I, which identifies an active
Packit fcad23
            interface, there are always at least two instantiated rows
Packit fcad23
            in this table associated with I.  For one of these rows, I
Packit fcad23
            is the value of ifStackHigherLayer; for the other, I is the
Packit fcad23
            value of ifStackLowerLayer.  (If I is not involved in
Packit fcad23
            multiplexing, then these are the only two rows associated
Packit fcad23
            with I.)
Packit fcad23
Packit fcad23
            For example, two rows exist even for an interface which has
Packit fcad23
            no others stacked on top or below it:
Packit fcad23
Packit fcad23
              ifStackStatus.0.x=active
Packit fcad23
              ifStackStatus.x.0=active "
Packit fcad23
     ::= { ifMIBObjects 2 }
Packit fcad23
Packit fcad23
ifStackEntry  OBJECT-TYPE
Packit fcad23
     SYNTAX        IfStackEntry
Packit fcad23
     MAX-ACCESS    not-accessible
Packit fcad23
     STATUS        current
Packit fcad23
     DESCRIPTION
Packit fcad23
            "Information on a particular relationship between two sub-
Packit fcad23
            layers, specifying that one sub-layer runs on 'top' of the
Packit fcad23
            other sub-layer.  Each sub-layer corresponds to a conceptual
Packit fcad23
            row in the ifTable."
Packit fcad23
     INDEX { ifStackHigherLayer, ifStackLowerLayer }
Packit fcad23
     ::= { ifStackTable 1 }
Packit fcad23
Packit fcad23
IfStackEntry ::=
Packit fcad23
    SEQUENCE {
Packit fcad23
        ifStackHigherLayer  InterfaceIndexOrZero,
Packit fcad23
        ifStackLowerLayer   InterfaceIndexOrZero,
Packit fcad23
        ifStackStatus       RowStatus
Packit fcad23
     }
Packit fcad23
Packit fcad23
ifStackHigherLayer  OBJECT-TYPE
Packit fcad23
     SYNTAX        InterfaceIndexOrZero
Packit fcad23
     MAX-ACCESS    not-accessible
Packit fcad23
     STATUS        current
Packit fcad23
     DESCRIPTION
Packit fcad23
            "The value of ifIndex corresponding to the higher sub-layer
Packit fcad23
            of the relationship, i.e., the sub-layer which runs on 'top'
Packit fcad23
            of the sub-layer identified by the corresponding instance of
Packit fcad23
            ifStackLowerLayer.  If there is no higher sub-layer (below
Packit fcad23
            the internetwork layer), then this object has the value 0."
Packit fcad23
     ::= { ifStackEntry 1 }
Packit fcad23
Packit fcad23
ifStackLowerLayer  OBJECT-TYPE
Packit fcad23
     SYNTAX        InterfaceIndexOrZero
Packit fcad23
     MAX-ACCESS    not-accessible
Packit fcad23
     STATUS        current
Packit fcad23
     DESCRIPTION
Packit fcad23
            "The value of ifIndex corresponding to the lower sub-layer
Packit fcad23
            of the relationship, i.e., the sub-layer which runs 'below'
Packit fcad23
            the sub-layer identified by the corresponding instance of
Packit fcad23
            ifStackHigherLayer.  If there is no lower sub-layer, then
Packit fcad23
            this object has the value 0."
Packit fcad23
     ::= { ifStackEntry 2 }
Packit fcad23
Packit fcad23
ifStackStatus  OBJECT-TYPE
Packit fcad23
    SYNTAX         RowStatus
Packit fcad23
    MAX-ACCESS     read-create
Packit fcad23
    STATUS         current
Packit fcad23
    DESCRIPTION
Packit fcad23
            "The status of the relationship between two sub-layers.
Packit fcad23
Packit fcad23
            Changing the value of this object from 'active' to
Packit fcad23
            'notInService' or 'destroy' will likely have consequences up
Packit fcad23
            and down the interface stack.  Thus, write access to this
Packit fcad23
            object is likely to be inappropriate for some types of
Packit fcad23
            interfaces, and many implementations will choose not to
Packit fcad23
            support write-access for any type of interface."
Packit fcad23
    ::= { ifStackEntry 3 }
Packit fcad23
Packit fcad23
ifStackLastChange OBJECT-TYPE
Packit fcad23
    SYNTAX         TimeTicks
Packit fcad23
    MAX-ACCESS     read-only
Packit fcad23
    STATUS         current
Packit fcad23
    DESCRIPTION
Packit fcad23
            "The value of sysUpTime at the time of the last change of
Packit fcad23
            the (whole) interface stack.  A change of the interface
Packit fcad23
            stack is defined to be any creation, deletion, or change in
Packit fcad23
            value of any instance of ifStackStatus.  If the interface
Packit fcad23
            stack has been unchanged since the last re-initialization of
Packit fcad23
            the local network management subsystem, then this object
Packit fcad23
            contains a zero value."
Packit fcad23
    ::= { ifMIBObjects 6 }
Packit fcad23
Packit fcad23
--   Generic Receive Address Table
Packit fcad23
--
Packit fcad23
-- This group of objects is mandatory for all types of
Packit fcad23
-- interfaces which can receive packets/frames addressed to
Packit fcad23
-- more than one address.
Packit fcad23
--
Packit fcad23
-- This table replaces the ifExtnsRcvAddr table.  The main
Packit fcad23
-- difference is that this table makes use of the RowStatus
Packit fcad23
-- textual convention, while ifExtnsRcvAddr did not.
Packit fcad23
Packit fcad23
ifRcvAddressTable  OBJECT-TYPE
Packit fcad23
    SYNTAX      SEQUENCE OF IfRcvAddressEntry
Packit fcad23
    MAX-ACCESS  not-accessible
Packit fcad23
    STATUS      current
Packit fcad23
    DESCRIPTION
Packit fcad23
            "This table contains an entry for each address (broadcast,
Packit fcad23
            multicast, or uni-cast) for which the system will receive
Packit fcad23
            packets/frames on a particular interface, except as follows:
Packit fcad23
Packit fcad23
            - for an interface operating in promiscuous mode, entries
Packit fcad23
            are only required for those addresses for which the system
Packit fcad23
            would receive frames were it not operating in promiscuous
Packit fcad23
            mode.
Packit fcad23
Packit fcad23
            - for 802.5 functional addresses, only one entry is
Packit fcad23
            required, for the address which has the functional address
Packit fcad23
            bit ANDed with the bit mask of all functional addresses for
Packit fcad23
            which the interface will accept frames.
Packit fcad23
Packit fcad23
            A system is normally able to use any unicast address which
Packit fcad23
            corresponds to an entry in this table as a source address."
Packit fcad23
    ::= { ifMIBObjects 4 }
Packit fcad23
Packit fcad23
ifRcvAddressEntry  OBJECT-TYPE
Packit fcad23
    SYNTAX      IfRcvAddressEntry
Packit fcad23
    MAX-ACCESS  not-accessible
Packit fcad23
    STATUS      current
Packit fcad23
    DESCRIPTION
Packit fcad23
            "A list of objects identifying an address for which the
Packit fcad23
            system will accept packets/frames on the particular
Packit fcad23
            interface identified by the index value ifIndex."
Packit fcad23
    INDEX  { ifIndex, ifRcvAddressAddress }
Packit fcad23
    ::= { ifRcvAddressTable 1 }
Packit fcad23
Packit fcad23
IfRcvAddressEntry ::=
Packit fcad23
    SEQUENCE {
Packit fcad23
        ifRcvAddressAddress   PhysAddress,
Packit fcad23
        ifRcvAddressStatus    RowStatus,
Packit fcad23
        ifRcvAddressType      INTEGER
Packit fcad23
    }
Packit fcad23
Packit fcad23
ifRcvAddressAddress OBJECT-TYPE
Packit fcad23
    SYNTAX      PhysAddress
Packit fcad23
    MAX-ACCESS  not-accessible
Packit fcad23
    STATUS      current
Packit fcad23
    DESCRIPTION
Packit fcad23
            "An address for which the system will accept packets/frames
Packit fcad23
            on this entry's interface."
Packit fcad23
    ::= { ifRcvAddressEntry 1 }
Packit fcad23
Packit fcad23
ifRcvAddressStatus OBJECT-TYPE
Packit fcad23
    SYNTAX      RowStatus
Packit fcad23
    MAX-ACCESS  read-create
Packit fcad23
    STATUS      current
Packit fcad23
    DESCRIPTION
Packit fcad23
            "This object is used to create and delete rows in the
Packit fcad23
            ifRcvAddressTable."
Packit fcad23
    ::= { ifRcvAddressEntry 2 }
Packit fcad23
Packit fcad23
ifRcvAddressType OBJECT-TYPE
Packit fcad23
    SYNTAX      INTEGER {
Packit fcad23
Packit fcad23
                    other(1),
Packit fcad23
                    volatile(2),
Packit fcad23
                    nonVolatile(3)
Packit fcad23
                }
Packit fcad23
    MAX-ACCESS  read-create
Packit fcad23
    STATUS      current
Packit fcad23
    DESCRIPTION
Packit fcad23
            "This object has the value nonVolatile(3) for those entries
Packit fcad23
            in the table which are valid and will not be deleted by the
Packit fcad23
            next restart of the managed system.  Entries having the
Packit fcad23
            value volatile(2) are valid and exist, but have not been
Packit fcad23
            saved, so that will not exist after the next restart of the
Packit fcad23
            managed system.  Entries having the value other(1) are valid
Packit fcad23
            and exist but are not classified as to whether they will
Packit fcad23
            continue to exist after the next restart."
Packit fcad23
    DEFVAL  { volatile }
Packit fcad23
    ::= { ifRcvAddressEntry 3 }
Packit fcad23
Packit fcad23
-- definition of interface-related traps.
Packit fcad23
Packit fcad23
linkDown NOTIFICATION-TYPE
Packit fcad23
    OBJECTS { ifIndex, ifAdminStatus, ifOperStatus }
Packit fcad23
    STATUS  current
Packit fcad23
    DESCRIPTION
Packit fcad23
            "A linkDown trap signifies that the SNMP entity, acting in
Packit fcad23
            an agent role, has detected that the ifOperStatus object for
Packit fcad23
            one of its communication links is about to enter the down
Packit fcad23
            state from some other state (but not from the notPresent
Packit fcad23
            state).  This other state is indicated by the included value
Packit fcad23
            of ifOperStatus."
Packit fcad23
    ::= { snmpTraps 3 }
Packit fcad23
Packit fcad23
linkUp NOTIFICATION-TYPE
Packit fcad23
    OBJECTS { ifIndex, ifAdminStatus, ifOperStatus }
Packit fcad23
    STATUS  current
Packit fcad23
    DESCRIPTION
Packit fcad23
            "A linkUp trap signifies that the SNMP entity, acting in an
Packit fcad23
            agent role, has detected that the ifOperStatus object for
Packit fcad23
            one of its communication links left the down state and
Packit fcad23
            transitioned into some other state (but not into the
Packit fcad23
            notPresent state).  This other state is indicated by the
Packit fcad23
            included value of ifOperStatus."
Packit fcad23
    ::= { snmpTraps 4 }
Packit fcad23
Packit fcad23
-- conformance information
Packit fcad23
Packit fcad23
ifConformance OBJECT IDENTIFIER ::= { ifMIB 2 }
Packit fcad23
Packit fcad23
ifGroups      OBJECT IDENTIFIER ::= { ifConformance 1 }
Packit fcad23
ifCompliances OBJECT IDENTIFIER ::= { ifConformance 2 }
Packit fcad23
Packit fcad23
-- compliance statements
Packit fcad23
Packit fcad23
ifCompliance3 MODULE-COMPLIANCE
Packit fcad23
    STATUS  current
Packit fcad23
    DESCRIPTION
Packit fcad23
            "The compliance statement for SNMP entities which have
Packit fcad23
            network interfaces."
Packit fcad23
Packit fcad23
    MODULE  -- this module
Packit fcad23
        MANDATORY-GROUPS { ifGeneralInformationGroup,
Packit fcad23
                           linkUpDownNotificationsGroup }
Packit fcad23
Packit fcad23
-- The groups:
Packit fcad23
--        ifFixedLengthGroup
Packit fcad23
--        ifHCFixedLengthGroup
Packit fcad23
--        ifPacketGroup
Packit fcad23
--        ifHCPacketGroup
Packit fcad23
--        ifVHCPacketGroup
Packit fcad23
-- are mutually exclusive; at most one of these groups is implemented
Packit fcad23
-- for a particular interface.  When any of these groups is implemented
Packit fcad23
-- for a particular interface, then ifCounterDiscontinuityGroup must
Packit fcad23
-- also be implemented for that interface.
Packit fcad23
Packit fcad23
        GROUP       ifFixedLengthGroup
Packit fcad23
        DESCRIPTION
Packit fcad23
            "This group is mandatory for those network interfaces which
Packit fcad23
            are character-oriented or transmit data in fixed-length
Packit fcad23
            transmission units, and for which the value of the
Packit fcad23
            corresponding instance of ifSpeed is less than or equal to
Packit fcad23
            20,000,000 bits/second."
Packit fcad23
Packit fcad23
        GROUP       ifHCFixedLengthGroup
Packit fcad23
        DESCRIPTION
Packit fcad23
            "This group is mandatory for those network interfaces which
Packit fcad23
            are character-oriented or transmit data in fixed-length
Packit fcad23
            transmission units, and for which the value of the
Packit fcad23
            corresponding instance of ifSpeed is greater than 20,000,000
Packit fcad23
            bits/second."
Packit fcad23
Packit fcad23
        GROUP       ifPacketGroup
Packit fcad23
        DESCRIPTION
Packit fcad23
            "This group is mandatory for those network interfaces which
Packit fcad23
            are packet-oriented, and for which the value of the
Packit fcad23
            corresponding instance of ifSpeed is less than or equal to
Packit fcad23
            20,000,000 bits/second."
Packit fcad23
Packit fcad23
        GROUP       ifHCPacketGroup
Packit fcad23
        DESCRIPTION
Packit fcad23
            "This group is mandatory only for those network interfaces
Packit fcad23
            which are packet-oriented and for which the value of the
Packit fcad23
            corresponding instance of ifSpeed is greater than 20,000,000
Packit fcad23
            bits/second but less than or equal to 650,000,000
Packit fcad23
            bits/second."
Packit fcad23
Packit fcad23
        GROUP       ifVHCPacketGroup
Packit fcad23
        DESCRIPTION
Packit fcad23
            "This group is mandatory only for those network interfaces
Packit fcad23
            which are packet-oriented and for which the value of the
Packit fcad23
            corresponding instance of ifSpeed is greater than
Packit fcad23
            650,000,000 bits/second."
Packit fcad23
Packit fcad23
        GROUP       ifCounterDiscontinuityGroup
Packit fcad23
        DESCRIPTION
Packit fcad23
            "This group is mandatory for those network interfaces that
Packit fcad23
            are required to maintain counters (i.e., those for which one
Packit fcad23
            of the ifFixedLengthGroup, ifHCFixedLengthGroup,
Packit fcad23
            ifPacketGroup, ifHCPacketGroup, or ifVHCPacketGroup is
Packit fcad23
            mandatory)."
Packit fcad23
Packit fcad23
        GROUP       ifRcvAddressGroup
Packit fcad23
        DESCRIPTION
Packit fcad23
            "The applicability of this group MUST be defined by the
Packit fcad23
            media-specific MIBs.  Media-specific MIBs must define the
Packit fcad23
            exact meaning, use, and semantics of the addresses in this
Packit fcad23
            group."
Packit fcad23
Packit fcad23
        OBJECT      ifLinkUpDownTrapEnable
Packit fcad23
        MIN-ACCESS  read-only
Packit fcad23
        DESCRIPTION
Packit fcad23
            "Write access is not required."
Packit fcad23
Packit fcad23
        OBJECT      ifPromiscuousMode
Packit fcad23
        MIN-ACCESS  read-only
Packit fcad23
        DESCRIPTION
Packit fcad23
            "Write access is not required."
Packit fcad23
Packit fcad23
        OBJECT       ifAdminStatus
Packit fcad23
        SYNTAX       INTEGER { up(1), down(2) }
Packit fcad23
        MIN-ACCESS   read-only
Packit fcad23
        DESCRIPTION
Packit fcad23
            "Write access is not required, nor is support for the value
Packit fcad23
            testing(3)."
Packit fcad23
Packit fcad23
        OBJECT       ifAlias
Packit fcad23
        MIN-ACCESS   read-only
Packit fcad23
        DESCRIPTION
Packit fcad23
            "Write access is not required."
Packit fcad23
    ::= { ifCompliances 3 }
Packit fcad23
Packit fcad23
-- units of conformance
Packit fcad23
Packit fcad23
ifGeneralInformationGroup    OBJECT-GROUP
Packit fcad23
    OBJECTS { ifIndex, ifDescr, ifType, ifSpeed, ifPhysAddress,
Packit fcad23
              ifAdminStatus, ifOperStatus, ifLastChange,
Packit fcad23
              ifLinkUpDownTrapEnable, ifConnectorPresent,
Packit fcad23
              ifHighSpeed, ifName, ifNumber, ifAlias,
Packit fcad23
              ifTableLastChange }
Packit fcad23
    STATUS  current
Packit fcad23
    DESCRIPTION
Packit fcad23
            "A collection of objects providing information applicable to
Packit fcad23
            all network interfaces."
Packit fcad23
    ::= { ifGroups 10 }
Packit fcad23
Packit fcad23
-- the following five groups are mutually exclusive; at most
Packit fcad23
-- one of these groups is implemented for any interface
Packit fcad23
Packit fcad23
ifFixedLengthGroup    OBJECT-GROUP
Packit fcad23
    OBJECTS { ifInOctets, ifOutOctets, ifInUnknownProtos,
Packit fcad23
              ifInErrors, ifOutErrors }
Packit fcad23
    STATUS  current
Packit fcad23
    DESCRIPTION
Packit fcad23
            "A collection of objects providing information specific to
Packit fcad23
            non-high speed (non-high speed interfaces transmit and
Packit fcad23
            receive at speeds less than or equal to 20,000,000
Packit fcad23
            bits/second) character-oriented or fixed-length-transmission
Packit fcad23
            network interfaces."
Packit fcad23
    ::= { ifGroups 2 }
Packit fcad23
Packit fcad23
ifHCFixedLengthGroup    OBJECT-GROUP
Packit fcad23
    OBJECTS { ifHCInOctets, ifHCOutOctets,
Packit fcad23
              ifInOctets, ifOutOctets, ifInUnknownProtos,
Packit fcad23
              ifInErrors, ifOutErrors }
Packit fcad23
    STATUS  current
Packit fcad23
    DESCRIPTION
Packit fcad23
            "A collection of objects providing information specific to
Packit fcad23
            high speed (greater than 20,000,000 bits/second) character-
Packit fcad23
            oriented or fixed-length-transmission network interfaces."
Packit fcad23
    ::= { ifGroups 3 }
Packit fcad23
Packit fcad23
ifPacketGroup    OBJECT-GROUP
Packit fcad23
    OBJECTS { ifInOctets, ifOutOctets, ifInUnknownProtos,
Packit fcad23
              ifInErrors, ifOutErrors,
Packit fcad23
              ifMtu, ifInUcastPkts, ifInMulticastPkts,
Packit fcad23
              ifInBroadcastPkts, ifInDiscards,
Packit fcad23
              ifOutUcastPkts, ifOutMulticastPkts,
Packit fcad23
              ifOutBroadcastPkts, ifOutDiscards,
Packit fcad23
              ifPromiscuousMode }
Packit fcad23
    STATUS  current
Packit fcad23
    DESCRIPTION
Packit fcad23
            "A collection of objects providing information specific to
Packit fcad23
            non-high speed (non-high speed interfaces transmit and
Packit fcad23
            receive at speeds less than or equal to 20,000,000
Packit fcad23
            bits/second) packet-oriented network interfaces."
Packit fcad23
    ::= { ifGroups 4 }
Packit fcad23
Packit fcad23
ifHCPacketGroup    OBJECT-GROUP
Packit fcad23
    OBJECTS { ifHCInOctets, ifHCOutOctets,
Packit fcad23
              ifInOctets, ifOutOctets, ifInUnknownProtos,
Packit fcad23
              ifInErrors, ifOutErrors,
Packit fcad23
              ifMtu, ifInUcastPkts, ifInMulticastPkts,
Packit fcad23
              ifInBroadcastPkts, ifInDiscards,
Packit fcad23
              ifOutUcastPkts, ifOutMulticastPkts,
Packit fcad23
              ifOutBroadcastPkts, ifOutDiscards,
Packit fcad23
              ifPromiscuousMode }
Packit fcad23
    STATUS  current
Packit fcad23
    DESCRIPTION
Packit fcad23
            "A collection of objects providing information specific to
Packit fcad23
            high speed (greater than 20,000,000 bits/second but less
Packit fcad23
            than or equal to 650,000,000 bits/second) packet-oriented
Packit fcad23
            network interfaces."
Packit fcad23
    ::= { ifGroups 5 }
Packit fcad23
Packit fcad23
ifVHCPacketGroup    OBJECT-GROUP
Packit fcad23
    OBJECTS { ifHCInUcastPkts, ifHCInMulticastPkts,
Packit fcad23
              ifHCInBroadcastPkts, ifHCOutUcastPkts,
Packit fcad23
              ifHCOutMulticastPkts, ifHCOutBroadcastPkts,
Packit fcad23
              ifHCInOctets, ifHCOutOctets,
Packit fcad23
              ifInOctets, ifOutOctets, ifInUnknownProtos,
Packit fcad23
              ifInErrors, ifOutErrors,
Packit fcad23
              ifMtu, ifInUcastPkts, ifInMulticastPkts,
Packit fcad23
              ifInBroadcastPkts, ifInDiscards,
Packit fcad23
              ifOutUcastPkts, ifOutMulticastPkts,
Packit fcad23
              ifOutBroadcastPkts, ifOutDiscards,
Packit fcad23
              ifPromiscuousMode }
Packit fcad23
    STATUS  current
Packit fcad23
    DESCRIPTION
Packit fcad23
            "A collection of objects providing information specific to
Packit fcad23
            higher speed (greater than 650,000,000 bits/second) packet-
Packit fcad23
            oriented network interfaces."
Packit fcad23
    ::= { ifGroups 6 }
Packit fcad23
Packit fcad23
ifRcvAddressGroup    OBJECT-GROUP
Packit fcad23
    OBJECTS { ifRcvAddressStatus, ifRcvAddressType }
Packit fcad23
    STATUS  current
Packit fcad23
    DESCRIPTION
Packit fcad23
            "A collection of objects providing information on the
Packit fcad23
            multiple addresses which an interface receives."
Packit fcad23
    ::= { ifGroups 7 }
Packit fcad23
Packit fcad23
ifStackGroup2    OBJECT-GROUP
Packit fcad23
    OBJECTS { ifStackStatus, ifStackLastChange }
Packit fcad23
    STATUS  current
Packit fcad23
    DESCRIPTION
Packit fcad23
            "A collection of objects providing information on the
Packit fcad23
            layering of MIB-II interfaces."
Packit fcad23
    ::= { ifGroups 11 }
Packit fcad23
Packit fcad23
ifCounterDiscontinuityGroup  OBJECT-GROUP
Packit fcad23
    OBJECTS { ifCounterDiscontinuityTime }
Packit fcad23
    STATUS  current
Packit fcad23
    DESCRIPTION
Packit fcad23
            "A collection of objects providing information specific to
Packit fcad23
            interface counter discontinuities."
Packit fcad23
    ::= { ifGroups 13 }
Packit fcad23
Packit fcad23
linkUpDownNotificationsGroup  NOTIFICATION-GROUP
Packit fcad23
    NOTIFICATIONS { linkUp, linkDown }
Packit fcad23
    STATUS  current
Packit fcad23
    DESCRIPTION
Packit fcad23
            "The notifications which indicate specific changes in the
Packit fcad23
            value of ifOperStatus."
Packit fcad23
    ::= { ifGroups 14 }
Packit fcad23
Packit fcad23
-- Deprecated Definitions - Objects
Packit fcad23
Packit fcad23
--
Packit fcad23
--    The Interface Test Table
Packit fcad23
--
Packit fcad23
-- This group of objects is optional.  However, a media-specific
Packit fcad23
Packit fcad23
-- MIB may make implementation of this group mandatory.
Packit fcad23
--
Packit fcad23
-- This table replaces the ifExtnsTestTable
Packit fcad23
--
Packit fcad23
Packit fcad23
ifTestTable   OBJECT-TYPE
Packit fcad23
    SYNTAX      SEQUENCE OF IfTestEntry
Packit fcad23
    MAX-ACCESS  not-accessible
Packit fcad23
    STATUS      deprecated
Packit fcad23
    DESCRIPTION
Packit fcad23
            "This table contains one entry per interface.  It defines
Packit fcad23
            objects which allow a network manager to instruct an agent
Packit fcad23
            to test an interface for various faults.  Tests for an
Packit fcad23
            interface are defined in the media-specific MIB for that
Packit fcad23
            interface.  After invoking a test, the object ifTestResult
Packit fcad23
            can be read to determine the outcome.  If an agent can not
Packit fcad23
            perform the test, ifTestResult is set to so indicate.  The
Packit fcad23
            object ifTestCode can be used to provide further test-
Packit fcad23
            specific or interface-specific (or even enterprise-specific)
Packit fcad23
            information concerning the outcome of the test.  Only one
Packit fcad23
            test can be in progress on each interface at any one time.
Packit fcad23
            If one test is in progress when another test is invoked, the
Packit fcad23
            second test is rejected.  Some agents may reject a test when
Packit fcad23
            a prior test is active on another interface.
Packit fcad23
Packit fcad23
            Before starting a test, a manager-station must first obtain
Packit fcad23
            'ownership' of the entry in the ifTestTable for the
Packit fcad23
            interface to be tested.  This is accomplished with the
Packit fcad23
            ifTestId and ifTestStatus objects as follows:
Packit fcad23
Packit fcad23
          try_again:
Packit fcad23
              get (ifTestId, ifTestStatus)
Packit fcad23
              while (ifTestStatus != notInUse)
Packit fcad23
                  /*
Packit fcad23
                   * Loop while a test is running or some other
Packit fcad23
                   * manager is configuring a test.
Packit fcad23
                   */
Packit fcad23
                  short delay
Packit fcad23
                  get (ifTestId, ifTestStatus)
Packit fcad23
              }
Packit fcad23
Packit fcad23
              /*
Packit fcad23
               * Is not being used right now -- let's compete
Packit fcad23
               * to see who gets it.
Packit fcad23
               */
Packit fcad23
              lock_value = ifTestId
Packit fcad23
Packit fcad23
              if ( set(ifTestId = lock_value, ifTestStatus = inUse,
Packit fcad23
                       ifTestOwner = 'my-IP-address') == FAILURE)
Packit fcad23
                  /*
Packit fcad23
                   * Another manager got the ifTestEntry -- go
Packit fcad23
                   * try again
Packit fcad23
                   */
Packit fcad23
                  goto try_again;
Packit fcad23
Packit fcad23
              /*
Packit fcad23
               * I have the lock
Packit fcad23
               */
Packit fcad23
              set up any test parameters.
Packit fcad23
Packit fcad23
              /*
Packit fcad23
               * This starts the test
Packit fcad23
               */
Packit fcad23
              set(ifTestType = test_to_run);
Packit fcad23
Packit fcad23
              wait for test completion by polling ifTestResult
Packit fcad23
Packit fcad23
              when test completes, agent sets ifTestResult
Packit fcad23
                   agent also sets ifTestStatus = 'notInUse'
Packit fcad23
Packit fcad23
              retrieve any additional test results, and ifTestId
Packit fcad23
Packit fcad23
              if (ifTestId == lock_value+1) results are valid
Packit fcad23
Packit fcad23
            A manager station first retrieves the value of the
Packit fcad23
            appropriate ifTestId and ifTestStatus objects, periodically
Packit fcad23
            repeating the retrieval if necessary, until the value of
Packit fcad23
            ifTestStatus is 'notInUse'.  The manager station then tries
Packit fcad23
            to set the same ifTestId object to the value it just
Packit fcad23
            retrieved, the same ifTestStatus object to 'inUse', and the
Packit fcad23
            corresponding ifTestOwner object to a value indicating
Packit fcad23
            itself.  If the set operation succeeds then the manager has
Packit fcad23
            obtained ownership of the ifTestEntry, and the value of the
Packit fcad23
            ifTestId object is incremented by the agent (per the
Packit fcad23
            semantics of TestAndIncr).  Failure of the set operation
Packit fcad23
            indicates that some other manager has obtained ownership of
Packit fcad23
            the ifTestEntry.
Packit fcad23
Packit fcad23
            Once ownership is obtained, any test parameters can be
Packit fcad23
            setup, and then the test is initiated by setting ifTestType.
Packit fcad23
            On completion of the test, the agent sets ifTestStatus to
Packit fcad23
            'notInUse'.  Once this occurs, the manager can retrieve the
Packit fcad23
            results.  In the (rare) event that the invocation of tests
Packit fcad23
            by two network managers were to overlap, then there would be
Packit fcad23
            a possibility that the first test's results might be
Packit fcad23
            overwritten by the second test's results prior to the first
Packit fcad23
Packit fcad23
            results being read.  This unlikely circumstance can be
Packit fcad23
            detected by a network manager retrieving ifTestId at the
Packit fcad23
            same time as retrieving the test results, and ensuring that
Packit fcad23
            the results are for the desired request.
Packit fcad23
Packit fcad23
            If ifTestType is not set within an abnormally long period of
Packit fcad23
            time after ownership is obtained, the agent should time-out
Packit fcad23
            the manager, and reset the value of the ifTestStatus object
Packit fcad23
            back to 'notInUse'.  It is suggested that this time-out
Packit fcad23
            period be 5 minutes.
Packit fcad23
Packit fcad23
            In general, a management station must not retransmit a
Packit fcad23
            request to invoke a test for which it does not receive a
Packit fcad23
            response; instead, it properly inspects an agent's MIB to
Packit fcad23
            determine if the invocation was successful.  Only if the
Packit fcad23
            invocation was unsuccessful, is the invocation request
Packit fcad23
            retransmitted.
Packit fcad23
Packit fcad23
            Some tests may require the interface to be taken off-line in
Packit fcad23
            order to execute them, or may even require the agent to
Packit fcad23
            reboot after completion of the test.  In these
Packit fcad23
            circumstances, communication with the management station
Packit fcad23
            invoking the test may be lost until after completion of the
Packit fcad23
            test.  An agent is not required to support such tests.
Packit fcad23
            However, if such tests are supported, then the agent should
Packit fcad23
            make every effort to transmit a response to the request
Packit fcad23
            which invoked the test prior to losing communication.  When
Packit fcad23
            the agent is restored to normal service, the results of the
Packit fcad23
            test are properly made available in the appropriate objects.
Packit fcad23
            Note that this requires that the ifIndex value assigned to
Packit fcad23
            an interface must be unchanged even if the test causes a
Packit fcad23
            reboot.  An agent must reject any test for which it cannot,
Packit fcad23
            perhaps due to resource constraints, make available at least
Packit fcad23
            the minimum amount of information after that test
Packit fcad23
            completes."
Packit fcad23
    ::= { ifMIBObjects 3 }
Packit fcad23
Packit fcad23
ifTestEntry OBJECT-TYPE
Packit fcad23
    SYNTAX       IfTestEntry
Packit fcad23
    MAX-ACCESS   not-accessible
Packit fcad23
    STATUS       deprecated
Packit fcad23
    DESCRIPTION
Packit fcad23
            "An entry containing objects for invoking tests on an
Packit fcad23
            interface."
Packit fcad23
    AUGMENTS  { ifEntry }
Packit fcad23
    ::= { ifTestTable 1 }
Packit fcad23
Packit fcad23
IfTestEntry ::=
Packit fcad23
Packit fcad23
    SEQUENCE {
Packit fcad23
        ifTestId           TestAndIncr,
Packit fcad23
        ifTestStatus       INTEGER,
Packit fcad23
        ifTestType         AutonomousType,
Packit fcad23
        ifTestResult       INTEGER,
Packit fcad23
        ifTestCode         OBJECT IDENTIFIER,
Packit fcad23
        ifTestOwner        OwnerString
Packit fcad23
    }
Packit fcad23
Packit fcad23
ifTestId         OBJECT-TYPE
Packit fcad23
    SYNTAX       TestAndIncr
Packit fcad23
    MAX-ACCESS   read-write
Packit fcad23
    STATUS       deprecated
Packit fcad23
    DESCRIPTION
Packit fcad23
            "This object identifies the current invocation of the
Packit fcad23
            interface's test."
Packit fcad23
    ::= { ifTestEntry 1 }
Packit fcad23
Packit fcad23
ifTestStatus     OBJECT-TYPE
Packit fcad23
    SYNTAX       INTEGER { notInUse(1), inUse(2) }
Packit fcad23
    MAX-ACCESS   read-write
Packit fcad23
    STATUS       deprecated
Packit fcad23
    DESCRIPTION
Packit fcad23
            "This object indicates whether or not some manager currently
Packit fcad23
            has the necessary 'ownership' required to invoke a test on
Packit fcad23
            this interface.  A write to this object is only successful
Packit fcad23
            when it changes its value from 'notInUse(1)' to 'inUse(2)'.
Packit fcad23
            After completion of a test, the agent resets the value back
Packit fcad23
            to 'notInUse(1)'."
Packit fcad23
    ::= { ifTestEntry 2 }
Packit fcad23
Packit fcad23
ifTestType       OBJECT-TYPE
Packit fcad23
    SYNTAX       AutonomousType
Packit fcad23
    MAX-ACCESS   read-write
Packit fcad23
    STATUS       deprecated
Packit fcad23
    DESCRIPTION
Packit fcad23
            "A control variable used to start and stop operator-
Packit fcad23
            initiated interface tests.  Most OBJECT IDENTIFIER values
Packit fcad23
            assigned to tests are defined elsewhere, in association with
Packit fcad23
            specific types of interface.  However, this document assigns
Packit fcad23
            a value for a full-duplex loopback test, and defines the
Packit fcad23
            special meanings of the subject identifier:
Packit fcad23
Packit fcad23
                noTest  OBJECT IDENTIFIER ::= { 0 0 }
Packit fcad23
Packit fcad23
            When the value noTest is written to this object, no action
Packit fcad23
            is taken unless a test is in progress, in which case the
Packit fcad23
            test is aborted.  Writing any other value to this object is
Packit fcad23
Packit fcad23
            only valid when no test is currently in progress, in which
Packit fcad23
            case the indicated test is initiated.
Packit fcad23
Packit fcad23
            When read, this object always returns the most recent value
Packit fcad23
            that ifTestType was set to.  If it has not been set since
Packit fcad23
            the last initialization of the network management subsystem
Packit fcad23
            on the agent, a value of noTest is returned."
Packit fcad23
    ::= { ifTestEntry 3 }
Packit fcad23
Packit fcad23
ifTestResult  OBJECT-TYPE
Packit fcad23
    SYNTAX       INTEGER {
Packit fcad23
                     none(1),          -- no test yet requested
Packit fcad23
                     success(2),
Packit fcad23
                     inProgress(3),
Packit fcad23
                     notSupported(4),
Packit fcad23
                     unAbleToRun(5),   -- due to state of system
Packit fcad23
                     aborted(6),
Packit fcad23
                     failed(7)
Packit fcad23
                 }
Packit fcad23
    MAX-ACCESS   read-only
Packit fcad23
    STATUS       deprecated
Packit fcad23
    DESCRIPTION
Packit fcad23
            "This object contains the result of the most recently
Packit fcad23
            requested test, or the value none(1) if no tests have been
Packit fcad23
            requested since the last reset.  Note that this facility
Packit fcad23
            provides no provision for saving the results of one test
Packit fcad23
            when starting another, as could be required if used by
Packit fcad23
            multiple managers concurrently."
Packit fcad23
    ::= { ifTestEntry 4 }
Packit fcad23
Packit fcad23
ifTestCode  OBJECT-TYPE
Packit fcad23
    SYNTAX       OBJECT IDENTIFIER
Packit fcad23
    MAX-ACCESS   read-only
Packit fcad23
    STATUS       deprecated
Packit fcad23
    DESCRIPTION
Packit fcad23
            "This object contains a code which contains more specific
Packit fcad23
            information on the test result, for example an error-code
Packit fcad23
            after a failed test.  Error codes and other values this
Packit fcad23
            object may take are specific to the type of interface and/or
Packit fcad23
            test.  The value may have the semantics of either the
Packit fcad23
            AutonomousType or InstancePointer textual conventions as
Packit fcad23
            defined in RFC 2579.  The identifier:
Packit fcad23
Packit fcad23
                testCodeUnknown  OBJECT IDENTIFIER ::= { 0 0 }
Packit fcad23
Packit fcad23
            is defined for use if no additional result code is
Packit fcad23
            available."
Packit fcad23
    ::= { ifTestEntry 5 }
Packit fcad23
Packit fcad23
ifTestOwner      OBJECT-TYPE
Packit fcad23
    SYNTAX       OwnerString
Packit fcad23
    MAX-ACCESS   read-write
Packit fcad23
    STATUS       deprecated
Packit fcad23
    DESCRIPTION
Packit fcad23
            "The entity which currently has the 'ownership' required to
Packit fcad23
            invoke a test on this interface."
Packit fcad23
    ::= { ifTestEntry 6 }
Packit fcad23
Packit fcad23
-- Deprecated Definitions - Groups
Packit fcad23
Packit fcad23
ifGeneralGroup    OBJECT-GROUP
Packit fcad23
    OBJECTS { ifDescr, ifType, ifSpeed, ifPhysAddress,
Packit fcad23
              ifAdminStatus, ifOperStatus, ifLastChange,
Packit fcad23
              ifLinkUpDownTrapEnable, ifConnectorPresent,
Packit fcad23
              ifHighSpeed, ifName }
Packit fcad23
    STATUS  deprecated
Packit fcad23
    DESCRIPTION
Packit fcad23
            "A collection of objects deprecated in favour of
Packit fcad23
            ifGeneralInformationGroup."
Packit fcad23
    ::= { ifGroups 1 }
Packit fcad23
Packit fcad23
ifTestGroup    OBJECT-GROUP
Packit fcad23
    OBJECTS { ifTestId, ifTestStatus, ifTestType,
Packit fcad23
              ifTestResult, ifTestCode, ifTestOwner }
Packit fcad23
    STATUS  deprecated
Packit fcad23
    DESCRIPTION
Packit fcad23
            "A collection of objects providing the ability to invoke
Packit fcad23
            tests on an interface."
Packit fcad23
    ::= { ifGroups 8 }
Packit fcad23
Packit fcad23
ifStackGroup    OBJECT-GROUP
Packit fcad23
    OBJECTS { ifStackStatus }
Packit fcad23
    STATUS  deprecated
Packit fcad23
    DESCRIPTION
Packit fcad23
            "The previous collection of objects providing information on
Packit fcad23
            the layering of MIB-II interfaces."
Packit fcad23
    ::= { ifGroups 9 }
Packit fcad23
Packit fcad23
ifOldObjectsGroup    OBJECT-GROUP
Packit fcad23
    OBJECTS { ifInNUcastPkts, ifOutNUcastPkts,
Packit fcad23
              ifOutQLen, ifSpecific }
Packit fcad23
    STATUS  deprecated
Packit fcad23
    DESCRIPTION
Packit fcad23
            "The collection of objects deprecated from the original MIB-
Packit fcad23
            II interfaces group."
Packit fcad23
    ::= { ifGroups 12 }
Packit fcad23
Packit fcad23
-- Deprecated Definitions - Compliance
Packit fcad23
Packit fcad23
ifCompliance MODULE-COMPLIANCE
Packit fcad23
    STATUS  deprecated
Packit fcad23
    DESCRIPTION
Packit fcad23
            "A compliance statement defined in a previous version of
Packit fcad23
            this MIB module, for SNMP entities which have network
Packit fcad23
            interfaces."
Packit fcad23
Packit fcad23
    MODULE  -- this module
Packit fcad23
        MANDATORY-GROUPS { ifGeneralGroup, ifStackGroup }
Packit fcad23
Packit fcad23
        GROUP       ifFixedLengthGroup
Packit fcad23
        DESCRIPTION
Packit fcad23
            "This group is mandatory for all network interfaces which
Packit fcad23
            are character-oriented or transmit data in fixed-length
Packit fcad23
            transmission units."
Packit fcad23
Packit fcad23
        GROUP       ifHCFixedLengthGroup
Packit fcad23
        DESCRIPTION
Packit fcad23
            "This group is mandatory only for those network interfaces
Packit fcad23
            which are character-oriented or transmit data in fixed-
Packit fcad23
            length transmission units, and for which the value of the
Packit fcad23
            corresponding instance of ifSpeed is greater than 20,000,000
Packit fcad23
            bits/second."
Packit fcad23
Packit fcad23
        GROUP       ifPacketGroup
Packit fcad23
        DESCRIPTION
Packit fcad23
            "This group is mandatory for all network interfaces which
Packit fcad23
            are packet-oriented."
Packit fcad23
Packit fcad23
        GROUP       ifHCPacketGroup
Packit fcad23
        DESCRIPTION
Packit fcad23
            "This group is mandatory only for those network interfaces
Packit fcad23
            which are packet-oriented and for which the value of the
Packit fcad23
            corresponding instance of ifSpeed is greater than
Packit fcad23
            650,000,000 bits/second."
Packit fcad23
Packit fcad23
        GROUP       ifTestGroup
Packit fcad23
        DESCRIPTION
Packit fcad23
            "This group is optional.  Media-specific MIBs which require
Packit fcad23
            interface tests are strongly encouraged to use this group
Packit fcad23
            for invoking tests and reporting results.  A medium specific
Packit fcad23
            MIB which has mandatory tests may make implementation of
Packit fcad23
Packit fcad23
            this group mandatory."
Packit fcad23
Packit fcad23
        GROUP       ifRcvAddressGroup
Packit fcad23
        DESCRIPTION
Packit fcad23
            "The applicability of this group MUST be defined by the
Packit fcad23
            media-specific MIBs.  Media-specific MIBs must define the
Packit fcad23
            exact meaning, use, and semantics of the addresses in this
Packit fcad23
            group."
Packit fcad23
Packit fcad23
        OBJECT      ifLinkUpDownTrapEnable
Packit fcad23
        MIN-ACCESS  read-only
Packit fcad23
        DESCRIPTION
Packit fcad23
            "Write access is not required."
Packit fcad23
Packit fcad23
        OBJECT      ifPromiscuousMode
Packit fcad23
        MIN-ACCESS  read-only
Packit fcad23
        DESCRIPTION
Packit fcad23
            "Write access is not required."
Packit fcad23
Packit fcad23
        OBJECT      ifStackStatus
Packit fcad23
        SYNTAX      INTEGER { active(1) } -- subset of RowStatus
Packit fcad23
        MIN-ACCESS  read-only
Packit fcad23
        DESCRIPTION
Packit fcad23
            "Write access is not required, and only one of the six
Packit fcad23
            enumerated values for the RowStatus textual convention need
Packit fcad23
            be supported, specifically: active(1)."
Packit fcad23
Packit fcad23
        OBJECT       ifAdminStatus
Packit fcad23
        SYNTAX       INTEGER { up(1), down(2) }
Packit fcad23
        MIN-ACCESS   read-only
Packit fcad23
        DESCRIPTION
Packit fcad23
            "Write access is not required, nor is support for the value
Packit fcad23
            testing(3)."
Packit fcad23
    ::= { ifCompliances 1 }
Packit fcad23
Packit fcad23
ifCompliance2 MODULE-COMPLIANCE
Packit fcad23
    STATUS      deprecated
Packit fcad23
    DESCRIPTION
Packit fcad23
            "A compliance statement defined in a previous version of
Packit fcad23
            this MIB module, for SNMP entities which have network
Packit fcad23
            interfaces."
Packit fcad23
Packit fcad23
    MODULE  -- this module
Packit fcad23
        MANDATORY-GROUPS { ifGeneralInformationGroup, ifStackGroup2,
Packit fcad23
                           ifCounterDiscontinuityGroup }
Packit fcad23
Packit fcad23
        GROUP       ifFixedLengthGroup
Packit fcad23
        DESCRIPTION
Packit fcad23
            "This group is mandatory for all network interfaces which
Packit fcad23
            are character-oriented or transmit data in fixed-length
Packit fcad23
            transmission units."
Packit fcad23
Packit fcad23
        GROUP       ifHCFixedLengthGroup
Packit fcad23
        DESCRIPTION
Packit fcad23
            "This group is mandatory only for those network interfaces
Packit fcad23
            which are character-oriented or transmit data in fixed-
Packit fcad23
            length transmission units, and for which the value of the
Packit fcad23
            corresponding instance of ifSpeed is greater than 20,000,000
Packit fcad23
            bits/second."
Packit fcad23
Packit fcad23
        GROUP       ifPacketGroup
Packit fcad23
        DESCRIPTION
Packit fcad23
            "This group is mandatory for all network interfaces which
Packit fcad23
            are packet-oriented."
Packit fcad23
Packit fcad23
        GROUP       ifHCPacketGroup
Packit fcad23
        DESCRIPTION
Packit fcad23
            "This group is mandatory only for those network interfaces
Packit fcad23
            which are packet-oriented and for which the value of the
Packit fcad23
            corresponding instance of ifSpeed is greater than
Packit fcad23
            650,000,000 bits/second."
Packit fcad23
Packit fcad23
        GROUP       ifRcvAddressGroup
Packit fcad23
        DESCRIPTION
Packit fcad23
            "The applicability of this group MUST be defined by the
Packit fcad23
            media-specific MIBs.  Media-specific MIBs must define the
Packit fcad23
            exact meaning, use, and semantics of the addresses in this
Packit fcad23
            group."
Packit fcad23
Packit fcad23
        OBJECT      ifLinkUpDownTrapEnable
Packit fcad23
        MIN-ACCESS  read-only
Packit fcad23
        DESCRIPTION
Packit fcad23
            "Write access is not required."
Packit fcad23
Packit fcad23
        OBJECT      ifPromiscuousMode
Packit fcad23
        MIN-ACCESS  read-only
Packit fcad23
        DESCRIPTION
Packit fcad23
            "Write access is not required."
Packit fcad23
Packit fcad23
        OBJECT      ifStackStatus
Packit fcad23
        SYNTAX      INTEGER { active(1) } -- subset of RowStatus
Packit fcad23
        MIN-ACCESS  read-only
Packit fcad23
        DESCRIPTION
Packit fcad23
            "Write access is not required, and only one of the six
Packit fcad23
            enumerated values for the RowStatus textual convention need
Packit fcad23
            be supported, specifically: active(1)."
Packit fcad23
Packit fcad23
        OBJECT       ifAdminStatus
Packit fcad23
        SYNTAX       INTEGER { up(1), down(2) }
Packit fcad23
        MIN-ACCESS   read-only
Packit fcad23
        DESCRIPTION
Packit fcad23
            "Write access is not required, nor is support for the value
Packit fcad23
            testing(3)."
Packit fcad23
Packit fcad23
        OBJECT       ifAlias
Packit fcad23
        MIN-ACCESS   read-only
Packit fcad23
        DESCRIPTION
Packit fcad23
            "Write access is not required."
Packit fcad23
    ::= { ifCompliances 2 }
Packit fcad23
Packit fcad23
END