1 INTEGRATED-SERVICES-MIB DEFINITIONS ::= BEGIN
4 MODULE-IDENTITY, OBJECT-TYPE, Counter32,
5 Gauge32, Integer32, mib-2 FROM SNMPv2-SMI
6 TimeInterval, TEXTUAL-CONVENTION, RowStatus,
7 TruthValue, TestAndIncr FROM SNMPv2-TC
8 MODULE-COMPLIANCE, OBJECT-GROUP FROM SNMPv2-CONF
9 ifIndex, InterfaceIndex FROM IF-MIB;
11 -- This MIB module uses the extended OBJECT-TYPE macro as
14 intSrv MODULE-IDENTITY
15 LAST-UPDATED "9511030500Z" -- Thu Aug 28 09:04:13 PDT 1997
16 ORGANIZATION "IETF Integrated Services Working Group"
21 Santa Barbara, California 93111
23 E-Mail: fred@cisco.com
26 Postal: ArrowPoint Communications
28 Westford, Massachusetts 01886
32 "The MIB module to describe the Integrated Services
36 intSrvObjects OBJECT IDENTIFIER ::= { intSrv 1 }
37 intSrvGenObjects OBJECT IDENTIFIER ::= { intSrv 2 }
38 intSrvNotifications OBJECT IDENTIFIER ::= { intSrv 3 }
39 intSrvConformance OBJECT IDENTIFIER ::= { intSrv 4 }
41 -- Textual Conventions
44 SessionNumber ::= TEXTUAL-CONVENTION
47 "The Session Number convention is used for
48 numbers identifying sessions or saved PATH or
49 RESV information. It is a number in the range
50 returned by a TestAndIncr variable, having no
51 protocol meaning whatsoever but serving instead
54 The alternative was a very complex instance or
55 instance object that became unwieldy."
56 SYNTAX INTEGER (0..2147483647)
59 Protocol ::= TEXTUAL-CONVENTION
63 "The value of the IP Protocol field of an IP
64 Datagram Header. This identifies the protocol
65 layer above IP. For example, the value 6 is
66 used for TCP and the value 17 is used for UDP.
67 The values of this field are defined in the As-
69 SYNTAX INTEGER (1..255)
72 SessionType ::= TEXTUAL-CONVENTION
75 "The value of the C-Type field of a Session ob-
76 ject, as defined in the RSVP specification.
77 This value determines the lengths of octet
78 strings and use of certain objects such as the
79 'port' variables. If the C-Type calls for an
80 IP6 address, one would expect all source, des-
81 tination, and next/previous hop addresses to be
82 16 bytes long, and for the ports to be UDP/TCP
83 port numbers, for example."
84 SYNTAX INTEGER (1..255)
86 Port ::= TEXTUAL-CONVENTION
87 -- DISPLAY-HINT "d" ---- illegal for OCTET STRING.
90 "The value of the UDP or TCP Source or Destina-
91 tion Port field, a virtual destination port or
92 generalized port identifier used with the IPSEC
93 Authentication Header or Encapsulating Security
94 Payload, or other session discriminator. If it
95 is not used, the value should be of length 0.
96 This pair, when coupled with the IP Addresses
97 of the source and destination system and the IP
98 protocol field, uniquely identifies a data
100 SYNTAX OCTET STRING (SIZE(2..4))
103 MessageSize ::= TEXTUAL-CONVENTION
107 "The size of a message in bytes. This is used
108 to specify the minimum and maximum size of a
109 message along an integrated services route."
110 SYNTAX INTEGER (0..'7FFFFFFF'h)
113 BitRate ::= TEXTUAL-CONVENTION
117 "The rate, in bits/second, that data may move
118 in the context. Applicable contexts minimally
119 include the speed of an interface or virtual
120 circuit, the data rate of a (potentially aggre-
121 gated) data flow, or the data rate to be allo-
122 cated for use by a flow."
123 SYNTAX INTEGER (0..'7FFFFFFF'h)
125 BurstSize ::= TEXTUAL-CONVENTION
129 "The number of octets of IP Data, including IP
130 Headers, that a stream may send without concern
132 SYNTAX INTEGER (0..'7FFFFFFF'h)
135 QosService ::= TEXTUAL-CONVENTION
138 "The class of service in use by a flow."
140 bestEffort (1), -- Best Effort Service
141 guaranteedDelay (2), -- Guaranteed Delay
142 controlledLoad (5) -- Controlled Load
145 -- The Integrated Services Interface Attributes Database contains
146 -- information about resources allocated by resource reservation
147 -- protocols, such as RSVP and ST-II.
150 intSrvIfAttribTable OBJECT-TYPE
151 SYNTAX SEQUENCE OF IntSrvIfAttribEntry
152 MAX-ACCESS not-accessible
155 "The reservable attributes of the system's in-
157 ::= { intSrvObjects 1 }
160 intSrvIfAttribEntry OBJECT-TYPE
161 SYNTAX IntSrvIfAttribEntry
162 MAX-ACCESS not-accessible
165 "The reservable attributes of a given inter-
168 ::= { intSrvIfAttribTable 1 }
170 IntSrvIfAttribEntry ::=
172 intSrvIfAttribAllocatedBits BitRate,
173 intSrvIfAttribMaxAllocatedBits BitRate,
174 intSrvIfAttribAllocatedBuffer BurstSize,
175 intSrvIfAttribFlows Gauge32,
176 intSrvIfAttribPropagationDelay Integer32,
177 intSrvIfAttribStatus RowStatus
180 intSrvIfAttribAllocatedBits OBJECT-TYPE
182 UNITS "Bits per second"
186 "The number of bits/second currently allocated
187 to reserved sessions on the interface."
188 ::= { intSrvIfAttribEntry 1 }
190 intSrvIfAttribMaxAllocatedBits OBJECT-TYPE
192 UNITS "Bits per second"
193 MAX-ACCESS read-create
196 "The maximum number of bits/second that may be
197 allocated to reserved sessions on the inter-
199 ::= { intSrvIfAttribEntry 2 }
202 intSrvIfAttribAllocatedBuffer OBJECT-TYPE
208 "The amount of buffer space required to hold
209 the simultaneous burst of all reserved flows on
211 ::= { intSrvIfAttribEntry 3 }
214 intSrvIfAttribFlows OBJECT-TYPE
219 "The number of reserved flows currently active
220 on this interface. A flow can be created ei-
221 ther from a reservation protocol (such as RSVP
222 or ST-II) or via configuration information."
223 ::= { intSrvIfAttribEntry 4 }
225 intSrvIfAttribPropagationDelay OBJECT-TYPE
228 MAX-ACCESS read-create
231 "The amount of propagation delay that this in-
232 terface introduces in addition to that intro-
233 diced by bit propagation delays."
234 DEFVAL { 0 }-- by default, interfaces are presumed to add
236 ::= { intSrvIfAttribEntry 5 }
239 intSrvIfAttribStatus OBJECT-TYPE
241 MAX-ACCESS read-create
244 "'active' on interfaces that are configured for
246 ::= { intSrvIfAttribEntry 6 }
249 -- The Integrated Services Active Flows Database
250 -- lists all flows active on an outgoing interface, including
251 -- relevant attributes.
254 intSrvFlowTable OBJECT-TYPE
255 SYNTAX SEQUENCE OF IntSrvFlowEntry
256 MAX-ACCESS not-accessible
259 "Information describing the reserved flows us-
260 ing the system's interfaces."
261 ::= { intSrvObjects 2 }
264 intSrvFlowEntry OBJECT-TYPE
265 SYNTAX IntSrvFlowEntry
266 MAX-ACCESS not-accessible
269 "Information describing the use of a given in-
270 terface by a given flow. The counter
271 intSrvFlowPoliced starts counting at the in-
272 stallation of the flow."
273 INDEX { intSrvFlowNumber }
274 ::= { intSrvFlowTable 1 }
279 intSrvFlowNumber SessionNumber,
280 intSrvFlowType SessionType,
281 intSrvFlowOwner INTEGER,
282 intSrvFlowDestAddr OCTET STRING,
283 intSrvFlowSenderAddr OCTET STRING,
284 intSrvFlowDestAddrLength INTEGER,
285 intSrvFlowSenderAddrLength INTEGER,
286 intSrvFlowProtocol Protocol,
287 intSrvFlowDestPort Port,
289 intSrvFlowFlowId INTEGER,
290 intSrvFlowInterface InterfaceIndex,
291 intSrvFlowIfAddr OCTET STRING,
292 intSrvFlowRate BitRate,
293 intSrvFlowBurst BurstSize,
294 intSrvFlowWeight Integer32,
295 intSrvFlowQueue Integer32,
296 intSrvFlowMinTU MessageSize,
297 intSrvFlowMaxTU MessageSize,
298 intSrvFlowBestEffort Counter32,
299 intSrvFlowPoliced Counter32,
300 intSrvFlowDiscard TruthValue,
301 intSrvFlowService QosService,
302 intSrvFlowOrder INTEGER,
303 intSrvFlowStatus RowStatus
307 intSrvFlowNumber OBJECT-TYPE
309 MAX-ACCESS not-accessible
312 "The number of this flow. This is for SNMP In-
313 dexing purposes only and has no relation to any
315 ::= { intSrvFlowEntry 1 }
318 intSrvFlowType OBJECT-TYPE
320 MAX-ACCESS read-create
323 "The type of session (IP4, IP6, IP6 with flow
325 ::= { intSrvFlowEntry 2 }
328 intSrvFlowOwner OBJECT-TYPE
334 MAX-ACCESS read-create
337 "The process that installed this flow in the
338 queue policy database."
339 ::= { intSrvFlowEntry 3 }
342 intSrvFlowDestAddr OBJECT-TYPE
343 SYNTAX OCTET STRING (SIZE(4..16))
344 MAX-ACCESS read-create
347 "The destination address used by all senders in
348 this session. This object may not be changed
349 when the value of the RowStatus object is 'ac-
351 ::= { intSrvFlowEntry 4 }
354 intSrvFlowSenderAddr OBJECT-TYPE
355 SYNTAX OCTET STRING (SIZE(4..16))
356 MAX-ACCESS read-create
359 "The source address of the sender selected by
360 this reservation. The value of all zeroes in-
361 dicates 'all senders'. This object may not be
362 changed when the value of the RowStatus object
364 ::= { intSrvFlowEntry 5 }
367 intSrvFlowDestAddrLength OBJECT-TYPE
368 SYNTAX INTEGER(0..128)
369 MAX-ACCESS read-create
372 "The length of the destination address in bits.
373 This is the CIDR Prefix Length, which for IP4
374 hosts and multicast addresses is 32 bits. This
375 object may not be changed when the value of the
376 RowStatus object is 'active'."
377 ::= { intSrvFlowEntry 6 }
380 intSrvFlowSenderAddrLength OBJECT-TYPE
381 SYNTAX INTEGER(0..128)
382 MAX-ACCESS read-create
385 "The length of the sender's address in bits.
386 This is the CIDR Prefix Length, which for IP4
387 hosts and multicast addresses is 32 bits. This
388 object may not be changed when the value of the
389 RowStatus object is 'active'."
390 ::= { intSrvFlowEntry 7 }
393 intSrvFlowProtocol OBJECT-TYPE
395 MAX-ACCESS read-create
398 "The IP Protocol used by a session. This ob-
399 ject may not be changed when the value of the
400 RowStatus object is 'active'."
401 ::= { intSrvFlowEntry 8 }
404 intSrvFlowDestPort OBJECT-TYPE
406 MAX-ACCESS read-create
409 "The UDP or TCP port number used as a destina-
410 tion port for all senders in this session. If
411 the IP protocol in use, specified by
412 intSrvResvFwdProtocol, is 50 (ESP) or 51 (AH),
413 this represents a virtual destination port
414 number. A value of zero indicates that the IP
415 protocol in use does not have ports. This ob-
416 ject may not be changed when the value of the
417 RowStatus object is 'active'."
418 ::= { intSrvFlowEntry 9 }
421 intSrvFlowPort OBJECT-TYPE
423 MAX-ACCESS read-create
426 "The UDP or TCP port number used as a source
427 port for this sender in this session. If the
428 IP protocol in use, specified by
429 intSrvResvFwdProtocol is 50 (ESP) or 51 (AH),
430 this represents a generalized port identifier
431 (GPI). A value of zero indicates that the IP
432 protocol in use does not have ports. This ob-
433 ject may not be changed when the value of the
434 RowStatus object is 'active'."
435 ::= { intSrvFlowEntry 10 }
438 intSrvFlowFlowId OBJECT-TYPE
439 SYNTAX INTEGER (0..16777215)
443 "The flow ID that this sender is using, if
444 this is an IPv6 session."
445 ::= { intSrvFlowEntry 11 }
448 intSrvFlowInterface OBJECT-TYPE
449 SYNTAX InterfaceIndex
450 MAX-ACCESS read-create
453 "The ifIndex value of the interface on which
454 this reservation exists."
455 ::= { intSrvFlowEntry 12 }
458 intSrvFlowIfAddr OBJECT-TYPE
459 SYNTAX OCTET STRING (SIZE(4..16))
460 MAX-ACCESS read-create
463 "The IP Address on the ifEntry on which this
464 reservation exists. This is present primarily
465 to support those interfaces which layer multi-
466 ple IP Addresses on the interface."
467 ::= { intSrvFlowEntry 13 }
470 intSrvFlowRate OBJECT-TYPE
472 UNITS "bits per second"
473 MAX-ACCESS read-create
476 "The Reserved Rate of the sender's data stream.
477 If this is a Controlled Load service flow, this
478 rate is derived from the Tspec rate parameter
479 (r). If this is a Guaranteed service flow,
480 this rate is derived from the Rspec clearing
482 ::= { intSrvFlowEntry 14 }
485 intSrvFlowBurst OBJECT-TYPE
488 MAX-ACCESS read-create
491 "The size of the largest burst expected from
492 the sender at a time.
494 If this is less than the sender's advertised
495 burst size, the receiver is asking the network
496 to provide flow pacing beyond what would be
497 provided under normal circumstances. Such pac-
498 ing is at the network's option."
499 ::= { intSrvFlowEntry 15 }
502 intSrvFlowWeight OBJECT-TYPE
504 MAX-ACCESS read-create
507 "The weight used to prioritize the traffic.
508 Note that the interpretation of this object is
509 implementation-specific, as implementations
510 vary in their use of weighting procedures."
511 ::= { intSrvFlowEntry 16 }
513 intSrvFlowQueue OBJECT-TYPE
515 MAX-ACCESS read-create
518 "The number of the queue used by this traffic.
519 Note that the interpretation of this object is
520 implementation-specific, as implementations
521 vary in their use of queue identifiers."
522 ::= { intSrvFlowEntry 17 }
525 intSrvFlowMinTU OBJECT-TYPE
527 MAX-ACCESS read-create
530 "The minimum message size for this flow. The
531 policing algorithm will treat smaller messages
532 as though they are this size."
533 ::= { intSrvFlowEntry 18 }
536 intSrvFlowMaxTU OBJECT-TYPE
538 MAX-ACCESS read-create
541 "The maximum datagram size for this flow that
542 will conform to the traffic specification. This
543 value cannot exceed the MTU of the interface."
544 ::= { intSrvFlowEntry 19 }
547 intSrvFlowBestEffort OBJECT-TYPE
552 "The number of packets that were remanded to
553 best effort service."
554 ::= { intSrvFlowEntry 20 }
557 intSrvFlowPoliced OBJECT-TYPE
562 "The number of packets policed since the incep-
563 tion of the flow's service."
564 ::= { intSrvFlowEntry 21 }
567 intSrvFlowDiscard OBJECT-TYPE
569 MAX-ACCESS read-create
572 "If 'true', the flow is to incur loss when
573 traffic is policed. If 'false', policed traff-
574 ic is treated as best effort traffic."
575 DEFVAL { false } -- traffic is, by default, treated as best
577 ::= { intSrvFlowEntry 22 }
580 intSrvFlowService OBJECT-TYPE
585 "The QoS service being applied to this flow."
586 ::= { intSrvFlowEntry 23 }
589 intSrvFlowOrder OBJECT-TYPE
590 SYNTAX INTEGER (0..65535)
591 MAX-ACCESS read-create
594 "In the event of ambiguity, the order in which
595 the classifier should make its comparisons.
596 The row with intSrvFlowOrder=0 is tried first,
597 and comparisons proceed in the order of in-
598 creasing value. Non-serial implementations of
599 the classifier should emulate this behavior."
600 ::= { intSrvFlowEntry 24 }
603 intSrvFlowStatus OBJECT-TYPE
605 MAX-ACCESS read-create
608 "'active' for all active flows. This object
609 may be used to install static classifier infor-
610 mation, delete classifier information, or au-
612 ::= { intSrvFlowEntry 25 }
615 intSrvFlowNewIndex OBJECT-TYPE
617 MAX-ACCESS read-write
620 "This object is used to assign values to
621 intSrvFlowNumber as described in 'Textual Con-
622 ventions for SNMPv2'. The network manager
623 reads the object, and then writes the value
624 back in the SET that creates a new instance of
625 intSrvFlowEntry. If the SET fails with the
626 code 'inconsistentValue', then the process must
627 be repeated; If the SET succeeds, then the ob-
628 ject is incremented, and the new instance is
629 created according to the manager's directions."
630 ::= { intSrvGenObjects 1 }
633 -- conformance information
636 intSrvGroups OBJECT IDENTIFIER ::= { intSrvConformance 1 }
637 intSrvCompliances OBJECT IDENTIFIER ::= { intSrvConformance 2 }
639 -- compliance statements
642 intSrvCompliance MODULE-COMPLIANCE
645 "The compliance statement "
646 MODULE -- this module
647 MANDATORY-GROUPS { intSrvIfAttribGroup, intSrvFlowsGroup }
649 OBJECT intSrvFlowType
652 "read-create access is not required. This may be
655 OBJECT intSrvFlowOwner
658 "read-create access is not required. This may be
661 OBJECT intSrvFlowDestAddr
664 "read-create access is not required. This may be
667 OBJECT intSrvFlowSenderAddr
670 "read-create access is not required. This may be
673 OBJECT intSrvFlowDestAddrLength
676 "read-create access is not required. This may be
679 OBJECT intSrvFlowSenderAddrLength
682 "read-create access is not required. This may be
685 OBJECT intSrvFlowProtocol
688 "read-create access is not required. This may be
691 OBJECT intSrvFlowDestPort
694 "read-create access is not required. This may be
697 OBJECT intSrvFlowPort
700 "read-create access is not required. This may be
703 OBJECT intSrvFlowFlowId
704 MIN-ACCESS not-accessible
706 "This object is needed only in a system that imple-
709 OBJECT intSrvFlowInterface
712 "read-create access is not required. This may be
715 OBJECT intSrvFlowRate
718 "read-create access is not required. This may be
721 OBJECT intSrvFlowBurst
724 "read-create access is not required. This may be
727 OBJECT intSrvFlowWeight
730 "read-create access is not required. This may be
733 OBJECT intSrvFlowQueue
736 "read-create access is not required. This may be
739 OBJECT intSrvFlowMinTU
742 "read-create access is not required. This may be
745 OBJECT intSrvFlowMaxTU
748 "read-create access is not required. This may be
751 OBJECT intSrvFlowStatus
754 "read-create access is not required. This may be
757 ::= { intSrvCompliances 1 }
760 intSrvIfAttribGroup OBJECT-GROUP
762 intSrvIfAttribAllocatedBits, intSrvIfAttribMaxAllocatedBits,
763 intSrvIfAttribAllocatedBuffer, intSrvIfAttribFlows,
764 intSrvIfAttribPropagationDelay, intSrvIfAttribStatus
768 "These objects are required for Systems sup-
769 porting the Integrated Services Architecture."
770 ::= { intSrvGroups 1 }
772 intSrvFlowsGroup OBJECT-GROUP
774 intSrvFlowType, intSrvFlowOwner, intSrvFlowDestAddr,
775 intSrvFlowSenderAddr, intSrvFlowDestAddrLength,
776 intSrvFlowSenderAddrLength, intSrvFlowProtocol,
777 intSrvFlowDestPort, intSrvFlowPort, intSrvFlowInterface,
778 intSrvFlowBestEffort, intSrvFlowRate, intSrvFlowBurst,
779 intSrvFlowWeight, intSrvFlowQueue, intSrvFlowMinTU,
780 intSrvFlowDiscard, intSrvFlowPoliced, intSrvFlowService,
781 intSrvFlowIfAddr, intSrvFlowOrder, intSrvFlowStatus
785 "These objects are required for Systems sup-
786 porting the Integrated Services Architecture."
787 ::= { intSrvGroups 2 }