display mac-limit

Function

The display mac-limit command displays the rules that limit the number of learned MAC addresses.

Format

display mac-limit [ interface-type interface-number | vlan vlan-id | vsi vsi-name ]

Parameters

Parameter	Description	Value
interface-type interface-number	Displays the MAC address limiting rule on a specified interface. interface-type specifies the type of the interface. interface-number specifies the number of the interface.	-
vlan vlan-id	Displays the MAC address limiting rules in a specified VLAN.	The value is an integer that ranges from 1 to 4094.
vsi vsi-name	Displays the MAC address limiting rules in a specified VSI. vsi-name specifies the name of a VSI. NOTE: Only the S5720-EI, S5720-HI, S5730-HI, S5731-H, S5731S-H, S5732-H, S6720-EI, S6720-HI, S6720S-EI, S6730S-H, and S6730-H support this parameter.	The value is a string of 1 to 31 case-sensitive characters, spaces not supported. When double quotation marks are used around the string, spaces are allowed in the string.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

To check whether MAC address limiting rules are configured correctly, run the display mac-limit command. If a rule is incorrect, run the mac-limit command to modify the rule or run the undo mac-limit all command to delete it.

Precautions

If no parameter is specified, MAC address learning limit rules of all interfaces, VSIs, and VLANs are displayed.

Example

# Display the MAC address limiting rule on GigabitEthernet0/0/1.

<HUAWEI> display mac-limit GigabitEthernet 0/0/1
GigabitEthernet0/0/1 MAC limit:
  Maximum MAC count 1000, used count 0 
  Action: forward, Alarm: enable

# Display all the MAC address limiting rules.

<HUAWEI> display mac-limit
MAC Limit is enabled
Total MAC Limit rule count : 1

PORT                 VLAN/VSI/SI       SLOT Maximum Rate(ms) Action  Alarm
----------------------------------------------------------------------------
GE0/0/1              -                 -    100     -        forward enable

**Table 1** Description of the display mac-limit command output
Item	Description
GigabitEthernet 0/0/1 MAC limit:	MAC address limiting rule for the interface. To specify the parameters, run the mac-limit command.
Maximum MAC count	Maximum number of MAC addresses that can be learned.
used count	Number of MAC addresses that have been learned.
Total MAC Limit rule count	Number of configured MAC address limiting rules.
PORT	Name of an interface.
VLAN/VSI/SI	ID of a VLAN VSI name, or service instance (SI) name.
SLOT	Slot ID of the card where a MAC address limiting rule is configured.
Maximum	Maximum number of MAC addresses that can be learned. To set the maximum number of MAC addresses, run the mac-limit command.
Rate(ms)	Indicates the interval at which MAC addresses are learned.
Action	Action performed on packets when the number of learned MAC addresses exceeds the maximum. The value forward indicates that packets are forwarded with new source MAC addresses.
Alarm	Whether an alarm is generated when the number of learned MAC addresses exceeds the maximum. enable: indicates that an alarm is generated. disable: indicates that an alarm is not generated.