From: Heinrich Schuchardt <xypron.glpk@gmx.de>
To: Masahisa Kojima <masahisa.kojima@linaro.org>, u-boot@lists.denx.de
Cc: Ilias Apalodimas <ilias.apalodimas@linaro.org>,
Simon Glass <sjg@chromium.org>,
Takahiro Akashi <takahiro.akashi@linaro.org>,
Francois Ozog <francois.ozog@linaro.org>,
Mark Kettenis <mark.kettenis@xs4all.nl>
Subject: Re: [PATCH v4 11/11] doc:bootmenu: add UEFI boot variable and distro boot support
Date: Sat, 2 Apr 2022 07:51:45 +0200 [thread overview]
Message-ID: <660bd1d7-fc6d-3a7c-c404-bece11c80941@gmx.de> (raw)
In-Reply-To: <20220324135443.1571-12-masahisa.kojima@linaro.org>
On 3/24/22 14:54, Masahisa Kojima wrote:
> The bootmenu enumerates the UEFI boot variable and distro boot
> (boot_targets) for boot device selection.
>
> Signed-off-by: Masahisa Kojima <masahisa.kojima@linaro.org>
> ---
> Newly created in v4
>
> doc/usage/bootmenu.rst | 65 ++++++++++++++++++++++++++++++++++++++++++
In origin/master the file is called doc/usage/cmd/bootmenu.rst.
> 1 file changed, 65 insertions(+)
>
> diff --git a/doc/usage/bootmenu.rst b/doc/usage/bootmenu.rst
> index 1f094ad6ed..dc1d22062b 100644
> --- a/doc/usage/bootmenu.rst
> +++ b/doc/usage/bootmenu.rst
> @@ -93,3 +93,68 @@ When you intend to use the bootmenu on a color frame buffer console,
> make sure to additionally define::
>
> CONFIG_CFB_CONSOLE_ANSI=y
> +
> +UEFI boot variable enumeration
> +==============================
> +
> +The bootmenu automatically generates the UEFI boot variable("BOOT####")
How do you ensure that those variables that are autogenerated are not saved?
> +in order of "BootOrder". When the user selects the UEFI boot
> +variable entry, bootmenu sets the selected boot variable index
> +to "BootNext", then call the uefi boot manager with the command
> +"bootefi bootmgr".
> +
> +The bootmenu automatically enumerates the possible bootable
> +media devices supporting EFI_SIMPLE_FILE_SYSTEM_PROTOCOL.
> +
> +The bootmenu prints the EFI_LOAD_OPTION.Description[] as title
> +of the entry together with "UEFI" prefix and BOOT#### variable name.
> +
> +Example bootmenu is as below::
> +
> + *** U-Boot Boot Menu ***
> +
> + UEFI BOOT0000 : mmc0:1
> + UEFI BOOT0001 : mmc0:2
> + UEFI BOOT0002 : debian
> + UEFI BOOT0003 : nvme0:1
> + UEFI BOOT0004 : ubuntu
> + UEFI BOOT0005 : nvme0:2
> + UEFI BOOT0006 : usb0:2
> +
> +To scan the discoverable devices connected to the buses such as
> +USB and PCIe prior to bootmenu showing up, CONFIG_PREBOOT can be
> +used to run the command before showing the bootmenu, i.e.::
> +
> + CONFIG_USE_PREBOOT=y
> + CONFIG_PREBOOT="pci enum; usb start; scsi scan; nvme scan; virtio scan"
> +
> +distro boot command enumeration
> +===============================
> +
> +The bootmenu also automatically generates the entries for
> +distro boot command. The bootmenu shows the devices in boot_targets
> +environment variable.
> +When the user selects the distro boot command entry, the bootmenu
> +runs the command defined in "bootcmd_xxx" environment variable.
> +As an example, if user selects "usb0" entry, bootmenu runs the
> +command defined in "bootcmd_usb0".
> +
> +Example boot_targets::
> +
> + usb0, scsi0, nvme0, dhcp
> +
> +Example bootmenu is as below::
> +
> + *** U-Boot Boot Menu ***
> +
> + distro_boot : usb0
> + distro_boot : scsi0
> + distro_boot : nvme0
> + distro_boot : dhcp
> +
> +Disable to enter the U-Boot console
> +===================================
> +
> +To improve the product security, U-Boot console can be disabled by::
> +
> + CONFIG_CMD_BOOTMENU_ENTER_UBOOT_CONSOLE=n
The man page should have a section 'Configuration' which lists all
relevant configuration options for the bootmenu command.
next prev parent reply other threads:[~2022-04-02 5:51 UTC|newest]
Thread overview: 43+ messages / expand[flat|nested] mbox.gz Atom feed top
2022-03-24 13:54 [PATCH v4 00/11] enable menu-driven boot device selection Masahisa Kojima
2022-03-24 13:54 ` [PATCH v4 01/11] bootmenu: fix menu API error handling Masahisa Kojima
2022-03-30 8:55 ` Ilias Apalodimas
2022-03-24 13:54 ` [PATCH v4 02/11] lib/charset: add u16_strlcat() function Masahisa Kojima
2022-04-02 7:14 ` Heinrich Schuchardt
2022-04-04 14:50 ` Masahisa Kojima
2022-04-16 7:32 ` Heinrich Schuchardt
2022-04-18 7:47 ` Masahisa Kojima
2022-04-28 7:45 ` Masahisa Kojima
2022-03-24 13:54 ` [PATCH v4 03/11] test: unit test for u16_strlcat() Masahisa Kojima
2022-04-02 7:47 ` Heinrich Schuchardt
2022-04-04 14:54 ` Masahisa Kojima
2022-03-24 13:54 ` [PATCH v4 04/11] menu: always show the menu regardless of the number of entry Masahisa Kojima
2022-04-02 7:56 ` Heinrich Schuchardt
2022-03-24 13:54 ` [PATCH v4 05/11] efi_loader: export efi_locate_device_handle() Masahisa Kojima
2022-04-01 5:43 ` Ilias Apalodimas
2022-03-24 13:54 ` [PATCH v4 06/11] efi_loader: bootmgr: add booting from removable media Masahisa Kojima
2022-03-30 19:13 ` Ilias Apalodimas
2022-03-31 0:51 ` Masahisa Kojima
2022-03-31 6:25 ` Ilias Apalodimas
2022-04-02 6:12 ` Heinrich Schuchardt
2022-04-04 6:48 ` Masahisa Kojima
2022-04-04 21:54 ` Heinrich Schuchardt
2022-03-24 13:54 ` [PATCH v4 07/11] bootmenu: add UEFI and disto_boot entries Masahisa Kojima
2022-04-01 6:08 ` Ilias Apalodimas
2022-04-02 6:33 ` Heinrich Schuchardt
2022-04-04 8:10 ` Masahisa Kojima
2022-03-24 13:54 ` [PATCH v4 08/11] bootmenu: factor out the user input handling Masahisa Kojima
2022-03-24 13:54 ` [PATCH v4 09/11] efi_loader: add menu-driven UEFI Boot Variable maintenance Masahisa Kojima
2022-03-31 8:31 ` Ilias Apalodimas
2022-04-14 9:25 ` Masahisa Kojima
2022-03-24 13:54 ` [PATCH v4 10/11] bootmenu: add removable media entries Masahisa Kojima
2022-03-31 8:48 ` Ilias Apalodimas
2022-03-31 10:18 ` Masahisa Kojima
2022-04-04 22:00 ` Heinrich Schuchardt
2022-03-24 13:54 ` [PATCH v4 11/11] doc:bootmenu: add UEFI boot variable and distro boot support Masahisa Kojima
2022-04-02 5:51 ` Heinrich Schuchardt [this message]
2022-03-25 1:20 ` [PATCH v4 00/11] enable menu-driven boot device selection Takahiro Akashi
2022-03-25 6:57 ` Masahisa Kojima
2022-04-02 5:48 ` Heinrich Schuchardt
2022-04-04 6:10 ` Masahisa Kojima
2022-04-16 6:46 ` Heinrich Schuchardt
2022-04-28 7:35 ` Masahisa Kojima
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=660bd1d7-fc6d-3a7c-c404-bece11c80941@gmx.de \
--to=xypron.glpk@gmx.de \
--cc=francois.ozog@linaro.org \
--cc=ilias.apalodimas@linaro.org \
--cc=mark.kettenis@xs4all.nl \
--cc=masahisa.kojima@linaro.org \
--cc=sjg@chromium.org \
--cc=takahiro.akashi@linaro.org \
--cc=u-boot@lists.denx.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;
as well as URLs for NNTP newsgroup(s).