Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

show ethernet-switching table

Syntax (Products that support the Enhanced Layer 2 Software (ELS))

Syntax (Products that do not support ELS, Except MX Series Routers)

Note:

MX Series routers support the show bridge mac-table command in place of this command. For the syntax on MX Series routers, see show bridge mac-table.

Description

Displays the Ethernet switching table.

Displays Layer 2 MAC address information.

Options

For products that support ELS:

none

Display all learned Layer 2 MAC address information.

brief | count | detail | extensive | summary

(Optional) Display the specified level of output.

address

(Optional) Display the specified learned Layer 2 MAC address information.

instance instance-name

(Optional) Display learned Layer 2 MAC addresses for the specified routing instance.

interface interface-name

(Optional) Display learned Layer 2 MAC addresses for the specified interface.

isid isid

(Optional) Display learned Layer 2 MAC addresses for the specified ISID.

logical-system logical-system-name

(Optional) Display Ethernet-switching statistics information for the specified logical system.

persistent-learning (interface interface-name | mac mac-address)

(Optional) Display dynamically learned MAC addresses that are retained despite device restarts and interface failures for a specified interface, or information about a specified MAC address.

vlan-id (all-vlan | vlan-id)

(Optional) Display learned Layer 2 MAC addresses for all VLANs or for the specified VLAN.

vlan-name (all | vlan-name)

(Optional) Display learned Layer 2 MAC addresses for all VLANs or for the specified VLAN.

For products that do not support ELS:

none

(Optional) Display brief information about the Ethernet switching table.

brief | detail | extensive | summary

(Optional) Display the specified level of output.

interface interface-name

(Optional) Display the Ethernet switching table for a specific interface.

management-vlan

(Optional) Display the Ethernet switching table for a management VLAN.

persistent-mac <interface interface-name>

(Optional) Display the persistent MAC addresses learned for all interfaces or a specified interface. You can use this command to view entries that you want to clear for an interface that you intentionally disabled.

sort-by (name | tag)

(Optional) Display VLANs in ascending order of VLAN IDs or VLAN names.

vlan vlan-name

(Optional) Display the Ethernet switching table for a specific VLAN.

Additional Information

When Layer 2 protocol tunneling is enabled, the tunneling MAC address 01:00:0c:cd:cd:d0 is installed in the MAC table. When the Cisco Discovery Protocol (CDP), Spanning Tree Protocol (STP), or VLAN Trunk Protocol (VTP) is configured for Layer 2 protocol tunneling on an interface, the corresponding protocol MAC address is installed in the MAC table.

Required Privilege Level

view

Output Fields

For products that support ELS: The table describes the output fields for the show ethernet-switching table command on products that support ELS. Output fields are listed in the approximate order in which they appear.

Table 1: show ethernet-switching table Output fields on Products That Support ELS

Field Name

Field Description

Routing instance

Name of the routing instance.

VLAN name

Name of the VLAN.

MAC address

MAC address or addresses learned on a logical interface.

MAC flags

Status of MAC address learning properties for each interface:

  • S—Static MAC address is configured.

  • D—Dynamic MAC address is configured.

  • L—Locally learned MAC address is configured.

  • SE—MAC accounting is enabled.

  • NM—Non-configured MAC.

  • R—Remote PE MAC address is configured.

  • O—OVSDB learned MAC address is configured.

  • B—Blocked duplicate MAC address.

Age

This field is not supported.

Logical interface

Name of the logical interface.

Name of the VTEP logical interface learned over remote VTEP.

GBP Tag

Assigned Group Based Policy (GBP) from 1 through 65535.

SVLBNH/VENH Index

Note:

This field appears on QFX5XXX switches that support dynamic load balancing in an EVPN-VXLAN network.

Next-hop index number associated with the MAC address of a multihomed remote device in an EVPN-VXLAN network. This index number appears when the Logical Interface column displays esi.nnnn. The index number can be an SVLBNH, a VENH, or a remote virtual tunnel endpoint (VTEP). To get more information about SVLBNHs, VENHs, and remote VTEPs, see show ethernet-switching vxlan-tunnel-end-point svlbnh.

Active source

IP address or Ethernet segment identifier (ESI) of remote entity on which MAC address is learned.

MAC count

Number of MAC addresses learned on the specific routing instance or interface.

Learning interface

Name of the logical interface on which the MAC address was learned.

Learning VLAN

VLAN ID of the routing instance or VLAN in which the MAC address was learned.

Layer 2 flags

Debugging flags signifying that the MAC address is present in various lists.

Epoch

Spanning-tree-protocolepoch number identifying when the MAC address was learned. Used for debugging.

Sequence number

Sequence number assigned to this MAC address. Used for debugging.

Learning mask

Mask of the Packet Forwarding Engines where this MAC address was learned. Used for debugging.

IPC generation

Creation time of the logical interface when this MAC address was learned. Used for debugging.

For products that do not support ELS: The following table lists the output fields for the show ethernet-switching table command on products that do not support ELS. Output fields are listed in the approximate order in which they appear.

Table 2: show ethernet-switching table Output Fields on Products That Do Not Support ELS

Field Name

Field Description

Level of Output

VLAN

The name of a VLAN.

All levels

Tag

The VLAN ID tag name or number.

extensive

MAC or MAC address

The MAC address associated with the VLAN.

All levels

Type

The type of MAC address. Values are:

  • static—The MAC address is manually created.

  • learn—The MAC address is learned dynamically from a packet's source MAC address.

  • flood—The MAC address is unknown and flooded to all members.

  • persistent—The learned MAC addresses that will persist across restarts of the switch or interface-down events.

All levels except persistent-mac

Type

The type of MAC address. Values are:

  • installed—addresses that are in the Ethernet switching table.

  • uninstalled—addresses that could not be installed in the table or were uninstalled in an interface-down event and will be reinstalled in the table when the interface comes back up.

persistent-mac

Age

The time remaining before the entry ages out and is removed from the Ethernet switching table.

All levels

Interfaces

Interface associated with learned MAC addresses or All-members (flood entry).

All levels

Learned

For learned entries, the time which the entry was added to the Ethernet switching table.

detail, extensive

Nexthop index

The next-hop index number.

detail, extensive

persistent-mac

installed indicates MAC addresses that are in the Ethernet switching table and uninstalled indicates MAC addresses that could not be installed in the table or were uninstalled in an interface-down event (and will be reinstalled in the table when the interface comes back up).

Sample Output

show ethernet-switching table (Products that support ELS)

show ethernet-switching table (Products that support ELS)

show ethernet-switching table brief (Products that support ELS)

show ethernet-switching table (QFX5120-32CD, QFX5120-48Y, QFX5130-32CD, QFX5130-48C, QFXC5130-48CM, QFX5700, EX4100, and EX4400-48P devices, Blocked (B) MAC Address Field)

show ethernet-switching table count (Products that support ELS)

show ethernet-switching table extensive (Products that support ELS)

show ethernet-switching table (EX Series switches, GBP Tag field)

show ethernet-switching table (QFX Series switches, SVLBNH/VENH field)

show ethernet-switching table persistent-mac interface ge-0/0/16.0 (EX Series switches)

show ethernet-switching table (Products that do not support ELS)

show ethernet-switching table (Private VLANs on products that do not support ELS)

show ethernet-switching table detail (Products that do not support ELS)

show ethernet-switching table extensive (Products that do not support ELS)

show ethernet-switching table interface (Products that do not support ELS)

show ethernet-switching table persistent-mac (Products that do not support ELS)

show ethernet-switching table vlan-name v100 (Products that support ELS)

Release Information

Command introduced in Junos OS Release 9.0 for EX Series switches.

Command introduced in Junos OS Release 9.5 for SRX Series.

Options summary, management-vlan, and vlan vlan-name introduced in Junos OS Release 9.6 for EX Series switches.

Option sort-by and field name tag introduced in Junos OS Release 10.1 for EX Series switches.

Command introduced in Junos OS Release 11.1 for the QFX Series.

Output for private VLANs introduced in Junos OS Release 12.1 for the QFX Series.

Option persistent-mac introduced in Junos OS Release 11.4 for EX Series switches.

Command introduced in Junos OS Release 12.3R2.

ELS commands introduced in Junos OS Release 12.3R2 for EX Series switches.

Options logical-system, persistent-learning, and summary introduced in Junos OS Release 13.2X50-D10 (ELS).

Output for shared VXLAN load balancing next hop (SVLBNH) and VXLAN encapsulated next hop (VENH) introduced in Junos OS Release 20.3R1 for QFX Series switches.

Output for pseudo VTEP logical interfaces introduced in Junos OS Release 20.3R1 for QFX Series switches.

GBP Tag option introduced in Junos OS Release 22.4R1 for supported QFX5120, EX4100, EX4400, and EX4650 Series switches.