ip-neighbor

ip neighbor [command] [options]

ip neighbor manages the ARP (IPv4) and NDP (IPv6) neighbor tables. These tables map IP addresses to link-layer (MAC) addresses for hosts on directly connected networks.The neighbor cache is normally populated automatically through ARP/NDP protocols, but static entries can be added for hosts that don't respond to ARP or for security purposes.neighbor is the American spelling accepted by ip; neighbour is the equivalent British spelling, and both refer to the same object. The keyword can also be abbreviated to neigh or n.

show [dev DEVICE]

Display neighbor table entries

Add a neighbor entry

Remove a neighbor entry

Modify existing entry

Add or change entry

Clear entries for a device

Lookup single entry

Neighbor state: permanent, noarp, reachable, stale, none, incomplete, delay, probe, failed.

Manage proxy ARP/NDP entries.

Filter entries by address prefix (used with show/flush).

Modifying entries requires root privileges. Static entries may become stale if the actual MAC changes. IPv6 uses NDP instead of ARP but is managed through the same interface.

ip neighbor is part of iproute2 and replaces the older arp command from net-tools. It provides unified IPv4 and IPv6 neighbor management.

ip(8), ip-neighbour(8), arp(8), arping(8)

Source code · Documentation