1.. SPDX-License-Identifier: GPL-2.0+:
2
3bootz command
4=============
5
6Synopsis
7--------
8
9::
10
11    bootz [<addr> [<initrd>[:<size>]] [<fdt>]]
12
13Description
14-----------
15
16The bootz command is used to boot a Linux kernel in 'zImage' format.
17
18addr
19    address of kernel image, defaults to the value of the environment
20    variable $loadaddr.
21
22initrd
23    address of the initial RAM disk. Use '-' to boot a kernel with a device
24    tree but without an initial RAM disk.
25
26size
27    size of the initial RAM disk. This parameter must be specified for raw
28    initial RAM disks.
29
30fdt
31    address of the device tree.
32
33Example
34-------
35
36This is the boot log of an OrangePi PC board:
37
38::
39
40    => load mmc 0:2 $fdt_addr_r dtb
41    23093 bytes read in 7 ms (3.1 MiB/s)
42    => load mmc 0:2 $kernel_addr_r vmlinuz
43    5079552 bytes read in 215 ms (22.5 MiB/s)
44    => load mmc 0:2 $ramdisk_addr_r initrd.img
45    23854965 bytes read in 995 ms (22.9 MiB/s)
46    => bootz $kernel_addr_r $ramdisk_addr_r:$filesize $fdt_addr_r
47    Kernel image @ 0x42000000 [ 0x000000 - 0x4d8200 ]
48    ## Flattened Device Tree blob at 43000000
49       Booting using the fdt blob at 0x43000000
50    EHCI failed to shut down host controller.
51       Loading Ramdisk to 48940000, end 49ffff75 ... OK
52       Loading Device Tree to 48937000, end 4893fa34 ... OK
53
54    Starting kernel ...
55
56Configuration
57-------------
58
59The bootz command is only available if CONFIG_CMD_BOOTZ=y.
60
61Return value
62------------
63
64Normally this command does not return. If an error occurs, the return value $?
65is set to 1 (false). If the operating system returns to U-Boot, the system is
66reset.
67