开通博客赚积分
发布资源赚积分
分类

源码开发语言/平台
当前位置：首页 > 源码/资料 > Internet/网络编程 > SNMP编程 > 查看源码
IF-MIB
资源名称：AdventNetSNMPAPI_4.zip　[点击查看]
上传用户：aonuowh
上传日期：2021-05-23
资源大小：35390k
文件大小：64k
源码类别：

SNMP编程

开发平台：

C/C++

IF-MIB：源码内容
  1. -- *****************************************************************
  2. -- IF-MIB.my:  Interfaces MIB
  3. --
  4. -- May 1994, Jeffrey T. Johnson
  5. --
  6. -- Copyright (c) 1994 - 1996 by cisco Systems, Inc.
  7. -- All rights reserved.
  8. -- 
  9. -- *****************************************************************
  10. --
  11. --  extracted from draft-ietf-ifmib-mib-03.txt
  12. --  major differences with RFC1573 - 
  13. --    Added InterfaceIndexOrZero textual convention.
  14. --    Added notPresent state for ifOperStatus.
  15. --    Added the ifAlias, ifStackLastChange and ifTableLastChange objects.
  16. --    Corrected the MAX-ACCESS clause values for
  17. --    ifRcvAddressAddress, ifRcvAddressStatus and ifStackStatus.
  18. --
  19. -- the following modifications have been applied:
  20. -- changed "RFC-1213" to "RFC1213-MIB"
  21. -- added import of snmpTraps
  23.    IF-MIB DEFINITIONS ::= BEGIN
  25.    IMPORTS
  26.        MODULE-IDENTITY, OBJECT-TYPE, Counter32, Gauge32,
  27.        Integer32, TimeTicks, Counter64,
  28.        NOTIFICATION-TYPE                        FROM SNMPv2-SMI
  29.        TEXTUAL-CONVENTION, DisplayString,
  30.        PhysAddress, TruthValue, RowStatus,
  31.        AutonomousType, TestAndIncr              FROM SNMPv2-TC
  32.        MODULE-COMPLIANCE, OBJECT-GROUP          FROM SNMPv2-CONF
  33.        snmpTraps                                FROM SNMPv2-MIB
  34.        IANAifType                               FROM IANAifType-MIB
  35.        mib-2,interfaces                         FROM RFC1213-MIB;
  37.    ifMIB MODULE-IDENTITY
  38.        LAST-UPDATED "9602221355Z"
  39.        ORGANIZATION "IETF Interfaces MIB Working Group"
  40.        CONTACT-INFO
  42.                "   Keith McCloghrie
  43.                    Cisco Systems, Inc.
  44.                    170 West Tasman Drive
  45.                    San Jose, CA  95134-1706
  46.                    US
  48.                    408-526-5260
  49.                    kzm@cisco.com"
  50.        DESCRIPTION
  51.                "The MIB module to describe generic objects for
  52.                network interface sub-layers.  This MIB is an updated
  53.                version of MIB-II's ifTable, and incorporates the
  54.                extensions defined in RFC 1229."
  55.        REVISION      "9602282155Z"
  56.        DESCRIPTION
  57.                "Revisions made by the Interfaces MIB WG."
  58.        REVISION      "9311082155Z"
  59.        DESCRIPTION
  60.                "Initial revision, published as part of RFC 1573."
  61.        ::= { mib-2 31 }
  63.    ifMIBObjects OBJECT IDENTIFIER ::= { ifMIB 1 }
  65.    -- OwnerString has the same semantics as used in RFC 1271
  67.    OwnerString ::= TEXTUAL-CONVENTION
  68.        DISPLAY-HINT "255a"
  69.        STATUS       current
  70.        DESCRIPTION
  71.                "This data type is used to model an administratively
  72.                assigned name of the owner of a resource.  This
  73.                information is taken from the NVT ASCII character set.
  74.                It is suggested that this name contain one or more of
  75.                the following: ASCII form of the manager station's
  76.                transport address, management station name (e.g.,
  77.                domain name), network management personnel's name,
  78.                location, or phone number.  In some cases the agent
  79.                itself will be the owner of an entry.  In these cases,
  80.                this string shall be set to a string starting with
  81.                'agent'."
  82.        SYNTAX       OCTET STRING (SIZE(0..255))
  85.    -- InterfaceIndex contains the semantics of ifIndex and
  86.    -- should be used for any objects defined on other mib
  87.    -- modules that need these semantics.
  89.    InterfaceIndex ::= TEXTUAL-CONVENTION
  90.        DISPLAY-HINT "d"
  91.        STATUS       current
  92.        DESCRIPTION
  93.                "A unique value, greater than zero, for each interface
  94.                or interface sub-layer in the managed system.  It is
  95.                recommended that values are assigned contiguously
  96.                starting from 1.  The value for each interface sub-
  97.                layer must remain constant at least from one re-
  98.                initialization of the entity's network management
  99.                system to the next re-initialization."
  100.        SYNTAX       Integer32
  102.    InterfaceIndexOrZero ::= TEXTUAL-CONVENTION
  103.        DISPLAY-HINT "d"
  104.        STATUS       current
  105.        DESCRIPTION
  106.                "This textual convention is an extension of the
  107.                InterfaceIndex convention.  The latter defines a
  108.                greater than zero to identify an interface or
  109.                interface sub-layer in the managed system.  This
  110.                extension permits the additional value of zero.  the
  111.                value zero is object-specific and must therefore be
  112.                defined as part of the description of any object which
  113.                uses this syntax.  Examples of the usage of zero might
  114.                include situations where interface was unknown, or
  115.                when none or all interfaces need to be referenced."
  116.        SYNTAX       Integer32 (0..2147483647)
  118.    ifNumber  OBJECT-TYPE
  119.        SYNTAX      Integer32
  120.        MAX-ACCESS  read-only
  121.        STATUS      current
  122.        DESCRIPTION
  123.                "The number of network interfaces (regardless of their
  124.                current state) present on this system."
  125.        ::= { interfaces 1 }
  127.    ifTableLastChange  OBJECT-TYPE
  128.        SYNTAX      TimeTicks
  129.        MAX-ACCESS  read-only
  130.        STATUS      current
  131.        DESCRIPTION
  132.                "The value of sysUpTime at the time of the last
  133.                creation or deletion of an entry in the ifTable.  If
  134.                the number of entries has been unchanged since the
  135.                last re-initialization of the local network management
  136.                subsystem, then this object contains a zero value."
  137.        ::= { ifMIBObjects 5 }
  140.    -- the Interfaces table
  142.    -- The Interfaces table contains information on the entity's
  143.    -- interfaces.  Each sub-layer below the internetwork-layer
  144.    -- of a network interface is considered to be an interface.
  146.    ifTable OBJECT-TYPE
  147.        SYNTAX      SEQUENCE OF IfEntry
  148.        MAX-ACCESS  not-accessible
  149.        STATUS      current
  150.        DESCRIPTION
  151.                "A list of interface entries.  The number of entries
  152.                is given by the value of ifNumber."
  153.        ::= { interfaces 2 }
  155.    ifEntry OBJECT-TYPE
  156.        SYNTAX      IfEntry
  157.        MAX-ACCESS  not-accessible
  158.        STATUS      current
  159.        DESCRIPTION
  160.                "An entry containing management information applicable
  161.                to a particular interface."
  162.        INDEX   { ifIndex }
  163.        ::= { ifTable 1 }
  165.    IfEntry ::=
  166.        SEQUENCE {
  167.            ifIndex                 InterfaceIndex,
  168.            ifDescr                 DisplayString,
  169.            ifType                  IANAifType,
  170.            ifMtu                   Integer32,
  171.            ifSpeed                 Gauge32,
  172.            ifPhysAddress           PhysAddress,
  173.            ifAdminStatus           INTEGER,
  174.            ifOperStatus            INTEGER,
  175.            ifLastChange            TimeTicks,
  176.            ifInOctets              Counter32,
  177.            ifInUcastPkts           Counter32,
  178.            ifInNUcastPkts          Counter32,  -- deprecated
  179.            ifInDiscards            Counter32,
  180.            ifInErrors              Counter32,
  181.            ifInUnknownProtos       Counter32,
  182.            ifOutOctets             Counter32,
  183.            ifOutUcastPkts          Counter32,
  184.            ifOutNUcastPkts         Counter32,  -- deprecated
  185.            ifOutDiscards           Counter32,
  186.            ifOutErrors             Counter32,
  187.            ifOutQLen               Gauge32,    -- deprecated
  188.            ifSpecific              OBJECT IDENTIFIER -- deprecated
  189.        }
  192.    ifIndex OBJECT-TYPE
  193.        SYNTAX      InterfaceIndex
  194.        MAX-ACCESS  read-only
  195.        STATUS      current
  196.        DESCRIPTION
  197.                "A unique value, greater than zero, for each
  198.                interface.  It is recommended that values are assigned
  199.                contiguously starting from 1.  The value for each
  200.                interface sub-layer must remain constant at least from
  201.                one re-initialization of the entity's network
  202.                management system to the next re-initialization."
  203.        ::= { ifEntry 1 }
  205.    ifDescr OBJECT-TYPE
  206.        SYNTAX      DisplayString (SIZE (0..255))
  207.        MAX-ACCESS  read-only
  208.        STATUS      current
  209.        DESCRIPTION
  210.                "A textual string containing information about the
  211.                interface.  This string should include the name of the
  212.                manufacturer, the product name and the version of the
  213.                interface hardware/software."
  214.        ::= { ifEntry 2 }
  216.    ifType OBJECT-TYPE
  217.        SYNTAX      IANAifType
  218.        MAX-ACCESS  read-only
  219.        STATUS      current
  220.        DESCRIPTION
  221.                "The type of interface.  Additional values for ifType
  222.                are assigned by the Internet Assigned Numbers
  223.                Authority (IANA), through updating the syntax of the
  224.                IANAifType textual convention."
  225.        ::= { ifEntry 3 }
  227.    ifMtu OBJECT-TYPE
  228.        SYNTAX      Integer32
  229.        MAX-ACCESS  read-only
  230.        STATUS      current
  231.        DESCRIPTION
  232.                "The size of the largest packet which can be
  233.                sent/received on the interface, specified in octets.
  234.                For interfaces that are used for transmitting network
  235.                datagrams, this is the size of the largest network
  236.                datagram that can be sent on the interface."
  237.        ::= { ifEntry 4 }
  239.    ifSpeed OBJECT-TYPE
  240.        SYNTAX      Gauge32
  241.        MAX-ACCESS  read-only
  242.        STATUS      current
  243.        DESCRIPTION
  244.                "An estimate of the interface's current bandwidth in
  245.                bits per second.  For interfaces which do not vary in
  246.                bandwidth or for those where no accurate estimation
  247.                can be made, this object should contain the nominal
  248.                bandwidth.  If the bandwidth of the interface is
  249.                greater than the maximum value reportable by this
  250.                object then this object should report its maximum
  251.                value (4,294,967,295) and ifHighSpeed must be used to
  252.                report the interace's speed.  For a sub-layer which
  253.                has no concept of bandwidth, this object should be
  254.                zero."
  255.        ::= { ifEntry 5 }
  257.    ifPhysAddress OBJECT-TYPE
  258.        SYNTAX      PhysAddress
  259.        MAX-ACCESS  read-only
  260.        STATUS      current
  261.        DESCRIPTION
  262.                "The interface's address at its protocol sub-layer.
  263.                The interface's media-specific MIB must define the bit
  264.                and byte ordering and format of the value contained by
  265.                this object.  For interfaces which do not have such an
  266.                address (e.g., a serial line), this object should
  267.                contain an octet string of zero length."
  268.        ::= { ifEntry 6 }
  270.    ifAdminStatus OBJECT-TYPE
  271.        SYNTAX  INTEGER {
  272.                    up(1),       -- ready to pass packets
  273.                    down(2),
  274.                    testing(3)   -- in some test mode
  275.                }
  276.        MAX-ACCESS  read-write
  277.        STATUS      current
  278.        DESCRIPTION
  279.                "The desired state of the interface.  The testing(3)
  280.                state indicates that no operational packets can be
  281.                passed.  When a managed system initializes, all
  282.                interfaces start with ifAdminStatus in the down(2)
  283.                state.  As a result of either explicit management
  284.                action or per configuration information retained by
  285.                the managed system, ifAdminStatus is then changed to
  286.                either the up(1) or testing(3) states (or remains in
  287.                the down(2) state)."
  288.        ::= { ifEntry 7 }
  290.    ifOperStatus OBJECT-TYPE
  291.        SYNTAX  INTEGER {
  292.                    up(1),       -- ready to pass packets
  293.                    down(2),
  294.                    testing(3),  -- in some test mode
  295.                    unknown(4),  -- status can not be determined
  296.                                 -- for some reason.
  297.                    dormant(5),
  298.                    notPresent(6) -- some component is missing
  299.                }
  300.        MAX-ACCESS  read-only
  301.        STATUS      current
  302.        DESCRIPTION
  303.                "The current operational state of the interface.  The
  304.                testing(3) state indicates that no operational packets
  305.                can be passed.  If ifAdminStatus is down(2) then
  306.                ifOperStatus should be down(2).  If ifAdminStatus is
  307.                changed to up(1) then ifOperStatus should change to
  308.                up(1) if the interface is ready to transmit and
  309.                receive network traffic; it should change to
  310.                dormant(5) if the interface is waiting for external
  311.                actions (such as a serial line waiting for an
  312.                incoming connection); it should remain in the down(2)
  313.                state if and only if there is a fault that prevents if
  314.                from going to the up(1) state; it should remain in the
  315.                notPresent(6) state if the interface has missing
  316.                (typically, hardware) components."
  317.        ::= { ifEntry 8 }
  319.    ifLastChange OBJECT-TYPE
  320.        SYNTAX      TimeTicks
  321.        MAX-ACCESS  read-only
  322.        STATUS      current
  323.        DESCRIPTION
  324.                "The value of sysUpTime at the time the interface
  325.                entered its current operational state.  If the current
  326.                state was entered prior to the last re-initialization
  327.                of the local network management subsystem, then this
  328.                object contains a zero value."
  329.        ::= { ifEntry 9 }
  331.    ifInOctets OBJECT-TYPE
  332.        SYNTAX      Counter32
  333.        MAX-ACCESS  read-only
  334.        STATUS      current
  335.        DESCRIPTION
  336.                "The total number of octets received on the interface,
  337.                including framing characters."
  338.        ::= { ifEntry 10 }
  340.    ifInUcastPkts OBJECT-TYPE
  341.        SYNTAX      Counter32
  342.        MAX-ACCESS  read-only
  343.        STATUS      current
  344.        DESCRIPTION
  345.                "The number of packets, delivered by this sub-layer to
  346.                a higher (sub-)layer, which were not addressed to a
  347.                multicast or broadcast address at this sub-layer."
  348.        ::= { ifEntry 11 }
  350.    ifInNUcastPkts OBJECT-TYPE
  351.        SYNTAX  Counter32
  352.        MAX-ACCESS  read-only
  353.        STATUS      deprecated
  354.        DESCRIPTION
  355.                "The number of packets, delivered by this sub-layer to
  356.                a higher (sub-)layer, which were addressed to a
  357.                multicast or broadcast address at this sub-layer.
  358.                This object is deprecated in favor of
  359.                ifInMulticastPkts and ifInBroadcastPkts."
  360.        ::= { ifEntry 12 }
  362.    ifInDiscards OBJECT-TYPE
  363.        SYNTAX      Counter32
  364.        MAX-ACCESS  read-only
  365.        STATUS      current
  366.        DESCRIPTION
  367.                "The number of inbound packets which were chosen to be
  368.                discarded even though no errors had been detected to
  369.                prevent their being deliverable to a higher-layer
  370.                protocol.  One possible reason for discarding such a
  371.                packet could be to free up buffer space."
  372.        ::= { ifEntry 13 }
  374.    ifInErrors OBJECT-TYPE
  375.        SYNTAX      Counter32
  376.        MAX-ACCESS  read-only
  377.        STATUS      current
  378.        DESCRIPTION
  379.                "For packet-oriented interfaces, the number of inbound
  380.                packets that contained errors preventing them from
  381.                being deliverable to a higher-layer protocol.  For
  382.                character-oriented or fixed-length interfaces, the
  383.                number of inbound transmission units that contained
  384.                errors preventing them from being deliverable to a
  385.                higher-layer protocol."
  386.        ::= { ifEntry 14 }
  388.    ifInUnknownProtos OBJECT-TYPE
  389.        SYNTAX      Counter32
  390.        MAX-ACCESS  read-only
  391.        STATUS      current
  392.        DESCRIPTION
  393.                "For packet-oriented interfaces, the number of packets
  394.                received via the interface which were discarded
  395.                because of an unknown or unsupported protocol.  For
  396.                character-oriented or fixed-length interfaces which
  397.                support protocol multiplexing the number of
  398.                transmission units received via the interface which
  399.                were discarded because of an unknown or unsupported
  400.                protocol.  For any interface which does not support
  401.                protocol multiplexing, this counter will always be 0."
  402.        ::= { ifEntry 15 }
  404.    ifOutOctets OBJECT-TYPE
  405.        SYNTAX      Counter32
  406.        MAX-ACCESS  read-only
  407.        STATUS      current
  408.        DESCRIPTION
  409.                "The total number of octets transmitted out of the
  410.                interface, including framing characters."
  411.        ::= { ifEntry 16 }
  413.    ifOutUcastPkts OBJECT-TYPE
  414.        SYNTAX      Counter32
  415.        MAX-ACCESS  read-only
  416.        STATUS      current
  417.        DESCRIPTION
  419.                "The total number of packets that higher-level
  420.                protocols requested be transmitted, and which were not
  421.                addressed to a multicast or broadcast address at this
  422.                sub-layer, including those that were discarded or not
  423.                sent."
  424.        ::= { ifEntry 17 }
  426.    ifOutNUcastPkts OBJECT-TYPE
  427.        SYNTAX      Counter32
  428.        MAX-ACCESS  read-only
  429.        STATUS      deprecated
  430.        DESCRIPTION
  431.                "The total number of packets that higher-level
  432.                protocols requested be transmitted, and which were
  433.                addressed to a multicast or broadcast address at this
  434.                sub-layer, including those that were discarded or not
  435.                sent.
  437.                This object is deprecated in favour of
  438.                ifOutMulticastPkts and ifOutBroadcastPkts."
  439.        ::= { ifEntry 18 }
  441.    ifOutDiscards OBJECT-TYPE
  442.        SYNTAX      Counter32
  443.        MAX-ACCESS  read-only
  444.        STATUS      current
  445.        DESCRIPTION
  446.                "The number of outbound packets which were chosen to
  447.                be discarded even though no errors had been detected
  448.                to prevent their being transmitted.  One possible
  449.                reason for discarding such a packet could be to free
  450.                up buffer space."
  451.        ::= { ifEntry 19 }
  453.    ifOutErrors OBJECT-TYPE
  454.        SYNTAX      Counter32
  455.        MAX-ACCESS  read-only
  456.        STATUS      current
  457.        DESCRIPTION
  458.                "For packet-oriented interfaces, the number of
  459.                outbound packets that could not be transmitted because
  460.                of errors.  For character-oriented or fixed-length
  461.                interfaces, the number of outbound transmission units
  462.                that could not be transmitted because of errors."
  463.        ::= { ifEntry 20 }
  465.    ifOutQLen OBJECT-TYPE
  466.        SYNTAX      Gauge32
  467.        MAX-ACCESS  read-only
  468.        STATUS      deprecated
  469.        DESCRIPTION
  470.                "The length of the output packet queue (in packets)."
  471.        ::= { ifEntry 21 }
  473.    ifSpecific OBJECT-TYPE
  474.        SYNTAX      OBJECT IDENTIFIER
  475.        MAX-ACCESS  read-only
  476.        STATUS      deprecated
  477.        DESCRIPTION
  478.                "A reference to MIB definitions specific to the
  479.                particular media being used to realize the interface.
  480.                It is recommended that this value point to an instance
  481.                of a MIB object in the media-specific MIB, i.e., that
  482.                this object have the semantics associated with the
  483.                InstancePointer textual convention defined in RFC
  484.                1443.  In fact, it is recommended that the media-
  485.                specific MIB specify what value ifSpecific should/can
  486.                take for values of ifType.  If no MIB definitions
  487.                specific to the particular media are available, the
  488.                value should be set to the OBJECT IDENTIFIER { 0 0 }."
  489.        ::= { ifEntry 22 }
  492.    --
  493.    --   Extension to the interface table
  494.    --
  495.    -- This table replaces the ifExtnsTable table.
  496.    --
  498.    ifXTable        OBJECT-TYPE
  499.        SYNTAX      SEQUENCE OF IfXEntry
  500.        MAX-ACCESS  not-accessible
  501.        STATUS      current
  502.        DESCRIPTION
  503.                "A list of interface entries.  The number of entries
  504.                is given by the value of ifNumber.  This table
  505.                contains additional objects for the interface table."
  506.        ::= { ifMIBObjects 1 }
  508.    ifXEntry        OBJECT-TYPE
  509.        SYNTAX      IfXEntry
  510.        MAX-ACCESS  not-accessible
  511.        STATUS      current
  512.        DESCRIPTION
  513.                "An entry containing additional management information
  514.                applicable to a particular interface."
  515.        AUGMENTS    { ifEntry }
  516.        ::= { ifXTable 1 }
  518.    IfXEntry ::=
  519.        SEQUENCE {
  520.            ifName                  DisplayString,
  521.            ifInMulticastPkts       Counter32,
  522.            ifInBroadcastPkts       Counter32,
  523.            ifOutMulticastPkts      Counter32,
  524.            ifOutBroadcastPkts      Counter32,
  525.            ifHCInOctets            Counter64,
  526.            ifHCInUcastPkts         Counter64,
  527.            ifHCInMulticastPkts     Counter64,
  528.            ifHCInBroadcastPkts     Counter64,
  529.            ifHCOutOctets           Counter64,
  530.            ifHCOutUcastPkts        Counter64,
  531.            ifHCOutMulticastPkts    Counter64,
  532.            ifHCOutBroadcastPkts    Counter64,
  533.            ifLinkUpDownTrapEnable  INTEGER,
  534.            ifHighSpeed             Gauge32,
  535.            ifPromiscuousMode       TruthValue,
  536.            ifConnectorPresent      TruthValue,
  537.            ifAlias                 DisplayString
  538.        }
  541.    ifName OBJECT-TYPE
  542.        SYNTAX      DisplayString
  543.        MAX-ACCESS  read-only
  544.        STATUS      current
  545.        DESCRIPTION
  546.                "The textual name of the interface.  The value of this
  547.                object should be the name of the interface as assigned
  548.                by the local device and should be suitable for use in
  549.                commands entered at the device's `console'.  This
  550.                might be a text name, such as `le0' or a simple port
  551.                number, such as `1', depending on the interface naming
  552.                syntax of the device.  If several entries in the
  553.                ifTable together represent a single interface as named
  554.                by the device, then each will have the same value of
  555.                ifName.  If there is no local name, or this object is
  556.                otherwise not applicable, then this object contains a
  557.                0-length string."
  558.        ::= { ifXEntry 1 }
  560.    ifInMulticastPkts OBJECT-TYPE
  561.        SYNTAX      Counter32
  562.        MAX-ACCESS  read-only
  563.        STATUS      current
  564.        DESCRIPTION
  565.                "The number of packets, delivered by this sub-layer to
  566.                a higher (sub-)layer, which were addressed to a
  567.                multicast address at this sub-layer.  For a MAC layer
  568.                protocol, this includes both Group and Functional
  569.                addresses."
  570.        ::= { ifXEntry 2 }
  572.    ifInBroadcastPkts OBJECT-TYPE
  573.        SYNTAX      Counter32
  574.        MAX-ACCESS  read-only
  575.        STATUS      current
  576.        DESCRIPTION
  577.                "The number of packets, delivered by this sub-layer to
  578.                a higher (sub-)layer, which were addressed to a
  579.                broadcast address at this sub-layer."
  580.        ::= { ifXEntry 3 }
  582.    ifOutMulticastPkts OBJECT-TYPE
  583.        SYNTAX      Counter32
  584.        MAX-ACCESS  read-only
  585.        STATUS      current
  586.        DESCRIPTION
  587.                "The total number of packets that higher-level
  588.                protocols requested be transmitted, and which were
  589.                addressed to a multicast address at this sub-layer,
  590.                including those that were discarded or not sent.  For
  591.                a MAC layer protocol, this includes both Group and
  592.                Functional addresses."
  593.        ::= { ifXEntry 4 }
  595.    ifOutBroadcastPkts OBJECT-TYPE
  596.        SYNTAX      Counter32
  597.        MAX-ACCESS  read-only
  598.        STATUS      current
  599.        DESCRIPTION
  600.                "The total number of packets that higher-level
  601.                protocols requested be transmitted, and which were
  602.                addressed to a broadcast address at this sub-layer,
  603.                including those that were discarded or not sent."
  604.        ::= { ifXEntry 5 }
  606.    --
  607.    -- High Capacity Counter objects.  These objects are all
  609.    -- 64 bit versions of the "basic" ifTable counters.  These
  610.    -- objects all have the same basic semantics as their 32-bit
  611.    -- counterparts, however, their syntax has been extended
  612.    -- to 64 bits.
  613.    --
  615.    ifHCInOctets OBJECT-TYPE
  616.        SYNTAX      Counter64
  617.        MAX-ACCESS  read-only
  618.        STATUS      current
  619.        DESCRIPTION
  620.                "The total number of octets received on the interface,
  621.                including framing characters.  This object is a 64-bit
  622.                version of ifInOctets."
  623.        ::= { ifXEntry 6 }
  625.    ifHCInUcastPkts OBJECT-TYPE
  626.        SYNTAX      Counter64
  627.        MAX-ACCESS  read-only
  628.        STATUS      current
  629.        DESCRIPTION
  630.                "The number of packets, delivered by this sub-layer to
  631.                a higher (sub-)layer, which were not addressed to a
  632.                multicast or broadcast address at this sub-layer.
  633.                This object is a 64-bit version of ifInUcastPkts."
  634.        ::= { ifXEntry 7 }
  636.    ifHCInMulticastPkts OBJECT-TYPE
  637.        SYNTAX      Counter64
  638.        MAX-ACCESS  read-only
  639.        STATUS      current
  640.        DESCRIPTION
  641.                "The number of packets, delivered by this sub-layer to
  642.                a higher (sub-)layer, which were addressed to a
  643.                multicast address at this sub-layer.  For a MAC layer
  644.                protocol, this includes both Group and Functional
  645.                addresses.  This object is a 64-bit version of
  646.                ifInMulticastPkts."
  647.        ::= { ifXEntry 8 }
  649.    ifHCInBroadcastPkts OBJECT-TYPE
  650.        SYNTAX      Counter64
  651.        MAX-ACCESS  read-only
  652.        STATUS      current
  653.        DESCRIPTION
  654.                "The number of packets, delivered by this sub-layer to
  655.                a higher (sub-)layer, which were addressed to a
  656.                broadcast address at this sub-layer.  This object is a
  657.                64-bit version of ifInBroadcastPkts."
  658.        ::= { ifXEntry 9 }
  660.    ifHCOutOctets OBJECT-TYPE
  661.        SYNTAX      Counter64
  662.        MAX-ACCESS  read-only
  663.        STATUS      current
  664.        DESCRIPTION
  665.                "The total number of octets transmitted out of the
  666.                interface, including framing characters.  This object
  667.                is a 64-bit version of ifOutOctets."
  668.        ::= { ifXEntry 10 }
  670.    ifHCOutUcastPkts OBJECT-TYPE
  671.        SYNTAX      Counter64
  672.        MAX-ACCESS  read-only
  673.        STATUS      current
  674.        DESCRIPTION
  675.                "The total number of packets that higher-level
  676.                protocols requested be transmitted, and which were not
  677.                addressed to a multicast or broadcast address at this
  678.                sub-layer, including those that were discarded or not
  679.                sent.  This object is a 64-bit version of
  680.                ifOutUcastPkts."
  681.        ::= { ifXEntry 11 }
  683.    ifHCOutMulticastPkts OBJECT-TYPE
  684.        SYNTAX      Counter64
  685.        MAX-ACCESS  read-only
  686.        STATUS      current
  687.        DESCRIPTION
  688.                "The total number of packets that higher-level
  689.                protocols requested be transmitted, and which were
  690.                addressed to a multicast address at this sub-layer,
  691.                including those that were discarded or not sent.  For
  692.                a MAC layer protocol, this includes both Group and
  693.                Functional addresses.  This object is a 64-bit version
  694.                of ifOutMulticastPkts."
  695.        ::= { ifXEntry 12 }
  697.    ifHCOutBroadcastPkts OBJECT-TYPE
  698.        SYNTAX      Counter64
  699.        MAX-ACCESS  read-only
  700.        STATUS      current
  701.        DESCRIPTION
  702.                "The total number of packets that higher-level
  703.                protocols requested be transmitted, and which were
  704.                addressed to a broadcast address at this sub-layer,
  705.                including those that were discarded or not sent.  This
  706.                object is a 64-bit version of ifOutBroadcastPkts."
  707.        ::= { ifXEntry 13 }
  709.    ifLinkUpDownTrapEnable  OBJECT-TYPE
  710.        SYNTAX      INTEGER { enabled(1), disabled(2) }
  711.        MAX-ACCESS  read-write
  712.        STATUS      current
  713.        DESCRIPTION
  714.                "Indicates whether linkUp/linkDown traps should be
  715.                generated for this interface.
  717.                By default, this object should have the value
  718.                enabled(1) for interfaces which do not operate on
  719.                'top' of any other interface (as defined in the
  720.                ifStackTable), and disabled(2) otherwise."
  721.        ::= { ifXEntry 14 }
  723.    ifHighSpeed OBJECT-TYPE
  724.        SYNTAX      Gauge32
  725.        MAX-ACCESS  read-only
  726.        STATUS      current
  727.        DESCRIPTION
  728.                "An estimate of the interface's current bandwidth in
  729.                units of 1,000,000 bits per second.  If this object
  730.                reports a value of `n' then the speed of the interface
  731.                is somewhere in the range of `n-500,000' to
  732.                `n+499,999'.  For interfaces which do not vary in
  733.                bandwidth or for those where no accurate estimation
  734.                can be made, this object should contain the nominal
  735.                bandwidth.  For a sub-layer which has no concept of
  736.                bandwidth, this object should be zero."
  737.        ::= { ifXEntry 15 }
  739.    ifPromiscuousMode  OBJECT-TYPE
  740.        SYNTAX      TruthValue
  741.        MAX-ACCESS  read-write
  742.        STATUS      current
  743.        DESCRIPTION
  744.                "This object has a value of false(2) if this interface
  745.                only accepts packets/frames that are addressed to this
  746.                station.  This object has a value of true(1) when the
  747.                station accepts all packets/frames transmitted on the
  748.                media.  The value true(1) is only legal on certain
  749.                types of media.  If legal, setting this object to a
  750.                value of true(1) may require the interface to be reset
  751.                before becoming effective.
  753.                The value of ifPromiscuousMode does not affect the
  754.                reception of broadcast and multicast packets/frames by
  755.                the interface."
  756.        ::= { ifXEntry 16 }
  758.    ifConnectorPresent   OBJECT-TYPE
  759.        SYNTAX      TruthValue
  760.        MAX-ACCESS  read-only
  761.        STATUS      current
  762.        DESCRIPTION
  763.                "This object has the value 'true(1)' if the interface
  764.                sublayer has a physical connector and the value
  765.                'false(2)' otherwise."
  766.        ::= { ifXEntry 17 }
  768.    ifAlias   OBJECT-TYPE
  769.        SYNTAX      DisplayString (SIZE(0..64))
  770.        MAX-ACCESS  read-write
  771.        STATUS      current
  772.        DESCRIPTION
  773.                "This object is an 'alias' name for the interface as
  774.                specified by a network manager, and provides a non-
  775.                volatile 'handle' for the interface.
  777.                On the first instantiation of an interface, the value
  778.                of ifAlias associated with that interface is the
  779.                zero-length string.  As and when a value is written
  780.                into an instance of ifAlias through a network
  781.                management set operation, then the agent must retain
  782.                the supplied value in the ifAlias instance associated
  783.                with the same interface for as long as that interface
  784.                remains instantiated, including across all re-
  785.                initializations/reboots of the network management
  786.                system, including those which result in a change of
  787.                the interface's ifIndex value.
  789.                An example of the value which a network manager might
  790.                store in this object for a WAN interface is the
  791.                (Telco's) circuit number/identifier of the interface.
  793.                Some agents may support write-access only for
  794.                interfaces having particular values of ifType.  An
  795.                agent which supports write access to this object is
  796.                required to keep the value in non-volatile storage,
  797.                but it may limit the length of new values depending on
  798.                how much storage is already occupied by the current
  799.                values for other interfaces."
  800.        ::= { ifXEntry 18 }
  803.    --           The Interface Stack Group
  804.    --
  805.    -- Implementation of this group is mandatory for all systems
  806.    --
  808.    ifStackTable  OBJECT-TYPE
  809.         SYNTAX        SEQUENCE OF IfStackEntry
  810.         MAX-ACCESS    not-accessible
  811.         STATUS        current
  812.         DESCRIPTION
  813.                "The table containing information on the relationships
  814.                between the multiple sub-layers of network interfaces.
  815.                In particular, it contains information on which sub-
  816.                layers run 'on top of' which other sub-layers.  Each
  817.                sub-layer corresponds to a conceptual row in the
  818.                ifTable."
  819.         ::= { ifMIBObjects 2 }
  822.    ifStackEntry  OBJECT-TYPE
  823.         SYNTAX        IfStackEntry
  824.         MAX-ACCESS    not-accessible
  825.         STATUS        current
  826.         DESCRIPTION
  827.                "Information on a particular relationship between two
  828.                sub-layers, specifying that one sub-layer runs on
  829.                'top' of the other sub-layer.  Each sub-layer
  830.                corresponds to a conceptual row in the ifTable."
  831.         INDEX { ifStackHigherLayer, ifStackLowerLayer }
  832.         ::= { ifStackTable 1 }
  835.    IfStackEntry ::=
  836.        SEQUENCE {
  837.            ifStackHigherLayer  Integer32,
  838.            ifStackLowerLayer   Integer32,
  839.            ifStackStatus       RowStatus
  840.         }
  843.    ifStackHigherLayer  OBJECT-TYPE
  844.         SYNTAX        Integer32
  845.         MAX-ACCESS    not-accessible
  846.         STATUS        current
  847.         DESCRIPTION
  848.                "The value of ifIndex corresponding to the higher
  849.                sub-layer of the relationship, i.e., the sub-layer
  850.                which runs on 'top' of the sub-layer identified by the
  851.                corresponding instance of ifStackLowerLayer.  If there
  852.                is no higher sub-layer (below the internetwork layer),
  853.                then this object has the value 0."
  854.         ::= { ifStackEntry 1 }
  857.    ifStackLowerLayer  OBJECT-TYPE
  858.         SYNTAX        Integer32
  859.         MAX-ACCESS    not-accessible
  860.         STATUS        current
  861.         DESCRIPTION
  862.                "The value of ifIndex corresponding to the lower sub-
  863.                layer of the relationship, i.e., the sub-layer which
  864.                runs 'below' the sub-layer identified by the
  865.                corresponding instance of ifStackHigherLayer.  If
  866.                there is no lower sub-layer, then this object has the
  867.                value 0."
  868.         ::= { ifStackEntry 2 }
  871.    ifStackStatus  OBJECT-TYPE
  872.        SYNTAX         RowStatus
  873.        MAX-ACCESS     read-create
  874.        STATUS         current
  875.        DESCRIPTION
  876.                "The status of the relationship between two sub-
  877.                layers.
  879.                Changing the value of this object from 'active' to
  880.                'notInService' or 'destroy' will likely have
  881.                consequences up and down the interface stack.  Thus,
  882.                write access to this object is likely to be
  883.                inappropriate for some types of interfaces, and many
  884.                implementations will choose not to support write-
  885.                access for any type of interface."
  886.        ::= { ifStackEntry 3 }
  888. ifStackLastChange OBJECT-TYPE
  889.     SYNTAX         TimeTicks
  890.     MAX-ACCESS     read-only
  891.     STATUS         current
  892.     DESCRIPTION
  893.             "The value of sysUpTime at the time of the last change
  894.             of the (whole) interface stack.  A change of the
  895.             interface stack is defined to be any creation,
  896.             deletion, or change in value of any instance of
  897.             ifStackStatus.  If the interface stack has been
  898.             unchanged since the last re-initialization of the
  899.             local network management subsystem, then this object
  900.             contains a zero value."
  901.     ::= { ifMIBObjects 6 }
  904.    --
  905.    --    The Interface Test Table
  906.    --
  907.    -- This group of objects is optional.  However, a media-specific
  908.    -- MIB may make implementation of this group mandatory.
  909.    --
  910.    -- This table replaces the ifExtnsTestTable
  911.    --
  913.    ifTestTable   OBJECT-TYPE
  914.        SYNTAX      SEQUENCE OF IfTestEntry
  915.        MAX-ACCESS  not-accessible
  916.        STATUS      deprecated
  917.        DESCRIPTION
  918.                "This table contains one entry per interface.  It
  919.                defines objects which allow a network manager to
  920.                instruct an agent to test an interface for various
  921.                faults.  Tests for an interface are defined in the
  922.                media-specific MIB for that interface.  After invoking
  923.                a test, the object ifTestResult can be read to
  924.                determine the outcome.  If an agent can not perform
  925.                the test, ifTestResult is set to so indicate.  The
  926.                object ifTestCode can be used to provide further
  927.                test-specific or interface-specific (or even
  928.                enterprise-specific) information concerning the
  929.                outcome of the test.  Only one test can be in progress
  930.                on each interface at any one time.  If one test is in
  931.                progress when another test is invoked, the second test
  932.                is rejected.  Some agents may reject a test when a
  933.                prior test is active on another interface.
  934.                Before starting a test, a manager-station must first
  935.                obtain 'ownership' of the entry in the ifTestTable for
  936.                the interface to be tested.  This is accomplished with
  937.                the ifTestId and ifTestStatus objects as follows:
  939.             try_again:
  940.                 get (ifTestId, ifTestStatus)
  941.                 while (ifTestStatus != notInUse)
  942.                     /*
  943.                      * Loop while a test is running or some other
  944.                      * manager is configuring a test.
  945.                      */
  946.                     short delay
  947.                     get (ifTestId, ifTestStatus)
  948.                 }
  950.                 /*
  951.                  * Is not being used right now -- let's compete
  952.                  * to see who gets it.
  953.                  */
  954.                 lock_value = ifTestId
  956.                 if ( set(ifTestId = lock_value, ifTestStatus = inUse,
  957.                          ifTestOwner = 'my-IP-address') == FAILURE)
  958.                     /*
  959.                      * Another manager got the ifTestEntry -- go
  960.                      * try again
  961.                      */
  962.                     goto try_again;
  964.                 /*
  965.                  * I have the lock
  966.                  */
  967.                 set up any test parameters.
  969.                 /*
  970.                  * This starts the test
  971.                  */
  972.                 set(ifTestType = test_to_run);
  974.                 wait for test completion by polling ifTestResult
  976.                 when test completes, agent sets ifTestResult
  977.                      agent also sets ifTestStatus = 'notInUse'
  979.                 retrieve any additional test results, and ifTestId
  981.                 if (ifTestId == lock_value+1) results are valid
  983.               A manager station first retrieves the value of the
  984.               appropriate ifTestId and ifTestStatus objects,
  985.               periodically repeating the retrieval if necessary,
  986.               until the value of ifTestStatus is 'notInUse'.  The
  987.               manager station then tries to set the same ifTestId
  988.               object to the value it just retrieved, the same
  989.               ifTestStatus object to 'inUse', and the corresponding
  990.               ifTestOwner object to a value indicating itself.  If
  991.               the set operation succeeds then the manager has
  992.               obtained ownership of the ifTestEntry, and the value of
  993.               the ifTestId object is incremented by the agent (per
  994.               the semantics of TestAndIncr).  Failure of the set
  995.               operation indicates that some other manager has
  996.               obtained ownership of the ifTestEntry.
  998.               Once ownership is obtained, any test parameters can be
  999.               setup, and then the test is initiated by setting
  1000.               ifTestType.  On completion of the test, the agent sets
  1001.               ifTestStatus to 'notInUse'.  Once this occurs, the
  1002.               manager can retrieve the results.  In the (rare) event
  1003.               that the invocation of tests by two network managers
  1004.               were to overlap, then there would be a possibility that
  1005.               the first test's results might be overwritten by the
  1006.               second test's results prior to the first results being
  1007.               read.  This unlikely circumstance can be detected by a
  1008.               network manager retrieving ifTestId at the same time as
  1009.               retrieving the test results, and ensuring that the
  1010.               results are for the desired request.
  1012.               If ifTestType is not set within an abnormally long
  1013.               period of time after ownership is obtained, the agent
  1014.               should time-out the manager, and reset the value of the
  1015.               ifTestStatus object back to 'notInUse'.  It is
  1016.               suggested that this time-out period be 5 minutes.
  1018.               In general, a management station must not retransmit a
  1019.               request to invoke a test for which it does not receive
  1020.               a response; instead, it properly inspects an agent's
  1021.               MIB to determine if the invocation was successful.
  1022.               Only if the invocation was unsuccessful, is the
  1023.               invocation request retransmitted.
  1025.               Some tests may require the interface to be taken off-
  1026.               line in order to execute them, or may even require the
  1027.               agent to reboot after completion of the test.  In these
  1028.               circumstances, communication with the management
  1029.               station invoking the test may be lost until after
  1030.               completion of the test.  An agent is not required to
  1031.               support such tests.  However, if such tests are
  1032.               supported, then the agent should make every effort to
  1033.               transmit a response to the request which invoked the
  1034.               test prior to losing communication.  When the agent is
  1035.               restored to normal service, the results of the test are
  1036.               properly made available in the appropriate objects.
  1037.               Note that this requires that the ifIndex value assigned
  1038.               to an interface must be unchanged even if the test
  1039.               causes a reboot.  An agent must reject any test for
  1040.               which it cannot, perhaps due to resource constraints,
  1041.               make available at least the minimum amount of
  1042.               information after that test completes."
  1043.        ::= { ifMIBObjects 3 }
  1045.    ifTestEntry OBJECT-TYPE
  1046.        SYNTAX       IfTestEntry
  1047.        MAX-ACCESS   not-accessible
  1048.        STATUS       deprecated
  1049.        DESCRIPTION
  1050.                "An entry containing objects for invoking tests on an
  1051.                interface."
  1052.        AUGMENTS  { ifEntry }
  1053.        ::= { ifTestTable 1 }
  1055.    IfTestEntry ::=
  1056.        SEQUENCE {
  1057.            ifTestId           TestAndIncr,
  1058.            ifTestStatus       INTEGER,
  1059.            ifTestType         AutonomousType,
  1060.            ifTestResult       INTEGER,
  1061.            ifTestCode         OBJECT IDENTIFIER,
  1062.            ifTestOwner        OwnerString
  1063.        }
  1065.    ifTestId         OBJECT-TYPE
  1066.        SYNTAX       TestAndIncr
  1067.        MAX-ACCESS   read-write
  1068.        STATUS      deprecated
  1069.        DESCRIPTION
  1070.                "This object identifies the current invocation of the
  1071.                interface's test."
  1072.        ::= { ifTestEntry 1 }
  1074.    ifTestStatus     OBJECT-TYPE
  1075.        SYNTAX       INTEGER { notInUse(1), inUse(2) }
  1076.        MAX-ACCESS   read-write
  1077.        STATUS      deprecated
  1078.        DESCRIPTION
  1079.                "This object indicates whether or not some manager
  1080.                currently has the necessary 'ownership' required to
  1081.                invoke a test on this interface.  A write to this
  1082.                object is only successful when it changes its value
  1083.                from 'notInUse(1)' to 'inUse(2)'.  After completion of
  1084.                a test, the agent resets the value back to
  1085.                'notInUse(1)'."
  1086.        ::= { ifTestEntry 2 }
  1088.    ifTestType       OBJECT-TYPE
  1089.        SYNTAX       AutonomousType
  1090.        MAX-ACCESS   read-write
  1091.        STATUS      deprecated
  1092.        DESCRIPTION
  1093.                "A control variable used to start and stop operator-
  1094.                initiated interface tests.  Most OBJECT IDENTIFIER
  1095.                values assigned to tests are defined elsewhere, in
  1096.                association with specific types of interface.
  1097.                However, this document assigns a value for a full-
  1098.                duplex loopback test, and defines the special meanings
  1099.                of the subject identifier:
  1101.                    noTest  OBJECT IDENTIFIER ::= { 0 0 }
  1103.                When the value noTest is written to this object, no
  1104.                action is taken unless a test is in progress, in which
  1105.                case the test is aborted.  Writing any other value to
  1106.                this object is only valid when no test is currently in
  1107.                progress, in which case the indicated test is
  1108.                initiated.
  1110.                When read, this object always returns the most recent
  1111.                value that ifTestType was set to.  If it has not been
  1112.                set since the last initialization of the network
  1113.                management subsystem on the agent, a value of noTest
  1114.                is returned."
  1115.        ::= { ifTestEntry 3 }
  1117.    ifTestResult  OBJECT-TYPE
  1118.        SYNTAX       INTEGER {
  1119.                         none(1),          -- no test yet requested
  1120.                         success(2),
  1121.                         inProgress(3),
  1122.                         notSupported(4),
  1123.                         unAbleToRun(5),   -- due to state of system
  1124.                         aborted(6),
  1125.                         failed(7)
  1126.                     }
  1127.        MAX-ACCESS   read-only
  1128.        STATUS      deprecated
  1129.        DESCRIPTION
  1130.                "This object contains the result of the most recently
  1131.                requested test, or the value none(1) if no tests have
  1132.                been requested since the last reset.  Note that this
  1133.                facility provides no provision for saving the results
  1134.                of one test when starting another, as could be
  1135.                required if used by multiple managers concurrently."
  1136.        ::= { ifTestEntry 4 }
  1138.    ifTestCode  OBJECT-TYPE
  1139.        SYNTAX       OBJECT IDENTIFIER
  1140.        MAX-ACCESS   read-only
  1141.        STATUS      deprecated
  1142.        DESCRIPTION
  1143.                "This object contains a code which contains more
  1144.                specific information on the test result, for example
  1145.                an error-code after a failed test.  Error codes and
  1146.                other values this object may take are specific to the
  1147.                type of interface and/or test.  The value may have the
  1148.                semantics of either the AutonomousType or
  1149.                InstancePointer textual conventions as defined in RFC
  1150.                1443.  The identifier:
  1152.                    testCodeUnknown  OBJECT IDENTIFIER ::= { 0 0 }
  1154.                is defined for use if no additional result code is
  1155.                available."
  1156.        ::= { ifTestEntry 5 }
  1158.    ifTestOwner      OBJECT-TYPE
  1159.        SYNTAX       OwnerString
  1160.        MAX-ACCESS   read-write
  1161.        STATUS      deprecated
  1162.        DESCRIPTION
  1163.                "The entity which currently has the 'ownership'
  1164.                required to invoke a test on this interface."
  1165.        ::= { ifTestEntry 6 }
  1168.    --   Generic Receive Address Table
  1169.    --
  1170.    -- This group of objects is mandatory for all types of
  1171.    -- interfaces which can receive packets/frames addressed to
  1172.    -- more than one address.
  1173.    --
  1174.    -- This table replaces the ifExtnsRcvAddr table.  The main
  1175.    -- difference is that this table makes use of the RowStatus
  1176.    -- textual convention, while ifExtnsRcvAddr did not.
  1178.    ifRcvAddressTable  OBJECT-TYPE
  1179.        SYNTAX      SEQUENCE OF IfRcvAddressEntry
  1180.        MAX-ACCESS  not-accessible
  1181.        STATUS      current
  1182.        DESCRIPTION
  1183.                "This table contains an entry for each address
  1184.                (broadcast, multicast, or uni-cast) for which the
  1185.                system will receive packets/frames on a particular
  1186.                interface, except as follows:
  1188.                - for an interface operating in promiscuous mode,
  1189.                entries are only required for those addresses for
  1190.                which the system would receive frames were it not
  1191.                operating in promiscuous mode.
  1193.                - for 802.5 functional addresses, only one entry is
  1194.                required, for the address which has the functional
  1195.                address bit ANDed with the bit mask of all functional
  1196.                addresses for which the interface will accept frames."
  1197.        ::= { ifMIBObjects 4 }
  1199.    ifRcvAddressEntry  OBJECT-TYPE
  1200.        SYNTAX      IfRcvAddressEntry
  1201.        MAX-ACCESS  not-accessible
  1202.        STATUS      current
  1203.        DESCRIPTION
  1204.                "A list of objects identifying an address for which
  1205.                the system will accept packets/frames on the
  1206.                particular interface identified by the index value
  1207.                ifIndex."
  1208.        INDEX  { ifIndex, ifRcvAddressAddress }
  1209.        ::= { ifRcvAddressTable 1 }
  1211.    IfRcvAddressEntry ::=
  1212.        SEQUENCE {
  1213.            ifRcvAddressAddress   PhysAddress,
  1214.            ifRcvAddressStatus    RowStatus,
  1215.            ifRcvAddressType      INTEGER
  1216.        }
  1218.    ifRcvAddressAddress OBJECT-TYPE
  1219.        SYNTAX      PhysAddress
  1220.        MAX-ACCESS  not-accessible
  1221.        STATUS      current
  1222.        DESCRIPTION
  1223.                "An address for which the system will accept
  1224.                packets/frames on this entry's interface."
  1225.        ::= { ifRcvAddressEntry 1 }
  1227.    ifRcvAddressStatus OBJECT-TYPE
  1228.        SYNTAX      RowStatus
  1229.        MAX-ACCESS  read-create
  1230.        STATUS      current
  1231.        DESCRIPTION
  1232.                "This object is used to create and delete rows in the
  1233.                ifRcvAddressTable."
  1235.        ::= { ifRcvAddressEntry 2 }
  1237.    ifRcvAddressType OBJECT-TYPE
  1238.        SYNTAX      INTEGER {
  1239.                        other(1),
  1240.                        volatile(2),
  1241.                        nonVolatile(3)
  1242.                    }
  1244.        MAX-ACCESS  read-create
  1245.        STATUS      current
  1246.        DESCRIPTION
  1247.                "This object has the value nonVolatile(3) for those
  1248.                entries in the table which are valid and will not be
  1249.                deleted by the next restart of the managed system.
  1250.                Entries having the value volatile(2) are valid and
  1251.                exist, but have not been saved, so that will not exist
  1252.                after the next restart of the managed system.  Entries
  1253.                having the value other(1) are valid and exist but are
  1254.                not classified as to whether they will continue to
  1255.                exist after the next restart."
  1257.        DEFVAL  { volatile }
  1259.        ::= { ifRcvAddressEntry 3 }
  1262.    -- definition of interface-related traps.
  1264.    linkDown NOTIFICATION-TYPE
  1265.        OBJECTS { ifIndex, ifAdminStatus, ifOperStatus }
  1266.        STATUS  current
  1267.        DESCRIPTION
  1268.                "A linkDown trap signifies that the SNMPv2 entity,
  1269.                acting in an agent role, has detected that the
  1270.                ifOperStatus object for one of its communication links
  1271.                is about to transition into the down state."
  1272.        ::= { snmpTraps 3 }
  1274.    linkUp NOTIFICATION-TYPE
  1275.        OBJECTS { ifIndex, ifAdminStatus, ifOperStatus }
  1276.        STATUS  current
  1277.        DESCRIPTION
  1278.                "A linkUp trap signifies that the SNMPv2 entity,
  1279.                acting in an agent role, has detected that the
  1280.                ifOperStatus object for one of its communication links
  1281.                has transitioned out of the down state."
  1282.        ::= { snmpTraps 4 }
  1285.    -- conformance information
  1287.    ifConformance OBJECT IDENTIFIER ::= { ifMIB 2 }
  1289.    ifGroups      OBJECT IDENTIFIER ::= { ifConformance 1 }
  1290.    ifCompliances OBJECT IDENTIFIER ::= { ifConformance 2 }
  1293.    -- compliance statements
  1295.    ifCompliance2 MODULE-COMPLIANCE
  1296.        STATUS  current
  1297.        DESCRIPTION
  1298.                "The compliance statement for SNMPv2 entities which
  1299.                have network interfaces."
  1301.        MODULE  -- this module
  1302.            MANDATORY-GROUPS { ifGeneralInformationGroup, ifStackGroup2 }
  1303.    
  1304.            GROUP       ifFixedLengthGroup
  1305.            DESCRIPTION
  1306.                "This group is mandatory for all network interfaces
  1307.                which are character-oriented or transmit data in
  1308.                fixed-length transmission units."
  1310.            GROUP       ifHCFixedLengthGroup
  1311.            DESCRIPTION
  1312.                "This group is mandatory only for those network
  1313.                interfaces which are character-oriented or transmit
  1314.                data in fixed-length transmission units, and for which
  1315.                the value of the corresponding instance of ifSpeed is
  1316.                greater than 20,000,000 bits/second."
  1318.            GROUP       ifPacketGroup
  1319.            DESCRIPTION
  1320.                "This group is mandatory for all network interfaces
  1321.                which are packet-oriented."
  1323.            GROUP       ifHCPacketGroup
  1324.            DESCRIPTION
  1325.                "This group is mandatory only for those network
  1326.                interfaces which are packet-oriented and for which the
  1327.                value of the corresponding instance of ifSpeed is
  1328.                greater than 650,000,000 bits/second."
  1330.            GROUP       ifRcvAddressGroup
  1331.            DESCRIPTION
  1332.                "The applicability of this group MUST be defined by
  1333.                the media-specific MIBs.  Media-specific MIBs must
  1334.                define the exact meaning, use, and semantics of the
  1335.                addresses in this group."
  1337.            OBJECT      ifLinkUpDownTrapEnable
  1338.            MIN-ACCESS  read-only
  1339.            DESCRIPTION
  1340.                "Write access is not required."
  1342.            OBJECT      ifPromiscuousMode
  1343.            MIN-ACCESS  read-only
  1344.            DESCRIPTION
  1345.                "Write access is not required."
  1347.            OBJECT      ifStackStatus
  1348.            SYNTAX      INTEGER { active(1) } -- subset of RowStatus
  1349.            MIN-ACCESS  read-only
  1350.            DESCRIPTION
  1351.                "Write access is not required, and only one of the six
  1352.                enumerated values for the RowStatus textual convention
  1353.                need be supported, specifically: active(1)."
  1355.            OBJECT       ifAdminStatus
  1356.            SYNTAX       INTEGER { up(1), down(2) }
  1357.            MIN-ACCESS   read-only
  1358.            DESCRIPTION
  1359.                "Write access is not required, nor is support for the
  1360.                value testing(3)."
  1362.            OBJECT       ifAlias
  1363.            MIN-ACCESS   read-only
  1364.            DESCRIPTION
  1365.                "Write access is not required."
  1367.        ::= { ifCompliances 2 }
  1369.    ifCompliance MODULE-COMPLIANCE
  1370.        STATUS  obsolete
  1371.        DESCRIPTION
  1372.                "The compliance statement for SNMPv2 entities which
  1373.                have network interfaces."
  1375.        MODULE  -- this module
  1376.            MANDATORY-GROUPS { ifGeneralGroup, ifStackGroup }
  1378.            GROUP       ifFixedLengthGroup
  1379.            DESCRIPTION
  1380.                "This group is mandatory for all network interfaces
  1381.                which are character-oriented or transmit data in
  1382.                fixed-length transmission units."
  1384.            GROUP       ifHCFixedLengthGroup
  1385.            DESCRIPTION
  1386.                "This group is mandatory only for those network
  1387.                interfaces which are character-oriented or transmit
  1388.                data in fixed-length transmission units, and for which
  1389.                the value of the corresponding instance of ifSpeed is
  1390.                greater than 20,000,000 bits/second."
  1392.            GROUP       ifPacketGroup
  1393.            DESCRIPTION
  1394.                "This group is mandatory for all network interfaces
  1395.                which are packet-oriented."
  1397.            GROUP       ifHCPacketGroup
  1398.            DESCRIPTION
  1399.                "This group is mandatory only for those network
  1400.                interfaces which are packet-oriented and for which the
  1401.                value of the corresponding instance of ifSpeed is
  1402.                greater than 650,000,000 bits/second."
  1403.            GROUP       ifTestGroup
  1404.            DESCRIPTION
  1405.                "This group is optional.  Media-specific MIBs which
  1406.                require interface tests are strongly encouraged to use
  1407.                this group for invoking tests and reporting results.
  1408.                A medium specific MIB which has mandatory tests may
  1409.                make implementation of this group mandatory."
  1411.            GROUP       ifRcvAddressGroup
  1412.            DESCRIPTION
  1413.                "The applicability of this group MUST be defined by
  1414.                the media-specific MIBs.  Media-specific MIBs must
  1415.                define the exact meaning, use, and semantics of the
  1416.                addresses in this group."
  1418.            OBJECT      ifLinkUpDownTrapEnable
  1419.            MIN-ACCESS  read-only
  1420.            DESCRIPTION
  1421.                "Write access is not required."
  1423.            OBJECT      ifPromiscuousMode
  1424.            MIN-ACCESS  read-only
  1425.            DESCRIPTION
  1426.                "Write access is not required."
  1428.            OBJECT      ifStackStatus
  1429.            SYNTAX      INTEGER { active(1) } -- subset of RowStatus
  1430.            MIN-ACCESS  read-only
  1431.            DESCRIPTION
  1432.                "Write access is not required, and only one of the six
  1433.                enumerated values for the RowStatus textual convention
  1434.                need be supported, specifically: active(1)."
  1436.            OBJECT       ifAdminStatus
  1437.            SYNTAX       INTEGER { up(1), down(2) }
  1438.            MIN-ACCESS   read-only
  1439.            DESCRIPTION
  1440.                "Write access is not required, nor is support for the
  1441.                value testing(3)."
  1442.        ::= { ifCompliances 1 }
  1445.    -- units of conformance
  1447.    ifGeneralInformationGroup    OBJECT-GROUP
  1448.        OBJECTS { ifIndex, ifDescr, ifType, ifSpeed, ifPhysAddress,
  1449.                  ifAdminStatus, ifOperStatus, ifLastChange,
  1450.                  ifLinkUpDownTrapEnable, ifConnectorPresent,
  1451.                  ifHighSpeed, ifName, ifNumber, ifAlias,
  1452.                  ifTableLastChange }
  1453.        STATUS  current
  1454.        DESCRIPTION
  1455.                "A collection of objects providing information
  1456.                applicable to all network interfaces."
  1457.        ::= { ifGroups 10 }
  1459.    ifGeneralGroup    OBJECT-GROUP
  1460.        OBJECTS { ifDescr, ifType, ifSpeed, ifPhysAddress,
  1461.                  ifAdminStatus, ifOperStatus, ifLastChange,
  1462.                  ifLinkUpDownTrapEnable, ifConnectorPresent,
  1463.                  ifHighSpeed, ifName }
  1464.        STATUS      obsolete
  1465.        DESCRIPTION
  1466.                "A collection of objects providing information
  1467.                applicable to all network interfaces."
  1468.        ::= { ifGroups 1 }
  1470.    -- the following five groups are mutually exclusive; at most
  1471.    -- one of these groups is implemented for any interface
  1473.    ifFixedLengthGroup    OBJECT-GROUP
  1474.        OBJECTS { ifInOctets, ifOutOctets, ifInUnknownProtos,
  1475.                  ifInErrors, ifOutErrors }
  1476.        STATUS  current
  1477.        DESCRIPTION
  1478.                "A collection of objects providing information
  1479.                specific to non-high speed, character-oriented or
  1480.                fixed-length-transmission network interfaces.  (Non-
  1481.                high speed interfaces transmit and receive at speeds
  1482.                less than or equal to 20,000,000 bits/second.)"
  1483.        ::= { ifGroups 2 }
  1485.    ifHCFixedLengthGroup    OBJECT-GROUP
  1486.        OBJECTS { ifHCInOctets, ifHCOutOctets,
  1487.                  ifInOctets, ifOutOctets, ifInUnknownProtos,
  1488.                  ifInErrors, ifOutErrors }
  1489.        STATUS  current
  1490.        DESCRIPTION
  1491.                "A collection of objects providing information
  1492.                specific to high speed (greater than 20,000,000
  1493.                bits/second) character-oriented or fixed-length-
  1494.                transmission network interfaces."
  1495.        ::= { ifGroups 3 }
  1497.    ifPacketGroup    OBJECT-GROUP
  1498.        OBJECTS { ifInOctets, ifOutOctets, ifInUnknownProtos,
  1499.                  ifInErrors, ifOutErrors,
  1500.                  ifMtu, ifInUcastPkts, ifInMulticastPkts,
  1501.                  ifInBroadcastPkts, ifInDiscards,
  1502.                  ifOutUcastPkts, ifOutMulticastPkts,
  1503.                  ifOutBroadcastPkts, ifOutDiscards,
  1504.                  ifPromiscuousMode }
  1505.        STATUS  current
  1506.        DESCRIPTION
  1507.                "A collection of objects providing information
  1508.                specific to non-high speed, packet-oriented network
  1509.                interfaces.  (Non-high speed interfaces transmit and
  1510.                receive at speeds less than or equal to 20,000,000
  1511.                bits/second.)"
  1512.        ::= { ifGroups 4 }
  1514.    ifHCPacketGroup    OBJECT-GROUP
  1515.        OBJECTS { ifHCInOctets, ifHCOutOctets,
  1516.                  ifInOctets, ifOutOctets, ifInUnknownProtos,
  1517.                  ifInErrors, ifOutErrors,
  1518.                  ifMtu, ifInUcastPkts, ifInMulticastPkts,
  1519.                  ifInBroadcastPkts, ifInDiscards,
  1520.                  ifOutUcastPkts, ifOutMulticastPkts,
  1521.                  ifOutBroadcastPkts, ifOutDiscards,
  1522.                  ifPromiscuousMode }
  1523.        STATUS  current
  1524.        DESCRIPTION
  1525.                "A collection of objects providing information
  1526.                specific to high speed (greater than 20,000,000
  1527.                bits/second but less than or equal to 650,000,000
  1528.                bits/second) packet-oriented network interfaces."
  1529.        ::= { ifGroups 5 }
  1531.    ifVHCPacketGroup    OBJECT-GROUP
  1532.        OBJECTS { ifHCInUcastPkts, ifHCInMulticastPkts,
  1533.                  ifHCInBroadcastPkts, ifHCOutUcastPkts,
  1534.                  ifHCOutMulticastPkts, ifHCOutBroadcastPkts,
  1535.                  ifHCInOctets, ifHCOutOctets,
  1536.                  ifInOctets, ifOutOctets, ifInUnknownProtos,
  1537.                  ifInErrors, ifOutErrors,
  1538.                  ifMtu, ifInUcastPkts, ifInMulticastPkts,
  1539.                  ifInBroadcastPkts, ifInDiscards,
  1540.                  ifOutUcastPkts, ifOutMulticastPkts,
  1541.                  ifOutBroadcastPkts, ifOutDiscards,
  1542.                  ifPromiscuousMode }
  1543.        STATUS  current
  1544.        DESCRIPTION
  1545.                "A collection of objects providing information
  1546.                specific to higher speed (greater than 650,000,000
  1547.                bits/second) packet-oriented network interfaces."
  1548.        ::= { ifGroups 6 }
  1550.    ifRcvAddressGroup    OBJECT-GROUP
  1551.        OBJECTS { ifRcvAddressStatus, ifRcvAddressType }
  1552.        STATUS  current
  1553.        DESCRIPTION
  1554.                "A collection of objects providing information on the
  1555.                multiple addresses which an interface receives."
  1556.        ::= { ifGroups 7 }
  1558.    ifTestGroup    OBJECT-GROUP
  1559.        OBJECTS { ifTestId, ifTestStatus, ifTestType,
  1560.                  ifTestResult, ifTestCode, ifTestOwner }
  1561.        STATUS  obsolete
  1562.        DESCRIPTION
  1563.                "A collection of objects providing the ability to
  1564.                invoke tests on an interface."
  1565.        ::= { ifGroups 8 }
  1567.    ifStackGroup    OBJECT-GROUP
  1568.        OBJECTS { ifStackStatus }
  1569.        STATUS  obsolete
  1570.        DESCRIPTION
  1571.                "A collection of objects providing information on the
  1572.                layering of MIB-II interfaces."
  1573.        ::= { ifGroups 9 }
  1575.    ifStackGroup2    OBJECT-GROUP
  1576.        OBJECTS { ifStackStatus, ifStackLastChange }
  1577.        STATUS  current
  1578.        DESCRIPTION
  1579.                "A collection of objects providing information on the
  1580.                layering of MIB-II interfaces."
  1581.        ::= { ifGroups 11 }
  1583. ifOldObjectsGroup    OBJECT-GROUP
  1584.     OBJECTS { ifInNUcastPkts, ifOutNUcastPkts,
  1585.               ifOutQLen, ifSpecific }
  1586.     STATUS  obsolete
  1587.     DESCRIPTION
  1588.             "The collection of objects deprecated from the
  1589.             original MIB-II interfaces group."
  1590.     ::= { ifGroups 12 }
  1594.    END