This is an old revision of the document!


Download and select an executable image

Synopsis

  kernel [--name <name>] <uri> [<arguments>...]

Examples

Download and select the iPXE demonstration image

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

Download and boot a Linux kernel with an initrd

  kernel vmlinuz
  initrd initrd.img
  boot

Download and boot a Multiboot kernel and modules

  kernel http://192.168.0.1/boot/mbkernel
  module http://192.168.0.1/modules/busybox
  module init.sh
  boot

Description

Download and select an executable image from the specified URI. If no name is explicitly specified, iPXE will use the filename portion of the URI as the image name. Any remaining arguments will be passed directly to the image. The image will become the selected image to be used as the default image for the boot command.

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

  kernel pxelinux.0

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

Command status

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

See also

Notes

The kernel command is equivalent to executing the imgfetch command followed by the imgselect command.

After downloading and selecting an image using the kernel command, you can use the imgstat command to check that the image has been autodetected as the correct image type.

cmd/kernel.1332622098.txt.gz ยท Last modified: 2012/03/24 20:48 by mcb30
Recent changes RSS feed CC Attribution-Share Alike 4.0 International Driven by DokuWiki
All uses of this content must include an attribution to the iPXE project and the URL https://ipxe.org
References to "iPXE" may not be altered or removed.