Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

TechLibrary
Navigation

show interfaces mac-database (Gigabit Ethernet)

Syntax

show interfaces mac-database (ge-fpc/pic/port | ge-fpc/pic/port.n)<mac-address mac-address>

Release Information

Command introduced before Junos OS Release 7.4.

Command introduced on PTX Series Packet Transport Routers for Junos OS Release 12.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 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

view

List of Sample Output

show interfaces mac-database (All MAC Addresses on a Port)
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.

Device flags

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

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 values 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 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 
Physical interface: xe-0/3/3, Enabled, Physical link is Up
  Interface index: 372, SNMP ifIndex: 788
  Link-level type: Ethernet, MTU: 1514, LAN-PHY mode, Speed: 10Gbps, Loopback: None, Source filtering: Disabled, Flow control: Enabled
  Device flags   : Present Running
  Interface flags: SNMP-Traps Internal: 0x4000
  Link flags     : None

  Logical interface xe-0/3/3.0 (Index 364) (SNMP ifIndex 829)
    Flags: SNMP-Traps 0x4004000 Encapsulation: ENET2
  MAC address        Input frames    Input bytes  Output frames   Output bytes
  00:00:00:00:00:00             1             56              0              0
  00:00:c0:01:01:02       7023810      323095260              0              0
  00:00:c0:01:01:03       7023810      323095260              0              0
  00:00:c0:01:01:04       7023810      323095260              0              0
  00:00:c0:01:01:05       7023810      323095260              0              0
  00:00:c0:01:01:06       7023810      323095260              0              0
  00:00:c0:01:01:07       7023810      323095260              0              0
  00:00:c0:01:01:08       7023809      323095214              0              0
  00:00:c0:01:01:09       7023809      323095214              0              0
  00:00:c0:01:01:0a       7023809      323095214              0              0
  00:00:c0:01:01:0b       7023809      323095214              0              0
  00:00:c8:01:01:02      30424784     1399540064       37448598     1722635508
  00:00:c8:01:01:03      30424784     1399540064       37448598     1722635508
  00:00:c8:01:01:04      30424716     1399536936       37448523     1722632058
  00:00:c8:01:01:05      30424789     1399540294       37448598     1722635508
  00:00:c8:01:01:06      30424788     1399540248       37448597     1722635462
  00:00:c8:01:01:07      30424783     1399540018       37448597     1722635462
  00:00:c8:01:01:08      30424783     1399540018       37448596     1722635416
  00:00:c8:01:01:09       8836796      406492616        8836795      406492570
  00:00:c8:01:01:0a      30424712     1399536752       37448521     1722631966
  00:00:c8:01:01:0b      30424715     1399536890       37448523     1722632058
  Number of MAC addresses : 21

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

user@host> show interfaces mac-database xe-0/3/3 
Logical interface xe-0/3/3.0 (Index 364) (SNMP ifIndex 829)
    Flags: SNMP-Traps 0x4004000 Encapsulation: ENET2
  MAC address        Input frames    Input bytes  Output frames   Output bytes
  00:00:00:00:00:00             1             56              0              0
  00:00:c0:01:01:02       7023810      323095260              0              0
  00:00:c0:01:01:03       7023810      323095260              0              0
  00:00:c0:01:01:04       7023810      323095260              0              0
  00:00:c0:01:01:05       7023810      323095260              0              0
  00:00:c0:01:01:06       7023810      323095260              0              0
  00:00:c0:01:01:07       7023810      323095260              0              0
  00:00:c0:01:01:08       7023809      323095214              0              0
  00:00:c0:01:01:09       7023809      323095214              0              0
  00:00:c0:01:01:0a       7023809      323095214              0              0
  00:00:c0:01:01:0b       7023809      323095214              0              0
  00:00:c8:01:01:02      31016568     1426762128       38040381     1749857526
  00:00:c8:01:01:03      31016568     1426762128       38040382     1749857572
  00:00:c8:01:01:04      31016499     1426758954       38040306     1749854076
  00:00:c8:01:01:05      31016573     1426762358       38040381     1749857526
  00:00:c8:01:01:06      31016573     1426762358       38040381     1749857526
  00:00:c8:01:01:07      31016567     1426762082       38040380     1749857480
  00:00:c8:01:01:08      31016567     1426762082       38040379     1749857434
  00:00:c8:01:01:09       9428580      433714680        9428580      433714680
  00:00:c8:01:01:0a      31016496     1426758816       38040304     1749853984
  00:00:c8:01:01:0b      31016498     1426758908       38040307     1749854122

show interfaces mac-database mac-address

user@host> show interfaces mac-database xe-0/3/3 mac-address 00:00:c8:01:01:09 
Physical interface: xe-0/3/3, Enabled, Physical link is Up
  Interface index: 372, SNMP ifIndex: 788
  Link-level type: Ethernet, MTU: 1514, LAN-PHY mode, Speed: 10Gbps, Loopback: None, Source filtering: Disabled, Flow control: Enabled
  Device flags   : Present Running
  Interface flags: SNMP-Traps Internal: 0x4000
  Link flags     : None

  Logical interface xe-0/3/3.0 (Index 364) (SNMP ifIndex 829)
    Flags: SNMP-Traps 0x4004000 Encapsulation: ENET2
  MAC address: 00:00:c8:01:01:09, Type: Configured,
    Input bytes     : 202324652
    Output bytes    : 202324560
    Input frames    : 4398362
    Output frames   : 4398360
  Policer statistics:
  Policer type      Discarded frames    Discarded bytes
  Output aggregate           3992386          183649756

Published: 2013-08-29

Supported Platforms

Published: 2013-08-29

Previous Page Next Page