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

mdc-admin

mdc-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 a minimum of one Selected member port.

Multiport unicast MAC address entries have no impact on the MAC address learning. When receiving a frame whose source MAC address matches a multiport unicast entry, the device can still learn the MAC address of the frame and generate a dynamic entry. However, the generated dynamic entry has lower priority. The device prefers to use the multiport unicast entry to forward frames destined for the MAC address in the entry.

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 1: 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.

  • OpenFlow—MAC address entry for an OpenFlow instance.

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.

Aging

Whether the entry can age out:

  • Y—The entry can age out.

  • N—The entry never ages out.

mac address(es) found

Number of matching MAC address entries.

Related commands

mac-address

mac-address timer