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.
|
- 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:
|
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: 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:
|
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:
|
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:
|
Type: A - access; T - trunk; H – hybrid | Link type options for Ethernet interfaces. |
Speed | Interface rate, in bps. |
Duplex | Duplex mode of the interface:
|
Type | Link type of the interface:
|
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. |