display ipv6 neighbors

Function

The display ipv6 neighbors command displays information about neighbor entries.

Format

display ipv6 neighbors [ ipv6-address | [ vid vid ] interface-type interface-number | vpn-instance vpn-instance-name ]

display ipv6 neighbors [ interface-type interface-number [ vid vid [ cevid cevid ] ] ]

Only the S5720-EI, S5720-HI, S5730-HI, S5731-H, S5731-S, S5731S-H, S5731S-S, S5732-H, S6720-EI, S6720-HI, S6720S-EI, S6730-H, S6730S-H, S6730-S, and S6730S-S support cevid cevid.

Parameters

Parameter	Description	Value
ipv6-address	Displays neighbor entries of a specified IPv6 address.	The value is a 32-digit hexadecimal number, in the format X:X:X:X:X:X:X:X.
vid vid	Displays neighbor entries of a specified VLAN.	The value is an integer that ranges from 1 to 4094.
interface-type interface-number	Displays neighbor entries on a specified interface.	-
vpn-instance vpn-instance-name	Displays neighbor entries of a specified VPN instance.	The value must be an existing VPN instance name.
cevid cevid	Specifies the inner tag.	The value is an integer that ranges from 1 to 4094.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

The display ipv6 neighbors command displays information about dynamic and static ND entries. The information helps you:

Check whether the local routing device has learned MAC addresses from neighbors.
Check the neighbor status of the local routing device, including neighbor unreachable, neighbor reachable, or unknown.

You can run one of the following commands as required:

To view neighbor entries based on the neighbor IPv6 address, run the display ipv6 neighbors [ ipv6-address ] command.
To view neighbor entries based on the neighbor interface number, run the display ipv6 neighbors interface-type interface-number command.

To view neighbor entries on a VLANIF interface, run the display ipv6 neighbors [ [ vid vlan-id ] interface-type interface-number ] command or the display ipv6 neighbors [ interface-type interface-number [ vid vid [ cevid cevid ] ] ] command.
To view the neighbor entry on a sub-interface for QinQ VLAN tag termination or Dot1q VLAN tag termination, run the display ipv6 neighbors [ interface-type interface-number [ vid vid [ cevid cevid ] ] ] command.

If no parameter is specified, the display ipv6 neighbors command displays all neighbor entries.

Example

# Display neighbor entries of IPv6 address FC00::2.

<HUAWEI> display ipv6 neighbors fc00::2
-----------------------------------------------------------------------------
IPv6 Address : FC00::2
Link-layer   : 00e0-fc89-fe6e           State : STALE
Interface    : GE0/0/1                  Age   : 00h19m12s
VLAN         : -                        CEVLAN: -                     
VPN name     :                          Is Router: FALSE  
-----------------------------------------------------------------------------
Total: 1        Dynamic: 1          Static: 0

# Display neighbor entries on a specified interface.

<HUAWEI> display ipv6 neighbors vlanif 11
-----------------------------------------------------------------------------
IPv6 Address : FC00::3                                              
Link-layer   : 0001-0001-0012                     State : INCMP        
Interface    : GE0/0/1                            Age   : 00h19m12s                   
VLAN         : 11                                 CEVLAN: - 
VPN name     : v1                                 Is Router: TRUE             

-----------------------------------------------------------------------------
Total: 1       Dynamic: 0       Static: 1

# View the neighbor entries on the QinQ termination sub-interface GE0/0/1.1.

<HUAWEI> display ipv6 neighbors gigabitethernet 0/0/1.1 vid 1 cevid 1
-----------------------------------------------------------------------------
IPv6 Address : 2001:db8::2
Link-layer   : 00e0-3602-8100                     State : REACH
Interface    : GE0/0/1.1                          Age   : -
VLAN         : 1                                  CEVLAN: 1
VPN name     :                                    Is Router: TRUE
-----------------------------------------------------------------------------
Total: 1       Dynamic: 0       Static: 1

**Table 1** Description of the **display ipv6 neighbors** command output
Item	Description
IPv6 Address	IPv6 address of a neighbor.
Link-layer	Link layer address (MAC address) of the neighbor.
State	Status of a neighbor entry: INCMP: indicates that the neighbor is unreachable. When the address is being resolved, the link layer address of the neighbor is not detected. If resolution succeeds, the neighbor entry is in REACH state. REACH: indicates that the neighbor is reachable within a specified period. By default, the neighbor is reachable within 30s. If the period expires and the entry remains unused, the neighbor entry is in STALE state. STALE: indicates that whether the neighbor is reachable is unknown. The entry remains unused within a specified period. By default, the neighbor is reachable within 30s. A device does not detect neighbor reachability unless it needs to send packets to a neighbor. DELAY: indicates that whether the neighbor is reachable is unknown. A device has sent a packet to a neighbor. If the device does not receive any response from the neighbor within the specified period, the neighbor entry is in PROBE state. PROBE: indicates that whether the neighbor is reachable is unknown. A device has sent a packet to a neighbor to detect whether the neighbor is reachable. If the device receives a response from the neighbor within a specified period, the neighbor entry is in REACH state. Otherwise, the neighbor entry is in INCMP state.
Interface	Name of the interface to which the neighbor entry belongs.
Age	Aging time of the neighbor entry: The aging time of static entries is displayed as "-". The aging time of dynamic entries is the time that the reachable state lasts. "#" indicates non-reachable (only for dynamic entries).
VLAN	ID of the VLAN to which the neighbor belongs.
CEVLAN	ID of the CEVLAN to which a neighbor belongs. NOTE: Only the S5720-EI, S5720-HI, S5730-HI, S5731-H, S5731-S, S5731S-H, S5731S-S, S5732-H, S6720-EI, S6720-HI, S6720S-EI, S6730-H, S6730S-H, S6730-S, and S6730S-S support this parameter.
VPN name	Name of a VPN instance to which the neighbor belongs.
Is Router	Whether an NA packet carries the R flag: If the NA packet carries the R flag, "TRUE" is displayed. In this case, the neighbor is a routing device. If the NA packet carries no R flag, "FALSE" is displayed. In this case, the neighbor may be a PC or a routing device that sends an NA packet carrying no R flag.
Total	Number of total neighbor entries.
Dynamic	Number of dynamic neighbor entries.
Static	Number of static neighbor entries.