====== Display neighbour table ======

===== Synopsis =====

    nstat

===== Examples =====

=== Display neighbour table ===

    nstat

===== Description =====

Display all entries in the neighbour table.  The output will show key information about each neighbour.  For example:

    iPXE> nstat
    net0 IP 10.253.253.1 is Ethernet 02:00:69:50:58:45 (ARP)
    net0 IP 10.253.253.22 is Ethernet (incomplete) (ARP)
    net0 IPv6 fe80::69ff:fe50:5845 is Ethernet 02:00:69:50:58:45
    net0 IPv6 3ffe:302:11:2:0:69ff:fe50:5845 is Ethernet 02:00:69:50:58:45
    net0 IPv6 3ffe:302:11:2:0:2aff:6b84:321a is Ethernet (incomplete) (NDP)

In this example you can see that there are five neighbours:

  * IP address ''10.253.253.1'', resolved using ARP to Ethernet ''02:00:69:50:58:45''.
  * IP address ''10.253.253.22'', still attempting resolution using ARP.
  * IPv6 (link-local) address ''fe80::69ff:fe50:5845'', resolved to Ethernet ''02:00:69:50:58:45'' without using a discovery protocol.
  * IPv6 (global) address ''3ffe:302:11:2:0:69ff:fe50:5845'', resolved to Ethernet ''02:00:69:50:58:45'' without using a discovery protocol.
  * IPv6 (global) address ''3ffe:302:11:2:0:2aff:6b84:321a'', still attempting resolution using NDP.

===== See also =====

  * ''[[:cmd:ifstat]]''
  * ''[[:cmd:ipstat]]''
  * ''[[:cmd:route]]''
  * [[:cmd|List of all iPXE commands]]

===== Build options =====

This command is available only when the build option ''[[:buildcfg:NEIGHBOUR_CMD]]'' is enabled.

===== Notes =====

You can trigger attempted resolution of a neighbour using the ''[[:cmd:ping]]'' command.