summaryrefslogtreecommitdiff
path: root/doc/develop/bootstd.rst
diff options
context:
space:
mode:
authorSimon Glass <sjg@chromium.org>2023-08-20 01:49:35 +0300
committerTom Rini <trini@konsulko.com>2023-08-28 22:59:22 +0300
commit5986d46f8efb20532d494242fccb051267f92e1a (patch)
treef63b239fb16ae1f72580d96ae8304e40364d2ef3 /doc/develop/bootstd.rst
parentd389efc44898f9b5b3d07e810253b6fb73c55e3c (diff)
downloadu-boot-5986d46f8efb20532d494242fccb051267f92e1a.tar.xz
bootstd: Adjust the default bootmeth order
The existing distro scripts check extlinux and scripts before EFI. Adjust the default ordering to do the same, to avoid breaking existing flows. Add some documentation, mentioning that this order will likely change in future. Signed-off-by: Simon Glass <sjg@chromium.org> Reported-by: Da Xue <da@libre.computer>
Diffstat (limited to 'doc/develop/bootstd.rst')
-rw-r--r--doc/develop/bootstd.rst8
1 files changed, 7 insertions, 1 deletions
diff --git a/doc/develop/bootstd.rst b/doc/develop/bootstd.rst
index ec31365357..c47de273ab 100644
--- a/doc/develop/bootstd.rst
+++ b/doc/develop/bootstd.rst
@@ -132,6 +132,9 @@ above bootdev scanning.
Controlling ordering
--------------------
+By default, faster bootdevs (or those which are assumed to be faster) are used
+first, since they are more likely to be able to boot the device quickly.
+
Several options are available to control the ordering of boot scanning:
@@ -151,6 +154,10 @@ bootdevs and their sequence numbers.
bootmeths
~~~~~~~~~
+By default bootmeths are checked in name order. Use `bootmeth list` to see the
+ordering. Note that the `extlinux` and `script` bootmeth is first, to preserve the behaviour
+used by the old distro scripts.
+
This environment variable can be used to control the list of bootmeths used and
their ordering for example::
@@ -164,7 +171,6 @@ controlled by aliases.
The :ref:`usage/cmd/bootmeth:bootmeth command` (`bootmeth order`) operates in
the same way as setting this variable.
-
Bootdev uclass
--------------