-- extracted from draft-ietf-diffserv-mib-11.txt -- at Wed Aug 22 06:05:54 2001 DIFFSERV-MIB DEFINITIONS ::= BEGIN IMPORTS Unsigned32, Counter32, Counter64, MODULE-IDENTITY, OBJECT-TYPE, OBJECT-IDENTITY, zeroDotZero, mib-2 FROM SNMPv2-SMI TEXTUAL-CONVENTION, RowStatus, RowPointer, TimeStamp FROM SNMPv2-TC MODULE-COMPLIANCE, OBJECT-GROUP FROM SNMPv2-CONF ifIndex FROM IF-MIB InetAddressType, InetAddress, InetAddressPrefixLength, InetPortNumber FROM INET-ADDRESS-MIB BurstSize FROM INTEGRATED-SERVICES-MIB Dscp, DscpOrAny FROM DIFFSERV-DSCP-TC; diffServMib MODULE-IDENTITY LAST-UPDATED "0102210000Z" ORGANIZATION "IETF Differentiated Services WG" CONTACT-INFO " Fred Baker Cisco Systems 519 Lado Drive Santa Barbara, CA 93111, USA E-mail: fred@cisco.com Kwok Ho Chan Nortel Networks 600 Technology Park Drive Billerica, MA 01821, USA E-mail: khchan@nortelnetworks.com Andrew Smith Allegro Networks 6399 San Ignacio Ave San Jose, CA 95119, USA E-mail: andrew@allegronetworks.com Differentiated Services Working Group: diffserv@ietf.org" DESCRIPTION "This MIB defines the objects necessary to manage a device that uses the Differentiated Services Architecture described in RFC 2475. The Conceptual Model of a Differentiated Services Router provides supporting information on how such a router is modeled." REVISION "0106030000Z" DESCRIPTION "Initial version, published as RFC xxxx." ::= { mib-2 1 } diffServMIBObjects OBJECT IDENTIFIER ::= { diffServMib 1 } diffServMIBConformance OBJECT IDENTIFIER ::= { diffServMib 2 } -- These textual conventions have no effect on either the syntax -- or the semantics of any managed object. Objects defined using -- this convention are always encoded by means of the rules that -- define their primitive type. IfDirection ::= TEXTUAL-CONVENTION STATUS current DESCRIPTION "IfDirection specifies a direction of data travel on an interface. 'inbound' traffic is operated on during reception from the interface, while 'outbound' traffic is operated on prior to transmission on the interface." SYNTAX INTEGER { inbound(1), -- ingress interface outbound(2) -- egress interface } -- -- Data Path -- diffServDataPath OBJECT IDENTIFIER ::= { diffServMIBObjects 1 } -- -- Data Path Table -- -- The Data Path Table enumerates the Differentiated Services -- Functional Data Paths within this device. Each entry in this -- table is indexed by ifIndex and ifDirection. Each entry provides -- the first Differentiated Services Functional Data Path Element to -- process data flowing along specific data path. This table should -- have at most two entries for each interface capable of Differentiated -- Services processing on this device: ingress and egress. -- Note that Differentiated Services Functional Data Path Elements -- linked together using their individual next pointers and anchored -- by an entry of the diffServDataPathTable constitute a functional data -- path. -- diffServDataPathTable OBJECT-TYPE SYNTAX SEQUENCE OF DiffServDataPathEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "The data path table contains RowPointers indicating the start of the functional data path for each interface and traffic direction in this device. These may merge, or be separated into parallel data paths by meters or classifiers." ::= { diffServDataPath 1 } diffServDataPathEntry OBJECT-TYPE SYNTAX DiffServDataPathEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An entry in the data path table indicates the start of a single Differentiated Services Functional Data Path in this device." INDEX { ifIndex, diffServDataPathIfDirection } ::= { diffServDataPathTable 1 } DiffServDataPathEntry ::= SEQUENCE { diffServDataPathIfDirection IfDirection, diffServDataPathStart RowPointer, diffServDataPathStatus RowStatus } diffServDataPathIfDirection OBJECT-TYPE SYNTAX IfDirection MAX-ACCESS not-accessible STATUS current DESCRIPTION "IfDirection specifies whether the reception or transmission path for this interface is in view." ::= { diffServDataPathEntry 1 } diffServDataPathStart OBJECT-TYPE SYNTAX RowPointer MAX-ACCESS read-create STATUS current DESCRIPTION "This selects the first Differentiated Services Functional Data Path Element to handle traffic for this data path. This RowPointer should point to an instance of one of: diffServClfrEntry diffServMeterEntry diffServActionEntry diffServAlgDropEntry diffServQEntry A value of zeroDotZero in this attribute indicates that no Differentiated Services treatment is performed on traffic of this data path. A pointer with the value zeroDotZero normally terminates a functional data path. If the row pointed to does not exist, the treatment is as if this attribute contains a value of zeroDotZero." ::= { diffServDataPathEntry 2 } diffServDataPathStatus OBJECT-TYPE SYNTAX RowStatus MAX-ACCESS read-create STATUS current DESCRIPTION "The RowStatus variable controls the activation, deactivation, or deletion of a row/entry. Any writable variable may be modified whether the row is active or notInService." ::= { diffServDataPathEntry 3 } -- -- Classifiers -- diffServClassifier OBJECT IDENTIFIER ::= { diffServMIBObjects 2 } -- -- Classifier Table -- --The Classifier Table allows multiple classifier elements, of same --or different types, to be used together. A classifier must completely --classify all packets presented to it. This means that all traffic --presented to a classifier must match at least one classifier element --within the classifier, with the classifier element parameters --specified by a filter. -- --If there is ambiguity between classifier elements of different --classifier, classifier linkage order indicates their precedence; --the first classifier in the link is applied to the traffic first. -- --Entries in the classifier element table serves as the anchor for --each classification pattern, defined in filter table entries. --Each classifier element table entry also specifies the subsequent --downstream Differentiated Services Functional Data Path Element --when the classification pattern is satisfied. Each entry in the --classifier element table describes one branch of the fan-out --characteristic of a classifier indicated in the Informal Differentiated Services Model section 4.1. --A classifier is composed of one or more classifier elements. diffServClfrNextFree OBJECT-TYPE SYNTAX IndexInteger MAX-ACCESS read-only STATUS current DESCRIPTION "This object yields a value when read that is currently unused for a diffServClfrId instance. If a configuring system attempts to create a new row in the diffServClfrTable using this value, but an instance has been created or is in the process of being created, that operation will fail." ::= { diffServClassifier 1 } diffServClfrTable OBJECT-TYPE SYNTAX SEQUENCE OF DiffServClfrEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "This table enumerates all the diffserv classifier functional data path elements of this device. The actual classification definitions are defined in diffServClfrElementTable entries belonging to each classifier. An entry in this table, pointed to by a RowPointer specifying an instance of diffServClfrStatus, is frequently used as the name for a set of classifier elements, which all use the index diffServClfrId. Per the semantics of the classifier element table, these entries constitute one or more unordered sets of tests which may be simultaneously applied to a message to classify it." REFERENCE "the Informal Differentiated Services Model section 4.1" ::= { diffServClassifier 2 } diffServClfrEntry OBJECT-TYPE SYNTAX DiffServClfrEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An entry in the classifier table describes a single classifier. All classifier elements belonging to the same classifier uses the classifier's diffServClfrId in their diffServClfrElementClfrId attribute." INDEX { diffServClfrId } ::= { diffServClfrTable 1 } DiffServClfrEntry ::= SEQUENCE { diffServClfrId IndexInteger, diffServClfrStatus RowStatus } diffServClfrId OBJECT-TYPE SYNTAX IndexInteger MAX-ACCESS not-accessible STATUS current DESCRIPTION "An index that enumerates the classifier entries. The set of such identifiers spans the whole agent. Managers should obtain new values for row creation in this table by reading diffServClfrNextFree." ::= { diffServClfrEntry 1 } diffServClfrStatus OBJECT-TYPE SYNTAX RowStatus MAX-ACCESS read-create STATUS current DESCRIPTION "The RowStatus variable controls the activation, deactivation, or deletion of a classifier. Any writable variable may be modified whether the row is active or notInService." ::= { diffServClfrEntry 2 } -- Classifier Element Table -- diffServClfrElementNextFree OBJECT-TYPE SYNTAX IndexInteger MAX-ACCESS read-only STATUS current DESCRIPTION "This object yields a value when read that is currently unused for a diffServClfrElementId instance. If a configuring system attempts to create a new row in the diffServClfrElementTable using this value, but an instance has been created or is in the process of being created, that operation will fail." ::= { diffServClassifier 3 } diffServClfrElementTable OBJECT-TYPE SYNTAX SEQUENCE OF DiffServClfrElementEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "The classifier element table enumerates the relationship between classification patterns and subsequent downstream Differentiated Services Functional Data Path elements. diffServClfrElementSpecific points to a filter that specifies the classification parameters. A classifier may use filter tables of different types together. One example of a filter table defined in this MIB is diffServMultiFieldClfrTable, for IP Multi-Field Classifiers (MFCs). Such an entry might identify anything from a single micro-flow (an identifiable sub-session packet stream directed from one sending transport to the receiving transport or transports), or aggregates of those such as the traffic from a host, traffic for an application, or traffic between two hosts using an application and a given DSCP. The standard Behavior Aggregate used in the Differentiated Services Architecture is encoded as a degenerate case of such an aggregate - the traffic using a particular DSCP value. Filter tables for other filter types may be defined elsewhere." REFERENCE "the Informal Differentiated Services Model section 4.1" ::= { diffServClassifier 4 } diffServClfrElementEntry OBJECT-TYPE SYNTAX DiffServClfrElementEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An entry in the classifier element table describes a single element of the classifier." INDEX { diffServClfrElementClfrId, diffServClfrElementId } ::= { diffServClfrElementTable 1 } DiffServClfrElementEntry ::= SEQUENCE { diffServClfrElementClfrId IndexInteger, diffServClfrElementId IndexInteger, diffServClfrElementPrecedence Unsigned32, diffServClfrElementNext RowPointer, diffServClfrElementSpecific RowPointer, diffServClfrElementStatus RowStatus } diffServClfrElementClfrId OBJECT-TYPE SYNTAX IndexInteger MAX-ACCESS not-accessible STATUS current DESCRIPTION "An index that enumerates the classifier entries. The set of such identifiers spans the whole agent. Managers obtain new values for row creation in this table by reading diffServClfrNextFree. A classifier Id identifies which classifier this classifier element is a part of." ::= { diffServClfrElementEntry 1 } diffServClfrElementId OBJECT-TYPE SYNTAX IndexInteger MAX-ACCESS not-accessible STATUS current DESCRIPTION "An index that enumerates the Classifier Element entries. The set of such identifiers spans the whole agent. Managers obtain new values for row creation in this table by reading diffServClfrElementNextFree." ::= { diffServClfrElementEntry 2 } diffServClfrElementPrecedence OBJECT-TYPE SYNTAX Unsigned32 MAX-ACCESS read-create STATUS current DESCRIPTION "The relative order in which classifier elements are applied: higher numbers represent classifier element with higher precedence. Classifier elements with the same order must be unambiguous i.e. they must define non-overlapping patterns, and are considered to be applied simultaneously to the traffic stream. Classifier elements with different order may overlap in their filters: the classifier element with the highest order that matches is taken. On a given interface, there must be a complete classifier in place at all times in the ingress direction. This means one or more filters must match any possible pattern. There is no such requirement in the egress direction." DEFVAL { 0 } ::= { diffServClfrElementEntry 3 } diffServClfrElementNext OBJECT-TYPE SYNTAX RowPointer MAX-ACCESS read-create STATUS current DESCRIPTION "This attribute provides one branch of the fan-out functionality of a classifier described in the Informal Differentiated Services Model section 4.1. This selects the next Differentiated Services Functional Data Path Element to handle traffic for this data path. This RowPointer should point to an instance of one of: diffServClfrEntry diffServMeterEntry diffServActionEntry diffServAlgDropEntry diffServQEntry A value of zeroDotZero in this attribute indicates no further Differentiated Services treatment is performed on traffic of this data path. The use of zeroDotZero is the normal usage for the last functional data path element of the current data path. If the row pointed to does not exist, the treatment is as if this attribute contains a value of zeroDotZero." ::= { diffServClfrElementEntry 4 } diffServClfrElementSpecific OBJECT-TYPE SYNTAX RowPointer MAX-ACCESS read-create STATUS current DESCRIPTION "A pointer to a valid entry in another table, filter table, that describes the applicable classification parameters, e.g. an entry in diffServMultiFieldClfrTable. If the row pointed to does not exist, the classifier element is ignored. The value zeroDotZero is interpreted to match anything not matched by another classifier element - only one such entry may exist for each classifier." DEFVAL { zeroDotZero } ::= { diffServClfrElementEntry 5 } diffServClfrElementStatus OBJECT-TYPE SYNTAX RowStatus MAX-ACCESS read-create STATUS current DESCRIPTION "The RowStatus variable controls the activation, deactivation, or deletion of a classifier element. Any writeable variable may be modified whether the row is active or notInService." ::= { diffServClfrElementEntry 6 } -- -- IP Six-Tuple Classification Table -- --Classification based on six different fields in the IP header. --Functional Data Paths may share definitions by using the same entry. -- diffServMultiFieldClfrNextFree OBJECT-TYPE SYNTAX IndexInteger MAX-ACCESS read-only STATUS current DESCRIPTION "This object yields a value when read that is currently unused for a diffServMultiFieldClfrId instance. If a configuring system attempts to create a new row in the diffServMultiFieldClfrTable using this value, but an instance has been created or is in the process of being created, that operation will fail." ::= { diffServClassifier 5 } diffServMultiFieldClfrTable OBJECT-TYPE SYNTAX SEQUENCE OF DiffServMultiFieldClfrEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "A table of IP Six-Tuple Classifier filter entries that a system may use to identify IP traffic." REFERENCE "the Informal Differentiated Services Model section 4.2.2" ::= { diffServClassifier 6 } diffServMultiFieldClfrEntry OBJECT-TYPE SYNTAX DiffServMultiFieldClfrEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An IP Six-Tuple Classifier entry describes a single filter." INDEX { diffServMultiFieldClfrId } ::= { diffServMultiFieldClfrTable 1 } DiffServMultiFieldClfrEntry ::= SEQUENCE { diffServMultiFieldClfrId INTEGER, diffServMultiFieldClfrAddrType InetAddressType, diffServMultiFieldClfrDstAddr InetAddress, diffServMultiFieldClfrDstPrefixLength InetAddressPrefixLength, diffServMultiFieldClfrSrcAddr InetAddress, diffServMultiFieldClfrSrcPrefixLength InetAddressPrefixLength, diffServMultiFieldClfrDscp DscpOrAny, diffServMultiFieldClfrFlowId INTEGER, diffServMultiFieldClfrProtocol Unsigned32, diffServMultiFieldClfrDstL4PortMin InetPortNumber, diffServMultiFieldClfrDstL4PortMax InetPortNumber, diffServMultiFieldClfrSrcL4PortMin InetPortNumber, diffServMultiFieldClfrSrcL4PortMax InetPortNumber, diffServMultiFieldClfrStatus RowStatus } diffServMultiFieldClfrId OBJECT-TYPE SYNTAX IndexInteger MAX-ACCESS not-accessible STATUS current DESCRIPTION "An index that enumerates the MultiField Classifier filter entries. The set of such identifiers spans the whole agent. Managers obtain new values for row creation in this table by reading diffServMultiFieldClfrNextFree." ::= { diffServMultiFieldClfrEntry 1 } diffServMultiFieldClfrAddrType OBJECT-TYPE SYNTAX InetAddressType MAX-ACCESS read-create STATUS current DESCRIPTION "The type of IP address used by this classifier entry." ::= { diffServMultiFieldClfrEntry 2 } diffServMultiFieldClfrDstAddr OBJECT-TYPE SYNTAX InetAddress MAX-ACCESS read-create STATUS current DESCRIPTION "The IP address to match against the packet's destination IP address. diffServMultiFieldClfrDstPrefixLength indicates the number of bits that are relevant." ::= { diffServMultiFieldClfrEntry 3 } diffServMultiFieldClfrDstPrefixLength OBJECT-TYPE SYNTAX InetAddressPrefixLength UNITS "bits" MAX-ACCESS read-create STATUS current DESCRIPTION "The length of the CIDR Prefix carried in diffServMultiFieldClfrDstAddr. In IPv4 addresses, a length of 0 indicates a match of any address; a length of 32 indicates a match of a single host address, and a length between 0 and 32 indicates the use of a CIDR Prefix. IPv6 is similar, except that prefix lengths range from 0..128." DEFVAL { 0 } ::= { diffServMultiFieldClfrEntry 4 } diffServMultiFieldClfrSrcAddr OBJECT-TYPE SYNTAX InetAddress MAX-ACCESS read-create STATUS current DESCRIPTION "The IP address to match against the packet's source IP address. diffServMultiFieldClfrSrcPrefixLength indicates the number of bits that are relevant." ::= { diffServMultiFieldClfrEntry 6 } diffServMultiFieldClfrSrcPrefixLength OBJECT-TYPE SYNTAX InetAddressPrefixLength UNITS "bits" MAX-ACCESS read-create STATUS current DESCRIPTION "The length of the CIDR Prefix carried in diffServMultiFieldClfrSrcAddr. In IPv4 addresses, a length of 0 indicates a match of any address; a length of 32 indicates a match of a single host address, and a length between 0 and 32 indicates the use of a CIDR Prefix. IPv6 is similar, except that prefix lengths range from 0..128." DEFVAL { 0 } ::= { diffServMultiFieldClfrEntry 7 } diffServMultiFieldClfrDscp OBJECT-TYPE SYNTAX DscpOrAny MAX-ACCESS read-create STATUS current DESCRIPTION "The value that the DSCP in the packet must have to match this entry. A value of -1 indicates that a specific DSCP value has not been defined and thus all DSCP values are considered a match." DEFVAL { -1 } ::= { diffServMultiFieldClfrEntry 8 } diffServMultiFieldClfrFlowID OBJECT-TYPE SYNTAX INTEGER (0..1048575) MAX-ACCESS read-create STATUS current DESCRIPTION "The flow identifier in an IPv6 header." ::= { diffServMultiFieldClfrEntry 5 } diffServMultiFieldClfrProtocol OBJECT-TYPE SYNTAX Unsigned32 (0..255) MAX-ACCESS read-create STATUS current DESCRIPTION "The IP protocol to match against the IPv4 protocol number or the IPv6 Next- Header number in the packet. A value of 255 means match all. Note the protocol number of 255 is reserved by IANA, and Next-Header number of 0 is used in IPv6." DEFVAL { 255 } ::= { diffServMultiFieldClfrEntry 9 } diffServMultiFieldClfrDstL4PortMin OBJECT-TYPE SYNTAX InetPortNumber MAX-ACCESS read-create STATUS current DESCRIPTION "The minimum value that the layer-4 destination port number in the packet must have in order to match this classifier entry." DEFVAL { 0 } ::= { diffServMultiFieldClfrEntry 10 } diffServMultiFieldClfrDstL4PortMax OBJECT-TYPE SYNTAX InetPortNumber MAX-ACCESS read-create STATUS current DESCRIPTION "The maximum value that the layer-4 destination port number in the packet must have in order to match this classifier entry. This value must be equal to or greater than the value specified for this entry in diffServMultiFieldClfrDstL4PortMin." DEFVAL { 65535 } ::= { diffServMultiFieldClfrEntry 11 } diffServMultiFieldClfrSrcL4PortMin OBJECT-TYPE SYNTAX InetPortNumber MAX-ACCESS read-create STATUS current DESCRIPTION "The minimum value that the layer-4 source port number in the packet must have in order to match this classifier entry." DEFVAL { 0 } ::= { diffServMultiFieldClfrEntry 12 } diffServMultiFieldClfrSrcL4PortMax OBJECT-TYPE SYNTAX InetPortNumber MAX-ACCESS read-create STATUS current DESCRIPTION "The maximum value that the layer-4 source port number in the packet must have in oder to match this classifier entry. This value must be equal to or greater than the value specified for this entry in diffServMultiFieldClfrSrcL4PortMin." DEFVAL { 65535 } ::= { diffServMultiFieldClfrEntry 13 } diffServMultiFieldClfrStatus OBJECT-TYPE SYNTAX RowStatus MAX-ACCESS read-create STATUS current DESCRIPTION "The RowStatus variable controls the activation, deactivation, or deletion of a classifier. Any writable variable may be modified whether the row is active or notInService." ::= { diffServMultiFieldClfrEntry 14 } -- -- Meters -- diffServMeter OBJECT IDENTIFIER ::= { diffServMIBObjects 3 } -- -- This MIB supports a variety of Meters. It includes a specific -- definition for Token Bucket Meter, which are but one type of -- specification. Other metering parameter sets can be defined in other MIBs. -- -- Multiple meter elements may be logically cascaded using their -- diffServMeterSucceedNext and diffServMeterFailNext pointers if -- required. One example of this might be for an AF PHB implementation -- that uses multiple level conformance meters. -- -- Cascading of individual meter elements in the MIB is intended to be -- functionally equivalent to multiple level conformance determination -- of a packet. The sequential nature of the representation is merely -- a notational convenience for this MIB. -- -- srTCM meters (RFC 2697) can be specified using two sets of diffServMeterEntry -- and diffServTBParamEntry. The first set specifies the Committed Information -- Rate and Committed Burst Size token-bucket. The second set specifies the -- Excess Burst Size token-bucket. -- -- trTCM meters (RFC 2698) can be specified using two sets of diffServMeterEntry -- and diffServTBParamEntry. The first set specifies the Committed Information -- Rate and Committed Burst Size token-bucket. The second set specifies the -- Peak Information Rate and Peak Burst Size token-bucket. -- -- tswTCM meters (RFC 2859) can be specified using two sets of -- diffServMeterEntry and diffServTBParamEntry. The first set specifies the -- Committed Target Rate token-bucket. The second set specifies the Peak -- Target Rate token-bucket. diffServTBParamInterval in each token bucket -- reflects the Average Interval. diffServMeterNextFree OBJECT-TYPE SYNTAX IndexInteger MAX-ACCESS read-only STATUS current DESCRIPTION "This object yields a value when read that is currently unused for a diffServMeterId instance. If a configuring system attempts to create a new row in the diffServMeterTable using this value, but an instance has been created or is in the process of being created, that operation will fail." ::= { diffServMeter 1 } diffServMeterTable OBJECT-TYPE SYNTAX SEQUENCE OF DiffServMeterEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "This table enumerates specific meters that a system may use to police a stream of traffic. The traffic stream to be metered is determined by the Differentiated Services Functional Data Path Element(s) upstream of the meter i.e. by the object(s) that point to each entry in this table. This may include all traffic on an interface. Specific meter details are to be found in table entry referenced by diffServMeterSpecific." REFERENCE "the Informal Differentiated Services Model section 5.1" ::= { diffServMeter 2 } diffServMeterEntry OBJECT-TYPE SYNTAX DiffServMeterEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An entry in the meter table describes a single conformance level of a meter." INDEX { diffServMeterId } ::= { diffServMeterTable 1 } DiffServMeterEntry ::= SEQUENCE { diffServMeterId INTEGER, diffServMeterSucceedNext RowPointer, diffServMeterFailNext RowPointer, diffServMeterSpecific RowPointer, diffServMeterStatus RowStatus } diffServMeterId OBJECT-TYPE SYNTAX IndexInteger MAX-ACCESS not-accessible STATUS current DESCRIPTION "An index that enumerates the Meter entries. The set of such identifiers spans the whole agent. Managers obtain new values for row creation in this table by reading diffServMeterNextFree." ::= { diffServMeterEntry 1 } diffServMeterSucceedNext OBJECT-TYPE SYNTAX RowPointer MAX-ACCESS read-create STATUS current DESCRIPTION "If the traffic does conform, this selects the next Differentiated Services Functional Data Path element to handle traffic for this data path. This RowPointer should point to an instance of one of: diffServClfrEntry diffServMeterEntry diffServActionEntry diffServAlgDropEntry diffServQEntry A value of zeroDotZero in this attribute indicates that no further Differentiated Services treatment is performed on traffic of this data path. The use of zeroDotZero is the normal usage for the last functional data path element of the current data path. If the row pointed to does not exist, the treatment is as if this attribute contains a value of zeroDotZero." DEFVAL { zeroDotZero } ::= { diffServMeterEntry 2 } diffServMeterFailNext OBJECT-TYPE SYNTAX RowPointer MAX-ACCESS read-create STATUS current DESCRIPTION "If the traffic does not conform, this selects the next Differentiated Services Functional Data Path element to handle traffic for this data path. This RowPointer should point to an instance of one of: diffServClfrEntry diffServMeterEntry diffServActionEntry diffServAlgDropEntry diffServQEntry A value of zeroDotZero in this attribute indicates no further Differentiated Services treatment is performed on traffic of this data path. The use of zeroDotZero is the normal usage for the last functional data path element of the current data path. If the row pointed to does not exist, the treatment is as if this attribute contains a value of zeroDotZero." DEFVAL { zeroDotZero } ::= { diffServMeterEntry 3 } diffServMeterSpecific OBJECT-TYPE SYNTAX RowPointer MAX-ACCESS read-create STATUS current DESCRIPTION "This indicates the behavior of the meter by pointing to an entry containing detailed parameters. Note that entries in that specific table must be managed explicitly. For example, diffServMeterSpecific may point to an entry in diffServTBParamTable, which contains an instance of a single set of Token Bucket parameters." ::= { diffServMeterEntry 4 } diffServMeterStatus OBJECT-TYPE SYNTAX RowStatus MAX-ACCESS read-create STATUS current DESCRIPTION "The RowStatus variable controls the activation, deactivation, or deletion of a meter. Any writable variable may be modified whether the row is active or notInService." ::= { diffServMeterEntry 5 } -- -- Token Bucket Parameter Table -- diffServTBParam OBJECT IDENTIFIER ::= { diffServMIBObjects 4 } -- Each entry in the Token Bucket Parameter Table parameterize a single -- token bucket. Multiple token buckets can be used together to -- parameterize multiple levels of conformance. -- -- Note that an entry in the Token Bucket Parameter Table can be shared -- by multiple diffServMeterTable entries. -- diffServTBParamNextFree OBJECT-TYPE SYNTAX IndexInteger MAX-ACCESS read-only STATUS current DESCRIPTION "This object yields a value when read that is currently unused for a diffServTBParamId instance. If a configuring system attempts to create a new row in the diffServTBParamTable using this value, but an instance has been created or is in the process of being created, that operation will fail." ::= { diffServTBParam 1 } diffServTBParamTable OBJECT-TYPE SYNTAX SEQUENCE OF DiffServTBParamEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "This table enumerates a single set of token bucket meter parameters that a system may use to police a stream of traffic. Such meters are modeled here as having a single rate and a single burst size. Multiple entries are used when multiple rates/burst sizes are needed." REFERENCE "the Informal Differentiated Services Model section 5.1" ::= { diffServTBParam 2 } diffServTBParamEntry OBJECT-TYPE SYNTAX DiffServTBParamEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An entry that describes a single set of token bucket parameters." INDEX { diffServTBParamId } ::= { diffServTBParamTable 1 } DiffServTBParamEntry ::= SEQUENCE { diffServTBParamId INTEGER, diffServTBParamType OBJECT IDENTIFIER, diffServTBParamRate Unsigned32, diffServTBParamBurstSize BurstSize, diffServTBParamInterval Unsigned32, diffServTBParamStatus RowStatus } diffServTBParamId OBJECT-TYPE SYNTAX IndexInteger MAX-ACCESS not-accessible STATUS current DESCRIPTION "An index that enumerates the Token Bucket Parameter entries. The set of such identifiers spans the whole agent. Managers obtain new values for row creation in this table by reading diffServTBParamNextFree." ::= { diffServTBParamEntry 1 } diffServTBParamType OBJECT-TYPE SYNTAX OBJECT IDENTIFIER MAX-ACCESS read-create STATUS current DESCRIPTION "The Metering algorithm associated with the Token Bucket parameters. zeroDotZero indicates this is unknown. Standard values for generic algorithms: diffServTBParamSimpleTokenBucket, diffServTBParamAvgRate, diffServTBParamSrTCMBlind, diffServTBParamSrTCMAware, diffServTBParamTrTCMBlind, diffServTBParamTrTCMAware, and diffServTBParamTswTCM are specified in this MIB as OBJECT- IDENTITYs; additional values may be further specified in other MIBs." REFERENCE "the Informal Differentiated Services Model section 5" ::= { diffServTBParamEntry 2 } diffServTBParamRate OBJECT-TYPE SYNTAX Unsigned32 UNITS "kilobits per second" MAX-ACCESS read-create STATUS current DESCRIPTION "The token-bucket rate, in kilobits per second (kbps). This attribute is used for: 1. CIR in RFC 2697 for srTCM 2. CIR and PIR in RFC 2698 for trTCM 3. CTR and PTR in RFC 2859 for TSWTCM 4. AverageRate used in the Informal Differentiated Services Model section 5." ::= { diffServTBParamEntry 3 } diffServTBParamBurstSize OBJECT-TYPE SYNTAX BurstSize UNITS "Bytes" MAX-ACCESS read-create STATUS current DESCRIPTION "The maximum number of bytes in a single transmission burst. This attribute is used for: 1. CBS and EBS in RFC 2697 for srTCM 2. CBS and PBS in RFC 2698 for trTCM 3. Burst Size used in the Informal Differentiated Services Model section 5." ::= { diffServTBParamEntry 4 } diffServTBParamInterval OBJECT-TYPE SYNTAX Unsigned32 UNITS "microseconds" MAX-ACCESS read-create STATUS current DESCRIPTION "The time interval used with the token bucket. For: 1. Average Rate Meter, the Informal Differentiated Services Model section 5.2.1, - Delta. 2. Simple Token Bucket Meter, the Informal Differentiated Services Model section 5.1, - time interval t. 3. RFC 2859 TSWTCM, - AVG_INTERVAL. 4. RFC 2697 srTCM, RFC 2698 trTCM, - token bucket update time interval." ::= { diffServTBParamEntry 5 } diffServTBParamStatus OBJECT-TYPE SYNTAX RowStatus MAX-ACCESS read-create STATUS current DESCRIPTION "The RowStatus variable controls the activation, deactivation, or deletion of a meter. Any writable variable may be modified whether the row is active or notInService." ::= { diffServTBParamEntry 6 } diffServTBParamSimpleTokenBucket OBJECT-IDENTITY STATUS current DESCRIPTION "Two Parameter Token Bucket Meter as described in the Informal Differentiated Services Model section 5.2.3." REFERENCE "the Informal Differentiated Services Model sections 5 and 7.1.2" ::= { diffServTBParam 3 } diffServTBParamAvgRate OBJECT-IDENTITY STATUS current DESCRIPTION "Average Rate Meter as described in the Informal Differentiated Services Model section 5.2.1." REFERENCE "the Informal Differentiated Services Model sections 5 and 7.1.2" ::= { diffServTBParam 4 } diffServTBParamSrTCMBlind OBJECT-IDENTITY STATUS current DESCRIPTION "Single Rate Three Color Marker Metering as defined by RFC 2697, in the `Color Blind' mode as described by the RFC." REFERENCE "RFC 2697" ::= { diffServTBParam 5 } diffServTBParamSrTCMAware OBJECT-IDENTITY STATUS current DESCRIPTION "Single Rate Three Color Marker Metering as defined by RFC 2697, in the `Color Aware' mode as described by the RFC." REFERENCE "RFC 2697" ::= { diffServTBParam 6 } diffServTBParamTrTCMBlind OBJECT-IDENTITY STATUS current DESCRIPTION "Two Rate Three Color Marker Metering as defined by RFC 2698, in the `Color Blind' mode as described by the RFC." REFERENCE "RFC 2698" ::= { diffServTBParam 7 } diffServTBParamTrTCMAware OBJECT-IDENTITY STATUS current DESCRIPTION "Two Rate Three Color Marker Metering as defined by RFC 2698, in the `Color Aware' mode as described by the RFC." REFERENCE "RFC 2698" ::= { diffServTBParam 8 } diffServTBParamTswTCM OBJECT-IDENTITY STATUS current DESCRIPTION "Time Sliding Window Three Color Marker Metering as defined by RFC 2859." REFERENCE "RFC 2859" ::= { diffServTBParam 9 } -- -- Actions -- diffServAction OBJECT IDENTIFIER ::= { diffServMIBObjects 5 } -- -- The Action Table allows enumeration of the different -- types of actions to be applied to a traffic flow. -- diffServActionNextFree OBJECT-TYPE SYNTAX IndexInteger MAX-ACCESS read-only STATUS current DESCRIPTION "This object yields a value when read that is currently unused for a diffServActionId instance. If a configuring system attempts to create a new row in the diffServActionTable using this value, but an instance has been created or is in the process of being created, that operation will fail." ::= { diffServAction 1 } diffServActionTable OBJECT-TYPE SYNTAX SEQUENCE OF DiffServActionEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "The Action Table enumerates actions that can be performed to a stream of traffic. Multiple actions can be concatenated. For example, traffic exiting from a meter may be counted, marked, and potentially dropped before entering a queue. Specific actions are indicated by diffServActionSpecific which points to an entry of a specific action type parameterizing the action in detail." REFERENCE "the Informal Differentiated Services Model section 6." ::= { diffServAction 2 } diffServActionEntry OBJECT-TYPE SYNTAX DiffServActionEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "Each entry in the action table allows description of one specific action to be applied to traffic." INDEX { diffServActionId } ::= { diffServActionTable 1 } DiffServActionEntry ::= SEQUENCE { diffServActionId INTEGER, diffServActionNext RowPointer, diffServActionSpecific RowPointer, diffServActionStatus RowStatus } diffServActionId OBJECT-TYPE SYNTAX IndexInteger MAX-ACCESS not-accessible STATUS current DESCRIPTION "An index that enumerates the Action entries. The set of such identifiers spans the whole agent. Managers obtain new values for row creation in this table by reading diffServActionNextFree." ::= { diffServActionEntry 1 } diffServActionNext OBJECT-TYPE SYNTAX RowPointer MAX-ACCESS read-create STATUS current DESCRIPTION "This selects the next Differentiated Services Functional Data Path Element to handle traffic for this data path. This RowPointer should point to an instance of one of: diffServClfrEntry diffServMeterEntry diffServActionEntry diffServAlgDropEntry diffServQEntry A value of zeroDotZero in this attribute indicates no further Differentiated Services treatment is performed on traffic of this data path. The use of zeroDotZero is the normal usage for the last functional data path element of the current data path. If the row pointed to does not exist, the treatment is as if this attribute contains a value of zeroDotZero." DEFVAL { zeroDotZero } ::= { diffServActionEntry 2 } diffServActionSpecific OBJECT-TYPE SYNTAX RowPointer MAX-ACCESS read-create STATUS current DESCRIPTION "A pointer to an object instance providing additional information for the type of action indicated by this action table entry. For the standard actions defined by this MIB module, this should point to one of the following: a diffServDscpMarkActEntry, a diffServCountActEntry. For other actions, it may point to an object instance defined in some other MIB." ::= { diffServActionEntry 3 } diffServActionStatus OBJECT-TYPE SYNTAX RowStatus MAX-ACCESS read-create STATUS current DESCRIPTION "The RowStatus variable controls the activation, deactivation or deletion of an action element. Any writable variable may be modified whether the row is active or notInService." ::= { diffServActionEntry 4 } -- DSCP Mark Action Table -- -- Rows of this table are pointed to by diffServActionSpecific to -- provide detailed parameters specific to the DSCP Mark action. -- -- A single entry in this table can be shared by multiple -- diffServActionTable entries. -- diffServDscpMarkActTable OBJECT-TYPE SYNTAX SEQUENCE OF DiffServDscpMarkActEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "This table enumerates specific DSCPs used for marking or remarking the DSCP field of IP packets. The entries of this table may be referenced by a diffServActionSpecific attribute." REFERENCE "the Informal Differentiated Services Model section 6.1" ::= { diffServAction 3 } diffServDscpMarkActEntry OBJECT-TYPE SYNTAX DiffServDscpMarkActEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An entry in the DSCP mark action table that describes a single DSCP used for marking." INDEX { diffServDscpMarkActDscp } ::= { diffServDscpMarkActTable 1 } DiffServDscpMarkActEntry ::= SEQUENCE { diffServDscpMarkActDscp Dscp } diffServDscpMarkActDscp OBJECT-TYPE SYNTAX Dscp MAX-ACCESS read-only STATUS current DESCRIPTION "The DSCP that this Action will store into the DSCP field of the subject. It is quite possible that the only packets subject to this Action are already marked with this DSCP. Note also that Differentiated Services processing may result in packet being marked on both ingress to a network and on egress from it, and that ingress and egress can occur in the same router. Normally, index variables are not-accessible. However, in this case the OID of the entry serves as a OBJECT-IDENTITY indicating that traffic should be marked in a certain way, and specifying a second object seems redundant." ::= { diffServDscpMarkActEntry 1 } -- -- Count Action Table -- -- Because the MIB structure allows multiple cascading -- diffServActionEntry be used to describe multiple actions for a -- data path, the counter became an optional action type. In normal -- implementation, either a data path has counters or it does not, -- as opposed to being configurable. The management entity may choose -- to read the counter or not. Hence it is recommended for implementation -- that have counters to always configure the count action as the first -- of multiple actions. -- diffServCountActNextFree OBJECT-TYPE SYNTAX IndexInteger MAX-ACCESS read-only STATUS current DESCRIPTION "This object yields a value when read that is currently unused for a diffServCountActId instance. If a configuring system attempts to create a new row in the diffServCountActTable using this value, but an instance has been created or is in the process of being created, that operation will fail." ::= { diffServAction 4 } diffServCountActTable OBJECT-TYPE SYNTAX SEQUENCE OF DiffServCountActEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "This table contains counters for all the traffic passing through an action element." REFERENCE "the Informal Differentiated Services Model section 6.4" ::= { diffServAction 5 } diffServCountActEntry OBJECT-TYPE SYNTAX DiffServCountActEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An entry in the count action table describes a single set of traffic counters." INDEX { diffServCountActId } ::= { diffServCountActTable 1 } DiffServCountActEntry ::= SEQUENCE { diffServCountActId INTEGER, diffServCountActOctets Counter32, diffServCountActHCOctets Counter64, diffServCountActPkts Counter32, diffServCountActHCPkts Counter64, diffServCountActDiscontTime TimeStamp, diffServCountActStatus RowStatus } diffServCountActId OBJECT-TYPE SYNTAX IndexInteger MAX-ACCESS not-accessible STATUS current DESCRIPTION "An index that enumerates the Count Action entries. The set of such identifiers spans the whole agent. Managers obtain new values for row creation in this table by reading diffServCountActNextFree." ::= { diffServCountActEntry 1 } diffServCountActOctets OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of octets at the Action data path element. On high- speed devices, this object implements the least significant 32 bits of diffServCountActHCOctets. Discontinuities in the value of this counter can occur at re- initialization of the management system and at other times as indicated by the value of diffServCountActDiscontTime for this entry." ::= { diffServCountActEntry 2 } diffServCountActHCOctets OBJECT-TYPE SYNTAX Counter64 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of octets at the Action data path element. This object should be used on high-speed interfaces. Discontinuities in the value of this counter can occur at re- initialization of the management system and at other times as indicated by the value of diffServCountActDiscontTime for this entry." ::= { diffServCountActEntry 3 } diffServCountActPkts OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of packets at the Action data path element. On high- speed devices, this object implements the least significant 32 bits of diffServCountActHCPkts. Discontinuities in the value of this counter can occur at re- initialization of the management system and at other times as indicated by the value of diffServCountActDiscontTime for this entry." ::= { diffServCountActEntry 4 } diffServCountActHCPkts OBJECT-TYPE SYNTAX Counter64 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of packets at the Action data path element. This object should be used on high-speed interfaces. Discontinuities in the value of this counter can occur at re- initialization of the management system and at other times as indicated by the value of diffServCountActDiscontTime for this entry." ::= { diffServCountActEntry 5 } diffServCountActDiscontTime OBJECT-TYPE SYNTAX TimeStamp MAX-ACCESS read-only STATUS current DESCRIPTION "The value of sysUpTime on the most recent occasion at which any one or more of this entry's counters suffered a discontinuity. If no such discontinuities have occurred since the last re- initialization of the local management subsystem, then this object contains a zero value." ::= { diffServCountActEntry 6 } diffServCountActStatus OBJECT-TYPE SYNTAX RowStatus MAX-ACCESS read-create STATUS current DESCRIPTION "The RowStatus variable controls the activation, deactivation, or deletion of this entry. Any writable variable may be modified whether the row is active or notInService." ::= { diffServCountActEntry 7 } -- -- Algorithmic Drop Table -- diffServAlgDrop OBJECT IDENTIFIER ::= { diffServMIBObjects 6 } diffServAlgDropNextFree OBJECT-TYPE SYNTAX IndexInteger MAX-ACCESS read-only STATUS current DESCRIPTION "This object yields a value when read that is currently unused for a diffServAlgDropId instance. If a configuring system attempts to create a new row in the diffServAlgDropTable using this value, but an instance has been created or is in the process of being created, that operation will fail." ::= { diffServAlgDrop 1 } diffServAlgDropTable OBJECT-TYPE SYNTAX SEQUENCE OF DiffServAlgDropEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "The algorithmic drop table contains entries describing an element that drops packets according to some algorithm." REFERENCE "the Informal Differentiated Services Model section 7.1.3" ::= { diffServAlgDrop 2 } diffServAlgDropEntry OBJECT-TYPE SYNTAX DiffServAlgDropEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An entry describes a process that drops packets according to some algorithm. Further details of the algorithm type are to be found in diffServAlgDropType and with more detail parameter entry pointed to by diffServAlgDropSpecific when necessary." INDEX { diffServAlgDropId } ::= { diffServAlgDropTable 1 } DiffServAlgDropEntry ::= SEQUENCE { diffServAlgDropId INTEGER, diffServAlgDropType INTEGER, diffServAlgDropNext RowPointer, diffServAlgDropQMeasure RowPointer, diffServAlgDropQThreshold Unsigned32, diffServAlgDropSpecific RowPointer, diffServAlgDropOctets Counter32, diffServAlgDropHCOctets Counter64, diffServAlgDropPkts Counter32, diffServAlgDropHCPkts Counter64, diffServAlgRandomDropOctets Counter32, diffServAlgRandomDropHCOctets Counter64, diffServAlgRandomDropPkts Counter32, diffServAlgRandomDropHCPkts Counter64, diffServAlgDropDiscontinuityTime TimeStamp, diffServAlgDropStatus RowStatus } diffServAlgDropId OBJECT-TYPE SYNTAX IndexInteger MAX-ACCESS not-accessible STATUS current DESCRIPTION "An index that enumerates the Algorithmic Dropper entries. The set of such identifiers spans the whole agent. Managers obtain new values for row creation in this table by reading diffServAlgDropNextFree." ::= { diffServAlgDropEntry 1 } diffServAlgDropType OBJECT-TYPE SYNTAX INTEGER { other(1), tailDrop(2), headDrop(3), randomDrop(4), alwaysDrop(5) } MAX-ACCESS read-create STATUS current DESCRIPTION "The type of algorithm used by this dropper. The value other(1) requires further specification in some other MIB module. In the tailDrop(2) algorithm, diffServAlgDropQThreshold represents the maximum depth of the queue, pointed to by diffServAlgDropQMeasure, beyond which all newly arriving packets will be dropped. In the headDrop(3) algorithm, if a packet arrives when the current depth of the queue, pointed to by diffServAlgDropQMeasure, is at diffServAlgDropQThreshold, packets currently at the head of the queue are dropped to make room for the new packet to be enqueued at the tail of the queue. In the randomDrop(4) algorithm, on packet arrival, an Active Queue Management algorithm is executed which may randomly drop a packet. This algorithm may be proprietary, and it may drop either the arriving packet or another packet in the queue. diffServAlgDropSpecific points to a diffServRandomDropEntry that describes the algorithm. For this algorithm, diffServAlgDropQThreshold is understood to be the absolute maximum size of the queue and additional parameters are described in diffServRandomDropTable. The alwaysDrop(5) algorithm is as its name specifies; always drop. In this case, the other configuration values in this Entry are not meaningful; There is no useful 'next' processing step, there is no queue, and parameters describing the queue are not useful. Therefore, diffServAlgDropQNext, diffServAlgDropQMeasure, and diffServAlgDropQSpecific are all zeroDotZero." ::= { diffServAlgDropEntry 2 } diffServAlgDropNext OBJECT-TYPE SYNTAX RowPointer MAX-ACCESS read-create STATUS current DESCRIPTION "This selects the next Differentiated Services Functional Data Path Element to handle traffic for this data path. This RowPointer should point to an instance of one of: diffServClfrEntry diffServMeterEntry diffServActionEntry diffServQEntry A value of zeroDotZero in this attribute indicates no further Differentiated Services treatment is performed on traffic of this data path. The use of zeroDotZero is the normal usage for the last functional data path element of the current data path. If the row pointed to does not exist, the treatment is as if this attribute contains a value of zeroDotZero." ::= { diffServAlgDropEntry 3 } diffServAlgDropQMeasure OBJECT-TYPE SYNTAX RowPointer MAX-ACCESS read-create STATUS current DESCRIPTION "Points to an entry in the diffServQTable to indicate the queue that a drop algorithm is to monitor when deciding whether to drop a packet. If the row pointed to does not exist, the algorithmic dropper element is considered inactive." ::= { diffServAlgDropEntry 4 } diffServAlgDropQThreshold OBJECT-TYPE SYNTAX Unsigned32 UNITS "Bytes" MAX-ACCESS read-create STATUS current DESCRIPTION "A threshold on the depth in bytes of the queue being measured at which a trigger is generated to the dropping algorithm. For the tailDrop(2) or headDrop(3) algorithms, this represents the depth of the queue, pointed to by diffServAlgDropQMeasure, at which the drop action will take place. Other algorithms will need to define their own semantics for this threshold." ::= { diffServAlgDropEntry 5 } diffServAlgDropSpecific OBJECT-TYPE SYNTAX RowPointer MAX-ACCESS read-create STATUS current DESCRIPTION "Points to a table entry that provides further detail regarding a drop algorithm. Entries with diffServAlgDropType equal to other(1) may have this point to a table defined in another MIB module. Entries with diffServAlgDropType equal to randomDrop(4) must have this point to an entry in diffServRandomDropTable. For all other algorithms specified in this MIB, this should take the value zeroDotzero. The diffServAlgDropType is authoritative for the type of the drop algorithm and the specific parameters for the drop algorithm needs to be evaluated based on the diffServAlgDropType." ::= { diffServAlgDropEntry 6 } diffServAlgDropOctets OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of octets that have been deterministically dropped by this drop process. On high-speed devices, this object implements the least significant 32 bits of diffServAlgDropHCOctets. Discontinuities in the value of this counter can occur at re- initialization of the management system and at other times as indicated by the value of diffServAlgDropDiscontinuityTime for this Entry." ::= { diffServAlgDropEntry 7 } diffServAlgDropHCOctets OBJECT-TYPE SYNTAX Counter64 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of octets that have been deterministically dropped by this drop process. This object should be used on high-speed interfaces. Discontinuities in the value of this counter can occur at re- initialization of the management system and at other times as indicated by the value of diffServAlgDropDiscontinuityTime for this Entry." ::= { diffServAlgDropEntry 8 } diffServAlgDropPkts OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of packets that have been deterministically dropped by this drop process. On high-speed devices, this object implements the least significant 32 bits of diffServAlgDropHCPkts. Discontinuities in the value of this counter can occur at re- initialization of the management system and at other times as indicated by the value of diffServAlgDropDiscontinuityTime for this Entry." ::= { diffServAlgDropEntry 9 } diffServAlgDropHCPkts OBJECT-TYPE SYNTAX Counter64 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of packets that have been deterministically dropped by this drop process. This object should be used on high-speed interfaces. Discontinuities in the value of this counter can occur at re- initialization of the management system and at other times as indicated by the value of diffServAlgDropDiscontinuityTime for this Entry." ::= { diffServAlgDropEntry 10 } diffServAlgRandomDropOctets OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of octets that have been randomly dropped by this drop process. This counter applies, therefore, only to random droppers. On high-speed devices, this object implements the least significant 32 bits of diffServAlgRandomDropHCOctets. Discontinuities in the value of this counter can occur at re- initialization of the management system and at other times as indicated by the value of diffServAlgDropDiscontinuityTime for this Entry." ::= { diffServAlgDropEntry 11 } diffServAlgRandomDropHCOctets OBJECT-TYPE SYNTAX Counter64 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of octets that have been randomly dropped by this drop process. This counter applies, therefore, only to random droppers. This object should be used on high-speed interfaces. Discontinuities in the value of this counter can occur at re- initialization of the management system and at other times as indicated by the value of diffServAlgDropDiscontinuityTime for this Entry." ::= { diffServAlgDropEntry 12 } diffServAlgRandomDropPkts OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of packets that have been randomly dropped by this drop process. This counter applies, therefore, only to random droppers. On high-speed devices, this object implements the least significant 32 bits of diffServAlgRandomDropHCPkts. Discontinuities in the value of this counter can occur at re- initialization of the management system and at other times as indicated by the value of diffServAlgDropDiscontinuityTime for this Entry." ::= { diffServAlgDropEntry 13 } diffServAlgRandomDropHCPkts OBJECT-TYPE SYNTAX Counter64 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of packets that have been randomly dropped by this drop process. This counter applies, therefore, only to random droppers. This object should be used on high-speed interfaces. Discontinuities in the value of this counter can occur at re- initialization of the management system and at other times as indicated by the value of diffServAlgDropDiscontinuityTime for this Entry." ::= { diffServAlgDropEntry 14 } diffServAlgDropDiscontinuityTime OBJECT-TYPE SYNTAX TimeStamp MAX-ACCESS read-only STATUS current DESCRIPTION "The value of sysUpTime on the most recent occasion at which any one or more of this entry's counters suffered a discontinuity. If no such discontinuities have occurred since the last re- initialization of the local management subsystem, then this object contains a zero value." ::= { diffServAlgDropEntry 15 } diffServAlgDropStatus OBJECT-TYPE SYNTAX RowStatus MAX-ACCESS read-create STATUS current DESCRIPTION "The RowStatus variable controls the activation, deactivation, or deletion of this entry. Any writable variable may be modified whether the row is active or notInService." ::= { diffServAlgDropEntry 16 } -- -- Random Drop Table -- diffServRandomDropNextFree OBJECT-TYPE SYNTAX IndexInteger MAX-ACCESS read-only STATUS current DESCRIPTION "This object yields a value when read that is currently unused for a diffServRandomDropId instance. If a configuring system attempts to create a new row in the diffServRandomDropTable using this value, but an instance has been created or is in the process of being created, that operation will fail." ::= { diffServAlgDrop 3 } diffServRandomDropTable OBJECT-TYPE SYNTAX SEQUENCE OF DiffServRandomDropEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "The random drop table contains entries describing a process that drops packets randomly. Entries in this table are pointed to by diffServAlgDropSpecific." REFERENCE "the Informal Differentiated Services Model section 7.1.3" ::= { diffServAlgDrop 4 } diffServRandomDropEntry OBJECT-TYPE SYNTAX DiffServRandomDropEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An entry describes a process that drops packets according to a random algorithm." INDEX { diffServRandomDropId } ::= { diffServRandomDropTable 1 } DiffServRandomDropEntry ::= SEQUENCE { diffServRandomDropId INTEGER, diffServRandomDropMinThreshBytes Unsigned32, diffServRandomDropMinThreshPkts Unsigned32, diffServRandomDropMaxThreshBytes Unsigned32, diffServRandomDropMaxThreshPkts Unsigned32, diffServRandomDropProbMax INTEGER, diffServRandomDropWeight INTEGER, diffServRandomDropSamplingRate INTEGER, diffServRandomDropStatus RowStatus } diffServRandomDropId OBJECT-TYPE SYNTAX IndexInteger MAX-ACCESS not-accessible STATUS current DESCRIPTION "An index that enumerates the Random Drop entries. The set of such identifiers spans the whole agent. Managers obtain new values for row creation in this table by reading diffServRandomDropNextFree." ::= { diffServRandomDropEntry 1 } diffServRandomDropMinThreshBytes OBJECT-TYPE SYNTAX Unsigned32 UNITS "bytes" MAX-ACCESS read-create STATUS current DESCRIPTION "The average queue depth in bytes, beyond which traffic has a non-zero probability of being dropped. Changes in this variable may or may not be reflected in the reported value of diffServRandomDropMinThreshPkts." ::= { diffServRandomDropEntry 2 } diffServRandomDropMinThreshPkts OBJECT-TYPE SYNTAX Unsigned32 UNITS "packets" MAX-ACCESS read-create STATUS current DESCRIPTION "The average queue depth in packets, beyond which traffic has a non-zero probability of being dropped. Changes in this variable may or may not be reflected in the reported value of diffServRandomDropMinThreshBytes." ::= { diffServRandomDropEntry 3 } diffServRandomDropMaxThreshBytes OBJECT-TYPE SYNTAX Unsigned32 UNITS "bytes" MAX-ACCESS read-create STATUS current DESCRIPTION "The average queue depth beyond which traffic has a probability indicated by diffServRandomDropProbMax of being dropped or marked. Note that this differs from the physical queue limit, which is stored in diffServAlgDropQThreshold. Changes in this variable may or may not be reflected in the reported value of diffServRandomDropMaxThreshPkts." ::= { diffServRandomDropEntry 4 } diffServRandomDropMaxThreshPkts OBJECT-TYPE SYNTAX Unsigned32 UNITS "packets" MAX-ACCESS read-create STATUS current DESCRIPTION "The average queue depth beyond which traffic has a probability indicated by diffServRandomDropProbMax of being dropped or marked. Note that this differs from the physical queue limit, which is stored in diffServAlgDropQThreshold. Changes in this variable may or may not be reflected in the reported value of diffServRandomDropMaxThreshBytes." ::= { diffServRandomDropEntry 5 } diffServRandomDropProbMax OBJECT-TYPE SYNTAX INTEGER (0..1000) MAX-ACCESS read-create STATUS current DESCRIPTION "The worst case random drop probability, expressed in drops per thousand packets. For example, if in the worst case every arriving packet may be dropped (100%) for a period, this has the value 1000. Alternatively, if in the worst case only one percent (1%) of traffic may be dropped, it has the value 10." ::= { diffServRandomDropEntry 6 } diffServRandomDropWeight OBJECT-TYPE SYNTAX INTEGER (0..65536) MAX-ACCESS read-create STATUS current DESCRIPTION "The weighting of past history in affecting the Exponentially Weighted Moving Average function that calculates the current average queue depth. The equation uses diffServRandomDropWeight/65536 as the coefficient for the new sample in the equation, and (65536 - diffServRandomDropWeight)/65536 as the coefficient of the old value. Implementations may limit the values of diffServRandomDropWeight to a subset of the possible range of values, such as powers of two. Doing this would facilitate implementation of the Exponentially Weighted Moving Average using shift instructions or registers." ::= { diffServRandomDropEntry 7 } diffServRandomDropSamplingRate OBJECT-TYPE SYNTAX INTEGER (0..1000000) MAX-ACCESS read-create STATUS current DESCRIPTION "The number of times per second the queue is sampled for queue average calculation. A value of zero is used to mean that the queue is sampled approximately each time a packet is enqueued (or dequeued)." ::= { diffServRandomDropEntry 8 } diffServRandomDropStatus OBJECT-TYPE SYNTAX RowStatus MAX-ACCESS read-create STATUS current DESCRIPTION "The RowStatus variable controls the activation, deactivation, or deletion of this entry. Any writable variable may be modified whether the row is active or notInService." ::= { diffServRandomDropEntry 9 } -- -- Queue Table -- diffServQueue OBJECT IDENTIFIER ::= { diffServMIBObjects 7 } -- -- An entry of diffServQTable represents a FIFO queue Differentiated -- Services Functional Data Path element as described in the Informal Differentiated Services Model section -- 7.1.1. Note that the specification of scheduling parameters for a -- queue as part of the input to a scheduler functional data path element -- as described in the Informal Differentiated Services Model section 7.1.2. This allows building of -- hierarchical queuing/scheduling. A queue therefore has these attributes: -- 1. Which scheduler will service this queue, diffServQNext. -- 2. How the scheduler will service this queue, with respect -- to all the other queues the same scheduler needs to service, -- diffServQRate. -- -- Note that upstream Differentiated Services Functional Data Path -- elements may point to a shared diffServQTable entry as described -- in the Informal Differentiated Services Model section 7.1.1. -- diffServQNextFree OBJECT-TYPE SYNTAX IndexInteger MAX-ACCESS read-only STATUS current DESCRIPTION "This object yields a value when read that is currently unused for a diffServQId instance. If a configuring system attempts to create a new row in the diffServQTable using this value, but an instance has been created or is in the process of being created, that operation will fail." ::= { diffServQueue 1 } diffServQTable OBJECT-TYPE SYNTAX SEQUENCE OF DiffServQEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "The Queue Table enumerates the individual queues." REFERENCE "the Informal Differentiated Services Model section 7.1.1" ::= { diffServQueue 2 } diffServQEntry OBJECT-TYPE SYNTAX DiffServQEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An entry in the Queue Table describes a single queue. With each entry belonging to one and only one data path." INDEX { diffServQId } ::= { diffServQTable 1 } DiffServQEntry ::= SEQUENCE { diffServQId INTEGER, diffServQNext RowPointer, diffServQRate RowPointer, diffServQShaper RowPointer, diffServQStatus RowStatus } diffServQId OBJECT-TYPE SYNTAX IndexInteger MAX-ACCESS not-accessible STATUS current DESCRIPTION "An index that enumerates the Queue entries. The set of such identifiers spans the whole agent. Managers obtain new values for row creation in this table by reading diffServQNextFree." ::= { diffServQEntry 1 } diffServQNext OBJECT-TYPE SYNTAX RowPointer MAX-ACCESS read-create STATUS current DESCRIPTION "This selects the next Differentiated Services Functional Data Path Element to handle traffic for this data path. This RowPointer must point to a diffServSchedulerEntry. A value of zeroDotZero in this attribute indicates an incomplete diffServQEntry instance. In such a case, the entry has no operational effect, since it has no parameters to give it meaning. If the row pointed to does not exist, the treatment is as if this attribute contains a value of zeroDotZero." ::= { diffServQEntry 2 } diffServQRate OBJECT-TYPE SYNTAX RowPointer MAX-ACCESS read-create STATUS current DESCRIPTION "This RowPointer indicates the diffServAssuredRateEntry that the scheduler, pointed to by diffServQNext, should use to service this queue. If the row pointed to is zeroDotZero or does not exist, the minimum rate is unspecified." ::= { diffServQEntry 3 } diffServQShaper OBJECT-TYPE SYNTAX RowPointer MAX-ACCESS read-create STATUS current DESCRIPTION "This RowPointer indicates the diffServShapingRateEntry that the scheduler, pointed to by diffServQNext, should use to service this queue. If the row pointed to does not exist or is zeroDotZero, the maximum rate is the line speed of the interface." ::= { diffServQEntry 4 } diffServQStatus OBJECT-TYPE SYNTAX RowStatus MAX-ACCESS read-create STATUS current DESCRIPTION "The RowStatus variable controls the activation, deactivation, or deletion of a queue. Any writable variable may be modified whether the row is active or notInService." ::= { diffServQEntry 5 } -- -- Scheduler Table -- diffServScheduler OBJECT IDENTIFIER ::= { diffServMIBObjects 8 } -- -- A Scheduler Entry represents a packet scheduler, such as a priority -- scheduler or a WFQ scheduler. It provides flexibility for multiple -- scheduling algorithms, each servicing multiple queues, to be used on -- the same logical/physical interface. -- -- Note that upstream queues or schedulers specify several of the -- scheduler's parameters. These must be properly specified if the -- scheduler is to behave as expected. -- -- The diffServSchedulerShaper attribute specifies the parameters -- when a scheduler's output is sent to another scheduler. This is -- used in building hierarchical queues or schedulers. -- -- More discussion of the scheduler functional data path element is -- in the Informal Differentiated Services Model section 7.1.2. -- diffServSchedulerNextFree OBJECT-TYPE SYNTAX IndexInteger MAX-ACCESS read-only STATUS current DESCRIPTION "This object yields a value when read that is currently unused for a diffServSchedulerId instance. If a configuring system attempts to create a new row in the diffServSchedulerTable using this value, but an instance has been created or is in the process of being created, that operation will fail." ::= { diffServScheduler 1 } diffServSchedulerTable OBJECT-TYPE SYNTAX SEQUENCE OF DiffServSchedulerEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "The Scheduler Table enumerates packet schedulers. Multiple scheduling algorithms can be used on a given data path, with each algorithm described by one diffServSchedulerEntry." REFERENCE "the Informal Differentiated Services Model section 7.1.2" ::= { diffServScheduler 2 } diffServSchedulerEntry OBJECT-TYPE SYNTAX DiffServSchedulerEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An entry in the Scheduler Table describing a single instance of a scheduling algorithm." INDEX { diffServSchedulerId } ::= { diffServSchedulerTable 1 } DiffServSchedulerEntry ::= SEQUENCE { diffServSchedulerId INTEGER, diffServSchedulerNext RowPointer, diffServSchedulerMethod OBJECT IDENTIFIER, diffServSchedulerRate RowPointer, diffServSchedulerShaper RowPointer, diffServSchedulerStatus RowStatus } diffServSchedulerId OBJECT-TYPE SYNTAX IndexInteger MAX-ACCESS not-accessible STATUS current DESCRIPTION "An index that enumerates the Scheduler entries. The set of such identifiers spans the whole agent. Managers obtain new values for row creation in this table by reading diffServSchedulerNextFree." ::= { diffServSchedulerEntry 1 } diffServSchedulerNext OBJECT-TYPE SYNTAX RowPointer MAX-ACCESS read-create STATUS current DESCRIPTION "This selects the next Differentiated Services Functional Data Path Element to handle traffic for this data path. This RowPointer should point to an instance of one of: diffServSchedulerEntry diffServQEntry as indicated by the Informal Differentiated Services Model section 7.1.4. However, this RowPointer may also point to an instance of:. diffServClfrEntry diffServMeterEntry diffServActionEntry diffServAlgDropEntry to extend the same data path. This should point to another diffServSchedulerEntry for implementation of multiple scheduler methods for the same data path, and for implementation of hierarchical schedulers. If the row pointed to does not exist or is zeroDotZero, no further Differentiated Services treatment is performed on traffic of this data path." DEFVAL { zeroDotZero } ::= { diffServSchedulerEntry 2 } diffServSchedulerMethod OBJECT-TYPE SYNTAX OBJECT IDENTIFIER MAX-ACCESS read-create STATUS current DESCRIPTION "The scheduling algorithm used by this Scheduler. zeroDotZero indicates that this is unknown. Standard values for generic algorithms: diffServSchedulerPriority, diffServSchedulerWRR, and diffServSchedulerWFQ are specified in this MIB; additional values may be further specified in other MIBs." REFERENCE "the Informal Differentiated Services Model section 7.1.2" ::= { diffServSchedulerEntry 3 } diffServSchedulerRate OBJECT-TYPE SYNTAX RowPointer MAX-ACCESS read-create STATUS current DESCRIPTION "This RowPointer indicates the entry in diffServAssuredRateTable which indicates the priority or minimum output rate from this scheduler. This attribute is used only when there is more than one level of scheduler. It should have the value of zeroDotZero when not used." DEFVAL { zeroDotZero } ::= { diffServSchedulerEntry 4 } diffServSchedulerShaper OBJECT-TYPE SYNTAX RowPointer MAX-ACCESS read-create STATUS current DESCRIPTION "This RowPointer indicates the entry in diffServShapingRateTable which indicates the maximum output rate from this scheduler. This attribute is used only when there is more than one level of scheduler. It should have the value of zeroDotZero when not used." DEFVAL { zeroDotZero } ::= { diffServSchedulerEntry 5 } diffServSchedulerStatus OBJECT-TYPE SYNTAX RowStatus MAX-ACCESS read-create STATUS current DESCRIPTION "The RowStatus variable controls the activation, deactivation, or deletion of a scheduler. Any writable variable may be modified whether the row is active or notInService." ::= { diffServSchedulerEntry 6 } diffServSchedulerPriority OBJECT-IDENTITY STATUS current DESCRIPTION " For use with diffServSchedulerMethod to indicate the Priority scheduling method. This is defined as an algorithm in which the presence of data in a queue or set of queues absolutely precludes dequeue from another queue or set of queues of lower priority. Note that attributes from diffServAssuredRateEntry of the queues/schedulers feeding this scheduler are used when determining the next packet to schedule." REFERENCE "the Informal Differentiated Services Model section 7.1.2" ::= { diffServScheduler 3 } diffServSchedulerWRR OBJECT-IDENTITY STATUS current DESCRIPTION "For use with diffServSchedulerMethod to indicate the Weighted Round Robin scheduling method, defined as any algorithm in which a set of queues are visited in a fixed order, and varying amounts of traffic are removed from each queue in turn to implement an average output rate by class. Notice attributes from diffServAssuredRateEntry of the queues/schedulers feeding this scheduler are used when determining the next packet to schedule." REFERENCE "the Informal Differentiated Services Model section 7.1.2" ::= { diffServScheduler 4 } diffServSchedulerWFQ OBJECT-IDENTITY STATUS current DESCRIPTION "For use with diffServSchedulerMethod to indicate the Weighted Fair Queuing scheduling method, defined as any algorithm in which a set of queues are conceptually visited in some order, to implement an average output rate by class. Notice attributes from diffServAssuredRateEntry of the queues/schedulers feeding this scheduler are used when determining the next packet to schedule." REFERENCE "the Informal Differentiated Services Model section 7.1.2" ::= { diffServScheduler 5 } -- --Assured Rate Parameters Table -- -- The parameters used by a scheduler for its inputs or outputs are -- maintained separately from the Queue or Scheduler table entries -- for reusability reasons and so that they may be used by both queues -- and schedulers. This follows the approach for separation of data -- path elements from parameterization that is used throughout this MIB. -- Use of these Assured Rate Parameter Table entries by Queues and -- Schedulers allows the modeling of hierarchical scheduling systems. -- -- Specifically, a Scheduler has one or more inputs and one output. -- Any queue feeding a scheduler, or any scheduler which feeds a second -- scheduler, might specify a minimum transfer rate by pointing to an -- Assured Rate Parameter Table entry. -- -- The diffServAssuredRatePriority/Abs/Rel attributes are used as -- parameters to the work-conserving portion of a scheduler: -- "work-conserving" implies that the scheduler can continue to emit -- data as long as there is data available at its input(s). This has -- the effect of guaranteeing a certain priority relative to other -- scheduler inputs and/or a certain minimum proportion of the available -- output bandwidth. Properly configured, this means a certain minimum -- rate, which may be exceeded should traffic be available should there -- be spare bandwidth after all other classes have had opportunities to -- consume their own minimum rates. -- diffServAssuredRateNextFree OBJECT-TYPE SYNTAX IndexInteger MAX-ACCESS read-only STATUS current DESCRIPTION "This object yields a value when read that is currently unused for a diffServAssuredRateId instance. If a configuring system attempts to create a new row in the diffServAssuredRateTable using this value, but an instance has been created or is in the process of being created, that operation will fail." ::= { diffServScheduler 6 } diffServAssuredRateTable OBJECT-TYPE SYNTAX SEQUENCE OF DiffServAssuredRateEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "The Assured Rate Parameters Table enumerates individual sets of scheduling parameter that can be used/reused by Queues and Schedulers." ::= { diffServScheduler 7 } diffServAssuredRateEntry OBJECT-TYPE SYNTAX DiffServAssuredRateEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An entry in the Assured Rate Parameters Table describes a single set of scheduling parameters for use by one or more queues or schedulers." INDEX { diffServAssuredRateId } ::= { diffServAssuredRateTable 1 } DiffServAssuredRateEntry ::= SEQUENCE { diffServAssuredRateId INTEGER, diffServAssuredRatePriority Unsigned32, diffServAssuredRateAbs Unsigned32, diffServAssuredRateRel Unsigned32, diffServAssuredRateStatus RowStatus } diffServAssuredRateId OBJECT-TYPE SYNTAX IndexInteger MAX-ACCESS not-accessible STATUS current DESCRIPTION "An index that enumerates the Scheduler Parameter entries. The set of such identifiers spans the whole agent. Managers obtain new values for row creation in this table by reading diffServAssuredRateNextFree." ::= { diffServAssuredRateEntry 1 } diffServAssuredRatePriority OBJECT-TYPE SYNTAX Unsigned32 MAX-ACCESS read-create STATUS current DESCRIPTION "The priority of this input to the associated scheduler, relative to the scheduler's other inputs. A queue or scheduler with a larger numeric value will be served before another with a smaller numeric value." ::= { diffServAssuredRateEntry 2 } diffServAssuredRateAbs OBJECT-TYPE SYNTAX Unsigned32 UNITS "kilobits per second" MAX-ACCESS read-create STATUS current DESCRIPTION "The minimum absolute rate, in kilobits/sec, that a downstream scheduler element should allocate to this queue. If the value is zero, then there is effectively no minimum rate guarantee. If the value is non-zero, the scheduler will assure the servicing of this queue to at least this rate. Note that this attribute value and that of diffServAssuredRateRel are coupled: changes to one will affect the value of the other. They are linked by the following equation: diffServAssuredRateRel = (diffServAssuredRateAbs * 1000000)/ifSpeed or, if appropriate: diffServAssuredRateRel = diffServAssuredRateAbs/ifHighSpeed" REFERENCE "ifSpeed, ifHighSpeed from the Interfaces MIB" ::= { diffServAssuredRateEntry 3 } diffServAssuredRateRel OBJECT-TYPE SYNTAX Unsigned32 MAX-ACCESS read-create STATUS current DESCRIPTION "The minimum rate that a downstream scheduler element should allocate to this queue, relative to the maximum rate of the interface as reported by ifSpeed or ifHighSpeed, in units of 1/1000 of 1. If the value is zero, then there is effectively no minimum rate guarantee. If the value is non-zero, the scheduler will assure the servicing of this queue to at least this rate. Note that this attribute value and that of diffServAssuredRateAbs are coupled: changes to one will affect the value of the other. They are linked by the following equation: diffServAssuredRateRel = (diffServAssuredRateAbs * 1000000)/ifSpeed or, if appropriate: diffServAssuredRateRel = diffServAssuredRateAbs/ifHighSpeed" REFERENCE "ifSpeed, ifHighSpeed from the Interfaces MIB" ::= { diffServAssuredRateEntry 4 } diffServAssuredRateStatus OBJECT-TYPE SYNTAX RowStatus MAX-ACCESS read-create STATUS current DESCRIPTION "The RowStatus variable controls the activation, deactivation, or deletion of a queue. Any writable variable may be modified whether the row is active or notInService." ::= { diffServAssuredRateEntry 5 } -- -- Shaping Parameter Table -- -- The parameters used by a scheduler for its inputs or outputs are -- maintained separately from the Queue or Scheduler table entries -- for reusability reasons and so that they may be used by both queues -- and schedulers. This follows the approach for separation of data -- path elements from parameterization that is used throughout this MIB. -- Use of these Shaping Parameter Table entries by Queues and Schedulers -- allows the modeling of hierarchical scheduling systems. -- -- Specifically, a Scheduler has one or more inputs and one output. -- Any queue feeding a scheduler, or any scheduler which feeds a second -- scheduler, might specify a maximum transfer rate by pointing to a -- Shaping Parameter Table entry. Multi-rate shapers, such as a Dual -- Leaky Bucket algorithm, specify their rates using multiple -- Shaping Parameter Entries with the same diffServShapingRateId but -- different diffServShapingRateLevels. -- -- The diffServShapingRateLevel/Abs/Rel attributes are used as parameters -- to the non-work-conserving portion of a scheduler: non-work-conserving -- implies that the scheduler may sometimes not emit a packet, even if -- there is data available at its input(s). This has the effect of limiting -- the servicing of the queue/scheduler input or output, in effect performing -- shaping of the packet stream passing through the queue/scheduler, as -- described in the Informal Differentiated Services Model section 7.2. -- diffServShapingRateNextFree OBJECT-TYPE SYNTAX IndexInteger MAX-ACCESS read-only STATUS current DESCRIPTION "This object yields a value when read that is currently unused for a diffServShapingRateId instance. If a configuring system attempts to create a new row in the diffServShapingRateTable using this value, but an instance has been created or is in the process of being created, that operation will fail." ::= { diffServScheduler 8 } diffServShapingRateTable OBJECT-TYPE SYNTAX SEQUENCE OF DiffServShapingRateEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "The Shaping Parameter Table enumerates individual sets of scheduling parameter that can be used/reused by Queues and Schedulers." ::= { diffServScheduler 9 } diffServShapingRateEntry OBJECT-TYPE SYNTAX DiffServShapingRateEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An entry in the Shaping Parameter Table describes a single set of scheduling parameters for use by one or more queues or schedulers." INDEX { diffServShapingRateId, diffServShapingRateLevel } ::= { diffServShapingRateTable 1 } DiffServShapingRateEntry ::= SEQUENCE { diffServShapingRateId INTEGER, diffServShapingRateLevel INTEGER, diffServShapingRateAbs Unsigned32, diffServShapingRateRel Unsigned32, diffServShapingRateThreshold BurstSize, diffServShapingRateStatus RowStatus } diffServShapingRateId OBJECT-TYPE SYNTAX IndexInteger MAX-ACCESS not-accessible STATUS current DESCRIPTION "An index that enumerates the Shaping Parameter entries. The set of such identifiers spans the whole agent. Managers obtain new values for row creation in this table by reading diffServShapingRateNextFree." ::= { diffServShapingRateEntry 1 } diffServShapingRateLevel OBJECT-TYPE SYNTAX IndexInteger MAX-ACCESS not-accessible STATUS current DESCRIPTION "An index that indicates which level of a multi-rate shaper is being given its parameters. A multi-rate shaper has some number of rate levels. Frame Relay's dual rate specification refers to a 'committed' and an 'excess' rate; ATM's dual rate specification refers to a 'mean' and a 'peak' rate. This table is generalized to support an arbitrary number of rates. The committed or mean rate is level 1, the peak rate (if any) is the highest level rate configured, and if there are other rates they are distributed in monotonically increasing order between them." ::= { diffServShapingRateEntry 2 } diffServShapingRateAbs OBJECT-TYPE SYNTAX Unsigned32 UNITS "kilobits per second" MAX-ACCESS read-create STATUS current DESCRIPTION "The maximum rate in kilobits/sec that a downstream scheduler element should allocate to this queue. If the value is zero, then there is effectively no maximum rate limit and that the scheduler should attempt to be work conserving for this queue. If the value is non-zero, the scheduler will limit the servicing of this queue to, at most, this rate in a non-work-conserving manner. Note that this attribute value and that of diffServShapingRateRel are coupled: changes to one will affect the value of the other. They are linked by the following equation: diffServShapingRateRel = (diffServShapingRateAbs * 1000000)/ifSpeed or, if appropriate: diffServShapingRateRel = diffServShapingRateAbs/ifHighSpeed" REFERENCE "ifSpeed, ifHighSpeed from the Interfaces MIB, RFC 2963" ::= { diffServShapingRateEntry 3 } diffServShapingRateRel OBJECT-TYPE SYNTAX Unsigned32 MAX-ACCESS read-create STATUS current DESCRIPTION "The maximum rate that a downstream scheduler element should allocate to this queue, relative to the maximum rate of the interface as reported by ifSpeed or ifHighSpeed, in units of 1/1000 of 1. If the value is zero, then there is effectively no maximum rate limit and the scheduler should attempt to be work conserving for this queue. If the value is non-zero, the scheduler will limit the servicing of this queue to, at most, this rate in a non-work-conserving manner. Note that this attribute value and that of diffServShapingRateAbs are coupled: changes to one will affect the value of the other. They are linked by the following equation: diffServShapingRateRel = (diffServShapingRateAbs * 1000000)/ifSpeed or, if appropriate: diffServShapingRateRel = diffServShapingRateAbs/ifHighSpeed" REFERENCE "ifSpeed, ifHighSpeed from the Interfaces MIB, RFC 2963" ::= { diffServShapingRateEntry 4 } diffServShapingRateThreshold OBJECT-TYPE SYNTAX BurstSize UNITS "Bytes" MAX-ACCESS read-create STATUS current DESCRIPTION "The number of bytes of queue depth at which the rate of a multi-rate scheduler will increase to the next output rate. In the last conceptual row for such a shaper, this threshold is ignored and by convention is zero." REFERENCE "RFC 2963" ::= { diffServShapingRateEntry 5 } diffServShapingRateStatus OBJECT-TYPE SYNTAX RowStatus MAX-ACCESS read-create STATUS current DESCRIPTION "The RowStatus variable controls the activation, deactivation, or deletion of a queue. Any writable variable may be modified whether the row is active or notInService." ::= { diffServShapingRateEntry 6 } -- -- MIB Compliance statements. -- diffServMIBCompliances OBJECT IDENTIFIER ::= { diffServMIBConformance 1 } diffServMIBGroups OBJECT IDENTIFIER ::= { diffServMIBConformance 2 } diffServMIBCompliance MODULE-COMPLIANCE STATUS current DESCRIPTION "This MIB may be implemented as a read-only or as a read-create MIB. As a result, it may be used for monitoring or for configuration." MODULE -- This Module MANDATORY-GROUPS { diffServMIBDataPathGroup, diffServMIBClfrGroup, diffServMIBClfrElementGroup, diffServMIBMultiFieldClfrGroup, diffServMIBActionGroup, diffServMIBAlgDropGroup, diffServMIBQGroup, diffServMIBSchedulerGroup, diffServMIBShapingRateGroup, diffServMIBAssuredRateGroup } -- The groups: -- diffServMIBCounterGroup -- diffServMIBHCCounterGroup -- diffServMIBVHCCounterGroup -- -- are mutually exclusive; at most one of these groups is implemented -- for a particular interface. When any of these groups is implemented -- for a particular interface, then ifCounterDiscontinuityGroup from -- the Interfaces MIB must also be implemented for that interface. -- -- Note that the diffServMIBStaticGroup is mandatory for implementations -- that implement a read-write or read-create mode. GROUP diffServMIBCounterGroup DESCRIPTION "This group is mandatory for table objects indexed by ifIndex for which the value of the corresponding instance of ifSpeed is less than or equal to 20,000,000 bits/second." GROUP diffServMIBHCCounterGroup DESCRIPTION "This group is mandatory for table objects indexed by ifIndex for which the value of the corresponding instance of ifSpeed is greater than 20,000,000 bits/second." GROUP diffServMIBVHCCounterGroup DESCRIPTION "This group is mandatory for table objects indexed by ifIndex for which the value of the corresponding instance of ifSpeed is greater than 650,000,000 bits/second." GROUP diffServMIBMeterGroup DESCRIPTION "This group is mandatory for devices that implement metering functions." GROUP diffServMIBTBParamGroup DESCRIPTION "This group is mandatory for devices that implement token-bucket metering functions." GROUP diffServMIBDscpMarkActGroup DESCRIPTION "This group is mandatory for devices that implement DSCP-Marking functions." GROUP diffServMIBRandomDropGroup DESCRIPTION "This group is mandatory for devices that implement Random Drop functions." GROUP diffServMIBStaticGroup DESCRIPTION "This group is mandatory for devices that allow creation of rows in any of the writable tables of this MIB." OBJECT diffServDataPathStart MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT diffServDataPathStatus MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT diffServClfrDataPathStart MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT diffServClfrStatus MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT diffServClfrElementPrecedence MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT diffServClfrElementNext MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT diffServClfrElementSpecific MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT diffServClfrElementStatus MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT diffServMultiFieldClfrAddrType MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT diffServMultiFieldClfrDstAddr MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT diffServMultiFieldClfrDstPrefixLength MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT diffServMultiFieldClfrFlowId MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT diffServMultiFieldClfrSrcAddr MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT diffServMultiFieldClfrSrcPrefixLength MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT diffServMultiFieldClfrDscp MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT diffServMultiFieldClfrProtocol MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT diffServMultiFieldClfrDstL4PortMin MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT diffServMultiFieldClfrDstL4PortMax MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT diffServMultiFieldClfrSrcL4PortMin MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT diffServMultiFieldClfrSrcL4PortMax MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT diffServMultiFieldClfrStatus MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT diffServMeterSucceedNext MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT diffServMeterFailNext MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT diffServMeterSpecific MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT diffServMeterStatus MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT diffServTBParamType MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT diffServTBParamRate MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT diffServTBParamBurstSize MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT diffServTBParamInterval MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT diffServTBParamStatus MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT diffServActionNext MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT diffServActionSpecific MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT diffServActionStatus MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT diffServCountActStatus MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT diffServAlgDropType MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT diffServAlgDropNext MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT diffServAlgDropQMeasure MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT diffServAlgDropQThreshold MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT diffServAlgDropSpecific MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT diffServAlgDropStatus MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT diffServRandomDropMinThreshBytes MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT diffServRandomDropMinThreshPkts MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT diffServRandomDropMaxThreshBytes MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT diffServRandomDropMaxThreshPkts MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT diffServRandomDropProbMax MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT diffServRandomDropWeight MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT diffServRandomDropSamplingRate MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT diffServRandomDropStatus MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT diffServQNext MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT diffServQRate MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT diffServQShaper MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT diffServQStatus MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT diffServSchedulerNext MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT diffServSchedulerMethod MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT diffServSchedulerRate MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT diffServSchedulerShaper MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT diffServSchedulerStatus MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT diffServAssuredRatePriority MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT diffServAssuredRateAbs MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT diffServAssuredRateRel MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT diffServAssuredRateStatus MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT diffServShapingRateAbs MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT diffServShapingRateRel MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT diffServShapingRateThreshold MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT diffServShapingRateStatus MIN-ACCESS read-only DESCRIPTION "Write access is not required." ::= { diffServMIBCompliances 1 } diffServMIBDataPathGroup OBJECT-GROUP OBJECTS { diffServDataPathStart, diffServDataPathStatus } STATUS current DESCRIPTION "The Data Path Group defines the MIB Objects that describe a functional data path." ::= { diffServMIBGroups 1 } diffServMIBClfrGroup OBJECT-GROUP OBJECTS { diffServClfrStatus } STATUS current DESCRIPTION "The Classifier Group defines the MIB Objects that describe the list the starts of individual classifiers." ::= { diffServMIBGroups 2 } diffServMIBClfrElementGroup OBJECT-GROUP OBJECTS { diffServClfrElementPrecedence, diffServClfrElementNext, diffServClfrElementSpecific, diffServClfrElementStatus } STATUS current DESCRIPTION "The Classifier Element Group defines the MIB Objects that describe the classifier elements that make up a generic classifier." ::= { diffServMIBGroups 3 } diffServMIBMultiFieldClfrGroup OBJECT-GROUP OBJECTS { diffServMultiFieldClfrAddrType, diffServMultiFieldClfrDstAddr, diffServMultiFieldClfrDstPrefixLength, diffServMultiFieldClfrFlowId, diffServMultiFieldClfrSrcAddr, diffServMultiFieldClfrSrcPrefixLength, diffServMultiFieldClfrDscp, diffServMultiFieldClfrProtocol, diffServMultiFieldClfrDstL4PortMin, diffServMultiFieldClfrDstL4PortMax, diffServMultiFieldClfrSrcL4PortMin, diffServMultiFieldClfrSrcL4PortMax, diffServMultiFieldClfrStatus } STATUS current DESCRIPTION "The Six-Tuple Classifier Group defines the MIB Objects that describe a classifier element for matching on 6 fields of an IP and upper-layer protocol header." ::= { diffServMIBGroups 4 } diffServMIBMeterGroup OBJECT-GROUP OBJECTS { diffServMeterSucceedNext, diffServMeterFailNext, diffServMeterSpecific, diffServMeterStatus } STATUS current DESCRIPTION "The Meter Group defines the objects used in describing a generic meter element." ::= { diffServMIBGroups 5 } diffServMIBTBParamGroup OBJECT-GROUP OBJECTS { diffServTBParamType, diffServTBParamRate, diffServTBParamBurstSize, diffServTBParamInterval, diffServTBParamStatus } STATUS current DESCRIPTION "The Token-Bucket Meter Group defines the objects used in describing a token bucket meter element." ::= { diffServMIBGroups 6 } diffServMIBActionGroup OBJECT-GROUP OBJECTS { diffServActionNext, diffServActionSpecific, diffServActionStatus } STATUS current DESCRIPTION "The Action Group defines the objects used in describing a generic action element." ::= { diffServMIBGroups 7 } diffServMIBDscpMarkActGroup OBJECT-GROUP OBJECTS { diffServDscpMarkActDscp } STATUS current DESCRIPTION "The DSCP Mark Action Group defines the objects used in describing a DSCP Marking Action element." ::= { diffServMIBGroups 8 } diffServMIBCounterGroup OBJECT-GROUP OBJECTS { diffServCountActOctets, diffServCountActPkts, diffServCountActDiscontTime, diffServCountActStatus, diffServAlgDropOctets, diffServAlgDropPkts, diffServAlgRandomDropOctets, diffServAlgRandomDropPkts } STATUS current DESCRIPTION "A collection of objects providing information specific to non- high speed (non- high speed interfaces transmit and receive at speeds less than or equal to 20,000,000 bits/second) packet- oriented network interfaces." ::= { diffServMIBGroups 9 } diffServMIBHCCounterGroup OBJECT-GROUP OBJECTS { diffServCountActOctets, diffServCountActHCOctets, diffServCountActPkts, diffServCountActDiscontTime, diffServCountActStatus, diffServAlgDropOctets, diffServAlgDropHCOctets, diffServAlgDropPkts, diffServAlgRandomDropHCOctets, diffServAlgRandomDropPkts } STATUS current DESCRIPTION "A collection of objects providing information specific to high speed (high speed interfaces transmit and receive at speeds greater than 20,000,000 but less than or equals to 650,000,000 bits/second) packet-oriented network interfaces." ::= { diffServMIBGroups 10 } diffServMIBVHCCounterGroup OBJECT-GROUP OBJECTS { diffServCountActOctets, diffServCountActHCOctets, diffServCountActPkts, diffServCountActHCPkts, diffServCountActDiscontTime, diffServCountActStatus, diffServAlgDropOctets, diffServAlgDropHCOctets, diffServAlgDropPkts, diffServAlgDropHCPkts } STATUS current DESCRIPTION "A collection of objects providing information specific to very- high speed (very-high speed interfaces transmit and receive at speeds greater than 650,000,000 bits/second) packet-oriented network interfaces." ::= { diffServMIBGroups 11 } diffServMIBAlgDropGroup OBJECT-GROUP OBJECTS { diffServAlgDropType, diffServAlgDropNext, diffServAlgDropDiscontinuityTime, diffServAlgDropQMeasure, diffServAlgDropQThreshold, diffServAlgDropSpecific, diffServAlgDropStatus } STATUS current DESCRIPTION "The Algorithmic Drop Group contains the objects that describe algorithmic dropper operation and configuration." ::= { diffServMIBGroups 12 } diffServMIBRandomDropGroup OBJECT-GROUP OBJECTS { diffServRandomDropMinThreshBytes, diffServRandomDropMinThreshPkts, diffServRandomDropMaxThreshBytes, diffServRandomDropMaxThreshPkts, diffServRandomDropProbMax, diffServRandomDropWeight, diffServRandomDropSamplingRate, diffServRandomDropStatus } STATUS current DESCRIPTION "The Random Drop Group augments the Algorithmic Drop Group for random dropper operation and configuration." ::= { diffServMIBGroups 13 } diffServMIBQGroup OBJECT-GROUP OBJECTS { diffServQNext, diffServQRate, diffServQShaper, diffServQStatus } STATUS current DESCRIPTION "The Queue Group contains the objects that describe an interface's queues." ::= { diffServMIBGroups 14 } diffServMIBSchedulerGroup OBJECT-GROUP OBJECTS { diffServSchedulerNext, diffServSchedulerMethod, diffServSchedulerRate, diffServSchedulerShaper, diffServSchedulerStatus } STATUS current DESCRIPTION "The Scheduler Group contains the objects that describe packet schedulers on interfaces." ::= { diffServMIBGroups 15 } diffServMIBAssuredRateGroup OBJECT-GROUP OBJECTS { diffServAssuredRatePriority, diffServAssuredRateAbs, diffServAssuredRateRel, diffServAssuredRateStatus } STATUS current DESCRIPTION "The Scheduler Parameter Group contains the objects that describe packet schedulers' parameters on interfaces." ::= { diffServMIBGroups 16 } diffServMIBShapingRateGroup OBJECT-GROUP OBJECTS { diffServShapingRateAbs, diffServShapingRateRel, diffServShapingRateThreshold, diffServShapingRateStatus } STATUS current DESCRIPTION "The Scheduler Parameter Group contains the objects that describe packet schedulers' parameters on interfaces." ::= { diffServMIBGroups 17 } diffServMIBStaticGroup OBJECT-GROUP OBJECTS { diffServClfrNextFree, diffServClfrElementNextFree, diffServMultiFieldClfrNextFree, diffServMeterNextFree, diffServTBParamNextFree, diffServActionNextFree, diffServCountActNextFree, diffServAlgDropNextFree, diffServRandomDropNextFree, diffServQNextFree, diffServSchedulerNextFree, diffServAssuredRateNextFree, diffServShapingRateNextFree } STATUS current DESCRIPTION "The Static Group contains readable scalar objects used in creating unique identifiers for classifiers, meters, actions and queues. These are required whenever row creation operations on such tables are supported." ::= { diffServMIBGroups 18 } END