rate-limit

Syntax

rate-limit {broadcast | multicast | unknown-unicast} <RATE> {kbps | 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> {kbps | pps}

Specifies the rate limit. Range: 22 to 100000000 kbps (in steps of 22 kbps), or 43 to 209090910 kbps (in steps of 43 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 broadcast traffic to 500 kbps on interface 1/1/3:

switch(config)# interface 1/1/3
switch(config-if)# rate-limit broadcast 500 kbps

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

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

Limiting unknown unicast traffic to 100 kbps on interface 1/1/3.

switch(config)# interface 1/1/3
switch(config-if)# rate-limit unknown-unicast 100 kbps

Viewing the results of the previous configuration settings.

switch# show interface 1/1/3 qos
Interface 1/1/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 broadcast unknown-unicast 100 kbps (109 actual)
 rate-limit broadcast 500 kbps (505 actual)
 rate-limit multicast 4000 pps (3990 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 kbps on LAG 100.
switch# config
switch(config)# interface 1/1/3
switch(config)# interface lag 100
switch(config-if)# rate-limit broadcast 50 kbps