home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1997 December / Internet_Info_CD-ROM_Walnut_Creek_December_1997.iso / rfc / rfc2020 < prev    next >
Text File  |  1996-10-17  |  72KB  |  1,740 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7. Network Working Group                                           J. Flick
  8. Request for Comments: 2020                               Hewlett Packard
  9. Category: Standards Track                                   October 1996
  10.  
  11.  
  12.        Definitions of Managed Objects for IEEE 802.12 Interfaces
  13.  
  14. Status of this Memo
  15.  
  16.    This document specifies an Internet standards track protocol for the
  17.    Internet community, and requests discussion and suggestions for
  18.    improvements.  Please refer to the current edition of the "Internet
  19.    Official Protocol Standards" (STD 1) for the standardization state
  20.    and status of this protocol.  Distribution of this memo is unlimited.
  21.  
  22. Table of Contents
  23.  
  24.  1.  Introduction ...............................................    1
  25.  2.  Object Definitions .........................................    2
  26.  3.  Overview ...................................................    2
  27.  3.1.  MAC Addresses ............................................    3
  28.  3.2.  Relation to RFC 1213 .....................................    3
  29.  3.3.  Relation to RFC 1573 .....................................    3
  30.  3.3.1.  Layering Model .........................................    4
  31.  3.3.2.  Virtual Circuits .......................................    4
  32.  3.3.3.  ifTestTable ............................................    4
  33.  3.3.4.  ifRcvAddressTable ......................................    4
  34.  3.3.5.  ifPhysAddress ..........................................    4
  35.  3.3.6.  Specific Interface MIB Objects .........................    5
  36.  3.4.  Relation to RFC 1643, RFC 1650, and RFC 1748 .............    8
  37.  3.5.  Relation to RFC 1749 .....................................    8
  38.  3.6.  Master Mode Operation ....................................    9
  39.  3.7.  Normal and High Priority Counters ........................    9
  40.  3.8.  IEEE 802.12 Training Frames ..............................   10
  41.  3.9.  Mapping of IEEE 802.12 Managed Objects ...................   12
  42.  4.  Definitions ................................................   14
  43.  5.  Acknowledgements ...........................................   30
  44.  6.  References .................................................   30
  45.  7.  Security Considerations ....................................   31
  46.  8.  Author's Address ...........................................   31
  47.  
  48. 1.  Introduction
  49.  
  50.    This memo defines a portion of the Management Information Base (MIB)
  51.    for use with network management protocols in TCP/IP-based internets.
  52.    In particular, it defines objects for managing network interfaces
  53.    based on IEEE 802.12.
  54.  
  55.  
  56.  
  57.  
  58. Flick                       Standards Track                     [Page 1]
  59.  
  60. RFC 2020               IEEE 802.12 Interface MIB            October 1996
  61.  
  62.  
  63. 2.  Object Definitions
  64.  
  65.    Management information is viewed as a collection of managed objects,
  66.    residing in a virtual information store, termed the Management
  67.    Information Base (MIB).  Collections of related objects are defined
  68.    in MIB modules.  MIB modules are written using a subset of Abstract
  69.    Syntax Notation One (ASN.1) [1] termed the Structure of Management
  70.    Information (SMI) [2].  In particular, each object type is named by
  71.    an OBJECT IDENTIFIER, an administratively assigned name.  The object
  72.    type together with an object instance serves to uniquely identify a
  73.    specific instantiation of the object.  For human convenience, we
  74.    often use a textual string, termed the descriptor, to refer to the
  75.    object type.
  76.  
  77. 3.  Overview
  78.  
  79.    Instances of these object types represent attributes of an interface
  80.    to an IEEE 802.12 communications medium.  At present, IEEE 802.12
  81.    media are identified by one value of the ifType object in the
  82.    Internet-standard MIB:
  83.  
  84.       ieee80212(55)
  85.  
  86.    For this interface, the value of the ifSpecific variable in the MIB-
  87.    II [5] has the OBJECT IDENTIFIER value:
  88.  
  89.       dot12MIB    OBJECT IDENTIFIER ::= { transmission 45 }
  90.  
  91.    The values for the ifType object are defined by the IANAifType
  92.    textual convention.  The Internet Assigned Numbers Authority (IANA)
  93.    is responsible for the assignment of all Internet numbers, including
  94.    new ifType values.  Therefore, IANA is responsible for maintaining
  95.    the definition of this textual convention.  The current definition of
  96.    the IANAifType textual convention is available from IANA's World Wide
  97.    Web server at:
  98.  
  99.          http://www.iana.org/iana/
  100.  
  101.    The definitions presented here are based on the IEEE Standard
  102.    802.12-1995, [6] Clause 13 "Layer management functions and services",
  103.    and Annex C "GDMO Specifications for Demand Priority Managed
  104.    Objects".  Implementors of these MIB objects should note that the
  105.    IEEE document explicitly describes (in the form of Pascal pseudocode)
  106.    when, where, and how various MAC attributes are measured.  The IEEE
  107.    document also describes the effects of MAC actions that may be
  108.    invoked by manipulating instances of the MIB objects defined here.
  109.  
  110.  
  111.  
  112.  
  113.  
  114. Flick                       Standards Track                     [Page 2]
  115.  
  116. RFC 2020               IEEE 802.12 Interface MIB            October 1996
  117.  
  118.  
  119.    To the extent that some of the attributes defined in [6] are
  120.    represented by previously defined objects in the Internet-standard
  121.    MIB [5] or in the Evolution of the Interfaces Group of MIB-II [7],
  122.    such attributes are not redundantly represented by objects defined in
  123.    this memo.  Among the attributes represented by objects defined in
  124.    other memos are the number of octets transmitted or received on a
  125.    particular interface, the MAC address of an interface, and multicast
  126.    information associated with an interface.
  127.  
  128. 3.1.  MAC Addresses
  129.  
  130.    All representations of MAC addresses in this MIB module, and in other
  131.    related MIB modules (like RFC 1573), are in "canonical" order defined
  132.    by 802.1a, i.e., as if it were transmitted least significant bit
  133.    first.  This is true even if the interface is operating in token ring
  134.    framing mode, which requires MAC addresses to be transmitted most
  135.    significant bit first.
  136.  
  137. 3.2.  Relation to RFC 1213
  138.  
  139.    This section applies only when this MIB is used in conjunction with
  140.    the "old" (i.e., pre-RFC 1573) interface group.
  141.  
  142.    The relationship between an IEEE 802.12 interface and an interface in
  143.    the context of the Internet-standard MIB is one-to-one.  As such, the
  144.    value of an ifIndex object instance can be directly used to identify
  145.    corresponding instances of the objects defined herein.
  146.  
  147. 3.3.  Relation to RFC 1573
  148.  
  149.    RFC 1573, the Interface MIB Evolution, requires that any MIB which is
  150.    an adjunct of the Interface MIB, clarify specific areas within the
  151.    Interface MIB.  These areas are intentionally left vague in RFC 1573
  152.    to avoid over constraining the MIB, thereby precluding management of
  153.    certain media-types.
  154.  
  155.    An agent which implements this MIB module must support the
  156.    ifGeneralGroup, ifStackGroup, ifHCPacketGroup, and ifRcvAddressGroup
  157.    of RFC 1573.
  158.  
  159.    Section 3.3 of RFC 1573 enumerates several areas which a media-
  160.    specific MIB must clarify.  In addition, there are some objects in
  161.    RFC 1573 for which additional clarification of how to apply them to
  162.    an IEEE 802.12 interface would be helpful.  Each of these areas is
  163.    addressed in a following subsection.  The implementor is referred to
  164.    RFC 1573 in order to understand the general intent of these areas.
  165.  
  166.  
  167.  
  168.  
  169.  
  170. Flick                       Standards Track                     [Page 3]
  171.  
  172. RFC 2020               IEEE 802.12 Interface MIB            October 1996
  173.  
  174.  
  175. 3.3.1.  Layering Model
  176.  
  177.    For the typical usage of this MIB module, there will be no sub-layers
  178.    "above" or "below" the 802.12 Interface.  However, this MIB module
  179.    does not preclude such layering.
  180.  
  181. 3.3.2.  Virtual Circuits
  182.  
  183.    This medium does not support virtual circuits and this area is not
  184.    applicable to this MIB.
  185.  
  186. 3.3.3.  ifTestTable
  187.  
  188.    This MIB does not define any tests for media instrumented by this
  189.    MIB.  Implementation of the ifTestTable is not required.  An
  190.    implementation may optionally implement the ifTestTable to execute
  191.    vendor specific tests.
  192.  
  193. 3.3.4.  ifRcvAddressTable
  194.  
  195.    This table contains all IEEE addresses, unicast, multicast, and
  196.    broadcast, for which this interface will receive packets and forward
  197.    them up to a higher layer entity for consumption.  In addition, when
  198.    the interface is using 802.5 framing mode, the ifRcvAddressTable will
  199.    contain the functional address mask.
  200.  
  201.    In the event that the interface is part of a MAC bridge, this table
  202.    does not include unicast addresses which are accepted for possible
  203.    forwarding out some other port.  This table is explicitly not
  204.    intended to provide a bridge address filtering mechanism.
  205.  
  206. 3.3.5.  ifPhysAddress
  207.  
  208.    This object contains the IEEE 802.12 address which is placed in the
  209.    source-address field of any frames that originate at this interface.
  210.    Usually this will be kept in ROM on the interface hardware.  Some
  211.    systems may set this address via software.
  212.  
  213.    In a system where there are several such addresses the designer has a
  214.    tougher choice.  The address chosen should be the one most likely to
  215.    be of use to network management (e.g.  the address placed in ARP
  216.    responses for systems which are primarily IP systems).
  217.  
  218.    If the designer truly can not choose, use of the factory-provided ROM
  219.    address is suggested.
  220.  
  221.    If the address can not be determined, an octet string of zero length
  222.    should be returned.
  223.  
  224.  
  225.  
  226. Flick                       Standards Track                     [Page 4]
  227.  
  228. RFC 2020               IEEE 802.12 Interface MIB            October 1996
  229.  
  230.  
  231.    The address is stored in binary in this object.  The address is
  232.    stored in "canonical" bit order, that is, the Group Bit is positioned
  233.    as the low-order bit of the first octet.  Thus, the first byte of a
  234.    multicast address would have the bit 0x01 set.  This is true even
  235.    when the interface is using token ring framing mode, which transmits
  236.    addresses high-order bit first.
  237.  
  238. 3.3.6.  Specific Interface MIB Objects
  239.  
  240.    The following table provides specific implementation guidelines for
  241.    the interface group objects in the conformance groups listed above.
  242.  
  243.      Object                 Use for an 802.12 Interface
  244.  
  245.      ifIndex                Each 802.12 interface is represented by an
  246.                             ifEntry.  Interface tables in this MIB
  247.                             module are indexed by ifIndex.
  248.  
  249.      ifDescr                Refer to [7].
  250.  
  251.      ifType                 The IANA reserved value for 802.12 - 55.
  252.  
  253.      ifMtu                  The value of ifMtu on an 802.12 interface
  254.                             will depend on the type of framing that is
  255.                             in use on that interface.  Changing the
  256.                             dot12DesiredFramingType may have the effect
  257.                             of changing ifMtu after the next time that
  258.                             the interface trains.  When
  259.                             dot12CurrentFramingType is equal to
  260.                             frameType88023, ifMtu will be equal to
  261.                             1500.  When dot12CurrentFramingType is
  262.                             equal to frameType88025, ifMtu will be
  263.                             4464.
  264.  
  265.      ifSpeed                The speed of the interface in bits per
  266.                             second.  For current 802.12
  267.                             implementations, this will be equal to
  268.                             100,000,000 (100 million).
  269.  
  270.      ifPhysAddress          See Section 3.3.5.
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282. Flick                       Standards Track                     [Page 5]
  283.  
  284. RFC 2020               IEEE 802.12 Interface MIB            October 1996
  285.  
  286.  
  287.      ifAdminStatus          Write access is not required.  Support for
  288.                             'testing' is not required.  Setting this
  289.                             object to 'up' will cause dot12Commands to
  290.                             be set to 'open'.  Setting this object to
  291.                             'down' will cause dot12Commands to be set
  292.                             to 'close'.  Setting dot12Commands to
  293.                             'open' will set this object to 'up'.
  294.                             Setting dot12Commands to 'close' will set
  295.                             this object to 'down'.  Setting
  296.                             dot12Commands to 'reset' will have no
  297.                             effect on this object.
  298.  
  299.      ifOperStatus           When dot12Status is equal to 'opened', this
  300.                             object will be equal to 'up'.  When
  301.                             dot12Status is equal to 'closed', 'opening',
  302.                             'openFailure' or 'linkFailure', this object
  303.                             will be equal to 'down'.  Support for
  304.                             'testing' is not required, but may be used
  305.                             to indicate that a vendor specific test is
  306.                             in progress.  The value 'dormant' has no
  307.                             meaning for an IEEE 802.12 interface.
  308.  
  309.      ifLastChange           Refer to [7].
  310.  
  311.      ifInOctets             The number of octets in valid MAC frames
  312.                             received on this interface, including the
  313.                             MAC header and FCS.
  314.  
  315.      ifInUcastPkts          Refer to [7].
  316.  
  317.      ifInDiscards           Refer to [7].
  318.  
  319.      ifInErrors             The sum for this interface of
  320.                             dot12InIPMErrors,
  321.                             dot12InOversizeFrameErrors,
  322.                             dot12InDataErrors, and any additional
  323.                             internal errors that may occur in an
  324.                             implementation.
  325.  
  326.      ifInUnknownProtos      Refer to [7].
  327.  
  328.      ifOutOctets            The number of octets transmitted in MAC
  329.                             frames on this interface, including the MAC
  330.                             header and FCS.
  331.  
  332.      ifOutUcastPkts         Refer to [7].
  333.  
  334.      ifOutDiscards          Refer to [7].
  335.  
  336.  
  337.  
  338. Flick                       Standards Track                     [Page 6]
  339.  
  340. RFC 2020               IEEE 802.12 Interface MIB            October 1996
  341.  
  342.  
  343.      ifOutErrors            The number of implementation-specific
  344.                             internal transmit errors on this interface.
  345.  
  346.      ifName                 Locally-significant textual name for the
  347.                             interface (e.g. vg0).
  348.  
  349.      ifInMulticastPkts      Refer to [7].  When dot12CurrentFramingType
  350.                             is frameType88025, this count includes
  351.                             packets addressed to functional addresses.
  352.  
  353.      ifInBroadcastPkts      Refer to [7].
  354.  
  355.      ifOutMulticastPkts     Refer to [7].  When dot12CurrentFramingType
  356.                             is frameType88025, this count includes
  357.                             packets addressed to functional addresses.
  358.  
  359.      ifOutBroadcastPkts     Refer to [7].
  360.  
  361.      ifHCInOctets           64-bit version of ifInOctets.
  362.  
  363.      ifHCOutOctets          64-bit version of ifOutOctets
  364.  
  365.      ifHC*Pkts              Not required for 100 MBit interfaces.
  366.                             Future IEEE 802.12 interfaces which operate
  367.                             at higher speeds may require implementation
  368.                             of these counters, but such interfaces are
  369.                             beyond the scope of this memo.
  370.  
  371.      ifLinkUpDownTrapEnable Refer to [7].  Default is 'enabled'.
  372.  
  373.      ifHighSpeed            The speed of the interface in millions of
  374.                             bits per second.  For current 802.12
  375.                             implementations, this will be equal to 100.
  376.  
  377.      ifPromiscuousMode      Reflects whether the interface has
  378.                             successfully trained and is currently
  379.                             operating in promiscuous mode.
  380.                             dot12DesiredPromiscStatus is used to select
  381.                             the promiscuous mode to be requested in the
  382.                             next training attempt.  Setting
  383.                             ifPromiscuousMode will update
  384.                             dot12DesiredPromiscStatus and cause the
  385.                             interface to attempt to retrain using the
  386.                             new promiscuous mode.  After the interface
  387.                             has retrained, ifPromiscuousMode will
  388.                             reflect the mode that is in use, not the
  389.                             mode that was requested.
  390.  
  391.  
  392.  
  393.  
  394. Flick                       Standards Track                     [Page 7]
  395.  
  396. RFC 2020               IEEE 802.12 Interface MIB            October 1996
  397.  
  398.  
  399.      ifConnectorPresent     This will normally be 'true'.
  400.  
  401.      ifStackHigherLayer     Refer to section 3.3.1
  402.      ifStackLowerLayer
  403.      ifStackStatus
  404.  
  405.      ifRcvAddressAddress    Refer to section 3.3.4.
  406.      ifRcvAddressStatus
  407.      ifRcvAddressType
  408.  
  409. 3.4.  Relation to RFC 1643, RFC 1650, and RFC 1748
  410.  
  411.    An IEEE 802.12 interface can be configured to operate in either
  412.    ethernet or token ring framing mode.  An IEEE 802.12 interface uses
  413.    the frame format for the configured framing mode, but does not use
  414.    the media access protocol for ethernet or token ring.  Instead, IEEE
  415.    802.12 defines its own media access protocol, the Demand Priority
  416.    Access Method (DPAM).
  417.  
  418.    There are existing standards-track MIB modules for instrumenting
  419.    ethernet-like interfaces and token ring interfaces.  At the time of
  420.    this writing, they are: STD 50, RFC 1643, "Definitions of Managed
  421.    Objects for Ethernet-like Interface Types" [8]; RFC 1650,
  422.    "Definitions of Managed Objects for Ethernet-like Interface Types
  423.    using SMIv2" [9]; and RFC 1748, "IEEE 802.5 MIB using SMIv2" [10].
  424.    These MIB modules are designed to instrument the media access
  425.    protocol for these respective technologies.  Since IEEE 802.12
  426.    interfaces do not implement either of these media access protocols,
  427.    an agent should not implement RFC 1643, RFC 1650, or RFC 1748 for
  428.    IEEE 802.12 interfaces.
  429.  
  430. 3.5.  Relation to RFC 1749
  431.  
  432.    When an IEEE 802.12 interface is operating in token ring framing
  433.    mode, and the end node supports token ring source routing, the agent
  434.    should implement RFC 1749, the IEEE 802.5 Station Source Routing MIB
  435.    [11] for those interfaces.
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450. Flick                       Standards Track                     [Page 8]
  451.  
  452. RFC 2020               IEEE 802.12 Interface MIB            October 1996
  453.  
  454.  
  455. 3.6.  Master Mode Operation
  456.  
  457.    In an IEEE 802.12 network, "master" devices act as network
  458.    controllers to decide when to grant requesting end-nodes permission
  459.    to transmit.  These master devices may be repeaters, or other active
  460.    controller devices such as switches.
  461.  
  462.    Devices which do not act as network controllers, such as end-nodes or
  463.    passive switches, are considered to be operating in "slave" mode.
  464.  
  465.    The dot12ControlMode object indicates if the interface is operating
  466.    in master mode or slave mode.
  467.  
  468. 3.7.  Normal and High Priority Counters
  469.  
  470.    The IEEE 802.12 interface MIB does not provide normal priority
  471.    transmit counters.  Standardization of normal priority transmit
  472.    counters could not be justified -- ifOutUcastPkts,
  473.    ifOutMulticastPkts, ifOutBroadcastPkts, ifOutOctets,
  474.    dot12OutHighPriorityFrames, and dot12OutHighPriorityOctets should
  475.    suffice.  More precisely, the number of normal priority frames
  476.    transmitted can be calculated as:
  477.  
  478.        outNormPriorityFrames = ifOutUcastPkts             +
  479.                                ifOutMulticastPkts         +
  480.                                ifOutBroadcastPkts         -
  481.                                dot12OutHighPriorityFrames
  482.  
  483.    The number of normal priority octets transmitted can be calculated
  484.    as:
  485.  
  486.        outNormPriorityOctets = ifOutOctets                -
  487.                                dot12OutHighPriorityOctets
  488.  
  489.    On the other hand, normal priority receive counters are provided.
  490.    The main reason for this is that the normal priority and high
  491.    priority counters include errored frames, whereas the ifIn*Pkts and
  492.    ifInOctets do not include errored frames.  dot12InNormPriorityFrames
  493.    could be calculated, but the calculation is tedious:
  494.  
  495.        inNormPriorityFrames = ifInUcastPkts              +
  496.                               ifInMulticastPkts          +
  497.                               ifInBroadcastPkts          +
  498.                               dot12InNullAddressedFrames +
  499.                               ifInErrors                 +
  500.                               ifInDiscards               +
  501.                               ifInUnknownProtos          -
  502.                               dot12InHighPriorityFrames
  503.  
  504.  
  505.  
  506. Flick                       Standards Track                     [Page 9]
  507.  
  508. RFC 2020               IEEE 802.12 Interface MIB            October 1996
  509.  
  510.  
  511.    dot12InNormPriorityOctets includes octets in unreadable frames, which
  512.    is not available elsewhere.  The number of octets in unreadable
  513.    frames can be calculated as:
  514.  
  515.        octetsInUnreadableFrames = dot12InNormPriorityOctets +
  516.                                   dot12InHighPriorityOctets -
  517.                                   ifInOctets
  518.  
  519.    Also, the total traffic at this interface can be calculated as:
  520.  
  521.        traffic = dot12InNormPriorityOctets +
  522.                  dot12InHighPriorityOctets +
  523.                  ifOutOctets
  524.  
  525.    In other words, the normal priority receive counters were deemed
  526.    useful, whereas the normal priority transmit counters can be easily
  527.    calculated from other available counters.
  528.  
  529. 3.8.  IEEE 802.12 Training Frames
  530.  
  531.    Training frames are special MAC frames that are used only during link
  532.    initialization.  Training frames are initially constructed by the
  533.    device at the lower end of a link, which is the slave mode device for
  534.    the link.  The training frame format is as follows:
  535.  
  536.        +----+----+------------+--------------+----------+-----+
  537.        | DA | SA | Req Config | Allow Config |   Data   | FCS |
  538.        +----+----+------------+--------------+----------+-----+
  539.  
  540.                DA = destination address (six octets)
  541.                SA = source address (six octets)
  542.                Req Config = requested configuration (2 octets)
  543.                Allow Config = allowed configuration (2 octets)
  544.                Data = data (594 to 675 octets)
  545.                FCS = frame check sequence (4 octets)
  546.  
  547.    Training frames are always sent with a null destination address.  To
  548.    pass training, an end node must use its source address in the source
  549.    address field of the training frame.  A repeater may use a non-null
  550.    source address if it has one, or it may use a null source address.
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562. Flick                       Standards Track                    [Page 10]
  563.  
  564. RFC 2020               IEEE 802.12 Interface MIB            October 1996
  565.  
  566.  
  567.    The requested configuration field allows the slave mode device to
  568.    inform the master mode device about itself and to request
  569.    configuration options.  The training response frame from the master
  570.    mode device contains the slave mode device's requested configuration
  571.    from the training request frame.  The currently defined format of the
  572.    requested configuration field as defined in the IEEE Standard
  573.    802.12-1995 standard is shown below.  Please refer to the most
  574.    current version of the IEEE document for a more up to date
  575.    description of this field.  In particular, the reserved bits may be
  576.    used in later versions of the standard.
  577.  
  578.        First Octet:       Second Octet:
  579.  
  580.         7 6 5 4 3 2 1 0    7 6 5 4 3 2 1 0
  581.        +-+-+-+-+-+-+-+-+  +-+-+-+-+-+-+-+-+
  582.        |v|v|v|r|r|r|r|r|  |r|r|r|F|F|P|P|R|
  583.        +-+-+-+-+-+-+-+-+  +-+-+-+-+-+-+-+-+
  584.  
  585.        vvv: The version of the 802.12 training protocol with which
  586.             the training initiator is compliant.  The current version
  587.             is 100.
  588.        r:   Reserved bits (set to zero)
  589.        FF:  00 = frameType88023
  590.             01 = frameType88025
  591.             10 = reserved
  592.             11 = frameTypeEither
  593.        PP:  00 = singleAddressMode
  594.             01 = promiscuousMode
  595.             10 = reserved
  596.             11 = reserved
  597.        R:   0  = the training initiator is an end node
  598.             1  = the training initiator is a repeater
  599.  
  600.    The allowed configuration field allows the master mode device to
  601.    respond with the allowed configuration.  The slave mode device sets
  602.    the contents of this field to all zero bits.  The master mode device
  603.    sets the allowed configuration field as follows:
  604.  
  605.        First Octet:       Second Octet:
  606.  
  607.         7 6 5 4 3 2 1 0    7 6 5 4 3 2 1 0
  608.        +-+-+-+-+-+-+-+-+  +-+-+-+-+-+-+-+-+
  609.        |v|v|v|D|C|N|r|r|  |r|r|r|F|F|P|P|R|
  610.        +-+-+-+-+-+-+-+-+  +-+-+-+-+-+-+-+-+
  611.  
  612.        vvv: The version of the 802.12 training protocol with which
  613.             the training responder is compliant.  The current version
  614.             is 100.
  615.  
  616.  
  617.  
  618. Flick                       Standards Track                    [Page 11]
  619.  
  620. RFC 2020               IEEE 802.12 Interface MIB            October 1996
  621.  
  622.  
  623.        D:   0  = No duplicate address has been detected.
  624.             1  = Duplicate address has been detected
  625.        C:   0  = The requested configuration is compatible with the
  626.                  network.
  627.             1  = The requested configuration is not compatible with
  628.                  the network.  In this case, the FF, PP, and R bits
  629.                  indicate the configuration that would be allowed.
  630.        N:   0  = Access will be allowed, providing the configuration
  631.                  is compatible (C = 0).
  632.             1  = Access is not granted because of security
  633.                  restrictions
  634.        r:   Reserved bits (set to zero)
  635.        FF:  00 = frameType88023 will be used
  636.             01 = frameType88025 will be used
  637.             10 = reserved
  638.             11 = reserved
  639.        PP:  00 = singleAddressMode
  640.             01 = promiscuousMode
  641.             10 = reserved
  642.             11 = reserved
  643.        R:   0  = Requested access as an end node is allowed
  644.             1  = Requested access as a repeater is allowed
  645.  
  646.    Again, note that the most recent version of the IEEE 802.12 standard
  647.    should be consulted for the most up to date definition of the
  648.    requested configuration and allowed configuration fields.
  649.  
  650.    The data field contains between 594 and 675 octets and is filled in
  651.    by the training initiator.  The first 55 octets may be used for
  652.    vendor specific protocol information.  The remaining octets are all
  653.    zeros.  The length of the training frame combined with the
  654.    requirement that 24 consecutive training frames be received without
  655.    error to complete training ensures that marginal links will not
  656.    complete training.
  657.  
  658. 3.9.  Mapping of IEEE 802.12 Managed Objects
  659.  
  660.    The following table lists all the managed objects defined for
  661.    oEndNode in the IEEE 802.12 Standard, and the corresponding SNMP
  662.    objects.
  663.  
  664.    IEEE 802.12 Managed Object            Corresponding SNMP Object
  665.  
  666.    oEndNode
  667.      .aBroadcastFramesReceived           IF-MIB - ifInBroadcastPkts
  668.      .aBroadcastFramesTransmitted        IF-MIB - ifOutBroadcastPkts
  669.      .aDataErrorFramesReceived           dot12InDataErrors
  670.      .aDesiredFramingType                dot12DesiredFramingType
  671.  
  672.  
  673.  
  674. Flick                       Standards Track                    [Page 12]
  675.  
  676. RFC 2020               IEEE 802.12 Interface MIB            October 1996
  677.  
  678.  
  679.      .aDesiredPromiscuousStatus          dot12DesiredPromiscStatus
  680.      .aFramesTransmitted                 IF-MIB - ifOutUCastPkts +
  681.                                                   ifOutMulticastPkts +
  682.                                                   ifOutBroadcastPkts
  683.      .aFramingCapability                 dot12FramingCapability
  684.      .aFunctionalAddresses               IF-MIB - ifRcvAddressTable
  685.      .aHighPriorityFramesReceived        dot12InHighPriorityFrames
  686.      .aHighPriorityFramesTransmitted     dot12OutHighPriorityFrames
  687.      .aHighPriorityOctetsReceived        dot12InHighPriorityOctets or
  688.                                          dot12InHCHighPriorityOctets
  689.      .aHighPriorityOctetsTransmitted     dot12OutHighPriorityOctets or
  690.                                          dot12OutHCHighPriorityOctets
  691.      .aIPMFramesReceived                 dot12InIPMErrors
  692.      .aLastTrainingConfig                dot12LastTrainingConfig
  693.      .aMACID                             IF-MIB - ifIndex
  694.      .aMACStatus                         dot12Status
  695.      .aMACVersion                        dot12TrainingVersion
  696.      .aMediaType                         <not yet mapped>
  697.                                          Tranceiver MIB issue
  698.      .aMulticastFramesReceived           IF-MIB - ifInMulticastPkts
  699.      .aMulticastFramesTransmitted        IF-MIB - ifOutMulticastPkts
  700.      .aMulticastReceiveStatus            IF-MIB - ifRcvAddressTable
  701.      .aNormalPriorityFramesReceived      dot12InNormPriorityFrames
  702.      .aNormalPriorityOctetsReceived      dot12InNormPriorityOctets or
  703.                                          dot12InHCNormPriorityOctets
  704.      .aNullAddressedFramesReceived       dot12InNullAddressedFrames
  705.      .aOctetsTransmitted                 IF-MIB - ifOutOctets or
  706.                                                   ifHCOutOctets
  707.      .aOversizeFramesReceived            dot12InOversizeFrameErrors
  708.      .aReadableFramesReceived            IF-MIB - ifInUcastPkts +
  709.                                                   ifInMulticastPkts +
  710.                                                   ifInBroadcastPkts
  711.      .aReadableOctetsReceived            IF-MIB - ifInOctets or
  712.                                                   ifHCInOctets
  713.      .aReadMulticastList                 IF-MIB - ifRcvAddressTable
  714.      .aReadWriteMACAddress               IF-MIB - ifPhysAddress
  715.      .aTransitionsIntoTraining           dot12TransitionIntoTrainings
  716.      .acAddGroupAddress                  IF-MIB - ifRcvAddressTable
  717.      .acClose                            dot12Commands: 'close'
  718.      .acDeleteGroupAddress               IF-MIB - ifRcvAddressTable
  719.      .acExecuteSelftest                  IF-MIB - ifAdminStatus
  720.      .acInitializeMAC                    dot12Commands: 'reset'
  721.      .acOpen                             dot12Commands: 'open'
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730. Flick                       Standards Track                    [Page 13]
  731.  
  732. RFC 2020               IEEE 802.12 Interface MIB            October 1996
  733.  
  734.  
  735. 4.  Definitions
  736.  
  737.       DOT12-IF-MIB DEFINITIONS ::= BEGIN
  738.  
  739.           IMPORTS
  740.               transmission, Counter32, Counter64, OBJECT-TYPE,
  741.               MODULE-IDENTITY
  742.                   FROM SNMPv2-SMI
  743.               MODULE-COMPLIANCE, OBJECT-GROUP
  744.                   FROM SNMPv2-CONF
  745.               ifIndex
  746.                   FROM IF-MIB;
  747.  
  748.           dot12MIB MODULE-IDENTITY
  749.                LAST-UPDATED "9602220452Z"  -- February 22, 1996
  750.                ORGANIZATION "IETF 100VG-AnyLAN MIB Working Group"
  751.                CONTACT-INFO
  752.                        "       John Flick
  753.  
  754.                        Postal: Hewlett Packard Company
  755.                                8000 Foothills Blvd. M/S 5556
  756.                                Roseville, CA 95747-5556
  757.                        Tel:    +1 916 785 4018
  758.                        Fax:    +1 916 785 3583
  759.  
  760.                        E-mail: johnf@hprnd.rose.hp.com"
  761.                DESCRIPTION
  762.                        "This MIB module describes objects for
  763.                        managing IEEE 802.12 interfaces."
  764.                ::= { transmission 45 }
  765.  
  766.           dot12MIBObjects     OBJECT IDENTIFIER ::= { dot12MIB 1 }
  767.  
  768.           dot12ConfigTable OBJECT-TYPE
  769.               SYNTAX     SEQUENCE OF Dot12ConfigEntry
  770.               MAX-ACCESS not-accessible
  771.               STATUS     current
  772.               DESCRIPTION
  773.                       "Configuration information for a collection of
  774.                       802.12 interfaces attached to a particular
  775.                       system."
  776.               ::= { dot12MIBObjects 1 }
  777.  
  778.           dot12ConfigEntry OBJECT-TYPE
  779.               SYNTAX     Dot12ConfigEntry
  780.               MAX-ACCESS not-accessible
  781.               STATUS     current
  782.               DESCRIPTION
  783.  
  784.  
  785.  
  786. Flick                       Standards Track                    [Page 14]
  787.  
  788. RFC 2020               IEEE 802.12 Interface MIB            October 1996
  789.  
  790.  
  791.                       "Configuration for a particular interface to an
  792.                       802.12 medium."
  793.               INDEX      { ifIndex }
  794.               ::= { dot12ConfigTable 1 }
  795.  
  796.           Dot12ConfigEntry ::=
  797.               SEQUENCE {
  798.                   dot12CurrentFramingType         INTEGER,
  799.                   dot12DesiredFramingType         INTEGER,
  800.                   dot12FramingCapability          INTEGER,
  801.                   dot12DesiredPromiscStatus       INTEGER,
  802.                   dot12TrainingVersion            INTEGER,
  803.                   dot12LastTrainingConfig         OCTET STRING,
  804.                   dot12Commands                   INTEGER,
  805.                   dot12Status                     INTEGER,
  806.                   dot12ControlMode                INTEGER
  807.               }
  808.  
  809.           dot12CurrentFramingType OBJECT-TYPE
  810.               SYNTAX     INTEGER {
  811.                              frameType88023(1),
  812.                              frameType88025(2),
  813.                              frameTypeUnknown(3)
  814.                          }
  815.               MAX-ACCESS read-only
  816.               STATUS     current
  817.               DESCRIPTION
  818.                       "When dot12DesiredFramingType is one of
  819.                       'frameType88023' or 'frameType88025', this is the
  820.                       type of framing asserted by the interface.
  821.  
  822.                       When dot12DesiredFramingType is 'frameTypeEither',
  823.                       dot12CurrentFramingType shall be one of
  824.                       'frameType88023' or 'frameType88025' when the
  825.                       dot12Status is 'opened'.   When the dot12Status is
  826.                       anything other than 'opened',
  827.                       dot12CurrentFramingType shall take the value of
  828.                       'frameTypeUnknown'."
  829.               ::= { dot12ConfigEntry 1 }
  830.  
  831.           dot12DesiredFramingType OBJECT-TYPE
  832.               SYNTAX     INTEGER {
  833.                              frameType88023(1),
  834.                              frameType88025(2),
  835.                              frameTypeEither(3)
  836.                          }
  837.               MAX-ACCESS read-write
  838.               STATUS     current
  839.  
  840.  
  841.  
  842. Flick                       Standards Track                    [Page 15]
  843.  
  844. RFC 2020               IEEE 802.12 Interface MIB            October 1996
  845.  
  846.  
  847.               DESCRIPTION
  848.                       "The type of framing which will be requested by
  849.                       the interface during the next interface MAC
  850.                       initialization or open action.
  851.  
  852.                       In master mode, this is the framing mode which
  853.                       will be granted by the interface.  Note that
  854.                       for a master mode interface, this object must be
  855.                       equal to 'frameType88023' or 'frameType88025',
  856.                       since a master mode interface cannot grant
  857.                       'frameTypeEither'."
  858.               REFERENCE
  859.                       "IEEE Standard 802.12-1995, 13.2.5.2.1,
  860.                       aDesiredFramingType."
  861.               ::= { dot12ConfigEntry 2 }
  862.  
  863.           dot12FramingCapability OBJECT-TYPE
  864.               SYNTAX     INTEGER {
  865.                              frameType88023(1),
  866.                              frameType88025(2),
  867.                              frameTypeEither(3)
  868.                          }
  869.               MAX-ACCESS read-only
  870.               STATUS     current
  871.               DESCRIPTION
  872.                       "The type of framing this interface is capable of
  873.                       supporting."
  874.               REFERENCE
  875.                       "IEEE Standard 802.12-1995, 13.2.5.2.1,
  876.                       aFramingCapability."
  877.               ::= { dot12ConfigEntry 3 }
  878.  
  879.           dot12DesiredPromiscStatus OBJECT-TYPE
  880.               SYNTAX     INTEGER {
  881.                              singleAddressMode(1),
  882.                              promiscuousMode(2)
  883.                          }
  884.               MAX-ACCESS read-write
  885.               STATUS     current
  886.               DESCRIPTION
  887.                       "This object is used to select the promiscuous
  888.                       mode that this interface will request in the next
  889.                       training packet issued on this interface.
  890.                       Whether the repeater grants the requested mode
  891.                       must be verified by examining the state of the PP
  892.                       bits in the corresponding instance of
  893.                       dot12LastTrainingConfig.
  894.  
  895.  
  896.  
  897.  
  898. Flick                       Standards Track                    [Page 16]
  899.  
  900. RFC 2020               IEEE 802.12 Interface MIB            October 1996
  901.  
  902.  
  903.                       In master mode, this object controls whether or
  904.                       not promiscuous mode will be granted by the
  905.                       interface when requested by the lower level
  906.                       device.
  907.  
  908.                       Note that this object indicates the desired mode
  909.                       for the next time the interface trains.  The
  910.                       currently active mode will be reflected in
  911.                       dot12LastTrainingConfig and in ifPromiscuousMode."
  912.               REFERENCE
  913.                       "IEEE Standard 802.12-1995, 13.2.5.2.1,
  914.                       aDesiredPromiscuousStatus."
  915.               ::= { dot12ConfigEntry 4 }
  916.  
  917.           dot12TrainingVersion OBJECT-TYPE
  918.               SYNTAX     INTEGER (0..7)
  919.               MAX-ACCESS read-only
  920.               STATUS     current
  921.               DESCRIPTION
  922.                       "The value that will be used in the version bits
  923.                       (vvv bits) in training frames on this interface.
  924.                       This is the highest version number supported by
  925.                       this MAC."
  926.               REFERENCE
  927.                       "IEEE Standard 802.12-1995, 13.2.5.2.1,
  928.                       aMACVersion."
  929.               ::= { dot12ConfigEntry 5 }
  930.  
  931.           dot12LastTrainingConfig OBJECT-TYPE
  932.               SYNTAX     OCTET STRING (SIZE(2))
  933.               MAX-ACCESS read-only
  934.               STATUS     current
  935.               DESCRIPTION
  936.                       "This 16 bit field contains the configuration
  937.                       bits from the most recent error-free training
  938.                       frame received during training on this interface.
  939.                       Training request frames are received when in
  940.                       master mode, while training response frames are
  941.                       received in slave mode.  On master mode interfaces,
  942.                       this object contains the contents of the
  943.                       requested configuration field of the most recent
  944.                       training request frame.  On slave mode interfaces,
  945.                       this object contains the contents of the allowed
  946.                       configuration field of the most recent training
  947.                       response frame.  The format of the current version
  948.                       of this field is described in section 3.8.  Please
  949.                       refer to the most recent version of the IEEE
  950.                       802.12 standard for the most up-to-date definition
  951.  
  952.  
  953.  
  954. Flick                       Standards Track                    [Page 17]
  955.  
  956. RFC 2020               IEEE 802.12 Interface MIB            October 1996
  957.  
  958.  
  959.                       of the format of this object."
  960.               REFERENCE
  961.                       "IEEE Standard 802.12-1995, 13.2.5.2.1,
  962.                       aLastTrainingConfig."
  963.               ::= { dot12ConfigEntry 6 }
  964.  
  965.           dot12Commands OBJECT-TYPE
  966.               SYNTAX     INTEGER {
  967.                              noOp(1),
  968.                              open(2),
  969.                              reset(3),
  970.                              close(4)
  971.                          }
  972.               MAX-ACCESS read-write
  973.               STATUS     current
  974.               DESCRIPTION
  975.                       "If the current value of dot12Status is 'closed',
  976.                       setting the value of this object to 'open' will
  977.                       change the corresponding instance of MIB-II's
  978.                       ifAdminStatus to 'up', cause this interface to
  979.                       enter the 'opening' state, and will cause training
  980.                       to be initiated on this interface.  The progress
  981.                       and success of the open is given by the values of
  982.                       the dot12Status object.  Setting this object to
  983.                       'open' when dot12Status has a value other than
  984.                       'closed' has no effect.
  985.  
  986.                       Setting the corresponding instance of ifAdminStatus
  987.                       to 'up' when the current value of dot12Status is
  988.                       'closed' will have the same effect as setting this
  989.                       object to 'open'.  Setting ifAdminStatus to 'up'
  990.                       when dot12Status has a value other than 'closed'
  991.                       has no effect.
  992.  
  993.                       Setting the value of this object to 'close' will
  994.                       move this interface into the 'closed' state and
  995.                       cause all transmit and receive actions to stop.
  996.                       This object will then have to be set to 'open' in
  997.                       order to reinitiate training.
  998.  
  999.                       Setting the corresponding instance of ifAdminStatus
  1000.                       to 'down' will have the same effect as setting this
  1001.                       object to 'close'.
  1002.  
  1003.                       Setting the value of this object to 'reset' when
  1004.                       the current value of dot12Status has a value other
  1005.                       than 'closed' will reset the interface.  On a
  1006.                       reset, all MIB counters should retain their values.
  1007.  
  1008.  
  1009.  
  1010. Flick                       Standards Track                    [Page 18]
  1011.  
  1012. RFC 2020               IEEE 802.12 Interface MIB            October 1996
  1013.  
  1014.  
  1015.                       This will cause the MAC to initiate an
  1016.                       acInitializeMAC action as specified in IEEE 802.12.
  1017.                       This will cause training to be reinitiated on this
  1018.                       interface.  Setting this object to 'reset' when
  1019.                       dot12Status has a value of 'closed' has no effect.
  1020.                       Setting this object to 'reset' has no effect on the
  1021.                       corresponding instance of ifAdminStatus.
  1022.  
  1023.                       Setting the value of this object to 'noOp' has no
  1024.                       effect.
  1025.  
  1026.                       When read, this object will always have a value
  1027.                       of 'noOp'."
  1028.               REFERENCE
  1029.                       "IEEE Standard 802.12-1995, 13.2.5.2.2,
  1030.                       acOpen, acClose, acInitializeMAC.
  1031.                       Also, RFC1231 IEEE802.5 Token Ring MIB,
  1032.                       dot5Commands."
  1033.               ::= { dot12ConfigEntry 7 }
  1034.  
  1035.           dot12Status OBJECT-TYPE
  1036.               SYNTAX     INTEGER {
  1037.                              opened(1),
  1038.                              closed(2),
  1039.                              opening(3),
  1040.                              openFailure(5),
  1041.                              linkFailure(6)
  1042.                          }
  1043.               MAX-ACCESS read-only
  1044.               STATUS     current
  1045.               DESCRIPTION
  1046.                       "The current interface status with respect to
  1047.                       training.  One of the following values:
  1048.  
  1049.                           opened      - Training has completed
  1050.                                         successfully.
  1051.                           closed      - MAC has been disabled by
  1052.                                         setting dot12Commands to
  1053.                                         'close'.
  1054.                           opening     - MAC is in training.  Training
  1055.                                         signals have been received.
  1056.                           openFailure - Passed 24 error-free packets,
  1057.                                         but there is a problem, noted
  1058.                                         in the training configuration
  1059.                                         bits (dot12LastTrainingConfig).
  1060.                           linkFailure - Training signals not received,
  1061.                                         or could not pass 24 error-free
  1062.                                         packets.
  1063.  
  1064.  
  1065.  
  1066. Flick                       Standards Track                    [Page 19]
  1067.  
  1068. RFC 2020               IEEE 802.12 Interface MIB            October 1996
  1069.  
  1070.  
  1071.                       Whenever the dot12Commands object is set to
  1072.                       'close' or ifAdminStatus is set to 'down', the MAC
  1073.                       will go silent, dot12Status will be 'closed', and
  1074.                       ifOperStatus will be 'down'.
  1075.  
  1076.                       When the value of this object is equal to 'closed'
  1077.                       and the dot12Commands object is set to 'open' or
  1078.                       the ifAdminStatus object is set to 'up', training
  1079.                       will be initiated on this interface.  When the
  1080.                       value of this object is not equal to 'closed' and
  1081.                       the dot12Commands object is set to 'reset',
  1082.                       training will be reinitiated on this interface.
  1083.                       Note that sets of some other objects (e.g.
  1084.                       dot12ControlMode) or external events (e.g. MAC
  1085.                       protocol violations) may also cause training to be
  1086.                       reinitiated on this interface.
  1087.  
  1088.                       When training is initiated or reinitiated on an
  1089.                       interface, the end node will send Training_Up to
  1090.                       the master and initially go to the 'linkFailure'
  1091.                       state and ifOperStatus will go to 'down'.
  1092.                       When the master sends back Training_Down,
  1093.                       dot12Status will change to the 'opening' state,
  1094.                       and training packets will be transferred.
  1095.  
  1096.                       After all of the training packets have been
  1097.                       passed, dot12Status will change to 'linkFailure'
  1098.                       if 24 consecutive error-free packets were not
  1099.                       passed, 'opened' if 24 consecutive error-free
  1100.                       packets were passed and the training
  1101.                       configuration bits were OK, or 'openFailure' if
  1102.                       there were 24 consecutive error-free packets, but
  1103.                       there was a problem with the training
  1104.                       configuration bits.
  1105.  
  1106.                       When in the 'openFailure' state, the
  1107.                       dot12LastTrainingConfig object will contain the
  1108.                       configuration bits from the last training
  1109.                       packet which can be examined to determine the
  1110.                       exact reason for the training configuration
  1111.                       failure.
  1112.  
  1113.                       If training did not succeed (dot12Status is
  1114.                       'linkFailure' or 'openFailure), the entire
  1115.                       process will be restarted after
  1116.                       MAC_Retraining_Delay_Timer seconds.
  1117.  
  1118.                       If training does succeed (dot12Status changes to
  1119.  
  1120.  
  1121.  
  1122. Flick                       Standards Track                    [Page 20]
  1123.  
  1124. RFC 2020               IEEE 802.12 Interface MIB            October 1996
  1125.  
  1126.  
  1127.                       'opened'), ifOperStatus will change to 'up'.  If
  1128.                       training does not succeed (dot12Status changes to
  1129.                       'linkFailure' or 'openFailure'), ifOperStatus will
  1130.                       remain 'down'."
  1131.               REFERENCE
  1132.                       "IEEE Standard 802.12-1995, 13.2.5.2.1,
  1133.                       aMACStatus."
  1134.               ::= { dot12ConfigEntry 8 }
  1135.  
  1136.           dot12ControlMode OBJECT-TYPE
  1137.               SYNTAX     INTEGER {
  1138.                              masterMode(1),
  1139.                              slaveMode(2),
  1140.                              learn(3)
  1141.                          }
  1142.               MAX-ACCESS read-write
  1143.               STATUS     current
  1144.               DESCRIPTION
  1145.                       "This object is used to configure and report
  1146.                       whether or not this interface is operating in
  1147.                       master mode.  In a Demand Priority network, end
  1148.                       node interfaces typically operate in slave mode,
  1149.                       while switch interfaces may control the Demand
  1150.                       Priority protocol and operate in master mode.
  1151.  
  1152.                       This object may be implemented as a read-only
  1153.                       object by those agents and interfaces that do not
  1154.                       implement software control of master mode.  In
  1155.                       particular, interfaces that cannot operate in
  1156.                       master mode, and interfaces on which master mode
  1157.                       is controlled by a pushbutton on the device,
  1158.                       should implement this object read-only.
  1159.  
  1160.                       Some interfaces do not require network management
  1161.                       configuration of this feature and can autosense
  1162.                       whether to use master mode or slave mode.  The
  1163.                       value 'learn' is used for that purpose.  While
  1164.                       autosense is taking place, the value 'learn' is
  1165.                       returned.
  1166.  
  1167.                       A network management operation which modifies the
  1168.                       value of dot12ControlMode causes the interface
  1169.                       to retrain."
  1170.               ::= { dot12ConfigEntry 9 }
  1171.  
  1172.           dot12StatTable OBJECT-TYPE
  1173.               SYNTAX     SEQUENCE OF Dot12StatEntry
  1174.               MAX-ACCESS not-accessible
  1175.  
  1176.  
  1177.  
  1178. Flick                       Standards Track                    [Page 21]
  1179.  
  1180. RFC 2020               IEEE 802.12 Interface MIB            October 1996
  1181.  
  1182.  
  1183.               STATUS     current
  1184.               DESCRIPTION
  1185.                       "Statistics for a collection of 802.12 interfaces
  1186.                       attached to a particular system."
  1187.               ::= { dot12MIBObjects 2 }
  1188.  
  1189.           dot12StatEntry OBJECT-TYPE
  1190.               SYNTAX     Dot12StatEntry
  1191.               MAX-ACCESS not-accessible
  1192.               STATUS     current
  1193.               DESCRIPTION
  1194.                       "Statistics for a particular interface to an
  1195.                       802.12 medium.  The receive statistics in this
  1196.                       table apply only to packets received by this
  1197.                       station (i.e., packets whose destination address
  1198.                       is either the local station address, the
  1199.                       broadcast address, or a multicast address that
  1200.                       this station is receiving, unless the station is
  1201.                       in promiscuous mode)."
  1202.               INDEX      { ifIndex }
  1203.               ::= { dot12StatTable 1 }
  1204.  
  1205.           Dot12StatEntry ::=
  1206.               SEQUENCE {
  1207.                   dot12InHighPriorityFrames       Counter32,
  1208.                   dot12InHighPriorityOctets       Counter32,
  1209.                   dot12InNormPriorityFrames       Counter32,
  1210.                   dot12InNormPriorityOctets       Counter32,
  1211.                   dot12InIPMErrors                Counter32,
  1212.                   dot12InOversizeFrameErrors      Counter32,
  1213.                   dot12InDataErrors               Counter32,
  1214.                   dot12InNullAddressedFrames      Counter32,
  1215.                   dot12OutHighPriorityFrames      Counter32,
  1216.                   dot12OutHighPriorityOctets      Counter32,
  1217.                   dot12TransitionIntoTrainings    Counter32,
  1218.                   dot12HCInHighPriorityOctets     Counter64,
  1219.                   dot12HCInNormPriorityOctets     Counter64,
  1220.                   dot12HCOutHighPriorityOctets    Counter64
  1221.               }
  1222.  
  1223.           dot12InHighPriorityFrames OBJECT-TYPE
  1224.               SYNTAX     Counter32
  1225.               MAX-ACCESS read-only
  1226.               STATUS     current
  1227.               DESCRIPTION
  1228.                       "This object is a count of high priority frames
  1229.                       that have been received on this interface.
  1230.                       Includes both good and bad high priority frames,
  1231.  
  1232.  
  1233.  
  1234. Flick                       Standards Track                    [Page 22]
  1235.  
  1236. RFC 2020               IEEE 802.12 Interface MIB            October 1996
  1237.  
  1238.  
  1239.                       as well as high priority training frames.  Does
  1240.                       not include normal priority frames which were
  1241.                       priority promoted."
  1242.               REFERENCE
  1243.                       "IEEE Standard 802.12-1995, 13.2.5.2.1,
  1244.                       aHighPriorityFramesReceived."
  1245.               ::= { dot12StatEntry 1 }
  1246.  
  1247.           dot12InHighPriorityOctets OBJECT-TYPE
  1248.               SYNTAX     Counter32
  1249.               MAX-ACCESS read-only
  1250.               STATUS     current
  1251.               DESCRIPTION
  1252.                       "This object is a count of the number of octets
  1253.                       contained in high priority frames that have been
  1254.                       received on this interface. This counter is
  1255.                       incremented by OctetCount for each frame received
  1256.                       on this interface which is counted by
  1257.                       dot12InHighPriorityFrames.
  1258.  
  1259.                       Note that this counter will roll over very
  1260.                       quickly.  It is provided for backward
  1261.                       compatibility for Network Management protocols
  1262.                       that do not support 64 bit counters (e.g. SNMP
  1263.                       version 1)."
  1264.               REFERENCE
  1265.                       "IEEE Standard 802.12-1995, 13.2.5.2.1,
  1266.                       aHighPriorityOctetsReceived."
  1267.               ::= { dot12StatEntry 2 }
  1268.  
  1269.           dot12InNormPriorityFrames OBJECT-TYPE
  1270.               SYNTAX     Counter32
  1271.               MAX-ACCESS read-only
  1272.               STATUS     current
  1273.               DESCRIPTION
  1274.                       "This object is a count of normal priority frames
  1275.                       that have been received on this interface.
  1276.                       Includes both good and bad normal priority
  1277.                       frames, as well as normal priority training
  1278.                       frames and normal priority frames which were
  1279.                       priority promoted."
  1280.               REFERENCE
  1281.                       "IEEE Standard 802.12-1995, 13.2.5.2.1,
  1282.                       aNormalPriorityFramesReceived."
  1283.               ::= { dot12StatEntry 3 }
  1284.  
  1285.           dot12InNormPriorityOctets OBJECT-TYPE
  1286.               SYNTAX     Counter32
  1287.  
  1288.  
  1289.  
  1290. Flick                       Standards Track                    [Page 23]
  1291.  
  1292. RFC 2020               IEEE 802.12 Interface MIB            October 1996
  1293.  
  1294.  
  1295.               MAX-ACCESS read-only
  1296.               STATUS     current
  1297.               DESCRIPTION
  1298.                       "This object is a count of the number of octets
  1299.                       contained in normal priority frames that have
  1300.                       been received on this interface. This counter is
  1301.                       incremented by OctetCount for each frame received
  1302.                       on this interface which is counted by
  1303.                       dot12InNormPriorityFrames.
  1304.  
  1305.                       Note that this counter will roll over very
  1306.                       quickly.  It is provided for backward
  1307.                       compatibility for Network Management protocols
  1308.                       that do not support 64 bit counters (e.g. SNMP
  1309.                       version 1)."
  1310.               REFERENCE
  1311.                       "IEEE Standard 802.12-1995, 13.2.5.2.1,
  1312.                       aNormalPriorityOctetsReceived."
  1313.               ::= { dot12StatEntry 4 }
  1314.  
  1315.           dot12InIPMErrors OBJECT-TYPE
  1316.               SYNTAX     Counter32
  1317.               MAX-ACCESS read-only
  1318.               STATUS     current
  1319.               DESCRIPTION
  1320.                       "This object is a count of the number of frames
  1321.                       that have been received on this interface with an
  1322.                       invalid packet marker and no PMI errors.  A
  1323.                       repeater will write an invalid packet marker to
  1324.                       the end of a frame containing errors as it is
  1325.                       forwarded through the repeater to the other
  1326.                       ports.  This counter is incremented by one for
  1327.                       each frame received on this interface which has
  1328.                       had an invalid packet marker added to the end of
  1329.                       the frame."
  1330.               REFERENCE
  1331.                       "IEEE Standard 802.12-1995, 13.2.5.2.1,
  1332.                       aIPMFramesReceived."
  1333.               ::= { dot12StatEntry 5 }
  1334.  
  1335.           dot12InOversizeFrameErrors OBJECT-TYPE
  1336.               SYNTAX     Counter32
  1337.               MAX-ACCESS read-only
  1338.               STATUS     current
  1339.               DESCRIPTION
  1340.                       "This object is a count of oversize frames
  1341.                       received on this interface.  This counter is
  1342.                       incremented by one for each frame received on
  1343.  
  1344.  
  1345.  
  1346. Flick                       Standards Track                    [Page 24]
  1347.  
  1348. RFC 2020               IEEE 802.12 Interface MIB            October 1996
  1349.  
  1350.  
  1351.                       this interface whose OctetCount is larger than
  1352.                       the maximum legal frame size.  The frame size
  1353.                       which causes this counter to increment is
  1354.                       dependent on the current framing type."
  1355.               REFERENCE
  1356.                       "IEEE Standard 802.12-1995, 13.2.5.2.1,
  1357.                       aOversizeFramesReceived."
  1358.               ::= { dot12StatEntry 6 }
  1359.  
  1360.           dot12InDataErrors OBJECT-TYPE
  1361.               SYNTAX     Counter32
  1362.               MAX-ACCESS read-only
  1363.               STATUS     current
  1364.               DESCRIPTION
  1365.                       "This object is a count of errored frames
  1366.                       received on this interface.  This counter is
  1367.                       incremented by one for each frame received on
  1368.                       this interface with any of the following errors:
  1369.                       bad FCS (with no IPM), PMI errors (excluding
  1370.                       frames with an IPM as the only PMI error),
  1371.                       undersize, bad start of frame delimiter, or bad
  1372.                       end of packet marker.  Does not include frames
  1373.                       counted by dot12InIPMErrors,
  1374.                       dot12InNullAddressedFrames, or
  1375.                       dot12InOversizeFrameErrors.
  1376.  
  1377.                       This counter indicates problems with the cable
  1378.                       directly attached to this interface, while
  1379.                       dot12InIPMErrors indicates problems with remote
  1380.                       cables."
  1381.               REFERENCE
  1382.                       "IEEE Standard 802.12-1995, 13.2.5.2.1,
  1383.                       aDataErrorFramesReceived."
  1384.               ::= { dot12StatEntry 7 }
  1385.  
  1386.           dot12InNullAddressedFrames OBJECT-TYPE
  1387.               SYNTAX     Counter32
  1388.               MAX-ACCESS read-only
  1389.               STATUS     current
  1390.               DESCRIPTION
  1391.                       "This object is a count of null addressed frames
  1392.                       received on this interface.  This counter is
  1393.                       incremented by one for each frame received on
  1394.                       this interface with a destination MAC address
  1395.                       consisting of all zero bits.  Both void and
  1396.                       training frames are included in this counter.
  1397.  
  1398.                       Note that since this station would normally not
  1399.  
  1400.  
  1401.  
  1402. Flick                       Standards Track                    [Page 25]
  1403.  
  1404. RFC 2020               IEEE 802.12 Interface MIB            October 1996
  1405.  
  1406.  
  1407.                       receive null addressed frames, this counter is
  1408.                       only incremented when this station is operating
  1409.                       in promiscuous mode or in training."
  1410.               REFERENCE
  1411.                       "IEEE Standard 802.12-1995, 13.2.5.2.1,
  1412.                       aNullAddressedFramesReceived."
  1413.               ::= { dot12StatEntry 8 }
  1414.  
  1415.           dot12OutHighPriorityFrames OBJECT-TYPE
  1416.               SYNTAX     Counter32
  1417.               MAX-ACCESS read-only
  1418.               STATUS     current
  1419.               DESCRIPTION
  1420.                       "This counter is incremented by one for each high
  1421.                       priority frame successfully transmitted out this
  1422.                       interface."
  1423.               REFERENCE
  1424.                       "IEEE Standard 802.12-1995, 13.2.5.2.1,
  1425.                       aHighPriorityFramesTransmitted."
  1426.               ::= { dot12StatEntry 9 }
  1427.  
  1428.           dot12OutHighPriorityOctets OBJECT-TYPE
  1429.               SYNTAX     Counter32
  1430.               MAX-ACCESS read-only
  1431.               STATUS     current
  1432.               DESCRIPTION
  1433.                       "This counter is incremented by OctetCount for
  1434.                       each frame counted by dot12OutHighPriorityFrames.
  1435.  
  1436.                       Note that this counter will roll over very
  1437.                       quickly.  It is provided for backward
  1438.                       compatibility for Network Management protocols
  1439.                       that do not support 64 bit counters (e.g. SNMP
  1440.                       version 1)."
  1441.               REFERENCE
  1442.                       "IEEE Standard 802.12-1995, 13.2.5.2.1,
  1443.                       aHighPriorityOctetsTransmitted."
  1444.               ::= { dot12StatEntry 10 }
  1445.  
  1446.           dot12TransitionIntoTrainings OBJECT-TYPE
  1447.               SYNTAX     Counter32
  1448.               MAX-ACCESS read-only
  1449.               STATUS     current
  1450.               DESCRIPTION
  1451.                       "This object is a count of the number of times
  1452.                       this interface has entered the training state.
  1453.                       This counter is incremented by one each time
  1454.                       dot12Status transitions to 'linkFailure' from any
  1455.  
  1456.  
  1457.  
  1458. Flick                       Standards Track                    [Page 26]
  1459.  
  1460. RFC 2020               IEEE 802.12 Interface MIB            October 1996
  1461.  
  1462.  
  1463.                       state other than 'opening' or 'openFailure'."
  1464.               REFERENCE
  1465.                       "IEEE Standard 802.12-1995, 13.2.5.2.1,
  1466.                       aTransitionsIntoTraining."
  1467.               ::= { dot12StatEntry 11 }
  1468.  
  1469.           dot12HCInHighPriorityOctets OBJECT-TYPE
  1470.               SYNTAX     Counter64
  1471.               MAX-ACCESS read-only
  1472.               STATUS     current
  1473.               DESCRIPTION
  1474.                       "This object is a count of the number of octets
  1475.                       contained in high priority frames that have been
  1476.                       received on this interface. This counter is
  1477.                       incremented by OctetCount for each frame received
  1478.                       on this interface which is counted by
  1479.                       dot12InHighPriorityFrames.
  1480.  
  1481.                       This counter is a 64 bit version of
  1482.                       dot12InHighPriorityOctets.  It should be used by
  1483.                       Network Management protocols which support 64 bit
  1484.                       counters (e.g. SNMPv2)."
  1485.               REFERENCE
  1486.                       "IEEE Standard 802.12-1995, 13.2.5.2.1,
  1487.                       aHighPriorityOctetsReceived."
  1488.               ::= { dot12StatEntry 12 }
  1489.  
  1490.           dot12HCInNormPriorityOctets OBJECT-TYPE
  1491.               SYNTAX     Counter64
  1492.               MAX-ACCESS read-only
  1493.               STATUS     current
  1494.               DESCRIPTION
  1495.                       "This object is a count of the number of octets
  1496.                       contained in normal priority frames that have
  1497.                       been received on this interface. This counter is
  1498.                       incremented by OctetCount for each frame received
  1499.                       on this interface which is counted by
  1500.                       dot12InNormPriorityFrames.
  1501.  
  1502.                       This counter is a 64 bit version of
  1503.                       dot12InNormPriorityOctets.  It should be used by
  1504.                       Network Management protocols which support 64 bit
  1505.                       counters (e.g. SNMPv2)."
  1506.               REFERENCE
  1507.                       "IEEE Standard 802.12-1995, 13.2.5.2.1,
  1508.                       aNormalPriorityOctetsReceived."
  1509.               ::= { dot12StatEntry 13 }
  1510.  
  1511.  
  1512.  
  1513.  
  1514. Flick                       Standards Track                    [Page 27]
  1515.  
  1516. RFC 2020               IEEE 802.12 Interface MIB            October 1996
  1517.  
  1518.  
  1519.           dot12HCOutHighPriorityOctets OBJECT-TYPE
  1520.               SYNTAX     Counter64
  1521.               MAX-ACCESS read-only
  1522.               STATUS     current
  1523.               DESCRIPTION
  1524.                       "This counter is incremented by OctetCount for
  1525.                       each frame counted by dot12OutHighPriorityFrames.
  1526.  
  1527.                       This counter is a 64 bit version of
  1528.                       dot12OutHighPriorityOctets.  It should be used by
  1529.                       Network Management protocols which support 64 bit
  1530.                       counters (e.g. SNMPv2)."
  1531.               REFERENCE
  1532.                       "IEEE Standard 802.12-1995, 13.2.5.2.1,
  1533.                       aHighPriorityOctetsTransmitted."
  1534.              ::= { dot12StatEntry 14 }
  1535.  
  1536.           -- conformance information
  1537.  
  1538.           dot12Conformance  OBJECT IDENTIFIER ::= { dot12MIB 2 }
  1539.  
  1540.           dot12Compliances  OBJECT IDENTIFIER ::= { dot12Conformance 1 }
  1541.           dot12Groups       OBJECT IDENTIFIER ::= { dot12Conformance 2 }
  1542.  
  1543.           -- compliance statements
  1544.  
  1545.           dot12Compliance MODULE-COMPLIANCE
  1546.               STATUS     current
  1547.               DESCRIPTION
  1548.                          "The compliance statement for managed network
  1549.                          entities that have 802.12 interfaces."
  1550.  
  1551.               MODULE  -- this module
  1552.                   MANDATORY-GROUPS { dot12ConfigGroup, dot12StatsGroup }
  1553.  
  1554.                   OBJECT       dot12DesiredFramingType
  1555.                   MIN-ACCESS   read-only
  1556.                   DESCRIPTION
  1557.                          "Write access to this object is not required."
  1558.  
  1559.                   OBJECT       dot12DesiredPromiscStatus
  1560.                   MIN-ACCESS   read-only
  1561.                   DESCRIPTION
  1562.                          "Write access to this object is not required."
  1563.  
  1564.                   OBJECT       dot12Commands
  1565.                   MIN-ACCESS   read-only
  1566.                   DESCRIPTION
  1567.  
  1568.  
  1569.  
  1570. Flick                       Standards Track                    [Page 28]
  1571.  
  1572. RFC 2020               IEEE 802.12 Interface MIB            October 1996
  1573.  
  1574.  
  1575.                          "Write access to this object is not required."
  1576.  
  1577.                   OBJECT       dot12ControlMode
  1578.                   MIN-ACCESS   read-only
  1579.                   DESCRIPTION
  1580.                          "Write access to this object is not required."
  1581.               ::= { dot12Compliances 1 }
  1582.  
  1583.           -- units of conformance
  1584.  
  1585.           dot12ConfigGroup OBJECT-GROUP
  1586.               OBJECTS    { dot12DesiredFramingType,
  1587.                            dot12FramingCapability,
  1588.                            dot12DesiredPromiscStatus,
  1589.                            dot12TrainingVersion,
  1590.                            dot12LastTrainingConfig,
  1591.                            dot12Commands, dot12Status,
  1592.                            dot12CurrentFramingType,
  1593.                            dot12ControlMode }
  1594.               STATUS     current
  1595.               DESCRIPTION
  1596.                       "A collection of objects for managing the status
  1597.                       and configuration of IEEE 802.12 interfaces."
  1598.               ::= { dot12Groups 1 }
  1599.  
  1600.           dot12StatsGroup OBJECT-GROUP
  1601.               OBJECTS    { dot12InHighPriorityFrames,
  1602.                            dot12InHighPriorityOctets,
  1603.                            dot12InNormPriorityFrames,
  1604.                            dot12InNormPriorityOctets,
  1605.                            dot12InIPMErrors,
  1606.                            dot12InOversizeFrameErrors,
  1607.                            dot12InDataErrors,
  1608.                            dot12InNullAddressedFrames,
  1609.                            dot12OutHighPriorityFrames,
  1610.                            dot12OutHighPriorityOctets,
  1611.                            dot12TransitionIntoTrainings,
  1612.                            dot12HCInHighPriorityOctets,
  1613.                            dot12HCInNormPriorityOctets,
  1614.                            dot12HCOutHighPriorityOctets }
  1615.               STATUS     current
  1616.               DESCRIPTION
  1617.                       "A collection of objects providing statistics for
  1618.                       IEEE 802.12 interfaces."
  1619.               ::= { dot12Groups 2 }
  1620.  
  1621.       END
  1622.  
  1623.  
  1624.  
  1625.  
  1626. Flick                       Standards Track                    [Page 29]
  1627.  
  1628. RFC 2020               IEEE 802.12 Interface MIB            October 1996
  1629.  
  1630.  
  1631. 5.  Acknowledgements
  1632.  
  1633.    This document was produced by the IETF 100VG-AnyLAN Working Group.
  1634.    It is based on the work of IEEE 802.12.
  1635.  
  1636. 6.  References
  1637.  
  1638.    [1]  Information processing systems - Open Systems Interconnection -
  1639.         Specification of Abstract Syntax Notation One (ASN.1),
  1640.         International Organization for Standardization.  International
  1641.         Standard 8824 (December, 1987).
  1642.  
  1643.    [2]  SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M., and
  1644.         S. Waldbusser, "Structure of Management Information for Version
  1645.         2 of the Simple Network Management Protocol (SNMPv2)", RFC 1902,
  1646.         SNMP Research, Inc., Cisco Systems, Inc., Dover Beach
  1647.         Consulting, Inc., International Network Services, January 1996.
  1648.  
  1649.    [3]  SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M., and
  1650.         S. Waldbusser, "Textual Conventions for Version 2 of the Simple
  1651.         Network Management Protocol (SNMPv2)", RFC 1903, SNMP Research,
  1652.         Inc., Cisco Systems, Inc., Dover Beach Consulting, Inc.,
  1653.         International Network Services, January 1996.
  1654.  
  1655.    [4]  SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M., and
  1656.         S. Waldbusser, "Conformance Statements for Version 2 of the
  1657.         Simple Network Management Protocol (SNMPv2)", RFC 1904, SNMP
  1658.         Research, Inc., Cisco Systems, Inc., Dover Beach Consulting,
  1659.         Inc., International Network Services, January 1996.
  1660.  
  1661.    [5]  McCloghrie, K., and M. Rose, "Management Information Base for
  1662.         Network Management of TCP/IP-based internets - MIB-II", STD 17,
  1663.         RFC 1213, Hughes LAN Systems, Performance Systems International,
  1664.         March 1991.
  1665.  
  1666.    [6]  IEEE, "Demand Priority Access Method, Physical Layer and
  1667.         Repeater Specifications for 100 Mb/s Operation", IEEE Standard
  1668.         802.12-1995"
  1669.  
  1670.    [7]  McCloghrie, K., and Kastenholz, F., "Evolution of the Interfaces
  1671.         Group of MIB-II", RFC 1573, Hughes LAN Systems, FTP Software,
  1672.         January 1994.
  1673.  
  1674.    [8]  Kastenholz, F., "Definitions of Managed Objects for the
  1675.         Ethernet-like Interface Types", STD 50, RFC 1643, FTP Software,
  1676.         Inc., July, 1994.
  1677.  
  1678.  
  1679.  
  1680.  
  1681.  
  1682. Flick                       Standards Track                    [Page 30]
  1683.  
  1684. RFC 2020               IEEE 802.12 Interface MIB            October 1996
  1685.  
  1686.  
  1687.    [9]  Kastenholz, F., "Definitions of Managed Objects for the
  1688.         Ethernet-like Interface Types using SMIv2", RFC 1650, FTP
  1689.         Software, Inc., August, 1994.
  1690.  
  1691.    [10] McCloghrie, K., and Decker, E., "IEEE 802.5 MIB using SMIv2",
  1692.         RFC 1748, Cisco Systems, Inc., December, 1994.
  1693.  
  1694.    [11] McCloghrie, K., Baker, F., and Decker, E., "IEEE 802.5 Station
  1695.         Source Routing MIB using SMIv2", RFC 1749, Cisco Systems, Inc.,
  1696.         December, 1994.
  1697.  
  1698. 7.  Security Considerations
  1699.  
  1700.    Security issues are not discussed in this memo.
  1701.  
  1702. 8.  Author's Address
  1703.  
  1704.    John Flick
  1705.    Hewlett Packard Company
  1706.    8000 Foothills Blvd. M/S 5556
  1707.    Roseville, CA 95747-5556
  1708.  
  1709.    Phone: +1 916 785 4018
  1710.    Email: johnf@hprnd.rose.hp.com
  1711.  
  1712.  
  1713.  
  1714.  
  1715.  
  1716.  
  1717.  
  1718.  
  1719.  
  1720.  
  1721.  
  1722.  
  1723.  
  1724.  
  1725.  
  1726.  
  1727.  
  1728.  
  1729.  
  1730.  
  1731.  
  1732.  
  1733.  
  1734.  
  1735.  
  1736.  
  1737.  
  1738. Flick                       Standards Track                    [Page 31]
  1739.  
  1740.