display interface neighbor

Function

The display interface neighbor command displays information about the neighboring devices and interfaces of physical interfaces on a device.

Format

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

Parameters

Parameter	Description	Value
interface-type	Displays information about the neighboring devices and interfaces of an interface with a specified interface type. If no interface type is specified, the description of all interfaces is displayed.	-
interface-number	Displays information about the neighboring devices and interfaces of an interface with a specified interface number. If an interface type is specified but no interface number is specified, the description of all the interfaces of this type is displayed.	-
slot slot-id	Displays information about the neighboring devices and interfaces of all the interfaces in a specified slot. If no slot ID is specified, the description of the interfaces in 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	Displays information about the neighboring devices and interfaces of all the interfaces on a specified subcard. 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

To check information about the neighboring devices and interfaces of specified or all physical interfaces on a device, run the display interface neighbor command.

Example

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

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

<HUAWEI> display interface neighbor 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
(c): CFM down
Interface                     PHY     Protocol Neighbor Device  Neighbor Interface          Description                     
Gigabitethernet0/1/0          up      down     HUAWEI           Gigabitethernet0/1/0

# Display the information about the neighboring devices and interfaces of physical interfaces on a device..

<HUAWEI> display interface neighbor
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
(c): CFM down
Interface                     PHY     Protocol Neighbor Device  Neighbor Interface          Description                     
Eth-Trunk1                    down    down                                                                                  
Gigabitethernet0/1/0          up      down     HUAWEI           Gigabitethernet0/1/0                                               
Gigabitethernet0/1/1          up      down     HUAWEI           Gigabitethernet0/1/1                                              
Gigabitethernet0/1/7          up      down     HUAWEI           Gigabitethernet0/1/7
Gigabitethernet0/1/8          up      down     HUAWEI           Gigabitethernet0/1/9
Gigabitethernet0/1/8          up      down     HUAWEI           Gigabitethernet0/1/10
Gigabitethernet0/1/8          up      down     HUAWEI           Gigabitethernet0/1/11

**Table 1** Description of the **display interface neighbor** command output
Item	Description
Interface	Type and number of an interface.
PHY	Physical status of an interface. Available options are as follows: up: The physical status of the interface is Up. down: The physical status of the interface is Down. *down: The interface is administratively Down after an administrator runs the shutdown command on the interface. ^down: The interface is a standby interface. (l): loopback, indicating that the loopback function is enabled on the interface. (b): BFD Down, indicating that the physical status of the interface is BFD Down. (E): E-Trunk Down, indicating that the Eth-Trunk interface goes Down due to E-Trunk protocol negotiation. (p): port alarm Down, indicating that the interface goes Down physically due to an alarm, such as a CRC alarm.
Protocol	Link-layer protocol status of an interface. Available options are as follows: up: The link layer protocol status of the interface is Up. down: The link layer protocol of the interface becomes faulty. (l): loopback, indicating that the loopback function is enabled on the interface. (s): spoofing, indicating that the spoofing function is enabled on the interface. (b): BFD Down, indicating that the link layer protocol status of the interface is BFD Down. (B): bit-error-detection Down, indicating that the link layer protocol status of the interface is bit-error-detection Down. (e): ETH OAM Down, indicating that the physical layer EFM detection of the interface is faulty. (d): dampening suppressed, indicating that the protocol module of the interface is suppressed. (ld): loop-detect trigger Down, indicating that the interface is set to Down to eliminate a loop. (c): CFM Down, indicating that the interface goes Down due to CFM association with the interface status. Blank: The interface is not configured with any link layer protocol.
Neighbor Device	Name of a neighboring device.
Neighbor Interface	Neighboring interface.
Description	Interface description. If no description is configured for the interface using the description command, no information is displayed by default.