====== Resolve host name to network address ======

===== Synopsis =====

    nslookup <setting> <hostname>

===== Examples =====

=== Look up the IP address for ipxe.org ===

    nslookup address ipxe.org
    echo ${address}

=== Set TFTP next-server address to boot.ipxe.org ===

    nslookup net0/next-server boot.ipxe.org

===== Description =====

Set value of the specified configuration [[:settings|setting]] to the network address corresponding to the specified host name.

===== Command status =====

^ Success   | The name was resolved successfully, and the setting was applied               |
^ Failure   | The name was not resolved successfully, or the setting could not be applied   |

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

  * ''[[:cmd:set]]''
  * ''[[:cmd:show]]''
  * [[:cfg|List of all iPXE settings]]
  * [[:cmd|List of all iPXE commands]]

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

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

===== Notes =====

You should not generally need to use the ''nslookup'' command, since you can simply include a host name as part of a URI.  For example:

    chain http://boot.ipxe.org/demo/boot.php