CTRON-RATE-POLICING-MIB DEFINITIONS ::= BEGIN -- ctron-rate-policing-mib.txt -- -- This module provides authoritative definitions for Enterasys -- Network's CTRON-RATE-POLICING-MIB. -- This module will be extended, as needed. -- -- Enterasys Networks reserves the right to make changes in -- specification and other information contained in this document -- without prior notice. The reader should consult Enterasys Networks -- to determine whether any such changes have been made. -- -- In no event shall Enterasys Networks be liable for any incidental, -- indirect, special, or consequential damages whatsoever (including -- but not limited to lost profits) arising out of or related to this -- document or the information contained in it, even if Enterasys -- Networks has been advised of, known, or should have known, the -- possibility of such damages. -- -- Enterasys grants vendors, end-users, and other interested parties -- a non-exclusive license to use this Specification in connection -- with the management of Enterasys products. -- -- Copyright November 2001-2003 Enterasys Networks, Inc. IMPORTS MODULE-IDENTITY, OBJECT-TYPE, Integer32, Unsigned32, TimeTicks FROM SNMPv2-SMI TEXTUAL-CONVENTION FROM SNMPv2-TC MODULE-COMPLIANCE, OBJECT-GROUP FROM SNMPv2-CONF dot1dBasePort FROM BRIDGE-MIB ctPriorityExt FROM CTRON-MIB-NAMES; ctRatePolicing MODULE-IDENTITY LAST-UPDATED "200304101518Z" -- Thu Apr 10 15:18 GMT 2003 ORGANIZATION "Enterasys Networks, Inc" CONTACT-INFO "Postal: Enterasys Networks 50 Minuteman Rd. Andover, MA 01810-1008 USA Phone: +1 978 684 1000 E-mail: support@enterasys.com WWW: http://www.enterasys.com" DESCRIPTION "The Enterasys Rate Policing MIB module allows the user to set maximum ingress rates on a per port, per priority basis." REVISION "200304101518Z" -- Thu Apr 10 15:18 GMT 2003 DESCRIPTION "Added display hint to CtPriList." REVISION "200303111553Z" -- Tue Mar 11 15:53 GMT 2003 DESCRIPTION "Changed the definitions of the CtRatePolActionList and CtRatePolDirectionList textual conventions. The syntax was also changed from Integer32 to INTEGER with enumeration values that map to the prior bit positions." REVISION "200011281551Z" DESCRIPTION "Changed the CONTACT-INFO portion of the MODULE-IDENTITY to reflect the company name change to Enterasys Networks. Added ranges to the ctRatePolicingThreshHoldMin and ctRatePolicingThreshHold leaves." REVISION "199906210000Z" DESCRIPTION "The initial version of this MIB module" ::= { ctPriorityExt 7 } ctRatePolicingObjects OBJECT IDENTIFIER ::= { ctRatePolicing 1 } -- ------------------------------------------------------------- -- Textual Conventions -- ------------------------------------------------------------- CtPriList ::= TEXTUAL-CONVENTION DISPLAY-HINT "x" STATUS current DESCRIPTION "The least significant octet within this integer specifies a set of eight priorities. Within this octet, the most significant bit represents the highest priority(7), and the least significant bit represents the lowest priority(0). Thus, each priority is represented by a single bit within the value of this object. If that bit has a value of '1' then that priority is included in the set of priorities; the priority is not included if its bit has a value of '0'." SYNTAX INTEGER (0..255) CtRatePolActionList ::= TEXTUAL-CONVENTION STATUS current DESCRIPTION "This value represents a list of rate policing actions." SYNTAX INTEGER { none(0), dropPacket(1), flowCtrlPacketAndDrop(2), dropPacketOrFlowCtrlAndDrop(3) } CtRatePolDirectionList ::= TEXTUAL-CONVENTION STATUS current DESCRIPTION "This value represents the possible traffic flow directions." SYNTAX INTEGER { none(0), inbound(1), outbound(2), inboundAndOutbound(3) } -- ------------------------------------------------------------- -- Rate Policing Configuration -- ------------------------------------------------------------- ctRatePolicingAdminStatus OBJECT-TYPE SYNTAX INTEGER { enable(1), disable(2) } MAX-ACCESS read-write STATUS current DESCRIPTION "Allows the rate policing feature to be globally enabled/disabled. A value of disable(2), functionally supersedes the ctRatePolicingRuleStatus of individual entries in the ctRatePolicingConfigTable, but does not change their actual values." DEFVAL { disable } ::= { ctRatePolicingObjects 1} ctRatePolicingConfigLastChange OBJECT-TYPE SYNTAX TimeTicks MAX-ACCESS read-only STATUS current DESCRIPTION "The value of sysUpTime the last time anything in the ctRatePolicingConfigTable changed." ::= { ctRatePolicingObjects 2 } ctRatePolicingConfigTable OBJECT-TYPE SYNTAX SEQUENCE OF CtRatePolicingConfigEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "This table allows configuration of rate policing rules on this device. Their are a limited number of resources available for rate policing, and this directly limits the number of rate policing rules that may be configured on each port. As a result this table does not support dynamic row creation, rather, all possible rows exist in either an active or disabled state. A manager application should not, however, infer that this configuration is necessarily fixed during the lifetime of the managed entity. The allocation of resources could theoretically be shifted. For example port 20 could have 3 resources and at some point suddenly have 4 or 2. Any such change would of course cause the value of ctRatePolicingConfigLastChange to change. At this time their is no defined mechanism to move these resources and there very likely never will be. This is merely a warning that manager applications should not count on this." ::= { ctRatePolicingObjects 3 } ctRatePolicingConfigEntry OBJECT-TYPE SYNTAX CtRatePolicingConfigEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "Describes a particular entry of ctRatePolicingConfigTable." INDEX { dot1dBasePort, ctRatePolicingResourceIndex } ::= { ctRatePolicingConfigTable 1 } CtRatePolicingConfigEntry ::= SEQUENCE { ctRatePolicingResourceIndex INTEGER, ctRatePolicingActionsAllowed CtRatePolActionList, ctRatePolicingAction CtRatePolActionList, ctRatePolicingThreshHoldMin Integer32, ctRatePolicingThreshHold Integer32, ctRatePolicingPriorityList CtPriList, ctRatePolicingRuleStatus INTEGER, ctRatePolicingActionsTaken Integer32, ctRatePolicingDirectionsAllowed CtRatePolDirectionList, ctRatePolicingDirection CtRatePolDirectionList } ctRatePolicingResourceIndex OBJECT-TYPE SYNTAX INTEGER (0..65535) MAX-ACCESS not-accessible STATUS current DESCRIPTION "This specifies a unique resource available for configuring a rate policing rule on this port. Each port has a limited number of resources available for rate policing. This index simply provides a mechanism for uniquely addressing each of these resources." ::= { ctRatePolicingConfigEntry 1 } ctRatePolicingActionsAllowed OBJECT-TYPE SYNTAX CtRatePolActionList MAX-ACCESS read-only STATUS current DESCRIPTION "This specifies the valid policing actions that may be taken for this port upon exceeding the threshold specified in ctRatePolicingThreshHold." ::= { ctRatePolicingConfigEntry 2 } ctRatePolicingAction OBJECT-TYPE SYNTAX CtRatePolActionList MAX-ACCESS read-write STATUS current DESCRIPTION "This is the action to be taken if the rate limit is exceeded. This value must be a valid action as specified by the corresponding ctRatePolicingActionsAllowed object. Also, no more than one action may be specified. Attempts to set this value outside of the aforementioned guidelines will fail." ::= { ctRatePolicingConfigEntry 3 } ctRatePolicingThreshHoldMin OBJECT-TYPE SYNTAX Integer32 (0..2147483647) UNITS "kilobytes" MAX-ACCESS read-only STATUS current DESCRIPTION "The minimum rate limit value for this entry in kB per second." ::= { ctRatePolicingConfigEntry 4 } ctRatePolicingThreshHold OBJECT-TYPE SYNTAX Integer32 (0..2147483647) UNITS "kilobytes" MAX-ACCESS read-write STATUS current DESCRIPTION "The rate limit value for this entry in kB per second. If the rate is exceeded the defined action in ctRatePolicingAction will be enforced. This value may not be set below the minimum rate specified in ctRatePolicingThreshHoldMin." ::= { ctRatePolicingConfigEntry 5 } ctRatePolicingPriorityList OBJECT-TYPE SYNTAX CtPriList MAX-ACCESS read-write STATUS current DESCRIPTION "This specifies the list of priorities to which this rule applies." ::= { ctRatePolicingConfigEntry 6 } ctRatePolicingRuleStatus OBJECT-TYPE SYNTAX INTEGER { active(1), disabled(2) } MAX-ACCESS read-write STATUS current DESCRIPTION "This object provides both control and status for the associated conceptual row in the table. The value of active(1) indicates that device is actively applying the rate policing rule defined by the other leaves in this row. All other read-write leaves in this row have an effective value of read-only while the row is in the active state. The value of disabled(2) indicates that this row is essentially an available resource which MAY be configured and activated." ::= { ctRatePolicingConfigEntry 7 } ctRatePolicingActionsTaken OBJECT-TYPE SYNTAX Integer32 MAX-ACCESS read-only STATUS current DESCRIPTION "This object counts the number of times the ctRatePolicingAction has been enforced for this particular entry." ::= { ctRatePolicingConfigEntry 8 } ctRatePolicingDirectionsAllowed OBJECT-TYPE SYNTAX CtRatePolDirectionList MAX-ACCESS read-only STATUS current DESCRIPTION "This specifies the valid policing directions that may be taken for this port." ::= { ctRatePolicingConfigEntry 9 } ctRatePolicingDirection OBJECT-TYPE SYNTAX CtRatePolDirectionList MAX-ACCESS read-write STATUS current DESCRIPTION "This specifies the direction of the traffic flow that will be limited." ::= { ctRatePolicingConfigEntry 10 } -- ------------------------------------------------------------- -- Conformance Information -- ------------------------------------------------------------- ctRatePolicingConformance OBJECT IDENTIFIER ::= { ctRatePolicing 2 } ctRatePolicingGroups OBJECT IDENTIFIER ::= { ctRatePolicingConformance 1 } ctRatePolicingCompliances OBJECT IDENTIFIER ::= { ctRatePolicingConformance 2 } -- ------------------------------------------------------------- -- units of conformance -- ------------------------------------------------------------- ctRatePolicingConfigGroup OBJECT-GROUP OBJECTS { ctRatePolicingAdminStatus, ctRatePolicingConfigLastChange, ctRatePolicingActionsAllowed, ctRatePolicingAction, ctRatePolicingThreshHold, ctRatePolicingPriorityList, ctRatePolicingRuleStatus, ctRatePolicingActionsTaken, ctRatePolicingDirectionsAllowed, ctRatePolicingDirection } STATUS current DESCRIPTION "A collection of objects providing device level control and status information for rate policing." ::= { ctRatePolicingGroups 1 } -- ------------------------------------------------------------- -- compliance statements -- ------------------------------------------------------------- ctRatePolicingCompliance MODULE-COMPLIANCE STATUS current DESCRIPTION "The compliance statement for devices that support rate policing." MODULE MANDATORY-GROUPS { ctRatePolicingConfigGroup } ::= { ctRatePolicingCompliances 1 } END