Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 

show interfaces xe

 

List of Syntax

Syntax (QFX Series)

Syntax (EX Series)

Syntax (QFX Series)

Syntax (EX Series)

Release Information

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

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

Command introduced in Junos OS Release 14.1X53-D20 for the OCX Series.

Description

Display status information about the specified 10-Gigabit Ethernet interface. This command does not display statistics for routed VLAN interfaces.

Note

You must have a transceiver plugged into an SFP+ or an XFP port before information about the interface can be displayed.

Note

On an EX Series switch, the traffic statistics for a LAG might vary slightly from the cumulative traffic statistics of the member interfaces of the LAG. This difference is more likely to be seen when the traffic is bursty in nature, and because the statistics are not fetched from the LAG and the members in the same instant. For accurate traffic statistics for a LAG, use the aggregated Ethernet counters.

Options

device-name:type-fpc/pic/port(QFabric systems only) The device name is either the serial number or the alias of the QFabric system component, such as a Node device, Interconnect device, or QFabric infrastructure. The name must contain a maximum of 128 characters and not contain any colons.
brief | detail | extensive | terse(Optional) (QFX Series) Display the specified level of output.
descriptions(Optional) (QFX Series) Display interface description strings.
media(Optional) (QFX Series) Display media-specific information about network interfaces.
routing-instance (all | instance-name)(Optional) (QFX Series) Display the name of an individual routing instance or display all routing instances.
snmp-index snmp-index(Optional) (QFX Series) Display information for the specified SNMP index of the interface.
statistics(Optional) (QFX Series) Display static interface statistics.
xe-fpc/pic/port (EX Series) Display standard information about the specified 10-Gigabit Ethernet interface.
brief | detail | extensive | terse(Optional) (EX Series) Display the specified level of output.
media(Optional) (EX Series) Display media-specific information about network interfaces. For 10-Gigabit Ethernet interfaces, using the media option does not provide you with new or additional information. The output is the same as when the media option is not used.
statistics(Optional) (EX Series) Display static interface statistics. For 10-Gigabit Ethernet interfaces, using the statistics option does not provide you with new or additional information. The output is the same as when the statistics option is not used.

Required Privilege Level

view

List of Sample Output

show interfaces

show interfaces (Asymmetric Flow Control)

show interfaces brief

show interfaces detail

show interfaces detail (Asymmetric Flow Control)

show interfaces extensive

show interfaces extensive (Asymmetric Flow Control)

show interfaces terse

show interfaces (QFabric System)

Output Fields

Table 1 lists the output fields for the show interfaces xe command. Output fields are listed in the approximate order in which they appear.

Table 1: show interfaces xe Output Fields

Field Name

Field Description

Level of Output

Physical Interface 

Physical interface

Name of the physical interface.

All levels

Enabled

State of the interface.

All levels

Interface index

Index number of the physical interface, which reflects its initialization sequence.

detail extensive none

SNMP ifIndex

SNMP index number for the physical interface.

detail extensive none

Generation

Unique number for use by Juniper Networks technical support only.

detail extensive

Link-level type

Encapsulation being used on the physical interface.

All levels

MTU

Maximum transmission unit size on the physical interface.

All levels

Speed

Speed at which the interface is running.

All levels

Duplex

Duplex mode of the interface, either Full-Duplex or Half-Duplex.

All levels

Loopback

Loopback status: Enabled or Disabled. If loopback is enabled, type of loopback: Local or Remote.

All levels

Source filtering

Source filtering status: Enabled or Disabled.

All levels

LAN-PHY mode

10-Gigabit Ethernet interface operating in Local Area Network Physical Layer Device (LAN PHY) mode. LAN PHY allows 10-Gigabit Ethernet wide area links to use existing Ethernet applications.

All levels

Unidirectional

Unidirectional link mode status for 10-Gigabit Ethernet interface: Enabled or Disabled for parent interface; Rx-only or Tx-only for child interfaces.

All levels

Flow control

Flow control status: Enabled or Disabled.

Note: This field is only displayed if asymmetric flow control is not configured.

All levels

Configured-flow-

control

Configured flow control for the interface transmit buffers (tx-buffers) and receive buffers (rx-buffers):

  • tx-buffersOn if the interface is configured to respond to Ethernet PAUSE messages received from the connected peer.

    Off if the interface is not configured to respond to received PAUSE messages.

  • rx-buffersOn if the interface is configured to generate and send Ethernet PAUSE messages to the connected peer.

    Off if the interface is not configured to generate and send PAUSE messages.

Note: This field is only displayed if asymmetric flow control is configured.

All levels

Auto-negotiation

Autonegotiation status: Enabled or Disabled.

All levels

Remote-fault

Remote fault status:

  • Online—Autonegotiation is manually configured as online.

  • Offline—Autonegotiation is manually configured as offline.

All levels

Device flags

Information about the physical device.

All levels

Interface flags

Information about the interface.

All levels

Link flags

Information about the link.

All levels

Wavelength

Configured wavelength, in nanometers (nm).

All levels

Frequency

Frequency associated with the configured wavelength, in terahertz (THz).

All levels

CoS queues

Number of CoS queues configured.

detail extensive none

Schedulers

Number of CoS schedulers configured.

extensive

Hold-times

Current interface hold-time up and hold-time down, in milliseconds.

detail extensive

Current address

Configured MAC address.

detail extensive none

Hardware address

Hardware MAC address.

detail extensive none

Last flapped

Date, time, and how long ago the interface went from down to up. The format is Last flapped: year-month-day hour: :minute:second:timezone (hour:minute:second ago). For example, Last flapped: 2008–01–16 10:52:40 UTC (3d 22:58 ago).

detail extensive none

Input Rate

Input rate in bits per second (bps) and packets per second (pps).

None specified

Output Rate

Output rate in bps and pps.

None specified

Statistics last cleared

Time when the statistics for the interface were last set to zero.

detail extensive

Traffic statistics

Number and rate of bytes and packets received and transmitted on the physical interface.

  • Input bytes—Number of bytes received on the interface.

  • Output bytes—Number of bytes transmitted on the interface.

  • Input packets—Number of packets received on the interface.

  • Output packets—Number of packets transmitted on the interface.

Note: The bandwidth bps counter is not enabled.

detail extensive

Input errors

Input errors on the interface. The following paragraphs explain the counters whose meaning might not be obvious:

  • Errors—Sum of the incoming frame aborts and FCS errors.

  • Drops—Number of packets dropped by the input queue of the I/O Manager ASIC. If the interface is saturated, this number increments once for every packet that is dropped by the ASIC's RED mechanism.

  • Framing errors—Number of packets received with an invalid frame checksum (FCS).

  • Runts—Number of frames received that are smaller than the runt threshold.

  • Policed discards—Number of frames that the incoming packet match code discarded because they were not recognized or not of interest. Usually, this field reports protocols that Junos OS does not handle.

  • L3 incompletes—Number of incoming packets discarded because they failed Layer 3 sanity checks of the header. For example, a frame with less than 20 bytes of available IP header is discarded. L3 incomplete errors can be ignored if you configure the ignore-l3-incompletes statement.

  • L2 channel errors—Number of times the software did not find a valid logical interface for an incoming frame.

  • L2 mismatch timeouts—Number of malformed or short packets that caused the incoming packet handler to discard the frame as unreadable.

  • FIFO errors—Number of FIFO errors in the receive direction that are reported by the ASIC on the PIC. If this value is ever nonzero, the PIC is probably malfunctioning.

  • Resource errors—Sum of transmit drops.

extensive

Output errors

Output errors on the interface. The following paragraphs explain the counters whose meaning might not be obvious:

  • Carrier transitions—Number of times the interface has gone from down to up. This number does not normally increment quickly, increasing only when the cable is unplugged, the far-end system is powered down and then up, or another problem occurs. If the number of carrier transitions increments quickly (perhaps once every 10 seconds), the cable, the far-end system, or the PIC or PIM is malfunctioning.

  • Errors—Sum of the outgoing frame aborts and FCS errors.

  • Drops—Number of packets dropped by the output queue of the I/O Manager ASIC. If the interface is saturated, this number increments once for every packet that is dropped by the ASIC's RED mechanism.

  • Collisions—Number of Ethernet collisions. The Gigabit Ethernet PIC supports only full-duplex operation, so for Gigabit Ethernet PICs, this number should always remain 0. If it is nonzero, there is a software bug.

  • Aged packets—Number of packets that remained in shared packet SDRAM so long that the system automatically purged them. The value in this field should never increment. If it does, it is most likely a software bug or possibly malfunctioning hardware.

  • FIFO errors—Number of FIFO errors in the send direction as reported by the ASIC on the PIC. If this value is ever nonzero, the PIC is probably malfunctioning.

  • HS link CRC errors—Number of errors on the high-speed links between the ASICs responsible for handling the router interfaces.

  • MTU errors—Number of packets whose size exceeded the MTU of the interface.

  • Resource errors—Sum of transmit drops.

extensive

Egress queues

Total number of egress queues supported on the specified interface.

detail extensive

Queue counters (Egress)

CoS queue number and its associated user-configured forwarding class name.

  • Queued packets—Number of queued packets.

  • Transmitted packets—Number of transmitted packets.

  • Dropped packets—Number of packets dropped by the ASIC's RED mechanism.

detail extensive

Queue Number

The CoS queue number and the forwarding classes mapped to the queue number. The Mapped forwarding class column lists the forwarding classes mapped to each CoS queue.

detail extensive

Ingress queues

Total number of ingress queues supported on the specified interface.

extensive

Queue counters (Ingress)

CoS queue number and its associated user-configured forwarding class name.

  • Queued packets—Number of queued packets.

  • Transmitted packets—Number of transmitted packets.

  • Dropped packets—Number of packets dropped by the ASIC's RED mechanism.

extensive

Active alarms and Active defects

Ethernet-specific defects that can prevent the interface from passing packets. When a defect persists for a certain amount of time, it is promoted to an alarm. Based on the switch configuration, an alarm can ring the red or yellow alarm bell on the switch, or turn on the red or yellow alarm LED on the craft interface. These fields can contain the value None or Link.

  • None—There are no active defects or alarms.

  • Link—Interface has lost its link state, which usually means that the cable is unplugged, the far-end system has been turned off, or the PIC is malfunctioning.

detail extensive none

PCS statistics

Physical Coding Sublayer (PCS) fault conditions from the LAN PHY device.

detail extensive

MAC statistics

Receive and Transmit statistics reported by the PIC's MAC subsystem.

  • Total octets and total packets—Total number of octets and packets. For Gigabit Ethernet IQ PICs, the received octets count varies by interface type.

  • Unicast packets, Broadcast packets, and Multicast packets—Number of unicast, broadcast, and multicast packets.

  • CRC/Align errors—Total number of packets received that had a length (excluding framing bits, but including FCS octets) of between 64 and 1518 octets, inclusive, and had either a bad FCS with an integral number of octets (FCS Error) or a bad FCS with a nonintegral number of octets (Alignment Error).

  • FIFO error—Number of FIFO errors that are reported by the ASIC on the PIC. If this value is ever nonzero, the PIC is probably malfunctioning.

  • MAC control frames—Number of MAC control frames.

  • MAC pause frames—Number of MAC control frames with pause operational code.

  • Oversized frames—Number of packets that exceeds the configured MTU.

  • Jabber frames—Number of frames that were longer than 1518 octets (excluding framing bits, but including FCS octets), and had either an FCS error or an alignment error. This definition of jabber is different from the definition in IEEE-802.3 section 8.2.1.5 (10BASE5) and section 10.3.1.4 (10BASE2). These documents define jabber as the condition in which any packet exceeds 20 ms. The allowed range to detect jabber is from 20 ms to 150 ms.

  • Fragment frames—Total number of packets that were less than 64 octets in length (excluding framing bits, but including FCS octets), and had either an FCS error or an alignment error. Fragment frames normally increment because both runts (which are normal occurrences caused by collisions) and noise hits are counted.

  • VLAN tagged frames—Number of frames that are VLAN tagged. The system uses the TPID of 0x8100 in the frame to determine whether a frame is tagged or not. This counter is not supported on EX Series switches and is always displayed as 0.

  • Code violations—Number of times an event caused the PHY to indicate “Data reception error” or “invalid data symbol error.”

extensive

Filter statistics

Receive and Transmit statistics reported by the PIC's MAC address filter subsystem.

extensive

Autonegotiation information

Information about link autonegotiation.

  • Negotiation status:

    • Incomplete—Ethernet interface has the speed or link mode configured.

    • No autonegotiation—Remote Ethernet interface has the speed or link mode configured, or does not perform autonegotiation.

    • Complete—Ethernet interface is connected to a device that performs autonegotiation and the autonegotiation process is successful.

  • Link partner statusOK when the Ethernet interface is connected to a device that performs autonegotiation and the autonegotiation process is successful.

  • Link partner:

    • Link mode—Depending on the capability of the attached Ethernet device, either Full-duplex or Half-duplex.

    • Flow control—Types of flow control supported by the remote Ethernet device. For Fast Ethernet interfaces, the type is None. For Gigabit Ethernet interfaces, types are Symmetric (link partner supports PAUSE on receive and transmit), Asymmetric (link partner supports PAUSE on transmit), and Symmetric/Asymmetric (link partner supports both PAUSE on receive and transmit or only PAUSE receive).

    • Remote fault—Remote fault information from the link partner—Failure indicates a receive link error. OK indicates that the link partner is receiving. Negotiation error indicates a negotiation error. Offline indicates that the link partner is going offline.

  • Local resolution:

    • Flow control—Types of flow control supported by the remote Ethernet device. For Gigabit Ethernet interfaces, types are Symmetric (link partner supports PAUSE on receive and transmit), Asymmetric (link partner supports PAUSE on transmit), and Symmetric/Asymmetric (link partner supports both PAUSE on receive and transmit or only PAUSE receive).

      For asymmetric PAUSE, shows if the PAUSE transmit and PAUSE receive states on the interface are enable or disable.

    • Remote fault—Remote fault information. Link OK (no error detected on receive), Offline (local interface is offline), and Link Failure (link error detected on receive).

extensive

Packet Forwarding Engine configuration

Information about the configuration of the Packet Forwarding Engine:

  • Destination slot—FPC slot number.

  • CoS transmit queue—Queue number and its associated user-configured forwarding class name.

  • Bandwidth %—Percentage of bandwidth allocated to the queue.

  • Bandwidth bps—Bandwidth allocated to the queue (in bps).

  • Buffer %—Percentage of buffer space allocated to the queue.

  • Buffer usec—Amount of buffer space allocated to the queue, in microseconds. This value is nonzero only if the buffer size is configured in terms of time.

  • Priority—Queue priority: low or high.

  • Limit—Displayed if rate limiting is configured for the queue. Possible values are none and exact. If exact is configured, the queue transmits only up to the configured bandwidth, even if excess bandwidth is available. If none is configured, the queue transmits beyond the configured bandwidth if bandwidth is available.

extensive

Logical Interface  

Logical interface

Name of the logical interface.

All levels

Index

Index number of the logical interface, which reflects its initialization sequence.

detail extensive none

SNMP ifIndex

SNMP interface index number for the logical interface.

detail extensive none

Generation

Unique number for use by Juniper Networks technical support only.

detail extensive

Flags

Information about the logical interface.

All levels

Encapsulation

Encapsulation on the logical interface.

All levels

Protocol

Protocol family.

detail extensive none

Traffic statistics

Number and rate of bytes and packets received (input) and transmitted (output) on the specified interface.

detail extensive

IPv6 transit statistics

If IPv6 statics tracking is enabled, number of IPv6 bytes and packets received and transmitted on the logical interface.

extensive

Local statistics

Number and rate of bytes and packets destined to and from the switch.

extensive

Transit statistics

Number and rate of bytes and packets transiting the switch.

extensive

Generation

Unique number for use by Juniper Networks technical support only.

detail extensive

Route Table

Route table in which the logical interface address is located. For example, 0 refers to the routing table inet.0.

detail extensive none

Input Filters

Names of any input filters applied to this interface.

detail extensive

Output Filters

Names of any output filters applied to this interface.

detail extensive

Flags

Information about protocol family flags.

If unicast Reverse Path Forwarding (uRPF) is explicitly configured on the specified interface, the uRPF flag appears. If uRPF was configured on a different interface (and therefore is enabled on all switch interfaces) but was not explicitly configured on the specified interface, the uRPF flag does not appear even though uRPF is enabled.

detail extensive

Addresses, Flags

Information about the address flags.

detail extensive none

protocol-family

Protocol family configured on the logical interface. If the protocol is inet, the IP address of the interface is also displayed.

brief

Flags

Information about the address flag.

detail extensive none

Destination

IP address of the remote side of the connection.

detail extensive none

Local

IP address of the logical interface.

detail extensive none

Broadcast

Broadcast address of the logical interlace.

detail extensive none

Generation

Unique number for use by Juniper Networks technical support only.

detail extensive

Sample Output

show interfaces

user@switch> show interfaces xe-0/0/1

show interfaces (Asymmetric Flow Control)

user@switch> show interfaces xe-0/0/1

show interfaces brief

user@switch> show interfaces xe-0/0/1 brief

show interfaces detail

user@switch> show interfaces xe-0/0/1 detail

show interfaces detail (Asymmetric Flow Control)

user@switch> show interfaces xe-0/0/1 detail

show interfaces extensive

user@switch> show interfaces xe-0/0/1 extensive

show interfaces extensive (Asymmetric Flow Control)

user@switch> show interfaces xe-0/0/1 extensive

show interfaces terse

user@switch> show interfaces xe-0/0/1 terse

show interfaces (QFabric System)

user@switch> show interfaces node1:xe-0/0/0