close

keyboard_arrow_left

Table of Contents Expand all

list Table of Contents

English

show interfaces ge

date_range 19-Nov-23

arrow_backward

arrow_forward

Syntax (EX Series)

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

Syntax (QFX Series)

content_copy zoom_out_map
show interfaces device-name:type-fpc/pic/port 
<brief | detail | extensive | terse> 
<descriptions> 
<media> 
<routing-instance (all | instance-name)> 
<snmp-index snmp-index> 
<statistics>

Description

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

Note:

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

Options

ge-`fpc/pic/port`	(EX Series) Display standard information about the specified 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.
statistics	(Optional) (EX Series) Display static interface statistics.

brief \| detail \| extensive \| terse	(Optional) (QFX Series) Display the specified level of output.
`device-name`:`type`-`fpc`/`pic`/`port`	(QFX Series) 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 can contain a maximum of 128 characters and cannot contain any colons.
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.

Required Privilege Level

view

Output Fields

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

Table 1: show interfaces ge- 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: Enabled or Disabled.	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
Description	Optional user-specified description.	brief detail extensive
Link-level type	Encapsulation being used on the physical interface.	All levels
MTU	Maximum transmission unit size on the physical interface. Default is 1514.	All levels
Speed	Speed of the interface: Auto if autonegotiation of speed is enabled; speed in megabits per second if the interface speed is explicitly configured.	All levels
Duplex	Link mode of the interface: Auto if autonegotiation of link mode is enabled; Full-Duplex or Half-Duplex if the link mode is explicitly configured.	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
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
IEEE 802.3az Energy Efficient Ethernet	IEEE 802.3az Energy Efficient Ethernet status: Enabled or Disabled (appears only for EEE-capable Base-T copper Ethernet interfaces).	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
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	MAC address of the hardware.	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
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 on the switch.	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 terminated 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 headers. For example, a frame with less than 20 bytes of available IP header is discarded. 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 terminated 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 switch 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
Active alarms and Active defects	Ethernet-specific defects that can prevent the interface from passing packets. When a defect persists for a certain time, it is promoted to an alarm. Based on the switch configuration, a defect can activate 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. 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 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
Filter Statistics	Receive and Transmit statistics reported by the PIC's MAC address filter subsystem.	extensive
Autonegotiation information	Information about link autonegotiation: Negotiation status: Complete—The autonegotiation process between the local and remote Ethernet interfaces was successful. Incomplete—Remote Ethernet interface has the speed or link mode configured or does not perform autonegotiation. No autonegotiation—Local Ethernet interface has autonegotiation disabled and the link mode and speed are manually configured. Link partner—Information from the link partner: Link mode—Depending on the capability of the attached Ethernet device, either Full-duplex or Half-duplex. If the link mode of the remote device cannot be determined, the value is Unknown. Flow control—Types of flow control supported by the remote Ethernet device. For Gigabit Ethernet interfaces, the types are: Symmetric (link partner supports PAUSE on receive and transmit); Asymmetric (link partner supports PAUSE on transmit); and Symmetric/Asymmetric (link partner supports PAUSE on both receive and transmit or PAUSE only on 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. Link partner speed—Speed of the link partner. Local resolution—Resolution of the autonegotiation process on the local interface: Flow control—Type of flow control that is used by the local interface. For Gigabit Ethernet interfaces, the types are: Symmetric (link partner supports PAUSE on receive and transmit); Asymmetric (link partner supports PAUSE on transmit); and Symmetric/Asymmetric (link partner supports PAUSE on both receive and transmit or PAUSE only on receive). Link mode—Link mode of local interface: either Full-duplex or Half-duplex. Displayed when Negotiation status is Incomplete. Local link speed—Speed of the local interface. Displayed when Negotiation status is Incomplete. 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: 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
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. 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
IPv6 transit statistics	EX Series switches do not support the collection and reporting of IPv6 transit statistics.	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 (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
`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 ge-0/0/0
show interfaces ge-0/0/0 brief
show interfaces ge-0/0/0 brief (with EEE Enabled on the EEE-capable Base-T copper Ethernet interfaces)
show interfaces ge-0/0/0 detail
show interfaces ge-0/0/4 extensive