This is an old revision of the document!

Download an image

Synopsis

  imgfetch [--name <name>] [--timeout <timeout>] <uri> [<arguments>...]

or

  module [--name <name>] [--timeout <timeout>] <uri> [<arguments>...]

or

  initrd [--name <name>] [--timeout <timeout>] <uri> [<arguments>...]

Examples

Download a 1MB test file

  imgfetch http://boot.ipxe.org/1mb

Download and boot a Linux kernel, initrd and kernel module (using a script)

  #!ipxe
  kernel /boot/vmlinuz-2.6.31
  initrd initrd.img
  initrd /modules/2.6.31/e1000.ko /lib/modules/e1000.ko
  boot

Description

Download an 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 image.

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

  imgfetch initrd.img

then iPXE will download http://boot.ipxe.org/demo/initrd.img.

Command status

Success	The image was successfully downloaded
Failure	The image was not successfully downloaded

Notes

There is no difference between the commands imgfetch, module, and initrd.

When booting a Linux kernel, any argument supplied to the initrd command will be used as the pathname for that image within the initial RAM filesystem. For example, if you have the script

  #!ipxe
  
  kernel /boot/vmlinuz-2.6.31
  initrd initrd.img
  initrd /modules/2.6.31/e1000.ko /lib/modules/e1000.ko mode=644
  boot

then the file initrd.img will be treated as a normal initramfs filesystem image, and the file e1000.ko will appear as an extra file /lib/modules/e1000.ko within this filesystem. The optional mode parameter can be used to change the file mode from the default 644 to 755 (useful for binaries that need to be executed).

Table of Contents