show interfaces mac-database

Syntax

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`/`port`	Display MAC addresses that have been learned on all logical interfaces on a particular physical interface.
ge-`fpc`/`pic`/`port`.`n`	Display MAC addresses that have been learned on a particular logical interface.
ae`x`	Display MAC addresses that have been learned on a particular aggregated Ethernet interface.
xe-`fpc`/`pic`/`port`	Display MAC addresses that have been learned on all logical interfaces on a particular physical interface.
xe-`fpc`/`pic`/`port.n`	Display MAC addresses that have been learned on a particular logical interface.
et-`fpc`/`pic`/`port`	Display MAC addresses that have been learned on all logical interfaces on a particular physical interface.
et-`fpc`/`pic`/`port.n`	Display 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

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)
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
show interfaces mac-database (Physical interface)
show interfaces mac-database (Logical interface)
show interfaces mac-database (Aggregated Ethernet)