1 | IF-MIB DEFINITIONS ::= BEGIN
|
---|
2 |
|
---|
3 | IMPORTS
|
---|
4 | MODULE-IDENTITY, OBJECT-TYPE, Counter32, Gauge32, Counter64,
|
---|
5 | Integer32, TimeTicks, mib-2,
|
---|
6 | NOTIFICATION-TYPE FROM SNMPv2-SMI
|
---|
7 | TEXTUAL-CONVENTION, DisplayString,
|
---|
8 | PhysAddress, TruthValue, RowStatus,
|
---|
9 | TimeStamp, AutonomousType, TestAndIncr FROM SNMPv2-TC
|
---|
10 | MODULE-COMPLIANCE, OBJECT-GROUP,
|
---|
11 | NOTIFICATION-GROUP FROM SNMPv2-CONF
|
---|
12 | snmpTraps FROM SNMPv2-MIB
|
---|
13 | IANAifType FROM IANAifType-MIB;
|
---|
14 |
|
---|
15 |
|
---|
16 | ifMIB MODULE-IDENTITY
|
---|
17 | LAST-UPDATED "200006140000Z"
|
---|
18 | ORGANIZATION "IETF Interfaces MIB Working Group"
|
---|
19 | CONTACT-INFO
|
---|
20 | " Keith McCloghrie
|
---|
21 | Cisco Systems, Inc.
|
---|
22 | 170 West Tasman Drive
|
---|
23 | San Jose, CA 95134-1706
|
---|
24 | US
|
---|
25 |
|
---|
26 | 408-526-5260
|
---|
27 | kzm@cisco.com"
|
---|
28 | DESCRIPTION
|
---|
29 | "The MIB module to describe generic objects for network
|
---|
30 | interface sub-layers. This MIB is an updated version of
|
---|
31 | MIB-II's ifTable, and incorporates the extensions defined in
|
---|
32 | RFC 1229."
|
---|
33 |
|
---|
34 |
|
---|
35 | REVISION "200006140000Z"
|
---|
36 | DESCRIPTION
|
---|
37 | "Clarifications agreed upon by the Interfaces MIB WG, and
|
---|
38 | published as RFC 2863."
|
---|
39 | REVISION "199602282155Z"
|
---|
40 | DESCRIPTION
|
---|
41 | "Revisions made by the Interfaces MIB WG, and published in
|
---|
42 | RFC 2233."
|
---|
43 | REVISION "199311082155Z"
|
---|
44 | DESCRIPTION
|
---|
45 | "Initial revision, published as part of RFC 1573."
|
---|
46 | ::= { mib-2 31 }
|
---|
47 |
|
---|
48 |
|
---|
49 | ifMIBObjects OBJECT IDENTIFIER ::= { ifMIB 1 }
|
---|
50 |
|
---|
51 | interfaces OBJECT IDENTIFIER ::= { mib-2 2 }
|
---|
52 |
|
---|
53 | --
|
---|
54 | -- Textual Conventions
|
---|
55 | --
|
---|
56 |
|
---|
57 |
|
---|
58 | -- OwnerString has the same semantics as used in RFC 1271
|
---|
59 |
|
---|
60 | OwnerString ::= TEXTUAL-CONVENTION
|
---|
61 | DISPLAY-HINT "255a"
|
---|
62 | STATUS deprecated
|
---|
63 | DESCRIPTION
|
---|
64 | "This data type is used to model an administratively
|
---|
65 | assigned name of the owner of a resource. This information
|
---|
66 | is taken from the NVT ASCII character set. It is suggested
|
---|
67 | that this name contain one or more of the following: ASCII
|
---|
68 | form of the manager station's transport address, management
|
---|
69 | station name (e.g., domain name), network management
|
---|
70 | personnel's name, location, or phone number. In some cases
|
---|
71 | the agent itself will be the owner of an entry. In these
|
---|
72 | cases, this string shall be set to a string starting with
|
---|
73 | 'agent'."
|
---|
74 | SYNTAX OCTET STRING (SIZE(0..255))
|
---|
75 |
|
---|
76 | -- InterfaceIndex contains the semantics of ifIndex and should be used
|
---|
77 | -- for any objects defined in other MIB modules that need these semantics.
|
---|
78 |
|
---|
79 | InterfaceIndex ::= TEXTUAL-CONVENTION
|
---|
80 | DISPLAY-HINT "d"
|
---|
81 | STATUS current
|
---|
82 | DESCRIPTION
|
---|
83 |
|
---|
84 |
|
---|
85 | "A unique value, greater than zero, for each interface or
|
---|
86 | interface sub-layer in the managed system. It is
|
---|
87 | recommended that values are assigned contiguously starting
|
---|
88 | from 1. The value for each interface sub-layer must remain
|
---|
89 | constant at least from one re-initialization of the entity's
|
---|
90 | network management system to the next re-initialization."
|
---|
91 | SYNTAX Integer32 (1..2147483647)
|
---|
92 |
|
---|
93 | InterfaceIndexOrZero ::= TEXTUAL-CONVENTION
|
---|
94 | DISPLAY-HINT "d"
|
---|
95 | STATUS current
|
---|
96 | DESCRIPTION
|
---|
97 | "This textual convention is an extension of the
|
---|
98 | InterfaceIndex convention. The latter defines a greater
|
---|
99 | than zero value used to identify an interface or interface
|
---|
100 | sub-layer in the managed system. This extension permits the
|
---|
101 | additional value of zero. the value zero is object-specific
|
---|
102 | and must therefore be defined as part of the description of
|
---|
103 | any object which uses this syntax. Examples of the usage of
|
---|
104 | zero might include situations where interface was unknown,
|
---|
105 | or when none or all interfaces need to be referenced."
|
---|
106 | SYNTAX Integer32 (0..2147483647)
|
---|
107 |
|
---|
108 | ifNumber OBJECT-TYPE
|
---|
109 | SYNTAX Integer32
|
---|
110 | MAX-ACCESS read-only
|
---|
111 | STATUS current
|
---|
112 | DESCRIPTION
|
---|
113 | "The number of network interfaces (regardless of their
|
---|
114 | current state) present on this system."
|
---|
115 | ::= { interfaces 1 }
|
---|
116 |
|
---|
117 | ifTableLastChange OBJECT-TYPE
|
---|
118 | SYNTAX TimeTicks
|
---|
119 | MAX-ACCESS read-only
|
---|
120 | STATUS current
|
---|
121 | DESCRIPTION
|
---|
122 | "The value of sysUpTime at the time of the last creation or
|
---|
123 | deletion of an entry in the ifTable. If the number of
|
---|
124 | entries has been unchanged since the last re-initialization
|
---|
125 | of the local network management subsystem, then this object
|
---|
126 | contains a zero value."
|
---|
127 | ::= { ifMIBObjects 5 }
|
---|
128 |
|
---|
129 |
|
---|
130 | -- the Interfaces table
|
---|
131 |
|
---|
132 | -- The Interfaces table contains information on the entity's
|
---|
133 |
|
---|
134 |
|
---|
135 | -- interfaces. Each sub-layer below the internetwork-layer
|
---|
136 | -- of a network interface is considered to be an interface.
|
---|
137 |
|
---|
138 | ifTable OBJECT-TYPE
|
---|
139 | SYNTAX SEQUENCE OF IfEntry
|
---|
140 | MAX-ACCESS not-accessible
|
---|
141 | STATUS current
|
---|
142 | DESCRIPTION
|
---|
143 | "A list of interface entries. The number of entries is
|
---|
144 | given by the value of ifNumber."
|
---|
145 | ::= { interfaces 2 }
|
---|
146 |
|
---|
147 | ifEntry OBJECT-TYPE
|
---|
148 | SYNTAX IfEntry
|
---|
149 | MAX-ACCESS not-accessible
|
---|
150 | STATUS current
|
---|
151 | DESCRIPTION
|
---|
152 | "An entry containing management information applicable to a
|
---|
153 | particular interface."
|
---|
154 | INDEX { ifIndex }
|
---|
155 | ::= { ifTable 1 }
|
---|
156 |
|
---|
157 | IfEntry ::=
|
---|
158 | SEQUENCE {
|
---|
159 | ifIndex InterfaceIndex,
|
---|
160 | ifDescr DisplayString,
|
---|
161 | ifType IANAifType,
|
---|
162 | ifMtu Integer32,
|
---|
163 | ifSpeed Gauge32,
|
---|
164 | ifPhysAddress PhysAddress,
|
---|
165 | ifAdminStatus INTEGER,
|
---|
166 | ifOperStatus INTEGER,
|
---|
167 | ifLastChange TimeTicks,
|
---|
168 | ifInOctets Counter32,
|
---|
169 | ifInUcastPkts Counter32,
|
---|
170 | ifInNUcastPkts Counter32, -- deprecated
|
---|
171 | ifInDiscards Counter32,
|
---|
172 | ifInErrors Counter32,
|
---|
173 | ifInUnknownProtos Counter32,
|
---|
174 | ifOutOctets Counter32,
|
---|
175 | ifOutUcastPkts Counter32,
|
---|
176 | ifOutNUcastPkts Counter32, -- deprecated
|
---|
177 | ifOutDiscards Counter32,
|
---|
178 | ifOutErrors Counter32,
|
---|
179 | ifOutQLen Gauge32, -- deprecated
|
---|
180 | ifSpecific OBJECT IDENTIFIER -- deprecated
|
---|
181 | }
|
---|
182 |
|
---|
183 |
|
---|
184 |
|
---|
185 | ifIndex OBJECT-TYPE
|
---|
186 | SYNTAX InterfaceIndex
|
---|
187 | MAX-ACCESS read-only
|
---|
188 | STATUS current
|
---|
189 | DESCRIPTION
|
---|
190 | "A unique value, greater than zero, for each interface. It
|
---|
191 | is recommended that values are assigned contiguously
|
---|
192 | starting from 1. The value for each interface sub-layer
|
---|
193 | must remain constant at least from one re-initialization of
|
---|
194 | the entity's network management system to the next re-
|
---|
195 | initialization."
|
---|
196 | ::= { ifEntry 1 }
|
---|
197 |
|
---|
198 | ifDescr OBJECT-TYPE
|
---|
199 | SYNTAX DisplayString (SIZE (0..255))
|
---|
200 | MAX-ACCESS read-only
|
---|
201 | STATUS current
|
---|
202 | DESCRIPTION
|
---|
203 | "A textual string containing information about the
|
---|
204 | interface. This string should include the name of the
|
---|
205 | manufacturer, the product name and the version of the
|
---|
206 | interface hardware/software."
|
---|
207 | ::= { ifEntry 2 }
|
---|
208 |
|
---|
209 | ifType OBJECT-TYPE
|
---|
210 | SYNTAX IANAifType
|
---|
211 | MAX-ACCESS read-only
|
---|
212 | STATUS current
|
---|
213 | DESCRIPTION
|
---|
214 | "The type of interface. Additional values for ifType are
|
---|
215 | assigned by the Internet Assigned Numbers Authority (IANA),
|
---|
216 | through updating the syntax of the IANAifType textual
|
---|
217 | convention."
|
---|
218 | ::= { ifEntry 3 }
|
---|
219 |
|
---|
220 | ifMtu OBJECT-TYPE
|
---|
221 | SYNTAX Integer32
|
---|
222 | MAX-ACCESS read-only
|
---|
223 | STATUS current
|
---|
224 | DESCRIPTION
|
---|
225 | "The size of the largest packet which can be sent/received
|
---|
226 | on the interface, specified in octets. For interfaces that
|
---|
227 | are used for transmitting network datagrams, this is the
|
---|
228 | size of the largest network datagram that can be sent on the
|
---|
229 | interface."
|
---|
230 | ::= { ifEntry 4 }
|
---|
231 |
|
---|
232 | ifSpeed OBJECT-TYPE
|
---|
233 |
|
---|
234 |
|
---|
235 | SYNTAX Gauge32
|
---|
236 | MAX-ACCESS read-only
|
---|
237 | STATUS current
|
---|
238 | DESCRIPTION
|
---|
239 | "An estimate of the interface's current bandwidth in bits
|
---|
240 | per second. For interfaces which do not vary in bandwidth
|
---|
241 | or for those where no accurate estimation can be made, this
|
---|
242 | object should contain the nominal bandwidth. If the
|
---|
243 | bandwidth of the interface is greater than the maximum value
|
---|
244 | reportable by this object then this object should report its
|
---|
245 | maximum value (4,294,967,295) and ifHighSpeed must be used
|
---|
246 | to report the interace's speed. For a sub-layer which has
|
---|
247 | no concept of bandwidth, this object should be zero."
|
---|
248 | ::= { ifEntry 5 }
|
---|
249 |
|
---|
250 | ifPhysAddress OBJECT-TYPE
|
---|
251 | SYNTAX PhysAddress
|
---|
252 | MAX-ACCESS read-only
|
---|
253 | STATUS current
|
---|
254 | DESCRIPTION
|
---|
255 | "The interface's address at its protocol sub-layer. For
|
---|
256 | example, for an 802.x interface, this object normally
|
---|
257 | contains a MAC address. The interface's media-specific MIB
|
---|
258 | must define the bit and byte ordering and the format of the
|
---|
259 | value of this object. For interfaces which do not have such
|
---|
260 | an address (e.g., a serial line), this object should contain
|
---|
261 | an octet string of zero length."
|
---|
262 | ::= { ifEntry 6 }
|
---|
263 |
|
---|
264 | ifAdminStatus OBJECT-TYPE
|
---|
265 | SYNTAX INTEGER {
|
---|
266 | up(1), -- ready to pass packets
|
---|
267 | down(2),
|
---|
268 | testing(3) -- in some test mode
|
---|
269 | }
|
---|
270 | MAX-ACCESS read-write
|
---|
271 | STATUS current
|
---|
272 | DESCRIPTION
|
---|
273 | "The desired state of the interface. The testing(3) state
|
---|
274 | indicates that no operational packets can be passed. When a
|
---|
275 | managed system initializes, all interfaces start with
|
---|
276 | ifAdminStatus in the down(2) state. As a result of either
|
---|
277 | explicit management action or per configuration information
|
---|
278 | retained by the managed system, ifAdminStatus is then
|
---|
279 | changed to either the up(1) or testing(3) states (or remains
|
---|
280 | in the down(2) state)."
|
---|
281 | ::= { ifEntry 7 }
|
---|
282 |
|
---|
283 |
|
---|
284 |
|
---|
285 | ifOperStatus OBJECT-TYPE
|
---|
286 | SYNTAX INTEGER {
|
---|
287 | up(1), -- ready to pass packets
|
---|
288 | down(2),
|
---|
289 | testing(3), -- in some test mode
|
---|
290 | unknown(4), -- status can not be determined
|
---|
291 | -- for some reason.
|
---|
292 | dormant(5),
|
---|
293 | notPresent(6), -- some component is missing
|
---|
294 | lowerLayerDown(7) -- down due to state of
|
---|
295 | -- lower-layer interface(s)
|
---|
296 | }
|
---|
297 | MAX-ACCESS read-only
|
---|
298 | STATUS current
|
---|
299 | DESCRIPTION
|
---|
300 | "The current operational state of the interface. The
|
---|
301 | testing(3) state indicates that no operational packets can
|
---|
302 | be passed. If ifAdminStatus is down(2) then ifOperStatus
|
---|
303 | should be down(2). If ifAdminStatus is changed to up(1)
|
---|
304 | then ifOperStatus should change to up(1) if the interface is
|
---|
305 | ready to transmit and receive network traffic; it should
|
---|
306 | change to dormant(5) if the interface is waiting for
|
---|
307 | external actions (such as a serial line waiting for an
|
---|
308 | incoming connection); it should remain in the down(2) state
|
---|
309 | if and only if there is a fault that prevents it from going
|
---|
310 | to the up(1) state; it should remain in the notPresent(6)
|
---|
311 | state if the interface has missing (typically, hardware)
|
---|
312 | components."
|
---|
313 | ::= { ifEntry 8 }
|
---|
314 |
|
---|
315 | ifLastChange OBJECT-TYPE
|
---|
316 | SYNTAX TimeTicks
|
---|
317 | MAX-ACCESS read-only
|
---|
318 | STATUS current
|
---|
319 | DESCRIPTION
|
---|
320 | "The value of sysUpTime at the time the interface entered
|
---|
321 | its current operational state. If the current state was
|
---|
322 | entered prior to the last re-initialization of the local
|
---|
323 | network management subsystem, then this object contains a
|
---|
324 | zero value."
|
---|
325 | ::= { ifEntry 9 }
|
---|
326 |
|
---|
327 | ifInOctets OBJECT-TYPE
|
---|
328 | SYNTAX Counter32
|
---|
329 | MAX-ACCESS read-only
|
---|
330 | STATUS current
|
---|
331 | DESCRIPTION
|
---|
332 | "The total number of octets received on the interface,
|
---|
333 |
|
---|
334 |
|
---|
335 | including framing characters.
|
---|
336 |
|
---|
337 | Discontinuities in the value of this counter can occur at
|
---|
338 | re-initialization of the management system, and at other
|
---|
339 | times as indicated by the value of
|
---|
340 | ifCounterDiscontinuityTime."
|
---|
341 | ::= { ifEntry 10 }
|
---|
342 |
|
---|
343 | ifInUcastPkts OBJECT-TYPE
|
---|
344 | SYNTAX Counter32
|
---|
345 | MAX-ACCESS read-only
|
---|
346 | STATUS current
|
---|
347 | DESCRIPTION
|
---|
348 | "The number of packets, delivered by this sub-layer to a
|
---|
349 | higher (sub-)layer, which were not addressed to a multicast
|
---|
350 | or broadcast address at this sub-layer.
|
---|
351 |
|
---|
352 | Discontinuities in the value of this counter can occur at
|
---|
353 | re-initialization of the management system, and at other
|
---|
354 | times as indicated by the value of
|
---|
355 | ifCounterDiscontinuityTime."
|
---|
356 | ::= { ifEntry 11 }
|
---|
357 |
|
---|
358 | ifInNUcastPkts OBJECT-TYPE
|
---|
359 | SYNTAX Counter32
|
---|
360 | MAX-ACCESS read-only
|
---|
361 | STATUS deprecated
|
---|
362 | DESCRIPTION
|
---|
363 | "The number of packets, delivered by this sub-layer to a
|
---|
364 | higher (sub-)layer, which were addressed to a multicast or
|
---|
365 | broadcast address at this sub-layer.
|
---|
366 |
|
---|
367 | Discontinuities in the value of this counter can occur at
|
---|
368 | re-initialization of the management system, and at other
|
---|
369 | times as indicated by the value of
|
---|
370 | ifCounterDiscontinuityTime.
|
---|
371 |
|
---|
372 | This object is deprecated in favour of ifInMulticastPkts and
|
---|
373 | ifInBroadcastPkts."
|
---|
374 | ::= { ifEntry 12 }
|
---|
375 |
|
---|
376 | ifInDiscards OBJECT-TYPE
|
---|
377 | SYNTAX Counter32
|
---|
378 | MAX-ACCESS read-only
|
---|
379 | STATUS current
|
---|
380 | DESCRIPTION
|
---|
381 | "The number of inbound packets which were chosen to be
|
---|
382 | discarded even though no errors had been detected to prevent
|
---|
383 |
|
---|
384 |
|
---|
385 | their being deliverable to a higher-layer protocol. One
|
---|
386 | possible reason for discarding such a packet could be to
|
---|
387 | free up buffer space.
|
---|
388 |
|
---|
389 | Discontinuities in the value of this counter can occur at
|
---|
390 | re-initialization of the management system, and at other
|
---|
391 | times as indicated by the value of
|
---|
392 | ifCounterDiscontinuityTime."
|
---|
393 | ::= { ifEntry 13 }
|
---|
394 |
|
---|
395 | ifInErrors OBJECT-TYPE
|
---|
396 | SYNTAX Counter32
|
---|
397 | MAX-ACCESS read-only
|
---|
398 | STATUS current
|
---|
399 | DESCRIPTION
|
---|
400 | "For packet-oriented interfaces, the number of inbound
|
---|
401 | packets that contained errors preventing them from being
|
---|
402 | deliverable to a higher-layer protocol. For character-
|
---|
403 | oriented or fixed-length interfaces, the number of inbound
|
---|
404 | transmission units that contained errors preventing them
|
---|
405 | from being deliverable to a higher-layer protocol.
|
---|
406 |
|
---|
407 | Discontinuities in the value of this counter can occur at
|
---|
408 | re-initialization of the management system, and at other
|
---|
409 | times as indicated by the value of
|
---|
410 | ifCounterDiscontinuityTime."
|
---|
411 | ::= { ifEntry 14 }
|
---|
412 |
|
---|
413 | ifInUnknownProtos OBJECT-TYPE
|
---|
414 | SYNTAX Counter32
|
---|
415 | MAX-ACCESS read-only
|
---|
416 | STATUS current
|
---|
417 | DESCRIPTION
|
---|
418 | "For packet-oriented interfaces, the number of packets
|
---|
419 | received via the interface which were discarded because of
|
---|
420 | an unknown or unsupported protocol. For character-oriented
|
---|
421 | or fixed-length interfaces that support protocol
|
---|
422 | multiplexing the number of transmission units received via
|
---|
423 | the interface which were discarded because of an unknown or
|
---|
424 | unsupported protocol. For any interface that does not
|
---|
425 | support protocol multiplexing, this counter will always be
|
---|
426 | 0.
|
---|
427 |
|
---|
428 | Discontinuities in the value of this counter can occur at
|
---|
429 | re-initialization of the management system, and at other
|
---|
430 | times as indicated by the value of
|
---|
431 | ifCounterDiscontinuityTime."
|
---|
432 | ::= { ifEntry 15 }
|
---|
433 |
|
---|
434 |
|
---|
435 | ifOutOctets OBJECT-TYPE
|
---|
436 | SYNTAX Counter32
|
---|
437 | MAX-ACCESS read-only
|
---|
438 | STATUS current
|
---|
439 | DESCRIPTION
|
---|
440 | "The total number of octets transmitted out of the
|
---|
441 | interface, including framing characters.
|
---|
442 |
|
---|
443 | Discontinuities in the value of this counter can occur at
|
---|
444 | re-initialization of the management system, and at other
|
---|
445 | times as indicated by the value of
|
---|
446 | ifCounterDiscontinuityTime."
|
---|
447 | ::= { ifEntry 16 }
|
---|
448 |
|
---|
449 | ifOutUcastPkts OBJECT-TYPE
|
---|
450 | SYNTAX Counter32
|
---|
451 | MAX-ACCESS read-only
|
---|
452 | STATUS current
|
---|
453 | DESCRIPTION
|
---|
454 | "The total number of packets that higher-level protocols
|
---|
455 | requested be transmitted, and which were not addressed to a
|
---|
456 | multicast or broadcast address at this sub-layer, including
|
---|
457 | those that were discarded or not sent.
|
---|
458 |
|
---|
459 | Discontinuities in the value of this counter can occur at
|
---|
460 | re-initialization of the management system, and at other
|
---|
461 | times as indicated by the value of
|
---|
462 | ifCounterDiscontinuityTime."
|
---|
463 | ::= { ifEntry 17 }
|
---|
464 |
|
---|
465 | ifOutNUcastPkts OBJECT-TYPE
|
---|
466 | SYNTAX Counter32
|
---|
467 | MAX-ACCESS read-only
|
---|
468 | STATUS deprecated
|
---|
469 | DESCRIPTION
|
---|
470 | "The total number of packets that higher-level protocols
|
---|
471 | requested be transmitted, and which were addressed to a
|
---|
472 | multicast or broadcast address at this sub-layer, including
|
---|
473 | those that were discarded or not sent.
|
---|
474 |
|
---|
475 | Discontinuities in the value of this counter can occur at
|
---|
476 | re-initialization of the management system, and at other
|
---|
477 | times as indicated by the value of
|
---|
478 | ifCounterDiscontinuityTime.
|
---|
479 |
|
---|
480 | This object is deprecated in favour of ifOutMulticastPkts
|
---|
481 | and ifOutBroadcastPkts."
|
---|
482 | ::= { ifEntry 18 }
|
---|
483 |
|
---|
484 |
|
---|
485 | ifOutDiscards OBJECT-TYPE
|
---|
486 | SYNTAX Counter32
|
---|
487 | MAX-ACCESS read-only
|
---|
488 | STATUS current
|
---|
489 | DESCRIPTION
|
---|
490 | "The number of outbound packets which were chosen to be
|
---|
491 | discarded even though no errors had been detected to prevent
|
---|
492 | their being transmitted. One possible reason for discarding
|
---|
493 | such a packet could be to free up buffer space.
|
---|
494 |
|
---|
495 | Discontinuities in the value of this counter can occur at
|
---|
496 | re-initialization of the management system, and at other
|
---|
497 | times as indicated by the value of
|
---|
498 | ifCounterDiscontinuityTime."
|
---|
499 | ::= { ifEntry 19 }
|
---|
500 |
|
---|
501 | ifOutErrors OBJECT-TYPE
|
---|
502 | SYNTAX Counter32
|
---|
503 | MAX-ACCESS read-only
|
---|
504 | STATUS current
|
---|
505 | DESCRIPTION
|
---|
506 | "For packet-oriented interfaces, the number of outbound
|
---|
507 | packets that could not be transmitted because of errors.
|
---|
508 | For character-oriented or fixed-length interfaces, the
|
---|
509 | number of outbound transmission units that could not be
|
---|
510 | transmitted because of errors.
|
---|
511 |
|
---|
512 | Discontinuities in the value of this counter can occur at
|
---|
513 | re-initialization of the management system, and at other
|
---|
514 | times as indicated by the value of
|
---|
515 | ifCounterDiscontinuityTime."
|
---|
516 | ::= { ifEntry 20 }
|
---|
517 |
|
---|
518 | ifOutQLen OBJECT-TYPE
|
---|
519 | SYNTAX Gauge32
|
---|
520 | MAX-ACCESS read-only
|
---|
521 | STATUS deprecated
|
---|
522 | DESCRIPTION
|
---|
523 | "The length of the output packet queue (in packets)."
|
---|
524 | ::= { ifEntry 21 }
|
---|
525 |
|
---|
526 | ifSpecific OBJECT-TYPE
|
---|
527 | SYNTAX OBJECT IDENTIFIER
|
---|
528 | MAX-ACCESS read-only
|
---|
529 | STATUS deprecated
|
---|
530 | DESCRIPTION
|
---|
531 | "A reference to MIB definitions specific to the particular
|
---|
532 | media being used to realize the interface. It is
|
---|
533 |
|
---|
534 |
|
---|
535 | recommended that this value point to an instance of a MIB
|
---|
536 | object in the media-specific MIB, i.e., that this object
|
---|
537 | have the semantics associated with the InstancePointer
|
---|
538 | textual convention defined in RFC 2579. In fact, it is
|
---|
539 | recommended that the media-specific MIB specify what value
|
---|
540 | ifSpecific should/can take for values of ifType. If no MIB
|
---|
541 | definitions specific to the particular media are available,
|
---|
542 | the value should be set to the OBJECT IDENTIFIER { 0 0 }."
|
---|
543 | ::= { ifEntry 22 }
|
---|
544 |
|
---|
545 |
|
---|
546 |
|
---|
547 | --
|
---|
548 | -- Extension to the interface table
|
---|
549 | --
|
---|
550 | -- This table replaces the ifExtnsTable table.
|
---|
551 | --
|
---|
552 |
|
---|
553 | ifXTable OBJECT-TYPE
|
---|
554 | SYNTAX SEQUENCE OF IfXEntry
|
---|
555 | MAX-ACCESS not-accessible
|
---|
556 | STATUS current
|
---|
557 | DESCRIPTION
|
---|
558 | "A list of interface entries. The number of entries is
|
---|
559 | given by the value of ifNumber. This table contains
|
---|
560 | additional objects for the interface table."
|
---|
561 | ::= { ifMIBObjects 1 }
|
---|
562 |
|
---|
563 | ifXEntry OBJECT-TYPE
|
---|
564 | SYNTAX IfXEntry
|
---|
565 | MAX-ACCESS not-accessible
|
---|
566 | STATUS current
|
---|
567 | DESCRIPTION
|
---|
568 | "An entry containing additional management information
|
---|
569 | applicable to a particular interface."
|
---|
570 | AUGMENTS { ifEntry }
|
---|
571 | ::= { ifXTable 1 }
|
---|
572 |
|
---|
573 | IfXEntry ::=
|
---|
574 | SEQUENCE {
|
---|
575 | ifName DisplayString,
|
---|
576 | ifInMulticastPkts Counter32,
|
---|
577 | ifInBroadcastPkts Counter32,
|
---|
578 | ifOutMulticastPkts Counter32,
|
---|
579 | ifOutBroadcastPkts Counter32,
|
---|
580 | ifHCInOctets Counter64,
|
---|
581 | ifHCInUcastPkts Counter64,
|
---|
582 | ifHCInMulticastPkts Counter64,
|
---|
583 |
|
---|
584 |
|
---|
585 | ifHCInBroadcastPkts Counter64,
|
---|
586 | ifHCOutOctets Counter64,
|
---|
587 | ifHCOutUcastPkts Counter64,
|
---|
588 | ifHCOutMulticastPkts Counter64,
|
---|
589 | ifHCOutBroadcastPkts Counter64,
|
---|
590 | ifLinkUpDownTrapEnable INTEGER,
|
---|
591 | ifHighSpeed Gauge32,
|
---|
592 | ifPromiscuousMode TruthValue,
|
---|
593 | ifConnectorPresent TruthValue,
|
---|
594 | ifAlias DisplayString,
|
---|
595 | ifCounterDiscontinuityTime TimeStamp
|
---|
596 | }
|
---|
597 |
|
---|
598 |
|
---|
599 | ifName OBJECT-TYPE
|
---|
600 | SYNTAX DisplayString
|
---|
601 | MAX-ACCESS read-only
|
---|
602 | STATUS current
|
---|
603 | DESCRIPTION
|
---|
604 | "The textual name of the interface. The value of this
|
---|
605 | object should be the name of the interface as assigned by
|
---|
606 | the local device and should be suitable for use in commands
|
---|
607 | entered at the device's `console'. This might be a text
|
---|
608 | name, such as `le0' or a simple port number, such as `1',
|
---|
609 | depending on the interface naming syntax of the device. If
|
---|
610 | several entries in the ifTable together represent a single
|
---|
611 | interface as named by the device, then each will have the
|
---|
612 | same value of ifName. Note that for an agent which responds
|
---|
613 | to SNMP queries concerning an interface on some other
|
---|
614 | (proxied) device, then the value of ifName for such an
|
---|
615 | interface is the proxied device's local name for it.
|
---|
616 |
|
---|
617 | If there is no local name, or this object is otherwise not
|
---|
618 | applicable, then this object contains a zero-length string."
|
---|
619 | ::= { ifXEntry 1 }
|
---|
620 |
|
---|
621 | ifInMulticastPkts OBJECT-TYPE
|
---|
622 | SYNTAX Counter32
|
---|
623 | MAX-ACCESS read-only
|
---|
624 | STATUS current
|
---|
625 | DESCRIPTION
|
---|
626 | "The number of packets, delivered by this sub-layer to a
|
---|
627 | higher (sub-)layer, which were addressed to a multicast
|
---|
628 | address at this sub-layer. For a MAC layer protocol, this
|
---|
629 | includes both Group and Functional addresses.
|
---|
630 |
|
---|
631 | Discontinuities in the value of this counter can occur at
|
---|
632 | re-initialization of the management system, and at other
|
---|
633 |
|
---|
634 |
|
---|
635 | times as indicated by the value of
|
---|
636 | ifCounterDiscontinuityTime."
|
---|
637 | ::= { ifXEntry 2 }
|
---|
638 |
|
---|
639 | ifInBroadcastPkts OBJECT-TYPE
|
---|
640 | SYNTAX Counter32
|
---|
641 | MAX-ACCESS read-only
|
---|
642 | STATUS current
|
---|
643 | DESCRIPTION
|
---|
644 | "The number of packets, delivered by this sub-layer to a
|
---|
645 | higher (sub-)layer, which were addressed to a broadcast
|
---|
646 | address at this sub-layer.
|
---|
647 |
|
---|
648 | Discontinuities in the value of this counter can occur at
|
---|
649 | re-initialization of the management system, and at other
|
---|
650 | times as indicated by the value of
|
---|
651 | ifCounterDiscontinuityTime."
|
---|
652 | ::= { ifXEntry 3 }
|
---|
653 |
|
---|
654 | ifOutMulticastPkts OBJECT-TYPE
|
---|
655 | SYNTAX Counter32
|
---|
656 | MAX-ACCESS read-only
|
---|
657 | STATUS current
|
---|
658 | DESCRIPTION
|
---|
659 | "The total number of packets that higher-level protocols
|
---|
660 | requested be transmitted, and which were addressed to a
|
---|
661 | multicast address at this sub-layer, including those that
|
---|
662 | were discarded or not sent. For a MAC layer protocol, this
|
---|
663 | includes both Group and Functional addresses.
|
---|
664 |
|
---|
665 | Discontinuities in the value of this counter can occur at
|
---|
666 | re-initialization of the management system, and at other
|
---|
667 | times as indicated by the value of
|
---|
668 | ifCounterDiscontinuityTime."
|
---|
669 | ::= { ifXEntry 4 }
|
---|
670 |
|
---|
671 | ifOutBroadcastPkts OBJECT-TYPE
|
---|
672 | SYNTAX Counter32
|
---|
673 | MAX-ACCESS read-only
|
---|
674 | STATUS current
|
---|
675 | DESCRIPTION
|
---|
676 | "The total number of packets that higher-level protocols
|
---|
677 | requested be transmitted, and which were addressed to a
|
---|
678 | broadcast address at this sub-layer, including those that
|
---|
679 | were discarded or not sent.
|
---|
680 |
|
---|
681 | Discontinuities in the value of this counter can occur at
|
---|
682 | re-initialization of the management system, and at other
|
---|
683 |
|
---|
684 |
|
---|
685 | times as indicated by the value of
|
---|
686 | ifCounterDiscontinuityTime."
|
---|
687 | ::= { ifXEntry 5 }
|
---|
688 |
|
---|
689 | --
|
---|
690 | -- High Capacity Counter objects. These objects are all
|
---|
691 | -- 64 bit versions of the "basic" ifTable counters. These
|
---|
692 | -- objects all have the same basic semantics as their 32-bit
|
---|
693 | -- counterparts, however, their syntax has been extended
|
---|
694 | -- to 64 bits.
|
---|
695 | --
|
---|
696 |
|
---|
697 | ifHCInOctets OBJECT-TYPE
|
---|
698 | SYNTAX Counter64
|
---|
699 | MAX-ACCESS read-only
|
---|
700 | STATUS current
|
---|
701 | DESCRIPTION
|
---|
702 | "The total number of octets received on the interface,
|
---|
703 | including framing characters. This object is a 64-bit
|
---|
704 | version of ifInOctets.
|
---|
705 |
|
---|
706 | Discontinuities in the value of this counter can occur at
|
---|
707 | re-initialization of the management system, and at other
|
---|
708 | times as indicated by the value of
|
---|
709 | ifCounterDiscontinuityTime."
|
---|
710 | ::= { ifXEntry 6 }
|
---|
711 |
|
---|
712 | ifHCInUcastPkts OBJECT-TYPE
|
---|
713 | SYNTAX Counter64
|
---|
714 | MAX-ACCESS read-only
|
---|
715 | STATUS current
|
---|
716 | DESCRIPTION
|
---|
717 | "The number of packets, delivered by this sub-layer to a
|
---|
718 | higher (sub-)layer, which were not addressed to a multicast
|
---|
719 | or broadcast address at this sub-layer. This object is a
|
---|
720 | 64-bit version of ifInUcastPkts.
|
---|
721 |
|
---|
722 | Discontinuities in the value of this counter can occur at
|
---|
723 | re-initialization of the management system, and at other
|
---|
724 | times as indicated by the value of
|
---|
725 | ifCounterDiscontinuityTime."
|
---|
726 | ::= { ifXEntry 7 }
|
---|
727 |
|
---|
728 | ifHCInMulticastPkts OBJECT-TYPE
|
---|
729 | SYNTAX Counter64
|
---|
730 | MAX-ACCESS read-only
|
---|
731 | STATUS current
|
---|
732 | DESCRIPTION
|
---|
733 |
|
---|
734 |
|
---|
735 | "The number of packets, delivered by this sub-layer to a
|
---|
736 | higher (sub-)layer, which were addressed to a multicast
|
---|
737 | address at this sub-layer. For a MAC layer protocol, this
|
---|
738 | includes both Group and Functional addresses. This object
|
---|
739 | is a 64-bit version of ifInMulticastPkts.
|
---|
740 |
|
---|
741 | Discontinuities in the value of this counter can occur at
|
---|
742 | re-initialization of the management system, and at other
|
---|
743 | times as indicated by the value of
|
---|
744 | ifCounterDiscontinuityTime."
|
---|
745 | ::= { ifXEntry 8 }
|
---|
746 |
|
---|
747 | ifHCInBroadcastPkts OBJECT-TYPE
|
---|
748 | SYNTAX Counter64
|
---|
749 | MAX-ACCESS read-only
|
---|
750 | STATUS current
|
---|
751 | DESCRIPTION
|
---|
752 | "The number of packets, delivered by this sub-layer to a
|
---|
753 | higher (sub-)layer, which were addressed to a broadcast
|
---|
754 | address at this sub-layer. This object is a 64-bit version
|
---|
755 | of ifInBroadcastPkts.
|
---|
756 |
|
---|
757 | Discontinuities in the value of this counter can occur at
|
---|
758 | re-initialization of the management system, and at other
|
---|
759 | times as indicated by the value of
|
---|
760 | ifCounterDiscontinuityTime."
|
---|
761 | ::= { ifXEntry 9 }
|
---|
762 |
|
---|
763 | ifHCOutOctets OBJECT-TYPE
|
---|
764 | SYNTAX Counter64
|
---|
765 | MAX-ACCESS read-only
|
---|
766 | STATUS current
|
---|
767 | DESCRIPTION
|
---|
768 | "The total number of octets transmitted out of the
|
---|
769 | interface, including framing characters. This object is a
|
---|
770 | 64-bit version of ifOutOctets.
|
---|
771 |
|
---|
772 | Discontinuities in the value of this counter can occur at
|
---|
773 | re-initialization of the management system, and at other
|
---|
774 | times as indicated by the value of
|
---|
775 | ifCounterDiscontinuityTime."
|
---|
776 | ::= { ifXEntry 10 }
|
---|
777 |
|
---|
778 | ifHCOutUcastPkts OBJECT-TYPE
|
---|
779 | SYNTAX Counter64
|
---|
780 | MAX-ACCESS read-only
|
---|
781 | STATUS current
|
---|
782 | DESCRIPTION
|
---|
783 |
|
---|
784 |
|
---|
785 | "The total number of packets that higher-level protocols
|
---|
786 | requested be transmitted, and which were not addressed to a
|
---|
787 | multicast or broadcast address at this sub-layer, including
|
---|
788 | those that were discarded or not sent. This object is a
|
---|
789 | 64-bit version of ifOutUcastPkts.
|
---|
790 |
|
---|
791 | Discontinuities in the value of this counter can occur at
|
---|
792 | re-initialization of the management system, and at other
|
---|
793 | times as indicated by the value of
|
---|
794 | ifCounterDiscontinuityTime."
|
---|
795 | ::= { ifXEntry 11 }
|
---|
796 |
|
---|
797 | ifHCOutMulticastPkts OBJECT-TYPE
|
---|
798 | SYNTAX Counter64
|
---|
799 | MAX-ACCESS read-only
|
---|
800 | STATUS current
|
---|
801 | DESCRIPTION
|
---|
802 | "The total number of packets that higher-level protocols
|
---|
803 | requested be transmitted, and which were addressed to a
|
---|
804 | multicast address at this sub-layer, including those that
|
---|
805 | were discarded or not sent. For a MAC layer protocol, this
|
---|
806 | includes both Group and Functional addresses. This object
|
---|
807 | is a 64-bit version of ifOutMulticastPkts.
|
---|
808 |
|
---|
809 | Discontinuities in the value of this counter can occur at
|
---|
810 | re-initialization of the management system, and at other
|
---|
811 | times as indicated by the value of
|
---|
812 | ifCounterDiscontinuityTime."
|
---|
813 | ::= { ifXEntry 12 }
|
---|
814 |
|
---|
815 | ifHCOutBroadcastPkts OBJECT-TYPE
|
---|
816 | SYNTAX Counter64
|
---|
817 | MAX-ACCESS read-only
|
---|
818 | STATUS current
|
---|
819 | DESCRIPTION
|
---|
820 | "The total number of packets that higher-level protocols
|
---|
821 | requested be transmitted, and which were addressed to a
|
---|
822 | broadcast address at this sub-layer, including those that
|
---|
823 | were discarded or not sent. This object is a 64-bit version
|
---|
824 | of ifOutBroadcastPkts.
|
---|
825 |
|
---|
826 | Discontinuities in the value of this counter can occur at
|
---|
827 | re-initialization of the management system, and at other
|
---|
828 | times as indicated by the value of
|
---|
829 | ifCounterDiscontinuityTime."
|
---|
830 | ::= { ifXEntry 13 }
|
---|
831 |
|
---|
832 | ifLinkUpDownTrapEnable OBJECT-TYPE
|
---|
833 |
|
---|
834 |
|
---|
835 | SYNTAX INTEGER { enabled(1), disabled(2) }
|
---|
836 | MAX-ACCESS read-write
|
---|
837 | STATUS current
|
---|
838 | DESCRIPTION
|
---|
839 | "Indicates whether linkUp/linkDown traps should be generated
|
---|
840 | for this interface.
|
---|
841 |
|
---|
842 | By default, this object should have the value enabled(1) for
|
---|
843 | interfaces which do not operate on 'top' of any other
|
---|
844 | interface (as defined in the ifStackTable), and disabled(2)
|
---|
845 | otherwise."
|
---|
846 | ::= { ifXEntry 14 }
|
---|
847 |
|
---|
848 | ifHighSpeed OBJECT-TYPE
|
---|
849 | SYNTAX Gauge32
|
---|
850 | MAX-ACCESS read-only
|
---|
851 | STATUS current
|
---|
852 | DESCRIPTION
|
---|
853 | "An estimate of the interface's current bandwidth in units
|
---|
854 | of 1,000,000 bits per second. If this object reports a
|
---|
855 | value of `n' then the speed of the interface is somewhere in
|
---|
856 | the range of `n-500,000' to `n+499,999'. For interfaces
|
---|
857 | which do not vary in bandwidth or for those where no
|
---|
858 | accurate estimation can be made, this object should contain
|
---|
859 | the nominal bandwidth. For a sub-layer which has no concept
|
---|
860 | of bandwidth, this object should be zero."
|
---|
861 | ::= { ifXEntry 15 }
|
---|
862 |
|
---|
863 | ifPromiscuousMode OBJECT-TYPE
|
---|
864 | SYNTAX TruthValue
|
---|
865 | MAX-ACCESS read-write
|
---|
866 | STATUS current
|
---|
867 | DESCRIPTION
|
---|
868 | "This object has a value of false(2) if this interface only
|
---|
869 | accepts packets/frames that are addressed to this station.
|
---|
870 | This object has a value of true(1) when the station accepts
|
---|
871 | all packets/frames transmitted on the media. The value
|
---|
872 | true(1) is only legal on certain types of media. If legal,
|
---|
873 | setting this object to a value of true(1) may require the
|
---|
874 | interface to be reset before becoming effective.
|
---|
875 |
|
---|
876 | The value of ifPromiscuousMode does not affect the reception
|
---|
877 | of broadcast and multicast packets/frames by the interface."
|
---|
878 | ::= { ifXEntry 16 }
|
---|
879 |
|
---|
880 | ifConnectorPresent OBJECT-TYPE
|
---|
881 | SYNTAX TruthValue
|
---|
882 | MAX-ACCESS read-only
|
---|
883 |
|
---|
884 |
|
---|
885 | STATUS current
|
---|
886 | DESCRIPTION
|
---|
887 | "This object has the value 'true(1)' if the interface
|
---|
888 | sublayer has a physical connector and the value 'false(2)'
|
---|
889 | otherwise."
|
---|
890 | ::= { ifXEntry 17 }
|
---|
891 |
|
---|
892 | ifAlias OBJECT-TYPE
|
---|
893 | SYNTAX DisplayString (SIZE(0..64))
|
---|
894 | MAX-ACCESS read-write
|
---|
895 | STATUS current
|
---|
896 | DESCRIPTION
|
---|
897 | "This object is an 'alias' name for the interface as
|
---|
898 | specified by a network manager, and provides a non-volatile
|
---|
899 | 'handle' for the interface.
|
---|
900 |
|
---|
901 | On the first instantiation of an interface, the value of
|
---|
902 | ifAlias associated with that interface is the zero-length
|
---|
903 | string. As and when a value is written into an instance of
|
---|
904 | ifAlias through a network management set operation, then the
|
---|
905 | agent must retain the supplied value in the ifAlias instance
|
---|
906 | associated with the same interface for as long as that
|
---|
907 | interface remains instantiated, including across all re-
|
---|
908 | initializations/reboots of the network management system,
|
---|
909 | including those which result in a change of the interface's
|
---|
910 | ifIndex value.
|
---|
911 |
|
---|
912 | An example of the value which a network manager might store
|
---|
913 | in this object for a WAN interface is the (Telco's) circuit
|
---|
914 | number/identifier of the interface.
|
---|
915 |
|
---|
916 | Some agents may support write-access only for interfaces
|
---|
917 | having particular values of ifType. An agent which supports
|
---|
918 | write access to this object is required to keep the value in
|
---|
919 | non-volatile storage, but it may limit the length of new
|
---|
920 | values depending on how much storage is already occupied by
|
---|
921 | the current values for other interfaces."
|
---|
922 | ::= { ifXEntry 18 }
|
---|
923 |
|
---|
924 | ifCounterDiscontinuityTime OBJECT-TYPE
|
---|
925 | SYNTAX TimeStamp
|
---|
926 | MAX-ACCESS read-only
|
---|
927 | STATUS current
|
---|
928 | DESCRIPTION
|
---|
929 | "The value of sysUpTime on the most recent occasion at which
|
---|
930 | any one or more of this interface's counters suffered a
|
---|
931 | discontinuity. The relevant counters are the specific
|
---|
932 | instances associated with this interface of any Counter32 or
|
---|
933 |
|
---|
934 |
|
---|
935 | Counter64 object contained in the ifTable or ifXTable. If
|
---|
936 | no such discontinuities have occurred since the last re-
|
---|
937 | initialization of the local management subsystem, then this
|
---|
938 | object contains a zero value."
|
---|
939 | ::= { ifXEntry 19 }
|
---|
940 |
|
---|
941 | -- The Interface Stack Group
|
---|
942 | --
|
---|
943 | -- Implementation of this group is optional, but strongly recommended
|
---|
944 | -- for all systems
|
---|
945 | --
|
---|
946 |
|
---|
947 | ifStackTable OBJECT-TYPE
|
---|
948 | SYNTAX SEQUENCE OF IfStackEntry
|
---|
949 | MAX-ACCESS not-accessible
|
---|
950 | STATUS current
|
---|
951 | DESCRIPTION
|
---|
952 | "The table containing information on the relationships
|
---|
953 | between the multiple sub-layers of network interfaces. In
|
---|
954 | particular, it contains information on which sub-layers run
|
---|
955 | 'on top of' which other sub-layers, where each sub-layer
|
---|
956 | corresponds to a conceptual row in the ifTable. For
|
---|
957 | example, when the sub-layer with ifIndex value x runs over
|
---|
958 | the sub-layer with ifIndex value y, then this table
|
---|
959 | contains:
|
---|
960 |
|
---|
961 | ifStackStatus.x.y=active
|
---|
962 |
|
---|
963 | For each ifIndex value, I, which identifies an active
|
---|
964 | interface, there are always at least two instantiated rows
|
---|
965 | in this table associated with I. For one of these rows, I
|
---|
966 | is the value of ifStackHigherLayer; for the other, I is the
|
---|
967 | value of ifStackLowerLayer. (If I is not involved in
|
---|
968 | multiplexing, then these are the only two rows associated
|
---|
969 | with I.)
|
---|
970 |
|
---|
971 | For example, two rows exist even for an interface which has
|
---|
972 | no others stacked on top or below it:
|
---|
973 |
|
---|
974 | ifStackStatus.0.x=active
|
---|
975 | ifStackStatus.x.0=active "
|
---|
976 | ::= { ifMIBObjects 2 }
|
---|
977 |
|
---|
978 |
|
---|
979 | ifStackEntry OBJECT-TYPE
|
---|
980 | SYNTAX IfStackEntry
|
---|
981 | MAX-ACCESS not-accessible
|
---|
982 | STATUS current
|
---|
983 |
|
---|
984 |
|
---|
985 | DESCRIPTION
|
---|
986 | "Information on a particular relationship between two sub-
|
---|
987 | layers, specifying that one sub-layer runs on 'top' of the
|
---|
988 | other sub-layer. Each sub-layer corresponds to a conceptual
|
---|
989 | row in the ifTable."
|
---|
990 | INDEX { ifStackHigherLayer, ifStackLowerLayer }
|
---|
991 | ::= { ifStackTable 1 }
|
---|
992 |
|
---|
993 |
|
---|
994 | IfStackEntry ::=
|
---|
995 | SEQUENCE {
|
---|
996 | ifStackHigherLayer InterfaceIndexOrZero,
|
---|
997 | ifStackLowerLayer InterfaceIndexOrZero,
|
---|
998 | ifStackStatus RowStatus
|
---|
999 | }
|
---|
1000 |
|
---|
1001 |
|
---|
1002 | ifStackHigherLayer OBJECT-TYPE
|
---|
1003 | SYNTAX InterfaceIndexOrZero
|
---|
1004 | MAX-ACCESS not-accessible
|
---|
1005 | STATUS current
|
---|
1006 | DESCRIPTION
|
---|
1007 | "The value of ifIndex corresponding to the higher sub-layer
|
---|
1008 | of the relationship, i.e., the sub-layer which runs on 'top'
|
---|
1009 | of the sub-layer identified by the corresponding instance of
|
---|
1010 | ifStackLowerLayer. If there is no higher sub-layer (below
|
---|
1011 | the internetwork layer), then this object has the value 0."
|
---|
1012 | ::= { ifStackEntry 1 }
|
---|
1013 |
|
---|
1014 |
|
---|
1015 | ifStackLowerLayer OBJECT-TYPE
|
---|
1016 | SYNTAX InterfaceIndexOrZero
|
---|
1017 | MAX-ACCESS not-accessible
|
---|
1018 | STATUS current
|
---|
1019 | DESCRIPTION
|
---|
1020 | "The value of ifIndex corresponding to the lower sub-layer
|
---|
1021 | of the relationship, i.e., the sub-layer which runs 'below'
|
---|
1022 | the sub-layer identified by the corresponding instance of
|
---|
1023 | ifStackHigherLayer. If there is no lower sub-layer, then
|
---|
1024 | this object has the value 0."
|
---|
1025 | ::= { ifStackEntry 2 }
|
---|
1026 |
|
---|
1027 |
|
---|
1028 | ifStackStatus OBJECT-TYPE
|
---|
1029 | SYNTAX RowStatus
|
---|
1030 | MAX-ACCESS read-create
|
---|
1031 | STATUS current
|
---|
1032 | DESCRIPTION
|
---|
1033 |
|
---|
1034 |
|
---|
1035 | "The status of the relationship between two sub-layers.
|
---|
1036 |
|
---|
1037 | Changing the value of this object from 'active' to
|
---|
1038 | 'notInService' or 'destroy' will likely have consequences up
|
---|
1039 | and down the interface stack. Thus, write access to this
|
---|
1040 | object is likely to be inappropriate for some types of
|
---|
1041 | interfaces, and many implementations will choose not to
|
---|
1042 | support write-access for any type of interface."
|
---|
1043 | ::= { ifStackEntry 3 }
|
---|
1044 |
|
---|
1045 | ifStackLastChange OBJECT-TYPE
|
---|
1046 | SYNTAX TimeTicks
|
---|
1047 | MAX-ACCESS read-only
|
---|
1048 | STATUS current
|
---|
1049 | DESCRIPTION
|
---|
1050 | "The value of sysUpTime at the time of the last change of
|
---|
1051 | the (whole) interface stack. A change of the interface
|
---|
1052 | stack is defined to be any creation, deletion, or change in
|
---|
1053 | value of any instance of ifStackStatus. If the interface
|
---|
1054 | stack has been unchanged since the last re-initialization of
|
---|
1055 | the local network management subsystem, then this object
|
---|
1056 | contains a zero value."
|
---|
1057 | ::= { ifMIBObjects 6 }
|
---|
1058 |
|
---|
1059 |
|
---|
1060 | -- Generic Receive Address Table
|
---|
1061 | --
|
---|
1062 | -- This group of objects is mandatory for all types of
|
---|
1063 | -- interfaces which can receive packets/frames addressed to
|
---|
1064 | -- more than one address.
|
---|
1065 | --
|
---|
1066 | -- This table replaces the ifExtnsRcvAddr table. The main
|
---|
1067 | -- difference is that this table makes use of the RowStatus
|
---|
1068 | -- textual convention, while ifExtnsRcvAddr did not.
|
---|
1069 |
|
---|
1070 | ifRcvAddressTable OBJECT-TYPE
|
---|
1071 | SYNTAX SEQUENCE OF IfRcvAddressEntry
|
---|
1072 | MAX-ACCESS not-accessible
|
---|
1073 | STATUS current
|
---|
1074 | DESCRIPTION
|
---|
1075 | "This table contains an entry for each address (broadcast,
|
---|
1076 | multicast, or uni-cast) for which the system will receive
|
---|
1077 | packets/frames on a particular interface, except as follows:
|
---|
1078 |
|
---|
1079 | - for an interface operating in promiscuous mode, entries
|
---|
1080 | are only required for those addresses for which the system
|
---|
1081 | would receive frames were it not operating in promiscuous
|
---|
1082 | mode.
|
---|
1083 |
|
---|
1084 |
|
---|
1085 | - for 802.5 functional addresses, only one entry is
|
---|
1086 | required, for the address which has the functional address
|
---|
1087 | bit ANDed with the bit mask of all functional addresses for
|
---|
1088 | which the interface will accept frames.
|
---|
1089 |
|
---|
1090 | A system is normally able to use any unicast address which
|
---|
1091 | corresponds to an entry in this table as a source address."
|
---|
1092 | ::= { ifMIBObjects 4 }
|
---|
1093 |
|
---|
1094 | ifRcvAddressEntry OBJECT-TYPE
|
---|
1095 | SYNTAX IfRcvAddressEntry
|
---|
1096 | MAX-ACCESS not-accessible
|
---|
1097 | STATUS current
|
---|
1098 | DESCRIPTION
|
---|
1099 | "A list of objects identifying an address for which the
|
---|
1100 | system will accept packets/frames on the particular
|
---|
1101 | interface identified by the index value ifIndex."
|
---|
1102 | INDEX { ifIndex, ifRcvAddressAddress }
|
---|
1103 | ::= { ifRcvAddressTable 1 }
|
---|
1104 |
|
---|
1105 | IfRcvAddressEntry ::=
|
---|
1106 | SEQUENCE {
|
---|
1107 | ifRcvAddressAddress PhysAddress,
|
---|
1108 | ifRcvAddressStatus RowStatus,
|
---|
1109 | ifRcvAddressType INTEGER
|
---|
1110 | }
|
---|
1111 |
|
---|
1112 | ifRcvAddressAddress OBJECT-TYPE
|
---|
1113 | SYNTAX PhysAddress
|
---|
1114 | MAX-ACCESS not-accessible
|
---|
1115 | STATUS current
|
---|
1116 | DESCRIPTION
|
---|
1117 | "An address for which the system will accept packets/frames
|
---|
1118 | on this entry's interface."
|
---|
1119 | ::= { ifRcvAddressEntry 1 }
|
---|
1120 |
|
---|
1121 | ifRcvAddressStatus OBJECT-TYPE
|
---|
1122 | SYNTAX RowStatus
|
---|
1123 | MAX-ACCESS read-create
|
---|
1124 | STATUS current
|
---|
1125 | DESCRIPTION
|
---|
1126 | "This object is used to create and delete rows in the
|
---|
1127 | ifRcvAddressTable."
|
---|
1128 |
|
---|
1129 | ::= { ifRcvAddressEntry 2 }
|
---|
1130 |
|
---|
1131 | ifRcvAddressType OBJECT-TYPE
|
---|
1132 | SYNTAX INTEGER {
|
---|
1133 |
|
---|
1134 |
|
---|
1135 | other(1),
|
---|
1136 | volatile(2),
|
---|
1137 | nonVolatile(3)
|
---|
1138 | }
|
---|
1139 |
|
---|
1140 | MAX-ACCESS read-create
|
---|
1141 | STATUS current
|
---|
1142 | DESCRIPTION
|
---|
1143 | "This object has the value nonVolatile(3) for those entries
|
---|
1144 | in the table which are valid and will not be deleted by the
|
---|
1145 | next restart of the managed system. Entries having the
|
---|
1146 | value volatile(2) are valid and exist, but have not been
|
---|
1147 | saved, so that will not exist after the next restart of the
|
---|
1148 | managed system. Entries having the value other(1) are valid
|
---|
1149 | and exist but are not classified as to whether they will
|
---|
1150 | continue to exist after the next restart."
|
---|
1151 |
|
---|
1152 | DEFVAL { volatile }
|
---|
1153 | ::= { ifRcvAddressEntry 3 }
|
---|
1154 |
|
---|
1155 | -- definition of interface-related traps.
|
---|
1156 |
|
---|
1157 | linkDown NOTIFICATION-TYPE
|
---|
1158 | OBJECTS { ifIndex, ifAdminStatus, ifOperStatus }
|
---|
1159 | STATUS current
|
---|
1160 | DESCRIPTION
|
---|
1161 | "A linkDown trap signifies that the SNMP entity, acting in
|
---|
1162 | an agent role, has detected that the ifOperStatus object for
|
---|
1163 | one of its communication links is about to enter the down
|
---|
1164 | state from some other state (but not from the notPresent
|
---|
1165 | state). This other state is indicated by the included value
|
---|
1166 | of ifOperStatus."
|
---|
1167 | ::= { snmpTraps 3 }
|
---|
1168 |
|
---|
1169 | linkUp NOTIFICATION-TYPE
|
---|
1170 | OBJECTS { ifIndex, ifAdminStatus, ifOperStatus }
|
---|
1171 | STATUS current
|
---|
1172 | DESCRIPTION
|
---|
1173 | "A linkUp trap signifies that the SNMP entity, acting in an
|
---|
1174 | agent role, has detected that the ifOperStatus object for
|
---|
1175 | one of its communication links left the down state and
|
---|
1176 | transitioned into some other state (but not into the
|
---|
1177 | notPresent state). This other state is indicated by the
|
---|
1178 | included value of ifOperStatus."
|
---|
1179 | ::= { snmpTraps 4 }
|
---|
1180 |
|
---|
1181 | -- conformance information
|
---|
1182 |
|
---|
1183 |
|
---|
1184 |
|
---|
1185 | ifConformance OBJECT IDENTIFIER ::= { ifMIB 2 }
|
---|
1186 |
|
---|
1187 | ifGroups OBJECT IDENTIFIER ::= { ifConformance 1 }
|
---|
1188 | ifCompliances OBJECT IDENTIFIER ::= { ifConformance 2 }
|
---|
1189 |
|
---|
1190 |
|
---|
1191 | -- compliance statements
|
---|
1192 |
|
---|
1193 | ifCompliance3 MODULE-COMPLIANCE
|
---|
1194 | STATUS current
|
---|
1195 | DESCRIPTION
|
---|
1196 | "The compliance statement for SNMP entities which have
|
---|
1197 | network interfaces."
|
---|
1198 |
|
---|
1199 | MODULE -- this module
|
---|
1200 | MANDATORY-GROUPS { ifGeneralInformationGroup,
|
---|
1201 | linkUpDownNotificationsGroup }
|
---|
1202 |
|
---|
1203 | -- The groups:
|
---|
1204 | -- ifFixedLengthGroup
|
---|
1205 | -- ifHCFixedLengthGroup
|
---|
1206 | -- ifPacketGroup
|
---|
1207 | -- ifHCPacketGroup
|
---|
1208 | -- ifVHCPacketGroup
|
---|
1209 | -- are mutually exclusive; at most one of these groups is implemented
|
---|
1210 | -- for a particular interface. When any of these groups is implemented
|
---|
1211 | -- for a particular interface, then ifCounterDiscontinuityGroup must
|
---|
1212 | -- also be implemented for that interface.
|
---|
1213 |
|
---|
1214 |
|
---|
1215 | GROUP ifFixedLengthGroup
|
---|
1216 | DESCRIPTION
|
---|
1217 | "This group is mandatory for those network interfaces which
|
---|
1218 | are character-oriented or transmit data in fixed-length
|
---|
1219 | transmission units, and for which the value of the
|
---|
1220 | corresponding instance of ifSpeed is less than or equal to
|
---|
1221 | 20,000,000 bits/second."
|
---|
1222 |
|
---|
1223 | GROUP ifHCFixedLengthGroup
|
---|
1224 | DESCRIPTION
|
---|
1225 | "This group is mandatory for those network interfaces which
|
---|
1226 | are character-oriented or transmit data in fixed-length
|
---|
1227 | transmission units, and for which the value of the
|
---|
1228 | corresponding instance of ifSpeed is greater than 20,000,000
|
---|
1229 | bits/second."
|
---|
1230 |
|
---|
1231 | GROUP ifPacketGroup
|
---|
1232 | DESCRIPTION
|
---|
1233 |
|
---|
1234 |
|
---|
1235 | "This group is mandatory for those network interfaces which
|
---|
1236 | are packet-oriented, and for which the value of the
|
---|
1237 | corresponding instance of ifSpeed is less than or equal to
|
---|
1238 | 20,000,000 bits/second."
|
---|
1239 |
|
---|
1240 | GROUP ifHCPacketGroup
|
---|
1241 | DESCRIPTION
|
---|
1242 | "This group is mandatory only for those network interfaces
|
---|
1243 | which are packet-oriented and for which the value of the
|
---|
1244 | corresponding instance of ifSpeed is greater than 20,000,000
|
---|
1245 | bits/second but less than or equal to 650,000,000
|
---|
1246 | bits/second."
|
---|
1247 |
|
---|
1248 | GROUP ifVHCPacketGroup
|
---|
1249 | DESCRIPTION
|
---|
1250 | "This group is mandatory only for those network interfaces
|
---|
1251 | which are packet-oriented and for which the value of the
|
---|
1252 | corresponding instance of ifSpeed is greater than
|
---|
1253 | 650,000,000 bits/second."
|
---|
1254 |
|
---|
1255 |
|
---|
1256 | GROUP ifCounterDiscontinuityGroup
|
---|
1257 | DESCRIPTION
|
---|
1258 | "This group is mandatory for those network interfaces that
|
---|
1259 | are required to maintain counters (i.e., those for which one
|
---|
1260 | of the ifFixedLengthGroup, ifHCFixedLengthGroup,
|
---|
1261 | ifPacketGroup, ifHCPacketGroup, or ifVHCPacketGroup is
|
---|
1262 | mandatory)."
|
---|
1263 |
|
---|
1264 |
|
---|
1265 | GROUP ifRcvAddressGroup
|
---|
1266 | DESCRIPTION
|
---|
1267 | "The applicability of this group MUST be defined by the
|
---|
1268 | media-specific MIBs. Media-specific MIBs must define the
|
---|
1269 | exact meaning, use, and semantics of the addresses in this
|
---|
1270 | group."
|
---|
1271 |
|
---|
1272 | OBJECT ifLinkUpDownTrapEnable
|
---|
1273 | MIN-ACCESS read-only
|
---|
1274 | DESCRIPTION
|
---|
1275 | "Write access is not required."
|
---|
1276 |
|
---|
1277 | OBJECT ifPromiscuousMode
|
---|
1278 | MIN-ACCESS read-only
|
---|
1279 | DESCRIPTION
|
---|
1280 | "Write access is not required."
|
---|
1281 |
|
---|
1282 | OBJECT ifAdminStatus
|
---|
1283 |
|
---|
1284 |
|
---|
1285 | SYNTAX INTEGER { up(1), down(2) }
|
---|
1286 | MIN-ACCESS read-only
|
---|
1287 | DESCRIPTION
|
---|
1288 | "Write access is not required, nor is support for the value
|
---|
1289 | testing(3)."
|
---|
1290 |
|
---|
1291 | OBJECT ifAlias
|
---|
1292 | MIN-ACCESS read-only
|
---|
1293 | DESCRIPTION
|
---|
1294 | "Write access is not required."
|
---|
1295 |
|
---|
1296 | ::= { ifCompliances 3 }
|
---|
1297 |
|
---|
1298 | -- units of conformance
|
---|
1299 |
|
---|
1300 | ifGeneralInformationGroup OBJECT-GROUP
|
---|
1301 | OBJECTS { ifIndex, ifDescr, ifType, ifSpeed, ifPhysAddress,
|
---|
1302 | ifAdminStatus, ifOperStatus, ifLastChange,
|
---|
1303 | ifLinkUpDownTrapEnable, ifConnectorPresent,
|
---|
1304 | ifHighSpeed, ifName, ifNumber, ifAlias,
|
---|
1305 | ifTableLastChange }
|
---|
1306 | STATUS current
|
---|
1307 | DESCRIPTION
|
---|
1308 | "A collection of objects providing information applicable to
|
---|
1309 | all network interfaces."
|
---|
1310 | ::= { ifGroups 10 }
|
---|
1311 |
|
---|
1312 | -- the following five groups are mutually exclusive; at most
|
---|
1313 | -- one of these groups is implemented for any interface
|
---|
1314 |
|
---|
1315 | ifFixedLengthGroup OBJECT-GROUP
|
---|
1316 | OBJECTS { ifInOctets, ifOutOctets, ifInUnknownProtos,
|
---|
1317 | ifInErrors, ifOutErrors }
|
---|
1318 | STATUS current
|
---|
1319 | DESCRIPTION
|
---|
1320 | "A collection of objects providing information specific to
|
---|
1321 | non-high speed (non-high speed interfaces transmit and
|
---|
1322 | receive at speeds less than or equal to 20,000,000
|
---|
1323 | bits/second) character-oriented or fixed-length-transmission
|
---|
1324 | network interfaces."
|
---|
1325 | ::= { ifGroups 2 }
|
---|
1326 |
|
---|
1327 | ifHCFixedLengthGroup OBJECT-GROUP
|
---|
1328 | OBJECTS { ifHCInOctets, ifHCOutOctets,
|
---|
1329 | ifInOctets, ifOutOctets, ifInUnknownProtos,
|
---|
1330 | ifInErrors, ifOutErrors }
|
---|
1331 | STATUS current
|
---|
1332 | DESCRIPTION
|
---|
1333 |
|
---|
1334 |
|
---|
1335 | "A collection of objects providing information specific to
|
---|
1336 | high speed (greater than 20,000,000 bits/second) character-
|
---|
1337 | oriented or fixed-length-transmission network interfaces."
|
---|
1338 | ::= { ifGroups 3 }
|
---|
1339 |
|
---|
1340 | ifPacketGroup OBJECT-GROUP
|
---|
1341 | OBJECTS { ifInOctets, ifOutOctets, ifInUnknownProtos,
|
---|
1342 | ifInErrors, ifOutErrors,
|
---|
1343 | ifMtu, ifInUcastPkts, ifInMulticastPkts,
|
---|
1344 | ifInBroadcastPkts, ifInDiscards,
|
---|
1345 | ifOutUcastPkts, ifOutMulticastPkts,
|
---|
1346 | ifOutBroadcastPkts, ifOutDiscards,
|
---|
1347 | ifPromiscuousMode }
|
---|
1348 | STATUS current
|
---|
1349 | DESCRIPTION
|
---|
1350 | "A collection of objects providing information specific to
|
---|
1351 | non-high speed (non-high speed interfaces transmit and
|
---|
1352 | receive at speeds less than or equal to 20,000,000
|
---|
1353 | bits/second) packet-oriented network interfaces."
|
---|
1354 | ::= { ifGroups 4 }
|
---|
1355 |
|
---|
1356 | ifHCPacketGroup OBJECT-GROUP
|
---|
1357 | OBJECTS { ifHCInOctets, ifHCOutOctets,
|
---|
1358 | ifInOctets, ifOutOctets, ifInUnknownProtos,
|
---|
1359 | ifInErrors, ifOutErrors,
|
---|
1360 | ifMtu, ifInUcastPkts, ifInMulticastPkts,
|
---|
1361 | ifInBroadcastPkts, ifInDiscards,
|
---|
1362 | ifOutUcastPkts, ifOutMulticastPkts,
|
---|
1363 | ifOutBroadcastPkts, ifOutDiscards,
|
---|
1364 | ifPromiscuousMode }
|
---|
1365 | STATUS current
|
---|
1366 | DESCRIPTION
|
---|
1367 | "A collection of objects providing information specific to
|
---|
1368 | high speed (greater than 20,000,000 bits/second but less
|
---|
1369 | than or equal to 650,000,000 bits/second) packet-oriented
|
---|
1370 | network interfaces."
|
---|
1371 | ::= { ifGroups 5 }
|
---|
1372 |
|
---|
1373 | ifVHCPacketGroup OBJECT-GROUP
|
---|
1374 | OBJECTS { ifHCInUcastPkts, ifHCInMulticastPkts,
|
---|
1375 | ifHCInBroadcastPkts, ifHCOutUcastPkts,
|
---|
1376 | ifHCOutMulticastPkts, ifHCOutBroadcastPkts,
|
---|
1377 | ifHCInOctets, ifHCOutOctets,
|
---|
1378 | ifInOctets, ifOutOctets, ifInUnknownProtos,
|
---|
1379 | ifInErrors, ifOutErrors,
|
---|
1380 | ifMtu, ifInUcastPkts, ifInMulticastPkts,
|
---|
1381 | ifInBroadcastPkts, ifInDiscards,
|
---|
1382 | ifOutUcastPkts, ifOutMulticastPkts,
|
---|
1383 |
|
---|
1384 |
|
---|
1385 | ifOutBroadcastPkts, ifOutDiscards,
|
---|
1386 | ifPromiscuousMode }
|
---|
1387 | STATUS current
|
---|
1388 | DESCRIPTION
|
---|
1389 | "A collection of objects providing information specific to
|
---|
1390 | higher speed (greater than 650,000,000 bits/second) packet-
|
---|
1391 | oriented network interfaces."
|
---|
1392 | ::= { ifGroups 6 }
|
---|
1393 |
|
---|
1394 | ifRcvAddressGroup OBJECT-GROUP
|
---|
1395 | OBJECTS { ifRcvAddressStatus, ifRcvAddressType }
|
---|
1396 | STATUS current
|
---|
1397 | DESCRIPTION
|
---|
1398 | "A collection of objects providing information on the
|
---|
1399 | multiple addresses which an interface receives."
|
---|
1400 | ::= { ifGroups 7 }
|
---|
1401 |
|
---|
1402 | ifStackGroup2 OBJECT-GROUP
|
---|
1403 | OBJECTS { ifStackStatus, ifStackLastChange }
|
---|
1404 | STATUS current
|
---|
1405 | DESCRIPTION
|
---|
1406 | "A collection of objects providing information on the
|
---|
1407 | layering of MIB-II interfaces."
|
---|
1408 | ::= { ifGroups 11 }
|
---|
1409 |
|
---|
1410 | ifCounterDiscontinuityGroup OBJECT-GROUP
|
---|
1411 | OBJECTS { ifCounterDiscontinuityTime }
|
---|
1412 | STATUS current
|
---|
1413 | DESCRIPTION
|
---|
1414 | "A collection of objects providing information specific to
|
---|
1415 | interface counter discontinuities."
|
---|
1416 | ::= { ifGroups 13 }
|
---|
1417 |
|
---|
1418 | linkUpDownNotificationsGroup NOTIFICATION-GROUP
|
---|
1419 | NOTIFICATIONS { linkUp, linkDown }
|
---|
1420 | STATUS current
|
---|
1421 | DESCRIPTION
|
---|
1422 | "The notifications which indicate specific changes in the
|
---|
1423 | value of ifOperStatus."
|
---|
1424 | ::= { ifGroups 14 }
|
---|
1425 |
|
---|
1426 | -- Deprecated Definitions - Objects
|
---|
1427 |
|
---|
1428 |
|
---|
1429 | --
|
---|
1430 | -- The Interface Test Table
|
---|
1431 | --
|
---|
1432 | -- This group of objects is optional. However, a media-specific
|
---|
1433 |
|
---|
1434 |
|
---|
1435 | -- MIB may make implementation of this group mandatory.
|
---|
1436 | --
|
---|
1437 | -- This table replaces the ifExtnsTestTable
|
---|
1438 | --
|
---|
1439 |
|
---|
1440 | ifTestTable OBJECT-TYPE
|
---|
1441 | SYNTAX SEQUENCE OF IfTestEntry
|
---|
1442 | MAX-ACCESS not-accessible
|
---|
1443 | STATUS deprecated
|
---|
1444 | DESCRIPTION
|
---|
1445 | "This table contains one entry per interface. It defines
|
---|
1446 | objects which allow a network manager to instruct an agent
|
---|
1447 | to test an interface for various faults. Tests for an
|
---|
1448 | interface are defined in the media-specific MIB for that
|
---|
1449 | interface. After invoking a test, the object ifTestResult
|
---|
1450 | can be read to determine the outcome. If an agent can not
|
---|
1451 | perform the test, ifTestResult is set to so indicate. The
|
---|
1452 | object ifTestCode can be used to provide further test-
|
---|
1453 | specific or interface-specific (or even enterprise-specific)
|
---|
1454 | information concerning the outcome of the test. Only one
|
---|
1455 | test can be in progress on each interface at any one time.
|
---|
1456 | If one test is in progress when another test is invoked, the
|
---|
1457 | second test is rejected. Some agents may reject a test when
|
---|
1458 | a prior test is active on another interface.
|
---|
1459 |
|
---|
1460 | Before starting a test, a manager-station must first obtain
|
---|
1461 | 'ownership' of the entry in the ifTestTable for the
|
---|
1462 | interface to be tested. This is accomplished with the
|
---|
1463 | ifTestId and ifTestStatus objects as follows:
|
---|
1464 |
|
---|
1465 | try_again:
|
---|
1466 | get (ifTestId, ifTestStatus)
|
---|
1467 | while (ifTestStatus != notInUse)
|
---|
1468 | /*
|
---|
1469 | * Loop while a test is running or some other
|
---|
1470 | * manager is configuring a test.
|
---|
1471 | */
|
---|
1472 | short delay
|
---|
1473 | get (ifTestId, ifTestStatus)
|
---|
1474 | }
|
---|
1475 |
|
---|
1476 | /*
|
---|
1477 | * Is not being used right now -- let's compete
|
---|
1478 | * to see who gets it.
|
---|
1479 | */
|
---|
1480 | lock_value = ifTestId
|
---|
1481 |
|
---|
1482 | if ( set(ifTestId = lock_value, ifTestStatus = inUse,
|
---|
1483 |
|
---|
1484 |
|
---|
1485 | ifTestOwner = 'my-IP-address') == FAILURE)
|
---|
1486 | /*
|
---|
1487 | * Another manager got the ifTestEntry -- go
|
---|
1488 | * try again
|
---|
1489 | */
|
---|
1490 | goto try_again;
|
---|
1491 |
|
---|
1492 | /*
|
---|
1493 | * I have the lock
|
---|
1494 | */
|
---|
1495 | set up any test parameters.
|
---|
1496 |
|
---|
1497 | /*
|
---|
1498 | * This starts the test
|
---|
1499 | */
|
---|
1500 | set(ifTestType = test_to_run);
|
---|
1501 |
|
---|
1502 | wait for test completion by polling ifTestResult
|
---|
1503 |
|
---|
1504 | when test completes, agent sets ifTestResult
|
---|
1505 | agent also sets ifTestStatus = 'notInUse'
|
---|
1506 |
|
---|
1507 | retrieve any additional test results, and ifTestId
|
---|
1508 |
|
---|
1509 | if (ifTestId == lock_value+1) results are valid
|
---|
1510 |
|
---|
1511 | A manager station first retrieves the value of the
|
---|
1512 | appropriate ifTestId and ifTestStatus objects, periodically
|
---|
1513 | repeating the retrieval if necessary, until the value of
|
---|
1514 | ifTestStatus is 'notInUse'. The manager station then tries
|
---|
1515 | to set the same ifTestId object to the value it just
|
---|
1516 | retrieved, the same ifTestStatus object to 'inUse', and the
|
---|
1517 | corresponding ifTestOwner object to a value indicating
|
---|
1518 | itself. If the set operation succeeds then the manager has
|
---|
1519 | obtained ownership of the ifTestEntry, and the value of the
|
---|
1520 | ifTestId object is incremented by the agent (per the
|
---|
1521 | semantics of TestAndIncr). Failure of the set operation
|
---|
1522 | indicates that some other manager has obtained ownership of
|
---|
1523 | the ifTestEntry.
|
---|
1524 |
|
---|
1525 | Once ownership is obtained, any test parameters can be
|
---|
1526 | setup, and then the test is initiated by setting ifTestType.
|
---|
1527 | On completion of the test, the agent sets ifTestStatus to
|
---|
1528 | 'notInUse'. Once this occurs, the manager can retrieve the
|
---|
1529 | results. In the (rare) event that the invocation of tests
|
---|
1530 | by two network managers were to overlap, then there would be
|
---|
1531 | a possibility that the first test's results might be
|
---|
1532 | overwritten by the second test's results prior to the first
|
---|
1533 |
|
---|
1534 |
|
---|
1535 | results being read. This unlikely circumstance can be
|
---|
1536 | detected by a network manager retrieving ifTestId at the
|
---|
1537 | same time as retrieving the test results, and ensuring that
|
---|
1538 | the results are for the desired request.
|
---|
1539 |
|
---|
1540 | If ifTestType is not set within an abnormally long period of
|
---|
1541 | time after ownership is obtained, the agent should time-out
|
---|
1542 | the manager, and reset the value of the ifTestStatus object
|
---|
1543 | back to 'notInUse'. It is suggested that this time-out
|
---|
1544 | period be 5 minutes.
|
---|
1545 |
|
---|
1546 | In general, a management station must not retransmit a
|
---|
1547 | request to invoke a test for which it does not receive a
|
---|
1548 | response; instead, it properly inspects an agent's MIB to
|
---|
1549 | determine if the invocation was successful. Only if the
|
---|
1550 | invocation was unsuccessful, is the invocation request
|
---|
1551 | retransmitted.
|
---|
1552 |
|
---|
1553 | Some tests may require the interface to be taken off-line in
|
---|
1554 | order to execute them, or may even require the agent to
|
---|
1555 | reboot after completion of the test. In these
|
---|
1556 | circumstances, communication with the management station
|
---|
1557 | invoking the test may be lost until after completion of the
|
---|
1558 | test. An agent is not required to support such tests.
|
---|
1559 | However, if such tests are supported, then the agent should
|
---|
1560 | make every effort to transmit a response to the request
|
---|
1561 | which invoked the test prior to losing communication. When
|
---|
1562 | the agent is restored to normal service, the results of the
|
---|
1563 | test are properly made available in the appropriate objects.
|
---|
1564 | Note that this requires that the ifIndex value assigned to
|
---|
1565 | an interface must be unchanged even if the test causes a
|
---|
1566 | reboot. An agent must reject any test for which it cannot,
|
---|
1567 | perhaps due to resource constraints, make available at least
|
---|
1568 | the minimum amount of information after that test
|
---|
1569 | completes."
|
---|
1570 | ::= { ifMIBObjects 3 }
|
---|
1571 |
|
---|
1572 | ifTestEntry OBJECT-TYPE
|
---|
1573 | SYNTAX IfTestEntry
|
---|
1574 | MAX-ACCESS not-accessible
|
---|
1575 | STATUS deprecated
|
---|
1576 | DESCRIPTION
|
---|
1577 | "An entry containing objects for invoking tests on an
|
---|
1578 | interface."
|
---|
1579 | AUGMENTS { ifEntry }
|
---|
1580 | ::= { ifTestTable 1 }
|
---|
1581 |
|
---|
1582 | IfTestEntry ::=
|
---|
1583 |
|
---|
1584 |
|
---|
1585 | SEQUENCE {
|
---|
1586 | ifTestId TestAndIncr,
|
---|
1587 | ifTestStatus INTEGER,
|
---|
1588 | ifTestType AutonomousType,
|
---|
1589 | ifTestResult INTEGER,
|
---|
1590 | ifTestCode OBJECT IDENTIFIER,
|
---|
1591 | ifTestOwner OwnerString
|
---|
1592 | }
|
---|
1593 |
|
---|
1594 | ifTestId OBJECT-TYPE
|
---|
1595 | SYNTAX TestAndIncr
|
---|
1596 | MAX-ACCESS read-write
|
---|
1597 | STATUS deprecated
|
---|
1598 | DESCRIPTION
|
---|
1599 | "This object identifies the current invocation of the
|
---|
1600 | interface's test."
|
---|
1601 | ::= { ifTestEntry 1 }
|
---|
1602 |
|
---|
1603 | ifTestStatus OBJECT-TYPE
|
---|
1604 | SYNTAX INTEGER { notInUse(1), inUse(2) }
|
---|
1605 | MAX-ACCESS read-write
|
---|
1606 | STATUS deprecated
|
---|
1607 | DESCRIPTION
|
---|
1608 | "This object indicates whether or not some manager currently
|
---|
1609 | has the necessary 'ownership' required to invoke a test on
|
---|
1610 | this interface. A write to this object is only successful
|
---|
1611 | when it changes its value from 'notInUse(1)' to 'inUse(2)'.
|
---|
1612 | After completion of a test, the agent resets the value back
|
---|
1613 | to 'notInUse(1)'."
|
---|
1614 | ::= { ifTestEntry 2 }
|
---|
1615 |
|
---|
1616 | ifTestType OBJECT-TYPE
|
---|
1617 | SYNTAX AutonomousType
|
---|
1618 | MAX-ACCESS read-write
|
---|
1619 | STATUS deprecated
|
---|
1620 | DESCRIPTION
|
---|
1621 | "A control variable used to start and stop operator-
|
---|
1622 | initiated interface tests. Most OBJECT IDENTIFIER values
|
---|
1623 | assigned to tests are defined elsewhere, in association with
|
---|
1624 | specific types of interface. However, this document assigns
|
---|
1625 | a value for a full-duplex loopback test, and defines the
|
---|
1626 | special meanings of the subject identifier:
|
---|
1627 |
|
---|
1628 | noTest OBJECT IDENTIFIER ::= { 0 0 }
|
---|
1629 |
|
---|
1630 | When the value noTest is written to this object, no action
|
---|
1631 | is taken unless a test is in progress, in which case the
|
---|
1632 | test is aborted. Writing any other value to this object is
|
---|
1633 |
|
---|
1634 |
|
---|
1635 | only valid when no test is currently in progress, in which
|
---|
1636 | case the indicated test is initiated.
|
---|
1637 |
|
---|
1638 | When read, this object always returns the most recent value
|
---|
1639 | that ifTestType was set to. If it has not been set since
|
---|
1640 | the last initialization of the network management subsystem
|
---|
1641 | on the agent, a value of noTest is returned."
|
---|
1642 | ::= { ifTestEntry 3 }
|
---|
1643 |
|
---|
1644 | ifTestResult OBJECT-TYPE
|
---|
1645 | SYNTAX INTEGER {
|
---|
1646 | none(1), -- no test yet requested
|
---|
1647 | success(2),
|
---|
1648 | inProgress(3),
|
---|
1649 | notSupported(4),
|
---|
1650 | unAbleToRun(5), -- due to state of system
|
---|
1651 | aborted(6),
|
---|
1652 | failed(7)
|
---|
1653 | }
|
---|
1654 | MAX-ACCESS read-only
|
---|
1655 | STATUS deprecated
|
---|
1656 | DESCRIPTION
|
---|
1657 | "This object contains the result of the most recently
|
---|
1658 | requested test, or the value none(1) if no tests have been
|
---|
1659 | requested since the last reset. Note that this facility
|
---|
1660 | provides no provision for saving the results of one test
|
---|
1661 | when starting another, as could be required if used by
|
---|
1662 | multiple managers concurrently."
|
---|
1663 | ::= { ifTestEntry 4 }
|
---|
1664 |
|
---|
1665 | ifTestCode OBJECT-TYPE
|
---|
1666 | SYNTAX OBJECT IDENTIFIER
|
---|
1667 | MAX-ACCESS read-only
|
---|
1668 | STATUS deprecated
|
---|
1669 | DESCRIPTION
|
---|
1670 | "This object contains a code which contains more specific
|
---|
1671 | information on the test result, for example an error-code
|
---|
1672 | after a failed test. Error codes and other values this
|
---|
1673 | object may take are specific to the type of interface and/or
|
---|
1674 | test. The value may have the semantics of either the
|
---|
1675 | AutonomousType or InstancePointer textual conventions as
|
---|
1676 | defined in RFC 2579. The identifier:
|
---|
1677 |
|
---|
1678 | testCodeUnknown OBJECT IDENTIFIER ::= { 0 0 }
|
---|
1679 |
|
---|
1680 | is defined for use if no additional result code is
|
---|
1681 | available."
|
---|
1682 | ::= { ifTestEntry 5 }
|
---|
1683 |
|
---|
1684 |
|
---|
1685 | ifTestOwner OBJECT-TYPE
|
---|
1686 | SYNTAX OwnerString
|
---|
1687 | MAX-ACCESS read-write
|
---|
1688 | STATUS deprecated
|
---|
1689 | DESCRIPTION
|
---|
1690 | "The entity which currently has the 'ownership' required to
|
---|
1691 | invoke a test on this interface."
|
---|
1692 | ::= { ifTestEntry 6 }
|
---|
1693 |
|
---|
1694 | -- Deprecated Definitions - Groups
|
---|
1695 |
|
---|
1696 |
|
---|
1697 | ifGeneralGroup OBJECT-GROUP
|
---|
1698 | OBJECTS { ifDescr, ifType, ifSpeed, ifPhysAddress,
|
---|
1699 | ifAdminStatus, ifOperStatus, ifLastChange,
|
---|
1700 | ifLinkUpDownTrapEnable, ifConnectorPresent,
|
---|
1701 | ifHighSpeed, ifName }
|
---|
1702 | STATUS deprecated
|
---|
1703 | DESCRIPTION
|
---|
1704 | "A collection of objects deprecated in favour of
|
---|
1705 | ifGeneralInformationGroup."
|
---|
1706 | ::= { ifGroups 1 }
|
---|
1707 |
|
---|
1708 |
|
---|
1709 | ifTestGroup OBJECT-GROUP
|
---|
1710 | OBJECTS { ifTestId, ifTestStatus, ifTestType,
|
---|
1711 | ifTestResult, ifTestCode, ifTestOwner }
|
---|
1712 | STATUS deprecated
|
---|
1713 | DESCRIPTION
|
---|
1714 | "A collection of objects providing the ability to invoke
|
---|
1715 | tests on an interface."
|
---|
1716 | ::= { ifGroups 8 }
|
---|
1717 |
|
---|
1718 |
|
---|
1719 | ifStackGroup OBJECT-GROUP
|
---|
1720 | OBJECTS { ifStackStatus }
|
---|
1721 | STATUS deprecated
|
---|
1722 | DESCRIPTION
|
---|
1723 | "The previous collection of objects providing information on
|
---|
1724 | the layering of MIB-II interfaces."
|
---|
1725 | ::= { ifGroups 9 }
|
---|
1726 |
|
---|
1727 |
|
---|
1728 | ifOldObjectsGroup OBJECT-GROUP
|
---|
1729 | OBJECTS { ifInNUcastPkts, ifOutNUcastPkts,
|
---|
1730 | ifOutQLen, ifSpecific }
|
---|
1731 | STATUS deprecated
|
---|
1732 | DESCRIPTION
|
---|
1733 |
|
---|
1734 |
|
---|
1735 | "The collection of objects deprecated from the original MIB-
|
---|
1736 | II interfaces group."
|
---|
1737 | ::= { ifGroups 12 }
|
---|
1738 |
|
---|
1739 | -- Deprecated Definitions - Compliance
|
---|
1740 |
|
---|
1741 | ifCompliance MODULE-COMPLIANCE
|
---|
1742 | STATUS deprecated
|
---|
1743 | DESCRIPTION
|
---|
1744 | "A compliance statement defined in a previous version of
|
---|
1745 | this MIB module, for SNMP entities which have network
|
---|
1746 | interfaces."
|
---|
1747 |
|
---|
1748 | MODULE -- this module
|
---|
1749 | MANDATORY-GROUPS { ifGeneralGroup, ifStackGroup }
|
---|
1750 |
|
---|
1751 | GROUP ifFixedLengthGroup
|
---|
1752 | DESCRIPTION
|
---|
1753 | "This group is mandatory for all network interfaces which
|
---|
1754 | are character-oriented or transmit data in fixed-length
|
---|
1755 | transmission units."
|
---|
1756 |
|
---|
1757 | GROUP ifHCFixedLengthGroup
|
---|
1758 | DESCRIPTION
|
---|
1759 | "This group is mandatory only for those network interfaces
|
---|
1760 | which are character-oriented or transmit data in fixed-
|
---|
1761 | length transmission units, and for which the value of the
|
---|
1762 | corresponding instance of ifSpeed is greater than 20,000,000
|
---|
1763 | bits/second."
|
---|
1764 |
|
---|
1765 | GROUP ifPacketGroup
|
---|
1766 | DESCRIPTION
|
---|
1767 | "This group is mandatory for all network interfaces which
|
---|
1768 | are packet-oriented."
|
---|
1769 |
|
---|
1770 | GROUP ifHCPacketGroup
|
---|
1771 | DESCRIPTION
|
---|
1772 | "This group is mandatory only for those network interfaces
|
---|
1773 | which are packet-oriented and for which the value of the
|
---|
1774 | corresponding instance of ifSpeed is greater than
|
---|
1775 | 650,000,000 bits/second."
|
---|
1776 |
|
---|
1777 | GROUP ifTestGroup
|
---|
1778 | DESCRIPTION
|
---|
1779 | "This group is optional. Media-specific MIBs which require
|
---|
1780 | interface tests are strongly encouraged to use this group
|
---|
1781 | for invoking tests and reporting results. A medium specific
|
---|
1782 | MIB which has mandatory tests may make implementation of
|
---|
1783 |
|
---|
1784 |
|
---|
1785 | this group mandatory."
|
---|
1786 |
|
---|
1787 | GROUP ifRcvAddressGroup
|
---|
1788 | DESCRIPTION
|
---|
1789 | "The applicability of this group MUST be defined by the
|
---|
1790 | media-specific MIBs. Media-specific MIBs must define the
|
---|
1791 | exact meaning, use, and semantics of the addresses in this
|
---|
1792 | group."
|
---|
1793 |
|
---|
1794 | OBJECT ifLinkUpDownTrapEnable
|
---|
1795 | MIN-ACCESS read-only
|
---|
1796 | DESCRIPTION
|
---|
1797 | "Write access is not required."
|
---|
1798 |
|
---|
1799 | OBJECT ifPromiscuousMode
|
---|
1800 | MIN-ACCESS read-only
|
---|
1801 | DESCRIPTION
|
---|
1802 | "Write access is not required."
|
---|
1803 |
|
---|
1804 | OBJECT ifStackStatus
|
---|
1805 | SYNTAX INTEGER { active(1) } -- subset of RowStatus
|
---|
1806 | MIN-ACCESS read-only
|
---|
1807 | DESCRIPTION
|
---|
1808 | "Write access is not required, and only one of the six
|
---|
1809 | enumerated values for the RowStatus textual convention need
|
---|
1810 | be supported, specifically: active(1)."
|
---|
1811 |
|
---|
1812 | OBJECT ifAdminStatus
|
---|
1813 | SYNTAX INTEGER { up(1), down(2) }
|
---|
1814 | MIN-ACCESS read-only
|
---|
1815 | DESCRIPTION
|
---|
1816 | "Write access is not required, nor is support for the value
|
---|
1817 | testing(3)."
|
---|
1818 | ::= { ifCompliances 1 }
|
---|
1819 |
|
---|
1820 | ifCompliance2 MODULE-COMPLIANCE
|
---|
1821 | STATUS deprecated
|
---|
1822 | DESCRIPTION
|
---|
1823 | "A compliance statement defined in a previous version of
|
---|
1824 | this MIB module, for SNMP entities which have network
|
---|
1825 | interfaces."
|
---|
1826 |
|
---|
1827 | MODULE -- this module
|
---|
1828 | MANDATORY-GROUPS { ifGeneralInformationGroup, ifStackGroup2,
|
---|
1829 | ifCounterDiscontinuityGroup }
|
---|
1830 |
|
---|
1831 | GROUP ifFixedLengthGroup
|
---|
1832 | DESCRIPTION
|
---|
1833 |
|
---|
1834 |
|
---|
1835 | "This group is mandatory for all network interfaces which
|
---|
1836 | are character-oriented or transmit data in fixed-length
|
---|
1837 | transmission units."
|
---|
1838 |
|
---|
1839 | GROUP ifHCFixedLengthGroup
|
---|
1840 | DESCRIPTION
|
---|
1841 | "This group is mandatory only for those network interfaces
|
---|
1842 | which are character-oriented or transmit data in fixed-
|
---|
1843 | length transmission units, and for which the value of the
|
---|
1844 | corresponding instance of ifSpeed is greater than 20,000,000
|
---|
1845 | bits/second."
|
---|
1846 |
|
---|
1847 | GROUP ifPacketGroup
|
---|
1848 | DESCRIPTION
|
---|
1849 | "This group is mandatory for all network interfaces which
|
---|
1850 | are packet-oriented."
|
---|
1851 |
|
---|
1852 | GROUP ifHCPacketGroup
|
---|
1853 | DESCRIPTION
|
---|
1854 | "This group is mandatory only for those network interfaces
|
---|
1855 | which are packet-oriented and for which the value of the
|
---|
1856 | corresponding instance of ifSpeed is greater than
|
---|
1857 | 650,000,000 bits/second."
|
---|
1858 |
|
---|
1859 | GROUP ifRcvAddressGroup
|
---|
1860 | DESCRIPTION
|
---|
1861 | "The applicability of this group MUST be defined by the
|
---|
1862 | media-specific MIBs. Media-specific MIBs must define the
|
---|
1863 | exact meaning, use, and semantics of the addresses in this
|
---|
1864 | group."
|
---|
1865 |
|
---|
1866 | OBJECT ifLinkUpDownTrapEnable
|
---|
1867 | MIN-ACCESS read-only
|
---|
1868 | DESCRIPTION
|
---|
1869 | "Write access is not required."
|
---|
1870 |
|
---|
1871 | OBJECT ifPromiscuousMode
|
---|
1872 | MIN-ACCESS read-only
|
---|
1873 | DESCRIPTION
|
---|
1874 | "Write access is not required."
|
---|
1875 |
|
---|
1876 | OBJECT ifStackStatus
|
---|
1877 | SYNTAX INTEGER { active(1) } -- subset of RowStatus
|
---|
1878 | MIN-ACCESS read-only
|
---|
1879 | DESCRIPTION
|
---|
1880 | "Write access is not required, and only one of the six
|
---|
1881 | enumerated values for the RowStatus textual convention need
|
---|
1882 | be supported, specifically: active(1)."
|
---|
1883 |
|
---|
1884 |
|
---|
1885 | OBJECT ifAdminStatus
|
---|
1886 | SYNTAX INTEGER { up(1), down(2) }
|
---|
1887 | MIN-ACCESS read-only
|
---|
1888 | DESCRIPTION
|
---|
1889 | "Write access is not required, nor is support for the value
|
---|
1890 | testing(3)."
|
---|
1891 |
|
---|
1892 | OBJECT ifAlias
|
---|
1893 | MIN-ACCESS read-only
|
---|
1894 | DESCRIPTION
|
---|
1895 | "Write access is not required."
|
---|
1896 |
|
---|
1897 | ::= { ifCompliances 2 }
|
---|
1898 |
|
---|
1899 | END
|
---|