Leaked source code of windows server 2003
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

1196 lines
47 KiB

  1. BRIDGE-MIB DEFINITIONS ::= BEGIN
  2. IMPORTS
  3. Counter, TimeTicks
  4. FROM RFC1155-SMI
  5. mib-2
  6. FROM RFC1213-MIB
  7. OBJECT-TYPE
  8. FROM RFC-1212
  9. TRAP-TYPE
  10. FROM RFC-1215;
  11. -- All representations of MAC addresses in this MIB Module
  12. -- use, as a textual convention (i.e. this convention does
  13. -- not affect their encoding), the data type:
  14. MacAddress ::= OCTET STRING (SIZE (6)) -- a 6 octet address
  15. -- in the
  16. -- "canonical"
  17. -- order
  18. -- defined by IEEE 802.1a, i.e., as if it were transmitted
  19. -- least significant bit first, even though 802.5 (in
  20. -- contrast to other n802.x protocols) requires MAC
  21. -- addresses to be transmitted most significant bit first.
  22. --
  23. -- 16-bit addresses, if needed, are represented by setting
  24. -- their upper 4 octets to all 0's, i.e., AAFF would be
  25. -- represented as 00000000AAFF.
  26. -- Similarly, all representations of Bridge-Id in this MIB
  27. -- Module use, as a textual convention (i.e. this
  28. -- convention does not affect their encoding), the data
  29. -- type:
  30. BridgeId ::= OCTET STRING (SIZE (8)) -- the
  31. -- Bridge-Identifier
  32. -- as used in the
  33. -- Spanning Tree
  34. -- Protocol to uniquely identify a bridge. Its first two
  35. -- octets (in network byte order) contain a priority
  36. -- value and its last 6 octets contain the MAC address
  37. -- used to refer to a bridge in a unique fashion
  38. -- (typically, the numerically smallest MAC address
  39. -- of all ports on the bridge).
  40. -- Several objects in this MIB module represent values of
  41. -- timers used by the Spanning Tree Protocol. In this
  42. -- MIB, these timers have values in units of hundreths of
  43. -- a second (i.e. 1/100 secs).
  44. -- These timers, when stored in a Spanning Tree Protocol's
  45. -- BPDU, are in units of 1/256 seconds. Note, however,
  46. -- that 802.1D-1990 specifies a settable granularity of
  47. -- no more than 1 second for these timers. To avoid
  48. -- ambiguity, a data type is defined here as a textual
  49. -- convention and all representation of these timers
  50. -- in this MIB module are defined using this data type. An
  51. -- algorithm is also defined for converting between the
  52. -- different units, to ensure a timer's value is not
  53. -- distorted by multiple conversions.
  54. -- The data type is:
  55. Timeout ::= INTEGER -- a STP timer in units of 1/100 seconds
  56. -- To convert a Timeout value into a value in units of
  57. -- 1/256 seconds, the following algorithm should be used:
  58. --
  59. -- b = floor( (n * 256) / 100)
  60. --
  61. -- where:
  62. -- floor = quotient [ignore remainder]
  63. -- n is the value in 1/100 second units
  64. -- b is the value in 1/256 second units
  65. --
  66. -- To convert the value from 1/256 second units back to
  67. -- 1/100 seconds, the following algorithm should be used:
  68. --
  69. -- n = ceiling( (b * 100) / 256)
  70. --
  71. -- where:
  72. -- ceiling = quotient [if remainder is 0], or
  73. -- quotient + 1 [if remainder is non-zero]
  74. -- n is the value in 1/100 second units
  75. -- b is the value in 1/256 second units
  76. --
  77. -- Note: it is important that the arithmetic operations are
  78. -- done in the order specified (i.e., multiply first, divide
  79. -- second).
  80. dot1dBridge OBJECT IDENTIFIER ::= { mib-2 17 }
  81. -- groups in the Bridge MIB
  82. dot1dBase OBJECT IDENTIFIER ::= { dot1dBridge 1 }
  83. dot1dStp OBJECT IDENTIFIER ::= { dot1dBridge 2 }
  84. dot1dSr OBJECT IDENTIFIER ::= { dot1dBridge 3 }
  85. -- separately documented
  86. dot1dTp OBJECT IDENTIFIER ::= { dot1dBridge 4 }
  87. dot1dStatic OBJECT IDENTIFIER ::= { dot1dBridge 5 }
  88. -- the dot1dBase group
  89. -- Implementation of the dot1dBase group is mandatory for all
  90. -- bridges.
  91. dot1dBaseBridgeAddress OBJECT-TYPE
  92. SYNTAX MacAddress
  93. ACCESS read-only
  94. STATUS mandatory
  95. DESCRIPTION
  96. "The MAC address used by this bridge when it must
  97. be referred to in a unique fashion. It is
  98. recommended that this be the numerically smallest
  99. MAC address of all ports that belong to this
  100. bridge. However it is only required to be unique.
  101. When concatenated with dot1dStpPriority a unique
  102. BridgeIdentifier is formed which is used in the
  103. Spanning Tree Protocol."
  104. REFERENCE
  105. "IEEE 802.1D-1990: Sections 6.4.1.1.3 and 3.12.5"
  106. ::= { dot1dBase 1 }
  107. dot1dBaseNumPorts OBJECT-TYPE
  108. SYNTAX INTEGER
  109. ACCESS read-only
  110. STATUS mandatory
  111. DESCRIPTION
  112. "The number of ports controlled by this bridging
  113. entity."
  114. REFERENCE
  115. "IEEE 802.1D-1990: Section 6.4.1.1.3"
  116. ::= { dot1dBase 2 }
  117. dot1dBaseType OBJECT-TYPE
  118. SYNTAX INTEGER {
  119. unknown(1),
  120. transparent-only(2),
  121. sourceroute-only(3),
  122. srt(4)
  123. }
  124. ACCESS read-only
  125. STATUS mandatory
  126. DESCRIPTION
  127. "Indicates what type of bridging this bridge can
  128. perform. If a bridge is actually performing a
  129. certain type of bridging this will be indicated by
  130. entries in the port table for the given type."
  131. ::= { dot1dBase 3 }
  132. -- The Generic Bridge Port Table
  133. dot1dBasePortTable OBJECT-TYPE
  134. SYNTAX SEQUENCE OF Dot1dBasePortEntry
  135. ACCESS not-accessible
  136. STATUS mandatory
  137. DESCRIPTION
  138. "A table that contains generic information about
  139. every port that is associated with this bridge.
  140. Transparent, source-route, and srt ports are
  141. included."
  142. ::= { dot1dBase 4 }
  143. dot1dBasePortEntry OBJECT-TYPE
  144. SYNTAX Dot1dBasePortEntry
  145. ACCESS not-accessible
  146. STATUS mandatory
  147. DESCRIPTION
  148. "A list of information for each port of the
  149. bridge."
  150. REFERENCE
  151. "IEEE 802.1D-1990: Section 6.4.2, 6.6.1"
  152. INDEX { dot1dBasePort }
  153. ::= { dot1dBasePortTable 1 }
  154. Dot1dBasePortEntry ::=
  155. SEQUENCE {
  156. dot1dBasePort
  157. INTEGER,
  158. dot1dBasePortIfIndex
  159. INTEGER,
  160. dot1dBasePortCircuit
  161. OBJECT IDENTIFIER,
  162. dot1dBasePortDelayExceededDiscards
  163. Counter,
  164. dot1dBasePortMtuExceededDiscards
  165. Counter
  166. }
  167. dot1dBasePort OBJECT-TYPE
  168. SYNTAX INTEGER (1..65535)
  169. ACCESS read-only
  170. STATUS mandatory
  171. DESCRIPTION
  172. "The port number of the port for which this entry
  173. contains bridge management information."
  174. ::= { dot1dBasePortEntry 1 }
  175. dot1dBasePortIfIndex OBJECT-TYPE
  176. SYNTAX INTEGER
  177. ACCESS read-only
  178. STATUS mandatory
  179. DESCRIPTION
  180. "The value of the instance of the ifIndex object,
  181. defined in MIB-II, for the interface corresponding
  182. to this port."
  183. ::= { dot1dBasePortEntry 2 }
  184. dot1dBasePortCircuit OBJECT-TYPE
  185. SYNTAX OBJECT IDENTIFIER
  186. ACCESS read-only
  187. STATUS mandatory
  188. DESCRIPTION
  189. "For a port which (potentially) has the same value
  190. of dot1dBasePortIfIndex as another port on the
  191. same bridge, this object contains the name of an
  192. object instance unique to this port. For example,
  193. in the case where multiple ports correspond one-
  194. to-one with multiple X.25 virtual circuits, this
  195. value might identify an (e.g., the first) object
  196. instance associated with the X.25 virtual circuit
  197. corresponding to this port.
  198. For a port which has a unique value of
  199. dot1dBasePortIfIndex, this object can have the
  200. value { 0 0 }."
  201. ::= { dot1dBasePortEntry 3 }
  202. dot1dBasePortDelayExceededDiscards OBJECT-TYPE
  203. SYNTAX Counter
  204. ACCESS read-only
  205. STATUS mandatory
  206. DESCRIPTION
  207. "The number of frames discarded by this port due
  208. to excessive transit delay through the bridge. It
  209. is incremented by both transparent and source
  210. route bridges."
  211. REFERENCE
  212. "IEEE 802.1D-1990: Section 6.6.1.1.3"
  213. ::= { dot1dBasePortEntry 4 }
  214. dot1dBasePortMtuExceededDiscards OBJECT-TYPE
  215. SYNTAX Counter
  216. ACCESS read-only
  217. STATUS mandatory
  218. DESCRIPTION
  219. "The number of frames discarded by this port due
  220. to an excessive size. It is incremented by both
  221. transparent and source route bridges."
  222. REFERENCE
  223. "IEEE 802.1D-1990: Section 6.6.1.1.3"
  224. ::= { dot1dBasePortEntry 5 }
  225. -- the dot1dStp group
  226. -- Implementation of the dot1dStp group is optional. It is
  227. -- implemented by those bridges that support the Spanning Tree
  228. -- Protocol.
  229. dot1dStpProtocolSpecification OBJECT-TYPE
  230. SYNTAX INTEGER {
  231. unknown(1),
  232. decLb100(2),
  233. ieee8021d(3)
  234. }
  235. ACCESS read-only
  236. STATUS mandatory
  237. DESCRIPTION
  238. "An indication of what version of the Spanning
  239. Tree Protocol is being run. The value
  240. 'decLb100(2)' indicates the DEC LANbridge 100
  241. Spanning Tree protocol. IEEE 802.1d
  242. implementations will return 'ieee8021d(3)'. If
  243. future versions of the IEEE Spanning Tree Protocol
  244. are released that are incompatible with the
  245. current version a new value will be defined."
  246. ::= { dot1dStp 1 }
  247. dot1dStpPriority OBJECT-TYPE
  248. SYNTAX INTEGER (0..65535)
  249. ACCESS read-write
  250. STATUS mandatory
  251. DESCRIPTION
  252. "The value of the write-able portion of the Bridge
  253. ID, i.e., the first two octets of the (8 octet
  254. long) Bridge ID. The other (last) 6 octets of the
  255. Bridge ID are given by the value of
  256. dot1dBaseBridgeAddress."
  257. REFERENCE
  258. "IEEE 802.1D-1990: Section 4.5.3.7"
  259. ::= { dot1dStp 2 }
  260. dot1dStpTimeSinceTopologyChange OBJECT-TYPE
  261. SYNTAX TimeTicks
  262. ACCESS read-only
  263. STATUS mandatory
  264. DESCRIPTION
  265. "The time (in hundredths of a second) since the
  266. last time a topology change was detected by the
  267. bridge entity."
  268. REFERENCE
  269. "IEEE 802.1D-1990: Section 6.8.1.1.3"
  270. ::= { dot1dStp 3 }
  271. dot1dStpTopChanges OBJECT-TYPE
  272. SYNTAX Counter
  273. ACCESS read-only
  274. STATUS mandatory
  275. DESCRIPTION
  276. "The total number of topology changes detected by
  277. this bridge since the management entity was last
  278. reset or initialized."
  279. REFERENCE
  280. "IEEE 802.1D-1990: Section 6.8.1.1.3"
  281. ::= { dot1dStp 4 }
  282. dot1dStpDesignatedRoot OBJECT-TYPE
  283. SYNTAX BridgeId
  284. ACCESS read-only
  285. STATUS mandatory
  286. DESCRIPTION
  287. "The bridge identifier of the root of the spanning
  288. tree as determined by the Spanning Tree Protocol
  289. as executed by this node. This value is used as
  290. the Root Identifier parameter in all Configuration
  291. Bridge PDUs originated by this node."
  292. REFERENCE
  293. "IEEE 802.1D-1990: Section 4.5.3.1"
  294. ::= { dot1dStp 5 }
  295. dot1dStpRootCost OBJECT-TYPE
  296. SYNTAX INTEGER
  297. ACCESS read-only
  298. STATUS mandatory
  299. DESCRIPTION
  300. "The cost of the path to the root as seen from
  301. this bridge."
  302. REFERENCE
  303. "IEEE 802.1D-1990: Section 4.5.3.2"
  304. ::= { dot1dStp 6 }
  305. dot1dStpRootPort OBJECT-TYPE
  306. SYNTAX INTEGER
  307. ACCESS read-only
  308. STATUS mandatory
  309. DESCRIPTION
  310. "The port number of the port which offers the
  311. lowest cost path from this bridge to the root
  312. bridge."
  313. REFERENCE
  314. "IEEE 802.1D-1990: Section 4.5.3.3"
  315. ::= { dot1dStp 7 }
  316. dot1dStpMaxAge OBJECT-TYPE
  317. SYNTAX Timeout
  318. ACCESS read-only
  319. STATUS mandatory
  320. DESCRIPTION
  321. "The maximum age of Spanning Tree Protocol
  322. information learned from the network on any port
  323. before it is discarded, in units of hundredths of
  324. a second. This is the actual value that this
  325. bridge is currently using."
  326. REFERENCE
  327. "IEEE 802.1D-1990: Section 4.5.3.4"
  328. ::= { dot1dStp 8 }
  329. dot1dStpHelloTime OBJECT-TYPE
  330. SYNTAX Timeout
  331. ACCESS read-only
  332. STATUS mandatory
  333. DESCRIPTION
  334. "The amount of time between the transmission of
  335. Configuration bridge PDUs by this node on any port
  336. when it is the root of the spanning tree or trying
  337. to become so, in units of hundredths of a second.
  338. This is the actual value that this bridge is
  339. currently using."
  340. REFERENCE
  341. "IEEE 802.1D-1990: Section 4.5.3.5"
  342. ::= { dot1dStp 9 }
  343. dot1dStpHoldTime OBJECT-TYPE
  344. SYNTAX INTEGER
  345. ACCESS read-only
  346. STATUS mandatory
  347. DESCRIPTION
  348. "This time value determines the interval length
  349. during which no more than two Configuration bridge
  350. PDUs shall be transmitted by this node, in units
  351. of hundredths of a second."
  352. REFERENCE
  353. "IEEE 802.1D-1990: Section 4.5.3.14"
  354. ::= { dot1dStp 10 }
  355. dot1dStpForwardDelay OBJECT-TYPE
  356. SYNTAX Timeout
  357. ACCESS read-only
  358. STATUS mandatory
  359. DESCRIPTION
  360. "This time value, measured in units of hundredths
  361. of a second, controls how fast a port changes its
  362. spanning state when moving towards the Forwarding
  363. state. The value determines how long the port
  364. stays in each of the Listening and Learning
  365. states, which precede the Forwarding state. This
  366. value is also used, when a topology change has
  367. been detected and is underway, to age all dynamic
  368. entries in the Forwarding Database. [Note that
  369. this value is the one that this bridge is
  370. currently using, in contrast to
  371. dot1dStpBridgeForwardDelay which is the value that
  372. this bridge and all others would start using
  373. if/when this bridge were to become the root.]"
  374. REFERENCE
  375. "IEEE 802.1D-1990: Section 4.5.3.6"
  376. ::= { dot1dStp 11 }
  377. dot1dStpBridgeMaxAge OBJECT-TYPE
  378. SYNTAX Timeout (600..4000)
  379. ACCESS read-write
  380. STATUS mandatory
  381. DESCRIPTION
  382. "The value that all bridges use for MaxAge when
  383. this bridge is acting as the root. Note that
  384. 802.1D-1990 specifies that the range for this
  385. parameter is related to the value of
  386. dot1dStpBridgeHelloTime. The granularity of this
  387. timer is specified by 802.1D-1990 to be 1 second.
  388. An agent may return a badValue error if a set is
  389. attempted to a value which is not a whole number
  390. of seconds."
  391. REFERENCE
  392. "IEEE 802.1D-1990: Section 4.5.3.8"
  393. ::= { dot1dStp 12 }
  394. dot1dStpBridgeHelloTime OBJECT-TYPE
  395. SYNTAX Timeout (100..1000)
  396. ACCESS read-write
  397. STATUS mandatory
  398. DESCRIPTION
  399. "The value that all bridges use for HelloTime when
  400. this bridge is acting as the root. The
  401. granularity of this timer is specified by 802.1D-
  402. 1990 to be 1 second. An agent may return a
  403. badValue error if a set is attempted to a value
  404. which is not a whole number of seconds."
  405. REFERENCE
  406. "IEEE 802.1D-1990: Section 4.5.3.9"
  407. ::= { dot1dStp 13 }
  408. dot1dStpBridgeForwardDelay OBJECT-TYPE
  409. SYNTAX Timeout (400..3000)
  410. ACCESS read-write
  411. STATUS mandatory
  412. DESCRIPTION
  413. "The value that all bridges use for ForwardDelay
  414. when this bridge is acting as the root. Note that
  415. 802.1D-1990 specifies that the range for this
  416. parameter is related to the value of
  417. dot1dStpBridgeMaxAge. The granularity of this
  418. timer is specified by 802.1D-1990 to be 1 second.
  419. An agent may return a badValue error if a set is
  420. attempted to a value which is not a whole number
  421. of seconds."
  422. REFERENCE
  423. "IEEE 802.1D-1990: Section 4.5.3.10"
  424. ::= { dot1dStp 14 }
  425. -- The Spanning Tree Port Table
  426. dot1dStpPortTable OBJECT-TYPE
  427. SYNTAX SEQUENCE OF Dot1dStpPortEntry
  428. ACCESS not-accessible
  429. STATUS mandatory
  430. DESCRIPTION
  431. "A table that contains port-specific information
  432. for the Spanning Tree Protocol."
  433. ::= { dot1dStp 15 }
  434. dot1dStpPortEntry OBJECT-TYPE
  435. SYNTAX Dot1dStpPortEntry
  436. ACCESS not-accessible
  437. STATUS mandatory
  438. DESCRIPTION
  439. "A list of information maintained by every port
  440. about the Spanning Tree Protocol state for that
  441. port."
  442. INDEX { dot1dStpPort }
  443. ::= { dot1dStpPortTable 1 }
  444. Dot1dStpPortEntry ::=
  445. SEQUENCE {
  446. dot1dStpPort
  447. INTEGER,
  448. dot1dStpPortPriority
  449. INTEGER,
  450. dot1dStpPortState
  451. INTEGER,
  452. dot1dStpPortEnable
  453. INTEGER,
  454. dot1dStpPortPathCost
  455. INTEGER,
  456. dot1dStpPortDesignatedRoot
  457. BridgeId,
  458. dot1dStpPortDesignatedCost
  459. INTEGER,
  460. dot1dStpPortDesignatedBridge
  461. BridgeId,
  462. dot1dStpPortDesignatedPort
  463. OCTET STRING,
  464. dot1dStpPortForwardTransitions
  465. Counter
  466. }
  467. dot1dStpPort OBJECT-TYPE
  468. SYNTAX INTEGER (1..65535)
  469. ACCESS read-only
  470. STATUS mandatory
  471. DESCRIPTION
  472. "The port number of the port for which this entry
  473. contains Spanning Tree Protocol management
  474. information."
  475. REFERENCE
  476. "IEEE 802.1D-1990: Section 6.8.2.1.2"
  477. ::= { dot1dStpPortEntry 1 }
  478. dot1dStpPortPriority OBJECT-TYPE
  479. SYNTAX INTEGER (0..255)
  480. ACCESS read-write
  481. STATUS mandatory
  482. DESCRIPTION
  483. "The value of the priority field which is
  484. contained in the first (in network byte order)
  485. octet of the (2 octet long) Port ID. The other
  486. octet of the Port ID is given by the value of
  487. dot1dStpPort."
  488. REFERENCE
  489. "IEEE 802.1D-1990: Section 4.5.5.1"
  490. ::= { dot1dStpPortEntry 2 }
  491. dot1dStpPortState OBJECT-TYPE
  492. SYNTAX INTEGER {
  493. disabled(1),
  494. blocking(2),
  495. listening(3),
  496. learning(4),
  497. forwarding(5),
  498. broken(6)
  499. }
  500. ACCESS read-only
  501. STATUS mandatory
  502. DESCRIPTION
  503. "The port's current state as defined by
  504. application of the Spanning Tree Protocol. This
  505. state controls what action a port takes on
  506. reception of a frame. If the bridge has detected
  507. a port that is malfunctioning it will place that
  508. port into the broken(6) state. For ports which
  509. are disabled (see dot1dStpPortEnable), this object
  510. will have a value of disabled(1)."
  511. REFERENCE
  512. "IEEE 802.1D-1990: Section 4.5.5.2"
  513. ::= { dot1dStpPortEntry 3 }
  514. dot1dStpPortEnable OBJECT-TYPE
  515. SYNTAX INTEGER {
  516. enabled(1),
  517. disabled(2)
  518. }
  519. ACCESS read-write
  520. STATUS mandatory
  521. DESCRIPTION
  522. "The enabled/disabled status of the port."
  523. REFERENCE
  524. "IEEE 802.1D-1990: Section 4.5.5.2"
  525. ::= { dot1dStpPortEntry 4 }
  526. dot1dStpPortPathCost OBJECT-TYPE
  527. SYNTAX INTEGER (1..65535)
  528. ACCESS read-write
  529. STATUS mandatory
  530. DESCRIPTION
  531. "The contribution of this port to the path cost of
  532. paths towards the spanning tree root which include
  533. this port. 802.1D-1990 recommends that the
  534. default value of this parameter be in inverse
  535. proportion to the speed of the attached LAN."
  536. REFERENCE
  537. "IEEE 802.1D-1990: Section 4.5.5.3"
  538. ::= { dot1dStpPortEntry 5 }
  539. dot1dStpPortDesignatedRoot OBJECT-TYPE
  540. SYNTAX BridgeId
  541. ACCESS read-only
  542. STATUS mandatory
  543. DESCRIPTION
  544. "The unique Bridge Identifier of the Bridge
  545. recorded as the Root in the Configuration BPDUs
  546. transmitted by the Designated Bridge for the
  547. segment to which the port is attached."
  548. REFERENCE
  549. "IEEE 802.1D-1990: Section 4.5.5.4"
  550. ::= { dot1dStpPortEntry 6 }
  551. dot1dStpPortDesignatedCost OBJECT-TYPE
  552. SYNTAX INTEGER
  553. ACCESS read-only
  554. STATUS mandatory
  555. DESCRIPTION
  556. "The path cost of the Designated Port of the
  557. segment connected to this port. This value is
  558. compared to the Root Path Cost field in received
  559. bridge PDUs."
  560. REFERENCE
  561. "IEEE 802.1D-1990: Section 4.5.5.5"
  562. ::= { dot1dStpPortEntry 7 }
  563. dot1dStpPortDesignatedBridge OBJECT-TYPE
  564. SYNTAX BridgeId
  565. ACCESS read-only
  566. STATUS mandatory
  567. DESCRIPTION
  568. "The Bridge Identifier of the bridge which this
  569. port considers to be the Designated Bridge for
  570. this port's segment."
  571. REFERENCE
  572. "IEEE 802.1D-1990: Section 4.5.5.6"
  573. ::= { dot1dStpPortEntry 8 }
  574. dot1dStpPortDesignatedPort OBJECT-TYPE
  575. SYNTAX OCTET STRING (SIZE (2))
  576. ACCESS read-only
  577. STATUS mandatory
  578. DESCRIPTION
  579. "The Port Identifier of the port on the Designated
  580. Bridge for this port's segment."
  581. REFERENCE
  582. "IEEE 802.1D-1990: Section 4.5.5.7"
  583. ::= { dot1dStpPortEntry 9 }
  584. dot1dStpPortForwardTransitions OBJECT-TYPE
  585. SYNTAX Counter
  586. ACCESS read-only
  587. STATUS mandatory
  588. DESCRIPTION
  589. "The number of times this port has transitioned
  590. from the Learning state to the Forwarding state."
  591. ::= { dot1dStpPortEntry 10 }
  592. -- the dot1dTp group
  593. -- Implementation of the dot1dTp group is optional. It is
  594. -- implemented by those bridges that support the transparent
  595. -- bridging mode. A transparent or SRT bridge will implement
  596. -- this group.
  597. dot1dTpLearnedEntryDiscards OBJECT-TYPE
  598. SYNTAX Counter
  599. ACCESS read-only
  600. STATUS mandatory
  601. DESCRIPTION
  602. "The total number of Forwarding Database entries,
  603. which have been or would have been learnt, but
  604. have been discarded due to a lack of space to
  605. store them in the Forwarding Database. If this
  606. counter is increasing, it indicates that the
  607. Forwarding Database is regularly becoming full (a
  608. condition which has unpleasant performance effects
  609. on the subnetwork). If this counter has a
  610. significant value but is not presently increasing,
  611. it indicates that the problem has been occurring
  612. but is not persistent."
  613. REFERENCE
  614. "IEEE 802.1D-1990: Section 6.7.1.1.3"
  615. ::= { dot1dTp 1 }
  616. dot1dTpAgingTime OBJECT-TYPE
  617. SYNTAX INTEGER (10..1000000)
  618. ACCESS read-write
  619. STATUS mandatory
  620. DESCRIPTION
  621. "The timeout period in seconds for aging out
  622. dynamically learned forwarding information.
  623. 802.1D-1990 recommends a default of 300 seconds."
  624. REFERENCE
  625. "IEEE 802.1D-1990: Section 6.7.1.1.3"
  626. ::= { dot1dTp 2 }
  627. -- The Forwarding Database for Transparent Bridges
  628. dot1dTpFdbTable OBJECT-TYPE
  629. SYNTAX SEQUENCE OF Dot1dTpFdbEntry
  630. ACCESS not-accessible
  631. STATUS mandatory
  632. DESCRIPTION
  633. "A table that contains information about unicast
  634. entries for which the bridge has forwarding and/or
  635. filtering information. This information is used
  636. by the transparent bridging function in
  637. determining how to propagate a received frame."
  638. ::= { dot1dTp 3 }
  639. dot1dTpFdbEntry OBJECT-TYPE
  640. SYNTAX Dot1dTpFdbEntry
  641. ACCESS not-accessible
  642. STATUS mandatory
  643. DESCRIPTION
  644. "Information about a specific unicast MAC address
  645. for which the bridge has some forwarding and/or
  646. filtering information."
  647. INDEX { dot1dTpFdbAddress }
  648. ::= { dot1dTpFdbTable 1 }
  649. Dot1dTpFdbEntry ::=
  650. SEQUENCE {
  651. dot1dTpFdbAddress
  652. MacAddress,
  653. dot1dTpFdbPort
  654. INTEGER,
  655. dot1dTpFdbStatus
  656. INTEGER
  657. }
  658. dot1dTpFdbAddress OBJECT-TYPE
  659. SYNTAX MacAddress
  660. ACCESS read-only
  661. STATUS mandatory
  662. DESCRIPTION
  663. "A unicast MAC address for which the bridge has
  664. forwarding and/or filtering information."
  665. REFERENCE
  666. "IEEE 802.1D-1990: Section 3.9.1, 3.9.2"
  667. ::= { dot1dTpFdbEntry 1 }
  668. dot1dTpFdbPort OBJECT-TYPE
  669. SYNTAX INTEGER
  670. ACCESS read-only
  671. STATUS mandatory
  672. DESCRIPTION
  673. "Either the value '0', or the port number of the
  674. port on which a frame having a source address
  675. equal to the value of the corresponding instance
  676. of dot1dTpFdbAddress has been seen. A value of
  677. '0' indicates that the port number has not been
  678. learned but that the bridge does have some
  679. forwarding/filtering information about this
  680. address (e.g. in the dot1dStaticTable).
  681. Implementors are encouraged to assign the port
  682. value to this object whenever it is learned even
  683. for addresses for which the corresponding value of
  684. dot1dTpFdbStatus is not learned(3)."
  685. ::= { dot1dTpFdbEntry 2 }
  686. dot1dTpFdbStatus OBJECT-TYPE
  687. SYNTAX INTEGER {
  688. other(1),
  689. invalid(2),
  690. learned(3),
  691. self(4),
  692. mgmt(5)
  693. }
  694. ACCESS read-only
  695. STATUS mandatory
  696. DESCRIPTION
  697. "The status of this entry. The meanings of the
  698. values are:
  699. other(1) : none of the following. This would
  700. include the case where some other
  701. MIB object (not the corresponding
  702. instance of dot1dTpFdbPort, nor an
  703. entry in the dot1dStaticTable) is
  704. being used to determine if and how
  705. frames addressed to the value of
  706. the corresponding instance of
  707. dot1dTpFdbAddress are being
  708. forwarded.
  709. invalid(2) : this entry is not longer valid
  710. (e.g., it was learned but has since
  711. aged-out), but has not yet been
  712. flushed from the table.
  713. learned(3) : the value of the corresponding
  714. instance of dot1dTpFdbPort was
  715. learned, and is being used.
  716. self(4) : the value of the corresponding
  717. instance of dot1dTpFdbAddress
  718. represents one of the bridge's
  719. addresses. The corresponding
  720. instance of dot1dTpFdbPort
  721. indicates which of the bridge's
  722. ports has this address.
  723. mgmt(5) : the value of the corresponding
  724. instance of dot1dTpFdbAddress is
  725. also the value of an existing
  726. instance of dot1dStaticAddress."
  727. ::= { dot1dTpFdbEntry 3 }
  728. -- Port Table for Transparent Bridges
  729. dot1dTpPortTable OBJECT-TYPE
  730. SYNTAX SEQUENCE OF Dot1dTpPortEntry
  731. ACCESS not-accessible
  732. STATUS mandatory
  733. DESCRIPTION
  734. "A table that contains information about every
  735. port that is associated with this transparent
  736. bridge."
  737. ::= { dot1dTp 4 }
  738. dot1dTpPortEntry OBJECT-TYPE
  739. SYNTAX Dot1dTpPortEntry
  740. ACCESS not-accessible
  741. STATUS mandatory
  742. DESCRIPTION
  743. "A list of information for each port of a
  744. transparent bridge."
  745. INDEX { dot1dTpPort }
  746. ::= { dot1dTpPortTable 1 }
  747. Dot1dTpPortEntry ::=
  748. SEQUENCE {
  749. dot1dTpPort
  750. INTEGER,
  751. dot1dTpPortMaxInfo
  752. INTEGER,
  753. dot1dTpPortInFrames
  754. Counter,
  755. dot1dTpPortOutFrames
  756. Counter,
  757. dot1dTpPortInDiscards
  758. Counter
  759. }
  760. dot1dTpPort OBJECT-TYPE
  761. SYNTAX INTEGER (1..65535)
  762. ACCESS read-only
  763. STATUS mandatory
  764. DESCRIPTION
  765. "The port number of the port for which this entry
  766. contains Transparent bridging management
  767. information."
  768. ::= { dot1dTpPortEntry 1 }
  769. -- It would be nice if we could use ifMtu as the size of the
  770. -- largest INFO field, but we can't because ifMtu is defined
  771. -- to be the size that the (inter-)network layer can use which
  772. -- can differ from the MAC layer (especially if several layers
  773. -- of encapsulation are used).
  774. dot1dTpPortMaxInfo OBJECT-TYPE
  775. SYNTAX INTEGER
  776. ACCESS read-only
  777. STATUS mandatory
  778. DESCRIPTION
  779. "The maximum size of the INFO (non-MAC) field that
  780. this port will receive or transmit."
  781. ::= { dot1dTpPortEntry 2 }
  782. dot1dTpPortInFrames OBJECT-TYPE
  783. SYNTAX Counter
  784. ACCESS read-only
  785. STATUS mandatory
  786. DESCRIPTION
  787. "The number of frames that have been received by
  788. this port from its segment. Note that a frame
  789. received on the interface corresponding to this
  790. port is only counted by this object if and only if
  791. it is for a protocol being processed by the local
  792. bridging function, including bridge management
  793. frames."
  794. REFERENCE
  795. "IEEE 802.1D-1990: Section 6.6.1.1.3"
  796. ::= { dot1dTpPortEntry 3 }
  797. dot1dTpPortOutFrames OBJECT-TYPE
  798. SYNTAX Counter
  799. ACCESS read-only
  800. STATUS mandatory
  801. DESCRIPTION
  802. "The number of frames that have been transmitted
  803. by this port to its segment. Note that a frame
  804. transmitted on the interface corresponding to this
  805. port is only counted by this object if and only if
  806. it is for a protocol being processed by the local
  807. bridging function, including bridge management
  808. frames."
  809. REFERENCE
  810. "IEEE 802.1D-1990: Section 6.6.1.1.3"
  811. ::= { dot1dTpPortEntry 4 }
  812. dot1dTpPortInDiscards OBJECT-TYPE
  813. SYNTAX Counter
  814. ACCESS read-only
  815. STATUS mandatory
  816. DESCRIPTION
  817. "Count of valid frames received which were
  818. discarded (i.e., filtered) by the Forwarding
  819. Process."
  820. REFERENCE
  821. "IEEE 802.1D-1990: Section 6.6.1.1.3"
  822. ::= { dot1dTpPortEntry 5 }
  823. -- The Static (Destination-Address Filtering) Database
  824. -- Implementation of this group is optional.
  825. dot1dStaticTable OBJECT-TYPE
  826. SYNTAX SEQUENCE OF Dot1dStaticEntry
  827. ACCESS not-accessible
  828. STATUS mandatory
  829. DESCRIPTION
  830. "A table containing filtering information
  831. configured into the bridge by (local or network)
  832. management specifying the set of ports to which
  833. frames received from specific ports and containing
  834. specific destination addresses are allowed to be
  835. forwarded. The value of zero in this table as the
  836. port number from which frames with a specific
  837. destination address are received, is used to
  838. specify all ports for which there is no specific
  839. entry in this table for that particular
  840. destination address. Entries are valid for
  841. unicast and for group/broadcast addresses."
  842. REFERENCE
  843. "IEEE 802.1D-1990: Section 6.7.2"
  844. ::= { dot1dStatic 1 }
  845. dot1dStaticEntry OBJECT-TYPE
  846. SYNTAX Dot1dStaticEntry
  847. ACCESS not-accessible
  848. STATUS mandatory
  849. DESCRIPTION
  850. "Filtering information configured into the bridge
  851. by (local or network) management specifying the
  852. set of ports to which frames received from a
  853. specific port and containing a specific
  854. destination address are allowed to be forwarded."
  855. REFERENCE
  856. "IEEE 802.1D-1990: Section 6.7.2"
  857. INDEX { dot1dStaticAddress, dot1dStaticReceivePort }
  858. ::= { dot1dStaticTable 1 }
  859. Dot1dStaticEntry ::=
  860. SEQUENCE {
  861. dot1dStaticAddress
  862. MacAddress,
  863. dot1dStaticReceivePort
  864. INTEGER,
  865. dot1dStaticAllowedToGoTo
  866. OCTET STRING,
  867. dot1dStaticStatus
  868. INTEGER
  869. }
  870. dot1dStaticAddress OBJECT-TYPE
  871. SYNTAX MacAddress
  872. ACCESS read-write
  873. STATUS mandatory
  874. DESCRIPTION
  875. "The destination MAC address in a frame to which
  876. this entry's filtering information applies. This
  877. object can take the value of a unicast address, a
  878. group address or the broadcast address."
  879. REFERENCE
  880. "IEEE 802.1D-1990: Section 3.9.1, 3.9.2"
  881. ::= { dot1dStaticEntry 1 }
  882. dot1dStaticReceivePort OBJECT-TYPE
  883. SYNTAX INTEGER
  884. ACCESS read-write
  885. STATUS mandatory
  886. DESCRIPTION
  887. "Either the value '0', or the port number of the
  888. port from which a frame must be received in order
  889. for this entry's filtering information to apply.
  890. A value of zero indicates that this entry applies
  891. on all ports of the bridge for which there is no
  892. other applicable entry."
  893. ::= { dot1dStaticEntry 2 }
  894. dot1dStaticAllowedToGoTo OBJECT-TYPE
  895. SYNTAX OCTET STRING
  896. ACCESS read-write
  897. STATUS mandatory
  898. DESCRIPTION
  899. "The set of ports to which frames received from a
  900. specific port and destined for a specific MAC
  901. address, are allowed to be forwarded. Each octet
  902. within the value of this object specifies a set of
  903. eight ports, with the first octet specifying ports
  904. 1 through 8, the second octet specifying ports 9
  905. through 16, etc. Within each octet, the most
  906. significant bit represents the lowest numbered
  907. port, and the least significant bit represents the
  908. highest numbered port. Thus, each port of the
  909. bridge is represented by a single bit within the
  910. value of this object. If that bit has a value of
  911. '1' then that port is included in the set of
  912. ports; the port is not included if its bit has a
  913. value of '0'. (Note that the setting of the bit
  914. corresponding to the port from which a frame is
  915. received is irrelevant.) The default value of
  916. this object is a string of ones of appropriate
  917. length."
  918. ::= { dot1dStaticEntry 3 }
  919. dot1dStaticStatus OBJECT-TYPE
  920. SYNTAX INTEGER {
  921. other(1),
  922. invalid(2),
  923. permanent(3),
  924. deleteOnReset(4),
  925. deleteOnTimeout(5)
  926. }
  927. ACCESS read-write
  928. STATUS mandatory
  929. DESCRIPTION
  930. "This object indicates the status of this entry.
  931. The default value is permanent(3).
  932. other(1) - this entry is currently in use but
  933. the conditions under which it will
  934. remain so are different from each of the
  935. following values.
  936. invalid(2) - writing this value to the object
  937. removes the corresponding entry.
  938. permanent(3) - this entry is currently in use
  939. and will remain so after the next reset
  940. of the bridge.
  941. deleteOnReset(4) - this entry is currently in
  942. use and will remain so until the next
  943. reset of the bridge.
  944. deleteOnTimeout(5) - this entry is currently
  945. in use and will remain so until it is
  946. aged out."
  947. ::= { dot1dStaticEntry 4 }
  948. -- Traps for use by Bridges
  949. -- Traps for the Spanning Tree Protocol
  950. newRoot TRAP-TYPE
  951. ENTERPRISE dot1dBridge
  952. DESCRIPTION
  953. "The newRoot trap indicates that the sending agent
  954. has become the new root of the Spanning Tree; the
  955. trap is sent by a bridge soon after its election
  956. as the new root, e.g., upon expiration of the
  957. Topology Change Timer immediately subsequent to
  958. its election. Implementation of this trap is
  959. optional."
  960. ::= 1
  961. topologyChange TRAP-TYPE
  962. ENTERPRISE dot1dBridge
  963. DESCRIPTION
  964. "A topologyChange trap is sent by a bridge when
  965. any of its configured ports transitions from the
  966. Learning state to the Forwarding state, or from
  967. the Forwarding state to the Blocking state. The
  968. trap is not sent if a newRoot trap is sent for the
  969. same transition. Implementation of this trap is
  970. optional."
  971. ::= 2
  972. END