u-boot.git/doc/develop/bootstd, branch main

doc: develop/bootstd: fix link to distro_boot

2026-08-29T04:41:36Z

We never had a file in boot/distro.c. The only time we had a distro_boot() function was between v2022.07 when it was introduced and v2023.07 (excluded) when it was renamed to extlinux_boot(). So let's just point at the latest release that still had it. Signed-off-by: Quentin Schulz

doc: bootstd: update link to BSL

2026-08-29T04:41:35Z

The link states the current version has moved to https://systemd.io/BOOT_LOADER_SPECIFICATION/ which itself says it's now hosted at https://uapi-group.org/specifications/specs/boot_loader_specification/ so used that link instead of making the user hop through multiple hoops. Signed-off-by: Quentin Schulz

doc: Switch from setenv to env set

2026-07-27T16:50:27Z

The "env" command is the recommended environment management command, its "set" subcommand is the equivalent replacement for legacy "setenv" command. Update the documentation to use the contemporary "env set" command instead of legacy "setenv" command. Note that the "setenv" command is unlikely to be removed from U-Boot in the near future due to it being integral part of the command line ABI. Implemented using: $ sed -i 's@\@env set@g' $(git grep -li '\' doc/) README Signed-off-by: Marek Vasut

doc: bootstd: specify CONFIG_BOOTSTD_DEFAULTS provides network features when NET=y

2026-05-01T08:35:06Z

In the past, we only had one network stack which was called NET. The network features were enabled for the legacy (and then only) networking stack since commit 22353fa6b585 ("bootstd: Add some default filesystems and commands"). Then instead on relying on NET legacy stack for enabling networking features, the dependencies were (mostly) changed to depend on CMD_NET in commit a0c739c184ca ("boot: Create a common BOOT_DEFAULTS for distro and bootstd"). Then a new stack (lwIP) appeared, then CMD_NET was made available with this new stack in commit 98ad145db61a ("net: lwip: add DHCP support and dhcp commmand") making the networking features possible to enable and finally commit f1e978fd54d9 ("boot: Update tests around network symbols in BOOT_DEFAULTS_CMDS") made it explicit that we need *a* network stack to enable some networking features. Align the bootstd documentation with what's actually implemented as Kconfig dependencies. Note that BOOTSTD_DEFAULTS selects BOOT_DEFAULTS which selects BOOT_DEFAULTS_CMDS which then selects network features. The CMDLINE symbol needs to be enabled as well for BOOT_DEFAULTS to select BOOT_DEFAULTS_CMDS, but I don't think we need to go that far into explaining what's required to enable some commands. Reported-by: Simon Glass Closes: https://lore.kernel.org/u-boot/CAFLszTgZC1FGy8965pHiG-u=FhrguftRv41ghQ_Qb_RRXx6tyg@mail.gmail.com/ Signed-off-by: Quentin Schulz

rename NET to NET_LEGACY

2026-04-27T17:26:40Z

Highlight that NET really is the legacy networking stack by renaming the option to NET_LEGACY. This requires us to add an SPL_NET_LEGACY alias to SPL_NET as otherwise CONFIG_IS_ENABLED(NET_LEGACY) will not work for SPL. The "depends on !NET_LWIP" for SPL_NET clearly highlights that it is using the legacy networking app so this seems fine to do. This also has the benefit of removing potential confusion on NET being a specific networking stack instead of "any" network stack. Signed-off-by: Quentin Schulz Acked-by: Ilias Apalodimas Reviewed-by: Peter Robinson Reviewed-by: Tom Rini

doc: bootstd: Describe the optional extension_overlay_addr environment

2025-11-06T22:26:28Z

Add extension_overlay_addr description to the list of environment variables that can be useful during the standard boot. Signed-off-by: Kory Maincent (TI.com) Reviewed-by: Heinrich Schuchardt

doc: bootstd: Remove extension support from TODO list

2025-11-06T22:26:28Z

Now that extension support has been added to extlinux and efi bootmeths we can remove this line from the TODO list. Signed-off-by: Kory Maincent (TI.com) Reviewed-by: Heinrich Schuchardt

bootstd: make it possible to use tftp for netboot with standardboot

2025-10-24T19:47:50Z

Add the option to load the bootscript with the tftp command (static IP) instead of the dhcp command (dynamic IP). For this a new function tftpb_run similar to dhcp_run, is needed. The selection of which command to use can be done with the ip_dyn environment variable, which can be set to yes or no. The ip_dyn variable was chosen as it is already in use on the imx platforms. Also edit the bootstd doc. Reviewed-by: Simon Glass Signed-off-by: Benjamin Hahn

boot: Run global bootmeths after all bootdevs are exhausted

2025-10-22T20:16:56Z

When there are no more bootdevs we should still go through the global bootmeths, since some may not have yet been used, if their priority has not yet come up. Add a final check for this at the end of the iterator. Update the documentation to match the new behaviour of global bootmeths. Signed-off-by: Simon Glass

bootstd: rauc: extend and fix doc to reflect real flow

2025-10-13T20:54:32Z

The documentation of bootmeth rauc in some aspects does not reflect the real program flow. Specifically the reset of boot tries in case of "no more slots found" is incorrect (it won't change BOOT_ORDER). Also the search sequence for boot scripts was mixed and incomplete. Fix these points in the documentation. Explain the initial setup of any missing BOOT_ORDER and BOOT_x_LEFT environment variables, and inform about BOOT_x_LEFT decrementing. Signed-off-by: Andreas Pretzsch Reviewed-by: Martin Schwan