telemetry-snmp 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (131) hide show
  1. checksums.yaml +7 -0
  2. data/.github/workflows/rspec.yml +44 -0
  3. data/.github/workflows/rubocop.yml +28 -0
  4. data/.github/workflows/sourcehawk-scan.yml +20 -0
  5. data/.gitignore +14 -0
  6. data/.rspec +4 -0
  7. data/.rubocop.yml +26 -0
  8. data/CHANGELOG.md +4 -0
  9. data/CODE_OF_CONDUCT.md +75 -0
  10. data/CONTRIBUTING.md +54 -0
  11. data/Gemfile +10 -0
  12. data/INDIVIDUAL_CONTRIBUTOR_LICENSE.md +30 -0
  13. data/LICENSE +201 -0
  14. data/NOTICE.txt +9 -0
  15. data/README.md +54 -0
  16. data/attribution.txt +1 -0
  17. data/config.ru +15 -0
  18. data/exe/snmp_collector +55 -0
  19. data/lib/telemetry/snmp.rb +23 -0
  20. data/lib/telemetry/snmp/api.rb +55 -0
  21. data/lib/telemetry/snmp/auth.rb +54 -0
  22. data/lib/telemetry/snmp/auth/defaults.rb +41 -0
  23. data/lib/telemetry/snmp/client.rb +104 -0
  24. data/lib/telemetry/snmp/controllers/device_creds.rb +105 -0
  25. data/lib/telemetry/snmp/controllers/devices.rb +94 -0
  26. data/lib/telemetry/snmp/controllers/oid_groups.rb +71 -0
  27. data/lib/telemetry/snmp/controllers/oids.rb +80 -0
  28. data/lib/telemetry/snmp/controllers/users.rb +81 -0
  29. data/lib/telemetry/snmp/controllers/walks.rb +89 -0
  30. data/lib/telemetry/snmp/data.rb +69 -0
  31. data/lib/telemetry/snmp/data/default_opts.rb +73 -0
  32. data/lib/telemetry/snmp/data/migrations/001_device_creds.rb +19 -0
  33. data/lib/telemetry/snmp/data/migrations/002_create_devices_table.rb +31 -0
  34. data/lib/telemetry/snmp/data/migrations/003_create_oids_tables.rb +16 -0
  35. data/lib/telemetry/snmp/data/migrations/004_create_oid_groups.rb +15 -0
  36. data/lib/telemetry/snmp/data/migrations/005_create_oids_oid_groups.rb +17 -0
  37. data/lib/telemetry/snmp/data/migrations/006_device_to_oid_group.rb +15 -0
  38. data/lib/telemetry/snmp/data/migrations/007_create_users.rb +20 -0
  39. data/lib/telemetry/snmp/data/migrations/008_create_walks_table.rb +14 -0
  40. data/lib/telemetry/snmp/data/migrations/009_create_tag_name_column.rb +7 -0
  41. data/lib/telemetry/snmp/data/migrations/010_create_user_audit_table.rb +18 -0
  42. data/lib/telemetry/snmp/data/models/device.rb +11 -0
  43. data/lib/telemetry/snmp/data/models/device_cred.rb +11 -0
  44. data/lib/telemetry/snmp/data/models/oid.rb +10 -0
  45. data/lib/telemetry/snmp/data/models/oid_group.rb +10 -0
  46. data/lib/telemetry/snmp/data/models/oid_oid_groups.rb +10 -0
  47. data/lib/telemetry/snmp/data/models/oid_walk.rb +10 -0
  48. data/lib/telemetry/snmp/data/models/user.rb +10 -0
  49. data/lib/telemetry/snmp/data/models/user_audit_log.rb +19 -0
  50. data/lib/telemetry/snmp/mibs/AGENTX-MIB.txt +527 -0
  51. data/lib/telemetry/snmp/mibs/AIRPORT-BASESTATION-3-MIB.txt +461 -0
  52. data/lib/telemetry/snmp/mibs/BRIDGE-MIB.txt +1472 -0
  53. data/lib/telemetry/snmp/mibs/DISMAN-EVENT-MIB.txt +1882 -0
  54. data/lib/telemetry/snmp/mibs/DISMAN-SCHEDULE-MIB.txt +699 -0
  55. data/lib/telemetry/snmp/mibs/DISMAN-SCRIPT-MIB.txt +1764 -0
  56. data/lib/telemetry/snmp/mibs/EtherLike-MIB.txt +1862 -0
  57. data/lib/telemetry/snmp/mibs/HCNUM-TC.txt +118 -0
  58. data/lib/telemetry/snmp/mibs/HOST-RESOURCES-MIB.txt +1540 -0
  59. data/lib/telemetry/snmp/mibs/HOST-RESOURCES-TYPES.txt +389 -0
  60. data/lib/telemetry/snmp/mibs/IANA-ADDRESS-FAMILY-NUMBERS-MIB.txt +123 -0
  61. data/lib/telemetry/snmp/mibs/IANA-LANGUAGE-MIB.txt +123 -0
  62. data/lib/telemetry/snmp/mibs/IANA-RTPROTO-MIB.txt +91 -0
  63. data/lib/telemetry/snmp/mibs/IANAifType-MIB.txt +619 -0
  64. data/lib/telemetry/snmp/mibs/IF-INVERTED-STACK-MIB.txt +149 -0
  65. data/lib/telemetry/snmp/mibs/IF-MIB.txt +1814 -0
  66. data/lib/telemetry/snmp/mibs/INET-ADDRESS-MIB.txt +402 -0
  67. data/lib/telemetry/snmp/mibs/IP-FORWARD-MIB.txt +1277 -0
  68. data/lib/telemetry/snmp/mibs/IP-MIB.txt +4993 -0
  69. data/lib/telemetry/snmp/mibs/IPV6-FLOW-LABEL-MIB.txt +58 -0
  70. data/lib/telemetry/snmp/mibs/IPV6-ICMP-MIB.txt +529 -0
  71. data/lib/telemetry/snmp/mibs/IPV6-MIB.txt +1443 -0
  72. data/lib/telemetry/snmp/mibs/IPV6-TC.txt +67 -0
  73. data/lib/telemetry/snmp/mibs/IPV6-TCP-MIB.txt +211 -0
  74. data/lib/telemetry/snmp/mibs/IPV6-UDP-MIB.txt +141 -0
  75. data/lib/telemetry/snmp/mibs/NET-SNMP-AGENT-MIB.txt +554 -0
  76. data/lib/telemetry/snmp/mibs/NET-SNMP-EXAMPLES-MIB.txt +285 -0
  77. data/lib/telemetry/snmp/mibs/NET-SNMP-EXTEND-MIB.txt +325 -0
  78. data/lib/telemetry/snmp/mibs/NET-SNMP-MIB.txt +67 -0
  79. data/lib/telemetry/snmp/mibs/NET-SNMP-PASS-MIB.txt +124 -0
  80. data/lib/telemetry/snmp/mibs/NET-SNMP-TC.txt +128 -0
  81. data/lib/telemetry/snmp/mibs/NET-SNMP-VACM-MIB.txt +154 -0
  82. data/lib/telemetry/snmp/mibs/NOTIFICATION-LOG-MIB.txt +753 -0
  83. data/lib/telemetry/snmp/mibs/PAN-COMMON-MIB.md5 +1 -0
  84. data/lib/telemetry/snmp/mibs/PAN-COMMON-MIB.my +2293 -0
  85. data/lib/telemetry/snmp/mibs/PAN-ENTITY-EXT-MIB.md5 +1 -0
  86. data/lib/telemetry/snmp/mibs/PAN-ENTITY-EXT-MIB.my +293 -0
  87. data/lib/telemetry/snmp/mibs/PAN-GLOBAL-REG-MIB.md5 +1 -0
  88. data/lib/telemetry/snmp/mibs/PAN-GLOBAL-REG-MIB.my +84 -0
  89. data/lib/telemetry/snmp/mibs/PAN-GLOBAL-TC-MIB.md5 +1 -0
  90. data/lib/telemetry/snmp/mibs/PAN-GLOBAL-TC-MIB.my +68 -0
  91. data/lib/telemetry/snmp/mibs/PAN-LC-MIB.md5 +1 -0
  92. data/lib/telemetry/snmp/mibs/PAN-LC-MIB.my +204 -0
  93. data/lib/telemetry/snmp/mibs/PAN-PRODUCT-MIB.md5 +1 -0
  94. data/lib/telemetry/snmp/mibs/PAN-PRODUCT-MIB.my +305 -0
  95. data/lib/telemetry/snmp/mibs/PAN-TRAPS.md5 +1 -0
  96. data/lib/telemetry/snmp/mibs/PAN-TRAPS.my +7809 -0
  97. data/lib/telemetry/snmp/mibs/RFC-1215.txt +38 -0
  98. data/lib/telemetry/snmp/mibs/RFC1155-SMI.txt +119 -0
  99. data/lib/telemetry/snmp/mibs/RFC1213-MIB.txt +2613 -0
  100. data/lib/telemetry/snmp/mibs/RMON-MIB.txt +3980 -0
  101. data/lib/telemetry/snmp/mibs/SCTP-MIB.txt +1342 -0
  102. data/lib/telemetry/snmp/mibs/SMUX-MIB.txt +160 -0
  103. data/lib/telemetry/snmp/mibs/SNMP-COMMUNITY-MIB.txt +429 -0
  104. data/lib/telemetry/snmp/mibs/SNMP-FRAMEWORK-MIB.txt +526 -0
  105. data/lib/telemetry/snmp/mibs/SNMP-MPD-MIB.txt +145 -0
  106. data/lib/telemetry/snmp/mibs/SNMP-NOTIFICATION-MIB.txt +589 -0
  107. data/lib/telemetry/snmp/mibs/SNMP-PROXY-MIB.txt +294 -0
  108. data/lib/telemetry/snmp/mibs/SNMP-TARGET-MIB.txt +660 -0
  109. data/lib/telemetry/snmp/mibs/SNMP-USER-BASED-SM-MIB.txt +912 -0
  110. data/lib/telemetry/snmp/mibs/SNMP-USM-AES-MIB.txt +62 -0
  111. data/lib/telemetry/snmp/mibs/SNMP-USM-DH-OBJECTS-MIB.txt +532 -0
  112. data/lib/telemetry/snmp/mibs/SNMP-VIEW-BASED-ACM-MIB.txt +830 -0
  113. data/lib/telemetry/snmp/mibs/SNMPv2-CONF.txt +322 -0
  114. data/lib/telemetry/snmp/mibs/SNMPv2-MIB.txt +854 -0
  115. data/lib/telemetry/snmp/mibs/SNMPv2-SMI.txt +344 -0
  116. data/lib/telemetry/snmp/mibs/SNMPv2-TC.txt +772 -0
  117. data/lib/telemetry/snmp/mibs/SNMPv2-TM.txt +176 -0
  118. data/lib/telemetry/snmp/mibs/TCP-MIB.txt +785 -0
  119. data/lib/telemetry/snmp/mibs/TRANSPORT-ADDRESS-MIB.txt +421 -0
  120. data/lib/telemetry/snmp/mibs/TUNNEL-MIB.txt +738 -0
  121. data/lib/telemetry/snmp/mibs/UCD-DEMO-MIB.txt +74 -0
  122. data/lib/telemetry/snmp/mibs/UCD-DISKIO-MIB.txt +171 -0
  123. data/lib/telemetry/snmp/mibs/UCD-DLMOD-MIB.txt +124 -0
  124. data/lib/telemetry/snmp/mibs/UCD-IPFWACC-MIB.txt +327 -0
  125. data/lib/telemetry/snmp/mibs/UCD-SNMP-MIB.txt +1712 -0
  126. data/lib/telemetry/snmp/mibs/UDP-MIB.txt +549 -0
  127. data/lib/telemetry/snmp/publisher.rb +130 -0
  128. data/lib/telemetry/snmp/version.rb +7 -0
  129. data/sourcehawk.yml +4 -0
  130. data/telemetry-snmp.gemspec +48 -0
  131. metadata +456 -0
@@ -0,0 +1,1472 @@
1
+ BRIDGE-MIB DEFINITIONS ::= BEGIN
2
+
3
+ -- ---------------------------------------------------------- --
4
+ -- MIB for IEEE 802.1D devices
5
+ -- ---------------------------------------------------------- --
6
+ IMPORTS
7
+ MODULE-IDENTITY, OBJECT-TYPE, NOTIFICATION-TYPE,
8
+ Counter32, Integer32, TimeTicks, mib-2
9
+ FROM SNMPv2-SMI
10
+ TEXTUAL-CONVENTION, MacAddress
11
+ FROM SNMPv2-TC
12
+ MODULE-COMPLIANCE, OBJECT-GROUP, NOTIFICATION-GROUP
13
+ FROM SNMPv2-CONF
14
+ InterfaceIndex FROM IF-MIB
15
+ ;
16
+
17
+ dot1dBridge MODULE-IDENTITY
18
+ LAST-UPDATED "200509190000Z"
19
+ ORGANIZATION "IETF Bridge MIB Working Group"
20
+ CONTACT-INFO
21
+ "Email: bridge-mib@ietf.org
22
+
23
+ K.C. Norseth (Editor)
24
+ L-3 Communications
25
+ Tel: +1 801-594-2809
26
+ Email: kenyon.c.norseth@L-3com.com
27
+ Postal: 640 N. 2200 West.
28
+ Salt Lake City, Utah 84116-0850
29
+
30
+ Les Bell (Editor)
31
+ 3Com Europe Limited
32
+ Phone: +44 1442 438025
33
+ Email: elbell@ntlworld.com
34
+ Postal: 3Com Centre, Boundary Way
35
+ Hemel Hempstead
36
+ Herts. HP2 7YU
37
+ UK
38
+
39
+ Send comments to <bridge-mib@ietf.org>"
40
+ DESCRIPTION
41
+ "The Bridge MIB module for managing devices that support
42
+ IEEE 802.1D.
43
+
44
+ Copyright (C) The Internet Society (2005). This version of
45
+ this MIB module is part of RFC 4188; see the RFC itself for
46
+ full legal notices."
47
+ REVISION "200509190000Z"
48
+ DESCRIPTION
49
+ "Third revision, published as part of RFC 4188.
50
+
51
+ The MIB module has been converted to SMIv2 format.
52
+ Conformance statements have been added and some
53
+ description and reference clauses have been updated.
54
+
55
+ The object dot1dStpPortPathCost32 was added to
56
+ support IEEE 802.1t and the permissible values of
57
+ dot1dStpPriority and dot1dStpPortPriority have been
58
+ clarified for bridges supporting IEEE 802.1t or
59
+ IEEE 802.1w.
60
+
61
+ The interpretation of dot1dStpTimeSinceTopologyChange
62
+ has been clarified for bridges supporting the Rapid
63
+ Spanning Tree Protocol (RSTP)."
64
+ REVISION "199307310000Z"
65
+ DESCRIPTION
66
+ "Second revision, published as part of RFC 1493."
67
+ REVISION "199112310000Z"
68
+ DESCRIPTION
69
+ "Initial revision, published as part of RFC 1286."
70
+ ::= { mib-2 17 }
71
+
72
+ -- ---------------------------------------------------------- --
73
+ -- Textual Conventions
74
+ -- ---------------------------------------------------------- --
75
+
76
+ BridgeId ::= TEXTUAL-CONVENTION
77
+ STATUS current
78
+ DESCRIPTION
79
+ "The Bridge-Identifier, as used in the Spanning Tree
80
+ Protocol, to uniquely identify a bridge. Its first two
81
+ octets (in network byte order) contain a priority value,
82
+ and its last 6 octets contain the MAC address used to
83
+ refer to a bridge in a unique fashion (typically, the
84
+ numerically smallest MAC address of all ports on the
85
+ bridge)."
86
+ SYNTAX OCTET STRING (SIZE (8))
87
+
88
+ Timeout ::= TEXTUAL-CONVENTION
89
+ DISPLAY-HINT "d"
90
+ STATUS current
91
+ DESCRIPTION
92
+ "A Spanning Tree Protocol (STP) timer in units of 1/100
93
+ seconds. Several objects in this MIB module represent
94
+ values of timers used by the Spanning Tree Protocol.
95
+ In this MIB, these timers have values in units of
96
+ hundredths of a second (i.e., 1/100 secs).
97
+
98
+ These timers, when stored in a Spanning Tree Protocol's
99
+ BPDU, are in units of 1/256 seconds. Note, however, that
100
+ 802.1D-1998 specifies a settable granularity of no more
101
+ than one second for these timers. To avoid ambiguity,
102
+ a conversion algorithm is defined below for converting
103
+ between the different units, which ensures a timer's
104
+ value is not distorted by multiple conversions.
105
+
106
+ To convert a Timeout value into a value in units of
107
+ 1/256 seconds, the following algorithm should be used:
108
+
109
+ b = floor( (n * 256) / 100)
110
+
111
+ where:
112
+ floor = quotient [ignore remainder]
113
+ n is the value in 1/100 second units
114
+ b is the value in 1/256 second units
115
+
116
+ To convert the value from 1/256 second units back to
117
+ 1/100 seconds, the following algorithm should be used:
118
+
119
+ n = ceiling( (b * 100) / 256)
120
+
121
+ where:
122
+ ceiling = quotient [if remainder is 0], or
123
+ quotient + 1 [if remainder is nonzero]
124
+ n is the value in 1/100 second units
125
+
126
+ b is the value in 1/256 second units
127
+
128
+ Note: it is important that the arithmetic operations are
129
+ done in the order specified (i.e., multiply first,
130
+ divide second)."
131
+ SYNTAX Integer32
132
+
133
+ -- ---------------------------------------------------------- --
134
+ -- subtrees in the Bridge MIB
135
+ -- ---------------------------------------------------------- --
136
+
137
+ dot1dNotifications OBJECT IDENTIFIER ::= { dot1dBridge 0 }
138
+
139
+ dot1dBase OBJECT IDENTIFIER ::= { dot1dBridge 1 }
140
+ dot1dStp OBJECT IDENTIFIER ::= { dot1dBridge 2 }
141
+
142
+ dot1dSr OBJECT IDENTIFIER ::= { dot1dBridge 3 }
143
+ -- documented in RFC 1525
144
+
145
+ dot1dTp OBJECT IDENTIFIER ::= { dot1dBridge 4 }
146
+ dot1dStatic OBJECT IDENTIFIER ::= { dot1dBridge 5 }
147
+
148
+ -- Subtrees used by Bridge MIB Extensions:
149
+ -- pBridgeMIB MODULE-IDENTITY ::= { dot1dBridge 6 }
150
+ -- qBridgeMIB MODULE-IDENTITY ::= { dot1dBridge 7 }
151
+ -- Note that the practice of registering related MIB modules
152
+ -- below dot1dBridge has been discouraged since there is no
153
+ -- robust mechanism to track such registrations.
154
+
155
+ dot1dConformance OBJECT IDENTIFIER ::= { dot1dBridge 8 }
156
+
157
+ -- ---------------------------------------------------------- --
158
+ -- the dot1dBase subtree
159
+ -- ---------------------------------------------------------- --
160
+ -- Implementation of the dot1dBase subtree is mandatory for all
161
+ -- bridges.
162
+ -- ---------------------------------------------------------- --
163
+
164
+ dot1dBaseBridgeAddress OBJECT-TYPE
165
+ SYNTAX MacAddress
166
+ MAX-ACCESS read-only
167
+ STATUS current
168
+ DESCRIPTION
169
+ "The MAC address used by this bridge when it must be
170
+ referred to in a unique fashion. It is recommended
171
+ that this be the numerically smallest MAC address of
172
+ all ports that belong to this bridge. However, it is only
173
+
174
+ required to be unique. When concatenated with
175
+ dot1dStpPriority, a unique BridgeIdentifier is formed,
176
+ which is used in the Spanning Tree Protocol."
177
+ REFERENCE
178
+ "IEEE 802.1D-1998: clauses 14.4.1.1.3 and 7.12.5"
179
+ ::= { dot1dBase 1 }
180
+
181
+ dot1dBaseNumPorts OBJECT-TYPE
182
+ SYNTAX Integer32
183
+ UNITS "ports"
184
+ MAX-ACCESS read-only
185
+ STATUS current
186
+ DESCRIPTION
187
+ "The number of ports controlled by this bridging
188
+ entity."
189
+ REFERENCE
190
+ "IEEE 802.1D-1998: clause 14.4.1.1.3"
191
+ ::= { dot1dBase 2 }
192
+
193
+ dot1dBaseType OBJECT-TYPE
194
+ SYNTAX INTEGER {
195
+ unknown(1),
196
+ transparent-only(2),
197
+ sourceroute-only(3),
198
+ srt(4)
199
+ }
200
+ MAX-ACCESS read-only
201
+ STATUS current
202
+ DESCRIPTION
203
+ "Indicates what type of bridging this bridge can
204
+ perform. If a bridge is actually performing a
205
+ certain type of bridging, this will be indicated by
206
+ entries in the port table for the given type."
207
+ ::= { dot1dBase 3 }
208
+
209
+ -- ---------------------------------------------------------- --
210
+ -- The Generic Bridge Port Table
211
+ -- ---------------------------------------------------------- --
212
+ dot1dBasePortTable OBJECT-TYPE
213
+ SYNTAX SEQUENCE OF Dot1dBasePortEntry
214
+ MAX-ACCESS not-accessible
215
+ STATUS current
216
+ DESCRIPTION
217
+ "A table that contains generic information about every
218
+ port that is associated with this bridge. Transparent,
219
+ source-route, and srt ports are included."
220
+ ::= { dot1dBase 4 }
221
+
222
+ dot1dBasePortEntry OBJECT-TYPE
223
+ SYNTAX Dot1dBasePortEntry
224
+ MAX-ACCESS not-accessible
225
+ STATUS current
226
+ DESCRIPTION
227
+ "A list of information for each port of the bridge."
228
+ REFERENCE
229
+ "IEEE 802.1D-1998: clause 14.4.2, 14.6.1"
230
+ INDEX { dot1dBasePort }
231
+ ::= { dot1dBasePortTable 1 }
232
+
233
+ Dot1dBasePortEntry ::=
234
+ SEQUENCE {
235
+ dot1dBasePort
236
+ Integer32,
237
+ dot1dBasePortIfIndex
238
+ InterfaceIndex,
239
+ dot1dBasePortCircuit
240
+ OBJECT IDENTIFIER,
241
+ dot1dBasePortDelayExceededDiscards
242
+ Counter32,
243
+ dot1dBasePortMtuExceededDiscards
244
+ Counter32
245
+ }
246
+
247
+ dot1dBasePort OBJECT-TYPE
248
+ SYNTAX Integer32 (1..65535)
249
+ MAX-ACCESS read-only
250
+ STATUS current
251
+ DESCRIPTION
252
+ "The port number of the port for which this entry
253
+ contains bridge management information."
254
+ ::= { dot1dBasePortEntry 1 }
255
+
256
+ dot1dBasePortIfIndex OBJECT-TYPE
257
+ SYNTAX InterfaceIndex
258
+ MAX-ACCESS read-only
259
+ STATUS current
260
+ DESCRIPTION
261
+ "The value of the instance of the ifIndex object,
262
+ defined in IF-MIB, for the interface corresponding
263
+ to this port."
264
+ ::= { dot1dBasePortEntry 2 }
265
+
266
+ dot1dBasePortCircuit OBJECT-TYPE
267
+ SYNTAX OBJECT IDENTIFIER
268
+ MAX-ACCESS read-only
269
+ STATUS current
270
+ DESCRIPTION
271
+ "For a port that (potentially) has the same value of
272
+ dot1dBasePortIfIndex as another port on the same bridge.
273
+ This object contains the name of an object instance
274
+ unique to this port. For example, in the case where
275
+ multiple ports correspond one-to-one with multiple X.25
276
+ virtual circuits, this value might identify an (e.g.,
277
+ the first) object instance associated with the X.25
278
+ virtual circuit corresponding to this port.
279
+
280
+ For a port which has a unique value of
281
+ dot1dBasePortIfIndex, this object can have the value
282
+ { 0 0 }."
283
+ ::= { dot1dBasePortEntry 3 }
284
+
285
+ dot1dBasePortDelayExceededDiscards OBJECT-TYPE
286
+ SYNTAX Counter32
287
+ MAX-ACCESS read-only
288
+ STATUS current
289
+ DESCRIPTION
290
+ "The number of frames discarded by this port due
291
+ to excessive transit delay through the bridge. It
292
+ is incremented by both transparent and source
293
+ route bridges."
294
+ REFERENCE
295
+ "IEEE 802.1D-1998: clause 14.6.1.1.3"
296
+ ::= { dot1dBasePortEntry 4 }
297
+
298
+ dot1dBasePortMtuExceededDiscards OBJECT-TYPE
299
+ SYNTAX Counter32
300
+ MAX-ACCESS read-only
301
+ STATUS current
302
+ DESCRIPTION
303
+ "The number of frames discarded by this port due
304
+ to an excessive size. It is incremented by both
305
+ transparent and source route bridges."
306
+ REFERENCE
307
+ "IEEE 802.1D-1998: clause 14.6.1.1.3"
308
+ ::= { dot1dBasePortEntry 5 }
309
+
310
+ -- ---------------------------------------------------------- --
311
+ -- the dot1dStp subtree
312
+ -- ---------------------------------------------------------- --
313
+ -- Implementation of the dot1dStp subtree is optional. It is
314
+ -- implemented by those bridges that support the Spanning Tree
315
+ -- Protocol.
316
+ -- ---------------------------------------------------------- --
317
+
318
+ dot1dStpProtocolSpecification OBJECT-TYPE
319
+ SYNTAX INTEGER {
320
+ unknown(1),
321
+ decLb100(2),
322
+ ieee8021d(3)
323
+ }
324
+ MAX-ACCESS read-only
325
+ STATUS current
326
+ DESCRIPTION
327
+ "An indication of what version of the Spanning Tree
328
+ Protocol is being run. The value 'decLb100(2)'
329
+ indicates the DEC LANbridge 100 Spanning Tree protocol.
330
+ IEEE 802.1D implementations will return 'ieee8021d(3)'.
331
+ If future versions of the IEEE Spanning Tree Protocol
332
+ that are incompatible with the current version
333
+ are released a new value will be defined."
334
+ ::= { dot1dStp 1 }
335
+
336
+ dot1dStpPriority OBJECT-TYPE
337
+ SYNTAX Integer32 (0..65535)
338
+ MAX-ACCESS read-write
339
+ STATUS current
340
+ DESCRIPTION
341
+ "The value of the write-able portion of the Bridge ID
342
+ (i.e., the first two octets of the (8 octet long) Bridge
343
+ ID). The other (last) 6 octets of the Bridge ID are
344
+ given by the value of dot1dBaseBridgeAddress.
345
+ On bridges supporting IEEE 802.1t or IEEE 802.1w,
346
+ permissible values are 0-61440, in steps of 4096."
347
+ REFERENCE
348
+ "IEEE 802.1D-1998 clause 8.10.2, Table 8-4,
349
+ IEEE 802.1t clause 8.10.2, Table 8-4, clause 14.3."
350
+ ::= { dot1dStp 2 }
351
+
352
+ dot1dStpTimeSinceTopologyChange OBJECT-TYPE
353
+ SYNTAX TimeTicks
354
+ UNITS "centi-seconds"
355
+ MAX-ACCESS read-only
356
+ STATUS current
357
+ DESCRIPTION
358
+ "The time (in hundredths of a second) since the
359
+ last time a topology change was detected by the
360
+ bridge entity.
361
+ For RSTP, this reports the time since the tcWhile
362
+ timer for any port on this Bridge was nonzero."
363
+ REFERENCE
364
+ "IEEE 802.1D-1998 clause 14.8.1.1.,
365
+ IEEE 802.1w clause 14.8.1.1."
366
+ ::= { dot1dStp 3 }
367
+
368
+ dot1dStpTopChanges OBJECT-TYPE
369
+ SYNTAX Counter32
370
+ MAX-ACCESS read-only
371
+ STATUS current
372
+ DESCRIPTION
373
+ "The total number of topology changes detected by
374
+ this bridge since the management entity was last
375
+ reset or initialized."
376
+ REFERENCE
377
+ "IEEE 802.1D-1998 clause 14.8.1.1."
378
+ ::= { dot1dStp 4 }
379
+
380
+ dot1dStpDesignatedRoot OBJECT-TYPE
381
+ SYNTAX BridgeId
382
+ MAX-ACCESS read-only
383
+ STATUS current
384
+ DESCRIPTION
385
+ "The bridge identifier of the root of the spanning
386
+ tree, as determined by the Spanning Tree Protocol,
387
+ as executed by this node. This value is used as
388
+ the Root Identifier parameter in all Configuration
389
+ Bridge PDUs originated by this node."
390
+ REFERENCE
391
+ "IEEE 802.1D-1998: clause 8.5.3.1"
392
+ ::= { dot1dStp 5 }
393
+
394
+ dot1dStpRootCost OBJECT-TYPE
395
+ SYNTAX Integer32
396
+ MAX-ACCESS read-only
397
+ STATUS current
398
+ DESCRIPTION
399
+ "The cost of the path to the root as seen from
400
+ this bridge."
401
+ REFERENCE
402
+ "IEEE 802.1D-1998: clause 8.5.3.2"
403
+ ::= { dot1dStp 6 }
404
+
405
+ dot1dStpRootPort OBJECT-TYPE
406
+ SYNTAX Integer32
407
+ MAX-ACCESS read-only
408
+ STATUS current
409
+ DESCRIPTION
410
+ "The port number of the port that offers the lowest
411
+ cost path from this bridge to the root bridge."
412
+ REFERENCE
413
+ "IEEE 802.1D-1998: clause 8.5.3.3"
414
+ ::= { dot1dStp 7 }
415
+
416
+ dot1dStpMaxAge OBJECT-TYPE
417
+ SYNTAX Timeout
418
+ UNITS "centi-seconds"
419
+ MAX-ACCESS read-only
420
+ STATUS current
421
+ DESCRIPTION
422
+ "The maximum age of Spanning Tree Protocol information
423
+ learned from the network on any port before it is
424
+ discarded, in units of hundredths of a second. This is
425
+ the actual value that this bridge is currently using."
426
+ REFERENCE
427
+ "IEEE 802.1D-1998: clause 8.5.3.4"
428
+ ::= { dot1dStp 8 }
429
+
430
+ dot1dStpHelloTime OBJECT-TYPE
431
+ SYNTAX Timeout
432
+ UNITS "centi-seconds"
433
+ MAX-ACCESS read-only
434
+ STATUS current
435
+ DESCRIPTION
436
+ "The amount of time between the transmission of
437
+ Configuration bridge PDUs by this node on any port when
438
+ it is the root of the spanning tree, or trying to become
439
+ so, in units of hundredths of a second. This is the
440
+ actual value that this bridge is currently using."
441
+ REFERENCE
442
+ "IEEE 802.1D-1998: clause 8.5.3.5"
443
+ ::= { dot1dStp 9 }
444
+
445
+ dot1dStpHoldTime OBJECT-TYPE
446
+ SYNTAX Integer32
447
+ UNITS "centi-seconds"
448
+ MAX-ACCESS read-only
449
+ STATUS current
450
+ DESCRIPTION
451
+ "This time value determines the interval length
452
+ during which no more than two Configuration bridge
453
+ PDUs shall be transmitted by this node, in units
454
+ of hundredths of a second."
455
+ REFERENCE
456
+ "IEEE 802.1D-1998: clause 8.5.3.14"
457
+ ::= { dot1dStp 10 }
458
+
459
+ dot1dStpForwardDelay OBJECT-TYPE
460
+ SYNTAX Timeout
461
+ UNITS "centi-seconds"
462
+ MAX-ACCESS read-only
463
+ STATUS current
464
+ DESCRIPTION
465
+ "This time value, measured in units of hundredths of a
466
+ second, controls how fast a port changes its spanning
467
+ state when moving towards the Forwarding state. The
468
+ value determines how long the port stays in each of the
469
+ Listening and Learning states, which precede the
470
+ Forwarding state. This value is also used when a
471
+ topology change has been detected and is underway, to
472
+ age all dynamic entries in the Forwarding Database.
473
+ [Note that this value is the one that this bridge is
474
+ currently using, in contrast to
475
+ dot1dStpBridgeForwardDelay, which is the value that this
476
+ bridge and all others would start using if/when this
477
+ bridge were to become the root.]"
478
+ REFERENCE
479
+ "IEEE 802.1D-1998: clause 8.5.3.6"
480
+ ::= { dot1dStp 11 }
481
+
482
+ dot1dStpBridgeMaxAge OBJECT-TYPE
483
+ SYNTAX Timeout (600..4000)
484
+ UNITS "centi-seconds"
485
+ MAX-ACCESS read-write
486
+ STATUS current
487
+ DESCRIPTION
488
+ "The value that all bridges use for MaxAge when this
489
+ bridge is acting as the root. Note that 802.1D-1998
490
+ specifies that the range for this parameter is related
491
+ to the value of dot1dStpBridgeHelloTime. The
492
+ granularity of this timer is specified by 802.1D-1998 to
493
+ be 1 second. An agent may return a badValue error if a
494
+ set is attempted to a value that is not a whole number
495
+ of seconds."
496
+ REFERENCE
497
+ "IEEE 802.1D-1998: clause 8.5.3.8"
498
+ ::= { dot1dStp 12 }
499
+
500
+ dot1dStpBridgeHelloTime OBJECT-TYPE
501
+ SYNTAX Timeout (100..1000)
502
+ UNITS "centi-seconds"
503
+ MAX-ACCESS read-write
504
+ STATUS current
505
+ DESCRIPTION
506
+ "The value that all bridges use for HelloTime when this
507
+ bridge is acting as the root. The granularity of this
508
+ timer is specified by 802.1D-1998 to be 1 second. An
509
+ agent may return a badValue error if a set is attempted
510
+
511
+ to a value that is not a whole number of seconds."
512
+ REFERENCE
513
+ "IEEE 802.1D-1998: clause 8.5.3.9"
514
+ ::= { dot1dStp 13 }
515
+
516
+ dot1dStpBridgeForwardDelay OBJECT-TYPE
517
+ SYNTAX Timeout (400..3000)
518
+ UNITS "centi-seconds"
519
+ MAX-ACCESS read-write
520
+ STATUS current
521
+ DESCRIPTION
522
+ "The value that all bridges use for ForwardDelay when
523
+ this bridge is acting as the root. Note that
524
+ 802.1D-1998 specifies that the range for this parameter
525
+ is related to the value of dot1dStpBridgeMaxAge. The
526
+ granularity of this timer is specified by 802.1D-1998 to
527
+ be 1 second. An agent may return a badValue error if a
528
+ set is attempted to a value that is not a whole number
529
+ of seconds."
530
+ REFERENCE
531
+ "IEEE 802.1D-1998: clause 8.5.3.10"
532
+ ::= { dot1dStp 14 }
533
+
534
+ -- ---------------------------------------------------------- --
535
+ -- The Spanning Tree Port Table
536
+ -- ---------------------------------------------------------- --
537
+
538
+ dot1dStpPortTable OBJECT-TYPE
539
+ SYNTAX SEQUENCE OF Dot1dStpPortEntry
540
+ MAX-ACCESS not-accessible
541
+ STATUS current
542
+ DESCRIPTION
543
+ "A table that contains port-specific information
544
+ for the Spanning Tree Protocol."
545
+ ::= { dot1dStp 15 }
546
+
547
+ dot1dStpPortEntry OBJECT-TYPE
548
+ SYNTAX Dot1dStpPortEntry
549
+ MAX-ACCESS not-accessible
550
+ STATUS current
551
+ DESCRIPTION
552
+ "A list of information maintained by every port about
553
+ the Spanning Tree Protocol state for that port."
554
+ INDEX { dot1dStpPort }
555
+ ::= { dot1dStpPortTable 1 }
556
+
557
+ Dot1dStpPortEntry ::=
558
+ SEQUENCE {
559
+
560
+ dot1dStpPort
561
+ Integer32,
562
+ dot1dStpPortPriority
563
+ Integer32,
564
+ dot1dStpPortState
565
+ INTEGER,
566
+ dot1dStpPortEnable
567
+ INTEGER,
568
+ dot1dStpPortPathCost
569
+ Integer32,
570
+ dot1dStpPortDesignatedRoot
571
+ BridgeId,
572
+ dot1dStpPortDesignatedCost
573
+ Integer32,
574
+ dot1dStpPortDesignatedBridge
575
+ BridgeId,
576
+ dot1dStpPortDesignatedPort
577
+ OCTET STRING,
578
+ dot1dStpPortForwardTransitions
579
+ Counter32,
580
+ dot1dStpPortPathCost32
581
+ Integer32
582
+ }
583
+
584
+ dot1dStpPort OBJECT-TYPE
585
+ SYNTAX Integer32 (1..65535)
586
+ MAX-ACCESS read-only
587
+ STATUS current
588
+ DESCRIPTION
589
+ "The port number of the port for which this entry
590
+ contains Spanning Tree Protocol management information."
591
+ REFERENCE
592
+ "IEEE 802.1D-1998: clause 14.8.2.1.2"
593
+ ::= { dot1dStpPortEntry 1 }
594
+
595
+ dot1dStpPortPriority OBJECT-TYPE
596
+ SYNTAX Integer32 (0..255)
597
+ MAX-ACCESS read-write
598
+ STATUS current
599
+ DESCRIPTION
600
+ "The value of the priority field that is contained in
601
+ the first (in network byte order) octet of the (2 octet
602
+ long) Port ID. The other octet of the Port ID is given
603
+ by the value of dot1dStpPort.
604
+ On bridges supporting IEEE 802.1t or IEEE 802.1w,
605
+ permissible values are 0-240, in steps of 16."
606
+ REFERENCE
607
+ "IEEE 802.1D-1998 clause 8.10.2, Table 8-4,
608
+ IEEE 802.1t clause 8.10.2, Table 8-4, clause 14.3."
609
+ ::= { dot1dStpPortEntry 2 }
610
+
611
+ dot1dStpPortState OBJECT-TYPE
612
+ SYNTAX INTEGER {
613
+ disabled(1),
614
+ blocking(2),
615
+ listening(3),
616
+ learning(4),
617
+ forwarding(5),
618
+ broken(6)
619
+ }
620
+ MAX-ACCESS read-only
621
+ STATUS current
622
+ DESCRIPTION
623
+ "The port's current state, as defined by application of
624
+ the Spanning Tree Protocol. This state controls what
625
+ action a port takes on reception of a frame. If the
626
+ bridge has detected a port that is malfunctioning, it
627
+ will place that port into the broken(6) state. For
628
+ ports that are disabled (see dot1dStpPortEnable), this
629
+ object will have a value of disabled(1)."
630
+ REFERENCE
631
+ "IEEE 802.1D-1998: clause 8.5.5.2"
632
+ ::= { dot1dStpPortEntry 3 }
633
+
634
+ dot1dStpPortEnable OBJECT-TYPE
635
+ SYNTAX INTEGER {
636
+ enabled(1),
637
+ disabled(2)
638
+ }
639
+ MAX-ACCESS read-write
640
+ STATUS current
641
+ DESCRIPTION
642
+ "The enabled/disabled status of the port."
643
+ REFERENCE
644
+ "IEEE 802.1D-1998: clause 8.5.5.2"
645
+ ::= { dot1dStpPortEntry 4 }
646
+
647
+ dot1dStpPortPathCost OBJECT-TYPE
648
+ SYNTAX Integer32 (1..65535)
649
+ MAX-ACCESS read-write
650
+ STATUS current
651
+ DESCRIPTION
652
+ "The contribution of this port to the path cost of
653
+ paths towards the spanning tree root which include
654
+ this port. 802.1D-1998 recommends that the default
655
+ value of this parameter be in inverse proportion to
656
+
657
+ the speed of the attached LAN.
658
+
659
+ New implementations should support dot1dStpPortPathCost32.
660
+ If the port path costs exceeds the maximum value of this
661
+ object then this object should report the maximum value,
662
+ namely 65535. Applications should try to read the
663
+ dot1dStpPortPathCost32 object if this object reports
664
+ the maximum value."
665
+ REFERENCE "IEEE 802.1D-1998: clause 8.5.5.3"
666
+ ::= { dot1dStpPortEntry 5 }
667
+
668
+ dot1dStpPortDesignatedRoot OBJECT-TYPE
669
+ SYNTAX BridgeId
670
+ MAX-ACCESS read-only
671
+ STATUS current
672
+ DESCRIPTION
673
+ "The unique Bridge Identifier of the Bridge
674
+ recorded as the Root in the Configuration BPDUs
675
+ transmitted by the Designated Bridge for the
676
+ segment to which the port is attached."
677
+ REFERENCE
678
+ "IEEE 802.1D-1998: clause 8.5.5.4"
679
+ ::= { dot1dStpPortEntry 6 }
680
+
681
+ dot1dStpPortDesignatedCost OBJECT-TYPE
682
+ SYNTAX Integer32
683
+ MAX-ACCESS read-only
684
+ STATUS current
685
+ DESCRIPTION
686
+ "The path cost of the Designated Port of the segment
687
+ connected to this port. This value is compared to the
688
+ Root Path Cost field in received bridge PDUs."
689
+ REFERENCE
690
+ "IEEE 802.1D-1998: clause 8.5.5.5"
691
+ ::= { dot1dStpPortEntry 7 }
692
+
693
+ dot1dStpPortDesignatedBridge OBJECT-TYPE
694
+ SYNTAX BridgeId
695
+ MAX-ACCESS read-only
696
+ STATUS current
697
+ DESCRIPTION
698
+ "The Bridge Identifier of the bridge that this
699
+ port considers to be the Designated Bridge for
700
+ this port's segment."
701
+ REFERENCE
702
+ "IEEE 802.1D-1998: clause 8.5.5.6"
703
+ ::= { dot1dStpPortEntry 8 }
704
+
705
+ dot1dStpPortDesignatedPort OBJECT-TYPE
706
+ SYNTAX OCTET STRING (SIZE (2))
707
+ MAX-ACCESS read-only
708
+ STATUS current
709
+ DESCRIPTION
710
+ "The Port Identifier of the port on the Designated
711
+ Bridge for this port's segment."
712
+ REFERENCE
713
+ "IEEE 802.1D-1998: clause 8.5.5.7"
714
+ ::= { dot1dStpPortEntry 9 }
715
+
716
+ dot1dStpPortForwardTransitions OBJECT-TYPE
717
+ SYNTAX Counter32
718
+ MAX-ACCESS read-only
719
+ STATUS current
720
+ DESCRIPTION
721
+ "The number of times this port has transitioned
722
+ from the Learning state to the Forwarding state."
723
+ ::= { dot1dStpPortEntry 10 }
724
+
725
+ dot1dStpPortPathCost32 OBJECT-TYPE
726
+ SYNTAX Integer32 (1..200000000)
727
+ MAX-ACCESS read-write
728
+ STATUS current
729
+ DESCRIPTION
730
+ "The contribution of this port to the path cost of
731
+ paths towards the spanning tree root which include
732
+ this port. 802.1D-1998 recommends that the default
733
+ value of this parameter be in inverse proportion to
734
+ the speed of the attached LAN.
735
+
736
+ This object replaces dot1dStpPortPathCost to support
737
+ IEEE 802.1t."
738
+ REFERENCE
739
+ "IEEE 802.1t clause 8.10.2, Table 8-5."
740
+ ::= { dot1dStpPortEntry 11 }
741
+
742
+ -- ---------------------------------------------------------- --
743
+ -- the dot1dTp subtree
744
+ -- ---------------------------------------------------------- --
745
+ -- Implementation of the dot1dTp subtree is optional. It is
746
+ -- implemented by those bridges that support the transparent
747
+ -- bridging mode. A transparent or SRT bridge will implement
748
+ -- this subtree.
749
+ -- ---------------------------------------------------------- --
750
+
751
+ dot1dTpLearnedEntryDiscards OBJECT-TYPE
752
+ SYNTAX Counter32
753
+ MAX-ACCESS read-only
754
+ STATUS current
755
+ DESCRIPTION
756
+ "The total number of Forwarding Database entries that
757
+ have been or would have been learned, but have been
758
+ discarded due to a lack of storage space in the
759
+ Forwarding Database. If this counter is increasing, it
760
+ indicates that the Forwarding Database is regularly
761
+ becoming full (a condition that has unpleasant
762
+ performance effects on the subnetwork). If this counter
763
+ has a significant value but is not presently increasing,
764
+ it indicates that the problem has been occurring but is
765
+ not persistent."
766
+ REFERENCE
767
+ "IEEE 802.1D-1998: clause 14.7.1.1.3"
768
+ ::= { dot1dTp 1 }
769
+
770
+ dot1dTpAgingTime OBJECT-TYPE
771
+ SYNTAX Integer32 (10..1000000)
772
+ UNITS "seconds"
773
+ MAX-ACCESS read-write
774
+ STATUS current
775
+ DESCRIPTION
776
+ "The timeout period in seconds for aging out
777
+ dynamically-learned forwarding information.
778
+ 802.1D-1998 recommends a default of 300 seconds."
779
+ REFERENCE
780
+ "IEEE 802.1D-1998: clause 14.7.1.1.3"
781
+ ::= { dot1dTp 2 }
782
+
783
+ -- ---------------------------------------------------------- --
784
+ -- The Forwarding Database for Transparent Bridges
785
+ -- ---------------------------------------------------------- --
786
+
787
+ dot1dTpFdbTable OBJECT-TYPE
788
+ SYNTAX SEQUENCE OF Dot1dTpFdbEntry
789
+ MAX-ACCESS not-accessible
790
+ STATUS current
791
+ DESCRIPTION
792
+ "A table that contains information about unicast
793
+ entries for which the bridge has forwarding and/or
794
+ filtering information. This information is used
795
+ by the transparent bridging function in
796
+ determining how to propagate a received frame."
797
+ ::= { dot1dTp 3 }
798
+
799
+ dot1dTpFdbEntry OBJECT-TYPE
800
+ SYNTAX Dot1dTpFdbEntry
801
+ MAX-ACCESS not-accessible
802
+ STATUS current
803
+ DESCRIPTION
804
+ "Information about a specific unicast MAC address
805
+ for which the bridge has some forwarding and/or
806
+ filtering information."
807
+ INDEX { dot1dTpFdbAddress }
808
+ ::= { dot1dTpFdbTable 1 }
809
+
810
+ Dot1dTpFdbEntry ::=
811
+ SEQUENCE {
812
+ dot1dTpFdbAddress
813
+ MacAddress,
814
+ dot1dTpFdbPort
815
+ Integer32,
816
+ dot1dTpFdbStatus
817
+ INTEGER
818
+ }
819
+
820
+ dot1dTpFdbAddress OBJECT-TYPE
821
+ SYNTAX MacAddress
822
+ MAX-ACCESS read-only
823
+ STATUS current
824
+ DESCRIPTION
825
+ "A unicast MAC address for which the bridge has
826
+ forwarding and/or filtering information."
827
+ REFERENCE
828
+ "IEEE 802.1D-1998: clause 7.9.1, 7.9.2"
829
+ ::= { dot1dTpFdbEntry 1 }
830
+
831
+ dot1dTpFdbPort OBJECT-TYPE
832
+ SYNTAX Integer32
833
+ MAX-ACCESS read-only
834
+ STATUS current
835
+ DESCRIPTION
836
+ "Either the value '0', or the port number of the port on
837
+ which a frame having a source address equal to the value
838
+ of the corresponding instance of dot1dTpFdbAddress has
839
+ been seen. A value of '0' indicates that the port
840
+ number has not been learned, but that the bridge does
841
+ have some forwarding/filtering information about this
842
+ address (e.g., in the dot1dStaticTable). Implementors
843
+ are encouraged to assign the port value to this object
844
+ whenever it is learned, even for addresses for which the
845
+ corresponding value of dot1dTpFdbStatus is not
846
+ learned(3)."
847
+ ::= { dot1dTpFdbEntry 2 }
848
+
849
+ dot1dTpFdbStatus OBJECT-TYPE
850
+ SYNTAX INTEGER {
851
+ other(1),
852
+ invalid(2),
853
+ learned(3),
854
+ self(4),
855
+ mgmt(5)
856
+ }
857
+ MAX-ACCESS read-only
858
+ STATUS current
859
+ DESCRIPTION
860
+ "The status of this entry. The meanings of the
861
+ values are:
862
+ other(1) - none of the following. This would
863
+ include the case where some other MIB object
864
+ (not the corresponding instance of
865
+ dot1dTpFdbPort, nor an entry in the
866
+ dot1dStaticTable) is being used to determine if
867
+ and how frames addressed to the value of the
868
+ corresponding instance of dot1dTpFdbAddress are
869
+ being forwarded.
870
+ invalid(2) - this entry is no longer valid (e.g.,
871
+ it was learned but has since aged out), but has
872
+ not yet been flushed from the table.
873
+ learned(3) - the value of the corresponding instance
874
+ of dot1dTpFdbPort was learned, and is being
875
+ used.
876
+ self(4) - the value of the corresponding instance of
877
+ dot1dTpFdbAddress represents one of the bridge's
878
+ addresses. The corresponding instance of
879
+ dot1dTpFdbPort indicates which of the bridge's
880
+ ports has this address.
881
+ mgmt(5) - the value of the corresponding instance of
882
+ dot1dTpFdbAddress is also the value of an
883
+ existing instance of dot1dStaticAddress."
884
+ ::= { dot1dTpFdbEntry 3 }
885
+
886
+ -- ---------------------------------------------------------- --
887
+ -- Port Table for Transparent Bridges
888
+ -- ---------------------------------------------------------- --
889
+
890
+ dot1dTpPortTable OBJECT-TYPE
891
+ SYNTAX SEQUENCE OF Dot1dTpPortEntry
892
+ MAX-ACCESS not-accessible
893
+ STATUS current
894
+ DESCRIPTION
895
+ "A table that contains information about every port that
896
+ is associated with this transparent bridge."
897
+ ::= { dot1dTp 4 }
898
+
899
+ dot1dTpPortEntry OBJECT-TYPE
900
+ SYNTAX Dot1dTpPortEntry
901
+ MAX-ACCESS not-accessible
902
+ STATUS current
903
+ DESCRIPTION
904
+ "A list of information for each port of a transparent
905
+ bridge."
906
+ INDEX { dot1dTpPort }
907
+ ::= { dot1dTpPortTable 1 }
908
+
909
+ Dot1dTpPortEntry ::=
910
+ SEQUENCE {
911
+ dot1dTpPort
912
+ Integer32,
913
+ dot1dTpPortMaxInfo
914
+ Integer32,
915
+ dot1dTpPortInFrames
916
+ Counter32,
917
+ dot1dTpPortOutFrames
918
+ Counter32,
919
+ dot1dTpPortInDiscards
920
+ Counter32
921
+ }
922
+
923
+ dot1dTpPort OBJECT-TYPE
924
+ SYNTAX Integer32 (1..65535)
925
+ MAX-ACCESS read-only
926
+ STATUS current
927
+ DESCRIPTION
928
+ "The port number of the port for which this entry
929
+ contains Transparent bridging management information."
930
+ ::= { dot1dTpPortEntry 1 }
931
+
932
+ -- It would be nice if we could use ifMtu as the size of the
933
+ -- largest INFO field, but we can't because ifMtu is defined
934
+ -- to be the size that the (inter-)network layer can use, which
935
+ -- can differ from the MAC layer (especially if several layers
936
+ -- of encapsulation are used).
937
+
938
+ dot1dTpPortMaxInfo OBJECT-TYPE
939
+ SYNTAX Integer32
940
+ UNITS "bytes"
941
+ MAX-ACCESS read-only
942
+ STATUS current
943
+ DESCRIPTION
944
+ "The maximum size of the INFO (non-MAC) field that
945
+
946
+ this port will receive or transmit."
947
+ ::= { dot1dTpPortEntry 2 }
948
+
949
+ dot1dTpPortInFrames OBJECT-TYPE
950
+ SYNTAX Counter32
951
+ UNITS "frames"
952
+ MAX-ACCESS read-only
953
+ STATUS current
954
+ DESCRIPTION
955
+ "The number of frames that have been received by this
956
+ port from its segment. Note that a frame received on the
957
+ interface corresponding to this port is only counted by
958
+ this object if and only if it is for a protocol being
959
+ processed by the local bridging function, including
960
+ bridge management frames."
961
+ REFERENCE
962
+ "IEEE 802.1D-1998: clause 14.6.1.1.3"
963
+ ::= { dot1dTpPortEntry 3 }
964
+
965
+ dot1dTpPortOutFrames OBJECT-TYPE
966
+ SYNTAX Counter32
967
+ UNITS "frames"
968
+ MAX-ACCESS read-only
969
+ STATUS current
970
+ DESCRIPTION
971
+ "The number of frames that have been transmitted by this
972
+ port to its segment. Note that a frame transmitted on
973
+ the interface corresponding to this port is only counted
974
+ by this object if and only if it is for a protocol being
975
+ processed by the local bridging function, including
976
+ bridge management frames."
977
+ REFERENCE
978
+ "IEEE 802.1D-1998: clause 14.6.1.1.3"
979
+ ::= { dot1dTpPortEntry 4 }
980
+
981
+ dot1dTpPortInDiscards OBJECT-TYPE
982
+ SYNTAX Counter32
983
+ UNITS "frames"
984
+ MAX-ACCESS read-only
985
+ STATUS current
986
+ DESCRIPTION
987
+ "Count of received valid frames that were discarded
988
+ (i.e., filtered) by the Forwarding Process."
989
+ REFERENCE
990
+ "IEEE 802.1D-1998: clause 14.6.1.1.3"
991
+ ::= { dot1dTpPortEntry 5 }
992
+
993
+ -- ---------------------------------------------------------- --
994
+
995
+ -- The Static (Destination-Address Filtering) Database
996
+ -- ---------------------------------------------------------- --
997
+ -- Implementation of this subtree is optional.
998
+ -- ---------------------------------------------------------- --
999
+
1000
+ dot1dStaticTable OBJECT-TYPE
1001
+ SYNTAX SEQUENCE OF Dot1dStaticEntry
1002
+ MAX-ACCESS not-accessible
1003
+ STATUS current
1004
+ DESCRIPTION
1005
+ "A table containing filtering information configured
1006
+ into the bridge by (local or network) management
1007
+ specifying the set of ports to which frames received
1008
+ from specific ports and containing specific destination
1009
+ addresses are allowed to be forwarded. The value of
1010
+ zero in this table, as the port number from which frames
1011
+ with a specific destination address are received, is
1012
+ used to specify all ports for which there is no specific
1013
+ entry in this table for that particular destination
1014
+ address. Entries are valid for unicast and for
1015
+ group/broadcast addresses."
1016
+ REFERENCE
1017
+ "IEEE 802.1D-1998: clause 14.7.2"
1018
+ ::= { dot1dStatic 1 }
1019
+
1020
+ dot1dStaticEntry OBJECT-TYPE
1021
+ SYNTAX Dot1dStaticEntry
1022
+ MAX-ACCESS not-accessible
1023
+ STATUS current
1024
+ DESCRIPTION
1025
+ "Filtering information configured into the bridge by
1026
+ (local or network) management specifying the set of
1027
+ ports to which frames received from a specific port and
1028
+ containing a specific destination address are allowed to
1029
+ be forwarded."
1030
+ REFERENCE
1031
+ "IEEE 802.1D-1998: clause 14.7.2"
1032
+ INDEX { dot1dStaticAddress, dot1dStaticReceivePort }
1033
+ ::= { dot1dStaticTable 1 }
1034
+
1035
+ Dot1dStaticEntry ::=
1036
+ SEQUENCE {
1037
+ dot1dStaticAddress MacAddress,
1038
+ dot1dStaticReceivePort Integer32,
1039
+ dot1dStaticAllowedToGoTo OCTET STRING,
1040
+ dot1dStaticStatus INTEGER
1041
+ }
1042
+
1043
+ dot1dStaticAddress OBJECT-TYPE
1044
+ SYNTAX MacAddress
1045
+ MAX-ACCESS read-create
1046
+ STATUS current
1047
+ DESCRIPTION
1048
+ "The destination MAC address in a frame to which this
1049
+ entry's filtering information applies. This object can
1050
+ take the value of a unicast address, a group address, or
1051
+ the broadcast address."
1052
+ REFERENCE
1053
+ "IEEE 802.1D-1998: clause 7.9.1, 7.9.2"
1054
+ ::= { dot1dStaticEntry 1 }
1055
+
1056
+ dot1dStaticReceivePort OBJECT-TYPE
1057
+ SYNTAX Integer32 (0..65535)
1058
+ MAX-ACCESS read-create
1059
+ STATUS current
1060
+ DESCRIPTION
1061
+ "Either the value '0', or the port number of the port
1062
+ from which a frame must be received in order for this
1063
+ entry's filtering information to apply. A value of zero
1064
+ indicates that this entry applies on all ports of the
1065
+ bridge for which there is no other applicable entry."
1066
+ ::= { dot1dStaticEntry 2 }
1067
+
1068
+ dot1dStaticAllowedToGoTo OBJECT-TYPE
1069
+ SYNTAX OCTET STRING (SIZE (0..512))
1070
+ MAX-ACCESS read-create
1071
+ STATUS current
1072
+ DESCRIPTION
1073
+ "The set of ports to which frames received from a
1074
+ specific port and destined for a specific MAC address,
1075
+ are allowed to be forwarded. Each octet within the
1076
+ value of this object specifies a set of eight ports,
1077
+ with the first octet specifying ports 1 through 8, the
1078
+ second octet specifying ports 9 through 16, etc. Within
1079
+ each octet, the most significant bit represents the
1080
+ lowest numbered port, and the least significant bit
1081
+ represents the highest numbered port. Thus, each port
1082
+ of the bridge is represented by a single bit within the
1083
+ value of this object. If that bit has a value of '1',
1084
+ then that port is included in the set of ports; the port
1085
+ is not included if its bit has a value of '0'. (Note
1086
+ that the setting of the bit corresponding to the port
1087
+ from which a frame is received is irrelevant.) The
1088
+ default value of this object is a string of ones of
1089
+ appropriate length.
1090
+
1091
+ The value of this object may exceed the required minimum
1092
+ maximum message size of some SNMP transport (484 bytes,
1093
+ in the case of SNMP over UDP, see RFC 3417, section 3.2).
1094
+ SNMP engines on bridges supporting a large number of
1095
+ ports must support appropriate maximum message sizes."
1096
+ ::= { dot1dStaticEntry 3 }
1097
+
1098
+ dot1dStaticStatus OBJECT-TYPE
1099
+ SYNTAX INTEGER {
1100
+ other(1),
1101
+ invalid(2),
1102
+ permanent(3),
1103
+ deleteOnReset(4),
1104
+ deleteOnTimeout(5)
1105
+ }
1106
+ MAX-ACCESS read-create
1107
+ STATUS current
1108
+ DESCRIPTION
1109
+ "This object indicates the status of this entry.
1110
+ The default value is permanent(3).
1111
+ other(1) - this entry is currently in use but the
1112
+ conditions under which it will remain so are
1113
+ different from each of the following values.
1114
+ invalid(2) - writing this value to the object
1115
+ removes the corresponding entry.
1116
+ permanent(3) - this entry is currently in use and
1117
+ will remain so after the next reset of the
1118
+ bridge.
1119
+ deleteOnReset(4) - this entry is currently in use
1120
+ and will remain so until the next reset of the
1121
+ bridge.
1122
+ deleteOnTimeout(5) - this entry is currently in use
1123
+ and will remain so until it is aged out."
1124
+ ::= { dot1dStaticEntry 4 }
1125
+
1126
+ -- ---------------------------------------------------------- --
1127
+ -- Notifications for use by Bridges
1128
+ -- ---------------------------------------------------------- --
1129
+ -- Notifications for the Spanning Tree Protocol
1130
+ -- ---------------------------------------------------------- --
1131
+
1132
+ newRoot NOTIFICATION-TYPE
1133
+ -- OBJECTS { }
1134
+ STATUS current
1135
+ DESCRIPTION
1136
+ "The newRoot trap indicates that the sending agent has
1137
+ become the new root of the Spanning Tree; the trap is
1138
+ sent by a bridge soon after its election as the new
1139
+
1140
+ root, e.g., upon expiration of the Topology Change Timer,
1141
+ immediately subsequent to its election. Implementation
1142
+ of this trap is optional."
1143
+ ::= { dot1dNotifications 1 }
1144
+
1145
+ topologyChange NOTIFICATION-TYPE
1146
+ -- OBJECTS { }
1147
+ STATUS current
1148
+ DESCRIPTION
1149
+ "A topologyChange trap is sent by a bridge when any of
1150
+ its configured ports transitions from the Learning state
1151
+ to the Forwarding state, or from the Forwarding state to
1152
+ the Blocking state. The trap is not sent if a newRoot
1153
+ trap is sent for the same transition. Implementation of
1154
+ this trap is optional."
1155
+ ::= { dot1dNotifications 2 }
1156
+
1157
+ -- ---------------------------------------------------------- --
1158
+ -- IEEE 802.1D MIB - Conformance Information
1159
+ -- ---------------------------------------------------------- --
1160
+
1161
+ dot1dGroups OBJECT IDENTIFIER ::= { dot1dConformance 1 }
1162
+ dot1dCompliances OBJECT IDENTIFIER ::= { dot1dConformance 2 }
1163
+
1164
+ -- ---------------------------------------------------------- --
1165
+ -- units of conformance
1166
+ -- ---------------------------------------------------------- --
1167
+
1168
+ -- ---------------------------------------------------------- --
1169
+ -- the dot1dBase group
1170
+ -- ---------------------------------------------------------- --
1171
+
1172
+ dot1dBaseBridgeGroup OBJECT-GROUP
1173
+ OBJECTS {
1174
+ dot1dBaseBridgeAddress,
1175
+ dot1dBaseNumPorts,
1176
+ dot1dBaseType
1177
+ }
1178
+ STATUS current
1179
+ DESCRIPTION
1180
+ "Bridge level information for this device."
1181
+ ::= { dot1dGroups 1 }
1182
+
1183
+ dot1dBasePortGroup OBJECT-GROUP
1184
+ OBJECTS {
1185
+ dot1dBasePort,
1186
+ dot1dBasePortIfIndex,
1187
+ dot1dBasePortCircuit,
1188
+ dot1dBasePortDelayExceededDiscards,
1189
+ dot1dBasePortMtuExceededDiscards
1190
+ }
1191
+ STATUS current
1192
+ DESCRIPTION
1193
+ "Information for each port on this device."
1194
+ ::= { dot1dGroups 2 }
1195
+
1196
+ -- ---------------------------------------------------------- --
1197
+ -- the dot1dStp group
1198
+ -- ---------------------------------------------------------- --
1199
+
1200
+ dot1dStpBridgeGroup OBJECT-GROUP
1201
+ OBJECTS {
1202
+ dot1dStpProtocolSpecification,
1203
+ dot1dStpPriority,
1204
+ dot1dStpTimeSinceTopologyChange,
1205
+ dot1dStpTopChanges,
1206
+ dot1dStpDesignatedRoot,
1207
+ dot1dStpRootCost,
1208
+ dot1dStpRootPort,
1209
+ dot1dStpMaxAge,
1210
+ dot1dStpHelloTime,
1211
+ dot1dStpHoldTime,
1212
+ dot1dStpForwardDelay,
1213
+ dot1dStpBridgeMaxAge,
1214
+ dot1dStpBridgeHelloTime,
1215
+ dot1dStpBridgeForwardDelay
1216
+ }
1217
+ STATUS current
1218
+ DESCRIPTION
1219
+ "Bridge level Spanning Tree data for this device."
1220
+ ::= { dot1dGroups 3 }
1221
+
1222
+ dot1dStpPortGroup OBJECT-GROUP
1223
+ OBJECTS {
1224
+ dot1dStpPort,
1225
+ dot1dStpPortPriority,
1226
+ dot1dStpPortState,
1227
+ dot1dStpPortEnable,
1228
+ dot1dStpPortPathCost,
1229
+ dot1dStpPortDesignatedRoot,
1230
+ dot1dStpPortDesignatedCost,
1231
+ dot1dStpPortDesignatedBridge,
1232
+ dot1dStpPortDesignatedPort,
1233
+ dot1dStpPortForwardTransitions
1234
+ }
1235
+ STATUS current
1236
+ DESCRIPTION
1237
+ "Spanning Tree data for each port on this device."
1238
+ ::= { dot1dGroups 4 }
1239
+
1240
+ dot1dStpPortGroup2 OBJECT-GROUP
1241
+ OBJECTS {
1242
+ dot1dStpPort,
1243
+ dot1dStpPortPriority,
1244
+ dot1dStpPortState,
1245
+ dot1dStpPortEnable,
1246
+ dot1dStpPortDesignatedRoot,
1247
+ dot1dStpPortDesignatedCost,
1248
+ dot1dStpPortDesignatedBridge,
1249
+ dot1dStpPortDesignatedPort,
1250
+ dot1dStpPortForwardTransitions,
1251
+ dot1dStpPortPathCost32
1252
+ }
1253
+ STATUS current
1254
+ DESCRIPTION
1255
+ "Spanning Tree data for each port on this device."
1256
+ ::= { dot1dGroups 5 }
1257
+
1258
+ dot1dStpPortGroup3 OBJECT-GROUP
1259
+ OBJECTS {
1260
+ dot1dStpPortPathCost32
1261
+ }
1262
+ STATUS current
1263
+ DESCRIPTION
1264
+ "Spanning Tree data for devices supporting 32-bit
1265
+ path costs."
1266
+ ::= { dot1dGroups 6 }
1267
+
1268
+ -- ---------------------------------------------------------- --
1269
+ -- the dot1dTp group
1270
+ -- ---------------------------------------------------------- --
1271
+
1272
+ dot1dTpBridgeGroup OBJECT-GROUP
1273
+ OBJECTS {
1274
+ dot1dTpLearnedEntryDiscards,
1275
+ dot1dTpAgingTime
1276
+ }
1277
+ STATUS current
1278
+ DESCRIPTION
1279
+ "Bridge level Transparent Bridging data."
1280
+ ::= { dot1dGroups 7 }
1281
+
1282
+ dot1dTpFdbGroup OBJECT-GROUP
1283
+ OBJECTS {
1284
+
1285
+ dot1dTpFdbAddress,
1286
+ dot1dTpFdbPort,
1287
+ dot1dTpFdbStatus
1288
+ }
1289
+ STATUS current
1290
+ DESCRIPTION
1291
+ "Filtering Database information for the Bridge."
1292
+ ::= { dot1dGroups 8 }
1293
+
1294
+ dot1dTpGroup OBJECT-GROUP
1295
+ OBJECTS {
1296
+ dot1dTpPort,
1297
+ dot1dTpPortMaxInfo,
1298
+ dot1dTpPortInFrames,
1299
+ dot1dTpPortOutFrames,
1300
+ dot1dTpPortInDiscards
1301
+ }
1302
+ STATUS current
1303
+ DESCRIPTION
1304
+ "Dynamic Filtering Database information for each port of
1305
+ the Bridge."
1306
+ ::= { dot1dGroups 9 }
1307
+
1308
+ -- ---------------------------------------------------------- --
1309
+ -- The Static (Destination-Address Filtering) Database
1310
+ -- ---------------------------------------------------------- --
1311
+
1312
+ dot1dStaticGroup OBJECT-GROUP
1313
+ OBJECTS {
1314
+ dot1dStaticAddress,
1315
+ dot1dStaticReceivePort,
1316
+ dot1dStaticAllowedToGoTo,
1317
+ dot1dStaticStatus
1318
+ }
1319
+ STATUS current
1320
+ DESCRIPTION
1321
+ "Static Filtering Database information for each port of
1322
+ the Bridge."
1323
+ ::= { dot1dGroups 10 }
1324
+
1325
+ -- ---------------------------------------------------------- --
1326
+ -- The Trap Notification Group
1327
+ -- ---------------------------------------------------------- --
1328
+
1329
+ dot1dNotificationGroup NOTIFICATION-GROUP
1330
+ NOTIFICATIONS {
1331
+ newRoot,
1332
+ topologyChange
1333
+ }
1334
+ STATUS current
1335
+ DESCRIPTION
1336
+ "Group of objects describing notifications (traps)."
1337
+ ::= { dot1dGroups 11 }
1338
+
1339
+ -- ---------------------------------------------------------- --
1340
+ -- compliance statements
1341
+ -- ---------------------------------------------------------- --
1342
+
1343
+ bridgeCompliance1493 MODULE-COMPLIANCE
1344
+ STATUS current
1345
+ DESCRIPTION
1346
+ "The compliance statement for device support of bridging
1347
+ services, as per RFC1493."
1348
+
1349
+ MODULE
1350
+ MANDATORY-GROUPS {
1351
+ dot1dBaseBridgeGroup,
1352
+ dot1dBasePortGroup
1353
+ }
1354
+
1355
+ GROUP dot1dStpBridgeGroup
1356
+ DESCRIPTION
1357
+ "Implementation of this group is mandatory for bridges
1358
+ that support the Spanning Tree Protocol."
1359
+
1360
+ GROUP dot1dStpPortGroup
1361
+ DESCRIPTION
1362
+ "Implementation of this group is mandatory for bridges
1363
+ that support the Spanning Tree Protocol."
1364
+
1365
+ GROUP dot1dTpBridgeGroup
1366
+ DESCRIPTION
1367
+ "Implementation of this group is mandatory for bridges
1368
+ that support the transparent bridging mode. A
1369
+ transparent or SRT bridge will implement this group."
1370
+
1371
+ GROUP dot1dTpFdbGroup
1372
+ DESCRIPTION
1373
+ "Implementation of this group is mandatory for bridges
1374
+ that support the transparent bridging mode. A
1375
+ transparent or SRT bridge will implement this group."
1376
+
1377
+ GROUP dot1dTpGroup
1378
+ DESCRIPTION
1379
+ "Implementation of this group is mandatory for bridges
1380
+
1381
+ that support the transparent bridging mode. A
1382
+ transparent or SRT bridge will implement this group."
1383
+
1384
+ GROUP dot1dStaticGroup
1385
+ DESCRIPTION
1386
+ "Implementation of this group is optional."
1387
+
1388
+ GROUP dot1dNotificationGroup
1389
+ DESCRIPTION
1390
+ "Implementation of this group is optional."
1391
+ ::= { dot1dCompliances 1 }
1392
+
1393
+ bridgeCompliance4188 MODULE-COMPLIANCE
1394
+ STATUS current
1395
+ DESCRIPTION
1396
+ "The compliance statement for device support of bridging
1397
+ services. This supports 32-bit Path Cost values and the
1398
+ more restricted bridge and port priorities, as per IEEE
1399
+ 802.1t.
1400
+
1401
+ Full support for the 802.1D management objects requires that
1402
+ the SNMPv2-MIB [RFC3418] objects sysDescr, and sysUpTime, as
1403
+ well as the IF-MIB [RFC2863] objects ifIndex, ifType,
1404
+ ifDescr, ifPhysAddress, and ifLastChange are implemented."
1405
+
1406
+ MODULE
1407
+ MANDATORY-GROUPS {
1408
+ dot1dBaseBridgeGroup,
1409
+ dot1dBasePortGroup
1410
+ }
1411
+
1412
+ GROUP dot1dStpBridgeGroup
1413
+ DESCRIPTION
1414
+ "Implementation of this group is mandatory for
1415
+ bridges that support the Spanning Tree Protocol."
1416
+
1417
+ OBJECT dot1dStpPriority
1418
+ SYNTAX Integer32 (0|4096|8192|12288|16384|20480|24576
1419
+ |28672|32768|36864|40960|45056|49152
1420
+ |53248|57344|61440)
1421
+ DESCRIPTION
1422
+ "The possible values defined by IEEE 802.1t."
1423
+
1424
+ GROUP dot1dStpPortGroup2
1425
+ DESCRIPTION
1426
+ "Implementation of this group is mandatory for
1427
+ bridges that support the Spanning Tree Protocol."
1428
+
1429
+ GROUP dot1dStpPortGroup3
1430
+ DESCRIPTION
1431
+ "Implementation of this group is mandatory for bridges
1432
+ that support the Spanning Tree Protocol and 32-bit path
1433
+ costs. In particular, this includes devices supporting
1434
+ IEEE 802.1t and IEEE 802.1w."
1435
+
1436
+ OBJECT dot1dStpPortPriority
1437
+ SYNTAX Integer32 (0|16|32|48|64|80|96|112|128
1438
+ |144|160|176|192|208|224|240)
1439
+ DESCRIPTION
1440
+ "The possible values defined by IEEE 802.1t."
1441
+
1442
+ GROUP dot1dTpBridgeGroup
1443
+ DESCRIPTION
1444
+ "Implementation of this group is mandatory for
1445
+ bridges that support the transparent bridging
1446
+ mode. A transparent or SRT bridge will implement
1447
+ this group."
1448
+
1449
+ GROUP dot1dTpFdbGroup
1450
+ DESCRIPTION
1451
+ "Implementation of this group is mandatory for
1452
+ bridges that support the transparent bridging
1453
+ mode. A transparent or SRT bridge will implement
1454
+ this group."
1455
+
1456
+ GROUP dot1dTpGroup
1457
+ DESCRIPTION
1458
+ "Implementation of this group is mandatory for
1459
+ bridges that support the transparent bridging
1460
+ mode. A transparent or SRT bridge will implement
1461
+ this group."
1462
+
1463
+ GROUP dot1dStaticGroup
1464
+ DESCRIPTION
1465
+ "Implementation of this group is optional."
1466
+
1467
+ GROUP dot1dNotificationGroup
1468
+ DESCRIPTION
1469
+ "Implementation of this group is optional."
1470
+ ::= { dot1dCompliances 2 }
1471
+
1472
+ END