police rate
To configure traffic policing and enter policy map police configuration mode, use the police rate command in policy map class configuration mode. To remove traffic policing from the configuration, use the no form of this command.
police rate {value [units] | percent percentage} [burst burst-size [burst-units] ] [peak-rate {value [units] | percent percentage}] [peak-burst peak-burst [burst-units] ]
no police rate {value [units] | percent percentage} [burst burst-size [burst-units] ] [peak-rate {value [units] | percent percentage}] [peak-burst peak-burst [burst-units] ]
Syntax Description
value |
Committed information rate (CIR). Range is from 1 to 4294967295. |
units |
(Optional) Unit of measurement for the CIR. |
percent percentage |
Specifies the police rate as a percentage of the CIR. Range is from 1 to 100. See the Usage Guidelines for information on how to use this keyword. |
burst burst-size |
(Optional) Specifies the burst size in the specified burst-units . The default burst value is 10 milliseconds of the CIR. The maximum burst value allowed is 4194304 bytes. |
burst-units |
(Optional) Unit of measurement for the burst values. |
peak-rate value |
(Optional) Specifies the Peak Information Rate (PIR) in the specified units . |
peak-burst peak-burst |
(Optional) Specifies the peak burst size in the specified burst-units . The default peak burst value is 10 milliseconds of the PIR. The maximum peak-burst value allowed is 8388608 bytes. Also, the difference of the peak-burst value and burst value cannot be larger than 4194304 bytes. |
Command Default
No restrictions on the flow of data are applied to any interface.
Command Modes
Policy map class configuration
Command History
Release | Modification |
---|---|
Release 6.1.42 |
This command was introduced. |
Usage Guidelines
Policer conditional set is unsupported.
Policing can be applied only in the ingress direction.
For police rate commands, interpret the percent keyword in this way:
-
For a one-level policy, the percent keyword specifies the CIR as a percentage of the link rate. For example, the command police rate percent 35 configures the CIR as 35% of the link rate.
Note |
Configured values take into account the Layer 2 encapsulation applied to traffic. This applies to ingress policing. For Ethernet transmission, the encapsulation is considered to be 14 bytes, whereas for IEEE 802.1Q, the encapsulation is 18 bytes. |
Note |
A police rate minimum of 21 kbps is supported. |
Task ID
Task ID |
Operations |
---|---|
qos |
read, write |
Examples
In this example, traffic policing is configured with an average rate of 200 pps, and a normal burst size of 50 packets, for all packets in class-map class1, leaving HundredGigE interface 0/1/0/0:
RP/0/(config)# policy-map pps-1r2c
RP/0/(config-pmap)# class class1
RP/0/(config-pmap-c)# police rate 200 pps burst 50 packets
RP/0/(config-pmap-c)# exit
RP/0/(config-pmap)# exit
RP/0/(config)# HundredGigE interface 0/1/0/0
RP/0/(config-if) service-policy input policy1