This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision Next revision Both sides next revision | ||
cmd:kernel [2012/03/24 20:48] mcb30 |
cmd:kernel [2012/11/20 01:13] mcb30 |
||
---|---|---|---|
Line 3: | Line 3: | ||
===== Synopsis ===== | ===== Synopsis ===== | ||
- | kernel [--name <name>] <uri> [<arguments>...] | + | kernel [--name <name>] <uri|image> [<arguments>...] |
+ | |||
+ | or | ||
+ | |||
+ | imgselect [--name <name>] <uri|image> [<arguments>...] | ||
+ | |||
+ | or | ||
+ | |||
+ | imgload [--name <name>] <uri|image> [<arguments>...] | ||
===== Examples ===== | ===== Examples ===== | ||
Line 13: | Line 21: | ||
=== Download and boot a Linux kernel with an initrd === | === Download and boot a Linux kernel with an initrd === | ||
- | kernel vmlinuz | + | kernel http://192.168.0.1/vmlinuz |
- | initrd initrd.img | + | initrd http://192.168.0.1/initrd.img |
boot | boot | ||
Line 26: | Line 34: | ||
===== Description ===== | ===== 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 [[:cmd:boot]] command. | + | Download and select an executable image from the specified URI. A name for the downloaded image can be specified using the ''%%--name%%'' 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 [[:cmd:boot]] command. | ||
If this command is executed from within an iPXE [[:scripting|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 | If this command is executed from within an iPXE [[:scripting|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 | ||
Line 49: | Line 59: | ||
===== Notes ===== | ===== Notes ===== | ||
- | The ''kernel'' command is equivalent to executing the ''[[:cmd:imgfetch]]'' command followed by the ''[[:cmd:imgselect]]'' command. | + | 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 ''[[:cmd:imgstat]]'' command to check that the image has been autodetected as the correct image type. | After downloading and selecting an image using the ''kernel'' command, you can use the ''[[:cmd:imgstat]]'' command to check that the image has been autodetected as the correct image type. | ||
+ | |||
+ | ===== Backwards compatibility ===== | ||
+ | |||
+ | In older 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. | ||