1--
2-- Copyright (C) The Internet Society (2005).
3--
4-- This document is subject to the rights, licenses and restrictions
5-- contained in BCP 78, and except as set forth therein, the authors
6-- retain all their rights.
7--
8-- This document and the information contained herein are provided on an
9-- "AS IS" basis and THE CONTRIBUTOR, THE ORGANIZATION HE/SHE REPRESENTS
10-- OR IS SPONSORED BY (IF ANY), THE INTERNET SOCIETY AND THE INTERNET
11-- ENGINEERING TASK FORCE DISCLAIM ALL WARRANTIES, EXPRESS OR IMPLIED,
12-- INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE
13-- INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED
14-- WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
15--
16
17RSTP-MIB DEFINITIONS ::= BEGIN
18
19-- -------------------------------------------------------------
20-- MIB for IEEE 802.1w Rapid Spanning Tree Protocol
21-- -------------------------------------------------------------
22
23IMPORTS
24    MODULE-IDENTITY, OBJECT-TYPE, Integer32, mib-2
25        FROM SNMPv2-SMI
26    TruthValue
27        FROM SNMPv2-TC
28    MODULE-COMPLIANCE, OBJECT-GROUP
29        FROM SNMPv2-CONF
30    dot1dStp, dot1dStpPortEntry
31        FROM BRIDGE-MIB;
32
33rstpMIB MODULE-IDENTITY
34    LAST-UPDATED "200512070000Z"
35    ORGANIZATION "IETF Bridge MIB Working Group"
36    CONTACT-INFO
37        "Email: Bridge-mib@ietf.org"
38    DESCRIPTION
39        "The Bridge MIB Extension module for managing devices
40         that support the Rapid Spanning Tree Protocol defined
41         by IEEE 802.1w.
42
43         Copyright (C) The Internet Society (2005).  This version of
44         this MIB module is part of RFC 4318; See the RFC itself for
45         full legal notices."
46
47    REVISION     "200512070000Z"
48    DESCRIPTION
49         "The initial version of this MIB module as published in
50          RFC 4318."
51    ::= { mib-2 134 }
52
53-- ---------------------------------------------------------- --
54-- subtrees in the RSTP-MIB
55-- ---------------------------------------------------------- --
56
57rstpNotifications OBJECT IDENTIFIER ::= { rstpMIB 0 }
58rstpObjects       OBJECT IDENTIFIER ::= { rstpMIB 1 }
59rstpConformance   OBJECT IDENTIFIER ::= { rstpMIB 2 }
60
61-- -------------------------------------------------------------
62-- Addition to the dot1dStp group
63-- -------------------------------------------------------------
64
65dot1dStpVersion OBJECT-TYPE
66    SYNTAX      INTEGER {
67                    stpCompatible(0),
68                    rstp(2)
69                }
70    MAX-ACCESS  read-write
71    STATUS      current
72    DESCRIPTION
73        "The version of Spanning Tree Protocol the bridge is
74         currently running.  The value 'stpCompatible(0)'
75         indicates the Spanning Tree Protocol specified in
76         IEEE 802.1D-1998 and 'rstp(2)' indicates the Rapid
77         Spanning Tree Protocol specified in IEEE 802.1w and
78         clause 17 of 802.1D-2004.  The values are directly from
79         the IEEE standard.  New values may be defined as future
80         versions of the protocol become available.
81
82         The value of this object MUST be retained across
83         reinitializations of the management system."
84    REFERENCE
85        "IEEE 802.1w clause 14.8.1, 17.12, 17.16.1"
86    DEFVAL      { rstp }
87    ::= { dot1dStp 16 }
88
89dot1dStpTxHoldCount OBJECT-TYPE
90    SYNTAX      Integer32 (1..10)
91    MAX-ACCESS  read-write
92    STATUS      current
93    DESCRIPTION
94        "The value used by the Port Transmit state machine to limit
95         the maximum transmission rate.
96
97         The value of this object MUST be retained across
98         reinitializations of the management system."
99
100    REFERENCE
101        "IEEE 802.1w clause 17.16.6"
102    DEFVAL      { 3 }
103    ::= { dot1dStp 17 }
104
105--
106-- { dot1dStp 18 } was used to represent dot1dStpPathCostDefault
107-- in an earlier version of this MIB.  It has since been
108-- obsoleted, and should not be used.
109--
110
111dot1dStpExtPortTable OBJECT-TYPE
112    SYNTAX      SEQUENCE OF Dot1dStpExtPortEntry
113    MAX-ACCESS  not-accessible
114    STATUS      current
115    DESCRIPTION
116        "A table that contains port-specific Rapid Spanning Tree
117         information."
118    ::= { dot1dStp 19 }
119
120dot1dStpExtPortEntry OBJECT-TYPE
121    SYNTAX      Dot1dStpExtPortEntry
122    MAX-ACCESS  not-accessible
123    STATUS      current
124    DESCRIPTION
125        "A list of Rapid Spanning Tree information maintained by
126         each port."
127    AUGMENTS    { dot1dStpPortEntry }
128    ::= { dot1dStpExtPortTable 1 }
129
130Dot1dStpExtPortEntry ::=
131    SEQUENCE {
132        dot1dStpPortProtocolMigration
133            TruthValue,
134        dot1dStpPortAdminEdgePort
135            TruthValue,
136        dot1dStpPortOperEdgePort
137            TruthValue,
138        dot1dStpPortAdminPointToPoint
139            INTEGER,
140        dot1dStpPortOperPointToPoint
141            TruthValue,
142        dot1dStpPortAdminPathCost
143            Integer32
144    }
145
146dot1dStpPortProtocolMigration OBJECT-TYPE
147    SYNTAX      TruthValue
148    MAX-ACCESS  read-write
149    STATUS      current
150    DESCRIPTION
151        "When operating in RSTP (version 2) mode, writing true(1)
152         to this object forces this port to transmit RSTP BPDUs.
153         Any other operation on this object has no effect and
154         it always returns false(2) when read."
155    REFERENCE
156        "IEEE 802.1w clause 14.8.2.4, 17.18.10, 17.26"
157    ::= { dot1dStpExtPortEntry 1 }
158
159dot1dStpPortAdminEdgePort OBJECT-TYPE
160    SYNTAX      TruthValue
161    MAX-ACCESS  read-write
162    STATUS      current
163    DESCRIPTION
164        "The administrative value of the Edge Port parameter.  A
165         value of true(1) indicates that this port should be
166         assumed as an edge-port, and a value of false(2) indicates
167         that this port should be assumed as a non-edge-port.
168         Setting this object will also cause the corresponding
169         instance of dot1dStpPortOperEdgePort to change to the
170         same value.  Note that even when this object's value
171         is true, the value of the corresponding instance of
172         dot1dStpPortOperEdgePort can be false if a BPDU has
173         been received.
174
175         The value of this object MUST be retained across
176         reinitializations of the management system."
177
178    REFERENCE
179        "IEEE 802.1t clause 14.8.2, 18.3.3"
180    ::= { dot1dStpExtPortEntry 2 }
181
182dot1dStpPortOperEdgePort OBJECT-TYPE
183    SYNTAX      TruthValue
184    MAX-ACCESS  read-only
185    STATUS      current
186    DESCRIPTION
187        "The operational value of the Edge Port parameter.  The
188         object is initialized to the value of the corresponding
189         instance of dot1dStpPortAdminEdgePort.  When the
190         corresponding instance of dot1dStpPortAdminEdgePort is
191         set, this object will be changed as well.  This object
192         will also be changed to false on reception of a BPDU."
193
194    REFERENCE
195        "IEEE 802.1t clause 14.8.2, 18.3.4"
196    ::= { dot1dStpExtPortEntry 3 }
197
198dot1dStpPortAdminPointToPoint OBJECT-TYPE
199    SYNTAX      INTEGER {
200                    forceTrue(0),
201                    forceFalse(1),
202                    auto(2)
203                }
204    MAX-ACCESS  read-write
205    STATUS      current
206    DESCRIPTION
207        "The administrative point-to-point status of the LAN segment
208         attached to this port, using the enumeration values of the
209         IEEE 802.1w clause.  A value of forceTrue(0) indicates
210         that this port should always be treated as if it is
211         connected to a point-to-point link.  A value of
212         forceFalse(1) indicates that this port should be treated as
213         having a shared media connection.  A value of auto(2)
214         indicates that this port is considered to have a
215         point-to-point link if it is an Aggregator and all of its
216         members are aggregatable, or if the MAC entity
217         is configured for full duplex operation, either through
218         auto-negotiation or by management means.  Manipulating this
219         object changes the underlying adminPortToPortMAC.
220
221         The value of this object MUST be retained across
222         reinitializations of the management system."
223
224   REFERENCE
225       "IEEE 802.1w clause 6.4.3, 6.5, 14.8.2"
226   ::= { dot1dStpExtPortEntry 4 }
227
228dot1dStpPortOperPointToPoint OBJECT-TYPE
229    SYNTAX      TruthValue
230    MAX-ACCESS  read-only
231    STATUS      current
232    DESCRIPTION
233        "The operational point-to-point status of the LAN segment
234         attached to this port.  It indicates whether a port is
235         considered to have a point-to-point connection.
236         If adminPointToPointMAC is set to auto(2), then the value
237         of operPointToPointMAC is determined in accordance with the
238         specific procedures defined for the MAC entity concerned,
239         as defined in IEEE 802.1w, clause 6.5.  The value is
240         determined dynamically; that is, it is re-evaluated whenever
241         the value of adminPointToPointMAC changes, and whenever
242         the specific procedures defined for the MAC entity evaluate
243         a change in its point-to-point status."
244    REFERENCE
245        "IEEE 802.1w clause 6.4.3, 6.5, 14.8.2"
246    ::= { dot1dStpExtPortEntry 5 }
247
248dot1dStpPortAdminPathCost OBJECT-TYPE
249    SYNTAX      Integer32 (0..200000000)
250    MAX-ACCESS  read-write
251    STATUS      current
252    DESCRIPTION
253        "The administratively assigned value for the contribution
254         of this port to the path cost of paths toward the spanning
255         tree root.
256
257         Writing a value of '0' assigns the automatically calculated
258         default Path Cost value to the port.  If the default Path
259         Cost is being used, this object returns '0' when read.
260
261         This complements the object dot1dStpPortPathCost or
262         dot1dStpPortPathCost32, which returns the operational value
263         of the path cost.
264
265         The value of this object MUST be retained across
266         reinitializations of the management system."
267    REFERENCE
268        "IEEE 802.1D-1998: Section 8.5.5.3"
269    ::= { dot1dStpExtPortEntry 6 }
270
271-- -------------------------------------------------------------
272-- rstpMIB - Conformance Information
273-- -------------------------------------------------------------
274
275rstpGroups OBJECT IDENTIFIER ::= { rstpConformance 1 }
276
277rstpCompliances OBJECT IDENTIFIER ::= { rstpConformance 2 }
278
279-- -------------------------------------------------------------
280-- Units of conformance
281-- -------------------------------------------------------------
282
283rstpBridgeGroup OBJECT-GROUP
284    OBJECTS {
285        dot1dStpVersion,
286        dot1dStpTxHoldCount
287    }
288    STATUS      current
289    DESCRIPTION
290        "Rapid Spanning Tree information for the bridge."
291    ::= { rstpGroups 1 }
292
293rstpPortGroup OBJECT-GROUP
294    OBJECTS {
295        dot1dStpPortProtocolMigration,
296        dot1dStpPortAdminEdgePort,
297        dot1dStpPortOperEdgePort,
298        dot1dStpPortAdminPointToPoint,
299        dot1dStpPortOperPointToPoint,
300        dot1dStpPortAdminPathCost
301    }
302    STATUS      current
303    DESCRIPTION
304        "Rapid Spanning Tree information for individual ports."
305    ::= { rstpGroups 2 }
306
307-- -------------------------------------------------------------
308-- Compliance statements
309-- -------------------------------------------------------------
310
311rstpCompliance MODULE-COMPLIANCE
312    STATUS      current
313    DESCRIPTION
314        "The compliance statement for device support of Rapid
315         Spanning Tree Protocol (RSTP) bridging services."
316    MODULE
317        MANDATORY-GROUPS {
318            rstpBridgeGroup,
319            rstpPortGroup
320        }
321    ::= { rstpCompliances 1 }
322
323END
324