Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 

show ethernet-switching table

 

List of Syntax

Syntax (QFX Series, QFabric, NFX Series and EX4600)

Syntax (EX Series)

Syntax (EX Series, MX Series and QFX Series)

Syntax (SRX Series)

Syntax (QFX Series, QFabric, NFX Series and EX4600)

Syntax (EX Series)

Syntax (EX Series, MX Series and QFX Series)

Syntax (SRX Series)

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.

Command 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).

Description

Displays the Ethernet switching table.

(MX Series routers,EX Series switches only) Displays Layer 2 MAC address information.

Options

For QFX Series, QFabric, NFX Series and EX4600:

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.

For EX Series, MX Series and QFX Series:

noneDisplay 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 SRX Series:

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

  • brief | detail | extensive—(Optional) Display the specified level of output.

  • interface-name—(Optional) Display the Ethernet switching table for a specific interface.

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

List of Sample Output

show ethernet-switching table (Enhanced Layer 2 Software on QFX Series, QFabric, NFX Series and EX460)

show ethernet-switching table (QFX Series, QFabric, NFX Series and EX460)

show ethernet-switching table (Private VLANs on QFX Series, QFabric, NFX Series and EX460)

show ethernet-switching table (Junos Fusion Data Center with EVPN on QFX Series switches)

show ethernet-switching table brief (QFX Series, QFabric, NFX Series and EX460)

show ethernet-switching table detail (QFX Series, QFabric, NFX Series and EX460)

show ethernet-switching table extensive (QFX Series, QFabric, NFX Series and EX460)

show ethernet-switching table interface (QFX Series, QFabric, NFX Series and EX460)

show ethernet-switching table (EX Series switches)

show ethernet-switching table brief (EX Series switches)

show ethernet-switching table detail (EX Series switches)

show ethernet-switching table extensive (EX Series switches)

show ethernet-switching table persistent-mac (EX Series switches)

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

show ethernet-switching table (EX Series, MX Series and QFX Series)

show ethernet-switching table brief

show ethernet-switching table count

show ethernet-switching table extensive

show ethernet-switching table detail (SRX Series)

show ethernet-switching table extensive (SRX Series)

show ethernet-switching table interface ge-0/0/1 (SRX Series)

Output Fields

For QFX Series, QFabric, NFX Series and EX4600:

The following table lists the output fields for the show ethernet-switching table command on QFX Series, QFabric, NFX Series and EX4600. Output fields are listed in the approximate order in which they appear.

Table 1: show ethernet-switching table Output Fields

Field Name

Field Description

Level of Output

VLAN

Name of a VLAN.

All levels

MAC address

MAC address associated with the VLAN.

All levels

Type

Type of MAC address:

  • 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.

All levels

Age

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 with the All-members option (flood entry).

All levels

Learned

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

detail, extensive

For EX Series switches:

The following table lists the output fields for the show ethernet-switching table command on EX Series switches. Output fields are listed in the approximate order in which they appear.

Table 2: show ethernet-switching table Output Fields

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).

For EX Series, MX Series and QFX Series:

The table describes the output fields for the show ethernet-switching table command on EX Series, MX Series and QFX Series. Output fields are listed in the approximate order in which they appear.

Table 3: show ethernet-switching table Output fields

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—Locally learned MAC address is configured.

Age

This field is not supported.

Logical interface

Name of the logical interface.

Active source

IP address 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 SRX Series:

Table 4 lists the output fields for the show ethernet-switching table command. Output fields are listed in the approximate order in which they appear.

Table 4: show ethernet-switching table Output Fields

Field Name

Field Description

VLAN

The name of a VLAN.

MAC address

The MAC address associated with the VLAN.

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.

Age

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

Interfaces

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

Learned

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

Sample Output

show ethernet-switching table (Enhanced Layer 2 Software on QFX Series, QFabric, NFX Series and EX460)

user@switch> show ethernet-switching table

show ethernet-switching table (QFX Series, QFabric, NFX Series and EX460)

user@switch> show ethernet-switching table

show ethernet-switching table (Private VLANs on QFX Series, QFabric, NFX Series and EX460)

user@switch> show ethernet-switching table

show ethernet-switching table (Junos Fusion Data Center with EVPN on QFX Series switches)

user@switch> show ethernet-switching table

show ethernet-switching table brief (QFX Series, QFabric, NFX Series and EX460)

user@switch> show ethernet-switching table brief

show ethernet-switching table detail (QFX Series, QFabric, NFX Series and EX460)

user@switch> show ethernet-switching table detail

show ethernet-switching table extensive (QFX Series, QFabric, NFX Series and EX460)

user@switch> show ethernet-switching table extensive

show ethernet-switching table interface (QFX Series, QFabric, NFX Series and EX460)

user@switch> show ethernet-switching table interface xe-0/0/1

show ethernet-switching table (EX Series switches)

user@switch> show ethernet-switching table

show ethernet-switching table brief (EX Series switches)

user@switch> show ethernet-switching table brief

show ethernet-switching table detail (EX Series switches)

user@switch> show ethernet-switching table detail

show ethernet-switching table extensive (EX Series switches)

user@switch> show ethernet-switching table extensive

show ethernet-switching table persistent-mac (EX Series switches)

user@switch> show ethernet-switching table persistent-mac

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

show ethernet-switching table (EX Series, MX Series and QFX Series)

user@host> show ethernet-switching table

show ethernet-switching table brief

user@host> show ethernet-switching table brief

show ethernet-switching table count

user@host> show ethernet-switching table count

show ethernet-switching table extensive

user@host> show ethernet-switching table extensive

Sample Output

show ethernet-switching table detail (SRX Series)

user@host> show ethernet-switching table detail

Sample Output

show ethernet-switching table extensive (SRX Series)

user@host> show ethernet-switching table extensive

Sample Output

show ethernet-switching table interface ge-0/0/1 (SRX Series)

user@host> show ethernet-switching table interface ge-0/0/1