display ipv6 neighbors

Function

The display ipv6 neighbors command displays the cache contents of the neighbor.

Format

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

Parameters

Parameter	Description	Value
ipv6-address	Displays the neighbor entries of the specified IPv6 address.	-
vid vlan-id	Displays the cache contents of the neighbor in a specified VLAN.	The value is an integer ranging from 1 to 4094.
interface-type interface-number	Displays the neighbor entries on the specified interface.	-
vpn-instance vpn-instance-name	Specifies the name of a VPN instance. The name is used to view the neighbor entries of the specified VPN instance.	The name is a string of 1 to 31 case-sensitive characters.

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

Through the output of the display ipv6 neighbors command displays information about dynamic and static ND entries and check the following:

Whether the local router has learnt MAC addresses from neighbors
Status of the neighbors of the local router, including neighbor unreachable, neighbor reachable, or unknown

You can run one of the following commands as required:

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

To view the neighbor entry on a VLANIF interface, run the display ipv6 neighbors [ [ vid vlan-id ] interface-type interface-number ] .

Example

# Display contents in the neighbor cache of the specific interface.

<sysname> display ipv6 neighbors GigabitEthernet 0/0/0

--------------------------------------------------------
IPv6 Address : 2001:DB8::2
Link-layer   : 00e0-fc89-fe6e            State : STALE
Interface    : GE0/0/0                   Age   : 00h19m12s
VLAN         : -                         CEVLAN: -
VPN name     : vpn1                      
Secure FLAG  : UN-SECURE

IPv6 Address : FE80::2E0:FCFF:FE89:FE6E
Link-layer   : 00e0-fc89-fe6e            State : STALE
Interface    : GE0/0/0                   Age   : 00h19m12s
VLAN         : -                         
VPN name     : vpn1                      Is Router: TRUE
Secure FLAG  : UN-SECURE
---------------------------------------------------------
Total: 2       Dynamic: 2       Static: 0

# Display the neighbor entries of the specified IPv6 address.

<sysname> display ipv6 neighbors 3003::2

-----------------------------------------------------------------------------
IPv6 Address : 2001:DB8::2
Link-layer   : 00e0-fc89-fe6e                     State : STALE
Interface    : GE0/0/0                   Age   : 00h19m12s
VLAN         : -                                  
VPN name     : vpn1                               Is Router: TRUE
Secure FLAG  : UN-SECURE
-----------------------------------------------------------------------------
Total: 1       Dynamic: 1       Static: 0

**Table 1** Description of the **display ipv6 neighbors** command output
Item	Description
IPv6 Address	Indicates the IPv6 address of the neighbor.
Link-layer address	Indicates the link layer address (MAC address of the neighbor).
State	Indicates the statuses of the neighbor entries: 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 enters the REACH state. REACH: indicates that the neighbor is reachable within a specified period. By default, the period is 30s. If the period expires and this entry is unused, the entry enters the Stale state. STALE: indicates that whether the neighbor is reachable is unknown. That is, the entry is unused within a specified period. By default, the period is 30s. In this case, reachability of the neighbor is not detected unless a packet is sent to the neighbor. DELAY: indicates that whether the neighbor is reachable is unknown. A packet is sent to the neighbor. If no response is received within the specified period, the neighbor enters the PROBE state. PROBE: indicates that whether the neighbor is reachable is unknown. A neighbor request packet is sent to the neighbor to detect whether the neighbor is reachable. If a response is received within the specified period, the neighbor enters the REACH state. If no response is received, the neighbor enters the INCMP state.
Interface	Indicates the interface to which the neighbor entry belongs.
Age	Indicates the time for establishing the neighbor entry, including the following situations: The aging time of static entries is "-". The aging time of dynamic entries is the time that the reachable state lasts. "#" indicates non-reachable (only for dynamic entries).
VLAN	Neighbors in the specified VLAN
VPN name	Indicates the name of the VPN instance to which the neighbor belongs.
Is Router: TRUE	Indicates whether the NA packet carries an R flag. If the NA packet carries an R flag, "TRUE" is displayed in the Is Router field. In this case, the neighbor is a route device. If the NA packet does not carry an R flag, "FALSE" is displayed in the Is Router field. In this case, the neighbor may be a PC or a route device that sends an NA packets carrying no R flag.
Secure FLAG	Indicates whether the neighbor entry is secure. The neighbor entry is either secure or insecure. If it is a static neighbor entry or the neighbor is enabled with the neighbor security function, "SECURE" is displayed in the Secure flag. If the neighbor is not enabled with the neighbor security function, "UN-SECURE" is displayed in the Secure flag.
Total	Total number of the IPv6 ND entries.
Dynamic	Number of the dynamic IPv6 ND entries.
Static	Number of the static IPv6 ND entries.