summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorMartyn Welch <[email protected]>2024-10-09 14:15:38 +0100
committerTom Rini <[email protected]>2024-10-15 10:24:27 -0600
commitd2faad3ff31f0fab0cf280c05ee333992f7a7d27 (patch)
treedb4686097e1a44fb9717dc4ab0c79916a896c684 /doc
parentd2061828a4c1b60b44cd2307b6a782ac2efbffbe (diff)
boot: pxe_utils: Add fallback support
When configured correctly, we can detect when boot fails after the boot process has been handed over to the kernel through the use of U-Boot's bootcount support. In some instances, such as when we are performing atomic updates via a system such as OSTree, it is desirable to provide a fallback option so that we can return to a previous (hopefully working) state. Add a "fallback" option to the supported extlinux configuration options that points to a label like "default" so that we can utilise this in later commits. Signed-off-by: Martyn Welch <[email protected]> Reviewed-by: Simon Glass <[email protected]>
Diffstat (limited to 'doc')
-rw-r--r--doc/README.pxe5
1 files changed, 5 insertions, 0 deletions
diff --git a/doc/README.pxe b/doc/README.pxe
index 172201093d0..af2e64a5776 100644
--- a/doc/README.pxe
+++ b/doc/README.pxe
@@ -120,6 +120,11 @@ Unrecognized commands are ignored.
default <label> - the label named here is treated as the default and is
the first label 'pxe boot' attempts to boot.
+fallback <label> - the label named here is treated as a fallback option that
+ may be attempted should it be detected that booting of
+ the default has failed to complete, for example via
+ U-Boot's boot count limit functionality.
+
menu title <string> - sets a title for the menu of labels being displayed.
menu include <path> - use tftp to retrieve the pxe file at <path>, which