multicast limit

Configures the maximum number of multicast packets allowed per second and generates infralogs for pps packets.
Syntax
multicast limitnum
multicast limitnumkbps
multicast limitnumkbpslog
rate-limit-lognum
rate-limit-pps-lognum
multicast limitnum[kbps|pps]thresholdnumactionport-shutdownnum
no multicast limitnum
no multicast limitnumkbps
no multicast limitnumkbpslog
no-rate-limit-lognum
no rate-limit-pps-lognum
no multicast limitnum[kbps|pps]thresholdnumactionport-shutdownnum
Command Default

Multicast rate limiting is disabled.

Parameters
num
Specifies the maximum number of multicast packets per second. For kbps, the value can be from 1 through 1000000. For pps, the value can be from 1 through 8388607.
kbps
Enables byte-based limiting. The value can be 1 to Max Port Speed.
When kbps is not specified, the rate limiting happens in packets per second (pps).
log
Enables Syslog logging when the broadcast limit exceeds numkpbs.
rate-limit-log
Configures the log timer for the kbps ports. The value can be from 1 through 10 minutes. Default value is 5 minutes.
rate-limit-pps-log
Configures the log timer for the pps ports. The value can be from 1 through 600 seconds. Default value is 300 seconds.
thresholdnum
Specifies the packet drop count threshold value. For kbps, valid values range from 1 through 1048576. For pps, valid values range from 1 through 8388607.
action
Specifies further action must be taken.
port-shutdown
Specifies that port shutdown is the action taken.
For pps, the port shutdown value is from 1 through 65535. Default value is 5 minutes.
Modes

Interface configuration mode

Usage Guidelines

Use the no form of the command to disable multicast rate limiting.

Examples

The following example enables a multicast limit of 131072 Kbps. 

device# configure terminal
device(config)# interface ethernet 9/1/1
device(config-if-e1000-9/1/1)# multicast limit 131072 kbps

The following example enables multicast logging when the configured limit exceeds 100 Kbps. 

device# configure terminal
device(config)# interface ethernet 1/2/1
device(config-if-e1000-1/2/1)# multicast limit 100 kbps log

The following example enables the kbps log timer interval to 3 minutes when kbps rate limit is configured.

device(config)# rate-limit-log 3

The following example enables the pps log timer interval to 200 seconds when pps rate limit is configured.

device(config)# rate-limit-pps-log 200

The following example sets the packet drop count threshold value to 2000 and specifies that the port shutodwn action is taken. 

device# configure terminal
device(config)# interface ethernet 1/2/1
device(config-if-e10000-1/2/1)# multicast limit 100 kbps threshold 2000 action port-shutdown 7

The following example sets the packet drop count threshold value for pps to 1500 and specifies that the port shutdown action is taken. 

device(config)# interface ethernet 1/2/3
device(config-if-e10000-1/2/3)#  multicast limit 1500 pps threshold 2000 action port-shutdown 7
History
Release version Command history
08.0.10 The command was introduced.
08.0.40a The command was modified to include the log keyword.
09.0.10 The command was modified to include the pps keyword and pps log timer was introduced.
Parent topic: Commands M