Download an image


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


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


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


Download a 1MB test file


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

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


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 contains the line

  imgfetch initrd.img

then iPXE will download

Command status

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

See also


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

  kernel /boot/vmlinuz-2.6.31
  initrd initrd.img
  initrd /initscripts/ /sbin/init mode=755

then the file initrd.img will be treated as a normal initramfs filesystem image, and the file will appear as an extra executable file /sbin/init within this filesystem.

The optional mode parameter can be used to change the file mode, which defaults to 644. This can be useful for binaries that need to be executed.

cmd/imgfetch.txt · Last modified: 2016/02/17 11:26 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
References to "iPXE" may not be altered or removed.