34e452dd02
Currently all shell command docs are put in the doc/usage root. Let's group them into cmd/ sub-directory. Signed-off-by: Bin Meng <bmeng.cn@gmail.com> Reviewed-by: Heinrich Schuchardt <heinrich.schuchardt@canonical.com>
115 lines
3.1 KiB
ReStructuredText
115 lines
3.1 KiB
ReStructuredText
.. SPDX-License-Identifier: GPL-2.0+:
|
|
|
|
booti command
|
|
=============
|
|
|
|
Synopsis
|
|
--------
|
|
|
|
::
|
|
|
|
booti [<addr> [<initrd>[:<size>]] [<fdt>]]
|
|
|
|
Description
|
|
-----------
|
|
|
|
The booti command is used to boot a Linux kernel in flat or compressed
|
|
'Image' format. Which compressed formats are supported is configurable.
|
|
|
|
addr
|
|
address of kernel image, defaults to CONFIG_SYS_LOAD_ADDR.
|
|
|
|
initrd
|
|
address of the initial RAM disk. Use '-' to boot a kernel with a device
|
|
tree but without an initial RAM disk.
|
|
|
|
size
|
|
size of the initial RAM disk. This parameter must be specified for raw
|
|
initial RAM disks.
|
|
|
|
fdt
|
|
address of the device tree.
|
|
|
|
To support compressed Image files the following environment variables must be
|
|
set:
|
|
|
|
kernel_comp_addr_r
|
|
start of memory area used for decompression
|
|
|
|
kernel_comp_size
|
|
size of the compressed file. The value has to be at least the size of
|
|
loaded image for decompression to succeed. For the booti command the
|
|
maximum decompressed size is 10 times this value.
|
|
|
|
Example
|
|
-------
|
|
|
|
This is the boot log of an Odroid C2 board:
|
|
|
|
::
|
|
|
|
=> load mmc 0:1 $fdt_addr_r dtb-5.10.0-3-arm64
|
|
27530 bytes read in 7 ms (3.7 MiB/s)
|
|
=> load mmc 0:1 $kernel_addr_r vmlinuz-5.10.0-3-arm64
|
|
26990448 bytes read in 1175 ms (21.9 MiB/s)
|
|
=> load mmc 0:1 $ramdisk_addr_r initrd.img-5.10.0-3-arm64
|
|
27421776 bytes read in 1209 ms (21.6 MiB/s)
|
|
=> booti $kernel_addr_r $ramdisk_addr_r:$filesize $fdt_addr_r
|
|
Moving Image from 0x8080000 to 0x8200000, end=9c60000
|
|
## Flattened Device Tree blob at 08008000
|
|
Booting using the fdt blob at 0x8008000
|
|
Loading Ramdisk to 7a52a000, end 7bf50c50 ... OK
|
|
Loading Device Tree to 000000007a520000, end 000000007a529b89 ... OK
|
|
|
|
Starting kernel ...
|
|
|
|
The kernel can be compressed with gzip:
|
|
|
|
.. code-block:: bash
|
|
|
|
cd /boot
|
|
gzip -k vmlinuz-5.10.0-3-arm64
|
|
|
|
Here is the boot log for the compressed kernel:
|
|
|
|
::
|
|
|
|
=> setenv kernel_comp_addr_r 0x50000000
|
|
=> setenv kernel_comp_size 0x04000000
|
|
=> load mmc 0:1 $fdt_addr_r dtb-5.10.0-3-arm64
|
|
27530 bytes read in 6 ms (4.4 MiB/s)
|
|
=> load mmc 0:1 $kernel_addr_r vmlinuz-5.10.0-3-arm64.gz
|
|
9267730 bytes read in 402 ms (22 MiB/s)
|
|
=> load mmc 0:1 $ramdisk_addr_r initrd.img-5.10.0-3-arm64
|
|
27421776 bytes read in 1181 ms (22.1 MiB/s)
|
|
=> booti $kernel_addr_r $ramdisk_addr_r:$filesize $fdt_addr_r
|
|
Uncompressing Kernel Image
|
|
Moving Image from 0x8080000 to 0x8200000, end=9c60000
|
|
## Flattened Device Tree blob at 08008000
|
|
Booting using the fdt blob at 0x8008000
|
|
Loading Ramdisk to 7a52a000, end 7bf50c50 ... OK
|
|
Loading Device Tree to 000000007a520000, end 000000007a529b89 ... OK
|
|
|
|
Starting kernel ...
|
|
|
|
Configuration
|
|
-------------
|
|
|
|
The booti command is only available if CONFIG_CMD_BOOTI=y.
|
|
|
|
Which compression types are supported depends on:
|
|
|
|
* CONFIG_BZIP2
|
|
* CONFIG_GZIP
|
|
* CONFIG_LZ4
|
|
* CONFIG_LZMA
|
|
* CONFIG_LZO
|
|
* CONFIG_ZSTD
|
|
|
|
Return value
|
|
------------
|
|
|
|
Normally this command does not return. If an error occurs, the return value $?
|
|
is set to 1 (false). If the operating system returns to U-Boot, the system is
|
|
reset.
|