display interface

Syntax

display interface [ interface-type ] [ brief [ down | description ] ] [ | { begin | exclude | include } regular-expression ]

display interface interface-type interface-number [ brief [ description ] ] [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

interface-type: Specifies an interface type.

interface-number: Specifies an interface number.

brief: Displays brief interface information. If you do not specify this keyword, the command displays detailed interface information.

down: Displays information about interfaces in down state and the causes. If you do not specify this keyword, this command displays information about interfaces in all states.

description: Displays complete interface descriptions. If you do not specify this keyword, the command displays only the first 27 characters of each interface description.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

exclude: Displays all lines that do not match the specified regular expression.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use display interface to display Ethernet interface information.

If no interface type is specified, this command displays information about all interfaces.

If an interface type is specified but no interface number is specified, this command displays information about all interfaces of that type.

Related commands: interface.

Examples

# Display detailed information about interface Ethernet 1/0/1.

<Sysname>display interface ethernet 1/0/1
Ethernet1/0/1 current state: DOWN
 IP Packet Frame Type: PKTFMT_ETHNT_2, Hardware Address: 00e0-fc00-9877
 Description: Ethernet1/0/1 Interface
 Loopback is not set
 Media type is twisted pair
 Port hardware type is  100_BASE_T
 Unknown-speed mode, unknown-duplex mode
 Link speed type is autonegotiation, link duplex type is autonegotiation
 Flow-control is not enabled
 The Maximum Frame Length is 2048
 Broadcast MAX-ratio: 100%
 Unicast MAX-ratio: 100%
 Multicast MAX-ratio: 100%
 PVID: 1
 Mdi type: auto
 Port link-type: access
  Tagged   VLAN ID : none
  Untagged VLAN ID : 1
 Port priority: 0
 Last clearing of counters:  Never
 Peak value of input: 0 bytes/sec, at 2012-03-06 16:32:05
 Peak value of output: 0 bytes/sec, at 2012-03-06 16:32:05
 Last 300 seconds input:  0 packets/sec 0 bytes/sec -%
 Last 300 seconds output:  0 packets/sec 0 bytes/sec -%
 Input (total):  0 packets, 0 bytes
          0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses
 Input (normal):  0 packets, - bytes
          0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses
 Input:  0 input errors, 0 runts, 0 giants, 0 throttles
          0 CRC, 0 frame, - overruns, 0 aborts
          - ignored, - parity errors
 Output (total): 0 packets, 0 bytes
          0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses
 Output (normal): 0 packets, - bytes
          0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses
 Output: 0 output errors, - underruns, - buffer failures
          0 aborts, 0 deferred, 0 collisions, 0 late collisions
          0 lost carrier, - no carrier

Table 3: Command output

Field

Description

Ethernet1/0/1 current state

Physical state of the Ethernet interface. For more information, see Table 4.

IP Packet Frame Type

Ethernet framing format on the interface.

Hardware address

Hardware address of the port.

Description

Description of the interface.

Loopback is not set

The loopback testing function is disabled.

Unknown-speed mode

The port speed is unknown.

unknown-duplex mode

The duplex mode is unknown.

Link speed type is autonegotiation

The interface will negotiate a speed with its peer.

link duplex type is autonegotiation

The interface will negotiate a duplex mode with its peer.

The Maximum Frame Length

Maximum Ethernet frame length allowed on the interface.

Broadcast MAX-ratio

Broadcast suppression threshold as a percentage of the interface transmission capability. When the threshold is exceeded, the interface drops broadcast packets.

Unicast MAX-ratio

Unknown unicast suppression threshold as a percentage of the interface transmission capability. When the threshold is exceeded, the interface drops unknown unicast packets.

Multicast MAX-ratio

Multicast suppression threshold as a percentage of the interface transmission capability. When the threshold is exceeded, the interface drops multicast packets.

PVID

Port VLAN ID.

Mdi type

Cable type.

Port link-type

Link type of the interface, which could be access, trunk, or hybrid.

Tagged VLAN ID

VLANs for which the interface sends packets without removing VLAN tags.

Untagged VLAN ID

VLANs for which the interface sends packets after removing VLAN tags.

Peak value of input

Peak value of inbound traffic, in Bps.

Peak value of output

Peak value of outbound traffic, in Bps.

Last 300 seconds input: 0 packets/sec 0 bytes/sec

Last 300 seconds output: 0 packets/sec 0 bytes/sec

Average rate of input and output traffic in the last 300 seconds, in pps and Bps.

Input (total): 0 packets, 0 bytes

0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses

Inbound traffic statistics (in packets and bytes) for the interface. All inbound normal and abnormal packets (including unicast, broadcast, and multicast), and pause frames were counted.

Input (normal): 0 packets, - bytes

0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses

Inbound traffic statistics (in packets and bytes) for the interface. All inbound normal packets (including unicast, broadcast, and multicast), and pause frames were counted.

input errors

Inbound packets with errors.

runts

Inbound frames shorter than 64 bytes, in correct format, and containing valid CRCs.

giants

Inbound frames larger than the maximum frame length supported on the interface.

  • For an Ethernet interface that does not permit jumbo frames, giants refer to frames larger than 1536 bytes (without VLAN tags) or 1540 bytes (with VLAN tags).

  • For an Ethernet interface that permits jumbo frames, giants refer to frames larger than the maximum length of Ethernet frames that are allowed to pass through, which is configured when you configure jumbo frame support on the interface.

- throttles

Number of times that the port shut down due to buffer or CPU overload.

frame

Total number of inbound frames that contained checksum errors and a non-integer number of bytes.

- overruns

Number of packet drops because the input rate of the port exceeded the queuing capability.

aborts

Total number of illegal inbound packets:

  • Fragment frames—CRC error frames shorter than 64 bytes. The length can be an integral or non-integral value.

  • Jabber frames—CRC error frames greater than the maximum frame length supported on the Ethernet interface (with an integral or non-integral length). For an Ethernet interface that does not permit jumbo frames, jabber frames refer to CRC error frames greater than 1518 bytes (without VLAN tags) or 1522 bytes (with VLAN tags). For an Ethernet interface that permits jumbo frames, jabber frames refer to CRC error frames greater than the maximum length of Ethernet frames that are allowed to pass through the interface (which is configured when you configure jumbo frame support on the interface).

  • Symbol error frames—Frames that contained at least one undefined symbol.

  • Unknown operation code frames—Non-pause MAC control frames

  • Length error frames—Frames whose 802.3 length fields did not accord with the actual frame length (46 to 1500 bytes).

ignored

Number of inbound frames dropped because the receive buffer of the port ran low.

- parity errors

Total number of frames with parity errors.

Output (total): 0 packets, 0 bytes

0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses

Outbound traffic statistics (in packets and bytes) for the port. All outbound normal and abnormal packets (including unicast, broadcast, and multicast), and pause frames were counted.

Output (normal): 0 packets, - bytes

0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses

Outbound normal traffic (including unicast, broadcast, and multicast) and pause frame statistics (in packets and bytes) for the interface.

output errors

Outbound packets with errors.

- underruns

Number of packet drops because the output rate of the interface exceeded the output queuing capability. This is a low-probability hardware anomaly.

- buffer failures

Number of packets dropped because the transmit buffer of the interface ran low.

aborts

Number of packets that failed to be transmitted, for example, because of Ethernet collisions.

deferred

Number of frames that the interface deferred to transmit because of detected collisions.

collisions

Number of frames that the interface stopped transmitting because Ethernet collisions were detected during transmission.

late collisions

Number of frames that the interface deferred to transmit after transmitting their first 512 bits, because of detected collisions.

lost carrier

Number of carrier losses during transmission. This counter applies to serial WAN interfaces.

- no carrier

Number of times that the port failed to detect the carrier when attempting to send frames. This counter applies to serial WAN interfaces.


[NOTE: ]

NOTE:

If an output field is not available, a hyphen (-) is displayed.


Table 4: Description on the possible physical states of a Ethernet interface

Field

Description

UP

The interface is physically up.

DOWN

The interface is physically down, because no physical connection exists. Possible reason: The network cable is disconnected or faulty.

DOWN ( Administratively )

The interface is physically down, because it was shut down with the shutdown command. To restore its physical state, use the undo shutdown command.

DOWN ( Link-Aggregation interface down )

The interface is physically down, because the aggregate interface corresponding to the aggregation group to which it belongs was shut down with the shutdown command.

DOWN ( OAM connection failure )

The interface is physically down, because an OAM connection fails to be established on it or the OAM connection is disconnected.

DOWN ( DLDP connection failure )

The interface is physically down, because a DLDP connection fails to be established on it or the DLDP connection is disconnected.

DOWN ( Loopback detection-protected )

The interface is shut down, because a loop is detected on it.

DOWN ( BPDU-protected )

The interface is shut down by the BPDU guard function.

DOWN ( Monitor-Link uplink down )

The interface is physically down, because the uplink of the monitor link group to which it belongs is down.

# Display brief information about all interfaces.

<Sysname> display interface brief
The brief information of interface(s) under route mode:
Link: ADM - administratively down; Stby - standby
Protocol: (s) - spoofing
Interface            Link Protocol Main IP         Description
NULL0                UP   UP(s)    --
Vlan1                UP   UP       192.168.0.85
Vlan2                DOWN DOWN     --
Vlan1010             DOWN DOWN     --

The brief information of interface(s) under bridge mode:
Link: ADM - administratively down; Stby - standby
Speed or Duplex: (a)/A - auto; H - half; F - full
Type: A - access; T - trunk; H - hybrid
Interface            Link Speed   Duplex Type PVID Description
BAGG1                DOWN auto    A      A    1
Eth1/0/1             DOWN auto    A      A    1
Eth1/0/2             DOWN auto    A      A    1
Eth1/0/3             DOWN auto    A      A    1
Eth1/0/4             DOWN auto    A      A    1
Eth1/0/5             DOWN auto    A      A    1
Eth1/0/6             DOWN auto    A      A    1
Eth1/0/7             DOWN auto    A      A    1
Eth1/0/8             DOWN auto    A      A    1
Eth1/0/9             DOWN auto    A      A    1
Eth1/0/10            DOWN auto    A      A    1

# Filter the brief interface information to display the line starting with the (s) string and all subsequent lines.

<Sysname>display interface brief | begin (s)
The brief information of interface(s) under route mode:
Link: ADM - administratively down; Stby - standby
Protocol: (s) - spoofing
Interface            Link Protocol Main IP         Description
NULL0                UP   UP(s)    --
RAGG1                DOWN DOWN     --
Vlan1                UP   UP       192.168.0.55
Vlan2                DOWN DOWN     --

# Display the interfaces in down state and the reasons why they are down.

<Sysname> display interface brief down 
The brief information of interface(s) under bridge mode:
Link: ADM - administratively down; Stby - standby
Interface            Link Cause
BAGG1                DOWN Not connected
Eth1/0/1             DOWN Not connected
Eth1/0/2             DOWN Not connected
Eth1/0/3             DOWN Not connected
Eth1/0/4             DOWN Not connected
Eth1/0/5             DOWN Not connected
Eth1/0/6             DOWN Not connected
Eth1/0/7             DOWN Not connected
Eth1/0/8             DOWN Not connected
Eth1/0/9             DOWN Not connected
Eth1/0/10            DOWN Not connected

Table 5: Command output

Field

Description

The brief information of interface(s) under route mode:

The command displays brief information about Layer 3 interfaces.

Link: ADM - administratively down; Stby - standby

Link layer state of the interface:

  • ADM—The interface has been shut down by the network administrator. To recover its physical layer state, perform the undo shutdown command.

  • Stby—The interface is a standby interface.

Protocol: (s) - spoofing

If the network layer protocol state of an interface is shown as UP, but its link is an on-demand link or not present at all, its protocol attribute includes the spoofing flag (an s in parentheses). This attribute is typical of interface Null 0 and the loopback interfaces.

Interface

Interface name.

Link

Physical link state of the interface:

  • UP—The link is up.

  • DOWN—The link is physically down.

  • ADM—The link has been administratively shut down. To recover its physical state, perform the undo shutdown command.

  • Stby—The interface is a standby interface.

Protocol

Protocol connection state of the interface, which can be UP, DOWN, or UP(s).

The brief information of interface(s) under bridge mode:

Brief information about Layer 2 interfaces.

Speed or Duplex: (a)/A - auto; H - half; F - full

If the speed of an interface is automatically negotiated, its speed attribute includes the auto negotiation flag, letter a in parentheses.

If the duplex mode of an interface is automatically negotiated, its duplex mode attribute includes the following options:

  • (a)/A—Auto negotiation

  • H—Half negotiation

  • F—Full negotiation

Type: A - access; T - trunk; H – hybrid

Link type options for Ethernet interfaces.

Speed

Interface rate, in bps.

Duplex

Duplex mode of the interface:

  • A—Auto-negotiation

  • F—Full duplex

  • F(a)—Auto-negotiated full duplex

  • H—Half duplex

  • H(a)—Auto-negotiated half duplex

Type

Link type of the interface:

  • A—Access

  • H—Hybrid

  • T—Trunk

PVID

Port VLAN ID of the interface.

Cause

Causes for the physical state of an interface to be DOWN. For more information, see Table 6.

Table 6: Causes for the physical state of an interface to be DOWN

Field

Description

Not connected

No physical connection exists (possibly because the network cable is disconnected or faulty).

Administratively

The port was shut down with the shutdown command. To restore the physical state of the interface, use the undo shutdown command.

Link-Aggregation interface down

The aggregate interface corresponding to the aggregation group to which the interface belongs was shut down with the shutdown command.

OAM connection failure

OAM connection fails (possibly because the connection fails to be established or the connection is disconnected).

DLDP connection failure

DLDP connection fails (possibly because the connection fails to be established or the connection is disconnected).

Loopback detection-protected

The interface is shut down because a loop is detected on it.

BPDU-protected

The interface is shut down by the BPDU guard function.

Monitor-Link uplink down

The uplink of the monitor link group to which the interface belongs is down.