home *** CD-ROM | disk | FTP | other *** search
/ Handbook of Infosec Terms 2.0 / Handbook_of_Infosec_Terms_Version_2.0_ISSO.iso / text / rfcs / rfc1743.txt < prev    next >
Text File  |  1996-05-07  |  44KB  |  555 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7. Network Working Group                                      K. McCloghrie Request for Comments: 1743                                     E. Decker Obsoletes: 1231                                      cisco Systems, Inc. Category: Standards Track                                  December 1994 
  8.  
  9.                         IEEE 802.5 MIB using SMIv2 
  10.  
  11. Status of this Memo 
  12.  
  13.    This document specifies an Internet standards track protocol for the    Internet community, and requests discussion and suggestions for    improvements.  Please refer to the current edition of the "Internet    Official Protocol Standards" (STD 1) for the standardization state    and status of this protocol.  Distribution of this memo is unlimited. 
  14.  
  15. Table of Contents 
  16.  
  17.    1. Introduction .............................................    1    2. The SNMPv2 Network Management Framework ..................    2    2.1 Object Definitions ......................................    2    3. Overview .................................................    2    3.1 MAC Addresses ...........................................    3    3.2 Relationship to RFC 1213 ................................    3    3.3 Relationship to RFC 1573 ................................    3    3.3.1 Layering Model ........................................    3    3.3.2 Virtual Circuits ......................................    3    3.3.3 ifTestTable ...........................................    3    3.3.4 ifRcvAddressTable .....................................    4    3.3.5 ifPhysAddress .........................................    4    3.3.6 ifType ................................................    4    4. Definitions ..............................................    4    5. Acknowledgements .........................................   23    6. References ...............................................   23    Appendix A. Changes from RFC 1231 ...........................   24    Security Considerations .....................................   24    Authors' Addresses ..........................................   25 
  18.  
  19. 1.  Introduction 
  20.  
  21.    This memo defines a portion of the Management Information Base (MIB)    for use with network management protocols in the Internet community.    In particular, it describes managed objects used for managing    subnetworks which use the IEEE 802.5 Token Ring technology described    in 802.5 Token Ring Access Method and Physical Layer Specifications,    IEEE Standard 802.5-1989 [7].  This memo is a replacement for RFC    1231. 
  22.  
  23.  
  24.  
  25.  McCloghrie & Decker                                             [Page 1] 
  26.  RFC 1743               IEEE 802.5 MIB using SMIv2          December 1994 
  27.  
  28.  2.  The SNMPv2 Network Management Framework 
  29.  
  30.    The SNMPv2 Network Management Framework consists of four major    components.  They are: 
  31.  
  32.       o    RFC 1442 [1] which defines the SMI, the mechanisms used for            describing and naming objects for the purpose of management. 
  33.  
  34.       o    STD 17, RFC 1213 [2] defines MIB-II, the core set of managed            objects for the Internet suite of protocols. 
  35.  
  36.       o    RFC 1445 [3] which defines the administrative and other            architectural aspects of the framework. 
  37.  
  38.       o    RFC 1448 [4] which defines the protocol used for network            access to managed objects. 
  39.  
  40.    The Framework permits new objects to be defined for the purpose of    experimentation and evaluation. 
  41.  
  42. 2.1.  Object Definitions 
  43.  
  44.    Managed objects are accessed via a virtual information store, termed    the Management Information Base or MIB.  Objects in the MIB are    defined using the subset of Abstract Syntax Notation One (ASN.1)    defined in the SMI.  In particular, each object type is named by an    OBJECT IDENTIFIER, an administratively assigned name.  The object    type together with an object instance serves to uniquely identify a    specific instantiation of the object.  For human convenience, we    often use a textual string, termed the descriptor, to refer to the    object type. 
  45.  
  46. 3.  Overview 
  47.  
  48.    This memo defines three tables: the 802.5 Interface Table, which    contains state and parameter information which is specific to 802.5    interfaces, the 802.5 Statistics Table, which contains 802.5    interface statistics, and the 802.5 Timer Table, which contains the    values of 802.5-defined timers. A managed system will have one entry    in the 802.5 Interface Table and one entry in the 802.5 Statistics    Table for each of its 802.5 interfaces.  The 802.5 Timer Table is    obsolete, but its definition has been retained in this memo for    backward compatibility. 
  49.  
  50.    This memo also defines OBJECT IDENTIFIERs, some to identify interface    tests for use with the ifTestTable [6], and some to identify Token    Ring interface Chip Sets. 
  51.  
  52.  
  53.  
  54.  McCloghrie & Decker                                             [Page 2] 
  55.  RFC 1743               IEEE 802.5 MIB using SMIv2          December 1994 
  56.  
  57.  3.1.  MAC Addresses 
  58.  
  59.    All representations of MAC addresses in this MIB Module use the    MacAddress textual convention [5] for which the address is in the    "canonical" order defined by IEEE 802.1a, i.e., as if it were    transmitted least significant bit first, even though 802.5 requires    MAC addresses to be transmitted most significant bit first. 
  60.  
  61.    16-bit addresses, if needed, are represented by setting their upper 4    octets to all zeros, i.e., AAFF would be represented as 00000000AAFF. 
  62.  
  63. 3.2.  Relationship to RFC 1213 
  64.  
  65.    When this MIB module is used in conjunction with the "old" (i.e.,    pre-RFC 1573) interfaces group, the relationship between an 802.5    interface and an interface in the context of the RFC 1213 is one-    to-one.  That is, the value of an ifIndex object instance for an    802.5 interface can be directly used to identify corresponding    instances of the objects defined in this memo. 
  66.  
  67. 3.3.  Relationship to RFC 1573 
  68.  
  69.    RFC 1573, the Interface MIB Evolution, requires that any MIB module    which is an adjunct of the Interface MIB, clarify specific areas    within the Interface MIB.  These areas were intentionally left vague    in RFC 1573 to avoid over constraining the MIB module, thereby    precluding management of certain media-types. 
  70.  
  71.    Section 3.3 of RFC 1573 enumerates several areas which a media-    specific MIB module must clarify.  Each of these areas is addressed    in a following subsection.  The implementor is referred to RFC 1573    in order to understand the general intent of these areas. 
  72.  
  73. 3.3.1.  Layering Model 
  74.  
  75.    For the typical usage of this IEEE 802.5 MIB module, there will be no    sub-layers "above" or "below" the 802.5 interface.  However, this MIB    module does not preclude such layering. 
  76.  
  77. 3.3.2.  Virtual Circuits 
  78.  
  79.    802.5 does not support virtual circuits. 
  80.  
  81. 3.3.3.  ifTestTable 
  82.  
  83.    This MIB module defines two tests for 802.5 interfaces: Insertion and    Loopback.  Implementation of these tests is not required. 
  84.  
  85.  
  86.  
  87.  McCloghrie & Decker                                             [Page 3] 
  88.  RFC 1743               IEEE 802.5 MIB using SMIv2          December 1994 
  89.  
  90.  3.3.4.  ifRcvAddressTable 
  91.  
  92.    The ifRcvAddressTable is defined to contains all MAC addresses,    unicast, multicast (group) and broadcast, for which an interface will    receive packets.  For 802.5 interfaces, its use includes functional    addresses. The format of the address, contained in    ifRcvAddressAddress, is the same as for ifPhysAddress. 
  93.  
  94.    For functional addresses on a particular 802.5 interface, only one    ifRcvAddressTable entry is required.  That entry is the one for the    address which has the functional address bit ANDed with the bit mask    of all functional addresses for which the interface will accept    frames. 
  95.  
  96. 3.3.5.  ifPhysAddress 
  97.  
  98.    For an 802.5 interface, ifPhysAddress contains the interface's IEEE    MAC address, stored as an octet string of length 6, in IEEE 802.1a    "canonical" order, i.e., the Group Bit is positioned as the low-order    bit (0x01) of the first octet. 
  99.  
  100. 3.3.6.  ifType 
  101.  
  102.    The objects defined in this memo apply to each interface for which    the ifType has the value: 
  103.  
  104.                   iso88025-tokenRing(9) 
  105.  
  106. 4.  Definitions 
  107.  
  108. TOKENRING-MIB DEFINITIONS ::= BEGIN 
  109.  
  110. IMPORTS     MODULE-IDENTITY, OBJECT-TYPE, OBJECT-IDENTITY,     Counter32, Integer32                 FROM SNMPv2-SMI     transmission                         FROM RFC1213-MIB     MacAddress,TimeStamp                 FROM SNMPv2-TC     MODULE-COMPLIANCE, OBJECT-GROUP      FROM SNMPv2-CONF; 
  111.  
  112. dot5 MODULE-IDENTITY     LAST-UPDATED "9410231150Z"     ORGANIZATION "IETF Interfaces MIB Working Group"     CONTACT-INFO             "        Keith McCloghrie 
  113.  
  114.              Postal: cisco Systems, Inc.                      170 West Tasman Drive,                      San Jose, CA 95134-1706 
  115.  
  116.  
  117.  
  118. McCloghrie & Decker                                             [Page 4] 
  119.  RFC 1743               IEEE 802.5 MIB using SMIv2          December 1994 
  120.  
  121.                       US 
  122.  
  123.               Phone: +1 408 526 5260               EMail: kzm@cisco.com"     DESCRIPTION         "The MIB module for IEEE Token Ring entities."     ::= { transmission 9 } 
  124.  
  125.  --              The 802.5 Interface Table 
  126.  
  127. -- This table contains state and parameter information which -- is specific to 802.5 interfaces.  It is mandatory that -- systems having 802.5 interfaces implement this table in -- addition to the ifTable (see RFCs 1213 and 1573). 
  128.  
  129. dot5Table       OBJECT-TYPE     SYNTAX      SEQUENCE OF Dot5Entry     MAX-ACCESS  not-accessible     STATUS      current     DESCRIPTION             "This table contains Token Ring interface             parameters and state variables, one entry             per 802.5 interface."     ::= { dot5 1 } 
  130.  
  131. dot5Entry       OBJECT-TYPE     SYNTAX      Dot5Entry     MAX-ACCESS  not-accessible     STATUS      current     DESCRIPTION             "A list of Token Ring status and parameter              values for an 802.5 interface."     INDEX       { dot5IfIndex }     ::= { dot5Table 1 } 
  132.  
  133. Dot5Entry ::= SEQUENCE {      dot5IfIndex              Integer32,      dot5Commands             INTEGER,      dot5RingStatus           INTEGER,      dot5RingState            INTEGER,      dot5RingOpenStatus       INTEGER,      dot5RingSpeed            INTEGER,      dot5UpStream             MacAddress,      dot5ActMonParticipate    INTEGER,      dot5Functional           MacAddress,      dot5LastBeaconSent       TimeStamp } 
  134.  
  135.  
  136.  
  137. McCloghrie & Decker                                             [Page 5] 
  138.  RFC 1743               IEEE 802.5 MIB using SMIv2          December 1994 
  139.  
  140.  dot5IfIndex     OBJECT-TYPE     SYNTAX      Integer32     MAX-ACCESS  read-only     STATUS      current     DESCRIPTION             "The value of this object identifies the              802.5 interface for which this entry              contains management information.  The              value of this object for a particular              interface has the same value as the              ifIndex object, defined in MIB-II for              the same interface."     ::= { dot5Entry 1 } 
  141.  
  142. dot5Commands    OBJECT-TYPE     SYNTAX      INTEGER {                     noop(1),                     open(2),                     reset(3),                     close(4)                 }     MAX-ACCESS  read-write     STATUS      current     DESCRIPTION             "When this object is set to the value of              open(2), the station should go into the              open state.  The progress and success of              the open is given by the values of the              objects dot5RingState and              dot5RingOpenStatus.                  When this object is set to the value              of reset(3), then the station should do              a reset.  On a reset, all MIB counters              should retain their values, if possible.              Other side affects are dependent on the              hardware chip set.                  When this object is set to the value              of close(4), the station should go into              the stopped state by removing itself              from the ring.                  Setting this object to a value of              noop(1) has no effect.                  When read, this object always has a              value of noop(1).                  The open(2) and close(4) values              correspond to the up(1) and down(2) values              of MIB-II's ifAdminStatus and ifOperStatus,              i.e., the setting of ifAdminStatus and 
  143.  
  144.  
  145.  
  146. McCloghrie & Decker                                             [Page 6] 
  147.  RFC 1743               IEEE 802.5 MIB using SMIv2          December 1994 
  148.  
  149.               dot5Commands affects the values of both              dot5Commands and ifOperStatus."     ::= { dot5Entry 2 } 
  150.  
  151. dot5RingStatus  OBJECT-TYPE     SYNTAX      INTEGER (0..262143)     MAX-ACCESS  read-only     STATUS      current     DESCRIPTION             "The current interface status which can             be used to diagnose fluctuating problems             that can occur on token rings, after a             station has successfully been added to             the ring.                Before an open is completed, this             object has the value for the 'no status'             condition.  The dot5RingState and             dot5RingOpenStatus objects provide for             debugging problems when the station             can not even enter the ring.                 The object's value is a sum of             values, one for each currently applicable             condition.  The following values are             defined for various conditions: 
  152.  
  153.                     0 = No Problems detected                    32 = Ring Recovery                    64 = Single Station                   256 = Remove Received                   512 = reserved                  1024 = Auto-Removal Error                  2048 = Lobe Wire Fault                  4096 = Transmit Beacon                  8192 = Soft Error                 16384 = Hard Error                 32768 = Signal Loss                131072 = no status, open not completed."     ::= { dot5Entry 3 } 
  154.  
  155. dot5RingState   OBJECT-TYPE     SYNTAX      INTEGER {                     opened(1),                     closed(2),                     opening(3),                     closing(4),                     openFailure(5),                     ringFailure(6)                 } 
  156.  
  157.  
  158.  
  159. McCloghrie & Decker                                             [Page 7] 
  160.  RFC 1743               IEEE 802.5 MIB using SMIv2          December 1994 
  161.  
  162.      MAX-ACCESS  read-only     STATUS      current     DESCRIPTION             "The current interface state with respect             to entering or leaving the ring."     ::= { dot5Entry 4 } 
  163.  
  164. dot5RingOpenStatus  OBJECT-TYPE     SYNTAX      INTEGER {                     noOpen(1),     -- no open attempted                     badParam(2),                     lobeFailed(3),                     signalLoss(4),                     insertionTimeout(5),                     ringFailed(6),                     beaconing(7),                     duplicateMAC(8),                     requestFailed(9),                     removeReceived(10),                     open(11)      -- last open successful                 }     MAX-ACCESS  read-only     STATUS      current     DESCRIPTION             "This object indicates the success, or the             reason for failure, of the station's most             recent attempt to enter the ring."     ::= { dot5Entry 5 } 
  165.  
  166. dot5RingSpeed   OBJECT-TYPE     SYNTAX      INTEGER {                     unknown(1),                     oneMegabit(2),                     fourMegabit(3),                     sixteenMegabit(4)                 }     MAX-ACCESS  read-write     STATUS      current     DESCRIPTION             "The ring-speed at the next insertion into             the ring.  Note that this may or may not be             different to the current ring-speed which is             given by MIB-II's ifSpeed.  For interfaces             which do not support changing ring-speed,             dot5RingSpeed can only be set to its current             value.  When dot5RingSpeed has the value             unknown(1), the ring's actual ring-speed is             to be used." 
  167.  
  168.  
  169.  
  170. McCloghrie & Decker                                             [Page 8] 
  171.  RFC 1743               IEEE 802.5 MIB using SMIv2          December 1994 
  172.  
  173.      ::= { dot5Entry 6 } 
  174.  
  175. dot5UpStream    OBJECT-TYPE     SYNTAX      MacAddress     MAX-ACCESS  read-only     STATUS      current     DESCRIPTION             "The MAC-address of the up stream neighbor              station in the ring."     ::= { dot5Entry 7 } 
  176.  
  177. dot5ActMonParticipate OBJECT-TYPE     SYNTAX      INTEGER {                     true(1),                     false(2)                 }     MAX-ACCESS  read-write     STATUS      current     DESCRIPTION             "If this object has a value of true(1) then             this interface will participate in the             active monitor selection process.  If the             value is false(2) then it will not.             Setting this object does not take effect             until the next Active Monitor election, and             might not take effect until the next time             the interface is opened."     ::= { dot5Entry 8 } 
  178.  
  179. dot5Functional  OBJECT-TYPE     SYNTAX      MacAddress     MAX-ACCESS  read-write     STATUS      current     DESCRIPTION             "The bit mask of all Token Ring functional             addresses for which this interface will             accept frames."     ::= { dot5Entry 9 } 
  180.  
  181. dot5LastBeaconSent OBJECT-TYPE     SYNTAX      TimeStamp     MAX-ACCESS  read-only     STATUS      current     DESCRIPTION             "The value of MIB-II's sysUpTime object at which             the local system last transmitted a Beacon frame             on this interface."     ::= { dot5Entry 10 } 
  182.  
  183.  
  184.  
  185. McCloghrie & Decker                                             [Page 9] 
  186.  RFC 1743               IEEE 802.5 MIB using SMIv2          December 1994 
  187.  
  188.  --   The 802.5 Statistics Table 
  189.  
  190. -- This table contains statistics and error counter which are -- specific to 802.5 interfaces.  It is mandatory that systems -- having 802.5 interfaces implement this table. 
  191.  
  192. dot5StatsTable  OBJECT-TYPE     SYNTAX      SEQUENCE OF Dot5StatsEntry     MAX-ACCESS  not-accessible     STATUS      current     DESCRIPTION             "A table containing Token Ring statistics,             one entry per 802.5 interface.                 All the statistics are defined using             the syntax Counter32 as 32-bit wrap around             counters.  Thus, if an interface's             hardware maintains these statistics in             16-bit counters, then the agent must read             the hardware's counters frequently enough             to prevent loss of significance, in order             to maintain 32-bit counters in software."     ::= { dot5 2 } 
  193.  
  194. dot5StatsEntry  OBJECT-TYPE     SYNTAX      Dot5StatsEntry     MAX-ACCESS  not-accessible     STATUS      current     DESCRIPTION             "An entry contains the 802.5 statistics              for a particular interface."     INDEX       { dot5StatsIfIndex }     ::= { dot5StatsTable 1 } 
  195.  
  196.  Dot5StatsEntry ::= SEQUENCE {      dot5StatsIfIndex              Integer32,      dot5StatsLineErrors           Counter32,      dot5StatsBurstErrors          Counter32,      dot5StatsACErrors             Counter32,      dot5StatsAbortTransErrors     Counter32,      dot5StatsInternalErrors       Counter32,      dot5StatsLostFrameErrors      Counter32,      dot5StatsReceiveCongestions   Counter32,      dot5StatsFrameCopiedErrors    Counter32,      dot5StatsTokenErrors          Counter32,      dot5StatsSoftErrors           Counter32,      dot5StatsHardErrors           Counter32,      dot5StatsSignalLoss           Counter32, 
  197.  
  198.  
  199.  
  200. McCloghrie & Decker                                            [Page 10] 
  201.  RFC 1743               IEEE 802.5 MIB using SMIv2          December 1994 
  202.  
  203.       dot5StatsTransmitBeacons      Counter32,      dot5StatsRecoverys            Counter32,      dot5StatsLobeWires            Counter32,      dot5StatsRemoves              Counter32,      dot5StatsSingles              Counter32,      dot5StatsFreqErrors           Counter32 } 
  204.  
  205.  dot5StatsIfIndex  OBJECT-TYPE     SYNTAX      Integer32     MAX-ACCESS  read-only     STATUS      current     DESCRIPTION             "The value of this object identifies the             802.5 interface for which this entry             contains management information.  The             value of this object for a particular             interface has the same value as MIB-II's             ifIndex object for the same interface."     ::= { dot5StatsEntry 1 } 
  206.  
  207. dot5StatsLineErrors OBJECT-TYPE     SYNTAX      Counter32     MAX-ACCESS  read-only     STATUS      current     DESCRIPTION             "This counter is incremented when a frame             or token is copied or repeated by a             station, the E bit is zero in the frame             or token and one of the following             conditions exists: 1) there is a             non-data bit (J or K bit) between the SD             and the ED of the frame or token, or             2) there is an FCS error in the frame."     ::= { dot5StatsEntry 2 } 
  208.  
  209. dot5StatsBurstErrors OBJECT-TYPE     SYNTAX      Counter32     MAX-ACCESS  read-only     STATUS      current     DESCRIPTION             "This counter is incremented when a station             detects the absence of transitions for five             half-bit timers (burst-five error)."     ::= { dot5StatsEntry 3 } 
  210.  
  211.  
  212.  
  213.  
  214.  
  215. McCloghrie & Decker                                            [Page 11] 
  216.  RFC 1743               IEEE 802.5 MIB using SMIv2          December 1994 
  217.  
  218.  dot5StatsACErrors OBJECT-TYPE     SYNTAX      Counter32     MAX-ACCESS  read-only     STATUS      current     DESCRIPTION             "This counter is incremented when a station             receives an AMP or SMP frame in which A is             equal to C is equal to 0, and then receives             another SMP frame with A is equal to C is             equal to 0 without first receiving an AMP             frame. It denotes a station that cannot set             the AC bits properly."     ::= { dot5StatsEntry 4 } 
  219.  
  220. dot5StatsAbortTransErrors OBJECT-TYPE     SYNTAX      Counter32     MAX-ACCESS  read-only     STATUS      current     DESCRIPTION             "This counter is incremented when a station             transmits an abort delimiter while             transmitting."     ::= { dot5StatsEntry 5 } 
  221.  
  222. dot5StatsInternalErrors OBJECT-TYPE     SYNTAX      Counter32     MAX-ACCESS  read-only     STATUS      current     DESCRIPTION             "This counter is incremented when a station             recognizes an internal error."     ::= { dot5StatsEntry 6 } 
  223.  
  224. dot5StatsLostFrameErrors OBJECT-TYPE     SYNTAX      Counter32     MAX-ACCESS  read-only     STATUS      current     DESCRIPTION             "This counter is incremented when a station             is transmitting and its TRR timer expires.             This condition denotes a condition where a             transmitting station in strip mode does not             receive the trailer of the frame before the             TRR timer goes off."     ::= { dot5StatsEntry 7 } 
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  McCloghrie & Decker                                            [Page 12] 
  231.  RFC 1743               IEEE 802.5 MIB using SMIv2          December 1994 
  232.  
  233.  dot5StatsReceiveCongestions OBJECT-TYPE     SYNTAX      Counter32     MAX-ACCESS  read-only     STATUS      current     DESCRIPTION             "This counter is incremented when a station             recognizes a frame addressed to its             specific address, but has no available             buffer space indicating that the station             is congested."     ::= { dot5StatsEntry 8 } 
  234.  
  235. dot5StatsFrameCopiedErrors OBJECT-TYPE     SYNTAX      Counter32     MAX-ACCESS  read-only     STATUS      current     DESCRIPTION             "This counter is incremented when a station             recognizes a frame addressed to its             specific address and detects that the FS             field A bits are set to 1 indicating a             possible line hit or duplicate address."     ::= { dot5StatsEntry 9 } 
  236.  
  237. dot5StatsTokenErrors OBJECT-TYPE     SYNTAX      Counter32     MAX-ACCESS  read-only     STATUS      current     DESCRIPTION             "This counter is incremented when a station             acting as the active monitor recognizes an             error condition that needs a token             transmitted."     ::= { dot5StatsEntry 10 } 
  238.  
  239. dot5StatsSoftErrors OBJECT-TYPE     SYNTAX      Counter32     MAX-ACCESS  read-only     STATUS      current     DESCRIPTION             "The number of Soft Errors the interface             has detected. It directly corresponds to             the number of Report Error MAC frames             that this interface has transmitted.             Soft Errors are those which are             recoverable by the MAC layer protocols."     ::= { dot5StatsEntry 11 } 
  240.  
  241.  
  242.  
  243.  McCloghrie & Decker                                            [Page 13] 
  244.  RFC 1743               IEEE 802.5 MIB using SMIv2          December 1994 
  245.  
  246.  dot5StatsHardErrors OBJECT-TYPE     SYNTAX      Counter32     MAX-ACCESS  read-only     STATUS      current     DESCRIPTION             "The number of times this interface has             detected an immediately recoverable             fatal error.  It denotes the number of             times this interface is either             transmitting or receiving beacon MAC             frames."     ::= { dot5StatsEntry 12 } 
  247.  
  248. dot5StatsSignalLoss OBJECT-TYPE     SYNTAX      Counter32     MAX-ACCESS  read-only     STATUS      current     DESCRIPTION             "The number of times this interface has             detected the loss of signal condition from             the ring."     ::= { dot5StatsEntry 13 } 
  249.  
  250. dot5StatsTransmitBeacons OBJECT-TYPE     SYNTAX      Counter32     MAX-ACCESS  read-only     STATUS      current     DESCRIPTION             "The number of times this interface has             transmitted a beacon frame."     ::= { dot5StatsEntry 14 } 
  251.  
  252. dot5StatsRecoverys OBJECT-TYPE     SYNTAX      Counter32     MAX-ACCESS  read-only     STATUS      current     DESCRIPTION             "The number of Claim Token MAC frames             received or transmitted after the interface             has received a Ring Purge MAC frame.  This             counter signifies the number of times the             ring has been purged and is being recovered             back into a normal operating state."     ::= { dot5StatsEntry 15 } 
  253.  
  254. dot5StatsLobeWires OBJECT-TYPE     SYNTAX      Counter32     MAX-ACCESS  read-only 
  255.  
  256.  
  257.  
  258. McCloghrie & Decker                                            [Page 14] 
  259.  RFC 1743               IEEE 802.5 MIB using SMIv2          December 1994 
  260.  
  261.      STATUS      current     DESCRIPTION             "The number of times the interface has             detected an open or short circuit in the             lobe data path.  The adapter will be closed             and dot5RingState will signify this             condition."     ::= { dot5StatsEntry 16 } 
  262.  
  263. dot5StatsRemoves OBJECT-TYPE     SYNTAX      Counter32     MAX-ACCESS  read-only     STATUS      current     DESCRIPTION             "The number of times the interface has             received a Remove Ring Station MAC frame             request.  When this frame is received             the interface will enter the close state             and dot5RingState will signify this             condition."     ::= { dot5StatsEntry 17 } 
  264.  
  265. dot5StatsSingles OBJECT-TYPE     SYNTAX      Counter32     MAX-ACCESS  read-only     STATUS      current     DESCRIPTION             "The number of times the interface has             sensed that it is the only station on the             ring.  This will happen if the interface             is the first one up on a ring, or if             there is a hardware problem."     ::= { dot5StatsEntry 18 } 
  266.  
  267. dot5StatsFreqErrors OBJECT-TYPE     SYNTAX      Counter32     MAX-ACCESS  read-only     STATUS      current     DESCRIPTION             "The number of times the interface has             detected that the frequency of the             incoming signal differs from the expected             frequency by more than that specified by             the IEEE 802.5 standard."     ::= { dot5StatsEntry 19 } 
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  McCloghrie & Decker                                            [Page 15] 
  274.  RFC 1743               IEEE 802.5 MIB using SMIv2          December 1994 
  275.  
  276.  -- The Timer Table 
  277.  
  278. -- This group contains the values of timers for 802.5 -- interfaces.  This table is obsolete, but its definition -- is retained here for backwards compatibility. 
  279.  
  280. dot5TimerTable  OBJECT-TYPE     SYNTAX      SEQUENCE OF Dot5TimerEntry     MAX-ACCESS  not-accessible     STATUS      obsolete     DESCRIPTION             "This table contains Token Ring interface             timer values, one entry per 802.5             interface."     ::= { dot5 5 } 
  281.  
  282. dot5TimerEntry  OBJECT-TYPE     SYNTAX      Dot5TimerEntry     MAX-ACCESS  not-accessible     STATUS      obsolete     DESCRIPTION             "A list of Token Ring timer values for an             802.5 interface."     INDEX       { dot5TimerIfIndex }     ::= { dot5TimerTable 1 } 
  283.  
  284. Dot5TimerEntry ::= SEQUENCE {     dot5TimerIfIndex          Integer32,     dot5TimerReturnRepeat     Integer32,     dot5TimerHolding          Integer32,     dot5TimerQueuePDU         Integer32,     dot5TimerValidTransmit    Integer32,     dot5TimerNoToken          Integer32,     dot5TimerActiveMon        Integer32,     dot5TimerStandbyMon       Integer32,     dot5TimerErrorReport      Integer32,     dot5TimerBeaconTransmit   Integer32,     dot5TimerBeaconReceive    Integer32 } 
  285.  
  286. dot5TimerIfIndex  OBJECT-TYPE     SYNTAX      Integer32     MAX-ACCESS  read-only     STATUS      obsolete     DESCRIPTION             "The value of this object identifies the              802.5 interface for which this entry              contains timer values.  The value of 
  287.  
  288.  
  289.  
  290. McCloghrie & Decker                                            [Page 16] 
  291.  RFC 1743               IEEE 802.5 MIB using SMIv2          December 1994 
  292.  
  293.               this object for a particular interface              has the same value as MIB-II's ifIndex              object for the same interface."     ::= { dot5TimerEntry 1 } 
  294.  
  295. dot5TimerReturnRepeat  OBJECT-TYPE     SYNTAX      Integer32     MAX-ACCESS  read-only     STATUS      obsolete     DESCRIPTION             "The time-out value used to ensure the             interface will return to Repeat State, in             units of 100 micro-seconds.  The value             should be greater than the maximum ring             latency."     ::= { dot5TimerEntry 2 } 
  296.  
  297. dot5TimerHolding  OBJECT-TYPE     SYNTAX      Integer32     MAX-ACCESS  read-only     STATUS      obsolete     DESCRIPTION             "Maximum period of time a station is             permitted to transmit frames after capturing             a token, in units of 100 micro-seconds."     ::= { dot5TimerEntry 3 } 
  298.  
  299. dot5TimerQueuePDU  OBJECT-TYPE     SYNTAX      Integer32     MAX-ACCESS  read-only     STATUS      obsolete     DESCRIPTION             "The time-out value for enqueuing of an SMP             PDU after reception of an AMP or SMP             frame in which the A and C bits were             equal to 0, in units of 100             micro-seconds."     ::= { dot5TimerEntry 4 } 
  300.  
  301. dot5TimerValidTransmit OBJECT-TYPE     SYNTAX      Integer32     MAX-ACCESS  read-only     STATUS      obsolete     DESCRIPTION             "The time-out value used by the active             monitor to detect the absence of valid             transmissions, in units of 100             micro-seconds." 
  302.  
  303.  
  304.  
  305. McCloghrie & Decker                                            [Page 17] 
  306.  RFC 1743               IEEE 802.5 MIB using SMIv2          December 1994 
  307.  
  308.      ::= { dot5TimerEntry 5 } 
  309.  
  310. dot5TimerNoToken  OBJECT-TYPE     SYNTAX      Integer32     MAX-ACCESS  read-only     STATUS      obsolete     DESCRIPTION             "The time-out value used to recover from             various-related error situations.             If N is the maximum number of stations on             the ring, the value of this timer is             normally:             dot5TimerReturnRepeat + N*dot5TimerHolding."     ::= { dot5TimerEntry 6 } 
  311.  
  312. dot5TimerActiveMon  OBJECT-TYPE     SYNTAX      Integer32     MAX-ACCESS  read-only     STATUS      obsolete     DESCRIPTION             "The time-out value used by the active             monitor to stimulate the enqueuing of an             AMP PDU for transmission, in units of             100 micro-seconds."     ::= { dot5TimerEntry 7 } 
  313.  
  314. dot5TimerStandbyMon  OBJECT-TYPE     SYNTAX      Integer32     MAX-ACCESS  read-only     STATUS      obsolete     DESCRIPTION             "The time-out value used by the stand-by             monitors to ensure that there is an active             monitor on the ring and to detect a             continuous stream of tokens, in units of             100 micro-seconds."     ::= { dot5TimerEntry 8 } 
  315.  
  316. dot5TimerErrorReport  OBJECT-TYPE     SYNTAX      Integer32     MAX-ACCESS  read-only     STATUS      obsolete     DESCRIPTION             "The time-out value which determines how             often a station shall send a Report Error             MAC frame to report its error counters,             in units of 100 micro-seconds."     ::= { dot5TimerEntry 9 } 
  317.  
  318.  
  319.  
  320. McCloghrie & Decker                                            [Page 18] 
  321.  RFC 1743               IEEE 802.5 MIB using SMIv2          December 1994 
  322.  
  323.  dot5TimerBeaconTransmit  OBJECT-TYPE     SYNTAX      Integer32     MAX-ACCESS  read-only     STATUS      obsolete     DESCRIPTION             "The time-out value which determines how             long a station shall remain in the state             of transmitting Beacon frames before             entering the Bypass state, in units of             100 micro-seconds."     ::= { dot5TimerEntry 10 } 
  324.  
  325. dot5TimerBeaconReceive  OBJECT-TYPE     SYNTAX      Integer32     MAX-ACCESS  read-only     STATUS      obsolete     DESCRIPTION             "The time-out value which determines how             long a station shall receive Beacon             frames from its downstream neighbor             before entering the Bypass state, in             units of 100 micro-seconds."     ::= { dot5TimerEntry 11 } 
  326.  
  327.  --                802.5 Interface Tests 
  328.  
  329. dot5Tests   OBJECT IDENTIFIER ::= { dot5 3 } 
  330.  
  331. -- RFC 1573 defines the ifTestTable, through which a -- network manager can instruct an agent to test an interface -- for various faults.  A test to be performed is identified -- as an OBJECT IDENTIFIER. 
  332.  
  333. -- The Insert Function test 
  334.  
  335. dot5TestInsertFunc  OBJECT-IDENTITY     STATUS       current     DESCRIPTION         "Invoking this test causes the station to test the insert         ring logic of the hardware if the station's lobe media         cable is connected to a wiring concentrator.  Note that         this command inserts the station into the network, and         thus, could cause problems if the station is connected         to a operational network."     ::= { dot5Tests 1 } 
  336.  
  337.  
  338.  
  339.  
  340.  
  341. McCloghrie & Decker                                            [Page 19] 
  342.  RFC 1743               IEEE 802.5 MIB using SMIv2          December 1994 
  343.  
  344.  -- The Full-Duplex Loop Back test 
  345.  
  346. dot5TestFullDuplexLoopBack OBJECT-IDENTITY     STATUS       current     DESCRIPTION         "Invoking this test on a 802.5 interface causes the         interface to check the path from memory through the         chip set's internal logic and back to memory, thus         checking the proper functioning of the system's         interface to the chip set."     ::= { dot5Tests 2 } 
  347.  
  348.  --              802.5 Hardware Chip Sets 
  349.  
  350. -- RFC 1229 specified an object, ifExtnsChipSet, with the -- syntax of OBJECT IDENTIFIER, to identify the hardware -- chip set in use by an interface.  RFC 1573 obsoletes -- the use of ifExtnsChipSet.  However, the following -- definitions are retained for backwards compatibility. 
  351.  
  352. dot5ChipSets   OBJECT IDENTIFIER ::= { dot5 4 } 
  353.  
  354. dot5ChipSetIBM16  OBJECT-IDENTITY     STATUS        current     DESCRIPTION         "IBM's 16/4 Mbs chip set."     ::= { dot5ChipSets 1 } 
  355.  
  356. dot5ChipSetTItms380 OBJECT-IDENTITY     STATUS        current     DESCRIPTION         "Texas Instruments' TMS 380 4Mbs chip-set"     ::= { dot5ChipSets 2 } 
  357.  
  358. dot5ChipSetTItms380c16 OBJECT-IDENTITY     STATUS        current     DESCRIPTION         "Texas Instruments' TMS 380C16 16/4 Mbs chip-set"     ::= { dot5ChipSets 3 } 
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370. McCloghrie & Decker                                            [Page 20] 
  371.  RFC 1743               IEEE 802.5 MIB using SMIv2          December 1994 
  372.  
  373.  -- conformance information 
  374.  
  375. dot5Conformance OBJECT IDENTIFIER ::= { dot5 5 } 
  376.  
  377. dot5Groups      OBJECT IDENTIFIER ::= { dot5Conformance 1 } dot5Compliances OBJECT IDENTIFIER ::= { dot5Conformance 2 } 
  378.  
  379.  -- compliance statements 
  380.  
  381. dot5Compliance MODULE-COMPLIANCE     STATUS  current     DESCRIPTION         "The compliance statement for SNMPv2 entities         which implement the IEEE 802.5 MIB." 
  382.  
  383.     MODULE  -- this module         MANDATORY-GROUPS { dot5StateGroup, dot5StatsGroup } 
  384.  
  385.         OBJECT     dot5ActMonParticipate         MIN-ACCESS read-only         DESCRIPTION             "Write access is not required." 
  386.  
  387.         OBJECT     dot5Functional         MIN-ACCESS read-only         DESCRIPTION             "Write access is not required." 
  388.  
  389.     ::= { dot5Compliances 1 } 
  390.  
  391.  -- units of conformance 
  392.  
  393. dot5StateGroup  OBJECT-GROUP     OBJECTS   { dot5Commands, dot5RingStatus, dot5RingState,                 dot5RingOpenStatus, dot5RingSpeed, dot5UpStream,                 dot5ActMonParticipate, dot5Functional,                 dot5LastBeaconSent               }     STATUS    current     DESCRIPTION         "A collection of objects providing state information         and parameters for IEEE 802.5 interfaces."     ::= { dot5Groups 1 } 
  394.  
  395. dot5StatsGroup  OBJECT-GROUP     OBJECTS   { dot5StatsLineErrors, dot5StatsBurstErrors, 
  396.  
  397.  
  398.  
  399. McCloghrie & Decker                                            [Page 21] 
  400.  RFC 1743               IEEE 802.5 MIB using SMIv2          December 1994 
  401.  
  402.                  dot5StatsACErrors, dot5StatsAbortTransErrors,                 dot5StatsInternalErrors, dot5StatsLostFrameErrors,                 dot5StatsReceiveCongestions,                 dot5StatsFrameCopiedErrors, dot5StatsTokenErrors,                 dot5StatsSoftErrors, dot5StatsHardErrors,                 dot5StatsSignalLoss, dot5StatsTransmitBeacons,                 dot5StatsRecoverys, dot5StatsLobeWires,                 dot5StatsRemoves, dot5StatsSingles,                 dot5StatsFreqErrors               }     STATUS    current     DESCRIPTION         "A collection of objects providing statistics for         IEEE 802.5 interfaces."     ::= { dot5Groups 2 } 
  403.  
  404. END 
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  McCloghrie & Decker                                            [Page 22] 
  439.  RFC 1743               IEEE 802.5 MIB using SMIv2          December 1994 
  440.  
  441.  5.  Acknowledgements 
  442.  
  443.    The changes from RFC 1231 are the result of discussions on the IETF's    snmp mailing-list and in the Interfaces MIB Working Group. 
  444.  
  445. 6.  References 
  446.  
  447.    [1] Case, J., McCloghrie, K., Rose, M., and S. Waldbusser, "Structure        of Management Information for version 2 of the Simple Network        Management Protocol (SNMPv2)", RFC 1442, SNMP Research,Inc.,        Hughes LAN Systems, Dover Beach Consulting, Inc., Carnegie Mellon        University, April 1993. 
  448.  
  449.    [2] McCloghrie, K., and M. Rose, Editors, "Management Information        Base for Network Management of TCP/IP-based internets: MIB-II",        STD 17, RFC 1213, Hughes LAN Systems, Performance Systems        International, March 1991. 
  450.  
  451.    [3] Galvin, J., and K. McCloghrie, "Administrative Model for version        2 of the Simple Network Management Protocol (SNMPv2)", RFC 1445,        Trusted Information Systems, Hughes LAN Systems, April 1993. 
  452.  
  453.    [4] Case, J., McCloghrie, K., Rose, M., and S. Waldbusser, "Protocol        Operations for version 2 of the Simple Network Management        Protocol (SNMPv2)", RFC 1448, SNMP Research,Inc., Hughes LAN        Systems, Dover Beach Consulting, Inc., Carnegie Mellon        University, April 1993. 
  454.  
  455.    [5] Case, J., McCloghrie, K., Rose, M., and S. Waldbusser, "Textual        Conventions for version 2 of the Simple Network Management        Protocol (SNMPv2)", RFC 1443, SNMP Research,Inc., Hughes LAN        Systems, Dover Beach Consulting, Inc., Carnegie Mellon        University, April 1993. 
  456.  
  457.    [6] McCloghrie, K., and F. Kastenholz, "Evolution of the Interfaces        Group of MIB-II", RFC 1573, Hughes LAN Systems, FTP Software, Jan        1994 
  458.  
  459.    [7] Institute of Electrical and Electronic Engineers, "Token Ring        Access Method and Physical Layer Specifications", IEEE Standard        802.5-1989, 1989. 
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  McCloghrie & Decker                                            [Page 23] 
  470.  RFC 1743               IEEE 802.5 MIB using SMIv2          December 1994 
  471.  
  472.  APPENDIX A - Changes from RFC 1231 
  473.  
  474.    This memo has the following differences from RFC 1231: 
  475.  
  476.    (1)  This memo is formatted using the SNMPv2 SMI. 
  477.  
  478.    (2)  The relationship of the "open" and "close" states of         dot5Commands to the value of ifAdminStatus has been         clarified.  In particular, the setting of one affects the         value of the other. 
  479.  
  480.    (3)  The relationship dot5RingSpeed and ifSpeed has been         clarified.  In particular, ifSpeed indicates the current         ring-speed; dot5RingSpeed indicates the ring-speed at the         next insertion into the ring.  If the interface doesn't         support changing ring-speed, then dot5RingSpeed can only be         set to its current value.  When dot5RingSpeed has the value         'unknown(1)', the ring-speed is to be set to the ring's         actual ring-speed. 
  481.  
  482.    (4)  Write-access to dot5ActMonParticipate is not required, and a         change to the value of dot5ActMonParticipate does not take         effect until the next Active Monitor election. 
  483.  
  484.    (5)  Write-access to dot5Functional is not required. 
  485.  
  486.    (6)  A new object, dot5LastBeaconSent has been defined to contain         the timestamp of the last beacon frame sent. 
  487.  
  488.    (7)  The dot5TimerTable has been designated as obsolete. 
  489.  
  490.    (8)  Text has been added describing the applicability of RFC 1573         [6] to 802.5 interfaces. 
  491.  
  492.    (9)  Other minor editorial changes. 
  493.  
  494. Security Considerations 
  495.  
  496.    Security issues are not discussed in this memo. 
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  McCloghrie & Decker                                            [Page 24] 
  509.  RFC 1743               IEEE 802.5 MIB using SMIv2          December 1994 
  510.  
  511.  Authors' Addresses 
  512.  
  513.    Keith McCloghrie    cisco Systems, Inc.    170 West Tasman Drive,    San Jose, CA 95134-1706 
  514.  
  515.    Phone: (408) 526-5260    EMail: kzm@cisco.com 
  516.  
  517.     Eric B. Decker    cisco Systems, Inc.    1525 O'Brien Dr.    Menlo Park, CA 94025 
  518.  
  519.    Phone: (415) 688-8241    EMail: cire@cisco.com 
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  
  551.  
  552.  
  553. McCloghrie & Decker                                            [Page 25] 
  554.  
  555.