Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

close
keyboard_arrow_left
Junos CLI Reference
Table of Contents Expand all
list Table of Contents
file_download PDF
{ "lLangCode": "en", "lName": "English", "lCountryCode": "us", "transcode": "en_US" }
English
keyboard_arrow_right

show ethernet-switching interfaces

date_range 19-Nov-23

Syntax

content_copy zoom_out_map
show ethernet-switching interfaces
<brief | detail | summary>
<interface interface-name>

Description

Display information about switched Ethernet interfaces.

Options

none

(Optional) Display brief information for Ethernet-switching interfaces.

brief | detail | summary

(Optional) Display the specified level of output.

interface interface-name

(Optional) Display Ethernet-switching information for a specific interface.

Required Privilege Level

view

Output Fields

For QFX Series, QFabric, NFX Series, EX4600 and OCX1100:

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

Table 1: show ethernet-switching interfaces Output Fields

Field Name

Field Description

Level of Output

Interface

Name of a switching interface.

All levels

State

Interface state. Values are up or down.

none, brief, detail, summary

VLAN members

Name of a VLAN.

none, brief, detail, summary

Blocking

Forwarding state of the interface:

  • blocked—Traffic is not being forwarded on the interface.

  • unblocked—Traffic is forwarded on the interface.

  • MAC limit exceeded—The interface is temporarily disabled because of a MAC limiting error. The disabled interface is automatically restored to service when the disable timeout expires.

  • MAC move limit exceeded—The interface is temporarily disabled because of a MAC move limiting error. The disabled interface is automatically restored to service when the disable timeout expires.

  • Storm control in effect —The interface is temporarily disabled because of a storm control error. The disabled interface is automatically restored to service when the disable timeout expires.

  • Storm control shutdown in effect —The interface is temporarily disabled because of a storm control shutdown error. The disabled interface is automatically restored to service when the disable timeout expires.

none, brief, detail, summary

Index

VLAN index internal to Junos OS software.

detail

untagged | tagged

Specifies whether the interface forwards IEEE802.1Q-tagged or untagged traffic.

detail

Output fields for EX Series:

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

Table 2: show ethernet-switching interfaces Output Fields

Field Name

Field Description

Level of Output

Interface

Name of a switching interface.

none, brief, detail, summary

Index

VLAN index internal to Junos OS.

detail

State

Interface state. Values are up and down.

none, brief, detail

Port mode

The access mode is the port mode default and works with a single VLAN. Port mode can also be trunk, which accepts tagged packets from multiple VLANs on other switches. The third port mode value is tagged-access, which accepts tagged packets from access devices.

detail

Reflective Relay Status

Reflective relay allows packets to use the same interface for both upstream and downstream traffic. When reflective relay has been configured, the status displayed is always enabled . When reflective relay is not configured, this entry does not appear in the command output.

detail

Ether type for the interface

Ether type is a two-octet field in an Ethernet frame used to indicate which protocol is encapsulated in the payload of an incoming Ethernet packet. Both 802.1Q packets and Q-in-Q packets use this field. The output displayed for this particular field indicates the interface’s Ether type, which is used to match the Ether type of incoming 802.1Q packets and Q-in-Q packets. The indicated Ether type field is also added to the interface’s outgoing 802.1Q and Q-in-Q packets.

detail

VLAN membership

Names of VLANs that belong to this interface.

none, brief, detail,

Tag

Number of the 802.1Q tag.

none, brief, detail,

Tagging

Specifies whether the interface forwards 802.1Q tagged or untagged traffic.

none, brief, detail,

Blocking

The forwarding state of the interface:

  • unblocked—Traffic is forwarded on the interface.

  • blocked—Traffic is not being forwarded on the interface.

  • Disabled by bpdu control—The interface is disabled due to receiving BPDUs on a protected interface. If the disable-timeout statement has been included in the BPDU configuration, the interface automatically returns to service after the timer expires.

  • blocked by RTG—The specified redundant trunk group is disabled.

  • blocked by STP—The interface is disabled due to a spanning-tree protocol error.

  • MAC limit exceeded—The interface is temporarily disabled due to a MAC limit error. The disabled interface is automatically restored to service when the disable timeout expires.

  • MAC move limit exceeded—The interface is temporarily disabled due to a MAC move limit error. The disabled interface is automatically restored to service when the disable timeout expires.

  • Storm control in effect—The interface is temporarily disabled due to a storm control error. The disabled interface is automatically restored to service when the disable timeout expires.

none, brief, detail,

Number of MACs learned on IFL

Number of MAC addresses learned by this interface.

detail

mapping

When mapping is configured, the status is one of the following C-VLAN to S-VLAN mapping types:

  • dot1q-tunneled—The interface maps all traffic to the S-VLAN (all-in-one bundling).

  • native—The interface maps untagged and priority tagged packets to the S-VLAN.

  • push—The interface maps packets to a firewall filter to an S-VLAN.

  • policy-mapped—The interface maps packets to a specifically defined S-VLAN.

  • integer—The interface maps packets to the specified S-VLAN.

When mapping is not configured, this entry does not appear in the command output.

detail

Sample Output for QFX Series Switches, QFabric, NFX Series, EX4600 and OCX1100

show ethernet-switching interfaces

content_copy zoom_out_map
user@switch> show ethernet-switching interfaces             

Interface   State    VLAN members           Blocking 
xe-0/0/0.0  up       T1122                  unblocked
xe-0/0/1.0  down     default                — MAC limit exceeded
xe-0/0/2.0  down     default                — MAC move limit exceeded
xe-0/0/3.0  down     default                — Storm control in effect
xe-0/0/4.0  down     default                unblocked
xe-0/0/5.0  down     default                unblocked
xe-0/0/6.0  down     default                unblocked
xe-0/0/7.0  down     default                unblocked
xe-0/0/8.0  down     default                unblocked
xe-0/0/9.0  up       T111                   unblocked
xe-0/0/10.0 down     default                unblocked
xe-0/0/11.0 down     default                unblocked
xe-0/0/12.0 down     default                unblocked
xe-0/0/13.0 down     default                unblocked
xe-0/0/14.0 down     default                unblocked
xe-0/0/15.0 down     default                unblocked
xe-0/0/16.0 down     default                unblocked
xe-0/0/17.0 down     default                unblocked
xe-0/0/18.0 down     default                unblocked
xe-0/0/19.0 up       T111                   unblocked
xe-0/1/0.0  down     default                unblocked
xe-0/1/1.0  down     default                unblocked
xe-0/1/2.0  down     default                unblocked
xe-0/1/3.0  down     default                unblocked

show ethernet-switching interfaces summary

content_copy zoom_out_map
user@switch> show ethernet-switching interfaces summary             
xe-0/0/0.0
xe-0/0/1.0
xe-0/0/2.0
xe-0/0/3.0
xe-0/0/8.0
xe-0/0/10.0
xe-0/0/11.0

show ethernet-switching interfaces brief

content_copy zoom_out_map
user@switch> show ethernet-switching interfaces brief             
Interface   State    VLAN members           Blocking 
xe-0/0/0.0  down     default                unblocked
xe-0/0/1.0  down     employee-vlan          unblocked
xe-0/0/2.0  down     employee-vlan          unblocked
xe-0/0/3.0  down     employee-vlan          unblocked
xe-0/0/8.0  down     employee-vlan          unblocked
xe-0/0/10.0 down     default                unblocked
xe-0/0/11.0 down     employee-vlan          unblocked

show ethernet-switching interfaces detail

content_copy zoom_out_map
user@switch> show ethernet-switching interfaces detail             
Interface: xe-0/0/0.0 Index: 65
  State: down
  VLANs:
    default                untagged     unblocked

Interface: xe-0/0/1.0 Index: 66
  State: down
  VLANs:
    employee-vlan          untagged     unblocked

Interface: xe-0/0/2.0 Index: 67
  State: down
  VLANs:
    employee-vlan          untagged     unblocked

Interface: xe-0/0/3.0 Index: 68
  State: down
  VLANs:
    employee-vlan          untagged     unblocked

Interface: xe-0/0/8.0 Index: 69
  State: down
  VLANs:
    employee-vlan          untagged     unblocked

Interface: xe-0/0/10.0 Index: 70
  State: down
  VLANs:
    default                untagged     unblocked

Interface: xe-0/0/11.0 Index: 71
  State: down
  VLANs:
    employee-vlan          tagged       unblocked

show ethernet-switching interfaces interface-name

content_copy zoom_out_map
user@switch> show ethernet-switching interfaces xe-0/0/0.0             
 Interface   State    VLAN members           Blocking 
xe-0/0/0.0  down     default                unblocked

Sample Output for EX Series Switches

show ethernet-switching interfaces

content_copy zoom_out_map
user@switch> show ethernet-switching interfaces             

Interface    State  VLAN members        Tag   Tagging  Blocking 

ae0.0        up      default                   untagged unblocked
ge-0/0/2.0   up      vlan300            300    untagged blocked by RTG (rtggroup)
ge-0/0/3.0   up      default                            blocked by STP      
ge-0/0/4.0   down    default                            MAC limit exceeded
ge-0/0/5.0   down    default                            MAC move limit exceeded
ge-0/0/6.0   down    default                            Storm control in effect
ge-0/0/7.0   down    default                            unblocked
ge-0/0/13.0  up      default                   untagged unblocked
ge-0/0/14.0  up      vlan100             100   tagged   unblocked
                     vlan200             200   tagged   unblocked
ge-0/0/15.0  up      vlan100             100   tagged   blocked by STP
                     vlan200             200   tagged   blocked by STP
ge-0/0/16.0  down    default                   untagged unblocked
ge-0/0/17.0  down    vlan100             100   tagged   Disabled by bpdu-control
                     vlan200             200   tagged   Disabled by bpdu-control

show ethernet-switching interfaces ge-0/0/15 brief

content_copy zoom_out_map
user@switch> show ethernet-switching interfaces ge-0/0/15 brief

Interface   State  VLAN members   Tag   Tagging        Blocking

ge-0/0/15.0  up     vlan100        100   tagged         blocked by STP
                    vlan200        200   tagged         blocked by STP 

show ethernet-switching interfaces ge-0/0/2 detail (Blocked by RTG rtggroup)

content_copy zoom_out_map
user@switch> show ethernet-switching interfaces ge-0/0/2 detail             

Interface: ge-0/0/2.0, Index: 65, State: up, Port mode: Access
Ether type for the interface: 0X8100
VLAN membership:
    vlan300, 802.1Q Tag: 300, untagged, msti-id: 0, blocked by RTG(rtggroup)
Number of MACs learned on IFL: 0

show ethernet-switching interfaces ge-0/0/15 detail (Blocked by STP)

content_copy zoom_out_map
user@switch> show ethernet-switching interfaces ge-0/0/15 detail             

Interface: ge-0/0/15.0, Index: 70, State: up, Port mode: Trunk
Ether type for the interface: 0X8100
VLAN membership:
    vlan100, 802.1Q Tag: 100, tagged, msti-id: 0, blocked by STP
    vlan200, 802.1Q Tag: 200, tagged, msti-id: 0, blocked by STP

Number of MACs learned on IFL: 0

show ethernet-switching interfaces ge-0/0/17 detail (Disabled by bpdu-control)

content_copy zoom_out_map
user@switch> show ethernet-switching interfaces ge-0/0/17 detail             

Interface: ge-0/0/17.0, Index: 71, State: down, Port mode: Trunk
Ether type for the interface: 0X8100
VLAN membership:
    vlan100, 802.1Q Tag: 100, tagged, msti-id: 1, Disabled by bpdu-control
    vlan200, 802.1Q Tag: 200, tagged, msti-id: 2, Disabled by bpdu-control
Number of MACs learned on IFL: 0

show ethernet-switching interfaces detail (C-VLAN to S-VLAN Mapping)

content_copy zoom_out_map
user@switch>show ethernet-switching interfaces ge-0/0/6.0 detail
Interface: ge-0/0/6.0, Index: 73, State: up, Port mode: Access
Ether type for the interface: 0X8100
VLAN membership:
    map, 802.1Q Tag: 134, Mapped Tag: native, push, dot1q-tunneled, unblocked
    map, 802.1Q Tag: 134, Mapped Tag: 20, push, dot1q-tunneled, unblocked

show ethernet-switching interfaces detail (Reflective Relay Is Configured)

content_copy zoom_out_map
user@switch1> show ethernet-switching interfaces ge-7/0/2 detail
Interface: ge-7/0/2, Index: 66, State: down, Port mode: Tagged-access
Ether type for the interface: 0X8100
Reflective Relay Status: Enabled
Ether type for the interface: 0x8100
VLAN membership:
    VLAN_Purple VLAN_Orange VLAN_Blue, 802.1Q Tag: 450, tagged, unblocked
Number of MACs learned on IFL: 0

Release Information

Command introduced in Junos OS Release 9.0.

In Junos OS Release 9.6 for EX Series switches, the following updates were made:

  • Blocking field output was updated.

  • The default view was updated to include information about 802.1Q tags.

  • The detail view was updated to include information on VLAN mapping.

In Junos OS Release 11.1 for EX Series switches, the detail view was updated to include reflective relay information.

external-footer-nav