====== VMware GuestInfo settings ======

===== Name =====

    VMWARE_SETTINGS

===== Header file =====

Configured via ''[[http://git.ipxe.org/ipxe.git/blob/HEAD:/src/config/settings.h|config/settings.h]]''.

===== Examples =====

=== Enable VMware GuestInfo settings ===

    #define VMWARE_SETTINGS        /* VMware GuestInfo settings */

===== Description =====

This build option enables support for VMware GuestInfo settings.

GuestInfo settings can be configured in the ''.vmx'' file that defines the virtual machine.  The general syntax for a GuestInfo setting is

    guestinfo.ipxe[.<network device>].<setting name>[.<setting type>] = "<value>"

For example:

    guestinfo.ipxe.net0.ip = "192.168.0.15"
    guestinfo.ipxe.net0.netmask = "255.255.255.0"
    guestinfo.ipxe.net0.gateway = "192.168.0.1"
    
    guestinfo.ipxe.filename = "http://boot.ipxe.org/demo/boot.php"
    guestinfo.ipxe.dns = "192.168.0.1"
    
    guestinfo.ipxe.scriptlet = "ifopen net0 && chain ${filename}"

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

  * [[:howto:vmware|Using iPXE in VMware]]
  * [[:cfg|List of all iPXE settings]]
  * [[:buildcfg|List of all iPXE build options]]

===== Notes =====

You can use an [[:embed|embedded script]] (or the ''[[:cfg:scriptlet]]'' setting) to avoid the use of DHCP.  For example, if you define the GuestInfo settings:

    guestinfo.ipxe.net0.ip = "192.168.0.15"
    guestinfo.ipxe.net0.netmask = "255.255.255.0"
    guestinfo.ipxe.net0.gateway = "192.168.0.1"    
    guestinfo.ipxe.filename = "http://boot.ipxe.org/demo/boot.php"
    guestinfo.ipxe.dns = "192.168.0.1"

and use the embedded script:

    #!ipxe
    
    ifopen net0
    chain ${filename}

then the virtual machine will be able to boot using the static IP address configured in the ''.vmx'' file.