test/dumps/xml/IF-MIB

   1 <?xml version="1.0"?>
   2 <!DOCTYPE smi SYSTEM "http://www.ibr.cs.tu-bs.de/projects/nmrg/smi.dtd">
   3
   4 <!-- This module has been generated by smidump 0.4.5. Do not edit. -->
   5
   6 <smi xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
   7      xsi:noNamespaceSchemaLocation="http://www.ibr.cs.tu-bs.de/projects/nmrg/smi.xsd">
   8   <module name="IF-MIB" language="SMIv2">
   9     <organization>
  10         IETF Interfaces MIB Working Group
  11     </organization>
  12     <contact>
  13            Keith McCloghrie
  14         Cisco Systems, Inc.
  15         170 West Tasman Drive
  16         San Jose, CA  95134-1706
  17         US
  18
  19         408-526-5260
  20         kzm@cisco.com
  21     </contact>
  22     <description>
  23         The MIB module to describe generic objects for network
  24         interface sub-layers.  This MIB is an updated version of
  25         MIB-II's ifTable, and incorporates the extensions defined in
  26         RFC 1229.
  27     </description>
  28     <revision date="2000-06-14 00:00">
  29       <description>
  30           Clarifications agreed upon by the Interfaces MIB WG, and
  31           published as RFC 2863.
  32       </description>
  33     </revision>
  34     <revision date="1996-02-28 21:55">
  35       <description>
  36           Revisions made by the Interfaces MIB WG, and published in
  37           RFC 2233.
  38       </description>
  39     </revision>
  40     <revision date="1993-11-08 21:55">
  41       <description>
  42           Initial revision, published as part of RFC 1573.
  43       </description>
  44     </revision>
  45     <identity node="ifMIB"/>
  46   </module>
  47
  48   <imports>
  49     <import module="SNMPv2-SMI" name="MODULE-IDENTITY"/>
  50     <import module="SNMPv2-SMI" name="OBJECT-TYPE"/>
  51     <import module="SNMPv2-SMI" name="Counter32"/>
  52     <import module="SNMPv2-SMI" name="Gauge32"/>
  53     <import module="SNMPv2-SMI" name="Counter64"/>
  54     <import module="SNMPv2-SMI" name="Integer32"/>
  55     <import module="SNMPv2-SMI" name="TimeTicks"/>
  56     <import module="SNMPv2-SMI" name="mib-2"/>
  57     <import module="SNMPv2-SMI" name="NOTIFICATION-TYPE"/>
  58     <import module="SNMPv2-TC" name="TEXTUAL-CONVENTION"/>
  59     <import module="SNMPv2-TC" name="DisplayString"/>
  60     <import module="SNMPv2-TC" name="PhysAddress"/>
  61     <import module="SNMPv2-TC" name="TruthValue"/>
  62     <import module="SNMPv2-TC" name="RowStatus"/>
  63     <import module="SNMPv2-TC" name="TimeStamp"/>
  64     <import module="SNMPv2-TC" name="AutonomousType"/>
  65     <import module="SNMPv2-TC" name="TestAndIncr"/>
  66     <import module="SNMPv2-CONF" name="MODULE-COMPLIANCE"/>
  67     <import module="SNMPv2-CONF" name="OBJECT-GROUP"/>
  68     <import module="SNMPv2-CONF" name="NOTIFICATION-GROUP"/>
  69     <import module="SNMPv2-MIB" name="snmpTraps"/>
  70     <import module="IANAifType-MIB" name="IANAifType"/>
  71   </imports>
  72
  73   <typedefs>
  74     <typedef name="OwnerString" basetype="OctetString" status="deprecated">
  75       <range min="0" max="255"/>
  76       <format>255a</format>
  77       <description>
  78           This data type is used to model an administratively
  79           assigned name of the owner of a resource.  This information
  80           is taken from the NVT ASCII character set.  It is suggested
  81           that this name contain one or more of the following: ASCII
  82           form of the manager station's transport address, management
  83           station name (e.g., domain name), network management
  84           personnel's name, location, or phone number.  In some cases
  85           the agent itself will be the owner of an entry.  In these
  86           cases, this string shall be set to a string starting with
  87           'agent'.
  88       </description>
  89     </typedef>
  90     <typedef name="InterfaceIndex" basetype="Integer32" status="current">
  91       <range min="1" max="2147483647"/>
  92       <format>d</format>
  93       <description>
  94           A unique value, greater than zero, for each interface or
  95           interface sub-layer in the managed system.  It is
  96           recommended that values are assigned contiguously starting
  97           from 1.  The value for each interface sub-layer must remain
  98           constant at least from one re-initialization of the entity's
  99           network management system to the next re-initialization.
 100       </description>
 101     </typedef>
 102     <typedef name="InterfaceIndexOrZero" basetype="Integer32" status="current">
 103       <range min="0" max="2147483647"/>
 104       <format>d</format>
 105       <description>
 106           This textual convention is an extension of the
 107           InterfaceIndex convention.  The latter defines a greater
 108           than zero value used to identify an interface or interface
 109           sub-layer in the managed system.  This extension permits the
 110           additional value of zero.  the value zero is object-specific
 111           and must therefore be defined as part of the description of
 112           any object which uses this syntax.  Examples of the usage of
 113           zero might include situations where interface was unknown,
 114           or when none or all interfaces need to be referenced.
 115       </description>
 116     </typedef>
 117   </typedefs>
 118
 119   <nodes>
 120     <node name="interfaces" oid="1.3.6.1.2.1.2">
 121     </node>
 122     <scalar name="ifNumber" oid="1.3.6.1.2.1.2.1" status="current">
 123       <syntax>
 124         <type module="" name="Integer32"/>
 125       </syntax>
 126       <access>readonly</access>
 127       <description>
 128           The number of network interfaces (regardless of their
 129           current state) present on this system.
 130       </description>
 131     </scalar>
 132     <table name="ifTable" oid="1.3.6.1.2.1.2.2" status="current">
 133       <description>
 134           A list of interface entries.  The number of entries is
 135           given by the value of ifNumber.
 136       </description>
 137       <row name="ifEntry" oid="1.3.6.1.2.1.2.2.1" status="current">
 138         <linkage>
 139           <index module="IF-MIB" name="ifIndex"/>
 140         </linkage>
 141         <description>
 142             An entry containing management information applicable to a
 143             particular interface.
 144         </description>
 145         <column name="ifIndex" oid="1.3.6.1.2.1.2.2.1.1" status="current">
 146           <syntax>
 147             <type module="IF-MIB" name="InterfaceIndex"/>
 148           </syntax>
 149           <access>readonly</access>
 150           <description>
 151               A unique value, greater than zero, for each interface.  It
 152               is recommended that values are assigned contiguously
 153               starting from 1.  The value for each interface sub-layer
 154               must remain constant at least from one re-initialization of
 155               the entity's network management system to the next re-
 156               initialization.
 157           </description>
 158         </column>
 159         <column name="ifDescr" oid="1.3.6.1.2.1.2.2.1.2" status="current">
 160           <syntax>
 161             <typedef basetype="OctetString">
 162               <parent module="SNMPv2-TC" name="DisplayString"/>
 163               <range min="0" max="255"/>
 164             </typedef>
 165           </syntax>
 166           <access>readonly</access>
 167           <description>
 168               A textual string containing information about the
 169               interface.  This string should include the name of the
 170               manufacturer, the product name and the version of the
 171               interface hardware/software.
 172           </description>
 173         </column>
 174         <column name="ifType" oid="1.3.6.1.2.1.2.2.1.3" status="current">
 175           <syntax>
 176             <type module="IANAifType-MIB" name="IANAifType"/>
 177           </syntax>
 178           <access>readonly</access>
 179           <description>
 180               The type of interface.  Additional values for ifType are
 181               assigned by the Internet Assigned Numbers Authority (IANA),
 182               through updating the syntax of the IANAifType textual
 183               convention.
 184           </description>
 185         </column>
 186         <column name="ifMtu" oid="1.3.6.1.2.1.2.2.1.4" status="current">
 187           <syntax>
 188             <type module="" name="Integer32"/>
 189           </syntax>
 190           <access>readonly</access>
 191           <description>
 192               The size of the largest packet which can be sent/received
 193               on the interface, specified in octets.  For interfaces that
 194               are used for transmitting network datagrams, this is the
 195               size of the largest network datagram that can be sent on the
 196               interface.
 197           </description>
 198         </column>
 199         <column name="ifSpeed" oid="1.3.6.1.2.1.2.2.1.5" status="current">
 200           <syntax>
 201             <type module="SNMPv2-SMI" name="Gauge32"/>
 202           </syntax>
 203           <access>readonly</access>
 204           <description>
 205               An estimate of the interface's current bandwidth in bits
 206               per second.  For interfaces which do not vary in bandwidth
 207               or for those where no accurate estimation can be made, this
 208               object should contain the nominal bandwidth.  If the
 209               bandwidth of the interface is greater than the maximum value
 210               reportable by this object then this object should report its
 211               maximum value (4,294,967,295) and ifHighSpeed must be used
 212               to report the interace's speed.  For a sub-layer which has
 213               no concept of bandwidth, this object should be zero.
 214           </description>
 215         </column>
 216         <column name="ifPhysAddress" oid="1.3.6.1.2.1.2.2.1.6" status="current">
 217           <syntax>
 218             <type module="SNMPv2-TC" name="PhysAddress"/>
 219           </syntax>
 220           <access>readonly</access>
 221           <description>
 222               The interface's address at its protocol sub-layer.  For
 223               example, for an 802.x interface, this object normally
 224               contains a MAC address.  The interface's media-specific MIB
 225               must define the bit and byte ordering and the format of the
 226               value of this object.  For interfaces which do not have such
 227               an address (e.g., a serial line), this object should contain
 228               an octet string of zero length.
 229           </description>
 230         </column>
 231         <column name="ifAdminStatus" oid="1.3.6.1.2.1.2.2.1.7" status="current">
 232           <syntax>
 233             <typedef basetype="Enumeration">
 234               <namednumber name="up" number="1"/>
 235               <namednumber name="down" number="2"/>
 236               <namednumber name="testing" number="3"/>
 237             </typedef>
 238           </syntax>
 239           <access>readwrite</access>
 240           <description>
 241               The desired state of the interface.  The testing(3) state
 242               indicates that no operational packets can be passed.  When a
 243               managed system initializes, all interfaces start with
 244               ifAdminStatus in the down(2) state.  As a result of either
 245               explicit management action or per configuration information
 246               retained by the managed system, ifAdminStatus is then
 247               changed to either the up(1) or testing(3) states (or remains
 248               in the down(2) state).
 249           </description>
 250         </column>
 251         <column name="ifOperStatus" oid="1.3.6.1.2.1.2.2.1.8" status="current">
 252           <syntax>
 253             <typedef basetype="Enumeration">
 254               <namednumber name="up" number="1"/>
 255               <namednumber name="down" number="2"/>
 256               <namednumber name="testing" number="3"/>
 257               <namednumber name="unknown" number="4"/>
 258               <namednumber name="dormant" number="5"/>
 259               <namednumber name="notPresent" number="6"/>
 260               <namednumber name="lowerLayerDown" number="7"/>
 261             </typedef>
 262           </syntax>
 263           <access>readonly</access>
 264           <description>
 265               The current operational state of the interface.  The
 266               testing(3) state indicates that no operational packets can
 267               be passed.  If ifAdminStatus is down(2) then ifOperStatus
 268               should be down(2).  If ifAdminStatus is changed to up(1)
 269               then ifOperStatus should change to up(1) if the interface is
 270               ready to transmit and receive network traffic; it should
 271               change to dormant(5) if the interface is waiting for
 272               external actions (such as a serial line waiting for an
 273               incoming connection); it should remain in the down(2) state
 274               if and only if there is a fault that prevents it from going
 275               to the up(1) state; it should remain in the notPresent(6)
 276               state if the interface has missing (typically, hardware)
 277               components.
 278           </description>
 279         </column>
 280         <column name="ifLastChange" oid="1.3.6.1.2.1.2.2.1.9" status="current">
 281           <syntax>
 282             <type module="SNMPv2-SMI" name="TimeTicks"/>
 283           </syntax>
 284           <access>readonly</access>
 285           <description>
 286               The value of sysUpTime at the time the interface entered
 287               its current operational state.  If the current state was
 288               entered prior to the last re-initialization of the local
 289               network management subsystem, then this object contains a
 290               zero value.
 291           </description>
 292         </column>
 293         <column name="ifInOctets" oid="1.3.6.1.2.1.2.2.1.10" status="current">
 294           <syntax>
 295             <type module="SNMPv2-SMI" name="Counter32"/>
 296           </syntax>
 297           <access>readonly</access>
 298           <description>
 299               The total number of octets received on the interface,
 300
 301
 302               including framing characters.
 303
 304               Discontinuities in the value of this counter can occur at
 305               re-initialization of the management system, and at other
 306               times as indicated by the value of
 307               ifCounterDiscontinuityTime.
 308           </description>
 309         </column>
 310         <column name="ifInUcastPkts" oid="1.3.6.1.2.1.2.2.1.11" status="current">
 311           <syntax>
 312             <type module="SNMPv2-SMI" name="Counter32"/>
 313           </syntax>
 314           <access>readonly</access>
 315           <description>
 316               The number of packets, delivered by this sub-layer to a
 317               higher (sub-)layer, which were not addressed to a multicast
 318               or broadcast address at this sub-layer.
 319
 320               Discontinuities in the value of this counter can occur at
 321               re-initialization of the management system, and at other
 322               times as indicated by the value of
 323               ifCounterDiscontinuityTime.
 324           </description>
 325         </column>
 326         <column name="ifInNUcastPkts" oid="1.3.6.1.2.1.2.2.1.12" status="deprecated">
 327           <syntax>
 328             <type module="SNMPv2-SMI" name="Counter32"/>
 329           </syntax>
 330           <access>readonly</access>
 331           <description>
 332               The number of packets, delivered by this sub-layer to a
 333               higher (sub-)layer, which were addressed to a multicast or
 334               broadcast address at this sub-layer.
 335
 336               Discontinuities in the value of this counter can occur at
 337               re-initialization of the management system, and at other
 338               times as indicated by the value of
 339               ifCounterDiscontinuityTime.
 340
 341               This object is deprecated in favour of ifInMulticastPkts and
 342               ifInBroadcastPkts.
 343           </description>
 344         </column>
 345         <column name="ifInDiscards" oid="1.3.6.1.2.1.2.2.1.13" status="current">
 346           <syntax>
 347             <type module="SNMPv2-SMI" name="Counter32"/>
 348           </syntax>
 349           <access>readonly</access>
 350           <description>
 351               The number of inbound packets which were chosen to be
 352               discarded even though no errors had been detected to prevent
 353
 354
 355               their being deliverable to a higher-layer protocol.  One
 356               possible reason for discarding such a packet could be to
 357               free up buffer space.
 358
 359               Discontinuities in the value of this counter can occur at
 360               re-initialization of the management system, and at other
 361               times as indicated by the value of
 362               ifCounterDiscontinuityTime.
 363           </description>
 364         </column>
 365         <column name="ifInErrors" oid="1.3.6.1.2.1.2.2.1.14" status="current">
 366           <syntax>
 367             <type module="SNMPv2-SMI" name="Counter32"/>
 368           </syntax>
 369           <access>readonly</access>
 370           <description>
 371               For packet-oriented interfaces, the number of inbound
 372               packets that contained errors preventing them from being
 373               deliverable to a higher-layer protocol.  For character-
 374               oriented or fixed-length interfaces, the number of inbound
 375               transmission units that contained errors preventing them
 376               from being deliverable to a higher-layer protocol.
 377
 378               Discontinuities in the value of this counter can occur at
 379               re-initialization of the management system, and at other
 380               times as indicated by the value of
 381               ifCounterDiscontinuityTime.
 382           </description>
 383         </column>
 384         <column name="ifInUnknownProtos" oid="1.3.6.1.2.1.2.2.1.15" status="current">
 385           <syntax>
 386             <type module="SNMPv2-SMI" name="Counter32"/>
 387           </syntax>
 388           <access>readonly</access>
 389           <description>
 390               For packet-oriented interfaces, the number of packets
 391               received via the interface which were discarded because of
 392               an unknown or unsupported protocol.  For character-oriented
 393               or fixed-length interfaces that support protocol
 394               multiplexing the number of transmission units received via
 395               the interface which were discarded because of an unknown or
 396               unsupported protocol.  For any interface that does not
 397               support protocol multiplexing, this counter will always be
 398               0.
 399
 400               Discontinuities in the value of this counter can occur at
 401               re-initialization of the management system, and at other
 402               times as indicated by the value of
 403               ifCounterDiscontinuityTime.
 404           </description>
 405         </column>
 406         <column name="ifOutOctets" oid="1.3.6.1.2.1.2.2.1.16" status="current">
 407           <syntax>
 408             <type module="SNMPv2-SMI" name="Counter32"/>
 409           </syntax>
 410           <access>readonly</access>
 411           <description>
 412               The total number of octets transmitted out of the
 413               interface, including framing characters.
 414
 415               Discontinuities in the value of this counter can occur at
 416               re-initialization of the management system, and at other
 417               times as indicated by the value of
 418               ifCounterDiscontinuityTime.
 419           </description>
 420         </column>
 421         <column name="ifOutUcastPkts" oid="1.3.6.1.2.1.2.2.1.17" status="current">
 422           <syntax>
 423             <type module="SNMPv2-SMI" name="Counter32"/>
 424           </syntax>
 425           <access>readonly</access>
 426           <description>
 427               The total number of packets that higher-level protocols
 428               requested be transmitted, and which were not addressed to a
 429               multicast or broadcast address at this sub-layer, including
 430               those that were discarded or not sent.
 431
 432               Discontinuities in the value of this counter can occur at
 433               re-initialization of the management system, and at other
 434               times as indicated by the value of
 435               ifCounterDiscontinuityTime.
 436           </description>
 437         </column>
 438         <column name="ifOutNUcastPkts" oid="1.3.6.1.2.1.2.2.1.18" status="deprecated">
 439           <syntax>
 440             <type module="SNMPv2-SMI" name="Counter32"/>
 441           </syntax>
 442           <access>readonly</access>
 443           <description>
 444               The total number of packets that higher-level protocols
 445               requested be transmitted, and which were addressed to a
 446               multicast or broadcast address at this sub-layer, including
 447               those that were discarded or not sent.
 448
 449               Discontinuities in the value of this counter can occur at
 450               re-initialization of the management system, and at other
 451               times as indicated by the value of
 452               ifCounterDiscontinuityTime.
 453
 454               This object is deprecated in favour of ifOutMulticastPkts
 455               and ifOutBroadcastPkts.
 456           </description>
 457         </column>
 458         <column name="ifOutDiscards" oid="1.3.6.1.2.1.2.2.1.19" status="current">
 459           <syntax>
 460             <type module="SNMPv2-SMI" name="Counter32"/>
 461           </syntax>
 462           <access>readonly</access>
 463           <description>
 464               The number of outbound packets which were chosen to be
 465               discarded even though no errors had been detected to prevent
 466               their being transmitted.  One possible reason for discarding
 467               such a packet could be to free up buffer space.
 468
 469               Discontinuities in the value of this counter can occur at
 470               re-initialization of the management system, and at other
 471               times as indicated by the value of
 472               ifCounterDiscontinuityTime.
 473           </description>
 474         </column>
 475         <column name="ifOutErrors" oid="1.3.6.1.2.1.2.2.1.20" status="current">
 476           <syntax>
 477             <type module="SNMPv2-SMI" name="Counter32"/>
 478           </syntax>
 479           <access>readonly</access>
 480           <description>
 481               For packet-oriented interfaces, the number of outbound
 482               packets that could not be transmitted because of errors.
 483               For character-oriented or fixed-length interfaces, the
 484               number of outbound transmission units that could not be
 485               transmitted because of errors.
 486
 487               Discontinuities in the value of this counter can occur at
 488               re-initialization of the management system, and at other
 489               times as indicated by the value of
 490               ifCounterDiscontinuityTime.
 491           </description>
 492         </column>
 493         <column name="ifOutQLen" oid="1.3.6.1.2.1.2.2.1.21" status="deprecated">
 494           <syntax>
 495             <type module="SNMPv2-SMI" name="Gauge32"/>
 496           </syntax>
 497           <access>readonly</access>
 498           <description>
 499               The length of the output packet queue (in packets).
 500           </description>
 501         </column>
 502         <column name="ifSpecific" oid="1.3.6.1.2.1.2.2.1.22" status="deprecated">
 503           <syntax>
 504             <type module="" name="ObjectIdentifier"/>
 505           </syntax>
 506           <access>readonly</access>
 507           <description>
 508               A reference to MIB definitions specific to the particular
 509               media being used to realize the interface.  It is
 510
 511
 512               recommended that this value point to an instance of a MIB
 513               object in the media-specific MIB, i.e., that this object
 514               have the semantics associated with the InstancePointer
 515               textual convention defined in RFC 2579.  In fact, it is
 516               recommended that the media-specific MIB specify what value
 517               ifSpecific should/can take for values of ifType.  If no MIB
 518               definitions specific to the particular media are available,
 519               the value should be set to the OBJECT IDENTIFIER { 0 0 }.
 520           </description>
 521         </column>
 522       </row>
 523     </table>
 524     <node name="ifMIB" oid="1.3.6.1.2.1.31" status="current">
 525     </node>
 526     <node name="ifMIBObjects" oid="1.3.6.1.2.1.31.1">
 527     </node>
 528     <table name="ifXTable" oid="1.3.6.1.2.1.31.1.1" status="current">
 529       <description>
 530           A list of interface entries.  The number of entries is
 531           given by the value of ifNumber.  This table contains
 532           additional objects for the interface table.
 533       </description>
 534       <row name="ifXEntry" oid="1.3.6.1.2.1.31.1.1.1" status="current">
 535         <linkage>
 536           <augments module="IF-MIB" name="ifEntry"/>
 537         </linkage>
 538         <description>
 539             An entry containing additional management information
 540             applicable to a particular interface.
 541         </description>
 542         <column name="ifName" oid="1.3.6.1.2.1.31.1.1.1.1" status="current">
 543           <syntax>
 544             <type module="SNMPv2-TC" name="DisplayString"/>
 545           </syntax>
 546           <access>readonly</access>
 547           <description>
 548               The textual name of the interface.  The value of this
 549               object should be the name of the interface as assigned by
 550               the local device and should be suitable for use in commands
 551               entered at the device's `console'.  This might be a text
 552               name, such as `le0' or a simple port number, such as `1',
 553               depending on the interface naming syntax of the device.  If
 554               several entries in the ifTable together represent a single
 555               interface as named by the device, then each will have the
 556               same value of ifName.  Note that for an agent which responds
 557               to SNMP queries concerning an interface on some other
 558               (proxied) device, then the value of ifName for such an
 559               interface is the proxied device's local name for it.
 560
 561               If there is no local name, or this object is otherwise not
 562               applicable, then this object contains a zero-length string.
 563           </description>
 564         </column>
 565         <column name="ifInMulticastPkts" oid="1.3.6.1.2.1.31.1.1.1.2" status="current">
 566           <syntax>
 567             <type module="SNMPv2-SMI" name="Counter32"/>
 568           </syntax>
 569           <access>readonly</access>
 570           <description>
 571               The number of packets, delivered by this sub-layer to a
 572               higher (sub-)layer, which were addressed to a multicast
 573               address at this sub-layer.  For a MAC layer protocol, this
 574               includes both Group and Functional addresses.
 575
 576               Discontinuities in the value of this counter can occur at
 577               re-initialization of the management system, and at other
 578
 579
 580               times as indicated by the value of
 581               ifCounterDiscontinuityTime.
 582           </description>
 583         </column>
 584         <column name="ifInBroadcastPkts" oid="1.3.6.1.2.1.31.1.1.1.3" status="current">
 585           <syntax>
 586             <type module="SNMPv2-SMI" name="Counter32"/>
 587           </syntax>
 588           <access>readonly</access>
 589           <description>
 590               The number of packets, delivered by this sub-layer to a
 591               higher (sub-)layer, which were addressed to a broadcast
 592               address at this sub-layer.
 593
 594               Discontinuities in the value of this counter can occur at
 595               re-initialization of the management system, and at other
 596               times as indicated by the value of
 597               ifCounterDiscontinuityTime.
 598           </description>
 599         </column>
 600         <column name="ifOutMulticastPkts" oid="1.3.6.1.2.1.31.1.1.1.4" status="current">
 601           <syntax>
 602             <type module="SNMPv2-SMI" name="Counter32"/>
 603           </syntax>
 604           <access>readonly</access>
 605           <description>
 606               The total number of packets that higher-level protocols
 607               requested be transmitted, and which were addressed to a
 608               multicast address at this sub-layer, including those that
 609               were discarded or not sent.  For a MAC layer protocol, this
 610               includes both Group and Functional addresses.
 611
 612               Discontinuities in the value of this counter can occur at
 613               re-initialization of the management system, and at other
 614               times as indicated by the value of
 615               ifCounterDiscontinuityTime.
 616           </description>
 617         </column>
 618         <column name="ifOutBroadcastPkts" oid="1.3.6.1.2.1.31.1.1.1.5" status="current">
 619           <syntax>
 620             <type module="SNMPv2-SMI" name="Counter32"/>
 621           </syntax>
 622           <access>readonly</access>
 623           <description>
 624               The total number of packets that higher-level protocols
 625               requested be transmitted, and which were addressed to a
 626               broadcast address at this sub-layer, including those that
 627               were discarded or not sent.
 628
 629               Discontinuities in the value of this counter can occur at
 630               re-initialization of the management system, and at other
 631
 632
 633               times as indicated by the value of
 634               ifCounterDiscontinuityTime.
 635           </description>
 636         </column>
 637         <column name="ifHCInOctets" oid="1.3.6.1.2.1.31.1.1.1.6" status="current">
 638           <syntax>
 639             <type module="SNMPv2-SMI" name="Counter64"/>
 640           </syntax>
 641           <access>readonly</access>
 642           <description>
 643               The total number of octets received on the interface,
 644               including framing characters.  This object is a 64-bit
 645               version of ifInOctets.
 646
 647               Discontinuities in the value of this counter can occur at
 648               re-initialization of the management system, and at other
 649               times as indicated by the value of
 650               ifCounterDiscontinuityTime.
 651           </description>
 652         </column>
 653         <column name="ifHCInUcastPkts" oid="1.3.6.1.2.1.31.1.1.1.7" status="current">
 654           <syntax>
 655             <type module="SNMPv2-SMI" name="Counter64"/>
 656           </syntax>
 657           <access>readonly</access>
 658           <description>
 659               The number of packets, delivered by this sub-layer to a
 660               higher (sub-)layer, which were not addressed to a multicast
 661               or broadcast address at this sub-layer.  This object is a
 662               64-bit version of ifInUcastPkts.
 663
 664               Discontinuities in the value of this counter can occur at
 665               re-initialization of the management system, and at other
 666               times as indicated by the value of
 667               ifCounterDiscontinuityTime.
 668           </description>
 669         </column>
 670         <column name="ifHCInMulticastPkts" oid="1.3.6.1.2.1.31.1.1.1.8" status="current">
 671           <syntax>
 672             <type module="SNMPv2-SMI" name="Counter64"/>
 673           </syntax>
 674           <access>readonly</access>
 675           <description>
 676               The number of packets, delivered by this sub-layer to a
 677               higher (sub-)layer, which were addressed to a multicast
 678               address at this sub-layer.  For a MAC layer protocol, this
 679               includes both Group and Functional addresses.  This object
 680               is a 64-bit version of ifInMulticastPkts.
 681
 682               Discontinuities in the value of this counter can occur at
 683               re-initialization of the management system, and at other
 684               times as indicated by the value of
 685               ifCounterDiscontinuityTime.
 686           </description>
 687         </column>
 688         <column name="ifHCInBroadcastPkts" oid="1.3.6.1.2.1.31.1.1.1.9" status="current">
 689           <syntax>
 690             <type module="SNMPv2-SMI" name="Counter64"/>
 691           </syntax>
 692           <access>readonly</access>
 693           <description>
 694               The number of packets, delivered by this sub-layer to a
 695               higher (sub-)layer, which were addressed to a broadcast
 696               address at this sub-layer.  This object is a 64-bit version
 697               of ifInBroadcastPkts.
 698
 699               Discontinuities in the value of this counter can occur at
 700               re-initialization of the management system, and at other
 701               times as indicated by the value of
 702               ifCounterDiscontinuityTime.
 703           </description>
 704         </column>
 705         <column name="ifHCOutOctets" oid="1.3.6.1.2.1.31.1.1.1.10" status="current">
 706           <syntax>
 707             <type module="SNMPv2-SMI" name="Counter64"/>
 708           </syntax>
 709           <access>readonly</access>
 710           <description>
 711               The total number of octets transmitted out of the
 712               interface, including framing characters.  This object is a
 713               64-bit version of ifOutOctets.
 714
 715               Discontinuities in the value of this counter can occur at
 716               re-initialization of the management system, and at other
 717               times as indicated by the value of
 718               ifCounterDiscontinuityTime.
 719           </description>
 720         </column>
 721         <column name="ifHCOutUcastPkts" oid="1.3.6.1.2.1.31.1.1.1.11" status="current">
 722           <syntax>
 723             <type module="SNMPv2-SMI" name="Counter64"/>
 724           </syntax>
 725           <access>readonly</access>
 726           <description>
 727               The total number of packets that higher-level protocols
 728               requested be transmitted, and which were not addressed to a
 729               multicast or broadcast address at this sub-layer, including
 730               those that were discarded or not sent.  This object is a
 731               64-bit version of ifOutUcastPkts.
 732
 733               Discontinuities in the value of this counter can occur at
 734               re-initialization of the management system, and at other
 735               times as indicated by the value of
 736               ifCounterDiscontinuityTime.
 737           </description>
 738         </column>
 739         <column name="ifHCOutMulticastPkts" oid="1.3.6.1.2.1.31.1.1.1.12" status="current">
 740           <syntax>
 741             <type module="SNMPv2-SMI" name="Counter64"/>
 742           </syntax>
 743           <access>readonly</access>
 744           <description>
 745               The total number of packets that higher-level protocols
 746               requested be transmitted, and which were addressed to a
 747               multicast address at this sub-layer, including those that
 748               were discarded or not sent.  For a MAC layer protocol, this
 749               includes both Group and Functional addresses.  This object
 750               is a 64-bit version of ifOutMulticastPkts.
 751
 752               Discontinuities in the value of this counter can occur at
 753               re-initialization of the management system, and at other
 754               times as indicated by the value of
 755               ifCounterDiscontinuityTime.
 756           </description>
 757         </column>
 758         <column name="ifHCOutBroadcastPkts" oid="1.3.6.1.2.1.31.1.1.1.13" status="current">
 759           <syntax>
 760             <type module="SNMPv2-SMI" name="Counter64"/>
 761           </syntax>
 762           <access>readonly</access>
 763           <description>
 764               The total number of packets that higher-level protocols
 765               requested be transmitted, and which were addressed to a
 766               broadcast address at this sub-layer, including those that
 767               were discarded or not sent.  This object is a 64-bit version
 768               of ifOutBroadcastPkts.
 769
 770               Discontinuities in the value of this counter can occur at
 771               re-initialization of the management system, and at other
 772               times as indicated by the value of
 773               ifCounterDiscontinuityTime.
 774           </description>
 775         </column>
 776         <column name="ifLinkUpDownTrapEnable" oid="1.3.6.1.2.1.31.1.1.1.14" status="current">
 777           <syntax>
 778             <typedef basetype="Enumeration">
 779               <namednumber name="enabled" number="1"/>
 780               <namednumber name="disabled" number="2"/>
 781             </typedef>
 782           </syntax>
 783           <access>readwrite</access>
 784           <description>
 785               Indicates whether linkUp/linkDown traps should be generated
 786               for this interface.
 787
 788               By default, this object should have the value enabled(1) for
 789               interfaces which do not operate on 'top' of any other
 790               interface (as defined in the ifStackTable), and disabled(2)
 791               otherwise.
 792           </description>
 793         </column>
 794         <column name="ifHighSpeed" oid="1.3.6.1.2.1.31.1.1.1.15" status="current">
 795           <syntax>
 796             <type module="SNMPv2-SMI" name="Gauge32"/>
 797           </syntax>
 798           <access>readonly</access>
 799           <description>
 800               An estimate of the interface's current bandwidth in units
 801               of 1,000,000 bits per second.  If this object reports a
 802               value of `n' then the speed of the interface is somewhere in
 803               the range of `n-500,000' to `n+499,999'.  For interfaces
 804               which do not vary in bandwidth or for those where no
 805               accurate estimation can be made, this object should contain
 806               the nominal bandwidth.  For a sub-layer which has no concept
 807               of bandwidth, this object should be zero.
 808           </description>
 809         </column>
 810         <column name="ifPromiscuousMode" oid="1.3.6.1.2.1.31.1.1.1.16" status="current">
 811           <syntax>
 812             <type module="SNMPv2-TC" name="TruthValue"/>
 813           </syntax>
 814           <access>readwrite</access>
 815           <description>
 816               This object has a value of false(2) if this interface only
 817               accepts packets/frames that are addressed to this station.
 818               This object has a value of true(1) when the station accepts
 819               all packets/frames transmitted on the media.  The value
 820               true(1) is only legal on certain types of media.  If legal,
 821               setting this object to a value of true(1) may require the
 822               interface to be reset before becoming effective.
 823
 824               The value of ifPromiscuousMode does not affect the reception
 825               of broadcast and multicast packets/frames by the interface.
 826           </description>
 827         </column>
 828         <column name="ifConnectorPresent" oid="1.3.6.1.2.1.31.1.1.1.17" status="current">
 829           <syntax>
 830             <type module="SNMPv2-TC" name="TruthValue"/>
 831           </syntax>
 832           <access>readonly</access>
 833           <description>
 834               This object has the value 'true(1)' if the interface
 835               sublayer has a physical connector and the value 'false(2)'
 836               otherwise.
 837           </description>
 838         </column>
 839         <column name="ifAlias" oid="1.3.6.1.2.1.31.1.1.1.18" status="current">
 840           <syntax>
 841             <typedef basetype="OctetString">
 842               <parent module="SNMPv2-TC" name="DisplayString"/>
 843               <range min="0" max="64"/>
 844             </typedef>
 845           </syntax>
 846           <access>readwrite</access>
 847           <description>
 848               This object is an 'alias' name for the interface as
 849               specified by a network manager, and provides a non-volatile
 850               'handle' for the interface.
 851
 852               On the first instantiation of an interface, the value of
 853               ifAlias associated with that interface is the zero-length
 854               string.  As and when a value is written into an instance of
 855               ifAlias through a network management set operation, then the
 856               agent must retain the supplied value in the ifAlias instance
 857               associated with the same interface for as long as that
 858               interface remains instantiated, including across all re-
 859               initializations/reboots of the network management system,
 860               including those which result in a change of the interface's
 861               ifIndex value.
 862
 863               An example of the value which a network manager might store
 864               in this object for a WAN interface is the (Telco's) circuit
 865               number/identifier of the interface.
 866
 867               Some agents may support write-access only for interfaces
 868               having particular values of ifType.  An agent which supports
 869               write access to this object is required to keep the value in
 870               non-volatile storage, but it may limit the length of new
 871               values depending on how much storage is already occupied by
 872               the current values for other interfaces.
 873           </description>
 874         </column>
 875         <column name="ifCounterDiscontinuityTime" oid="1.3.6.1.2.1.31.1.1.1.19" status="current">
 876           <syntax>
 877             <type module="SNMPv2-TC" name="TimeStamp"/>
 878           </syntax>
 879           <access>readonly</access>
 880           <description>
 881               The value of sysUpTime on the most recent occasion at which
 882               any one or more of this interface's counters suffered a
 883               discontinuity.  The relevant counters are the specific
 884               instances associated with this interface of any Counter32 or
 885
 886
 887               Counter64 object contained in the ifTable or ifXTable.  If
 888               no such discontinuities have occurred since the last re-
 889               initialization of the local management subsystem, then this
 890               object contains a zero value.
 891           </description>
 892         </column>
 893       </row>
 894     </table>
 895     <table name="ifStackTable" oid="1.3.6.1.2.1.31.1.2" status="current">
 896       <description>
 897           The table containing information on the relationships
 898           between the multiple sub-layers of network interfaces.  In
 899           particular, it contains information on which sub-layers run
 900           'on top of' which other sub-layers, where each sub-layer
 901           corresponds to a conceptual row in the ifTable.  For
 902           example, when the sub-layer with ifIndex value x runs over
 903           the sub-layer with ifIndex value y, then this table
 904           contains:
 905
 906             ifStackStatus.x.y=active
 907
 908           For each ifIndex value, I, which identifies an active
 909           interface, there are always at least two instantiated rows
 910           in this table associated with I.  For one of these rows, I
 911           is the value of ifStackHigherLayer; for the other, I is the
 912           value of ifStackLowerLayer.  (If I is not involved in
 913           multiplexing, then these are the only two rows associated
 914           with I.)
 915
 916           For example, two rows exist even for an interface which has
 917           no others stacked on top or below it:
 918
 919             ifStackStatus.0.x=active
 920             ifStackStatus.x.0=active
 921       </description>
 922       <row name="ifStackEntry" oid="1.3.6.1.2.1.31.1.2.1" create="true" status="current">
 923         <linkage>
 924           <index module="IF-MIB" name="ifStackHigherLayer"/>
 925           <index module="IF-MIB" name="ifStackLowerLayer"/>
 926         </linkage>
 927         <description>
 928             Information on a particular relationship between two sub-
 929             layers, specifying that one sub-layer runs on 'top' of the
 930             other sub-layer.  Each sub-layer corresponds to a conceptual
 931             row in the ifTable.
 932         </description>
 933         <column name="ifStackHigherLayer" oid="1.3.6.1.2.1.31.1.2.1.1" status="current">
 934           <syntax>
 935             <type module="IF-MIB" name="InterfaceIndexOrZero"/>
 936           </syntax>
 937           <access>noaccess</access>
 938           <description>
 939               The value of ifIndex corresponding to the higher sub-layer
 940               of the relationship, i.e., the sub-layer which runs on 'top'
 941               of the sub-layer identified by the corresponding instance of
 942               ifStackLowerLayer.  If there is no higher sub-layer (below
 943               the internetwork layer), then this object has the value 0.
 944           </description>
 945         </column>
 946         <column name="ifStackLowerLayer" oid="1.3.6.1.2.1.31.1.2.1.2" status="current">
 947           <syntax>
 948             <type module="IF-MIB" name="InterfaceIndexOrZero"/>
 949           </syntax>
 950           <access>noaccess</access>
 951           <description>
 952               The value of ifIndex corresponding to the lower sub-layer
 953               of the relationship, i.e., the sub-layer which runs 'below'
 954               the sub-layer identified by the corresponding instance of
 955               ifStackHigherLayer.  If there is no lower sub-layer, then
 956               this object has the value 0.
 957           </description>
 958         </column>
 959         <column name="ifStackStatus" oid="1.3.6.1.2.1.31.1.2.1.3" status="current">
 960           <syntax>
 961             <type module="SNMPv2-TC" name="RowStatus"/>
 962           </syntax>
 963           <access>readwrite</access>
 964           <description>
 965               The status of the relationship between two sub-layers.
 966
 967               Changing the value of this object from 'active' to
 968               'notInService' or 'destroy' will likely have consequences up
 969               and down the interface stack.  Thus, write access to this
 970               object is likely to be inappropriate for some types of
 971               interfaces, and many implementations will choose not to
 972               support write-access for any type of interface.
 973           </description>
 974         </column>
 975       </row>
 976     </table>
 977     <table name="ifTestTable" oid="1.3.6.1.2.1.31.1.3" status="deprecated">
 978       <description>
 979           This table contains one entry per interface.  It defines
 980           objects which allow a network manager to instruct an agent
 981           to test an interface for various faults.  Tests for an
 982           interface are defined in the media-specific MIB for that
 983           interface.  After invoking a test, the object ifTestResult
 984           can be read to determine the outcome.  If an agent can not
 985           perform the test, ifTestResult is set to so indicate.  The
 986           object ifTestCode can be used to provide further test-
 987           specific or interface-specific (or even enterprise-specific)
 988           information concerning the outcome of the test.  Only one
 989           test can be in progress on each interface at any one time.
 990           If one test is in progress when another test is invoked, the
 991           second test is rejected.  Some agents may reject a test when
 992           a prior test is active on another interface.
 993
 994           Before starting a test, a manager-station must first obtain
 995           'ownership' of the entry in the ifTestTable for the
 996           interface to be tested.  This is accomplished with the
 997           ifTestId and ifTestStatus objects as follows:
 998
 999           try_again:
1000             get (ifTestId, ifTestStatus)
1001             while (ifTestStatus != notInUse)
1002                 /*
1003                  * Loop while a test is running or some other
1004                  * manager is configuring a test.
1005                  */
1006                 short delay
1007                 get (ifTestId, ifTestStatus)
1008             }
1009
1010             /*
1011              * Is not being used right now -- let's compete
1012              * to see who gets it.
1013              */
1014             lock_value = ifTestId
1015
1016             if ( set(ifTestId = lock_value, ifTestStatus = inUse,
1017
1018
1019                      ifTestOwner = 'my-IP-address') == FAILURE)
1020                 /*
1021                  * Another manager got the ifTestEntry -- go
1022                  * try again
1023                  */
1024                 goto try_again;
1025
1026             /*
1027              * I have the lock
1028              */
1029             set up any test parameters.
1030
1031             /*
1032              * This starts the test
1033              */
1034             set(ifTestType = test_to_run);
1035
1036             wait for test completion by polling ifTestResult
1037
1038             when test completes, agent sets ifTestResult
1039                  agent also sets ifTestStatus = 'notInUse'
1040
1041             retrieve any additional test results, and ifTestId
1042
1043             if (ifTestId == lock_value+1) results are valid
1044
1045           A manager station first retrieves the value of the
1046           appropriate ifTestId and ifTestStatus objects, periodically
1047           repeating the retrieval if necessary, until the value of
1048           ifTestStatus is 'notInUse'.  The manager station then tries
1049           to set the same ifTestId object to the value it just
1050           retrieved, the same ifTestStatus object to 'inUse', and the
1051           corresponding ifTestOwner object to a value indicating
1052           itself.  If the set operation succeeds then the manager has
1053           obtained ownership of the ifTestEntry, and the value of the
1054           ifTestId object is incremented by the agent (per the
1055           semantics of TestAndIncr).  Failure of the set operation
1056           indicates that some other manager has obtained ownership of
1057           the ifTestEntry.
1058
1059           Once ownership is obtained, any test parameters can be
1060           setup, and then the test is initiated by setting ifTestType.
1061           On completion of the test, the agent sets ifTestStatus to
1062           'notInUse'.  Once this occurs, the manager can retrieve the
1063           results.  In the (rare) event that the invocation of tests
1064           by two network managers were to overlap, then there would be
1065           a possibility that the first test's results might be
1066           overwritten by the second test's results prior to the first
1067
1068
1069           results being read.  This unlikely circumstance can be
1070           detected by a network manager retrieving ifTestId at the
1071           same time as retrieving the test results, and ensuring that
1072           the results are for the desired request.
1073
1074           If ifTestType is not set within an abnormally long period of
1075           time after ownership is obtained, the agent should time-out
1076           the manager, and reset the value of the ifTestStatus object
1077           back to 'notInUse'.  It is suggested that this time-out
1078           period be 5 minutes.
1079
1080           In general, a management station must not retransmit a
1081           request to invoke a test for which it does not receive a
1082           response; instead, it properly inspects an agent's MIB to
1083           determine if the invocation was successful.  Only if the
1084           invocation was unsuccessful, is the invocation request
1085           retransmitted.
1086
1087           Some tests may require the interface to be taken off-line in
1088           order to execute them, or may even require the agent to
1089           reboot after completion of the test.  In these
1090           circumstances, communication with the management station
1091           invoking the test may be lost until after completion of the
1092           test.  An agent is not required to support such tests.
1093           However, if such tests are supported, then the agent should
1094           make every effort to transmit a response to the request
1095           which invoked the test prior to losing communication.  When
1096           the agent is restored to normal service, the results of the
1097           test are properly made available in the appropriate objects.
1098           Note that this requires that the ifIndex value assigned to
1099           an interface must be unchanged even if the test causes a
1100           reboot.  An agent must reject any test for which it cannot,
1101           perhaps due to resource constraints, make available at least
1102           the minimum amount of information after that test
1103           completes.
1104       </description>
1105       <row name="ifTestEntry" oid="1.3.6.1.2.1.31.1.3.1" status="deprecated">
1106         <linkage>
1107           <augments module="IF-MIB" name="ifEntry"/>
1108         </linkage>
1109         <description>
1110             An entry containing objects for invoking tests on an
1111             interface.
1112         </description>
1113         <column name="ifTestId" oid="1.3.6.1.2.1.31.1.3.1.1" status="deprecated">
1114           <syntax>
1115             <type module="SNMPv2-TC" name="TestAndIncr"/>
1116           </syntax>
1117           <access>readwrite</access>
1118           <description>
1119               This object identifies the current invocation of the
1120               interface's test.
1121           </description>
1122         </column>
1123         <column name="ifTestStatus" oid="1.3.6.1.2.1.31.1.3.1.2" status="deprecated">
1124           <syntax>
1125             <typedef basetype="Enumeration">
1126               <namednumber name="notInUse" number="1"/>
1127               <namednumber name="inUse" number="2"/>
1128             </typedef>
1129           </syntax>
1130           <access>readwrite</access>
1131           <description>
1132               This object indicates whether or not some manager currently
1133               has the necessary 'ownership' required to invoke a test on
1134               this interface.  A write to this object is only successful
1135               when it changes its value from 'notInUse(1)' to 'inUse(2)'.
1136               After completion of a test, the agent resets the value back
1137               to 'notInUse(1)'.
1138           </description>
1139         </column>
1140         <column name="ifTestType" oid="1.3.6.1.2.1.31.1.3.1.3" status="deprecated">
1141           <syntax>
1142             <type module="SNMPv2-TC" name="AutonomousType"/>
1143           </syntax>
1144           <access>readwrite</access>
1145           <description>
1146               A control variable used to start and stop operator-
1147               initiated interface tests.  Most OBJECT IDENTIFIER values
1148               assigned to tests are defined elsewhere, in association with
1149               specific types of interface.  However, this document assigns
1150               a value for a full-duplex loopback test, and defines the
1151               special meanings of the subject identifier:
1152
1153                   noTest  OBJECT IDENTIFIER ::= { 0 0 }
1154
1155               When the value noTest is written to this object, no action
1156               is taken unless a test is in progress, in which case the
1157               test is aborted.  Writing any other value to this object is
1158
1159
1160               only valid when no test is currently in progress, in which
1161               case the indicated test is initiated.
1162
1163               When read, this object always returns the most recent value
1164               that ifTestType was set to.  If it has not been set since
1165               the last initialization of the network management subsystem
1166               on the agent, a value of noTest is returned.
1167           </description>
1168         </column>
1169         <column name="ifTestResult" oid="1.3.6.1.2.1.31.1.3.1.4" status="deprecated">
1170           <syntax>
1171             <typedef basetype="Enumeration">
1172               <namednumber name="none" number="1"/>
1173               <namednumber name="success" number="2"/>
1174               <namednumber name="inProgress" number="3"/>
1175               <namednumber name="notSupported" number="4"/>
1176               <namednumber name="unAbleToRun" number="5"/>
1177               <namednumber name="aborted" number="6"/>
1178               <namednumber name="failed" number="7"/>
1179             </typedef>
1180           </syntax>
1181           <access>readonly</access>
1182           <description>
1183               This object contains the result of the most recently
1184               requested test, or the value none(1) if no tests have been
1185               requested since the last reset.  Note that this facility
1186               provides no provision for saving the results of one test
1187               when starting another, as could be required if used by
1188               multiple managers concurrently.
1189           </description>
1190         </column>
1191         <column name="ifTestCode" oid="1.3.6.1.2.1.31.1.3.1.5" status="deprecated">
1192           <syntax>
1193             <type module="" name="ObjectIdentifier"/>
1194           </syntax>
1195           <access>readonly</access>
1196           <description>
1197               This object contains a code which contains more specific
1198               information on the test result, for example an error-code
1199               after a failed test.  Error codes and other values this
1200               object may take are specific to the type of interface and/or
1201               test.  The value may have the semantics of either the
1202               AutonomousType or InstancePointer textual conventions as
1203               defined in RFC 2579.  The identifier:
1204
1205                   testCodeUnknown  OBJECT IDENTIFIER ::= { 0 0 }
1206
1207               is defined for use if no additional result code is
1208               available.
1209           </description>
1210         </column>
1211         <column name="ifTestOwner" oid="1.3.6.1.2.1.31.1.3.1.6" status="deprecated">
1212           <syntax>
1213             <type module="IF-MIB" name="OwnerString"/>
1214           </syntax>
1215           <access>readwrite</access>
1216           <description>
1217               The entity which currently has the 'ownership' required to
1218               invoke a test on this interface.
1219           </description>
1220         </column>
1221       </row>
1222     </table>
1223     <table name="ifRcvAddressTable" oid="1.3.6.1.2.1.31.1.4" status="current">
1224       <description>
1225           This table contains an entry for each address (broadcast,
1226           multicast, or uni-cast) for which the system will receive
1227           packets/frames on a particular interface, except as follows:
1228
1229           - for an interface operating in promiscuous mode, entries
1230           are only required for those addresses for which the system
1231           would receive frames were it not operating in promiscuous
1232           mode.
1233
1234
1235           - for 802.5 functional addresses, only one entry is
1236           required, for the address which has the functional address
1237           bit ANDed with the bit mask of all functional addresses for
1238           which the interface will accept frames.
1239
1240           A system is normally able to use any unicast address which
1241           corresponds to an entry in this table as a source address.
1242       </description>
1243       <row name="ifRcvAddressEntry" oid="1.3.6.1.2.1.31.1.4.1" create="true" status="current">
1244         <linkage>
1245           <index module="IF-MIB" name="ifIndex"/>
1246           <index module="IF-MIB" name="ifRcvAddressAddress"/>
1247         </linkage>
1248         <description>
1249             A list of objects identifying an address for which the
1250             system will accept packets/frames on the particular
1251             interface identified by the index value ifIndex.
1252         </description>
1253         <column name="ifRcvAddressAddress" oid="1.3.6.1.2.1.31.1.4.1.1" status="current">
1254           <syntax>
1255             <type module="SNMPv2-TC" name="PhysAddress"/>
1256           </syntax>
1257           <access>noaccess</access>
1258           <description>
1259               An address for which the system will accept packets/frames
1260               on this entry's interface.
1261           </description>
1262         </column>
1263         <column name="ifRcvAddressStatus" oid="1.3.6.1.2.1.31.1.4.1.2" status="current">
1264           <syntax>
1265             <type module="SNMPv2-TC" name="RowStatus"/>
1266           </syntax>
1267           <access>readwrite</access>
1268           <description>
1269               This object is used to create and delete rows in the
1270               ifRcvAddressTable.
1271           </description>
1272         </column>
1273         <column name="ifRcvAddressType" oid="1.3.6.1.2.1.31.1.4.1.3" status="current">
1274           <syntax>
1275             <typedef basetype="Enumeration">
1276               <namednumber name="other" number="1"/>
1277               <namednumber name="volatile" number="2"/>
1278               <namednumber name="nonVolatile" number="3"/>
1279             </typedef>
1280           </syntax>
1281           <access>readwrite</access>
1282           <default>volatile</default>
1283           <description>
1284               This object has the value nonVolatile(3) for those entries
1285               in the table which are valid and will not be deleted by the
1286               next restart of the managed system.  Entries having the
1287               value volatile(2) are valid and exist, but have not been
1288               saved, so that will not exist after the next restart of the
1289               managed system.  Entries having the value other(1) are valid
1290               and exist but are not classified as to whether they will
1291               continue to exist after the next restart.
1292           </description>
1293         </column>
1294       </row>
1295     </table>
1296     <scalar name="ifTableLastChange" oid="1.3.6.1.2.1.31.1.5" status="current">
1297       <syntax>
1298         <type module="SNMPv2-SMI" name="TimeTicks"/>
1299       </syntax>
1300       <access>readonly</access>
1301       <description>
1302           The value of sysUpTime at the time of the last creation or
1303           deletion of an entry in the ifTable.  If the number of
1304           entries has been unchanged since the last re-initialization
1305           of the local network management subsystem, then this object
1306           contains a zero value.
1307       </description>
1308     </scalar>
1309     <scalar name="ifStackLastChange" oid="1.3.6.1.2.1.31.1.6" status="current">
1310       <syntax>
1311         <type module="SNMPv2-SMI" name="TimeTicks"/>
1312       </syntax>
1313       <access>readonly</access>
1314       <description>
1315           The value of sysUpTime at the time of the last change of
1316           the (whole) interface stack.  A change of the interface
1317           stack is defined to be any creation, deletion, or change in
1318           value of any instance of ifStackStatus.  If the interface
1319           stack has been unchanged since the last re-initialization of
1320           the local network management subsystem, then this object
1321           contains a zero value.
1322       </description>
1323     </scalar>
1324     <node name="ifConformance" oid="1.3.6.1.2.1.31.2">
1325     </node>
1326     <node name="ifGroups" oid="1.3.6.1.2.1.31.2.1">
1327     </node>
1328     <node name="ifCompliances" oid="1.3.6.1.2.1.31.2.2">
1329     </node>
1330   </nodes>
1331
1332   <notifications>
1333     <notification name="linkDown" oid="1.3.6.1.6.3.1.1.5.3" status="current">
1334       <objects>
1335         <object module="IF-MIB" name="ifIndex"/>
1336         <object module="IF-MIB" name="ifAdminStatus"/>
1337         <object module="IF-MIB" name="ifOperStatus"/>
1338       </objects>
1339       <description>
1340           A linkDown trap signifies that the SNMP entity, acting in
1341           an agent role, has detected that the ifOperStatus object for
1342           one of its communication links is about to enter the down
1343           state from some other state (but not from the notPresent
1344           state).  This other state is indicated by the included value
1345           of ifOperStatus.
1346       </description>
1347     </notification>
1348     <notification name="linkUp" oid="1.3.6.1.6.3.1.1.5.4" status="current">
1349       <objects>
1350         <object module="IF-MIB" name="ifIndex"/>
1351         <object module="IF-MIB" name="ifAdminStatus"/>
1352         <object module="IF-MIB" name="ifOperStatus"/>
1353       </objects>
1354       <description>
1355           A linkUp trap signifies that the SNMP entity, acting in an
1356           agent role, has detected that the ifOperStatus object for
1357           one of its communication links left the down state and
1358           transitioned into some other state (but not into the
1359           notPresent state).  This other state is indicated by the
1360           included value of ifOperStatus.
1361       </description>
1362     </notification>
1363   </notifications>
1364
1365   <groups>
1366     <group name="ifGeneralGroup" oid="1.3.6.1.2.1.31.2.1.1" status="deprecated">
1367       <members>
1368         <member module="IF-MIB" name="ifDescr"/>
1369         <member module="IF-MIB" name="ifType"/>
1370         <member module="IF-MIB" name="ifSpeed"/>
1371         <member module="IF-MIB" name="ifPhysAddress"/>
1372         <member module="IF-MIB" name="ifAdminStatus"/>
1373         <member module="IF-MIB" name="ifOperStatus"/>
1374         <member module="IF-MIB" name="ifLastChange"/>
1375         <member module="IF-MIB" name="ifLinkUpDownTrapEnable"/>
1376         <member module="IF-MIB" name="ifConnectorPresent"/>
1377         <member module="IF-MIB" name="ifHighSpeed"/>
1378         <member module="IF-MIB" name="ifName"/>
1379       </members>
1380       <description>
1381           A collection of objects deprecated in favour of
1382           ifGeneralInformationGroup.
1383       </description>
1384     </group>
1385     <group name="ifFixedLengthGroup" oid="1.3.6.1.2.1.31.2.1.2" status="current">
1386       <members>
1387         <member module="IF-MIB" name="ifInOctets"/>
1388         <member module="IF-MIB" name="ifOutOctets"/>
1389         <member module="IF-MIB" name="ifInUnknownProtos"/>
1390         <member module="IF-MIB" name="ifInErrors"/>
1391         <member module="IF-MIB" name="ifOutErrors"/>
1392       </members>
1393       <description>
1394           A collection of objects providing information specific to
1395           non-high speed (non-high speed interfaces transmit and
1396           receive at speeds less than or equal to 20,000,000
1397           bits/second) character-oriented or fixed-length-transmission
1398           network interfaces.
1399       </description>
1400     </group>
1401     <group name="ifHCFixedLengthGroup" oid="1.3.6.1.2.1.31.2.1.3" status="current">
1402       <members>
1403         <member module="IF-MIB" name="ifHCInOctets"/>
1404         <member module="IF-MIB" name="ifHCOutOctets"/>
1405         <member module="IF-MIB" name="ifInOctets"/>
1406         <member module="IF-MIB" name="ifOutOctets"/>
1407         <member module="IF-MIB" name="ifInUnknownProtos"/>
1408         <member module="IF-MIB" name="ifInErrors"/>
1409         <member module="IF-MIB" name="ifOutErrors"/>
1410       </members>
1411       <description>
1412           A collection of objects providing information specific to
1413           high speed (greater than 20,000,000 bits/second) character-
1414           oriented or fixed-length-transmission network interfaces.
1415       </description>
1416     </group>
1417     <group name="ifPacketGroup" oid="1.3.6.1.2.1.31.2.1.4" status="current">
1418       <members>
1419         <member module="IF-MIB" name="ifInOctets"/>
1420         <member module="IF-MIB" name="ifOutOctets"/>
1421         <member module="IF-MIB" name="ifInUnknownProtos"/>
1422         <member module="IF-MIB" name="ifInErrors"/>
1423         <member module="IF-MIB" name="ifOutErrors"/>
1424         <member module="IF-MIB" name="ifMtu"/>
1425         <member module="IF-MIB" name="ifInUcastPkts"/>
1426         <member module="IF-MIB" name="ifInMulticastPkts"/>
1427         <member module="IF-MIB" name="ifInBroadcastPkts"/>
1428         <member module="IF-MIB" name="ifInDiscards"/>
1429         <member module="IF-MIB" name="ifOutUcastPkts"/>
1430         <member module="IF-MIB" name="ifOutMulticastPkts"/>
1431         <member module="IF-MIB" name="ifOutBroadcastPkts"/>
1432         <member module="IF-MIB" name="ifOutDiscards"/>
1433         <member module="IF-MIB" name="ifPromiscuousMode"/>
1434       </members>
1435       <description>
1436           A collection of objects providing information specific to
1437           non-high speed (non-high speed interfaces transmit and
1438           receive at speeds less than or equal to 20,000,000
1439           bits/second) packet-oriented network interfaces.
1440       </description>
1441     </group>
1442     <group name="ifHCPacketGroup" oid="1.3.6.1.2.1.31.2.1.5" status="current">
1443       <members>
1444         <member module="IF-MIB" name="ifHCInOctets"/>
1445         <member module="IF-MIB" name="ifHCOutOctets"/>
1446         <member module="IF-MIB" name="ifInOctets"/>
1447         <member module="IF-MIB" name="ifOutOctets"/>
1448         <member module="IF-MIB" name="ifInUnknownProtos"/>
1449         <member module="IF-MIB" name="ifInErrors"/>
1450         <member module="IF-MIB" name="ifOutErrors"/>
1451         <member module="IF-MIB" name="ifMtu"/>
1452         <member module="IF-MIB" name="ifInUcastPkts"/>
1453         <member module="IF-MIB" name="ifInMulticastPkts"/>
1454         <member module="IF-MIB" name="ifInBroadcastPkts"/>
1455         <member module="IF-MIB" name="ifInDiscards"/>
1456         <member module="IF-MIB" name="ifOutUcastPkts"/>
1457         <member module="IF-MIB" name="ifOutMulticastPkts"/>
1458         <member module="IF-MIB" name="ifOutBroadcastPkts"/>
1459         <member module="IF-MIB" name="ifOutDiscards"/>
1460         <member module="IF-MIB" name="ifPromiscuousMode"/>
1461       </members>
1462       <description>
1463           A collection of objects providing information specific to
1464           high speed (greater than 20,000,000 bits/second but less
1465           than or equal to 650,000,000 bits/second) packet-oriented
1466           network interfaces.
1467       </description>
1468     </group>
1469     <group name="ifVHCPacketGroup" oid="1.3.6.1.2.1.31.2.1.6" status="current">
1470       <members>
1471         <member module="IF-MIB" name="ifHCInUcastPkts"/>
1472         <member module="IF-MIB" name="ifHCInMulticastPkts"/>
1473         <member module="IF-MIB" name="ifHCInBroadcastPkts"/>
1474         <member module="IF-MIB" name="ifHCOutUcastPkts"/>
1475         <member module="IF-MIB" name="ifHCOutMulticastPkts"/>
1476         <member module="IF-MIB" name="ifHCOutBroadcastPkts"/>
1477         <member module="IF-MIB" name="ifHCInOctets"/>
1478         <member module="IF-MIB" name="ifHCOutOctets"/>
1479         <member module="IF-MIB" name="ifInOctets"/>
1480         <member module="IF-MIB" name="ifOutOctets"/>
1481         <member module="IF-MIB" name="ifInUnknownProtos"/>
1482         <member module="IF-MIB" name="ifInErrors"/>
1483         <member module="IF-MIB" name="ifOutErrors"/>
1484         <member module="IF-MIB" name="ifMtu"/>
1485         <member module="IF-MIB" name="ifInUcastPkts"/>
1486         <member module="IF-MIB" name="ifInMulticastPkts"/>
1487         <member module="IF-MIB" name="ifInBroadcastPkts"/>
1488         <member module="IF-MIB" name="ifInDiscards"/>
1489         <member module="IF-MIB" name="ifOutUcastPkts"/>
1490         <member module="IF-MIB" name="ifOutMulticastPkts"/>
1491         <member module="IF-MIB" name="ifOutBroadcastPkts"/>
1492         <member module="IF-MIB" name="ifOutDiscards"/>
1493         <member module="IF-MIB" name="ifPromiscuousMode"/>
1494       </members>
1495       <description>
1496           A collection of objects providing information specific to
1497           higher speed (greater than 650,000,000 bits/second) packet-
1498           oriented network interfaces.
1499       </description>
1500     </group>
1501     <group name="ifRcvAddressGroup" oid="1.3.6.1.2.1.31.2.1.7" status="current">
1502       <members>
1503         <member module="IF-MIB" name="ifRcvAddressStatus"/>
1504         <member module="IF-MIB" name="ifRcvAddressType"/>
1505       </members>
1506       <description>
1507           A collection of objects providing information on the
1508           multiple addresses which an interface receives.
1509       </description>
1510     </group>
1511     <group name="ifTestGroup" oid="1.3.6.1.2.1.31.2.1.8" status="deprecated">
1512       <members>
1513         <member module="IF-MIB" name="ifTestId"/>
1514         <member module="IF-MIB" name="ifTestStatus"/>
1515         <member module="IF-MIB" name="ifTestType"/>
1516         <member module="IF-MIB" name="ifTestResult"/>
1517         <member module="IF-MIB" name="ifTestCode"/>
1518         <member module="IF-MIB" name="ifTestOwner"/>
1519       </members>
1520       <description>
1521           A collection of objects providing the ability to invoke
1522           tests on an interface.
1523       </description>
1524     </group>
1525     <group name="ifStackGroup" oid="1.3.6.1.2.1.31.2.1.9" status="deprecated">
1526       <members>
1527         <member module="IF-MIB" name="ifStackStatus"/>
1528       </members>
1529       <description>
1530           The previous collection of objects providing information on
1531           the layering of MIB-II interfaces.
1532       </description>
1533     </group>
1534     <group name="ifGeneralInformationGroup" oid="1.3.6.1.2.1.31.2.1.10" status="current">
1535       <members>
1536         <member module="IF-MIB" name="ifIndex"/>
1537         <member module="IF-MIB" name="ifDescr"/>
1538         <member module="IF-MIB" name="ifType"/>
1539         <member module="IF-MIB" name="ifSpeed"/>
1540         <member module="IF-MIB" name="ifPhysAddress"/>
1541         <member module="IF-MIB" name="ifAdminStatus"/>
1542         <member module="IF-MIB" name="ifOperStatus"/>
1543         <member module="IF-MIB" name="ifLastChange"/>
1544         <member module="IF-MIB" name="ifLinkUpDownTrapEnable"/>
1545         <member module="IF-MIB" name="ifConnectorPresent"/>
1546         <member module="IF-MIB" name="ifHighSpeed"/>
1547         <member module="IF-MIB" name="ifName"/>
1548         <member module="IF-MIB" name="ifNumber"/>
1549         <member module="IF-MIB" name="ifAlias"/>
1550         <member module="IF-MIB" name="ifTableLastChange"/>
1551       </members>
1552       <description>
1553           A collection of objects providing information applicable to
1554           all network interfaces.
1555       </description>
1556     </group>
1557     <group name="ifStackGroup2" oid="1.3.6.1.2.1.31.2.1.11" status="current">
1558       <members>
1559         <member module="IF-MIB" name="ifStackStatus"/>
1560         <member module="IF-MIB" name="ifStackLastChange"/>
1561       </members>
1562       <description>
1563           A collection of objects providing information on the
1564           layering of MIB-II interfaces.
1565       </description>
1566     </group>
1567     <group name="ifOldObjectsGroup" oid="1.3.6.1.2.1.31.2.1.12" status="deprecated">
1568       <members>
1569         <member module="IF-MIB" name="ifInNUcastPkts"/>
1570         <member module="IF-MIB" name="ifOutNUcastPkts"/>
1571         <member module="IF-MIB" name="ifOutQLen"/>
1572         <member module="IF-MIB" name="ifSpecific"/>
1573       </members>
1574       <description>
1575           The collection of objects deprecated from the original MIB-
1576           II interfaces group.
1577       </description>
1578     </group>
1579     <group name="ifCounterDiscontinuityGroup" oid="1.3.6.1.2.1.31.2.1.13" status="current">
1580       <members>
1581         <member module="IF-MIB" name="ifCounterDiscontinuityTime"/>
1582       </members>
1583       <description>
1584           A collection of objects providing information specific to
1585           interface counter discontinuities.
1586       </description>
1587     </group>
1588     <group name="linkUpDownNotificationsGroup" oid="1.3.6.1.2.1.31.2.1.14" status="current">
1589       <members>
1590         <member module="IF-MIB" name="linkUp"/>
1591         <member module="IF-MIB" name="linkDown"/>
1592       </members>
1593       <description>
1594           The notifications which indicate specific changes in the
1595           value of ifOperStatus.
1596       </description>
1597     </group>
1598   </groups>
1599
1600   <compliances>
1601     <compliance name="ifCompliance" oid="1.3.6.1.2.1.31.2.2.1" status="deprecated">
1602       <description>
1603           A compliance statement defined in a previous version of
1604           this MIB module, for SNMP entities which have network
1605           interfaces.
1606       </description>
1607       <requires>
1608         <mandatory module="IF-MIB" name="ifGeneralGroup"/>
1609         <mandatory module="IF-MIB" name="ifStackGroup"/>
1610         <option module="IF-MIB" name="ifFixedLengthGroup">
1611           <description>
1612               This group is mandatory for all network interfaces which
1613               are character-oriented or transmit data in fixed-length
1614               transmission units.
1615           </description>
1616         </option>
1617         <option module="IF-MIB" name="ifHCFixedLengthGroup">
1618           <description>
1619               This group is mandatory only for those network interfaces
1620               which are character-oriented or transmit data in fixed-
1621               length transmission units, and for which the value of the
1622               corresponding instance of ifSpeed is greater than 20,000,000
1623               bits/second.
1624           </description>
1625         </option>
1626         <option module="IF-MIB" name="ifPacketGroup">
1627           <description>
1628               This group is mandatory for all network interfaces which
1629               are packet-oriented.
1630           </description>
1631         </option>
1632         <option module="IF-MIB" name="ifHCPacketGroup">
1633           <description>
1634               This group is mandatory only for those network interfaces
1635               which are packet-oriented and for which the value of the
1636               corresponding instance of ifSpeed is greater than
1637               650,000,000 bits/second.
1638           </description>
1639         </option>
1640         <option module="IF-MIB" name="ifTestGroup">
1641           <description>
1642               This group is optional.  Media-specific MIBs which require
1643               interface tests are strongly encouraged to use this group
1644               for invoking tests and reporting results.  A medium specific
1645               MIB which has mandatory tests may make implementation of
1646
1647
1648               this group mandatory.
1649           </description>
1650         </option>
1651         <option module="IF-MIB" name="ifRcvAddressGroup">
1652           <description>
1653               The applicability of this group MUST be defined by the
1654               media-specific MIBs.  Media-specific MIBs must define the
1655               exact meaning, use, and semantics of the addresses in this
1656               group.
1657           </description>
1658         </option>
1659       </requires>
1660       <refinements>
1661         <refinement module="IF-MIB" name="ifLinkUpDownTrapEnable">
1662           <access>readonly</access>
1663           <description>
1664               Write access is not required.
1665           </description>
1666         </refinement>
1667         <refinement module="IF-MIB" name="ifPromiscuousMode">
1668           <access>readonly</access>
1669           <description>
1670               Write access is not required.
1671           </description>
1672         </refinement>
1673         <refinement module="IF-MIB" name="ifStackStatus">
1674           <syntax>
1675             <typedef basetype="Enumeration">
1676               <parent module="SNMPv2-TC" name="RowStatus"/>
1677               <namednumber name="active" number="1"/>
1678             </typedef>
1679           </syntax>
1680           <access>readonly</access>
1681           <description>
1682               Write access is not required, and only one of the six
1683               enumerated values for the RowStatus textual convention need
1684               be supported, specifically: active(1).
1685           </description>
1686         </refinement>
1687         <refinement module="IF-MIB" name="ifAdminStatus">
1688           <syntax>
1689             <typedef basetype="Enumeration">
1690               <namednumber name="up" number="1"/>
1691               <namednumber name="down" number="2"/>
1692             </typedef>
1693           </syntax>
1694           <access>readonly</access>
1695           <description>
1696               Write access is not required, nor is support for the value
1697               testing(3).
1698           </description>
1699         </refinement>
1700       </refinements>
1701
1702     </compliance>
1703     <compliance name="ifCompliance2" oid="1.3.6.1.2.1.31.2.2.2" status="deprecated">
1704       <description>
1705           A compliance statement defined in a previous version of
1706           this MIB module, for SNMP entities which have network
1707           interfaces.
1708       </description>
1709       <requires>
1710         <mandatory module="IF-MIB" name="ifGeneralInformationGroup"/>
1711         <mandatory module="IF-MIB" name="ifStackGroup2"/>
1712         <mandatory module="IF-MIB" name="ifCounterDiscontinuityGroup"/>
1713         <option module="IF-MIB" name="ifFixedLengthGroup">
1714           <description>
1715               This group is mandatory for all network interfaces which
1716               are character-oriented or transmit data in fixed-length
1717               transmission units.
1718           </description>
1719         </option>
1720         <option module="IF-MIB" name="ifHCFixedLengthGroup">
1721           <description>
1722               This group is mandatory only for those network interfaces
1723               which are character-oriented or transmit data in fixed-
1724               length transmission units, and for which the value of the
1725               corresponding instance of ifSpeed is greater than 20,000,000
1726               bits/second.
1727           </description>
1728         </option>
1729         <option module="IF-MIB" name="ifPacketGroup">
1730           <description>
1731               This group is mandatory for all network interfaces which
1732               are packet-oriented.
1733           </description>
1734         </option>
1735         <option module="IF-MIB" name="ifHCPacketGroup">
1736           <description>
1737               This group is mandatory only for those network interfaces
1738               which are packet-oriented and for which the value of the
1739               corresponding instance of ifSpeed is greater than
1740               650,000,000 bits/second.
1741           </description>
1742         </option>
1743         <option module="IF-MIB" name="ifRcvAddressGroup">
1744           <description>
1745               The applicability of this group MUST be defined by the
1746               media-specific MIBs.  Media-specific MIBs must define the
1747               exact meaning, use, and semantics of the addresses in this
1748               group.
1749           </description>
1750         </option>
1751       </requires>
1752       <refinements>
1753         <refinement module="IF-MIB" name="ifLinkUpDownTrapEnable">
1754           <access>readonly</access>
1755           <description>
1756               Write access is not required.
1757           </description>
1758         </refinement>
1759         <refinement module="IF-MIB" name="ifPromiscuousMode">
1760           <access>readonly</access>
1761           <description>
1762               Write access is not required.
1763           </description>
1764         </refinement>
1765         <refinement module="IF-MIB" name="ifStackStatus">
1766           <syntax>
1767             <typedef basetype="Enumeration">
1768               <parent module="SNMPv2-TC" name="RowStatus"/>
1769               <namednumber name="active" number="1"/>
1770             </typedef>
1771           </syntax>
1772           <access>readonly</access>
1773           <description>
1774               Write access is not required, and only one of the six
1775               enumerated values for the RowStatus textual convention need
1776               be supported, specifically: active(1).
1777           </description>
1778         </refinement>
1779         <refinement module="IF-MIB" name="ifAdminStatus">
1780           <syntax>
1781             <typedef basetype="Enumeration">
1782               <namednumber name="up" number="1"/>
1783               <namednumber name="down" number="2"/>
1784             </typedef>
1785           </syntax>
1786           <access>readonly</access>
1787           <description>
1788               Write access is not required, nor is support for the value
1789               testing(3).
1790           </description>
1791         </refinement>
1792         <refinement module="IF-MIB" name="ifAlias">
1793           <access>readonly</access>
1794           <description>
1795               Write access is not required.
1796           </description>
1797         </refinement>
1798       </refinements>
1799
1800     </compliance>
1801     <compliance name="ifCompliance3" oid="1.3.6.1.2.1.31.2.2.3" status="current">
1802       <description>
1803           The compliance statement for SNMP entities which have
1804           network interfaces.
1805       </description>
1806       <requires>
1807         <mandatory module="IF-MIB" name="ifGeneralInformationGroup"/>
1808         <mandatory module="IF-MIB" name="linkUpDownNotificationsGroup"/>
1809         <option module="IF-MIB" name="ifFixedLengthGroup">
1810           <description>
1811               This group is mandatory for those network interfaces which
1812               are character-oriented or transmit data in fixed-length
1813               transmission units, and for which the value of the
1814               corresponding instance of ifSpeed is less than or equal to
1815               20,000,000 bits/second.
1816           </description>
1817         </option>
1818         <option module="IF-MIB" name="ifHCFixedLengthGroup">
1819           <description>
1820               This group is mandatory for those network interfaces which
1821               are character-oriented or transmit data in fixed-length
1822               transmission units, and for which the value of the
1823               corresponding instance of ifSpeed is greater than 20,000,000
1824               bits/second.
1825           </description>
1826         </option>
1827         <option module="IF-MIB" name="ifPacketGroup">
1828           <description>
1829               This group is mandatory for those network interfaces which
1830               are packet-oriented, and for which the value of the
1831               corresponding instance of ifSpeed is less than or equal to
1832               20,000,000 bits/second.
1833           </description>
1834         </option>
1835         <option module="IF-MIB" name="ifHCPacketGroup">
1836           <description>
1837               This group is mandatory only for those network interfaces
1838               which are packet-oriented and for which the value of the
1839               corresponding instance of ifSpeed is greater than 20,000,000
1840               bits/second but less than or equal to 650,000,000
1841               bits/second.
1842           </description>
1843         </option>
1844         <option module="IF-MIB" name="ifVHCPacketGroup">
1845           <description>
1846               This group is mandatory only for those network interfaces
1847               which are packet-oriented and for which the value of the
1848               corresponding instance of ifSpeed is greater than
1849               650,000,000 bits/second.
1850           </description>
1851         </option>
1852         <option module="IF-MIB" name="ifCounterDiscontinuityGroup">
1853           <description>
1854               This group is mandatory for those network interfaces that
1855               are required to maintain counters (i.e., those for which one
1856               of the ifFixedLengthGroup, ifHCFixedLengthGroup,
1857               ifPacketGroup, ifHCPacketGroup, or ifVHCPacketGroup is
1858               mandatory).
1859           </description>
1860         </option>
1861         <option module="IF-MIB" name="ifRcvAddressGroup">
1862           <description>
1863               The applicability of this group MUST be defined by the
1864               media-specific MIBs.  Media-specific MIBs must define the
1865               exact meaning, use, and semantics of the addresses in this
1866               group.
1867           </description>
1868         </option>
1869       </requires>
1870       <refinements>
1871         <refinement module="IF-MIB" name="ifLinkUpDownTrapEnable">
1872           <access>readonly</access>
1873           <description>
1874               Write access is not required.
1875           </description>
1876         </refinement>
1877         <refinement module="IF-MIB" name="ifPromiscuousMode">
1878           <access>readonly</access>
1879           <description>
1880               Write access is not required.
1881           </description>
1882         </refinement>
1883         <refinement module="IF-MIB" name="ifAdminStatus">
1884           <syntax>
1885             <typedef basetype="Enumeration">
1886               <namednumber name="up" number="1"/>
1887               <namednumber name="down" number="2"/>
1888             </typedef>
1889           </syntax>
1890           <access>readonly</access>
1891           <description>
1892               Write access is not required, nor is support for the value
1893               testing(3).
1894           </description>
1895         </refinement>
1896         <refinement module="IF-MIB" name="ifAlias">
1897           <access>readonly</access>
1898           <description>
1899               Write access is not required.
1900           </description>
1901         </refinement>
1902       </refinements>
1903
1904     </compliance>
1905   </compliances>
1906
1907 </smi>