Juniper show interfaces

gblf

show interfaces


Syntax

show interfaces ge-fpc/pic/port<brief
| detail | extensive | terse><descriptions><media><snmp-index snmp-index><statistics>

Release Information


Command introduced in JUNOS Release 9.0 for EX-series switches.


Description


Display status information about the specified Gigabit Ethernet interface.


Options


ge-fpc/pic/port

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


List of Sample Output

show interfaces
(Gigabit Ethernet)

show interfaces
brief (Gigabit Ethernet)

show interfaces
detail (Gigabit Ethernet)

show interfaces
extensive (Gigabit Ethernet)


Output Fields


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


Table 1: Gigabit Ethernet 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: Enabled or Disabled.


All levels



Interface index


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


detail extensivenone



SNMP ifIndex


SNMP index number for the physical interface.


detail extensivenone



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 at which the interface is running.


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



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 extensivenone



Hold-times


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


detail extensive



Current address


Configured MAC address.


detail extensivenone



Hardware address


MAC address of the hardware.


detail extensivenone



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 extensivenone



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 this platform.


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 software 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 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



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 extensivenone



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 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:
  
  
  
  • 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 status—OK 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 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.
    
  • Link partner speed—Speed of the link partner.
    
  
  
• 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


Logical Interface


Logical interface


Name of the logical interface.


All levels



Index


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


detail extensivenone



SNMP ifIndex


SNMP interface index number for the logical interface.


detail extensivenone



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 extensivenone



MTU


This field is not supported for logical interfaces on EX-series switches.


detail extensivenone



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 extensivenone



Flags


Information about protocol family flags.

If unicast Reverse Path Forwarding (uRPF) is explicitly configured on the specified interface, the uRPF flag displays. 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 display even though uRPF 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 address flag.


detail extensivenone



Destination


IP address of the remote side of the connection.


detail extensivenone



Local


IP address of the logical interface.


detail extensivenone



Broadcast


Broadcast address of the logical interlace.


detail extensivenone



Generation


Unique number for use by Juniper Networks technical support only.


detail extensive



Sample Output


show interfaces (Gigabit Ethernet)

user@host> show interfaces ge-0/0/0
Physical interface: ge-0/0/0, Enabled, Physical link is Down
Interface index: 129, SNMP ifIndex: 21
Link-level type: Ethernet, MTU: 1514, Speed: Unspecified, Loopback: Disabled,
Source filtering: Disabled, Flow control: Enabled, Auto-negotiation: Enabled
Remote fault: Online
Device flags   : Present Running Down
Interface flags: Hardware-Down SNMP-Traps Internal: 0x0
CoS queues     : 8 supported, 8 maximum usable queues
Hold-times     : Up 0 ms, Down 0 ms
Current address: 00:19:e2:50:3f:41, Hardware address: 00:19:e2:50:3f:41
Last flapped   : 2008-01-16 11:40:53 UTC (4d 02:30 ago)
Input rate     : 0 bps (0 pps)
Output rate    : 0 bps (0 pps)
Ingress rate at Packet Forwarding Engine      : 0 bps (0 pps)
Ingress drop rate at Packet Forwarding Engine : 0 bps (0 pps)
Active alarms  : None
Active defects : None
Logical interface ge-0/0/0.0 (Index 65) (SNMP ifIndex 22)
Flags: SNMP-Traps
Encapsulation: ENET2
Input packets : 0
Output packets: 0
Protocol eth-switch, MTU: 0
Flags: None


show interfaces brief (Gigabit Ethernet)

user@host> show interfaces ge-0/0/0 brief
Physical interface: ge-0/0/0, Enabled, Physical link is Down
Description: voice priority and tcp and icmp traffic rate-limiting filter at i
ngress port
Link-level type: Ethernet, MTU: 1514, Speed: Unspecified, Loopback: Disabled,
Source filtering: Disabled, Flow control: Enabled, Auto-negotiation: Enabled,
Remote fault: Online
Device flags   : Present Running Down
Interface flags: Hardware-Down SNMP-Traps Internal: 0x0
Link flags     : None
Logical interface ge-0/0/0.0
Flags: Device-Down SNMP-Traps Encapsulation: ENET2
eth-switch

show interfaces detail (Gigabit Ethernet)

user@host> show interfaces ge-0/0/0 detail
Physical interface: ge-0/0/0, Enabled, Physical link is Up
Interface index: 129, SNMP ifIndex: 21, Generation: 130
Link-level type: Ethernet, MTU: 1514, Speed: Auto, Loopback: Disabled,
Source filtering: Disabled, Flow control: Enabled, Auto-negotiation: Enabled,
Remote fault: Online
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:50:a8:a1, Hardware address: 00:19:e2:50:a8:a1
Last flapped   : 2008-01-29 10:54:31 UTC (01:36:47 ago)
Statistics last cleared: Never
Traffic statistics:
Input  bytes  :         368613240000                    0 bps
Output bytes  :         368642493760                    0 bps
Input  packets:           5759581881                    0 pps
Output packets:           5760038969                    0 pps
Egress queues: 8 supported, 0 in use
Queue counters:       Queued packets  Transmitted packets      Dropped packets
0 best-effort                    0           5760782572                    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 ge-0/0/0.0 (Index 66) (SNMP ifIndex 22) (Generation 132)
Flags: SNMP-Traps Encapsulation: ENET2
Traffic statistics:
Input  bytes  :                   60
Output bytes  :                    0
Input  packets:                    1
Output packets:                    0
Local statistics:
Input  bytes  :                   60
Output bytes  :                    0
Input  packets:                    1
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, MTU: 0, Generation: 143, Route table: 0
Flags: Is-Primary


show interfaces extensive (Gigabit Ethernet)

user@host> show interfaces ge-0/0/0 extensive
Physical interface: ge-0/0/0, Enabled, Physical link is Up
Interface index: 129, SNMP ifIndex: 21, Generation: 130
Link-level type: Ethernet, MTU: 1514, Speed: Auto, Loopback: Disabled,
Source filtering: Disabled, Flow control: Enabled, Auto-negotiation: Enabled,
Remote fault: Online
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:50:a8:a1, Hardware address: 00:19:e2:50:a8:a1
Last flapped   : 2008-01-29 10:54:31 UTC (01:40:54 ago)
Statistics last cleared: Never
Traffic statistics:
Input  bytes  :         386327695808                    0 bps
Output bytes  :         386356949568                    0 bps
Input  packets:           6036370253                    0 pps
Output packets:           6036827341                    0 pps
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: 0, Errors: 0, Drops: 0, Collisions: 0, Aged packets: 0,
FIFO errors: 0, Resource errors: 0
Output errors:
Carrier transitions: 0, Errors: 0, Drops: 0, Collisions: 0, Aged packets: 0,
FIFO errors: 0, HS link CRC errors: 0, MTU errors: 0, Resource errors: 0
Egress queues: 8 supported, 0 in use
Queue counters:       Queued packets  Transmitted packets      Dropped packets
0 best-effort                    0           6036979415                    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
MAC statistics:                      Receive         Transmit
Total octets                  386327695808     386356949568
Total packets                   6036370253       6036827341
Unicast packets                 6036370252       6036827341
Broadcast packets                        0                0
Multicast packets                        1                0
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
Filter statistics:
Input packet count                       0
Input packet rejects                     0
Input DA rejects                         0
Input SA rejects                         0
Output packet count                                       0
Output packet pad count                                   0
Output packet error count                                 0
CAM destination filters: 0, CAM source filters: 0
Autonegotiation information:
Negotiation status: Complete
Link partner:
Link mode: Full-duplex, Flow control: None, Remote fault: OK,
Link partner Speed: 1000 Mbps
Local resolution:
Flow control: None, Remote fault: Link OK
Packet Forwarding Engine configuration:
Destination slot: 0
Logical interface ge-0/0/0.0 (Index 66) (SNMP ifIndex 22) (Generation 132)
Flags: SNMP-Traps Encapsulation: ENET2
Traffic statistics:
Input  bytes  :                   60
Output bytes  :                    0
Input  packets:                    1
Output packets:                    0
Local statistics:
Input  bytes  :                   60
Output bytes  :                    0
Input  packets:                    1
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, MTU: 0, Generation: 143, Route table: 0
Flags: Is-Primary



Published: 2010-01-12