IEEE8021-SPANNING-TREE-MIB
- Registered at
- 1.3.111.2.802.1.1.3
- Last updated
- 2022-11-08 00:00
- Organization
- IEEE 802.1 Working Group
- Revisions
- 2022-11-08 00:00, 2018-07-01 00:00, 2014-12-15 00:00, 2011-03-24 00:00, 2008-10-15 00:00
- Namespace
- standard
- Source file
IEEE8021-SPANNING-TREE-MIB- Digest
sha256:f0114c4f5caad980a8a0a9d68558a1d05ea09a4b49fdc4fe054b92003d9e9ef0
Description
The Spanning-Tree MIB module for managing devices that support IEEE 802.1Q. Unless otherwise indicated, the references in this MIB module are to IEEE Std 802.1Q-2022. Copyright (C) IEEE (2022). This version of this MIB module is part of IEEE Std 802.1Q; see that standard for full legal notices.
Contact
WG-URL: http://www.ieee802.org/1/ WG-EMail: stds-802-1-l@ieee.org Contact: IEEE 802.1 Working Group Chair Postal: C/O IEEE 802.1 Working Group IEEE Standards Association 445 Hoes Lane Piscataway, NJ 08854 USA E-mail: stds-802-1-chairs@ieee.org
Imports
| From | Symbols |
|---|---|
| BRIDGE-MIB | BridgeId, Timeout |
| IEEE8021-TC-MIB | IEEE8021BridgePortNumber, IEEE8021PbbComponentIdentifier, ieee802dot1mibs |
| SNMPv2-CONF | MODULE-COMPLIANCE, NOTIFICATION-GROUP, OBJECT-GROUP |
| SNMPv2-SMI | Counter64, Integer32, MODULE-IDENTITY, NOTIFICATION-TYPE, OBJECT-IDENTITY, OBJECT-TYPE, TimeTicks, iso |
| SNMPv2-TC | DisplayString, TEXTUAL-CONVENTION, TruthValue |
Imported by
Nothing in this corpus imports this module.
Load order
Every file a consumer needs in order to load this module, dependencies first.
BRIDGE-MIB IANAifType-MIB IEEE8021-SPANNING-TREE-MIB IEEE8021-TC-MIB IF-MIB SNMPv2-CONF SNMPv2-MIB SNMPv2-SMI SNMPv2-TC
Objects
| Name | OID | Syntax | Access | Status |
|---|---|---|---|---|
| ieee8021SpanningTreeNotifications OBJECT-IDENTITY | 1.3.111.2.802.1.1.3.0 | |||
| ieee8021SpanningTreeObjects OBJECT-IDENTITY | 1.3.111.2.802.1.1.3.1 | |||
| ieee8021SpanningTreeTable OBJECT-TYPE A table that contains information related to STP about every Bridge. | 1.3.111.2.802.1.1.3.1.1 | not-accessible | current | |
| ieee8021SpanningTreeEntry OBJECT-TYPE A list of objects containing information for each Bridge about the Spanning Tree Protocol for that Bridge. | 1.3.111.2.802.1.1.3.1.1.1 | not-accessible | current | |
| ieee8021SpanningTreeComponentId OBJECT-TYPE The component identifier is used to distinguish between the multiple virtual Bridge instances within a PBB. In simple situations where there is only a single component the default value is 1. | 1.3.111.2.802.1.1.3.1.1.1.1 | IEEE8021PbbComponentIdentifier | not-accessible | current |
| ieee8021SpanningTreeProtocolSpecification OBJECT-TYPE An indication of what version of the Spanning Tree Protocol is being run. The value 'decLb100(2)' indicates the DEC LANbridge 100 Spanning Tree protocol. IEEE 802.1D implementations will return 'ieee8021d(3)'. New enumerated values may be added in the future to the definition of this object to reflect future versions of the IEEE Spanning Tree protocol. | 1.3.111.2.802.1.1.3.1.1.1.2 | INTEGER {unknown(1), decLb100(2), ieee8021d(3), ieee8021q(4)} | read-only | current |
| ieee8021SpanningTreePriority OBJECT-TYPE The value of the write-able portion of the Bridge ID (i.e., the first two octets of the (8 octet long) Bridge ID). The other (last) 6 octets of the Bridge ID are given by the value of ieee8021BridgeBaseBridgeAddress. On Bridges supporting IEEE 802.1t or IEEE 802.1w, permissible values are 0-61440, in steps of 4096. The value of this object MUST be retained across reinitializations of the management system. | 1.3.111.2.802.1.1.3.1.1.1.3 | Integer32 (0..65535) | read-write | current |
| ieee8021SpanningTreeTimeSinceTopologyChange OBJECT-TYPE The time (in hundredths of a second) since the last time a topology change was detected by the Bridge entity. For RSTP, this reports the time since the tcWhile timer for any port on this Bridge was nonzero. | 1.3.111.2.802.1.1.3.1.1.1.4 | TimeTicks | read-only | current |
| ieee8021SpanningTreeTopChanges OBJECT-TYPE The total number of topology changes detected by this Bridge since the management entity was last reset or initialized. Discontinuities in the value of the counter can occur at re-initialization of the management system. | 1.3.111.2.802.1.1.3.1.1.1.5 | Counter64 | read-only | current |
| ieee8021SpanningTreeDesignatedRoot OBJECT-TYPE The Bridge identifier of the root of the spanning tree, as determined by the Spanning Tree Protocol, as executed by this node. This value is used as the Root Identifier parameter in all Configuration Bridge PDUs originated by this node. | 1.3.111.2.802.1.1.3.1.1.1.6 | BridgeId | read-only | current |
| ieee8021SpanningTreeRootCost OBJECT-TYPE The cost of the path to the root as seen from this Bridge. | 1.3.111.2.802.1.1.3.1.1.1.7 | Integer32 | read-only | current |
| ieee8021SpanningTreeRootPort OBJECT-TYPE The port number of the port that offers the lowest cost path from this Bridge to the root Bridge. | 1.3.111.2.802.1.1.3.1.1.1.8 | IEEE8021BridgePortNumber | read-only | current |
| ieee8021SpanningTreeMaxAge OBJECT-TYPE The maximum age of Spanning Tree Protocol information learned from the network on any port before it is discarded, in units of hundredths of a second. This is the actual value that this Bridge is currently using. | 1.3.111.2.802.1.1.3.1.1.1.9 | Timeout | read-only | current |
| ieee8021SpanningTreeHelloTime OBJECT-TYPE The amount of time between the transmission of Configuration Bridge PDUs by this node on any port when it is the root of the spanning tree, or trying to become so, in units of hundredths of a second. This is the actual value that this Bridge is currently using. | 1.3.111.2.802.1.1.3.1.1.1.10 | Timeout | read-only | current |
| ieee8021SpanningTreeHoldTime OBJECT-TYPE This time value determines the interval length during which no more than two Configuration Bridge PDUs shall be transmitted by this node, in units of hundredths of a second. | 1.3.111.2.802.1.1.3.1.1.1.11 | Integer32 | read-only | current |
| ieee8021SpanningTreeForwardDelay OBJECT-TYPE This time value, measured in units of hundredths of a second, controls how fast a port changes its spanning state when moving towards the Forwarding state. The value determines how long the port stays in each of the Listening and Learning states, which precede the Forwarding state. This value is also used when a topology change has been detected and is underway, to age all dynamic entries in the Filtering Database. [Note that this value is the one that this Bridge is currently using, in contrast to ieee8021SpanningTreeBridgeForwardDelay, which is the value that this Bridge and all others would start using if/when this Bridge were to become the root.] | 1.3.111.2.802.1.1.3.1.1.1.12 | Timeout | read-only | current |
| ieee8021SpanningTreeBridgeMaxAge OBJECT-TYPE The value that all Bridges use for MaxAge when this Bridge is acting as the root. Note that IEEE Std 802.1D-1998 specifies that the range for this parameter is related to the value of ieee8021SpanningTreeBridgeHelloTime. The granularity of this timer is specified by IEEE Std 802.1D-1998 to be 1 second. An agent may return an SNMP badValue error (or its equivalent if another protocol is used) if a set is attempted to a value that is not a whole number of seconds. The value of this object MUST be retained across reinitializations of the management system. | 1.3.111.2.802.1.1.3.1.1.1.13 | Timeout (600..4000) | read-write | current |
| ieee8021SpanningTreeBridgeHelloTime OBJECT-TYPE The value that all Bridges use for HelloTime when this Bridge is acting as the root. The granularity of this timer is specified by IEEE Std 802.1D-1998 to be 1 second. An agent may return an SNMP badValue error (or its equivalent if another protocol is used) if a set is attempted to a value that is not a whole number of seconds. The value of this object MUST be retained across reinitializations of the management system. | 1.3.111.2.802.1.1.3.1.1.1.14 | Timeout (100..1000) | read-write | current |
| ieee8021SpanningTreeBridgeForwardDelay OBJECT-TYPE The value that all Bridges use for ForwardDelay when this Bridge is acting as the root. Note that IEEE Std 802.1D-1998 specifies that the range for this parameter is related to the value of ieee8021SpanningTreeBridgeMaxAge. The granularity of this timer is specified by IEEE Std 802.1D-1998 to be 1 second. An agent may return an SNMP badValue error (or its equivalent if another protocol is used) if a set is attempted to a value that is not a whole number of seconds. The value of this object MUST be retained across reinitializations of the management system. | 1.3.111.2.802.1.1.3.1.1.1.15 | Timeout (400..3000) | read-write | current |
| ieee8021SpanningTreeVersion OBJECT-TYPE The version of Spanning Tree Protocol the Bridge is currently running. The values are directly from the IEEE standard. New values may be defined as future versions of the protocol become available. The value 'stp(0)' indicates the Bridge is running the Spanning Tree Protocol specified in IEEE Std 802.1D-1998. The value 'rstp(2)' indicates the Bridge is running RSTP specified in IEEE 802.1Q. The value 'mstp(3)' indicates the Bridge is running MSTP specified in Clause 13 of IEEE Std 802.1Q. The value of this object MUST be retained across reinitializations of the management system. | 1.3.111.2.802.1.1.3.1.1.1.16 | INTEGER {stp(0), rstp(2), mstp(3)} | read-write | current |
| ieee8021SpanningTreeRstpTxHoldCount OBJECT-TYPE The value used by the Port Transmit state machine to limit the maximum transmission rate. This is used by Bridges that are running RSTP. The value of this object MUST be retained across reinitializations of the management system. | 1.3.111.2.802.1.1.3.1.1.1.17 | Integer32 (1..10) | read-write | current |
| ieee8021SpanningTreePortTable OBJECT-TYPE A table that contains port-specific information for the Spanning Tree Protocol. | 1.3.111.2.802.1.1.3.1.2 | not-accessible | current | |
| ieee8021SpanningTreePortEntry OBJECT-TYPE A list of objects containing information maintained by every port about the Spanning Tree Protocol state for that port. | 1.3.111.2.802.1.1.3.1.2.1 | not-accessible | current | |
| ieee8021SpanningTreePortComponentId OBJECT-TYPE The component identifier is used to distinguish between the multiple virtual Bridge instances within a PBB. In simple situations where there is only a single component the default value is 1. | 1.3.111.2.802.1.1.3.1.2.1.1 | IEEE8021PbbComponentIdentifier | not-accessible | current |
| ieee8021SpanningTreePort OBJECT-TYPE The port number of the port for which this entry contains Spanning Tree Protocol management information. | 1.3.111.2.802.1.1.3.1.2.1.2 | IEEE8021BridgePortNumber | not-accessible | current |
| ieee8021SpanningTreePortPriority OBJECT-TYPE The value of the priority field that is contained in the first (in network byte order) octet of the (2 octet long) Port ID. The other octet of the Port ID is given by the value of ieee8021SpanningTreePort. On Bridges supporting IEEE 802.1t or IEEE 802.1w, permissible values are 0-240, in steps of 16. The value of this object MUST be retained across reinitializations of the management system. | 1.3.111.2.802.1.1.3.1.2.1.3 | Integer32 (0..255) | read-write | current |
| ieee8021SpanningTreePortState OBJECT-TYPE The port's current state, as defined by application of the Spanning Tree Protocol. This state controls what action a port takes on reception of a frame. If the Bridge has detected a port that is malfunctioning, it will place that port into the broken(6) state. For ports that are disabled (see ieee8021SpanningTreePortEnabled), this object will have a value of disabled(1). The values disabled, blocking, listening, and broken correspond to the Clause 12 port state of 'Discarding'. The value learning corresponds to the Clause 12 port state of 'Learning'. The value forwarding corresponds to the Clause 12 port state of 'Forwarding'. | 1.3.111.2.802.1.1.3.1.2.1.4 | INTEGER {disabled(1), blocking(2), listening(3), learning(4), forwarding(5), broken(6)} | read-only | current |
| ieee8021SpanningTreePortEnabled OBJECT-TYPE The enabled/disabled status of the port. A value of true(1) means the spanning-tree protocol is enabled for this port. The value of this object MUST be retained across reinitializations of the management system. | 1.3.111.2.802.1.1.3.1.2.1.5 | TruthValue | read-write | current |
| ieee8021SpanningTreePortPathCost OBJECT-TYPE The contribution of this port to the path cost of paths towards the spanning tree root that include this port. Table 13-4 recommends defaults and ranges for Port Path Cost values, in inverse proportion to the speed of the attached LAN. If this object is used to set the Path Cost it is possible to restore the default setting using the ieee8021SpanningTreeRstpPortAdminPathCost object. Table 13-4 recommends defaults and ranges for Port Path Cost values, in inverse proportion to the speed of the attached LAN. If this object is used to set the Path Cost it is possible to restore the default setting using the ieee8021MstpPortAdminPathCost object. The value of this object MUST be retained across reinitializations of the management system. | 1.3.111.2.802.1.1.3.1.2.1.6 | Integer32 (1..200000000) | read-write | current |
| ieee8021SpanningTreePortDesignatedRoot OBJECT-TYPE The unique Bridge Identifier of the Bridge recorded as the Root in the Configuration BPDUs transmitted by the Designated Bridge for the segment to which the port is attached. | 1.3.111.2.802.1.1.3.1.2.1.7 | BridgeId | read-only | current |
| ieee8021SpanningTreePortDesignatedCost OBJECT-TYPE The path cost of the Designated Port of the segment connected to this port. This value is compared to the Root Path Cost field in received Bridge PDUs. | 1.3.111.2.802.1.1.3.1.2.1.8 | Integer32 | read-only | current |
| ieee8021SpanningTreePortDesignatedBridge OBJECT-TYPE The Bridge Identifier of the Bridge that this port considers to be the Designated Bridge for this port's segment. | 1.3.111.2.802.1.1.3.1.2.1.9 | BridgeId | read-only | current |
| ieee8021SpanningTreePortDesignatedPort OBJECT-TYPE The Port Identifier of the port on the Designated Bridge for this port's segment. | 1.3.111.2.802.1.1.3.1.2.1.10 | OCTET STRING (SIZE(2)) | read-only | current |
| ieee8021SpanningTreePortForwardTransitions OBJECT-TYPE The number of times this port has transitioned from the Learning state to the Forwarding state. Discontinuities in the value of the counter can occur at re-initialization of the management system, and at other times as indicated by the value of ifCounterDiscontinuityTime object of the associated interface (if any). | 1.3.111.2.802.1.1.3.1.2.1.11 | Counter64 | read-only | current |
| ieee8021SpanningTreeRstpPortProtocolMigration OBJECT-TYPE When operating in RSTP (version 2) mode, writing true(1) to this object forces this port to transmit RSTP BPDUs. Any other operation on this object has no effect and it always returns false(2) when read. | 1.3.111.2.802.1.1.3.1.2.1.12 | TruthValue | read-write | current |
| ieee8021SpanningTreeRstpPortAdminEdgePort OBJECT-TYPE The administrative value of the Edge Port parameter. A value of true(1) indicates that this port should be assumed as an edge-port, and a value of false(2) indicates that this port should be assumed as a non-edge-port. Setting this object will also cause the corresponding instance of ieee8021SpanningTreeRstpPortOperEdgePort to change to the same value. Note that even when this object's value is true(1), the value of the corresponding instance of ieee8021SpanningTreeRstpPortOperEdgePort can be false(2) if a BPDU has been received. The value of this object MUST be retained across reinitializations of the management system. | 1.3.111.2.802.1.1.3.1.2.1.13 | TruthValue | read-write | current |
| ieee8021SpanningTreeRstpPortOperEdgePort OBJECT-TYPE The operational value of the Edge Port parameter. The object is initialized to the value of the corresponding instance of ieee8021SpanningTreeRstpPortAdminEdgePort. When the corresponding instance of ieee8021SpanningTreeRstpPortAdminEdgePort is set, this object will be changed as well. This object will also be changed to false(2) on reception of a BPDU. | 1.3.111.2.802.1.1.3.1.2.1.14 | TruthValue | read-only | current |
| ieee8021SpanningTreeRstpPortAdminPathCost OBJECT-TYPE The administratively assigned value for the contribution of this port to the path cost of paths toward the spanning tree root. Writing a value of '0' assigns the automatically calculated default Path Cost value to the port. If the default Path Cost is being used, this object returns '0' when read. This complements the object ieee8021SpanningTreePortPathCost, which returns the operational value of the path cost. The value of this object MUST be retained across reinitializations of the management system. | 1.3.111.2.802.1.1.3.1.2.1.15 | Integer32 (0..200000000) | read-write | current |
| ieee8021SpanningTreePortExtensionTable OBJECT-TYPE A table that contains port-specific information for the Spanning Tree Protocol. | 1.3.111.2.802.1.1.3.1.3 | not-accessible | current | |
| ieee8021SpanningTreePortExtensionEntry OBJECT-TYPE A list of additional objects containing information maintained by every port about the Spanning Tree Protocol state for that port. | 1.3.111.2.802.1.1.3.1.3.1 | not-accessible | current | |
| ieee8021SpanningTreeRstpPortAutoEdgePort OBJECT-TYPE The administrative value of the Auto Edge Port parameter. A value of true(1) indicates if the Bridge detection state machine (BDM, 13.33) is to detect other Bridges attached to the LAN, and set ieee8021SpanningTreeRstpPortOperEdgePort automatically. The default value is true(1) This is optional and provided only by implementations that support the automatic identification of edge ports. The value of this object MUST be retained across reinitializations of the management system. | 1.3.111.2.802.1.1.3.1.3.1.1 | TruthValue | read-write | current |
| ieee8021SpanningTreeRstpPortAutoIsolatePort OBJECT-TYPE The operational value of the Isolate Port parameter. A value of true(1) indicates a Designated Port will transition to discarding if both ieee8021SpanningTreeRstpPortAdminEdgePort and ieee8021SpanningTreeRstpPortAutoEdgePort are FALSE and the other Bridge presumed to be attached to the same point-to-point LAN does not transmit periodic BPDUs. This is optional and provided only by implementations that support the automatic identification of edge ports. | 1.3.111.2.802.1.1.3.1.3.1.2 | TruthValue | read-only | current |
| ieee8021SpanningTreeRstpPortIsolatePort OBJECT-TYPE The operational value of the Isolate Port parameter. A value of true(1), Set by the Bridge detection state machine (BDM, 13.33), indicates when the Spanning Tree Protocol Entity of a neighboring Bridge has apparently failed . | 1.3.111.2.802.1.1.3.1.3.1.3 | TruthValue | read-only | current |
| ieee8021SpanningTreeConformance OBJECT-IDENTITY | 1.3.111.2.802.1.1.3.2 | |||
| ieee8021SpanningTreeCompliances OBJECT-IDENTITY | 1.3.111.2.802.1.1.3.2.1 | |||
| ieee8021SpanningTreeGroups OBJECT-IDENTITY | 1.3.111.2.802.1.1.3.2.2 |
Notifications
| Name | OID | Status |
|---|---|---|
| ieee8021SpanningTreeNewRoot NOTIFICATION-TYPE The ieee8021SpanningTreeNewRoot notification indicates that the sending agent has become the new root of the Spanning Tree; the notification 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. | 1.3.111.2.802.1.1.3.0.1 | current |
| ieee8021SpanningTreeTopologyChange NOTIFICATION-TYPE A ieee8021SpanningTreeTopologyChange notification is sent by a Bridge when any of its configured ports transitions from the Learning state to the Forwarding state, or from the Forwarding state to the Blocking state. The notification is not sent if a ieee8021SpanningTreeNewRoot notification is sent for the same transition. | 1.3.111.2.802.1.1.3.0.2 | current |
Conformance
| Name | OID | Status |
|---|---|---|
| ieee8021SpanningTreeCompliance MODULE-COMPLIANCE The compliance statement for devices supporting the Spanning Tree Protocol. | 1.3.111.2.802.1.1.3.2.1.1 | current |
| ieee8021SpanningTreeRstpCompliance MODULE-COMPLIANCE The compliance statement for devices supporting RSTP. | 1.3.111.2.802.1.1.3.2.1.2 | current |
| ieee8021SpanningTreeGroup OBJECT-GROUP Bridge level Spanning Tree data for this device. | 1.3.111.2.802.1.1.3.2.2.1 | current |
| ieee8021SpanningTreeRstpGroup OBJECT-GROUP Bridge level Rstp data for this device. | 1.3.111.2.802.1.1.3.2.2.2 | current |
| ieee8021SpanningTreePortGroup OBJECT-GROUP Spanning Tree data for each port on this device. | 1.3.111.2.802.1.1.3.2.2.3 | current |
| ieee8021SpanningTreeRstpPortGroup OBJECT-GROUP Rstp data for each port on this device. | 1.3.111.2.802.1.1.3.2.2.4 | current |
| ieee8021SpanningTreeNotificationGroup NOTIFICATION-GROUP Group of notifications. | 1.3.111.2.802.1.1.3.2.2.5 | current |
| ieee8021SpanningTreeRstpFragileGroup OBJECT-GROUP Rstp fragile Bridge data for each port on this device. | 1.3.111.2.802.1.1.3.2.2.6 | current |