chain [--name <name>] [--timeout <timeout>] [<uri|image>] [<arguments>...]
imgexec [--name <name>] [--timeout <timeout>] [<uri|image>] [<arguments>...]
boot [--name <name>] [--timeout <timeout>] [<uri|image>] [<arguments>...]
initrd http://192.168.0.1/initrd.img chain http://192.168.0.1/vmlinuz vga=788 console=ttyS0,115200n8 console=tty0
Download and boot an executable image from the specified URI. A name for the downloaded image can be specified using the
--name option. A download progress timeout can be specified (in milliseconds) using the
--timeout option. Any remaining arguments will be passed directly to the booted image.
If no image is explicitly specified, iPXE will boot the currently-selected image (as reported by the
An image that has already been downloaded (e.g. by the
imgfetch command) can be specified by using the image's name instead of a URI. For example:
imgfetch http://192.168.0.1/vmlinuz boot vmlinuz
If this command is executed from within an iPXE script, then the URI will be interpreted as being relative to the URI of the script itself. For example, if the script
http://boot.ipxe.org/demo/boot.php contains the line
then iPXE will download and boot
|Success||The image was successfully downloaded and booted, and the image subsequently returned successfully|
|Failure||The image was not successfully downloaded and booted, or the image subsequently returned with an error|
It is unusual for this command to return successfully, since if the boot is successful then control will not return to iPXE.
There is no difference between the commands
In older versions of iPXE, you must use
chain when you want to download and boot a new image from a URI, and you must use
boot when you want to boot an image that has already been downloaded.