Police - Cisco Catalyst 3750 Metro Command Reference Manual

Chapter 2 Catalyst 3750 Metro Switch Cisco IOS Commands

police

Use the police policy-map class configuration command to define a single-rate traffic policer for a class
of traffic. A policer defines a maximum permissible rate of transmission, a maximum burst size for
transmissions, and an action to take if either maximum is exceeded. Use the no form of this command
to remove an existing policer.
Syntax Description rate-bps
burst-byte
exceed-action drop
exceed-action
policed-dscp-transmit
Defaults No policers are defined.
Command Modes
Policy-map class configuration
Command History Release
12.1(14)AX
Usage Guidelines On a standard port and on the input of an ES port, the port ASIC device that controls the ports supports
256 policers on the switch (255 user-configurable policers plus 1 policer reserved for system internal
use). The maximum number of policers that can be configured per port is 63. Policers are allocated on
demand by the software and are constrained by the hardware and ASIC boundaries. You cannot reserve
policers per port. There is no guarantee that a port will be assigned to any policer. These limitations do
not apply to policers configured in a hierarchical policy attached to an ES port.
In Cisco IOS Release 12.2(25)EY or later, when configuring hierarchical dual-level policy maps, you
can only use the police policy-map command in a secondary interface-level policy map.
To return to policy-map configuration mode, use the exit command. To return to privileged EXEC mode,
use the end command.
Policing uses a token-bucket algorithm. You configure the bucket depth (the maximum burst that is
tolerated before the bucket overflows) by using the burst-byte option of the police policy-map class
configuration command or the mls qos aggregate-policer global configuration command. You configure
OL-9645-10
police rate-bps burst-byte [exceed-action {drop | policed-dscp-transmit}]
no police rate-bps burst-byte [exceed-action {drop | policed-dscp-transmit}]
Specify the average traffic rate in bps. The range is 8000 to 1000000000.
Specify the normal burst size in bytes. The range is 8000 to 1000000.
(Optional) When the specified rate is exceeded, specify that the switch drop
the packet.
(Optional) When the specified rate is exceeded, specify that the switch
change the Differentiated Services Code Point (DSCP) of the packet to that
specified in the policed-DSCP map and then send the packet.
Note
Modification
This command was introduced.
This exceed-action policed-dscp-transmit keywords are not
supported in ingress and egress hierarchical policies on
enhanced-services (ES) ports.
Catalyst 3750 Metro Switch Command Reference
police
2-347