path: root/Documentation
diff options
authorEnrico Jorns <>2019-02-15 13:53:46 +0100
committerSascha Hauer <>2019-02-18 14:26:27 +0100
commit2b21c973876587dfa012a2ed892c6786cecec09a (patch)
tree2f74346bb9698414ec5bcf50546d4adb0352e6b1 /Documentation
parent463610e5b831812d9c0e0557aa23525cfdd81ef8 (diff)
doc: bootchooser: be more explicit about when the bootchooser terminates
Signed-off-by: Enrico Jorns <> Signed-off-by: Sascha Hauer <>
Diffstat (limited to 'Documentation')
1 files changed, 3 insertions, 0 deletions
diff --git a/Documentation/user/bootchooser.rst b/Documentation/user/bootchooser.rst
index 0c5e564..00ce896 100644
--- a/Documentation/user/bootchooser.rst
+++ b/Documentation/user/bootchooser.rst
@@ -79,6 +79,9 @@ booting a fallback in case of a permanent failure.
To indicate a successful boot, one must explicitly reset the remaining
attempts counter. See `Marking a Boot as Successful`_.
+The bootchooser algorithm aborts when all enabled targets (priority > 0) have
+no remaining attempts left.
To prevent ending up in an unbootable system after a number of failed boot
attempts, there is a also a built-in mechanism to reset the counters to their defaults,
controlled by the ``global.bootchooser.reset_attempts`` variable. It holds a