1295016Sjkim--
2238405Sjkim-- Copyright (C) The Internet Society (2005).
3238405Sjkim--
4238405Sjkim-- This document is subject to the rights, licenses and restrictions
5238405Sjkim-- contained in BCP 78, and except as set forth therein, the authors
6238405Sjkim-- retain all their rights.
7238405Sjkim--
8238405Sjkim-- This document and the information contained herein are provided on an
9238405Sjkim-- "AS IS" basis and THE CONTRIBUTOR, THE ORGANIZATION HE/SHE REPRESENTS
10238405Sjkim-- OR IS SPONSORED BY (IF ANY), THE INTERNET SOCIETY AND THE INTERNET
11238405Sjkim-- ENGINEERING TASK FORCE DISCLAIM ALL WARRANTIES, EXPRESS OR IMPLIED,
12238405Sjkim-- INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE
13238405Sjkim-- INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED
14238405Sjkim-- WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
15238405Sjkim--
16238405Sjkim-- $FreeBSD: releng/11.0/usr.sbin/bsnmpd/modules/snmp_bridge/BRIDGE-MIB.txt 164410 2006-11-19 15:42:48Z syrinx $
17238405Sjkim--
18238405Sjkim
19238405SjkimBRIDGE-MIB DEFINITIONS ::= BEGIN
20238405Sjkim
21238405Sjkim-- ---------------------------------------------------------- --
22238405Sjkim-- MIB for IEEE 802.1D devices
23238405Sjkim-- ---------------------------------------------------------- --
24238405SjkimIMPORTS
25238405Sjkim    MODULE-IDENTITY, OBJECT-TYPE, NOTIFICATION-TYPE,
26238405Sjkim    Counter32, Integer32, TimeTicks, mib-2
27238405Sjkim        FROM SNMPv2-SMI
28238405Sjkim    TEXTUAL-CONVENTION, MacAddress
29238405Sjkim        FROM SNMPv2-TC
30238405Sjkim    MODULE-COMPLIANCE, OBJECT-GROUP, NOTIFICATION-GROUP
31238405Sjkim        FROM SNMPv2-CONF
32238405Sjkim    InterfaceIndex FROM IF-MIB
33238405Sjkim    ;
34238405Sjkim
35238405Sjkimdot1dBridge MODULE-IDENTITY
36238405Sjkim    LAST-UPDATED "200509190000Z"
37238405Sjkim    ORGANIZATION "IETF Bridge MIB Working Group"
38238405Sjkim    CONTACT-INFO
39238405Sjkim        "Email: bridge-mib@ietf.org
40238405Sjkim
41276864Sjkim                 K.C. Norseth (Editor)
42276864Sjkim                 L-3 Communications
43238405Sjkim            Tel: +1 801-594-2809
44238405Sjkim          Email: kenyon.c.norseth@L-3com.com
45238405Sjkim         Postal: 640 N. 2200 West.
46238405Sjkim                 Salt Lake City, Utah 84116-0850
47238405Sjkim                 Les Bell (Editor)
48238405Sjkim                 3Com Europe Limited
49238405Sjkim          Phone: +44 1442 438025
50238405Sjkim          Email: elbell@ntlworld.com
51238405Sjkim         Postal: 3Com Centre, Boundary Way
52238405Sjkim                 Hemel Hempstead
53276864Sjkim                 Herts.  HP2 7YU
54276864Sjkim                 UK
55276864Sjkim
56238405Sjkim         Send comments to <bridge-mib@ietf.org>"
57276864Sjkim    DESCRIPTION
58276864Sjkim        "The Bridge MIB module for managing devices that support
59276864Sjkim        IEEE 802.1D.
60276864Sjkim
61276864Sjkim        Copyright (C) The Internet Society (2005).  This version of
62276864Sjkim        this MIB module is part of RFC 4188; see the RFC itself for
63238405Sjkim        full legal notices."
64276864Sjkim    REVISION     "200509190000Z"
65276864Sjkim    DESCRIPTION
66276864Sjkim         "Third revision, published as part of RFC 4188.
67276864Sjkim
68276864Sjkim         The MIB module has been converted to SMIv2 format.
69238405Sjkim         Conformance statements have been added and some
70276864Sjkim         description and reference clauses have been updated.
71238405Sjkim
72238405Sjkim         The object dot1dStpPortPathCost32 was added to
73238405Sjkim         support IEEE 802.1t and the permissible values of
74238405Sjkim         dot1dStpPriority and dot1dStpPortPriority have been
75238405Sjkim         clarified for bridges supporting IEEE 802.1t or
76238405Sjkim         IEEE 802.1w.
77238405Sjkim
78238405Sjkim         The interpretation of dot1dStpTimeSinceTopologyChange
79238405Sjkim         has been clarified for bridges supporting the Rapid
80238405Sjkim         Spanning Tree Protocol (RSTP)."
81238405Sjkim    REVISION     "199307310000Z"
82238405Sjkim    DESCRIPTION
83238405Sjkim         "Second revision, published as part of RFC 1493."
84238405Sjkim    REVISION     "199112310000Z"
85238405Sjkim    DESCRIPTION
86238405Sjkim         "Initial revision, published as part of RFC 1286."
87238405Sjkim    ::= { mib-2 17 }
88238405Sjkim
89238405Sjkim
90238405Sjkim-- ---------------------------------------------------------- --
91238405Sjkim-- Textual Conventions
92238405Sjkim-- ---------------------------------------------------------- --
93238405Sjkim
94238405SjkimBridgeId ::= TEXTUAL-CONVENTION
95238405Sjkim    STATUS      current
96238405Sjkim    DESCRIPTION
97238405Sjkim        "The Bridge-Identifier, as used in the Spanning Tree
98238405Sjkim        Protocol, to uniquely identify a bridge.  Its first two
99238405Sjkim        octets (in network byte order) contain a priority value,
100238405Sjkim        and its last 6 octets contain the MAC address used to
101238405Sjkim        refer to a bridge in a unique fashion (typically, the
102238405Sjkim        numerically smallest MAC address of all ports on the
103238405Sjkim        bridge)."
104238405Sjkim    SYNTAX      OCTET STRING (SIZE (8))
105238405Sjkim
106238405SjkimTimeout ::= TEXTUAL-CONVENTION
107238405Sjkim    DISPLAY-HINT "d"
108238405Sjkim    STATUS      current
109238405Sjkim    DESCRIPTION
110238405Sjkim        "A Spanning Tree Protocol (STP) timer in units of 1/100
111238405Sjkim        seconds.  Several objects in this MIB module represent
112238405Sjkim        values of timers used by the Spanning Tree Protocol.
113238405Sjkim        In this MIB, these timers have values in units of
114238405Sjkim        hundredths of a second (i.e., 1/100 secs).
115238405Sjkim
116238405Sjkim        These timers, when stored in a Spanning Tree Protocol's
117238405Sjkim        BPDU, are in units of 1/256 seconds.  Note, however, that
118238405Sjkim        802.1D-1998 specifies a settable granularity of no more
119238405Sjkim        than one second for these timers.  To avoid ambiguity,
120238405Sjkim        a conversion algorithm is defined below for converting
121238405Sjkim        between the different units, which ensures a timer's
122238405Sjkim        value is not distorted by multiple conversions.
123238405Sjkim
124238405Sjkim        To convert a Timeout value into a value in units of
125238405Sjkim        1/256 seconds, the following algorithm should be used:
126238405Sjkim
127238405Sjkim            b = floor( (n * 256) / 100)
128238405Sjkim
129238405Sjkim        where:
130238405Sjkim            floor   =  quotient [ignore remainder]
131238405Sjkim            n is the value in 1/100 second units
132238405Sjkim            b is the value in 1/256 second units
133238405Sjkim
134238405Sjkim        To convert the value from 1/256 second units back to
135238405Sjkim        1/100 seconds, the following algorithm should be used:
136296317Sdelphij
137238405Sjkim            n = ceiling( (b * 100) / 256)
138238405Sjkim
139238405Sjkim        where:
140238405Sjkim            ceiling = quotient [if remainder is 0], or
141238405Sjkim                      quotient + 1 [if remainder is nonzero]
142238405Sjkim            n is the value in 1/100 second units
143238405Sjkim            b is the value in 1/256 second units
144238405Sjkim
145238405Sjkim        Note: it is important that the arithmetic operations are
146238405Sjkim        done in the order specified (i.e., multiply first,
147238405Sjkim        divide second)."
148238405Sjkim    SYNTAX      Integer32
149238405Sjkim
150238405Sjkim-- ---------------------------------------------------------- --
151238405Sjkim-- subtrees in the Bridge MIB
152238405Sjkim-- ---------------------------------------------------------- --
153238405Sjkim
154238405Sjkimdot1dNotifications  OBJECT IDENTIFIER ::= { dot1dBridge 0 }
155238405Sjkim
156238405Sjkimdot1dBase           OBJECT IDENTIFIER ::= { dot1dBridge 1 }
157238405Sjkimdot1dStp            OBJECT IDENTIFIER ::= { dot1dBridge 2 }
158238405Sjkim
159238405Sjkimdot1dSr             OBJECT IDENTIFIER ::= { dot1dBridge 3 }
160238405Sjkim-- documented in RFC 1525
161238405Sjkim
162238405Sjkimdot1dTp             OBJECT IDENTIFIER ::= { dot1dBridge 4 }
163238405Sjkimdot1dStatic         OBJECT IDENTIFIER ::= { dot1dBridge 5 }
164238405Sjkim
165238405Sjkim-- Subtrees used by Bridge MIB Extensions:
166238405Sjkim--      pBridgeMIB  MODULE-IDENTITY   ::= { dot1dBridge 6 }
167238405Sjkim--      qBridgeMIB  MODULE-IDENTITY   ::= { dot1dBridge 7 }
168238405Sjkim-- Note that the practice of registering related MIB modules
169238405Sjkim-- below dot1dBridge has been discouraged since there is no
170238405Sjkim-- robust mechanism to track such registrations.
171238405Sjkim
172238405Sjkimdot1dConformance    OBJECT IDENTIFIER ::= { dot1dBridge 8 }
173238405Sjkim
174238405Sjkim-- ---------------------------------------------------------- --
175238405Sjkim-- the dot1dBase subtree
176238405Sjkim-- ---------------------------------------------------------- --
177238405Sjkim-- Implementation of the dot1dBase subtree is mandatory for all
178238405Sjkim-- bridges.
179238405Sjkim-- ---------------------------------------------------------- --
180238405Sjkim
181238405Sjkimdot1dBaseBridgeAddress OBJECT-TYPE
182238405Sjkim
183238405Sjkim    SYNTAX      MacAddress
184238405Sjkim    MAX-ACCESS  read-only
185238405Sjkim    STATUS      current
186238405Sjkim    DESCRIPTION
187238405Sjkim        "The MAC address used by this bridge when it must be
188238405Sjkim        referred to in a unique fashion.  It is recommended
189276864Sjkim        that this be the numerically smallest MAC address of
190238405Sjkim        all ports that belong to this bridge.  However, it is only
191238405Sjkim        required to be unique.  When concatenated with
192238405Sjkim        dot1dStpPriority, a unique BridgeIdentifier is formed,
193238405Sjkim        which is used in the Spanning Tree Protocol."
194238405Sjkim    REFERENCE
195276864Sjkim        "IEEE 802.1D-1998: clauses 14.4.1.1.3 and 7.12.5"
196238405Sjkim    ::= { dot1dBase 1 }
197238405Sjkim
198238405Sjkimdot1dBaseNumPorts OBJECT-TYPE
199238405Sjkim    SYNTAX      Integer32
200238405Sjkim    UNITS       "ports"
201238405Sjkim    MAX-ACCESS  read-only
202238405Sjkim    STATUS      current
203238405Sjkim    DESCRIPTION
204276864Sjkim        "The number of ports controlled by this bridging
205238405Sjkim        entity."
206238405Sjkim    REFERENCE
207238405Sjkim        "IEEE 802.1D-1998: clause 14.4.1.1.3"
208238405Sjkim    ::= { dot1dBase 2 }
209238405Sjkim
210238405Sjkimdot1dBaseType OBJECT-TYPE
211238405Sjkim    SYNTAX      INTEGER {
212238405Sjkim                    unknown(1),
213238405Sjkim                    transparent-only(2),
214276864Sjkim                    sourceroute-only(3),
215238405Sjkim                    srt(4)
216238405Sjkim                }
217238405Sjkim    MAX-ACCESS  read-only
218238405Sjkim    STATUS      current
219238405Sjkim    DESCRIPTION
220238405Sjkim        "Indicates what type of bridging this bridge can
221238405Sjkim        perform.  If a bridge is actually performing a
222238405Sjkim        certain type of bridging, this will be indicated by
223238405Sjkim        entries in the port table for the given type."
224238405Sjkim    ::= { dot1dBase 3 }
225238405Sjkim
226238405Sjkim-- ---------------------------------------------------------- --
227238405Sjkim-- The Generic Bridge Port Table
228238405Sjkim-- ---------------------------------------------------------- --
229238405Sjkimdot1dBasePortTable OBJECT-TYPE
230238405Sjkim    SYNTAX      SEQUENCE OF Dot1dBasePortEntry
231238405Sjkim    MAX-ACCESS  not-accessible
232238405Sjkim    STATUS      current
233238405Sjkim    DESCRIPTION
234238405Sjkim        "A table that contains generic information about every
235238405Sjkim        port that is associated with this bridge.  Transparent,
236238405Sjkim        source-route, and srt ports are included."
237238405Sjkim    ::= { dot1dBase 4 }
238238405Sjkim
239238405Sjkimdot1dBasePortEntry OBJECT-TYPE
240238405Sjkim    SYNTAX      Dot1dBasePortEntry
241238405Sjkim    MAX-ACCESS  not-accessible
242238405Sjkim    STATUS      current
243238405Sjkim
244238405Sjkim    DESCRIPTION
245238405Sjkim        "A list of information for each port of the bridge."
246238405Sjkim    REFERENCE
247238405Sjkim        "IEEE 802.1D-1998: clause 14.4.2, 14.6.1"
248276864Sjkim    INDEX  { dot1dBasePort }
249238405Sjkim    ::= { dot1dBasePortTable 1 }
250238405Sjkim
251238405SjkimDot1dBasePortEntry ::=
252238405Sjkim    SEQUENCE {
253238405Sjkim        dot1dBasePort
254238405Sjkim            Integer32,
255238405Sjkim        dot1dBasePortIfIndex
256238405Sjkim            InterfaceIndex,
257238405Sjkim        dot1dBasePortCircuit
258238405Sjkim            OBJECT IDENTIFIER,
259238405Sjkim        dot1dBasePortDelayExceededDiscards
260238405Sjkim            Counter32,
261238405Sjkim        dot1dBasePortMtuExceededDiscards
262238405Sjkim            Counter32
263238405Sjkim    }
264238405Sjkim
265238405Sjkimdot1dBasePort OBJECT-TYPE
266238405Sjkim    SYNTAX      Integer32 (1..65535)
267238405Sjkim    MAX-ACCESS  read-only
268238405Sjkim    STATUS      current
269238405Sjkim    DESCRIPTION
270238405Sjkim        "The port number of the port for which this entry
271238405Sjkim        contains bridge management information."
272238405Sjkim    ::= { dot1dBasePortEntry 1 }
273238405Sjkim
274238405Sjkimdot1dBasePortIfIndex OBJECT-TYPE
275238405Sjkim    SYNTAX      InterfaceIndex
276238405Sjkim    MAX-ACCESS  read-only
277238405Sjkim    STATUS      current
278238405Sjkim    DESCRIPTION
279276864Sjkim        "The value of the instance of the ifIndex object,
280238405Sjkim        defined in IF-MIB, for the interface corresponding
281238405Sjkim        to this port."
282238405Sjkim    ::= { dot1dBasePortEntry 2 }
283238405Sjkim
284238405Sjkimdot1dBasePortCircuit OBJECT-TYPE
285238405Sjkim    SYNTAX      OBJECT IDENTIFIER
286238405Sjkim    MAX-ACCESS  read-only
287238405Sjkim    STATUS      current
288238405Sjkim    DESCRIPTION
289238405Sjkim        "For a port that (potentially) has the same value of
290238405Sjkim        dot1dBasePortIfIndex as another port on the same bridge.
291238405Sjkim        This object contains the name of an object instance
292276864Sjkim        unique to this port.  For example, in the case where
293276864Sjkim        multiple ports correspond one-to-one with multiple X.25
294238405Sjkim        virtual circuits, this value might identify an (e.g.,
295238405Sjkim        the first) object instance associated with the X.25
296238405Sjkim        virtual circuit corresponding to this port.
297238405Sjkim
298276864Sjkim        For a port which has a unique value of
299238405Sjkim        dot1dBasePortIfIndex, this object can have the value
300238405Sjkim        { 0 0 }."
301238405Sjkim    ::= { dot1dBasePortEntry 3 }
302238405Sjkim
303238405Sjkimdot1dBasePortDelayExceededDiscards OBJECT-TYPE
304276864Sjkim    SYNTAX      Counter32
305276864Sjkim    MAX-ACCESS  read-only
306238405Sjkim    STATUS      current
307238405Sjkim    DESCRIPTION
308238405Sjkim        "The number of frames discarded by this port due
309238405Sjkim        to excessive transit delay through the bridge.  It
310238405Sjkim        is incremented by both transparent and source
311238405Sjkim        route bridges."
312238405Sjkim    REFERENCE
313238405Sjkim        "IEEE 802.1D-1998: clause 14.6.1.1.3"
314238405Sjkim    ::= { dot1dBasePortEntry 4 }
315238405Sjkim
316238405Sjkimdot1dBasePortMtuExceededDiscards OBJECT-TYPE
317238405Sjkim    SYNTAX      Counter32
318238405Sjkim    MAX-ACCESS  read-only
319238405Sjkim    STATUS      current
320238405Sjkim    DESCRIPTION
321238405Sjkim        "The number of frames discarded by this port due
322238405Sjkim        to an excessive size.  It is incremented by both
323238405Sjkim        transparent and source route bridges."
324238405Sjkim    REFERENCE
325238405Sjkim        "IEEE 802.1D-1998: clause 14.6.1.1.3"
326238405Sjkim    ::= { dot1dBasePortEntry 5 }
327238405Sjkim
328238405Sjkim-- ---------------------------------------------------------- --
329238405Sjkim-- the dot1dStp subtree
330238405Sjkim-- ---------------------------------------------------------- --
331238405Sjkim-- Implementation of the dot1dStp subtree is optional.  It is
332238405Sjkim-- implemented by those bridges that support the Spanning Tree
333238405Sjkim-- Protocol.
334238405Sjkim-- ---------------------------------------------------------- --
335238405Sjkimdot1dStpProtocolSpecification OBJECT-TYPE
336238405Sjkim    SYNTAX      INTEGER {
337238405Sjkim                    unknown(1),
338238405Sjkim                    decLb100(2),
339238405Sjkim                    ieee8021d(3)
340238405Sjkim                }
341238405Sjkim    MAX-ACCESS  read-only
342238405Sjkim    STATUS      current
343238405Sjkim    DESCRIPTION
344238405Sjkim        "An indication of what version of the Spanning Tree
345238405Sjkim        Protocol is being run.  The value 'decLb100(2)'
346238405Sjkim        indicates the DEC LANbridge 100 Spanning Tree protocol.
347238405Sjkim        IEEE 802.1D implementations will return 'ieee8021d(3)'.
348238405Sjkim        If future versions of the IEEE Spanning Tree Protocol
349238405Sjkim        that are incompatible with the current version
350238405Sjkim        are released a new value will be defined."
351238405Sjkim    ::= { dot1dStp 1 }
352238405Sjkim
353238405Sjkimdot1dStpPriority OBJECT-TYPE
354238405Sjkim    SYNTAX      Integer32 (0..65535)
355238405Sjkim    MAX-ACCESS  read-write
356238405Sjkim    STATUS      current
357276864Sjkim    DESCRIPTION
358238405Sjkim        "The value of the write-able portion of the Bridge ID
359238405Sjkim        (i.e., the first two octets of the (8 octet long) Bridge
360238405Sjkim        ID).  The other (last) 6 octets of the Bridge ID are
361238405Sjkim        given by the value of dot1dBaseBridgeAddress.
362238405Sjkim        On bridges supporting IEEE 802.1t or IEEE 802.1w,
363238405Sjkim        permissible values are 0-61440, in steps of 4096."
364238405Sjkim    REFERENCE
365238405Sjkim        "IEEE 802.1D-1998 clause 8.10.2, Table 8-4,
366238405Sjkim        IEEE 802.1t clause 8.10.2, Table 8-4, clause 14.3."
367238405Sjkim    ::= { dot1dStp 2 }
368238405Sjkim
369238405Sjkimdot1dStpTimeSinceTopologyChange OBJECT-TYPE
370238405Sjkim    SYNTAX      TimeTicks
371238405Sjkim    UNITS       "centi-seconds"
372238405Sjkim    MAX-ACCESS  read-only
373238405Sjkim    STATUS      current
374238405Sjkim    DESCRIPTION
375238405Sjkim        "The time (in hundredths of a second) since the
376238405Sjkim        last time a topology change was detected by the
377238405Sjkim        bridge entity.
378238405Sjkim        For RSTP, this reports the time since the tcWhile
379238405Sjkim        timer for any port on this Bridge was nonzero."
380238405Sjkim    REFERENCE
381238405Sjkim        "IEEE 802.1D-1998 clause 14.8.1.1.,
382238405Sjkim        IEEE 802.1w clause 14.8.1.1."
383238405Sjkim    ::= { dot1dStp 3 }
384238405Sjkim
385238405Sjkimdot1dStpTopChanges OBJECT-TYPE
386238405Sjkim    SYNTAX      Counter32
387238405Sjkim    MAX-ACCESS  read-only
388238405Sjkim    STATUS      current
389238405Sjkim    DESCRIPTION
390238405Sjkim        "The total number of topology changes detected by
391238405Sjkim        this bridge since the management entity was last
392238405Sjkim        reset or initialized."
393238405Sjkim    REFERENCE
394238405Sjkim        "IEEE 802.1D-1998 clause 14.8.1.1."
395238405Sjkim    ::= { dot1dStp 4 }
396238405Sjkim
397238405Sjkimdot1dStpDesignatedRoot OBJECT-TYPE
398238405Sjkim    SYNTAX      BridgeId
399238405Sjkim    MAX-ACCESS  read-only
400276864Sjkim    STATUS      current
401238405Sjkim    DESCRIPTION
402238405Sjkim        "The bridge identifier of the root of the spanning
403238405Sjkim        tree, as determined by the Spanning Tree Protocol,
404238405Sjkim        as executed by this node.  This value is used as
405238405Sjkim        the Root Identifier parameter in all Configuration
406238405Sjkim        Bridge PDUs originated by this node."
407238405Sjkim    REFERENCE
408238405Sjkim        "IEEE 802.1D-1998: clause 8.5.3.1"
409238405Sjkim    ::= { dot1dStp 5 }
410238405Sjkim
411238405Sjkimdot1dStpRootCost OBJECT-TYPE
412238405Sjkim    SYNTAX      Integer32
413238405Sjkim    MAX-ACCESS  read-only
414238405Sjkim    STATUS      current
415238405Sjkim    DESCRIPTION
416238405Sjkim        "The cost of the path to the root as seen from
417238405Sjkim        this bridge."
418238405Sjkim    REFERENCE
419238405Sjkim        "IEEE 802.1D-1998: clause 8.5.3.2"
420238405Sjkim    ::= { dot1dStp 6 }
421238405Sjkim
422238405Sjkimdot1dStpRootPort OBJECT-TYPE
423238405Sjkim    SYNTAX      Integer32
424238405Sjkim    MAX-ACCESS  read-only
425238405Sjkim    STATUS      current
426238405Sjkim    DESCRIPTION
427264331Sjkim        "The port number of the port that offers the lowest
428238405Sjkim        cost path from this bridge to the root bridge."
429238405Sjkim    REFERENCE
430238405Sjkim        "IEEE 802.1D-1998: clause 8.5.3.3"
431238405Sjkim    ::= { dot1dStp 7 }
432238405Sjkim
433238405Sjkimdot1dStpMaxAge OBJECT-TYPE
434238405Sjkim    SYNTAX      Timeout
435238405Sjkim    UNITS       "centi-seconds"
436238405Sjkim    MAX-ACCESS  read-only
437238405Sjkim    STATUS      current
438238405Sjkim    DESCRIPTION
439238405Sjkim        "The maximum age of Spanning Tree Protocol information
440238405Sjkim        learned from the network on any port before it is
441238405Sjkim        discarded, in units of hundredths of a second.  This is
442238405Sjkim        the actual value that this bridge is currently using."
443238405Sjkim    REFERENCE
444238405Sjkim        "IEEE 802.1D-1998: clause 8.5.3.4"
445238405Sjkim    ::= { dot1dStp 8 }
446238405Sjkim
447238405Sjkimdot1dStpHelloTime OBJECT-TYPE
448238405Sjkim    SYNTAX      Timeout
449238405Sjkim    UNITS       "centi-seconds"
450238405Sjkim    MAX-ACCESS  read-only
451238405Sjkim    STATUS      current
452238405Sjkim    DESCRIPTION
453238405Sjkim        "The amount of time between the transmission of
454238405Sjkim        Configuration bridge PDUs by this node on any port when
455238405Sjkim        it is the root of the spanning tree, or trying to become
456238405Sjkim        so, in units of hundredths of a second.  This is the
457238405Sjkim        actual value that this bridge is currently using."
458238405Sjkim    REFERENCE
459238405Sjkim        "IEEE 802.1D-1998: clause 8.5.3.5"
460238405Sjkim    ::= { dot1dStp 9 }
461238405Sjkim
462238405Sjkimdot1dStpHoldTime OBJECT-TYPE
463238405Sjkim    SYNTAX      Integer32
464238405Sjkim    UNITS       "centi-seconds"
465238405Sjkim    MAX-ACCESS  read-only
466238405Sjkim    STATUS      current
467238405Sjkim    DESCRIPTION
468238405Sjkim        "This time value determines the interval length
469238405Sjkim        during which no more than two Configuration bridge
470238405Sjkim        PDUs shall be transmitted by this node, in units
471238405Sjkim        of hundredths of a second."
472238405Sjkim    REFERENCE
473238405Sjkim        "IEEE 802.1D-1998: clause 8.5.3.14"
474238405Sjkim    ::= { dot1dStp 10 }
475238405Sjkim
476238405Sjkimdot1dStpForwardDelay OBJECT-TYPE
477238405Sjkim    SYNTAX      Timeout
478238405Sjkim    UNITS       "centi-seconds"
479238405Sjkim    MAX-ACCESS  read-only
480238405Sjkim    STATUS      current
481238405Sjkim    DESCRIPTION
482238405Sjkim        "This time value, measured in units of hundredths of a
483238405Sjkim        second, controls how fast a port changes its spanning
484238405Sjkim        state when moving towards the Forwarding state.  The
485238405Sjkim        value determines how long the port stays in each of the
486238405Sjkim        Listening and Learning states, which precede the
487238405Sjkim        Forwarding state.  This value is also used when a
488238405Sjkim        topology change has been detected and is underway, to
489238405Sjkim        age all dynamic entries in the Forwarding Database.
490238405Sjkim        [Note that this value is the one that this bridge is
491238405Sjkim        currently using, in contrast to
492238405Sjkim        dot1dStpBridgeForwardDelay, which is the value that this
493238405Sjkim        bridge and all others would start using if/when this
494238405Sjkim        bridge were to become the root.]"
495238405Sjkim    REFERENCE
496238405Sjkim        "IEEE 802.1D-1998: clause 8.5.3.6"
497238405Sjkim    ::= { dot1dStp 11 }
498238405Sjkim
499238405Sjkimdot1dStpBridgeMaxAge OBJECT-TYPE
500276864Sjkim    SYNTAX      Timeout (600..4000)
501238405Sjkim    UNITS       "centi-seconds"
502238405Sjkim    MAX-ACCESS  read-write
503238405Sjkim    STATUS      current
504238405Sjkim    DESCRIPTION
505238405Sjkim        "The value that all bridges use for MaxAge when this
506238405Sjkim        bridge is acting as the root.  Note that 802.1D-1998
507238405Sjkim        specifies that the range for this parameter is related
508238405Sjkim        to the value of dot1dStpBridgeHelloTime.  The
509264331Sjkim        granularity of this timer is specified by 802.1D-1998 to
510238405Sjkim        be 1 second.  An agent may return a badValue error if a
511238405Sjkim        set is attempted to a value that is not a whole number
512238405Sjkim        of seconds."
513238405Sjkim    REFERENCE
514238405Sjkim        "IEEE 802.1D-1998: clause 8.5.3.8"
515238405Sjkim    ::= { dot1dStp 12 }
516238405Sjkim
517276864Sjkimdot1dStpBridgeHelloTime OBJECT-TYPE
518238405Sjkim    SYNTAX      Timeout (100..1000)
519238405Sjkim    UNITS       "centi-seconds"
520238405Sjkim    MAX-ACCESS  read-write
521238405Sjkim    STATUS      current
522238405Sjkim    DESCRIPTION
523238405Sjkim        "The value that all bridges use for HelloTime when this
524238405Sjkim        bridge is acting as the root.  The granularity of this
525238405Sjkim        timer is specified by 802.1D-1998 to be 1 second.  An
526238405Sjkim        agent may return a badValue error if a set is attempted
527238405Sjkim        to a value that is not a whole number of seconds."
528238405Sjkim    REFERENCE
529238405Sjkim        "IEEE 802.1D-1998: clause 8.5.3.9"
530238405Sjkim    ::= { dot1dStp 13 }
531238405Sjkim
532238405Sjkimdot1dStpBridgeForwardDelay OBJECT-TYPE
533238405Sjkim    SYNTAX      Timeout (400..3000)
534238405Sjkim    UNITS       "centi-seconds"
535238405Sjkim    MAX-ACCESS  read-write
536238405Sjkim    STATUS      current
537238405Sjkim    DESCRIPTION
538238405Sjkim        "The value that all bridges use for ForwardDelay when
539238405Sjkim        this bridge is acting as the root.  Note that
540238405Sjkim        802.1D-1998 specifies that the range for this parameter
541238405Sjkim        is related to the value of dot1dStpBridgeMaxAge.  The
542238405Sjkim        granularity of this timer is specified by 802.1D-1998 to
543238405Sjkim        be 1 second.  An agent may return a badValue error if a
544238405Sjkim        set is attempted to a value that is not a whole number
545238405Sjkim        of seconds."
546238405Sjkim    REFERENCE
547238405Sjkim        "IEEE 802.1D-1998: clause 8.5.3.10"
548238405Sjkim    ::= { dot1dStp 14 }
549238405Sjkim
550238405Sjkim-- ---------------------------------------------------------- --
551238405Sjkim-- The Spanning Tree Port Table
552238405Sjkim-- ---------------------------------------------------------- --
553238405Sjkim
554238405Sjkimdot1dStpPortTable OBJECT-TYPE
555238405Sjkim    SYNTAX      SEQUENCE OF Dot1dStpPortEntry
556276864Sjkim    MAX-ACCESS  not-accessible
557238405Sjkim    STATUS      current
558276864Sjkim    DESCRIPTION
559238405Sjkim        "A table that contains port-specific information
560238405Sjkim        for the Spanning Tree Protocol."
561238405Sjkim    ::= { dot1dStp 15 }
562238405Sjkim
563238405Sjkimdot1dStpPortEntry OBJECT-TYPE
564238405Sjkim    SYNTAX      Dot1dStpPortEntry
565238405Sjkim    MAX-ACCESS  not-accessible
566238405Sjkim    STATUS      current
567238405Sjkim    DESCRIPTION
568238405Sjkim        "A list of information maintained by every port about
569238405Sjkim        the Spanning Tree Protocol state for that port."
570238405Sjkim    INDEX   { dot1dStpPort }
571238405Sjkim    ::= { dot1dStpPortTable 1 }
572238405Sjkim
573238405SjkimDot1dStpPortEntry ::=
574238405Sjkim    SEQUENCE {
575238405Sjkim        dot1dStpPort
576238405Sjkim            Integer32,
577238405Sjkim        dot1dStpPortPriority
578238405Sjkim            Integer32,
579238405Sjkim        dot1dStpPortState
580238405Sjkim            INTEGER,
581238405Sjkim        dot1dStpPortEnable
582238405Sjkim            INTEGER,
583238405Sjkim        dot1dStpPortPathCost
584238405Sjkim            Integer32,
585238405Sjkim        dot1dStpPortDesignatedRoot
586238405Sjkim            BridgeId,
587238405Sjkim        dot1dStpPortDesignatedCost
588238405Sjkim            Integer32,
589238405Sjkim        dot1dStpPortDesignatedBridge
590238405Sjkim            BridgeId,
591238405Sjkim        dot1dStpPortDesignatedPort
592238405Sjkim            OCTET STRING,
593238405Sjkim        dot1dStpPortForwardTransitions
594238405Sjkim            Counter32,
595238405Sjkim        dot1dStpPortPathCost32
596238405Sjkim            Integer32
597238405Sjkim    }
598238405Sjkim
599238405Sjkimdot1dStpPort OBJECT-TYPE
600238405Sjkim    SYNTAX      Integer32 (1..65535)
601238405Sjkim    MAX-ACCESS  read-only
602238405Sjkim    STATUS      current
603238405Sjkim    DESCRIPTION
604238405Sjkim        "The port number of the port for which this entry
605238405Sjkim        contains Spanning Tree Protocol management information."
606238405Sjkim    REFERENCE
607238405Sjkim        "IEEE 802.1D-1998: clause 14.8.2.1.2"
608238405Sjkim    ::= { dot1dStpPortEntry 1 }
609238405Sjkim
610238405Sjkimdot1dStpPortPriority OBJECT-TYPE
611238405Sjkim    SYNTAX      Integer32 (0..255)
612238405Sjkim    MAX-ACCESS  read-write
613238405Sjkim    STATUS      current
614238405Sjkim    DESCRIPTION
615238405Sjkim        "The value of the priority field that is contained in
616238405Sjkim        the first (in network byte order) octet of the (2 octet
617238405Sjkim        long) Port ID.  The other octet of the Port ID is given
618238405Sjkim        by the value of dot1dStpPort.
619238405Sjkim        On bridges supporting IEEE 802.1t or IEEE 802.1w,
620238405Sjkim        permissible values are 0-240, in steps of 16."
621238405Sjkim    REFERENCE
622238405Sjkim        "IEEE 802.1D-1998 clause 8.10.2, Table 8-4,
623238405Sjkim        IEEE 802.1t clause 8.10.2, Table 8-4, clause 14.3."
624238405Sjkim    ::= { dot1dStpPortEntry 2 }
625238405Sjkim
626238405Sjkimdot1dStpPortState OBJECT-TYPE
627238405Sjkim    SYNTAX      INTEGER {
628238405Sjkim                    disabled(1),
629238405Sjkim                    blocking(2),
630238405Sjkim                    listening(3),
631238405Sjkim                    learning(4),
632238405Sjkim                    forwarding(5),
633276864Sjkim                    broken(6)
634238405Sjkim                }
635238405Sjkim    MAX-ACCESS  read-only
636238405Sjkim    STATUS      current
637238405Sjkim    DESCRIPTION
638238405Sjkim        "The port's current state, as defined by application of
639238405Sjkim        the Spanning Tree Protocol.  This state controls what
640238405Sjkim        action a port takes on reception of a frame.  If the
641238405Sjkim        bridge has detected a port that is malfunctioning, it
642238405Sjkim        will place that port into the broken(6) state.  For
643238405Sjkim        ports that are disabled (see dot1dStpPortEnable), this
644238405Sjkim        object will have a value of disabled(1)."
645238405Sjkim    REFERENCE
646238405Sjkim        "IEEE 802.1D-1998: clause 8.5.5.2"
647238405Sjkim    ::= { dot1dStpPortEntry 3 }
648238405Sjkim
649238405Sjkimdot1dStpPortEnable OBJECT-TYPE
650238405Sjkim    SYNTAX      INTEGER {
651238405Sjkim                    enabled(1),
652238405Sjkim                    disabled(2)
653238405Sjkim                }
654238405Sjkim    MAX-ACCESS  read-write
655238405Sjkim    STATUS      current
656238405Sjkim    DESCRIPTION
657238405Sjkim        "The enabled/disabled status of the port."
658238405Sjkim    REFERENCE
659        "IEEE 802.1D-1998: clause 8.5.5.2"
660    ::= { dot1dStpPortEntry 4 }
661
662dot1dStpPortPathCost OBJECT-TYPE
663    SYNTAX      Integer32 (1..65535)
664    MAX-ACCESS  read-write
665    STATUS      current
666    DESCRIPTION
667        "The contribution of this port to the path cost of
668        paths towards the spanning tree root which include
669        this port.  802.1D-1998 recommends that the default
670        value of this parameter be in inverse proportion to
671        the speed of the attached LAN.
672
673        New implementations should support dot1dStpPortPathCost32.
674        If the port path costs exceeds the maximum value of this
675        object then this object should report the maximum value,
676        namely 65535.  Applications should try to read the
677        dot1dStpPortPathCost32 object if this object reports
678        the maximum value."
679    REFERENCE "IEEE 802.1D-1998: clause 8.5.5.3"
680        ::= { dot1dStpPortEntry 5 }
681
682dot1dStpPortDesignatedRoot OBJECT-TYPE
683    SYNTAX      BridgeId
684    MAX-ACCESS  read-only
685    STATUS      current
686    DESCRIPTION
687        "The unique Bridge Identifier of the Bridge
688        recorded as the Root in the Configuration BPDUs
689        transmitted by the Designated Bridge for the
690        segment to which the port is attached."
691    REFERENCE
692        "IEEE 802.1D-1998: clause 8.5.5.4"
693    ::= { dot1dStpPortEntry 6 }
694
695dot1dStpPortDesignatedCost OBJECT-TYPE
696    SYNTAX      Integer32
697    MAX-ACCESS  read-only
698    STATUS      current
699    DESCRIPTION
700        "The path cost of the Designated Port of the segment
701        connected to this port.  This value is compared to the
702        Root Path Cost field in received bridge PDUs."
703    REFERENCE
704        "IEEE 802.1D-1998: clause 8.5.5.5"
705    ::= { dot1dStpPortEntry 7 }
706
707dot1dStpPortDesignatedBridge OBJECT-TYPE
708    SYNTAX      BridgeId
709    MAX-ACCESS  read-only
710    STATUS      current
711    DESCRIPTION
712        "The Bridge Identifier of the bridge that this
713        port considers to be the Designated Bridge for
714        this port's segment."
715    REFERENCE
716        "IEEE 802.1D-1998: clause 8.5.5.6"
717    ::= { dot1dStpPortEntry 8 }
718
719dot1dStpPortDesignatedPort OBJECT-TYPE
720    SYNTAX      OCTET STRING (SIZE (2))
721    MAX-ACCESS  read-only
722    STATUS      current
723    DESCRIPTION
724        "The Port Identifier of the port on the Designated
725        Bridge for this port's segment."
726    REFERENCE
727        "IEEE 802.1D-1998: clause 8.5.5.7"
728    ::= { dot1dStpPortEntry 9 }
729
730dot1dStpPortForwardTransitions OBJECT-TYPE
731    SYNTAX      Counter32
732    MAX-ACCESS  read-only
733    STATUS      current
734    DESCRIPTION
735        "The number of times this port has transitioned
736        from the Learning state to the Forwarding state."
737    ::= { dot1dStpPortEntry 10 }
738
739dot1dStpPortPathCost32 OBJECT-TYPE
740    SYNTAX      Integer32 (1..200000000)
741    MAX-ACCESS  read-write
742    STATUS      current
743    DESCRIPTION
744        "The contribution of this port to the path cost of
745        paths towards the spanning tree root which include
746        this port.  802.1D-1998 recommends that the default
747        value of this parameter be in inverse proportion to
748        the speed of the attached LAN.
749
750        This object replaces dot1dStpPortPathCost to support
751        IEEE 802.1t."
752    REFERENCE
753        "IEEE 802.1t clause 8.10.2, Table 8-5."
754    ::= { dot1dStpPortEntry 11 }
755
756-- ---------------------------------------------------------- --
757-- the dot1dTp subtree
758-- ---------------------------------------------------------- --
759-- Implementation of the dot1dTp subtree is optional.  It is
760-- implemented by those bridges that support the transparent
761-- bridging mode.  A transparent or SRT bridge will implement
762-- this subtree.
763-- ---------------------------------------------------------- --
764
765dot1dTpLearnedEntryDiscards OBJECT-TYPE
766    SYNTAX      Counter32
767    MAX-ACCESS  read-only
768    STATUS      current
769    DESCRIPTION
770        "The total number of Forwarding Database entries that
771        have been or would have been learned, but have been
772        discarded due to a lack of storage space in the
773        Forwarding Database.  If this counter is increasing, it
774        indicates that the Forwarding Database is regularly
775        becoming full (a condition that has unpleasant
776        performance effects on the subnetwork).  If this counter
777        has a significant value but is not presently increasing,
778        it indicates that the problem has been occurring but is
779        not persistent."
780    REFERENCE
781        "IEEE 802.1D-1998: clause 14.7.1.1.3"
782    ::= { dot1dTp 1 }
783
784dot1dTpAgingTime OBJECT-TYPE
785    SYNTAX      Integer32 (10..1000000)
786    UNITS       "seconds"
787    MAX-ACCESS  read-write
788    STATUS      current
789    DESCRIPTION
790        "The timeout period in seconds for aging out
791        dynamically-learned forwarding information.
792        802.1D-1998 recommends a default of 300 seconds."
793    REFERENCE
794        "IEEE 802.1D-1998: clause 14.7.1.1.3"
795    ::= { dot1dTp 2 }
796
797
798-- ---------------------------------------------------------- --
799--  The Forwarding Database for Transparent Bridges
800-- ---------------------------------------------------------- --
801
802dot1dTpFdbTable OBJECT-TYPE
803    SYNTAX      SEQUENCE OF Dot1dTpFdbEntry
804    MAX-ACCESS  not-accessible
805    STATUS      current
806    DESCRIPTION
807        "A table that contains information about unicast
808        entries for which the bridge has forwarding and/or
809        filtering information.  This information is used
810        by the transparent bridging function in
811        determining how to propagate a received frame."
812    ::= { dot1dTp 3 }
813
814dot1dTpFdbEntry OBJECT-TYPE
815    SYNTAX      Dot1dTpFdbEntry
816    MAX-ACCESS  not-accessible
817    STATUS      current
818    DESCRIPTION
819        "Information about a specific unicast MAC address
820        for which the bridge has some forwarding and/or
821        filtering information."
822    INDEX   { dot1dTpFdbAddress }
823    ::= { dot1dTpFdbTable 1 }
824
825Dot1dTpFdbEntry ::=
826    SEQUENCE {
827        dot1dTpFdbAddress
828            MacAddress,
829        dot1dTpFdbPort
830            Integer32,
831        dot1dTpFdbStatus
832            INTEGER
833    }
834
835dot1dTpFdbAddress OBJECT-TYPE
836    SYNTAX      MacAddress
837    MAX-ACCESS  read-only
838    STATUS      current
839    DESCRIPTION
840        "A unicast MAC address for which the bridge has
841        forwarding and/or filtering information."
842    REFERENCE
843        "IEEE 802.1D-1998: clause 7.9.1, 7.9.2"
844    ::= { dot1dTpFdbEntry 1 }
845
846dot1dTpFdbPort OBJECT-TYPE
847    SYNTAX      Integer32
848    MAX-ACCESS  read-only
849    STATUS      current
850    DESCRIPTION
851        "Either the value '0', or the port number of the port on
852        which a frame having a source address equal to the value
853        of the corresponding instance of dot1dTpFdbAddress has
854        been seen.  A value of '0' indicates that the port
855        number has not been learned, but that the bridge does
856        have some forwarding/filtering information about this
857        address (e.g., in the dot1dStaticTable).  Implementors
858        are encouraged to assign the port value to this object
859        whenever it is learned, even for addresses for which the
860        corresponding value of dot1dTpFdbStatus is not
861        learned(3)."
862    ::= { dot1dTpFdbEntry 2 }
863dot1dTpFdbStatus OBJECT-TYPE
864    SYNTAX      INTEGER {
865                    other(1),
866                    invalid(2),
867                    learned(3),
868                    self(4),
869                    mgmt(5)
870                }
871    MAX-ACCESS  read-only
872    STATUS      current
873    DESCRIPTION
874        "The status of this entry.  The meanings of the
875        values are:
876            other(1) - none of the following.  This would
877                include the case where some other MIB object
878                (not the corresponding instance of
879                dot1dTpFdbPort, nor an entry in the
880                dot1dStaticTable) is being used to determine if
881                and how frames addressed to the value of the
882                corresponding instance of dot1dTpFdbAddress are
883                being forwarded.
884            invalid(2) - this entry is no longer valid (e.g.,
885                it was learned but has since aged out), but has
886                not yet been flushed from the table.
887            learned(3) - the value of the corresponding instance
888                of dot1dTpFdbPort was learned, and is being
889                used.
890            self(4) - the value of the corresponding instance of
891                dot1dTpFdbAddress represents one of the bridge's
892                addresses.  The corresponding instance of
893                dot1dTpFdbPort indicates which of the bridge's
894                ports has this address.
895            mgmt(5) - the value of the corresponding instance of
896                dot1dTpFdbAddress is also the value of an
897                existing instance of dot1dStaticAddress."
898    ::= { dot1dTpFdbEntry 3 }
899
900-- ---------------------------------------------------------- --
901--  Port Table for Transparent Bridges
902-- ---------------------------------------------------------- --
903
904dot1dTpPortTable OBJECT-TYPE
905    SYNTAX      SEQUENCE OF Dot1dTpPortEntry
906    MAX-ACCESS  not-accessible
907    STATUS      current
908    DESCRIPTION
909        "A table that contains information about every port that
910        is associated with this transparent bridge."
911    ::= { dot1dTp 4 }
912
913dot1dTpPortEntry OBJECT-TYPE
914    SYNTAX      Dot1dTpPortEntry
915    MAX-ACCESS  not-accessible
916    STATUS      current
917    DESCRIPTION
918        "A list of information for each port of a transparent
919        bridge."
920    INDEX   { dot1dTpPort }
921    ::= { dot1dTpPortTable 1 }
922
923Dot1dTpPortEntry ::=
924    SEQUENCE {
925        dot1dTpPort
926            Integer32,
927        dot1dTpPortMaxInfo
928            Integer32,
929        dot1dTpPortInFrames
930            Counter32,
931        dot1dTpPortOutFrames
932            Counter32,
933        dot1dTpPortInDiscards
934            Counter32
935    }
936
937dot1dTpPort OBJECT-TYPE
938    SYNTAX      Integer32 (1..65535)
939    MAX-ACCESS  read-only
940    STATUS      current
941    DESCRIPTION
942        "The port number of the port for which this entry
943        contains Transparent bridging management information."
944    ::= { dot1dTpPortEntry 1 }
945
946-- It would be nice if we could use ifMtu as the size of the
947-- largest INFO field, but we can't because ifMtu is defined
948-- to be the size that the (inter-)network layer can use, which
949-- can differ from the MAC layer (especially if several layers
950-- of encapsulation are used).
951
952dot1dTpPortMaxInfo OBJECT-TYPE
953    SYNTAX      Integer32
954    UNITS       "bytes"
955    MAX-ACCESS  read-only
956    STATUS      current
957    DESCRIPTION
958        "The maximum size of the INFO (non-MAC) field that
959        this port will receive or transmit."
960    ::= { dot1dTpPortEntry 2 }
961
962dot1dTpPortInFrames OBJECT-TYPE
963    SYNTAX      Counter32
964    UNITS       "frames"
965    MAX-ACCESS  read-only
966    STATUS      current
967    DESCRIPTION
968        "The number of frames that have been received by this
969        port from its segment.  Note that a frame received on the
970        interface corresponding to this port is only counted by
971        this object if and only if it is for a protocol being
972        processed by the local bridging function, including
973        bridge management frames."
974    REFERENCE
975        "IEEE 802.1D-1998: clause 14.6.1.1.3"
976    ::= { dot1dTpPortEntry 3 }
977
978dot1dTpPortOutFrames OBJECT-TYPE
979    SYNTAX      Counter32
980    UNITS       "frames"
981    MAX-ACCESS  read-only
982    STATUS      current
983    DESCRIPTION
984        "The number of frames that have been transmitted by this
985        port to its segment.  Note that a frame transmitted on
986        the interface corresponding to this port is only counted
987        by this object if and only if it is for a protocol being
988        processed by the local bridging function, including
989        bridge management frames."
990    REFERENCE
991        "IEEE 802.1D-1998: clause 14.6.1.1.3"
992    ::= { dot1dTpPortEntry 4 }
993
994dot1dTpPortInDiscards OBJECT-TYPE
995    SYNTAX      Counter32
996    UNITS       "frames"
997    MAX-ACCESS  read-only
998    STATUS      current
999    DESCRIPTION
1000        "Count of received valid frames that were discarded
1001        (i.e., filtered) by the Forwarding Process."
1002    REFERENCE
1003        "IEEE 802.1D-1998: clause 14.6.1.1.3"
1004    ::= { dot1dTpPortEntry 5 }
1005
1006-- ---------------------------------------------------------- --
1007-- The Static (Destination-Address Filtering) Database
1008-- ---------------------------------------------------------- --
1009-- Implementation of this subtree is optional.
1010-- ---------------------------------------------------------- --
1011
1012dot1dStaticTable OBJECT-TYPE
1013    SYNTAX      SEQUENCE OF Dot1dStaticEntry
1014    MAX-ACCESS  not-accessible
1015    STATUS      current
1016    DESCRIPTION
1017        "A table containing filtering information configured
1018        into the bridge by (local or network) management
1019        specifying the set of ports to which frames received
1020        from specific ports and containing specific destination
1021        addresses are allowed to be forwarded.  The value of
1022        zero in this table, as the port number from which frames
1023        with a specific destination address are received, is
1024        used to specify all ports for which there is no specific
1025        entry in this table for that particular destination
1026        address.  Entries are valid for unicast and for
1027        group/broadcast addresses."
1028    REFERENCE
1029        "IEEE 802.1D-1998: clause 14.7.2"
1030    ::= { dot1dStatic 1 }
1031
1032dot1dStaticEntry OBJECT-TYPE
1033    SYNTAX      Dot1dStaticEntry
1034    MAX-ACCESS  not-accessible
1035    STATUS      current
1036    DESCRIPTION
1037        "Filtering information configured into the bridge by
1038        (local or network) management specifying the set of
1039        ports to which frames received from a specific port and
1040        containing a specific destination address are allowed to
1041        be forwarded."
1042    REFERENCE
1043        "IEEE 802.1D-1998: clause 14.7.2"
1044    INDEX   { dot1dStaticAddress, dot1dStaticReceivePort }
1045    ::= { dot1dStaticTable 1 }
1046
1047Dot1dStaticEntry ::=
1048    SEQUENCE {
1049        dot1dStaticAddress       MacAddress,
1050        dot1dStaticReceivePort   Integer32,
1051        dot1dStaticAllowedToGoTo OCTET STRING,
1052        dot1dStaticStatus        INTEGER
1053    }
1054
1055dot1dStaticAddress OBJECT-TYPE
1056    SYNTAX      MacAddress
1057    MAX-ACCESS  read-create
1058    STATUS      current
1059    DESCRIPTION
1060        "The destination MAC address in a frame to which this
1061        entry's filtering information applies.  This object can
1062        take the value of a unicast address, a group address, or
1063        the broadcast address."
1064    REFERENCE
1065        "IEEE 802.1D-1998: clause 7.9.1, 7.9.2"
1066    ::= { dot1dStaticEntry 1 }
1067
1068dot1dStaticReceivePort OBJECT-TYPE
1069    SYNTAX      Integer32 (0..65535)
1070    MAX-ACCESS  read-create
1071    STATUS      current
1072    DESCRIPTION
1073        "Either the value '0', or the port number of the port
1074        from which a frame must be received in order for this
1075        entry's filtering information to apply.  A value of zero
1076        indicates that this entry applies on all ports of the
1077        bridge for which there is no other applicable entry."
1078    ::= { dot1dStaticEntry 2 }
1079
1080dot1dStaticAllowedToGoTo OBJECT-TYPE
1081    SYNTAX      OCTET STRING (SIZE (0..512))
1082    MAX-ACCESS  read-create
1083    STATUS      current
1084    DESCRIPTION
1085        "The set of ports to which frames received from a
1086        specific port and destined for a specific MAC address,
1087        are allowed to be forwarded.  Each octet within the
1088        value of this object specifies a set of eight ports,
1089        with the first octet specifying ports 1 through 8, the
1090        second octet specifying ports 9 through 16, etc.  Within
1091        each octet, the most significant bit represents the
1092        lowest numbered port, and the least significant bit
1093        represents the highest numbered port.  Thus, each port
1094        of the bridge is represented by a single bit within the
1095        value of this object.  If that bit has a value of '1',
1096        then that port is included in the set of ports; the port
1097        is not included if its bit has a value of '0'.  (Note
1098        that the setting of the bit corresponding to the port
1099        from which a frame is received is irrelevant.)  The
1100        default value of this object is a string of ones of
1101        appropriate length.
1102
1103        The value of this object may exceed the required minimum
1104        maximum message size of some SNMP transport (484 bytes,
1105        in the case of SNMP over UDP, see RFC 3417, section 3.2).
1106        SNMP engines on bridges supporting a large number of
1107        ports must support appropriate maximum message sizes."
1108    ::= { dot1dStaticEntry 3 }
1109
1110dot1dStaticStatus OBJECT-TYPE
1111    SYNTAX      INTEGER {
1112                    other(1),
1113                    invalid(2),
1114                    permanent(3),
1115                    deleteOnReset(4),
1116                    deleteOnTimeout(5)
1117                }
1118    MAX-ACCESS  read-create
1119    STATUS      current
1120    DESCRIPTION
1121        "This object indicates the status of this entry.
1122        The default value is permanent(3).
1123            other(1) - this entry is currently in use but the
1124                conditions under which it will remain so are
1125                different from each of the following values.
1126            invalid(2) - writing this value to the object
1127                removes the corresponding entry.
1128            permanent(3) - this entry is currently in use and
1129                will remain so after the next reset of the
1130                bridge.
1131            deleteOnReset(4) - this entry is currently in use
1132                and will remain so until the next reset of the
1133                bridge.
1134            deleteOnTimeout(5) - this entry is currently in use
1135                and will remain so until it is aged out."
1136    ::= { dot1dStaticEntry 4 }
1137
1138-- ---------------------------------------------------------- --
1139-- Notifications for use by Bridges
1140-- ---------------------------------------------------------- --
1141-- Notifications for the Spanning Tree Protocol
1142-- ---------------------------------------------------------- --
1143
1144newRoot NOTIFICATION-TYPE
1145    -- OBJECTS     { }
1146    STATUS      current
1147    DESCRIPTION
1148        "The newRoot trap indicates that the sending agent has
1149        become the new root of the Spanning Tree; the trap is
1150        sent by a bridge soon after its election as the new
1151        root, e.g., upon expiration of the Topology Change Timer,
1152        immediately subsequent to its election.  Implementation
1153        of this trap is optional."
1154    ::= { dot1dNotifications 1 }
1155
1156topologyChange NOTIFICATION-TYPE
1157    -- OBJECTS     { }
1158    STATUS      current
1159    DESCRIPTION
1160        "A topologyChange trap is sent by a bridge when any of
1161        its configured ports transitions from the Learning state
1162        to the Forwarding state, or from the Forwarding state to
1163        the Blocking state.  The trap is not sent if a newRoot
1164        trap is sent for the same transition.  Implementation of
1165        this trap is optional."
1166    ::= { dot1dNotifications 2 }
1167
1168-- ---------------------------------------------------------- --
1169-- IEEE 802.1D MIB - Conformance Information
1170-- ---------------------------------------------------------- --
1171
1172dot1dGroups         OBJECT IDENTIFIER ::= { dot1dConformance 1 }
1173dot1dCompliances    OBJECT IDENTIFIER ::= { dot1dConformance 2 }
1174
1175-- ---------------------------------------------------------- --
1176-- units of conformance
1177-- ---------------------------------------------------------- --
1178
1179-- ---------------------------------------------------------- --
1180-- the dot1dBase group
1181-- ---------------------------------------------------------- --
1182
1183dot1dBaseBridgeGroup OBJECT-GROUP
1184    OBJECTS {
1185        dot1dBaseBridgeAddress,
1186        dot1dBaseNumPorts,
1187        dot1dBaseType
1188    }
1189    STATUS      current
1190    DESCRIPTION
1191        "Bridge level information for this device."
1192    ::= { dot1dGroups 1 }
1193
1194dot1dBasePortGroup OBJECT-GROUP
1195    OBJECTS {
1196        dot1dBasePort,
1197        dot1dBasePortIfIndex,
1198        dot1dBasePortCircuit,
1199        dot1dBasePortDelayExceededDiscards,
1200        dot1dBasePortMtuExceededDiscards
1201    }
1202    STATUS      current
1203    DESCRIPTION
1204        "Information for each port on this device."
1205    ::= { dot1dGroups 2 }
1206
1207-- ---------------------------------------------------------- --
1208-- the dot1dStp group
1209-- ---------------------------------------------------------- --
1210
1211dot1dStpBridgeGroup OBJECT-GROUP
1212    OBJECTS {
1213        dot1dStpProtocolSpecification,
1214        dot1dStpPriority,
1215        dot1dStpTimeSinceTopologyChange,
1216        dot1dStpTopChanges,
1217        dot1dStpDesignatedRoot,
1218        dot1dStpRootCost,
1219        dot1dStpRootPort,
1220        dot1dStpMaxAge,
1221        dot1dStpHelloTime,
1222        dot1dStpHoldTime,
1223        dot1dStpForwardDelay,
1224        dot1dStpBridgeMaxAge,
1225        dot1dStpBridgeHelloTime,
1226        dot1dStpBridgeForwardDelay
1227    }
1228    STATUS      current
1229    DESCRIPTION
1230        "Bridge level Spanning Tree data for this device."
1231    ::= { dot1dGroups 3 }
1232
1233dot1dStpPortGroup OBJECT-GROUP
1234    OBJECTS {
1235        dot1dStpPort,
1236        dot1dStpPortPriority,
1237        dot1dStpPortState,
1238        dot1dStpPortEnable,
1239        dot1dStpPortPathCost,
1240        dot1dStpPortDesignatedRoot,
1241        dot1dStpPortDesignatedCost,
1242        dot1dStpPortDesignatedBridge,
1243        dot1dStpPortDesignatedPort,
1244        dot1dStpPortForwardTransitions
1245    }
1246    STATUS      current
1247    DESCRIPTION
1248        "Spanning Tree data for each port on this device."
1249    ::= { dot1dGroups 4 }
1250
1251dot1dStpPortGroup2 OBJECT-GROUP
1252    OBJECTS {
1253        dot1dStpPort,
1254        dot1dStpPortPriority,
1255        dot1dStpPortState,
1256        dot1dStpPortEnable,
1257        dot1dStpPortDesignatedRoot,
1258        dot1dStpPortDesignatedCost,
1259        dot1dStpPortDesignatedBridge,
1260        dot1dStpPortDesignatedPort,
1261        dot1dStpPortForwardTransitions,
1262        dot1dStpPortPathCost32
1263    }
1264    STATUS      current
1265    DESCRIPTION
1266        "Spanning Tree data for each port on this device."
1267    ::= { dot1dGroups 5 }
1268
1269dot1dStpPortGroup3 OBJECT-GROUP
1270    OBJECTS {
1271        dot1dStpPortPathCost32
1272    }
1273    STATUS      current
1274    DESCRIPTION
1275        "Spanning Tree data for devices supporting 32-bit
1276         path costs."
1277    ::= { dot1dGroups 6 }
1278
1279-- ---------------------------------------------------------- --
1280-- the dot1dTp group
1281-- ---------------------------------------------------------- --
1282
1283dot1dTpBridgeGroup OBJECT-GROUP
1284    OBJECTS {
1285        dot1dTpLearnedEntryDiscards,
1286        dot1dTpAgingTime
1287    }
1288    STATUS      current
1289    DESCRIPTION
1290        "Bridge level Transparent Bridging data."
1291    ::= { dot1dGroups 7 }
1292
1293dot1dTpFdbGroup OBJECT-GROUP
1294    OBJECTS {
1295        dot1dTpFdbAddress,
1296        dot1dTpFdbPort,
1297        dot1dTpFdbStatus
1298    }
1299
1300    STATUS      current
1301    DESCRIPTION
1302        "Filtering Database information for the Bridge."
1303    ::= { dot1dGroups 8 }
1304
1305dot1dTpGroup OBJECT-GROUP
1306    OBJECTS {
1307        dot1dTpPort,
1308        dot1dTpPortMaxInfo,
1309        dot1dTpPortInFrames,
1310        dot1dTpPortOutFrames,
1311        dot1dTpPortInDiscards
1312    }
1313    STATUS      current
1314    DESCRIPTION
1315        "Dynamic Filtering Database information for each port of
1316        the Bridge."
1317    ::= { dot1dGroups 9 }
1318
1319-- ---------------------------------------------------------- --
1320-- The Static (Destination-Address Filtering) Database
1321-- ---------------------------------------------------------- --
1322
1323dot1dStaticGroup OBJECT-GROUP
1324    OBJECTS {
1325        dot1dStaticAddress,
1326        dot1dStaticReceivePort,
1327        dot1dStaticAllowedToGoTo,
1328        dot1dStaticStatus
1329    }
1330    STATUS      current
1331    DESCRIPTION
1332        "Static Filtering Database information for each port of
1333        the Bridge."
1334    ::= { dot1dGroups 10 }
1335
1336-- ---------------------------------------------------------- --
1337-- The Trap Notification Group
1338-- ---------------------------------------------------------- --
1339
1340dot1dNotificationGroup NOTIFICATION-GROUP
1341    NOTIFICATIONS {
1342        newRoot,
1343        topologyChange
1344    }
1345    STATUS      current
1346    DESCRIPTION
1347        "Group of objects describing notifications (traps)."
1348    ::= { dot1dGroups 11 }
1349
1350-- ---------------------------------------------------------- --
1351-- compliance statements
1352-- ---------------------------------------------------------- --
1353
1354bridgeCompliance1493 MODULE-COMPLIANCE
1355    STATUS      current
1356    DESCRIPTION
1357        "The compliance statement for device support of bridging
1358        services, as per RFC1493."
1359
1360    MODULE
1361        MANDATORY-GROUPS {
1362            dot1dBaseBridgeGroup,
1363            dot1dBasePortGroup
1364        }
1365
1366    GROUP   dot1dStpBridgeGroup
1367    DESCRIPTION
1368        "Implementation of this group is mandatory for bridges
1369        that support the Spanning Tree Protocol."
1370
1371    GROUP   dot1dStpPortGroup
1372    DESCRIPTION
1373        "Implementation of this group is mandatory for bridges
1374        that support the Spanning Tree Protocol."
1375
1376    GROUP   dot1dTpBridgeGroup
1377    DESCRIPTION
1378        "Implementation of this group is mandatory for bridges
1379        that support the transparent bridging mode.  A
1380        transparent or SRT bridge will implement this group."
1381
1382    GROUP   dot1dTpFdbGroup
1383    DESCRIPTION
1384        "Implementation of this group is mandatory for bridges
1385        that support the transparent bridging mode.  A
1386        transparent or SRT bridge will implement this group."
1387
1388    GROUP   dot1dTpGroup
1389    DESCRIPTION
1390        "Implementation of this group is mandatory for bridges
1391        that support the transparent bridging mode.  A
1392        transparent or SRT bridge will implement this group."
1393
1394    GROUP   dot1dStaticGroup
1395    DESCRIPTION
1396        "Implementation of this group is optional."
1397
1398    GROUP dot1dNotificationGroup
1399    DESCRIPTION
1400        "Implementation of this group is optional."
1401    ::= { dot1dCompliances 1 }
1402
1403bridgeCompliance4188 MODULE-COMPLIANCE
1404    STATUS      current
1405    DESCRIPTION
1406        "The compliance statement for device support of bridging
1407        services.  This supports 32-bit Path Cost values and the
1408        more restricted bridge and port priorities, as per IEEE
1409        802.1t.
1410
1411        Full support for the 802.1D management objects requires that
1412        the SNMPv2-MIB [RFC3418] objects sysDescr, and sysUpTime, as
1413        well as the IF-MIB [RFC2863] objects ifIndex, ifType,
1414        ifDescr, ifPhysAddress, and ifLastChange are implemented."
1415
1416    MODULE
1417        MANDATORY-GROUPS {
1418            dot1dBaseBridgeGroup,
1419            dot1dBasePortGroup
1420        }
1421
1422    GROUP   dot1dStpBridgeGroup
1423    DESCRIPTION
1424        "Implementation of this group is mandatory for
1425        bridges that support the Spanning Tree Protocol."
1426
1427    OBJECT dot1dStpPriority
1428    SYNTAX Integer32 (0|4096|8192|12288|16384|20480|24576
1429                     |28672|32768|36864|40960|45056|49152
1430                     |53248|57344|61440)
1431    DESCRIPTION
1432        "The possible values defined by IEEE 802.1t."
1433
1434    GROUP   dot1dStpPortGroup2
1435    DESCRIPTION
1436        "Implementation of this group is mandatory for
1437        bridges that support the Spanning Tree Protocol."
1438
1439    GROUP   dot1dStpPortGroup3
1440    DESCRIPTION
1441        "Implementation of this group is mandatory for bridges
1442         that support the Spanning Tree Protocol and 32-bit path
1443         costs.  In particular, this includes devices supporting
1444         IEEE 802.1t and IEEE 802.1w."
1445
1446    OBJECT dot1dStpPortPriority
1447    SYNTAX Integer32 (0|16|32|48|64|80|96|112|128
1448                     |144|160|176|192|208|224|240)
1449    DESCRIPTION
1450        "The possible values defined by IEEE 802.1t."
1451
1452    GROUP   dot1dTpBridgeGroup
1453    DESCRIPTION
1454        "Implementation of this group is mandatory for
1455        bridges that support the transparent bridging
1456        mode.  A transparent or SRT bridge will implement
1457        this group."
1458
1459    GROUP   dot1dTpFdbGroup
1460    DESCRIPTION
1461        "Implementation of this group is mandatory for
1462        bridges that support the transparent bridging
1463        mode.  A transparent or SRT bridge will implement
1464        this group."
1465
1466    GROUP   dot1dTpGroup
1467    DESCRIPTION
1468        "Implementation of this group is mandatory for
1469        bridges that support the transparent bridging
1470        mode.  A transparent or SRT bridge will implement
1471        this group."
1472
1473    GROUP   dot1dStaticGroup
1474    DESCRIPTION
1475        "Implementation of this group is optional."
1476
1477    GROUP dot1dNotificationGroup
1478    DESCRIPTION
1479        "Implementation of this group is optional."
1480
1481    ::= { dot1dCompliances 2 }
1482
1483END
1484