kernel [--name <name>] [--timeout <timeout>] <uri|image> [<arguments>...]
or
imgselect [--name <name>] [--timeout <timeout>] <uri|image> [<arguments>...]
or
imgload [--name <name>] [--timeout <timeout>] <uri|image> [<arguments>...]
kernel http://boot.ipxe.org/demo/boot.php
kernel http://192.168.0.1/vmlinuz initrd http://192.168.0.1/initrd.img boot
kernel http://192.168.0.1/boot/mbkernel module http://192.168.0.1/modules/busybox module init.sh boot
Download and select 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 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
.
Success | The image was successfully downloaded and selected |
---|---|
Failure | The image was not successfully downloaded and selected |
There is no difference between the commands kernel
, imgselect
, and imgload
.
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.
In very old versions of iPXE, you must use kernel
when you want to download and select a new image from a URI, and you must use imgselect
or imgload
when you want to select an image that has already been downloaded.