doc: binman: Add guidance for determining ELF load addresses
authorAristo Chen <jj251510319013@gmail.com>
Sun, 14 Sep 2025 10:59:32 +0000 (10:59 +0000)
committerTom Rini <trini@konsulko.com>
Tue, 23 Sep 2025 19:35:22 +0000 (13:35 -0600)
commit4907a920e8292e9e38ddab4d211dfd5499097a8c
treead65d7c59f1011f06a3c4e48cf0ff516c61e6782
parent8f3d3510e31ebc7b2057f431322a7174b6b60ea6
doc: binman: Add guidance for determining ELF load addresses

Add documentation to help users understand how to determine where ELF
files will be loaded when using binman's 'fit,load' property. This
addresses the common confusion about how load addresses are determined
from ELF files.

The documentation explains three methods:
1. Using readelf to examine program headers
2. Checking the linker script (.lds file)
3. Using objdump to see section addresses

Also includes a specific example from binman tests showing how
elf_sections.lds sets ATF load address to 0x00000010 and
elf_sections_tee.lds sets TEE load address to 0x00100010 to avoid
memory overlap conflicts.

This helps users debug memory layout conflicts more efficiently when
working with FIT images containing multiple ELF components.

Signed-off-by: Aristo Chen <aristo.chen@canonical.com>
tools/binman/entries.rst