| .. SPDX-License-Identifier: GPL-2.0-or-later |
| .. Copyright 2024, Maxim Moskalets <maximmosk4@gmail.com> |
| |
| .. index:: |
| single: bootelf (command) |
| |
| bootelf command |
| =============== |
| |
| Synopsis |
| -------- |
| |
| :: |
| |
| bootelf [-p|-s] [-d <fdt_addr>] [<image_addr> [<arg>]...] |
| |
| Description |
| ----------- |
| |
| The *bootelf* command is used to launch a ELF binary at *image_addr*. If |
| *image_addr* is not specified, the bootelf command will try to find image in |
| *image_load_addr* variable (*CONFIG\_SYS\_LOAD\_ADDR* by default). |
| |
| Args after *image_addr* will be passed to application in common *argc*, *argv* |
| format. |
| |
| A command sequence to run a ELF image using FDT might look like |
| |
| :: |
| |
| load mmc 0:1 ${loadaddr} /kernel.elf |
| load mmc 0:1 ${fdt_addr_r} /soc-board.dtb |
| bootelf -d ${fdt_addr_r} ${loadaddr} ${loadaddr} |
| |
| image_addr |
| Address of the ELF binary. |
| |
| fdt_addr |
| Address of the device-tree. This argument in only needed if bootable |
| application uses FDT that requires additional setup (like /memory node). |
| |
| arg |
| Any text arguments for bootable application. This is usually the address |
| of the device-tree. |
| |
| Flags: |
| |
| -p |
| Load ELF image via program headers. |
| |
| -s |
| Load ELF image via section headers. |
| |
| -d |
| Setup FDT by address. |
| |
| Configuration |
| ------------- |
| |
| The bootelf command is only available if CONFIG_CMD_ELF=y. FDT setup by flag -d |
| need CONFIG_CMD_ELF_FDT_SETUP=y. |