show interfaces mac-database (Gigabit Ethernet)

(M-series, T-series, and MX-series routing platforms only) Display media access control (MAC) address information for the specified Gigabit Ethernet 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.

mac-address mac-address — (Optional) Display detailed MAC address statistics, including policer information.

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

List of Sample Output

Output Fields

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

Field Name	Field Description
Physical Interface
Physical interface	Name of the physical interface.
Enabled	State of the physical interface. Possible values are described in Enabled Field.
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.
Device flags	Information about the physical device. Possible values are described in Device Flags.
Interface flags	Information about the interface. Possible values are described in Interface Flags.
Link flags	Information about the link. Possible values are described in Link Flags.
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 Logical Interface Flags).
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 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.

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

user@host> show interfaces mac-database ge-5/0/1

Physical interface: ge-5/0/1, Enabled, Physical link is Down
  Interface index: 161, SNMP ifIndex: 59
  Description: horseshoe ge-2/2/1
  Link-level type: Ethernet, MTU: 1514, Speed: 1000mbps, Loopback: Disabled, Source filtering: Disabled,
  Flow control: Enabled
  Device flags   : Present Running Down
  Interface flags: Hardware-Down SNMP-Traps 16384
  Link flags     : None
  
  Logical interface ge-5/0/1.0 (Index 68) (SNMP ifIndex 67) 
    Flags: Device-Down SNMP-Traps Encapsulation: ENET2
  MAC address        Input frames    Input bytes  Output frames   Output bytes
  00:00:20:00:00:01             0              0              0              0
  00:00:20:00:00:02             0              0              0              0
  00:00:20:00:00:03             0              0              0              0
  00:00:20:00:00:05             0              0              0              0
  Number of MAC addresses : 4

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

user@host> show interfaces mac-database ge-5/0/1.0

Logical interface ge-5/0/1.0 (Index 68) (SNMP ifIndex 67) 
    Flags: Device-Down SNMP-Traps Encapsulation: ENET2
  MAC address        Input frames    Input bytes  Output frames   Output bytes
  00:00:20:00:00:01             0              0              0              0
  00:00:20:00:00:02             0              0              0              0
  00:00:20:00:00:03             0              0              0              0
  00:00:20:00:00:05             0              0              0              0

show interfaces mac-database mac-address

user@host> show interfaces mac-database ge-1/2/0
mac-address   	aa:bb:cc:dd:e0:00

Physical interface: ge-1/2/0, Enabled, Physical link is Up
  Interface index: 142, SNMP ifIndex: 32
  Link-level type: Ethernet, MTU: 1514, Speed: 1000mbps, Loopback: Disabled,
  Source filtering: Disabled, Flow control: Enabled
  Device flags   : Present Running
  Interface flags: SNMP-Traps 16384
  Link flags     : None

  Logical interface ge-1/2/0.0 (Index 68) (SNMP ifIndex 56) 
    Flags: SNMP-Traps 16384 Encapsulation: ENET2
  MAC address: aa:bb:cc:dd:e0:00, Type: Configured,
    Input bytes     : 0
    Output bytes    : 0
    Input frames    : 0
    Output frames   : 0
  Policer statistics:    
  Policer type      Discarded frames    Discarded bytes
  Input aggregate                  0                  0
  Output aggregate                 0                  0

Syntax

Release Information

Description