display mac-address

Function

The display mac-address command displays information about MAC address table entries.

Format

display mac-address [ mac-address ] [ vlan vlan-id ]

display mac-address { vlan vlan-id | interface-type interface-number }

Parameters

Parameter	Description	Value
mac-address	Displays the entry corresponding to a specified unicast MAC address.	MAC address in the format of H-H-H. Each H is a 4-digit hexadecimal number, such as 00e0 and fc01. If an H contains less than four digits, 0s are added ahead. For example, if an H is e0, it is equal to 00e0.
vlan vlan-id	Displays the MAC address entries in a specified VLAN.	The value is an integer ranging from 1 to 4094.
interface-type interface-number	Displays the MAC address entries on a specified interface.	The interface can be an Ethernet interface, a GE interface, or an Eth-Trunk interface.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

None

Example

# Display all MAC address entries.

[sysname] display mac-address
------------------------------------------------------------------------------- 
MAC Address    VLAN ID     Left Time(s)    Port            Type                  
------------------------------------------------------------------------------- 
0001-0001-0001 1           -               GE0/0/2         static                
------------------------------------------------------------------------------- 
Total items displayed = 1

**Table 1** Description of the **display mac-address** command output
Item	Description
MAC Address	Indicates the MAC address.
VLAN ID	Indicates the VLAN to which the outgoing interface belongs.
Left Time(s)	Remained aging time, in seconds
Port	Indicates the outbound interface corresponding to the MAC address
Type	Indicates the type of MAC addresses. The value can be: static: indicates static MAC address entries. Static MAC addresses are configured by users, and the entries will not be aged. They will remain in the MAC address table after the system is reset or the interface board is hot swapped. blackhole: indicates blackhole MAC address entries. Blackhole MAC addresses are configured by users, and the entries will not be aged. They will remain in the MAC address table after the system is reset or the interface board is hot swapped. dynamic: indicates dynamic MAC address entries. Dynamic MAC addresses can be configured by users or obtained by learning source MAC addresses. The entries will be aged, and they will be removed from the MAC address table after the system is reset or the interface board is hot swapped.