display interface description

Function

The display interface description command displays the description of interfaces on the device.

Format

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

display interface description [ interface-type ] [ main ]

Parameters

Parameter	Description	Value
interface-type interface-number	Specifies the type and number of an interface.	If no interface type is specified, information about all interfaces is displayed. If no interface number is specified, information about all interfaces of this type is displayed.
\|	Filters the output by using the regular expression.	-
begin	Displays the information from the line containing the regular expression.	-
include	Displays all the lines that contain the regular expression.	-
exclude	Displays all the lines that do not contain the regular expression.	-
regular-expression	Specifies the regular expression.	-
main	Displays the description of the main interface. If an interface has no sub-interfaces, description about the interface are displayed whether you specify the main parameter or not. If an interface has sub-interfaces, description about the interface and sub-interfaces are displayed if you do not specify the main parameter.	-

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

To facilitate management, you can run the description command on an interface to record the function of the interface. In the case of many interfaces, you can run the display interface description command to rapidly view the description of the interfaces.

The description of interfaces cannot be configured in the terminal user interface view.

Example

# Display the description of all interfaces on the FW.

<sysname> display interface description

PHY: Physical
*down: administratively down
^down: standby
(l): loopback
(s): spoofing
(E): E-Trunk down(b): BFD down
(B): Bit-error-detection down
(e): ETHOAM down
(d): Dampening Suppressed
(ms): MACsec down
Interface                     PHY     Protocol   Description
GE0/0/0                down      down     HUAWEI, GigabitEthernet0/0/0 Interface
GE0/0/1                down      down     HUAWEI, GigabitEthernet 0/0/1 Interface
GE0/0/2                down      down     HUAWEI, GigabitEthernet 0/0/2 Interface
GE0/0/3                down      down     HUAWEI, GigabitEthernet 0/0/3 Interface

# Display the description of all Ethernet interfaces on the FW.

<sysname> display interface description gigabitethernet

PHY: Physical
*down: administratively down
^down: standby
(l): loopback
(s): spoofing
(E): E-Trunk down
(b): BFD down
(B): Bit-error-detection down
(e): ETHOAM down
(d): Dampening Suppressed
(ms): MACsec down
Interface                     PHY     Protocol   Description
GE0/0/0                down      down     HUAWEI, GigabitEthernet0/0/0 Interface
GE0/0/1                down      down     HUAWEI, GigabitEthernet 0/0/1 Interface
GE0/0/2                down      down     HUAWEI, GigabitEthernet 0/0/2 Interface
GE0/0/3                down      down     HUAWEI, GigabitEthernet 0/0/3 Interface

# Display the description of GigabitEthernet 0/0/0 on the FW.

<sysname> display interface description GigabitEthernet 0/0/0

PHY: Physical
*down: administratively down
^down: standby
(l): loopback
(s): spoofing
(E): E-Trunk down
(b): BFD down
(B): Bit-error-detection down
(e): ETHOAM down
(d): Dampening Suppressed
(ms): MACsec down
Interface                     PHY     Protocol   Description
GE0/0/0                down      down     HUAWEI, GigabitEthernet0/0/0 Interface

# Use the regular expression to filter the description of Gigabit Ethernet interfaces on the FW.

<sysname> display interface description | include Giga

PHY: Physical
*down: administratively down
^down: standby
(l): loopback
(s): spoofing
(E): E-Trunk down
(b): BFD down
(B): Bit-error-detection down
(e): ETHOAM down
(d): Dampening Suppressed
(ms): MACsec down
Interface                     PHY     Protocol   Description
GE0/0/0                down      down     HUAWEI, GigabitEthernet0/0/0 Interface
GE0/0/1                down      down     HUAWEI, GigabitEthernet 0/0/1 Interface
GE0/0/2                down      down     HUAWEI, GigabitEthernet 0/0/2 Interface
GE0/0/3                down      down     HUAWEI, GigabitEthernet 0/0/3 Interface

**Table 1** Description of the **display interface description** command output
Item	Description
Interface	The name and number of an interface. If the bandwidth of an interface exceeds 1 GB, the bandwidth value is displayed following the interface name.
PHY	Indicates the physical status of the interface, including: Up: indicates that the physical layer of this interface works properly. Down: indicates that the physical layer of this interface becomes faulty. down: refers to Administratively Down, indicating that the administrator has run the shutdown (interface view)* command on this interface. ^down: refers to standby, indicating that this interface is a standby interface. (l): refers to loopback, indicating that this interface is enabled with the loopback function. (E): E-Trunk down, the Eth-Trunk interface goes Down because of the E-Trunk negotiation failure. (b): refers to BFD Down, indicating that the physical layer of the interface is in the BFD Down state.
Protocol	Indicates the link layer protocol status of the interface, including: Up: indicates that the link layer protocol of this interface works properly. Down: indicates that the link layer protocol of this interface becomes faulty. (l): refers to loopback, indicating that this interface is enabled with the loopback function. (s): refers to spoofing, indicating that this interface is enabled with the spoofing function. (b): refers to BFD Down, indicating that the link layer protocol of the interface is in the BFD Down state. (B): Bit-error-detection down, indicating that the link layer protocol of the interface is in the error Down state. (e): refers to ETHOAM Down, indicating that the link layer protocol of the interface is in the ETHOAM Down state. (d): refers to dampening suppressed, indicating that the protocol of the interface is suppressed. (ms): refers to MACsec Down, indicating that MACsec negotiation fails and the link layer protocol status of the interface turns MACsec Down. Blank: indicates that the interface is not configured with a link layer protocol.
Description	Indicates the description of an interface. The information allows users to know about functions of the interface and is used to identify the current interface. You can run the description command to configure or modify the description of an interface.