show ipv6 neighbor

Displays the IPv6 neighbor table, which contains an entry for each IPv6 neighbor with which the router exchanges IPv6 packets.
Syntax
show ipv6 neighbor [ vrf vrf-name ] { ethernet stack/slot/port | lag lag-id | ve ve-num } [ dynamic | incomplete | stale | static ]
show ipv6 neighbor [ vrf vrf-name ] [ ipv6-address | ipv6-prefix/prefix-length | dynamic | incomplete | proxy | stale | static | statistics | summary ]
Parameters
vrf vrf-name
Specifies a VRF.
ethernet unit/slot/port
Specifies an Ethernet interface.
lag lag-id
Specifies a LAG interface.
ve ve-number
Specifies a Virtual Ethernet (VE) interface.
dynamic
Specifies dynamically learned IPv6 neighbors.
incomplete
Specifies IPv6 neighbors in an incomplete state.
stale
Specifies IPv6 neighbors in a stale state.
static
Specifies statically configured IPv6 neighbors.
ipv6-address
Specifies an IPv6 address, which restricts the display to the entries for the specified IPv6 address.
ipv6-prefix/prefix-length
Specifies an IPv6 prefix, which restricts the display to the entries for the specified IPv6 prefix.
proxy
Specifies IPv6 proxy neighbors.
statistics
Specifies IPv6 neighbor statistics.
summary
Specifies summarized information.
Modes

User EXEC mode

The show ipv6 neighbor command displays the following information:

Output Field Description
Total number of Neighbor entries The total number of entries in the IPv6 neighbor table.
IPv6 Address The 128-bit IPv6 address of the neighbor.
LinkLayer-Addr The 48-bit interface ID of the neighbor.
State The current state of the neighbor. Potential states include:
  • INCOMPLETE: Address resolution of the entry is being performed.
  • *REACH : The static forward path to the neighbor is functioning properly.
  • REACH: The forward path to the neighbor is functioning properly.
  • STALE: This entry has remained unused for the maximum interval of two hours. While stale, no action takes place until a packet is sent.
  • DELAY: This entry has remained unused for the maximum interval, and a packet was sent before another interval elapsed.
  • PROBE: Neighbor solicitations are transmitted until a reachability confirmation is received.
Age The number of seconds the entry has remained unused. If this value remains unused for the number of seconds specified by the ipv6 nd reachable-time command (the default is 30 seconds), the entry is removed from the table.
Port The physical port on which the entry was learned.
vlan The VLAN on which the entry was learned.
IsR Determines if the neighbor is a router or host:
  • 0 : Indicates that the neighbor is a host.
  • 1: Indicates that the neighbor is a router.
Note: The oldest stale entry will be deleted before the default time interval of two hours if the total number of entries in the neighbor table is equal to the maximum number of neighbor entries when a new entry is trying to be added.
Examples

The following example displays the IPv6 neighbor table.

device> show ipv6 neighbor

Total number of Neighbor entries: 3
IPv6 Address              LinkLayer-Addr   State     Age    Port       vlan    IsR
2001:DB8::55              0000.0002.0002   *REACH    0      e 1/3/11   -       0 
2000:4::110               0000.0091.bb37    REACH    20     e 1/3/1    5       1
fe80::2e0:52ff:fe91:bb37  0000.0091.bb37    DELAY    1      e 1/3/2    4       1
fe80::2e0:52ff:fe91:bb40  0000.0091.bb40    STALE    5930   e 1/3/3    5       1

The following example displays statistical information for IPv6 neighbors.

device> show ipv6 neighbor statistics

Neighbor Discovery Statistics:
   Messages/Events sent to ND6 Task(sent/processed):
       Control-Pkt 131/131 Slowpath-Tx 2024/2024 Nbr-Resolve-Req 12/12
       Port-Event 525/525 Addr-Event 264/264 MAC-Event 45/45 ITC-Fail 0
   Neighbor Lifecycle:
       Resolve-Req-Rcvd 7151(R=7139), Resolve-Pkt-Tx 2024, Create-With-LL 11,
       Create-And-Resolve 12, Resolve-Failed 12, Aged-Out 0,
       Probe-Failed 0, Nbr-Cache-Full 0, Dup-Update 0,
       Nbr-Alloc 23, Nbr-Free 23, Nbr-Alloc-Fail 0
   Neighbor Cache Operations:
       Search: If-scope 9312, VRF-scope 2024
       Traversal with key: If 140, VRF 0, All-VRF 0,
                           VLAN 18, Lag 2, Addr 0, Prefix 0
   Neighbor HW Update:
       Egress-Mod 0, State-Mod 42, Neighbor-Del 23, NH-Prog-Err 0

The following example displays summarized information for IPv6 neighbors.

device> show ipv6 neighbor summary

Global Neighbor Count:
      Max  Total Incomp  Reach  Stale  Delay  Probe
     4096    200      0      0    200      0      0
Interface L Neighbor Count:
      Total Incomp  Reach  Stale  Delay  Probe
v217:
     100      0      0    100      0      0
v218:
     100      0      0    100      0      0

The following example displays information for statically configured IPv6 neighbors for an Ethernet interface.

device> show ipv6 neighbor interface ethernet 1/1/4 static  
     Static: 
      Neighbor Entries in VRF: default-vrf
      IPv6 Address              LinkLayer-Addr State  Age    vlan IsR
      fe80::d6c1:9eff:fe18:7bf9 d4c1.9e18.7bf9 STALE  1952   1    1 

The following example displays information for statically configured IPv6 neighbors for a non-default VRF instance.

device> show ipv6 neighbor vrf vrf1 static  
     Static: 
      Neighbor Entries in VRF: vrf1
      IPv6 Address              LinkLayer-Addr State  Age    Port      vlan IsR
      fe80::d6c1:9eff:fe18:7bf9 d4c1.9e18.7bf9 STALE  1952   e 1/1/3   1    1 

The following example displays information for dynamically learned IPv6 neighbors for an Ethernet interface.

device> show ipv6 neighbor interface ethernet 1/1/4 dynamic
    Dynamic: 
      IPv6 Address              LinkLayer-Addr State  Age  vlan IsR
      fe80::d6c1:9eff:fe18:7bf9 d4c1.9e18.7bf9 STALE  1952 1    1
 

The following example displays information for dynamically learned IPv6 neighbors for a non-default VRF instance.

device> show ipv6 neighbor vrf vrf1 dynamic
    Dynamic: 
      IPv6 Address              LinkLayer-Addr State  Age    Port      vlan IsR
      fe80::d6c1:9eff:fe18:7bf9 d4c1.9e18.7bf9 STALE  1952   e 1/1/3    1    1

 

The following example displays information for IPv6 neighbors in an incomplete state for an Ethernet interface.

device> show ipv6 neighbor interface eth 1/1/4 incomplete
    Incomplete State : 
      IPv6 Address              LinkLayer-Addr   Age    vlan IsR
      fe80::d6c1:9eff:fe18:7bf9 d4c1.9e18.7bf9   1952   1    1 

History
Release version Command history
08.0.95 The dynamic, incomplete, stale, static, statistics, and summary keywords were added.