display mac-address

Use display mac-address to display MAC address entries.

Syntax

display mac-address [ mac-address [ vlan vlan-id ] | [ [ dynamic | static ] [ interface interface-type interface-number ] | blackhole | multiport ] [ vlan vlan-id ] [ count ] ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

mac-address: Specifies a MAC address in the format of H-H-H. When entering a MAC address, you can omit the leading zeros in each H section. For example, enter f-e2-1 for 000f-00e2-0001.

vlan vlan-id: Specifies a VLAN by its ID in the range of 1 to 4094.

dynamic: Displays dynamic MAC address entries.

static: Displays static MAC address entries.

interface interface-type interface-number: Specifies an interface by its type and number.

blackhole: Displays blackhole MAC address entries.

multiport: Displays multiport unicast MAC address entries.

count: Displays only the number of MAC address entries that match all entry attributes you specify in the command. Detailed information about MAC address entries is not displayed. For example, you can use the display mac-address vlan 20 dynamic count command to display the number of dynamic entries for VLAN 20. If you do not specify an entry attribute, the command displays the number of entries in the MAC address table. If you do not specify this keyword, the command displays detailed information about the specified MAC address entries.

Usage guidelines

A MAC address entry includes a destination MAC address, an outgoing interface, and a VLAN ID.

If you do not specify any parameters, the command displays all MAC address entries.

This command displays dynamic MAC address entries for an aggregate interface only when the aggregate interface has at least one Selected member port.

Examples

# Display MAC address entries for VLAN 100.

<Sysname> display mac-address vlan 100
MAC Address      VLAN ID    State            Port/NickName            Aging
0001-0101-0101   100        Multiport        XGE1/0/1                   N
                                             XGE1/0/2
0033-0033-0033   100        Blackhole        N/A                        N
0000-0000-0002   100        Static           XGE1/0/3                   N
00e0-fc00-5829   100        Learned          XGE1/0/4                   Y

# Display the number of MAC address entries.

<Sysname> display mac-address count
1 mac address(es) found.

Table 15: Command output

Field	Description
VLAN ID	ID of the VLAN to which the outgoing interface of the MAC address entry belongs.
State	MAC address entry state: Static—Static MAC address entry. Learned—Dynamic MAC address entry. Dynamic entries can be learned or manually configured. Blackhole—Blackhole MAC address entry. Multiport—Multiport unicast MAC address entry.
Port/NickName	When the field displays an interface name, the field indicates the outgoing interface for packets that are destined for the MAC address. This field displays N/A for a blackhole MAC address entry. When the field displays a 16-bit number Nickname in hexadecimal format (for example, 0x12ab), it indicates the RB through which the packets leave the TRILL network. For information about RBs and TRILL, see TRILL Configuration Guide.
Aging	Whether the entry can age out: Y—The entry can age out. N—The entry never ages out.
n mac address(es) found	Number of matching MAC address entries.

Related commands

mac-address

mac-address timer

prev	up	next
MAC address table commands	home	display mac-address nickname