From: Heinrich Schuchardt Date: Mon, 11 Apr 2022 19:06:13 +0000 (+0200) Subject: doc: update bootefi man-page X-Git-Tag: v2025.01-rc5-pxa1908~1438^2~20 X-Git-Url: http://git.dujemihanovic.xyz/img/%7B%7B%20.RelPermalink%20%7D%7D?a=commitdiff_plain;h=7f97d8cddfb7c7168cbd8193e8d2ff523716f161;p=u-boot.git doc: update bootefi man-page A image_size parameter has been added to the bootefi parameter. Describe all parameters. Correct how the description of how the device-path in the loaded image protocol is determined. Signed-off-by: Heinrich Schuchardt --- diff --git a/doc/usage/cmd/bootefi.rst b/doc/usage/cmd/bootefi.rst index 31279fc0cb..4cc8c0718c 100644 --- a/doc/usage/cmd/bootefi.rst +++ b/doc/usage/cmd/bootefi.rst @@ -9,7 +9,7 @@ Synopsis :: - bootefi [image_addr] [fdt_addr] + bootefi [image_addr] [fdt_addr [image_size]] bootefi bootmgr [fdt_addr] bootefi hello [fdt_addr] bootefi selftest [fdt_addr] @@ -41,13 +41,28 @@ command sequence to run a UEFI application might look like load mmc 0:1 $kernel_addr_r /EFI/grub/grubaa64.efi bootefi $kernel_addr_r $fdt_addr_r -The last file loaded defines the image file path in the loaded image protocol. -Hence the executable should always be loaded last. +The last UEFI binary loaded defines the image file path in the loaded image +protocol. The value of the environment variable *bootargs* is converted from UTF-8 to UTF-16 and passed as load options in the loaded image protocol to the UEFI binary. +image_addr + Address of the UEFI binary. + +fdt_addr + Address of the device-tree or '-'. If no address is specifiy, the + environment variable $fdt_addr is used as first fallback, the address of + U-Boot's internal device-tree $fdtcontroladdr as second fallback. + When using ACPI no device-tree shall be specified. + +image_size + Size of the UEFI binary file. This argument is only needed if *image_addr* + does not match the address of the last loaded UEFI binary. In this case + a memory device path will be used as image file path in the loaded image + protocol. + Note UEFI binaries that are contained in FIT images are launched via the *bootm* command.