`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.
<RATE> {kbps | pps}: Specifies the rate limit. Range: 22 - 100000000 kbps (in steps of 22 kbps), or 43 - 209090910 kbps (in steps of 43 pps).

Authority

Administrators

Examples

Limiting broadcast traffic to 500 kbps on interface 3:

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

Limiting multicast traffic to 4000 pps on interface 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
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/1
switch(config)# interface lag 100
switch(config-if)# rate-limit broadcast 50 kbps
switch(config)# interface 1/1/2
switch(config-if)# lag 100
switch(config)# interface 1/1/3
switch(config-if)# lag 100