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

    Syntax

    show interfaces <esp max-router-fpcs/slot-id/port > |<ats interface-number><brief | detail | extensive | terse> <descriptions> <media> <snmp-index snmp-index> <statistics>

    Release Information

    Command introduced in Junos OS Release 13.3 for PTX5000 routers with CSE2000.

    Command introduced in Junos OS Release 13.3R4 for PTX3000 routers with CSE2000.

    Description

    Display status information about the specified Ethernet interface.

    Options

    none

    Display information about physical and logical interfaces.

    esp max-router-fpcs/slot-id/port

    (Optional) Display standard information about the specified export service port.

    ats interface-number

    (Optional) Display standard information about the specified aggregated tethered services (ATS) interface.

    brief | detail | extensive | terse

    (Optional) Display the specified level of output.

    descriptions

    (Optional) Display interface description strings.

    media

    (Optional) Display media-specific information about network interfaces.

    snmp-index snmp-index

    (Optional) Display information for the specified SNMP index of the interface.

    statistics

    (Optional) Display static interface statistics.

    Required Privilege Level

    view

    List of Sample Output

    show interfaces esp (Export Service Port)
    show interfaces ats (Aggregated Tethered Services)

    Output Fields

    See Table 1 for the output fields for the show interfaces command.

    Table 1: show interfaces 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. Possible values are described in the “Enabled Field” section under Common Output Fields Description.

    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

    Device flags

    Information about the physical device. Possible values are described in the “Device Flags” section under Common Output Fields Description.

    All levels

    Interface flags

    Information about the interface. Possible values are described in the “Interface Flags” section under Common Output Fields Description.

    All levels

    Link flags

    Information about the link. Possible values are described in the “Links Flags” section under Common Output Fields Description.

    All levels

    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: 2013-11-28 16:24:06 IST (21:23:45 ago).

    detail extensive none

    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.

    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 the Junos OS does not handle.
    • 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.
    • MTU errors—Number of packets whose size exceeded the MTU of the interface.
    • Resource errors—Sum of transmit drops.

    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. Possible values are described in the “Logical Interface Flags” section under Common Output Fields Description.

    All levels

    Encapsulation

    Encapsulation on the logical interface.

    All levels

    Protocol

    Protocol family. Possible values are described in the “Protocol Field” section under Common Output Fields Description.

    detail extensive none

    MTU

    Maximum transmission unit size on the logical interface.

    detail extensive none

    Maximum labels

    Maximum number of MPLS labels configured for the MPLS protocol family on the logical interface.

    detail extensive none

    statistics

    Number of bytes and packets received and transmitted on the specified ATS bundle.

    • Input bytes, Output bytes—Number of bytes received and transmitted on the ATS interface bundle.
    • Input pps, Output pps—Number of packets per second received and transmitted on the ATS interface bundle.
    • Input packets, Output packets—Number of packets received and transmitted on the ATS interface bundle.
    • Input bps, Output bps—Number of bytes per second received and transmitted on the ATS interface bundle.

    detail extensive

    Links

    Number and rate of bytes and packets received and transmitted on the specified member interface links of the ATS interface bundle.

    • Input bytes, Output bytes—Number of bytes received and transmitted on the member interface link.
    • Input pps, Output pps—Number of packets per second received and transmitted on the member interface link.
    • Input packets, Output packets—Number of packets received and transmitted on the member interface link.
    • Input bps, Output bps—Number of bytes per second received and transmitted on the member interface link.

    detail

    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

    Sample Output

    show interfaces esp (Export Service Port)

    user@host> show interfaces esp-8/0/1
    Physical interface: esp-8/0/1, Enabled, Physical link is Down
      Interface index: 131, SNMP ifIndex: 605
      Type: Ethernet, Link-level type: Ethernet, MTU: 9536, Speed: 10Gbps
      Device flags   : Present Running
      Interface flags: Hardware-Down
      Link type      : Full-Duplex
      Link flags     : None
      Last flapped   : Never
      Input rate     : 0 bps (0 pps)
      Output rate    : 0 bps (0 pps)

    show interfaces ats (Aggregated Tethered Services)

    user@host> show interfaces ats0
    Physical interface: ats0, Enabled, Physical link is Up
      Interface index: 195, SNMP ifIndex: 503, Generation: 1268
      Type: Ethernet, Link-level type: Ethernet, MTU: 9536, Clocking: Unspecified, Speed: 10Gbps
      Device flags   : Present Running
      Interface flags: SNMP-Traps Internal: 0x4000
      Link type      : Full-Duplex
      Link flags     : None
      Physical info  : Unspecified
      Hold-times     : Up 0 ms, Down 0 ms
      Current address: 08:81:f4:d0:40:10, Hardware address: 08:81:f4:d0:40:10
      Alternate link address: Unspecified
      Last flapped   : 2013-11-28 16:24:06 IST (22:15:57 ago)
      Statistics last cleared: Never
      Traffic statistics:
       Input  bytes  :                 7532                    0 bps
       Output bytes  :                    0                    0 bps
       Input  packets:                  122                    0 pps
       Output packets:                    0                    0 pps
       IPv6 transit statistics:
        Input  bytes  :                   0
        Output bytes  :                   0
        Input  packets:                   0
        Output packets:                   0
    
      Logical interface ats0.0 (Index 66) (SNMP ifIndex 504) (Generation 425)
        Flags: Up Point-To-Point SNMP-Traps 0x4000 Encapsulation: Tether-Enet-Svcs
        Statistics        Packets        pps         Bytes          bps
        Bundle:
            Input :           122          0          7532            0
            Output:             0          0             0            0
           Link:
          et-0/0/12.0 
            Input :             0          0             0            0
            Output:             0          0             0            0
          et-0/0/13.0
            Input :           122          0          7532            0
            Output:             0          0           7423            0
        Protocol inet, MTU: 9536, Generation: 979, Route table: 0
          Flags: Sendbcast-pkt-to-re
        Protocol inet6, MTU: 9536, Generation: 980, Route table: 0
          Flags: Is-Primary

    Modified: 2017-01-18