display mac-limit rule-name

Function

The display mac-limit rule-name command displays detailed information about a global MAC address learning limit rule.

Format

display mac-limit rule-name [ rule-name ]

Parameters

Parameter	Description	Value
rule-name	Displays detailed information about the specified global MAC address learning limit rule.	The value is a string of 1 to 31 characters.It does not support space, question mark, or subtraction sign.

Parameter

Description

Value

rule-name

Displays detailed information about the specified global MAC address learning limit rule.

The value is a string of 1 to 31 characters.It does not support space, question mark, or subtraction sign.

Views

All views

Default Level

1: Monitoring level

Task Name and Operations

Task Name	Operations
mac	read

Usage Guidelines

Usage Scenario

After a global MAC address learning limit rule is created using the mac-limit rule-name (system view) command, you can use the display mac-limit rule-name command to view detailed information about the global MAC address learning limit rule.
After a global MAC address learning limit rule is applied on an interface using the mac-limit rule-name(interface view) or the mac-limit vlan rule-name command, you can run the display mac-limit rule-name command to view detailed information about the global MAC address learning limit rule which has taken effect on the interface.

Precautions

If a global MAC address learning limit rule is not applied on an interface, no content is displayed in the Port and VLAN fields when the display mac-limit rule-name command is run.

The MAC address learning limit rule configured by the mac-limit (interface view) command in the interface view or the mac-limit (VLAN view) command in the VLAN view will not be displayed when the display mac-limit rule-name command is run.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display detailed information about the global MAC address learning limit rule name1.

<HUAWEI> display mac-limit rule-name name1
Total Global MAC Limit rule count : 1 
RuleName      Maximum  Rate(ms)  Action    Alarm   PortNum  Port          Vlan 
-------------------------------------------------------------------------------
name1         100      21        discard   enable  6      
                                                           Eth-Trunk2.1   -    
                                                           GE0/1/1.1      -    
                                                           GE0/1/2.1      -    
                                                           GE0/1/3.1      -    
                                                           GE0/1/4.1      -    
                                                           GE0/1/5.1      -

**Table 1** Description of the **display mac-limit rule-name** command output
Item	Description
Total Global MAC Limit rule count	Total mac address limit rule count.
RuleName	Name of the global MAC address learning limit rule.
Maximum	Maximum number of MAC addresses that can be learned.
Rate(ms)	Interval at which MAC addresses are learned.
Action	Action taken on the packets after the maximum number is reached. discard: The packet with the destination MAC address not contained in the MAC address table is discarded. forward: The packet with the destination MAC address not contained in the MAC address table is forwarded.
Alarm	Whether an alarm is generated when the number of learned MAC addresses reaches the limit: enable: An alarm is generated. disable: No alarm is generated.
PortNum	Total number of the interfaces on which the global MAC address learning limit rule is applied.
Port	Number of the port to which the global MAC address learning limit rule is applied.
Vlan	ID of the VLAN to which the interface belongs.