Police - Cisco Catalyst 3750 Command Reference Manual

police

police
Use the police policy-map class configuration command on the switch stack or on a standalone switch
to define a policer for classified 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(11)AX
Usage Guidelines The port ASIC device, which controls more than one physical port, supports 256 policers (255 policers
plus 1 no policer). The maximum number of policers supported per port is 64. 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.
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
how quickly (the average rate) the tokens are removed from the bucket by using the rate-bps option of
the police policy-map class configuration command or the mls qos aggregate-policer global
configuration command. For more information, refer to the software configuration guide for this release.
Policy maps that have the police aggregate command fail when applied to a 10-Gigabit Ethernet
interface.
Catalyst 3750 Switch Command Reference
2-206
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 bits per second (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
changes the Differentiated Services Code Point (DSCP) of the packet to that
specified in the policed-DSCP map and then sends the packet.
Modification
This command was introduced.
Chapter 2 Catalyst 3750 Switch Cisco IOS Commands
78-16181-01