From: Sascha Hauer <sha@pengutronix.de>
To: Roland Hieber <rhi@pengutronix.de>
Cc: barebox@lists.infradead.org
Subject: Re: [PATCH] doc: booting-linux: improve Bootloader spec section
Date: Thu, 21 Sep 2023 10:05:53 +0200 [thread overview]
Message-ID: <20230921080553.GB637806@pengutronix.de> (raw)
In-Reply-To: <20230914132028.50261-1-rhi@pengutronix.de>
On Thu, Sep 14, 2023 at 03:20:28PM +0200, Roland Hieber wrote:
> Improve language and clarity of the text, and add formatting.
>
> Signed-off-by: Roland Hieber <rhi@pengutronix.de>
> ---
> Documentation/user/booting-linux.rst | 36 ++++++++++++++--------------
> 1 file changed, 18 insertions(+), 18 deletions(-)
Applied, thanks
Sascha
>
> diff --git a/Documentation/user/booting-linux.rst b/Documentation/user/booting-linux.rst
> index 0ba6229797cd..76883862b938 100644
> --- a/Documentation/user/booting-linux.rst
> +++ b/Documentation/user/booting-linux.rst
> @@ -172,13 +172,14 @@ https://uapi-group.org/specifications/specs/boot_loader_specification/
>
> It follows another philosophy than the :ref:`boot_entries`. With Boot Entries
> booting is completely configured in the bootloader. Bootloader Spec Entries
> -on the other hand the boot entries are on a boot medium. This gives a boot medium
> -the possibility to describe where a Kernel is and what parameters it needs.
> +on the other hand are part of the boot medium. This gives a boot medium
> +the possibility to describe where a kernel is located and which parameters are
> +needed to boot it.
>
> -All Bootloader Spec Entries are in a partition on the boot medium under ``/loader/entries/*.conf``.
> -In the Bootloader Spec a boot medium has a dedicated partition to use for
> -boot entries. barebox is less strict, it accepts Bootloader Spec Entries on
> -every partition barebox can read.
> +All Bootloader Spec Entries are located in a partition on the boot medium under
> +``/loader/entries/*.conf``. According to the Bootloader Spec, a boot medium has
> +to use a dedicated partition for boot entries. barebox is less strict, it
> +accepts Bootloader Spec Entries on every partition that barebox can read.
>
> A Bootloader Spec Entry consists of key value pairs::
>
> @@ -194,7 +195,7 @@ A Bootloader Spec Entry consists of key value pairs::
> All paths are absolute paths in the partition. Bootloader Spec Entries can
> be created manually, but there also is the ``scripts/kernel-install`` tool to
> create/list/modify entries directly on a MMC/SD card or other media. To use
> -it create a SD card / USB memory stick with a /boot partition with type 0xea.
> +it, create an SD card / USB memory stick with a ``/boot`` partition with type ``0xea``.
> The partition can be formatted with FAT or EXT4 filesystem. If you wish to write
> to it from barebox later you must use FAT. The following creates a Bootloader
> Spec Entry on a SD card:
> @@ -206,7 +207,7 @@ Spec Entry on a SD card:
> --kernel=/home/sha/linux/arch/arm/boot/zImage --add-root-option \
> --root=/dev/mmcblk0p1 -o "console=ttymxc0,115200"
>
> -The entry can be listed with the -l option:
> +The entry can be listed with the ``-l`` option:
>
> .. code-block:: sh
>
> @@ -219,23 +220,22 @@ The entry can be listed with the -l option:
> options: console=ttymxc0,115200 root=PARTUUID=0007CB20-01
> linux: 11ab7c89d02c4f66a4e2474ea25b2b84.15/linux
>
> -When on barebox the SD card shows up as ``mmc1`` then this entry can be booted with
> -``boot mmc1`` or with setting ``global.boot.default`` to ``mmc1``.
> +When the SD card shows up as ``mmc1`` in barebox, this entry can be booted with
> +``boot mmc1`` or by setting ``global.boot.default`` to ``mmc1``.
>
> -``machine-id`` is an optional key. If ``global.boot.machine_id`` variable is set to
> -non-empty value, then barebox accepts only Bootloader Spec entries with ``machine-id``
> -key. In case if value of global variable and Bootloader Spec key match each other,
> -barebox will choose the boot entry for booting. All other Bootloader Spec entries will
> -be ignored.
> +``machine-id`` is an optional key. If the ``global.boot.machine_id`` variable
> +is set to a non-empty value, barebox will only boot the Bootloader Spec Entry
> +whose ``machine-id`` key matches the ``global.boot.machine_id`` variable.
> +All other Bootloader Spec entries will be ignored.
>
> -A bootloader spec entry can also reside on an NFS server in which case a RFC2224
> -compatible NFS URI string must be passed to the boot command:
> +A bootloader spec entry can also reside on an NFS server in which case an
> +RFC2224-compatible NFS URI string must be passed to the boot command:
>
> .. code-block:: sh
>
> boot nfs://nfshost[:port]//path/
>
> -Additionally to the options defined in the original spec barebox understands the
> +In addition to the options defined in the original spec barebox understands the
> ``linux-appendroot`` option. This is a boolean value and if set to ``true`` barebox
> will automatically append a ``root=`` string to the Linux commandline based on the
> device where the entry is found on. This makes it possible to use the same rootfs
> --
> 2.39.2
>
>
>
--
Pengutronix e.K. | |
Steuerwalder Str. 21 | http://www.pengutronix.de/ |
31137 Hildesheim, Germany | Phone: +49-5121-206917-0 |
Amtsgericht Hildesheim, HRA 2686 | Fax: +49-5121-206917-5555 |
prev parent reply other threads:[~2023-09-21 8:07 UTC|newest]
Thread overview: 2+ messages / expand[flat|nested] mbox.gz Atom feed top
2023-09-14 13:20 Roland Hieber
2023-09-21 8:05 ` Sascha Hauer [this message]
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=20230921080553.GB637806@pengutronix.de \
--to=sha@pengutronix.de \
--cc=barebox@lists.infradead.org \
--cc=rhi@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