Download and boot an executable image

Synopsis

  chain [--name <name>] [--timeout <timeout>] [<uri|image>] [<arguments>...]

or

  imgexec [--name <name>] [--timeout <timeout>] [<uri|image>] [<arguments>...]

or

  boot [--name <name>] [--timeout <timeout>] [<uri|image>] [<arguments>...]

Examples

Download and boot the iPXE demonstration image

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

Download and boot pxelinux

  chain pxelinux.0

Download and boot a Linux kernel with an initrd and arguments

  initrd http://192.168.0.1/initrd.img
  chain http://192.168.0.1/vmlinuz vga=788

Boot the currently-selected image

  boot

Description

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 imgstat command).

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

  chain pxelinux.0

then iPXE will download and boot http://boot.ipxe.org/demo/pxelinux.0.

Command status

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.

See also

Notes

There is no difference between the commands chain, imgexec and boot.

Backwards compatibility

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 imgexec or boot when you want to boot an image that has already been downloaded.

 
cmd/chain.txt · Last modified: 2014/03/10 13:53 by mcb30
Recent changes RSS feed Donate Powered by PHP Valid XHTML 1.0 Valid CSS Driven by DokuWiki
All uses of this content must include an attribution to the iPXE project and the URL http://ipxe.org
References to "iPXE" may not be altered or removed.