Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 

show interfaces mac-database

 

Syntax

Release Information

Command introduced before Junos OS Release 7.4.

Command introduced on PTX Series Packet Transport Routers for Junos OS Release 12.1.

Support for statement with the aex option introduced in Junos OS Release 15.1.

Description

(M Series, T Series, MX Series routers, and PTX Series Packet Transport Routers only) Display media access control (MAC) address information for the specified interface.

Options

ge-fpc/pic/portDisplay MAC addresses that have been learned on all logical interfaces on a particular physical interface.
ge-fpc/pic/port.nDisplay MAC addresses that have been learned on a particular logical interface.
aexDisplay MAC addresses that have been learned on a particular aggregated Ethernet interface.
xe-fpc/pic/portDisplay MAC addresses that have been learned on all logical interfaces on a particular physical interface.
xe-fpc/pic/port.nDisplay MAC addresses that have been learned on a particular logical interface.
et-fpc/pic/portDisplay MAC addresses that have been learned on all logical interfaces on a particular physical interface.
et-fpc/pic/port.nDisplay MAC addresses that have been learned on a particular logical interface.
mac-address mac-address(Optional) Display detailed MAC address statistics, including policer information for ge, xe, and et interfaces.

Additional Information

On IQ2 PIC interfaces, the default value for maximum retention of entries in the MAC address table has changed, for cases in which the table is not full. The new holding time is 12 hours. The previous retention time of 3 minutes is still in effect when the table is full.

Required Privilege Level

view

List of Sample Output

show interfaces mac-database (All MAC Addresses on a Port)

show interfaces mac-database (All MAC Addresses on an Aggregated Ethernet Interface)

show interfaces mac-database (All MAC Addresses on a Service)

show interfaces mac-database mac-address

Output Fields

Table 1 lists the output fields for the show interfaces mac-database command. Output fields are listed in the approximate order in which they appear.

Table 1: show interfaces mac-database Output Fields

Field Name

Field Description

Physical Interface

Physical interface

Name of the physical interface.

Enabled

State of the physical interface. Possible values are described in the “Enabled Field” section under Common Output Fields Description.

Interface index

Physical interface index number, which reflects its initialization sequence.

SNMP ifIndex

SNMP index number for the physical interface.

Description

Description and name of the interface.

Link-level type

Encapsulation being used on the physical interface.

MTU

MTU size on the physical interface.

Speed

Speed at which the interface is running.

Loopback

Whether loopback is enabled and the type of loopback: local or remote.

Source filtering

Whether source filtering is configured.

Flow control

Whether flow control is enabled or disabled.

Minimum links needed

(Aggregated Ethernet interfaces only) Number of child links that must be operational for the aggregated interface to be operational.

Minimum bandwidth needed

(Aggregated Ethernet interfaces only) Minimum amount of bandwidth of child links that must be operational for the aggregated interface to be operational.

Device flags

Information about the physical device. Possible values are described in the “Device Flags” section under Common Output Fields Description.

Currrent address

(Aggregated Ethernet interfaces only) Configured MAC address.

Hardware address

(Aggregated Ethernet interfaces only) Hardware MAC address.

Last flapped

(Aggregated Ethernet interfaces only) Date, time, and how long ago the interface went from down to up or from up to down. The format is Last flapped: year-month-day hours:minutes:seconds timezone (wweeksddays hours:minutes ago). For example, Last flapped: 2013-12-18 04:33:22 PST (1w5d 22:23 ago).

Input Rate

(Aggregated Ethernet interfaces only) Input rate in bits per second (bps) and packets per second (pps).

Output Rate

(Aggregated Ethernet interfaces only) Output rate in bps and pps.

Interface flags

Information about the interface. Possible values are described in the “Links Flags” section under Common Output Fields Description.

Link flags

Information about the link. Possible v4alues are described in the “Device Flags” section under Common Output Fields Description.

Logical Interface

Logical interface

Name of the logical interface.

Index

Logical interface index number, which reflects its initialization sequence.

SNMP ifIndex

Logical interface SNMP interface index number.

Flags

Information about the logical interface (possible values are described in the “Logical Interface Flags” section under Common Output Fields Description.

Encapsulation

Encapsulation on the logical interface.

MAC address, Input frames, Input bytes, Output frames, Output bytes

MAC address and corresponding number of input frames, input bytes, output frames, and output bytes.

Number of MAC addresses

Number of MAC addresses configured.

Policer Statistics

(Displayed for mac-address option for ge, xe, and et interface types only) Display information about policers applied to a logical interface-MAC pair.

  • Policer type—Type of policer that is out of spec with respect to the configuration. It can be one or more of the following:

    • Input premium—Number of high-priority rating out-of-spec frames or bytes received.

    • Output premium—Number of high-priority rating out-of-spec frames or bytes sent.

    • Input aggregate—Total number of out-of-spec frames or bytes received.

    • Output aggregate—Total number of out-of-spec frames or bytes sent.

  • Discarded Frames—Number of discarded frames.

  • Discarded Bytes—Number of discarded bytes.

Sample Output

show interfaces mac-database (All MAC Addresses on a Port)

user@host> show interfaces mac-database xe-0/3/3

show interfaces mac-database (All MAC Addresses on an Aggregated Ethernet Interface)

user@host> show interfaces mac-database ae4

show interfaces mac-database (All MAC Addresses on a Service)

user@host> show interfaces mac-database xe-0/3/3

show interfaces mac-database mac-address

user@host> show interfaces mac-database xe-0/3/3 mac-address 00:00:c8:01:01:09