From: Bastian Krause <bst@pengutronix.de>
To: barebox@lists.infradead.org
Cc: "Enrico Jörns" <ejo@pengutronix.de>,
"Bastian Krause" <bst@pengutronix.de>
Subject: [PATCH 7/9] doc: bootchooser: document defaults of global.bootchooser.*
Date: Mon, 31 Mar 2025 14:49:30 +0200 [thread overview]
Message-ID: <20250331124932.901033-7-bst@pengutronix.de> (raw)
In-Reply-To: <20250331124932.901033-1-bst@pengutronix.de>
Signed-off-by: Bastian Krause <bst@pengutronix.de>
---
Documentation/user/bootchooser.rst | 20 ++++++++++++--------
1 file changed, 12 insertions(+), 8 deletions(-)
diff --git a/Documentation/user/bootchooser.rst b/Documentation/user/bootchooser.rst
index 01c5c86edb6..53bf5f329fd 100644
--- a/Documentation/user/bootchooser.rst
+++ b/Documentation/user/bootchooser.rst
@@ -37,12 +37,15 @@ following configuration variables are needed to describe a *bootchooser* boot ta
``global.bootchooser.<targetname>.boot``
This controls what barebox actually boots for this boot target. This string can
- contain anything that the :ref:`boot <command_boot>` command understands.
+ contain anything that the :ref:`boot <command_boot>` command understands. If
+ unset, the boot script ``/env/boot/<targetname>`` is called.
``global.bootchooser.<targetname>.default_attempts``
The default number of attempts that a boot target shall be tried before skipping it.
+ Defaults to ``bootchooser.default_attempts``, see below.
``global.bootchooser.<targetname>.default_priority``
The default priority of a boot target.
+ Defaults to ``global.bootchooser.default_priority``, see below.
Additionally the following run-time variables are needed. Unlike the configuration
@@ -125,20 +128,20 @@ options not specific to any boot target.
``global.bootchooser.disable_on_zero_attempts``
Boolean flag. If set to 1, *bootchooser* disables a boot target (sets priority
- to 0) whenever the remaining attempts counter reaches 0.
+ to 0) whenever the remaining attempts counter reaches 0. Defaults to 0.
``global.bootchooser.default_attempts``
The default number of attempts that a boot target shall be tried before skipping
it, used when not overwritten with the boot target specific variable of the same
- name.
+ name. Defaults to 3.
``global.bootchooser.default_priority``
The default priority of a boot target when not overwritten with the target
- specific variable of the same name.
+ specific variable of the same name. Defaults to 1.
``global.bootchooser.reset_attempts``
A space-separated list of conditions (checked during bootchooser start) that
shall cause the ``remaining_attempts`` counters of all enabled targets to be
reset. Possible values:
- * empty: Counters will never be reset.
+ * empty: Counters will never be reset (default).
* ``power-on``: If a power-on reset (``$global.system.reset="POR"``) is detected.
Happens after a power cycle.
* ``reset``: If a generic reset (``$global.system.reset="RST"``) is detected.
@@ -148,21 +151,22 @@ options not specific to any boot target.
A space-separated list of conditions (checked during bootchooser start) that
shall cause the ``priority`` of all boot targets to be reset. Possible values:
- * empty: Priorities will never be reset.
+ * empty: Priorities will never be reset (default).
* ``all-zero``: If all boot targets have zero ``priority``.
``global.bootchooser.retry``
If set to 1, *bootchooser* retries booting until one succeeds or no more valid
boot targets exist.
Otherwise the ``boot`` command will return with an error after the first failed
- boot target.
+ boot target. Defaults to 0.
``global.bootchooser.state_prefix``
If set, this makes *bootchooser* use the *state* framework as backend for
storing run-time data and defines the name of the state instance to use, see
- :ref:`below <bootchooser,state_framework>`.
+ :ref:`below <bootchooser,state_framework>`. Defaults to an empty string.
``global.bootchooser.targets``
Space-separated list of boot targets that are used. For each entry in the list
a corresponding
set of ``global.bootchooser.<targetname>.<variablename>`` variables must exist.
+ Defaults to an empty string.
``global.bootchooser.last_chosen``
*bootchooser* sets this to the boot target that was chosen on last boot (index).
--
2.39.5
next prev parent reply other threads:[~2025-03-31 12:50 UTC|newest]
Thread overview: 10+ messages / expand[flat|nested] mbox.gz Atom feed top
2025-03-31 12:49 [PATCH 1/9] doc: bootchooser: drop article before bootchooser Bastian Krause
2025-03-31 12:49 ` [PATCH 2/9] doc: bootchooser: drop confusing description for "remaining_attempts" Bastian Krause
2025-03-31 12:49 ` [PATCH 3/9] doc: bootchooser: clarify marking boot successful from barebox Bastian Krause
2025-03-31 12:49 ` [PATCH 4/9] doc: bootchooser: don't recommend NV backend Bastian Krause
2025-03-31 12:49 ` [PATCH 5/9] doc: bootchooser: move global.bootchooser.reset_attempts docs down to other variables Bastian Krause
2025-03-31 12:49 ` [PATCH 6/9] doc: bootchooser: rephrase global.bootchooser.reset_priorities description Bastian Krause
2025-03-31 12:49 ` Bastian Krause [this message]
2025-03-31 12:49 ` [PATCH 8/9] doc: bootchooser: rephrase scenarios Bastian Krause
2025-03-31 12:49 ` [PATCH 9/9] doc: bootchooser: document NV storage backend separately Bastian Krause
2025-04-01 6:06 ` [PATCH 1/9] doc: bootchooser: drop article before bootchooser Sascha Hauer
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20250331124932.901033-7-bst@pengutronix.de \
--to=bst@pengutronix.de \
--cc=barebox@lists.infradead.org \
--cc=ejo@pengutronix.de \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox