`rate-limit`

Syntax

rate-limit {broadcast | multicast | unknown-unicast} <RATE> pps

no rate-limit {broadcast | multicast | unknown-unicast}

Description

Sets the amount of traffic of a specific type that can ingress on an Ethernet port, or on each port of a LAG interface. Rate limits are enforced separately on each individual member of a LAG, not on the LAG as a whole.

The no form of this command removes the traffic limit for the specified traffic type.

Command context

config-if

Parameters

{broadcast | multicast | unknown-unicast}: Specifies the type of ingress traffic to which the rate limit applies: broadcast, multicast, or unknown-unicast. The multicast rate limit affects multicast and broadcast traffic. The broadcast rate limit only affects broadcast traffic. When both types are applied to the same interface, broadcast packets are limited to the lower of the two rate values. Layer 2 BPDU packets, like spanning tree, are also included in the multicast rate limit.
rate: Specifies the rate limit in packets per second (pps). Range: 64 to 209090910 pps. The actual rate limit varies with steps approximately equal to the minimum value. Verify the actual rate limit using the command show interface <INTERFACE-NAME>.

Authority

Administrators or local user group members with execution rights for this command.

Examples

Limiting multicast traffic to 4000 pps on interface 1/3/3:

switch(config)# interface 1/3/3
switch(config-if)# rate-limit multicast 4000 pps

Viewing the results of the previous configuration setting.

switch# show interface 1/3/3 qos
Interface 1/3/3 is down (Administratively down)
 Admin state is down
 Hardware: Ethernet, MAC Address: 1c:98:ec:e3:6a:00
 MTU 1500
 Full-duplex
 rate-limit multicast 4000 pps (4000 actual)

 Speed 0 Mb/s
 Auto-Negotiation is turned on
 Input flow-control is off, output flow-control is off
 RX
            0 input packets              0 bytes
            0 input error                0 dropped
            0 CRC/FCS
       L3:
            ucast: 0 packets, 0 bytes
            mcast: 0 packets, 0 bytes
 TX
            0 output packets             0 bytes
            0 input error                0 dropped
            0 collision
       L3:
            ucast: 0 packets, 0 bytes
            mcast: 0 packets, 0 bytes

Limiting broadcast traffic to 50 pps on LAG 100.

switch# config
switch(config)# interface 1/3/3
switch(config-if)# interface lag 100
switch(config-if)# rate-limit broadcast 50 pps