unknown-unicast limit

Configures the maximum number of unknown unicast packets allowed per second and generates infralogs for pps packets.
Syntax
unknown-unicast limit num
unknown-unicast limit num kbps log
rate-limit-log num
rate-limit-pps-log num
unknown-unicast limit num [ kbps | pps ] threshold num action port-shutdown num
no unknown-unicast limit num
no unknown-unicast limit num kbps log
no-rate-limit-log num
no rate-limit-pps-log num
no unknown-unicast limit num [ kbps | pps ] threshold num action port-shutdown num
Command Default

Unknown unicast rate limiting is disabled.

Parameters
num
Specifies the maximum number of unknown unicast 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 of unknown unicast packets when the unknown unicast 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.
threshold num
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 unknown unicast rate limiting.

Examples

The following example enables a unknown unicast limit of 131072 Kbps. 

device(config)# interface ethernet 9/1/1
device(config-if-e1000-9/1/1)# unknown-unicast limit 131072 kbps

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

device(config)# interface ethernet 1/2/1
device(config-if-e1000-1/2/1)# unknown-unicast 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 for pps to 1500 and specifies that the port shutdown action is taken. 

device(config)# interface ethernet 1/2/4
device(config-if-e10000-1/2/4)# unknown-unicast 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 Si - Z