ruzin-mstp-mib-00.txt Network Working Group Alex Rozin IEEE 802.1 Interworking Task Group MRV International Request for Comments: ???? T.B.D. Category: Internet Draft Nov 2004 Definitions of Managed Objects for Bridges with Multiple Spanning Tree Protocol Status of this Memo This document is an Internet-Draft and is subject to all provisions of Section 10 of RFC2026. Internet-Drafts are working documents of the Internet Engineering Task Force (IETF), its areas, and its working groups. Note that other groups may also distribute working documents as Internet-Drafts. Internet-Drafts are draft documents valid for a maximum of six months and may be updated, replaced, or obsoleted by other documents at any time. It is inappropriate to use Internet-Drafts as reference material or to cite them other than as "work in progress." The list of current Internet-Drafts can be accessed at http://www.ietf.org/1id-abstracts.html The list of Internet-Draft Shadow Directories can be accessed at http://www.ietf.org/shadow.html Copyright Notice Copyright (C) The Internet Society (2001). All Rights Reserved. Abstract This memo defines a portion of the Management Information Base (MIB) for use with network management protocols in TCP/IP based internets. In particular, it defines a MIB module for managing the Multiple Spanning Tree capability defined by the IEEE Std 802.1s amendment to IEEE Std 802.1D-1998 for bridging between Local Area Network (LAN) segments. <> This memo gives a MIB module for managing the MSTP protocol in a manner that is compliant to SMIv2 [RFC2578]. Table of Contents 1 The SNMP Management Framework ................................ 2 Overview ..................................................... 2.1 Scope ...................................................... 3 Structure of MSTP-MIB......................................... 4 Relation to Original Bridge MIB............................... 5 Definition for MSTP-MIB ...................................... 6 Acknowledgments .............................................. 7 Security consideration ....................................... 8 References ................................................... 9 Authors' Addresses ........................................... 10 Full Copyright .............................................. 1. The SNMP Management Framework The SNMP Management Framework presently consists of five major components: o An overall architecture, described in RFC 2571 [RFC2571]. o Mechanisms for describing and naming objects and events for the purpose of management. The first version of this Structure of Management Information (SMI) is called SMIv1 and described in STD 16, RFC 1155 [RFC1155], STD 16, RFC 1212 [RFC1212] and RFC 1215 [RFC1215]. The second version, called SMIv2, is described in STD 58, RFC 2578 [RFC2578], STD 58, RFC 2579 [RFC2579] and STD 58, RFC 2580 [RFC2580]. o Message protocols for transferring management information. The first version of the SNMP message protocol is called SNMPv1 and described in STD 15, RFC 1157 [RFC1157]. A second version of the SNMP message protocol, which is not an Internet standards track protocol, is called SNMPv2c and described in RFC 1901 [RFC1901] and RFC 1906 [RFC1906]. The third version of the message protocol is called SNMPv3 and described in RFC 1906 [RFC1906], RFC 2572 [RFC2572] and RFC 2574 [RFC2574]. o Protocol operations for accessing management information. The first set of protocol operations and associated PDU formats is described in STD 15, RFC 1157 [RFC1157]. A second set of protocol operations and associated PDU formats is described in RFC 1905 [RFC1905]. o A set of fundamental applications described in RFC 2573 [RFC2573] and the view-based access control mechanism described in RFC 2575 [RFC2575]. A more detailed introduction to the current SNMP Management Framework can be found in RFC 2570 [RFC2570]. Managed objects are accessed via a virtual information store, termed the Management Information Base or MIB. Objects in the MIB are defined using the mechanisms defined in the SMI. This memo specifies a MIB module that is compliant to the SMIv2. A MIB conforming to the SMIv1 can be produced through the appropriate translations. The resulting translated MIB must be semantically equivalent, except where objects or events are omitted because no translation is possible (use of Counter64). Some machine readable information in SMIv2 will be converted into textual descriptions in SMIv1 during the translation process. However, this loss of machine readable information is not considered to change the semantics of the MIB. 2. Overview A common device present in many networks is the Bridge. This device is used to connect Local Area Network segments below the network layer. These devices are often known as 'layer 2 switches'. There are two major modes defined for this bridging: Source-Route and transparent. Management of Source-Route bridging is not discussed in this document. MSTP is defined by IEEE Std 802.1s. MST is defined as one or more logical topologies on a common physical interface. Typically one or more VLANs are mapped to a logical topology. 2.1. Scope This MIB includes a comprehensive set of managed objects which attempts to match the set defined in IEEE Std 802.1s. 3. Structure of MSTP-MIB MSTP-MIB Name IEEE Std 802.1s Name/Purpose mstp T.B.D. 4. Relation to Original Bridge MIB The interpretation of all the existing groups in the original Bridge MIB [BRIDGEMIB] remains unchanged. In addition to the objects in the original Bridge MIB [BRIDGEMIB], this document adds mstp group with the following OID to manage the Multiple Spanning Tree Protocol: dot1dBridge XXX MSTP-MIB DEFINITIONS ::= BEGIN -- draft ! IMPORTS MODULE-IDENTITY, OBJECT-TYPE, Counter32, TimeTicks FROM SNMPv2-SMI TEXTUAL-CONVENTION, RowStatus, DisplayString, TruthValue FROM SNMPv2-TC mib-2 FROM RFC1213-MIB Timeout, BridgeId FROM BRIDGE-MIB VlanId FROM Q-BRIDGE-MIB; mstp MODULE-IDENTITY LAST-UPDATED "200107130000Z" ORGANIZATION "MRV Communications, Inc." CONTACT-INFO "Alex Rozin MRV Communication, Inc http://www.mrv.com Email: ARozin@mrv.com" DESCRIPTION "The MIB module for managing devices that support Multiple & Rapid Spanning Trees Protocol and algorithm. It is dedicated to reflect IEEE Std 802.1s" ::= { dot1dBridge XXX } -- to be selected -- -- Textual Conventions -- PortIndex ::= TEXTUAL-CONVENTION DISPLAY-HINT "d" STATUS current DESCRIPTION "A unique value, greater than zero, for each Port in the managed Bridge. The value for each PortIndex remain constant at least from one re-initialization of the entity's network management system to the next re-initialization." SYNTAX Integer32 (1..2147483647) PortIndexOrZero ::= TEXTUAL-CONVENTION DISPLAY-HINT "d" STATUS current DESCRIPTION "This textual convention is an extension of the PortIndex convention. The latter defines a greater than zero value used to identify a Port in the managed Bridge. This extension permits the additional value of zero. the value zero is object-specific and must therefore be defined as part of the description of any object which uses this syntax. Examples of the usage of zero might include situations where Port was unknown, or when none or all Ports need to be referenced." SYNTAX Integer32 (0..2147483647) MstiInstanceIndex ::= TEXTUAL-CONVENTION DISPLAY-HINT "d" STATUS current DESCRIPTION "A unique value, greater than zero, for each Multiple Spanning Tree Instance (MSTI) in the managed Bridge. The value for each MstiInstanceIndex remains constant for the instance. The " SYNTAX Integer32 (1..64) BpduCounter ::= TEXTUAL-CONVENTION DISPLAY-HINT "d" STATUS current DESCRIPTION "An optional counter of received or transmitted Bridge Protocol Data Units of different types on/from a Port. If the agent does not support these counter, it returns the value 0. These counters are reset when the protocol starts to operate and when the value of mstpPortOperMACEnable changes from false(2) to true(1)." SYNTAX Counter32 MstiOrCistInstanceIndex ::= TEXTUAL-CONVENTION DISPLAY-HINT "d" STATUS current DESCRIPTION "This textual convention is an extension of the MstiInstanceIndex convention. This extension permits the additional value of zero, which means Common and Internal Spanning Tree (CIST)." SYNTAX Integer32 (0..64) PortId ::= TEXTUAL-CONVENTION DISPLAY-HINT "d" STATUS current DESCRIPTION "The Port Identifier of the Port, the unique Port identifier comprising two parts, the Port Number and the Port Priority field (13.24.8 of IEEE Std 802.1s, 8.5.5.1 and 17.18.16 of IEEE Std 802.1D, 1998 Edition)." SYNTAX OCTET STRING (SIZE (2)) mstpGen OBJECT IDENTIFIER ::= { mstp 10 } -- mstpGen group reflects configurations/statuses -- the Bridge as a unit mstpGenBridgeMaxAge OBJECT-TYPE SYNTAX Timeout (600..4000) ACCESS read-write STATUS mandatory DESCRIPTION "12.8.1.3.a)" ::= { mstpGen 2 } mstpGenBridgeHelloTime OBJECT-TYPE SYNTAX Timeout (100..1000) ACCESS read-write STATUS mandatory DESCRIPTION "12.8.1.3.b)" ::= { mstpGen 3 } mstpGenBridgeForwardDelay OBJECT-TYPE SYNTAX Timeout (400..3000) ACCESS read-write STATUS mandatory DESCRIPTION "12.8.1.3.c)" ::= { mstpGen 4 } mstpGenMaxAge OBJECT-TYPE SYNTAX Timeout (600..4000) ACCESS read-only STATUS mandatory DESCRIPTION "12.8.1.3.a)" ::= { mstpGen 8 } mstpGenHelloTime OBJECT-TYPE SYNTAX Timeout (100..1000) ACCESS read-only STATUS mandatory DESCRIPTION "12.8.1.3.b)" ::= { mstpGen 9 } mstpGenForwardDelay OBJECT-TYPE SYNTAX Timeout (400..3000) ACCESS read-only STATUS mandatory DESCRIPTION "12.8.1.3.c)" ::= { mstpGen 10 } mstpGenMaxHops OBJECT-TYPE SYNTAX Integer32 (4..30) ACCESS read-write STATUS mandatory DESCRIPTION "13.22.f)" ::= { mstpGen 14 } mstpGenHoldTime OBJECT-TYPE SYNTAX Timeout (100..1000) ACCESS read-write STATUS mandatory DESCRIPTION "." ::= { mstpGen 15 } mstpGenMigrateTime OBJECT-TYPE SYNTAX Timeout (100..1000) ACCESS read-write STATUS mandatory DESCRIPTION "13.22.d)" ::= { mstpGen 16 } mstpGenPathCostDefault OBJECT-TYPE SYNTAX INTEGER { pathCostDefault8021d1998(1), pathCostDefault8021t2001(2) } MAX-ACCESS read-write STATUS current DESCRIPTION "(Copied from draft-ietf-bridge-rstpmib-02.txt). The version of the Spanning Tree default Path Costs that are to be used by this Bridge. A value of pathCostDefault8021d1998(1) uses the 16-bit default Path Costs from IEEE Std. 802.1D-1998. A value of pathCostDefault8021t2001(2) uses the 32-bit default Path Costs from IEEE Std. 802.1t." REFERENCE "IEEE Std 802.1D & 802.1t Table 8-5" ::= { mstpGen 18 } mstpGenCapable OBJECT-TYPE SYNTAX INTEGER { nonStp(0), dot1d1998(1), dot1w(2), dot1d2004(3), dot1s(4), dot1q(5), unknown(6) } ACCESS read-only STATUS current DESCRIPTION "An indication of whether the Bridge supports 'maximum' level Spanning Tree Protocol. The value nonStp(0) indicates, the Bridge doesn't support any Spanning Tree Protocol. The value 'dot1d1998(1)' indicates the Spanning Tree Protocol specified in EEE 802.1D-1998, 'dot1w(2)' indicates the Rapid Spanning Tree Protocol specified in IEEE Std 802.1w, 'dot1d2004' indicates IEEE Std 802.1D-2004 and 'dot1s(4) means MSTP IEEE Std 802.1s." ::= { mstpGen 19 } mstpGenForceVersion OBJECT-TYPE SYNTAX INTEGER { forceNonStp(0), forceLegacyDot1d(1), forceDot1w(2), autoDot1s(3), unknown(4) } ACCESS read-write STATUS mandatory DESCRIPTION "The value forceNonStp(0) indicates, the Spanning Tree Protocol is disabled on the Bridge (or the Spanning Tree Protocol Emulation operates). Other possible values are described in IEEE Std 802.1s clause 12.8.1.3.e)" DEFVAL { autoDot1s } ::= { mstpGen 20 } mstpGenCfgName OBJECT-TYPE SYNTAX DisplayString (SIZE (32)) ACCESS read-write STATUS mandatory DESCRIPTION "The configuration name that identifies the MST region and is used as one of the inputs in the computation of the MST Configuration Identifier." REFERENCE "12.12.3.4.2.b)" ::= { mstpGen 21 } mstpGenRevLevel OBJECT-TYPE SYNTAX Integer32 ACCESS read-write STATUS mandatory DESCRIPTION "This object identifies the MST revision that identifies the MST region and is used as one of the inputs in the computation of the MST configuration Identifier." REFERENCE "12.12.3.4.2.c)" ::= { mstpGen 22 } mstpGenReginalRoot OBJECT-TYPE SYNTAX BridgeId ACCESS read-only STATUS mandatory DESCRIPTION "... of CIST." ::= { mstpGen 26 } mstpGenExternalRootCost OBJECT-TYPE SYNTAX Integer32 ACCESS read-only STATUS mandatory DESCRIPTION "... of CIST." ::= { mstpGen 27 } mstpPortTable OBJECT-TYPE SYNTAX SEQUENCE OF Dot1sPortEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "A table that contains generic information about every port that is associated with this bridge." ::= { mstp 11 } mstpPortEntry OBJECT-TYPE SYNTAX Dot1sPortEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "A list of information for each port of the bridge." INDEX { mstpPortIndex } ::= { mstpPortTable 1 } Dot1sPortEntry ::= SEQUENCE { mstpPortIndex PortIndex, mstpPortAdminMACEnable TruthValue, mstpPortOperMACEnable TruthValue, mstpPortUpTime TimeTicks, mstpPortAdminExternalPathCost Integer32, mstpPortOperExternalPathCost Integer32, mstpPortAdminEdge TruthValue, mstpPortOperEdge TruthValue, mstpPortAutoEdge TruthValue, mstpPortAdminPointToPoint INTEGER, mstpPortOperPointToPoint TruthValue, mstpPortHelloTime Timeout, mstpPortAdminNonStp TruthValue, mstpPortProtocolMigration TruthValue, -- mcheck mstpPortRxTcnBpduCounter BpduCounter, mstpPortRxCfgBpduCounter BpduCounter, mstpPortRxRstBpduCounter BpduCounter, mstpPortTxMstBpduCounter BpduCounter, mstpPortTxTcnBpduCounter BpduCounter, mstpPortTxCfgBpduCounter BpduCounter, mstpPortTxRstBpduCounter BpduCounter, mstpPortTxMstBpduCounter BpduCounter } mstpPortIndex OBJECT-TYPE SYNTAX PortIndex MAX-ACCESS read-only STATUS current DESCRIPTION "A unique value, greater than zero, for each Port. The value for each interface sub-layer must remain constant at least from one re-initialization of the entity's network management system to the next re- initialization." ::= { mstpPortEntry 1 } mstpPortAdminMACEnable OBJECT-TYPE SYNTAX TruthValue MAX-ACCESS read-write STATUS current DESCRIPTION "." REFERENCE "IEEE Std 802.1s Clause 12.8.2.5.2" ::= { mstpPortEntry 2 } mstpPortOperMACEnable OBJECT-TYPE SYNTAX TruthValue MAX-ACCESS read-only STATUS current DESCRIPTION "." REFERENCE "IEEE Std 802.1s Clause 12.8.2.5.2" ::= { mstpPortEntry 3 } mstpPortUpTime OBJECT-TYPE SYNTAX TimeTicks MAX-ACCESS read-only STATUS current DESCRIPTION "The value of sysUpTime at the time when the Port has been enabled by mstpPortAdminMACEnable or linked last time." ::= { mstpPortEntry 4 } mstpPortAdminExternalPathCost OBJECT-TYPE SYNTAX Integer32 (0..200000000) MAX-ACCESS read-write STATUS mandatory DESCRIPTION "The administrative value of the External Port Cost parameter. The value 0 means, that Port Cost will be selected automatically in correspondence with the speed of the attached LAN." REFERENCE "IEEE Std 802.1s Clause " ::= { mstpPortEntry 5 } mstpPortOperExternalPathCost OBJECT-TYPE SYNTAX Integer32 MAX-ACCESS read-only STATUS mandatory DESCRIPTION "." REFERENCE "IEEE Std 802.1s Clause " ::= { mstpPortEntry 6 } mstpPortAdminEdge OBJECT-TYPE SYNTAX TruthValue MAX-ACCESS read-write STATUS current DESCRIPTION "." REFERENCE "IEEE Std 802.1s Clause " ::= { mstpPortEntry 7 } mstpPortOperEdge OBJECT-TYPE SYNTAX TruthValue MAX-ACCESS read-only STATUS mandatory DESCRIPTION "." REFERENCE "IEEE Std 802.1s Clause " ::= { mstpPortEntry 8 } mstpPortAutoEdge OBJECT-TYPE SYNTAX TruthValue MAX-ACCESS read-write STATUS current DESCRIPTION "(From IEEE Std 8021D). Optional." REFERENCE "IEEE Std 802.1s Clause " ::= { mstpPortEntry 9 } mstpPortAdminPointToPoint OBJECT-TYPE SYNTAX INTEGER { forceTrue(0), forceFalse(1), auto(2) } MAX-ACCESS read-write STATUS mandatory DESCRIPTION "." REFERENCE "IEEE Std 802.1s Clause " ::= { mstpPortEntry 10 } mstpPortOperPointToPoint OBJECT-TYPE SYNTAX TruthValue MAX-ACCESS read-only STATUS mandatory DESCRIPTION "." REFERENCE "IEEE Std 802.1s Clause " ::= { mstpPortEntry 11 } mstpPortHelloTime OBJECT-TYPE SYNTAX Timeout (100..1000) MAX-ACCESS read-write STATUS current DESCRIPTION "." REFERENCE "IEEE Std 802.1s Clause " ::= { mstpPortEntry 12 } mstpPortAdminNonStp OBJECT-TYPE SYNTAX TruthValue MAX-ACCESS read-write STATUS current DESCRIPTION "Ports with this object set to true(1) do not participate in any STP computation; they are always in Forwarding state, do not send BPDU and all received on these Ports BPDU must be discarded. Such Ports are used to define the STP termination point of the LAN." REFERENCE "." ::= { mstpPortEntry 13 } mstpPortProtocolMigration OBJECT-TYPE SYNTAX TruthValue MAX-ACCESS read-write STATUS current DESCRIPTION "Reflects 'mcheck' - 'Force BPDU Migration Check' management operation, which is executes, when this object is being set to true(1). The value false(2) in SET operation has to be ignored. The operation GET must always return value false(2)." REFERENCE "IEEE Std 802.1s Clause 12.8.2.7" ::= { mstpPortEntry 14 } mstpPortRxTcnBpduCounter OBJECT-TYPE SYNTAX BpduCounter MAX-ACCESS read-only STATUS current DESCRIPTION "Received Topology Change Notification (TCN) Messages." ::= { mstpPortEntry 15 } mstpPortRxCfgBpduCounter OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Received Configuration BPDUs (IEEE Std 802.1d-1998)." ::= { mstpPortEntry 16 } mstpPortRxRstBpduCounter OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Received RST BPDUs IEEE Std 802.1w-2001." ::= { mstpPortEntry 17 } mstpPortTxMstBpduCounter OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Received MST BPDUs IEEE Std 802.1s." ::= { mstpPortEntry 18 } mstpPortTxTcnBpduCounter OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Transmitted Topology Change Notification (TCN) Messages." ::= { mstpPortEntry 19 } mstpPortTxCfgBpduCounter OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Transmitted Configuration BPDUs (IEEE Std 802.1d-1998)." ::= { mstpPortEntry 20 } mstpPortTxRstBpduCounter OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Transmitted RST BPDUs IEEE Std 802.1w-2001." ::= { mstpPortEntry 21 } mstpPortTxMstBpduCounter OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Transmitted MST BPDUs IEEE Std 802.1s." ::= { mstpPortEntry 22 } mstpMapTable OBJECT-TYPE SYNTAX SEQUENCE OF Dot1sMapEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "MST Configuration table (VID=>MSTID translation): allocates each and every possible VLAN to CST or a specific MSTI." ::= { mstp 12 } mstpMapEntry OBJECT-TYPE SYNTAX Dot1sMapEntry MAX-ACCESS not-accessible STATUS mandatory DESCRIPTION "MST Configuration table (VID=>MSTID translation): allocates each and every possible VLAN to CST or a specific MSTI." INDEX { mstpMapMSTiID, mstpMapVlanRangeIndex } ::= { mstpMapTable 1 } Dot1sMapEntry ::= SEQUENCE { mstpMapMSTiID MstiInstanceIndex, mstpMapVlanRangeIndex Integer32, mstpMapVlanMin VlanId, mstpMapVlanMax VlanId, mstpMapRowStatus RowStatus } mstpMapMSTiID OBJECT-TYPE SYNTAX MstiInstanceIndex MAX-ACCESS not-accessible STATUS mandatory DESCRIPTION "." ::= { mstpMapEntry 1 } mstpMapVlanRangeIndex OBJECT-TYPE SYNTAX Integer32 (1..4094) MAX-ACCESS not-accessible STATUS mandatory DESCRIPTION "Signifies the index to the VLAN range entry in the table." ::= { mstpMapEntry 2 } mstpMapVlanMin OBJECT-TYPE SYNTAX VlanId MAX-ACCESS read-create STATUS mandatory DESCRIPTION "." ::= { mstpMapEntry 3 } mstpMapVlanMax OBJECT-TYPE SYNTAX VlanId MAX-ACCESS read-create STATUS mandatory DESCRIPTION "." ::= { mstpMapEntry 4 } mstpMapRowStatus OBJECT-TYPE SYNTAX RowStatus MAX-ACCESS read-create STATUS current DESCRIPTION "The status of the row as per SNMP-v2." ::= { mstpMapEntry 9 } mstpXstTable OBJECT-TYPE SYNTAX SEQUENCE OF Dot1sXstEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "." ::= { mstp 13 } mstpXstEntry OBJECT-TYPE SYNTAX Dot1sXstEntry MAX-ACCESS not-accessible STATUS mandatory DESCRIPTION "." INDEX { mstpXstId } ::= { mstpXstTable 1 } Dot1sXstEntry ::= SEQUENCE { mstpXstId MstiOrCistInstanceIndex, mstpXstBridgePriority Integer32, mstpXstBridgeId BridgeId, mstpXstDesignatedRoot BridgeId, mstpXstDesignatedBridge BridgeId, mstpXstInternalRootCost Integer32, mstpXstRootPort PortIndexOrZero, mstpXstMasterPort PortIndexOrZero, mstpXstTimeSinceTopologyChange TimeTicks, mstpXstTopologyChangesCount Counter32, mstpXstTopologyChangeFlag TruthValue } mstpXstId OBJECT-TYPE SYNTAX MstiOrCistInstanceIndex MAX-ACCESS not-accessible STATUS mandatory DESCRIPTION "0 means CIST." ::= { mstpXstEntry 1 } mstpXstBridgePriority OBJECT-TYPE SYNTAX Integer32 (0..61440) MAX-ACCESS read-write STATUS mandatory DESCRIPTION "Bridge priority, in steps of 4096." DEFVAL { 32768 } := { mstpXstEntry 2 } mstpXstBridgeId OBJECT-TYPE SYNTAX BridgeId MAX-ACCESS read-only STATUS mandatory DESCRIPTION "." ::= { mstpXstEntry 3 } mstpXstDesignatedRoot OBJECT-TYPE SYNTAX BridgeId MAX-ACCESS read-only STATUS mandatory DESCRIPTION "." ::= { mstpXstEntry 4 } mstpXstDesignatedBridge OBJECT-TYPE SYNTAX BridgeId MAX-ACCESS read-only STATUS mandatory DESCRIPTION "." ::= { mstpXstEntry 5 } mstpXstInternalRootCost OBJECT-TYPE SYNTAX Integer32 MAX-ACCESS read-only STATUS mandatory DESCRIPTION "." ::= { mstpXstEntry 6 } mstpXstRootPort OBJECT-TYPE SYNTAX PortIndexOrZero MAX-ACCESS read-only STATUS mandatory DESCRIPTION "." ::= { mstpXstEntry 7 } mstpXstMasterPort OBJECT-TYPE SYNTAX PortIndexOrZero MAX-ACCESS read-only STATUS mandatory DESCRIPTION "Non zero value may not be in CIST." ::= { mstpXstEntry 8 } mstpXstTimeSinceTopologyChange OBJECT-TYPE SYNTAX TimeTicks MAX-ACCESS read-only STATUS current DESCRIPTION "." ::= { mstpXstEntry 11 } mstpXstTopologyChangesCount OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "." ::= { mstpXstEntry 12 } mstpXstTopologyChangeFlag OBJECT-TYPE SYNTAX TruthValue MAX-ACCESS read-only STATUS current DESCRIPTION "." ::= { mstpXstEntry 13 } mstpXstPortTable OBJECT-TYPE SYNTAX SEQUENCE OF Dot1sXstPortEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "." ::= { mstp 14 } mstpXstPortEntry OBJECT-TYPE SYNTAX Dot1sXstPortEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "." REFERENCE "." INDEX { mstpXstPortXstId, mstpXstPortIndex } ::= { mstpXstPortTable 1 } Dot1sXstPortEntry ::= SEQUENCE { mstpXstPortXstId MstiOrCistInstanceIndex, mstpXstPortIndex PortIndex, mstpXstPortState INTEGER, mstpXstPortRole INTEGER, mstpXstPortDesignatedRoot BridgeId, mstpXstPortExternalRootCost Integer32, mstpXstPortRegionalBridge BridgeId, mstpXstPortInternalRootCost Integer32, mstpXstPortDesignatedBridge BridgeId, mstpXstPortDesignatedPort PortId, mstpXstPortPriority Integer32, mstpXstPortAdminInternalPathCost Integer32, mstpXstPortOperInternalPathCost Integer32 } mstpXstPortXstId OBJECT-TYPE SYNTAX MstiOrCistInstanceIndex MAX-ACCESS not-accessible STATUS mandatory DESCRIPTION "0 means CIST." ::= { mstpXstPortEntry 1 } mstpXstPortIndex OBJECT-TYPE SYNTAX PortIndex MAX-ACCESS read-only STATUS current DESCRIPTION "The value of mstpPortIndex of the Port in mstpPortTable." ::= { mstpXstPortEntry 2 } mstpXstPortState OBJECT-TYPE SYNTAX INTEGER { disabled(1), discarding(1), learning(2), forwarding(3), unknown(4) } MAX-ACCESS read-only STATUS current DESCRIPTION "." ::= { mstpXstPortEntry 3 } mstpXstPortRole OBJECT-TYPE SYNTAX INTEGER { disabled(1), alternate(2), backup(3), root(4), designated(5), master(6), nonStp(7), unknown(8) } MAX-ACCESS read-only STATUS current DESCRIPTION "." ::= { mstpXstPortEntry 4 } mstpXstPortDesignatedRoot OBJECT-TYPE SYNTAX BridgeId MAX-ACCESS read-only STATUS current DESCRIPTION "." ::= { mstpXstPortEntry 6 } mstpXstPortExternalRootCost OBJECT-TYPE SYNTAX Integer32 MAX-ACCESS read-only STATUS current DESCRIPTION "." ::= { mstpXstPortEntry 7 } mstpXstPortRegionalBridge OBJECT-TYPE SYNTAX BridgeId MAX-ACCESS read-only STATUS current DESCRIPTION "." ::= { mstpXstPortEntry 8 } mstpXstPortInternalRootCost OBJECT-TYPE SYNTAX Integer32 MAX-ACCESS read-only STATUS current DESCRIPTION "." ::= { mstpXstPortEntry 9 } mstpXstPortDesignatedBridge OBJECT-TYPE SYNTAX BridgeId MAX-ACCESS read-only STATUS current DESCRIPTION "." ::= { mstpXstPortEntry 10 } mstpXstPortDesignatedPort OBJECT-TYPE SYNTAX PortId MAX-ACCESS read-only STATUS current DESCRIPTION "." ::= { mstpXstPortEntry 14 } mstpXstPortPriority OBJECT-TYPE SYNTAX Integer32 (0..255) MAX-ACCESS read-write STATUS current DESCRIPTION "Port priority, in steps of 16." DEFVAL { 128 } ::= { mstpXstPortEntry 15 } mstpXstPortAdminInternalPathCost OBJECT-TYPE SYNTAX Integer32 (0..200000000) MAX-ACCESS read-write STATUS current DESCRIPTION "The value 0 means, that the cost will be selected automatically." ::= { mstpXstPortEntry 16 } mstpXstPortOperInternalPathCost OBJECT-TYPE SYNTAX Integer32 MAX-ACCESS read-only STATUS current DESCRIPTION "." ::= { mstpXstPortEntry 17 } -- Traps mstpTraps OBJECT IDENTIFIER ::= { mstp 0 } dos1sNewRootBridge NOTIFICATION-TYPE OBJECTS { mstpXstId } STATUS current DESCRIPTION "The dos1sNewRootBridge trap indicates that the sending agent has become the new root of the Spanning Tree in the CIST or in any MSTI; the trap is sent by a bridge soon after its election as the new root, e.g., upon expiration of the Topology Change Timer immediately subsequent to its election. Implementation of this trap is optional." ::= { mstpTraps 1 } dos1sNewRootPort NOTIFICATION-TYPE OBJECTS { mstpXstId, mstpXstPortIndex } STATUS current DESCRIPTION "The dos1sNewRootPort trap indicates that the sending agent has changed the root Port of the Spanning Tree in the CIST or in any MSTI. If the instance has become a root one, the sending value of the parameter mstpXstPortIndex is equal to zero. The trap is sent by a bridge soon after its election as the new root Port, e.g., upon expiration of the Topology Change Timer immediately subsequent to its election. Implementation of this trap is optional." ::= { mstpTraps 2 } dos1sTopologyChange NOTIFICATION-TYPE OBJECTS { mstpXstId, mstpXstPortIndex, mstpXstPortState } STATUS current DESCRIPTION "A dos1sTopologyChange trap is sent by a bridge when any of its configured ports n any instance (CIST or MSTI) transitions from the Learning state to the Forwarding state, or from the Forwarding state to the Blocking state. The trap is not sent if a dos1sNewRootBridge trap is sent for the same transition. Implementation of this trap is optional." ::= { mstpTraps 3 } END 5. Acknowledgments This document was produced on behalf of the Bridge MIB Working Group in the Operations and Management area of the Internet Engineering Task Force. 6. Security Considerations Security Issues are not discussed in this memo. 7. References [RFC2571] Harrington, D., Presuhn, R., and B. Wijnen, An Architecture for Describing SNMP Management Frameworks, RFC 2571, April 1999. [RFC2578] McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, J., Rose, M., and S. Waldbusser, Structure of Management Information Version 2 (SMIv2), STD 58, RFC 2578, April 1999. [RFC2579] McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, J., Rose, M., and S. Waldbusser, Textual Conventions for SMIv2, STD 58, RFC 2579, April 1999. [RFC1905] Case, J., McCloghrie, K., Rose, M., and S. Waldbusser, Protocol Operations for Version 2 of the Simple Network Management Protocol (SNMPv2), RFC 1905, January 1996. [RFC1493] Decker, E., Langille, P., Rijsinghani, A. and K. McCloghrie, "Definitions of Managed Objects for Bridges", RFC 1493, July 1993. [RFC2674] Bell, E., Smith, A., Langille, P., Rijhsinghani, A., McCloghrie, A., "Definitions of Managed Objects for Bridges with Traffic Classes, Multicast Filtering and Virtual LAN Extensions", RFC 2674, August 1999. [802.1d] IEEE Std 802.1d-1998, "IEEE Standard for Information technology Telecommunications and information exchange between systems Local and metropolitan area networks - Common Specifications Part 3: Media Access Control (MAC) Bridges". [802.1w] IEEE Std 802.1w-2001, "(Amendment to IEEE Standard 802.1D) IEEE Standard for Information technology - Telecommunications and information exchange between systems - Local and metropolitan area networks--Common Specifications - Part 3: Media Access Control (MAC) Bridges: Rapid Reconfiguation". [802.1s] IEEE Std 802.1s-2002, "(Amendment to IEEE Standard 802.1Q) IEEE Standard for Local and metropolitan area networks-Virtual Bridged Local Area Networks-Amendment 3: Multiple Spanning Trees. 8. Authors' Addresses T.B.D. 9. Full Copyright Copyright (C) The Internet Society (date). All Rights Reserved. This document and translations of it may be copied and furnished to others, and derivative works that comment on or otherwise explain it or assist in its implementation may be prepared, copied, published and distributed, in whole or in part, without restriction of any kind, provided that the above copyright notice and this paragraph are included on all such copies and derivative works. However, this document itself may not be modified in any way, such as by removing the copyright notice or references to the Internet Society or other Internet organizations, except as needed for the purpose of developing Internet standards in which case the procedures for copyrights defined in the Internet Standards process must be followed, or as required to translate it into languages other than English. The limited permissions granted above are perpetual and will not be revoked by the Internet Society or its successors or assigns. This document and the information contained herein is provided on an "AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.