display interface description

Function

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

Format

display interface description [ interface-name | interface-type [ interface-number ] | slot slot-id [ card card-number ] ]

Parameters

Parameter	Description	Value
interface-name	Specifies the name of an interface.	-
interface-type	Specifies the type of an interface. If no interface type is specified, the description of all interfaces is displayed.	-
interface-number	Specifies the number of an interface. If an interface type is specified but no interface number is specified, the description of all interfaces of this type is displayed.	-
slot slot-id	Specifies the slot number. If no slot number is specified, the description of all slots is displayed. In VS mode, this parameter is supported only by the admin VS.	The value is a string of 1 to 23 case-sensitive characters, spaces not supported.
card card-number	Specifies the subcard number. If a slot ID is specified but no interface number is specified, the description of the interfaces on all the subcards in the specified slot is displayed. In VS mode, this parameter is supported only by the admin VS.	-

Views

All views

Default Level

1: Monitoring level

Task Name and Operations

Task Name	Operations
interface-mgr	read

Usage Guidelines

Usage Scenario

For simplifying interface management, run the description command to record the use of each interface. In the case of many interfaces, run the display interface description command to view the description of these interfaces.

If the interface is Down, check whether the link connection is correct or whether interface negotiation succeeds.

Precautions

All activation interfaces are described in specifications. It is recommended that the interfaces be described in compliance with customer specifications.

If the customer does not have the specifications, describe the interface according to the following rules: Local device name-Local port number -> Peer device name-Peer port number//Port rate.

If the description of an interface displayed by running the display interface description command does not comply with the specifications, run the description command to describe the interface.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display the description of all the Ethernet interfaces on a device.

<HUAWEI> 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
(p): port alarm down
(ld): loop-detect trigger down
Interface                     PHY     Protocol Description
GE0/1/0                       up      down     Connecting to Beijing
GE0/1/1(10G)                  up      down     GigabitEthernet0/1/1 Interface

# Display the description of GigabitEthernet 0/1/0 on a device.

<HUAWEI> display interface description gigabitethernet 0/1/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
(p): port alarm down
(ld): loop-detect trigger down
Interface                     PHY     Protocol Description
GE0/1/0                       up      down     Connecting to Beijing

# Display the description of all interfaces on a device.

<HUAWEI> display interface description
PHY: Physical
^down: standby
(l): loopback
(s): spoofing
(E): E-Trunk down
(b): BFD down
(B): Bit-error-detection down
(e): ETHOAM down
(d): Dampening Suppressed
(p): port alarm down
(ld): loop-detect trigger down
Interface                     PHY     Protocol Description
GE0/1/0                       up      down     Connecting to Beijing
GE0/1/1(10G)                       up      down     GigabitEthernet0/1/1 Interface
GE0/1/1.1(10G)                     up      down  
NULL0                         up      up       NULL0 Interface

**Table 1** Description of the **display interface description** command output
Item	Description
Interface	Interface type and number. Bandwidth identifier displayed in the brackets after a GE interface: Actual bandwidth of the interface. For example, the name of a 10 Gbit/s GE main interface or sub-interface is tagged with the 10G bandwidth identifier. For a main interface or sub-interface whose bandwidth is limited by a license, the bandwidth identifier is displayed after the interface name. For a main interface or sub-interface with adaptive bandwidth, the bandwidth identifier is displayed after the interface name.
PHY	Physical status of the interface. Up: The physical layer of this interface is working properly. Down: The physical layer of this interface becomes faulty. *down: Administratively Down, the administrator has run the shutdown command on this interface. ^down: The interface is a backup interface. (l): loopback, this interface is enabled with the loopback function. (b): BFD Down, the physical layer of the interface is in the BFD Down state. (E): E-Trunk down, the Eth-Trunk interface goes Down due to E-Trunk protocol negotiation. (p): port alarm down, the interface goes Down physical due to an alarm, such as a CRC alarm.
Protocol	Link layer protocol status of the interface. Up: The link layer protocol of this interface is working properly. Down: The link layer protocol of this interface becomes faulty. (l): loopback. The interface is enabled with the loopback function. (s): spoofing. The interface is enabled with the spoofing function. (b): BFD Down. The link layer protocol of the interface is in the BFD Down state. (B): Bit-error-detection down. The data link layer of the interface is in the bit error Down state. (e): ETHOAM down. The physical layer of the interface is in the EFM fault state. (d): dampening suppressed. The protocol of the interface is suppressed. (ld): loop-detect trigger down. The interface is set to Down to prevent a loop. (c): CFM down. The interface goes Down due to the CFM configuration. Blank: The interface is not configured with a link layer protocol.
Description	Interface description. If the description command is not used to configure the interface description, the description is empty by default.