Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

Navigation
Guide That Contains This Content
[+] Expand All
[-] Collapse All

    show interfaces xe-

    Syntax

    show interfaces xe-fpc/pic/port <brief | detail | extensive | terse> <media> <statistics>

    Release Information

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

    Description

    Display status information about the specified 10-Gigabit Ethernet interface.

    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

    xe-fpc/pic/port

    Display standard information about the specified 10-Gigabit Ethernet interface.

    brief | detail | extensive | terse

    (Optional) Display the specified level of output.

    media

    (Optional) 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) 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 xe-4/1/0
    show interfaces xe-0/1/0 brief
    show interfaces xe-4/1/0 detail
    show interfaces xe-6/0/39 extensive

    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

    Fields for the Terse Output Level Only

    Interface

    Name of the physical or logical interface.

    terse

    Admin

    Administrative state of the interface.

    terse

    Link

    State of the physical link.

    terse

    Proto

    Protocol family configured on the logical interface.

    terse

    Local

    Local IP address of the logical interface.

    terse

    Remote

    Remote IP address of the logical interface.

    terse

    Fields for the Physical Interface  

    Physical interface

    Name of the physical interface.

    brief
    detail
    extensive
    none

    Enabled

    State of the interface. Can be one of the following:

    • Administratively down, Physical link is Down—The interface is turned off, and the physical link is inoperable and cannot pass packets even when it is enabled.
    • Administratively down, Physical link is Up—The interface is turned off, but the physical link is operational and can pass packets when it is enabled.
    • Enabled, Physical link is Down—The interface is turned on, but the physical link is inoperable and cannot pass packets.
    • Enabled, Physical link is Up—The interface is turned on, and the physical link is operational and can pass packets.

    brief
    detail
    extensive
    none

    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

    Description

    User-configured interface description.

    brief
    detail
    extensive
    none

    Link-level type

    Encapsulation being used on the physical interface.

    brief
    detail
    extensive
    none

    MTU

    Maximum transmission unit size on the physical interface.

    brief
    detail
    extensive
    none

    Speed

    Speed at which the interface is running.

    brief
    detail
    extensive
    none

    Duplex

    Duplex mode of the interface.

    brief
    detail
    extensive
    none

    BPDU Error

    Not supported on EX Series switches.

    detail
    extensive
    none

    MAC-REWRITE Error

    Not supported on EX Series switches.

    detail
    extensive
    none

    Loopback

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

    brief
    detail
    extensive
    none

    Source filtering

    Source filtering status: Enabled or Disabled.

    brief
    detail
    extensive
    none

    Flow control

    Flow control status: Enabled or Disabled.

    brief
    detail
    extensive
    none

    Device flags

    Information about the physical device.

    brief
    detail
    extensive
    none

    Interface flags

    Information about the interface.

    brief
    detail
    extensive
    none

    Link flags

    Information about the link.

    brief
    detail
    extensive
    none

    CoS queues

    Number of CoS queues configured.

    detail
    extensive
    none

    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 year-month-day hour:minute:second timezone (weekswdaysd hours:minutes:seconds ago). For example, 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

    Output Rate

    Output rate in bps and pps.

    none

    Statistics last cleared

    Date, time, and how long ago the statistics for the interface were cleared. The format is year-month-day hour:minute:second timezone (weekswdaysd hours:minutes:seconds ago). For example, 2010-05-17 07:51:28 PDT (00:04:33 ago).

    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 and rate in bits per second.
    • Output bytes—Number of bytes transmitted on the interface and rate in bits per second.
    • Input packets—Number of packets received on the interface and rate in packets per second.
    • Output packets—Number of packets transmitted on the interface and rate in packets per second.

    detail
    extensive

    IPv6 transit statistics

    EX Series switches do not support the collection and reporting of IPv6 transit statistics.

    detail
    extensive

    Input errors

    Input errors on the interface:

    • 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 the 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:

    • 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. A 10-Gigabit Ethernet interface supports only full-duplex operation, so for 10-Gigabit Ethernet interfaces, 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 switch interfaces.
    • MTU errors—Number of packets whose size exceeded the MTU of the interface.
    • Resource errors—Sum of transmit drops.

    extensive

    Ingress queues

    Number of CoS ingress queues supported on the specified interface. Displayed only for an interface on a line card with oversubscribed ports.

    detail
    extensive

    Egress queues

    Number of CoS egress queues supported on the specified interface.

    detail
    extensive

    PFE Egress queues

    Number of Packet Forwarding Engine egress queues shared by the interfaces in a port group. Displayed only for an interface on a line card with oversubscribed ports.

    detail
    extensive

    Queue counters

    Statistics for queues:

    • Queued packets—Number of queued packets. This counter is not supported on EX switches and always contains 0.
    • Transmitted packets—Number of transmitted packets.
    • Dropped packets—Number of packets dropped by the ASIC's RED mechanism.

    detail
    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 front of the switch. 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

    MAC statistics

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

    • Total octets and total packets—Total number of octets and packets.
    • 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 frames that exceed 1518 octets.
    • 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.
    • Code violations—Number of times an event caused the PHY to indicate “Data reception error” or “invalid data symbol error.”

    extensive

    Packet Forwarding Engine configuration

    Information about the configuration of the Packet Forwarding Engine:

    • Destination slot—FPC slot number:
      • On standalone switches with built-in interfaces, the slot number refers to the switch itself and is always 0.
      • On Virtual Chassis composed of switches with built-in interfaces, the slot number refers to the member ID of the switch.
      • On switches with line cards or on Virtual Chassis composed of switches with line cards, the slot number refers to the line card slot number on the switch or Virtual Chassis.

    extensive

    CoS Information

    Scheduler information for the CoS egress queues on the physical interface:

    • Direction—Queue direction, always Output.
    • CoS transmit queue—Queue number and its associated user-configured forwarding class name.
    • Bandwidth—Information about bandwidth allocated to the queue:
      • %—Bandwidth allocated to the queue as a percentage
      • bps—Bandwidth allocated to the queue in bps
    • Buffer—Information about buffer space allocated to the queue:
      • %—Buffer space allocated to the queue as a percentage.
      • usec—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

    Fields for Logical Interfaces  

    Logical interface

    Name of the logical interface.

    brief
    detail
    extensive
    none

    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

    Description

    User-configured description of the interface.

    brief
    detail
    extensive
    none

    Flags

    Information about the logical interface.

    brief
    detail
    extensive
    none

    Encapsulation

    Encapsulation on the logical interface.

    brief
    detail
    extensive
    none

    Traffic statistics

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

    Note: For logical interfaces on EX Series switches, the traffic statistics fields in show interfaces commands show only control traffic; the traffic statistics do not include data traffic.

    detail
    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

    Protocol

    Protocol family.

    detail
    extensive
    none

    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 (RPF) is explicitly configured on the specified interface, the uRPF flag is displayed. If unicast RPF 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 is not displayed even though unicast RPF 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 flags.

    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 xe-4/1/0

    user@switch show interfaces xe-4/1/0
    Physical interface: xe-4/1/0, Enabled, Physical link is Up
      Interface index: 387, SNMP ifIndex: 369
      Link-level type: Ethernet, MTU: 1514, Speed: 10Gbps, Duplex: Full-Duplex,
      BPDU Error: None, MAC-REWRITE Error: None, Loopback: Disabled,
      Source filtering: Disabled, Flow control: Enabled
      Device flags   : Present Running
      Interface flags: SNMP-Traps Internal: 0x0
      Link flags     : None
      CoS queues     : 8 supported, 8 maximum usable queues
      Current address: 00:23:9c:03:8e:70, Hardware address: 00:23:9c:03:8e:70
      Last flapped   : 2009-05-12 08:01:04 UTC (00:13:44 ago)
      Input rate     : 36432 bps (3 pps)
      Output rate    : 0 bps (0 pps)
      Active alarms  : None
      Active defects : None
    
      Logical interface xe-4/1/0.0 (Index 66) (SNMP ifIndex 417)
        Flags: SNMP-Traps Encapsulation: ENET2
        Input packets : 0
        Output packets: 0
        Protocol eth-switch
          Flags: None
    

    show interfaces xe-0/1/0 brief

    user@switch> show interfaces xe-0/1/0 brief
    Physical interface: xe-0/1/0, Enabled, Physical link is Up
      Link-level type: Ethernet, MTU: 1514, Speed: 1000mbps, Loopback: Disabled,
      Source filtering: Disabled, Flow control: Enabled
      Device flags   : Present Running
      Interface flags: SNMP-Traps Internal: 0x0
      Link flags     : None
     
      Logical interface xe-0/1/0.0 
        Flags: SNMP-Traps Encapsulation: ENET2
        eth-switch
    

    show interfaces xe-4/1/0 detail

    user@switch> show interfaces xe-4/1/0 detail
    Physical interface: xe-4/1/0, Enabled, Physical link is Up
      Interface index: 387, SNMP ifIndex: 369, Generation: 390
      Link-level type: Ethernet, MTU: 1514, Speed: 10Gbps, Duplex: Full-Duplex,
      BPDU Error: None, MAC-REWRITE Error: None, Loopback: Disabled,
      Source filtering: Disabled, Flow control: Enabled
      Device flags   : Present Running
      Interface flags: SNMP-Traps Internal: 0x0
      Link flags     : None
      CoS queues     : 8 supported, 8 maximum usable queues
      Hold-times     : Up 0 ms, Down 0 ms
      Current address: 00:23:9c:03:8e:70, Hardware address: 00:23:9c:03:8e:70
      Last flapped   : 2009-05-12 08:01:04 UTC (00:13:49 ago)
      Statistics last cleared: Never
      Traffic statistics:
       Input  bytes  :              4945644                48576 bps
       Output bytes  :                    0                    0 bps
       Input  packets:                 3258                    4 pps
       Output packets:                    0                    0 pps
       IPv6 transit statistics:
        Input  bytes  :                   0
        Output bytes  :                   0
        Input  packets:                   0
        Output packets:                   0
      Egress queues: 8 supported, 4 in use
      Queue counters:       Queued packets  Transmitted packets      Dropped packets
        0 best-effort                    0                    0                    0
        1 assured-forw                   0                    0                    0
        5 expedited-fo                   0                    0                    0
        7 network-cont                   0                    0                    0
      Active alarms  : None
      Active defects : None
    
      Logical interface xe-4/1/0.0 (Index 66) (SNMP ifIndex 417) (Generation 158)
        Flags: SNMP-Traps Encapsulation: ENET2
        Traffic statistics:
         Input  bytes  :                    0
         Output bytes  :                    0
         Input  packets:                    0
         Output packets:                    0
        Local statistics:
         Input  bytes  :                    0
         Output bytes  :                    0
         Input  packets:                    0
         Output packets:                    0
        Transit statistics:
         Input  bytes  :                    0                    0 bps
         Output bytes  :                    0                    0 bps
         Input  packets:                    0                    0 pps
         Output packets:                    0                    0 pps
        Protocol eth-switch, Generation: 174, Route table: 0
          Flags: None
          Input Filters: f1,
          Output Filters: f2,,,,
    

    show interfaces xe-6/0/39 extensive

    user@switch> show interfaces xe-6/0/39 extensive
    Physical interface: xe-6/0/39, Enabled, Physical link is Up
      Interface index: 291, SNMP ifIndex: 1641, Generation: 316
      Link-level type: Ethernet, MTU: 1514, Speed: 10Gbps, Duplex: Full-Duplex, 
      BPDU Error: None,  MAC-REWRITE Error: None,  Loopback: Disabled, 
      Source filtering: Disabled, Flow control: Enabled
      Device flags   : Present Running
      Interface flags: SNMP-Traps Internal: 0x0
      Link flags     : None
      CoS queues     : 8 supported, 8 maximum usable queues
      Hold-times     : Up 0 ms, Down 0 ms
      Current address: 00:19:e2:72:f2:88, Hardware address: 00:19:e2:72:f2:88
      Last flapped   : 2010-05-13 14:49:43 PDT (1d 00:14 ago)
      Statistics last cleared: Never
      Traffic statistics:
       Input  bytes  :       49625962140160           4391057408 bps
       Output bytes  :       47686985710805           4258984960 bps
       Input  packets:         387702829264              4288139 pps
       Output packets:         372554570944              4159166 pps
       IPv6 transit statistics:
        Input  bytes  :                   0 
        Output bytes  :                   0
        Input  packets:                   0
        Output packets:                   0
      Input errors:
        Errors: 0, Drops: 0, Framing errors: 0, Runts: 0, Policed discards: 0,
        L3 incompletes: 0, L2 channel errors: 0, L2 mismatch timeouts: 0, 
        FIFO errors: 0, Resource errors: 0
      Output errors:
        Carrier transitions: 1, Errors: 0, Drops: 0, Collisions: 0, Aged packets: 0,
        FIFO errors: 0, HS link CRC errors: 0, MTU errors: 0, Resource errors: 0
      Ingress queues: 2 supported, 2 in use
      Queue counters:      Queued packets  Transmitted packets     Dropped packets
          Low priority                  0         336342805223          7986622358
          High priority                  0                    0                   0
      Egress queues: 8 supported, 8 in use
      Queue counters:      Queued packets  Transmitted packets     Dropped packets
        0 best-effort                   0         333760130103                   0
        1 assured-forw                  0                    0                   0
        2 mcast-be                      0            274948977                   0
        3 queue3                        0                    0                   0
        4 mcast-ef                      0                    0                   0
        5 expedited-fo                  0                    0                   0
        6 mcast-af                      0                    0                   0
        7 network-cont                  0                46613                   0
      PFE Egress queues: 8 supported, 8 in use
      Queue counters:      Queued packets  Transmitted packets     Dropped packets
        0 best-effort                   0         737867061290          5595302082
        1 assured-forw                  0                    0                   0
        2 mcast-be                      0                    0                   0
        3 queue3                        0                    0                   0
        4 mcast-ef                      0                    0                   0
        5 expedited-fo                  0                    0                   0
        6 mcast-af                      0                    0                   0
        7 network-cont                  0                97800                   0
      Active alarms  : None
      Active defects : None
      MAC statistics:                      Receive         Transmit
        Total octets                49625962140160   47686985710805
        Total packets                 387702829264     372554570944
        Unicast packets               387702829264     372554518472
        Broadcast packets                        0                2
        Multicast packets                        0            52470
        CRC/Align errors                         0                0
        FIFO errors                              0                0
        MAC control frames                       0                0
        MAC pause frames                         0                0
        Oversized frames                         0
        Jabber frames                            0
        Fragment frames                          0
        Code violations                          0
      Packet Forwarding Engine configuration:
        Destination slot: 6
      CoS information:
        Direction : Output 
        CoS transmit queue           Bandwidth           Buffer Priority   Limit
                              %            bps     %       usec
        0 best-effort        75     7500000000    75          0      low    none
        2 mcast-be           20     2000000000    20          0      low    none
        7 network-cont        5      500000000     5          0      low    none
    
      Logical interface xe-6/0/39.0 (Index 1810) (SNMP ifIndex 2238) (Generation 1923)
        Flags: SNMP-Traps 0x0 Encapsulation: ENET2
        Traffic statistics:
         Input  bytes  :                    0
         Output bytes  :              9375416
         Input  packets:                    0
         Output packets:                48901
        Local statistics:
         Input  bytes  :                    0
         Output bytes  :              9375416
         Input  packets:                    0
         Output packets:                48901
        Transit statistics:
         Input  bytes  :                    0                    0 bps
         Output bytes  :                    0                    0 bps
         Input  packets:                    0                    0 pps
         Output packets:                    0                    0 pps
        Protocol eth-switch, Generation: 1937, Route table: 0
          Flags: Trunk-Mode
    

    Published: 2012-12-07