Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

show interfaces (PTX Series Packet Transport Routers)

Syntax

Description

(PTX Series Packet Transport Routers only) Display status information about the specified Ethernet interface.

Options

et-fpc/pic/port

Display standard information about the specified Ethernet 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

Output Fields

See Table 1 for the output fields for the show interfaces (PTX Series Packet Transport Routers) command.

Table 1: show interfaces PTX Series 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. Refer possible values 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

MTU size on the physical interface.

All levels

Speed

Speed at which the interface is running.

All levels

BPDU Error

Bridge protocol data unit (BPDU) errors (if any).

All levels

MAC-Rewrite

MAC Rewrite errors (if any).

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

Flow control

Flow control status: Enabled or Disabled.

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

CoS queues

Number of CoS queues configured.

detail extensive none

Hold-times

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

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: 2002-04-26 10:52:40 PDT (04:33:20 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 that are received on the interface.

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

Note:

Input bytes and output bytes are counted as L3 packet length.

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 terminates and FCS errors.

  • Drops—Number of packets that are 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 L3 (usually IPv4) 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 by configuring the ignore-l3-incompletes statement.

    Note:

    The L3 incompletes field is not supported on PTX Series Packet Transport Routers.

  • 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 terminates and FCS errors.

  • Drops—Number of packets that are 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 GbE 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

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 router configuration, an alarm can ring the red or yellow alarm bell on the router, 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.

  • LOCAL-FAULT—Link fault signaling operates between the remote PHY RS (Reconciliation sub-layer) and the local RS. A Local Fault is used to signal a detected fault between the remote RS and the local RS to the local Ethernet interface.

  • REMOTE-FAULT—When the Local Fault status reaches an RS, the RS stops sending MAC data and continuously generates the Remote Fault status on the transmit datapath.

detail extensive none

MAC statistics

Receive and Transmit statistics reported by the PIC's MAC subsystem, including the following:

  • 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 or a cable 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 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.

  • 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. The filtering is done by the content-addressable memory (CAM) on the PIC. The filter examines a packet's source and destination MAC addresses to determine whether the packet should enter the system or be rejected.

  • Input packet count—Number of packets received from the MAC hardware that the filter processed.

  • Input packet rejects—Number of packets that the filter rejected because of either the source MAC address or the destination MAC address.

  • Input DA rejects—Number of packets that the filter rejected because the destination MAC address of the packet is not on the accept list. It is normal for this value to increment. When it increments very quickly and no traffic is entering the router from the far-end system, either there is a bad ARP entry on the far-end system, or multicast routing is not on and the far-end system is sending many multicast packets to the local router (which the router is rejecting).

  • Input SA rejects—Number of packets that the filter rejected because the source MAC address of the packet is not on the accept list. The value in this field should increment only if source MAC address filtering has been enabled. If filtering is enabled, if the value increments quickly, and if the system is not receiving traffic that it should from the far-end system, it means that the user-configured source MAC addresses for this interface are incorrect.

  • Output packet count—Number of packets that the filter has given to the MAC hardware.

  • Output packet pad count—Number of packets the filter padded to the minimum Ethernet size (60 bytes) before giving the packet to the MAC hardware. Usually, padding is done only on small ARP packets, but some very small IP packets can also require padding. If this value increments rapidly, either the system is trying to find an ARP entry for a far-end system that does not exist or it is misconfigured.

  • Output packet error count—Number of packets with an indicated error that the filter was given to transmit. These packets are usually aged packets or are the result of a bandwidth problem on the FPC hardware. On a normal system, the value of this field should not increment.

  • CAM destination filters, CAM source filters—Number of entries in the CAM dedicated to destination and source MAC address filters. There can only be up to 64 source entries. If source filtering is disabled, which is the default, the values for these fields should be 0.

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 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—Information from the link partner:

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

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

extensive

CoS information

Information about the CoS queue for the physical interface.

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

All levels

VLAN-Tag

Rewrite profile applied to incoming or outgoing frames on the outer (Out) VLAN tag or for both the outer and inner (In) VLAN tags.

  • push—An outer VLAN tag is pushed in front of the existing VLAN tag.

  • pop—The outer VLAN tag of the incoming frame is removed.

  • swap—The outer VLAN tag of the incoming frame is overwritten with the user-specified VLAN tag information.

  • push—An outer VLAN tag is pushed in front of the existing VLAN tag.

  • push-push—Two VLAN tags are pushed in from the incoming frame.

  • swap-push—The outer VLAN tag of the incoming frame is replaced by a user-specified VLAN tag value. A user-specified outer VLAN tag is pushed in front. The outer tag becomes an inner tag in the final frame.

  • swap-swap—Both the inner and the outer VLAN tags of the incoming frame are replaced by the user-specified VLAN tag value.

  • pop-swap—The outer VLAN tag of the incoming frame is removed, and the inner VLAN tag of the incoming frame is replaced by the user-specified VLAN tag value. The inner tag becomes the outer tag in the final frame.

  • pop-pop—Both the outer and inner VLAN tags of the incoming frame are removed.

brief detail extensive none

Demux

IP demultiplexing (demux) value that appears if this interface is used as the demux underlying interface. The output is one of the following:

  • Source Family Inet

  • Destination Family Inet

detail extensive none

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

Traffic statistics

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

  • Input bytes, Output bytes—Number of bytes received and transmitted on the interface set

  • Input packets, Output packets—Number of packets received and transmitted on the interface set.

Note:

Input bytes and output bytes are counted as Layer 3 packet length.

detail extensive

IPv6 transit statistics

Number of IPv6 transit bytes and packets received and transmitted on the logical interface if IPv6 statistics tracking is enabled.

extensive

Local statistics

Number and rate of bytes and packets destined to the router.

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

Flags

Information about protocol family flags. Possible values are described in the “Family Flags” section under Common Output Fields Description.

detail extensive

Donor interface

(Unnumbered Ethernet) Interface from which an unnumbered Ethernet interface borrows an IPv4 address.

detail extensive none

Preferred source address

(Unnumbered Ethernet) Secondary IPv4 address of the donor loopback interface that acts as the preferred source address for the unnumbered Ethernet interface.

detail extensive none

Input Filters

Names of any input filters applied to this interface. If you specify a precedence value for any filter in a dynamic profile, filter precedence values appear in parentheses next to all interfaces.

detail extensive

Output Filters

Names of any output filters applied to this interface. If you specify a precedence value for any filter in a dynamic profile, filter precedence values appear in parentheses next to all interfaces.

detail extensive

Mac-Validate Failures

Number of MAC address validation failures for packets and bytes. This field is displayed when MAC address validation is enabled for the logical interface.

detail extensive none

Addresses, Flags

Information about the address flags. Possible values are described in the “Addresses Flags” section under Common Output Fields Description.

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 flags (possible values are described in the “Addresses Flags” section under Common Output Fields Description.

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 brief (PTX5000 Packet Transport Router)

show interfaces extensive (PTX5000 Packet Transport Router)

show interfaces terse (PTX5000 Packet Transport Router)

show interfaces extensive (Junos OS Evolved)

Release Information

Command introduced in Junos OS Release 8.0.