|/
|\ISS               Tidbits  Posts  Answers  Install  Wiki  Contact  Donate  GitHub


efibootmgr                      version 4069341e184471dccf407ca8410daa4c4fd634f5
________________________________________________________________________________

This is efibootmgr, a Linux user-space application to modify the Intel
Extensible Firmware Interface (EFI) Boot Manager. This application can create
and destroy boot entries, change the boot order, change the next running boot
option, and more.

Upstream: https://github.com/rhboot/efibootmgr


[000] Index
________________________________________________________________________________

* Installation ........................................................... [001]
* Setup .................................................................. [002]
  * Mounting The efivar Filesystem ....................................... [003]
  * Booting The System With An EFISTUB ................................... [004]
* Usage .................................................................. [005]
* History ................................................................ [006]
* References ............................................................. [007]


[001] Installation
________________________________________________________________________________

+------------------------------------------------------------------------------+
|                                                                              |
|  $ kiss b efibootmgr                                                         |
|                                                                              |
+------------------------------------------------------------------------------+


[002] Setup
________________________________________________________________________________


--[003] Mounting The efivar Filesystem -----------------------------------------

  To use efibootmgr and other software to manipulate the UEFI boot entries, the
  efivars filesystem must be mounted. This isn't handled automatically by KISS
  due to the security implications in doing so. [1]

  +----------------------------------------------------------------------------+
  |                                                                            |
  |  $ mount -t efivarfs none /sys/firmware/efi/efivars/                       |
  |                                                                            |
  +----------------------------------------------------------------------------+


--[004] Booting The System With An EFISTUB -------------------------------------

  Using an EFISTUB to boot the system removes the need for a bootloader and
  shortens boot times. Ensure that the following options are enabled in your
  kernel: CONFIG_EFI, CONFIG_EFI_STUB

  Run the following command to create a boot entry (replacing example arguments
  with their respective values). X and Y should point to where the ESP is
  located.

  +----------------------------------------------------------------------------+
  |                                                                            |
  |  $ efibootmgr \                                                            |
  |        --disk /dev/sdX \                                                   |
  |        --part Y \                                                          |
  |        --create \                                                          |
  |        --label "KISS" \                                                    |
  |        --loader /vmlinuz \                                                 |
  |        --unicode 'root=PARTUUID=XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX rw' \ |
  |        --verbose                                                           |
  |                                                                            |
  +----------------------------------------------------------------------------+


[005] Usage
________________________________________________________________________________

Refer to the manual pages and command help output for more information.


[006] History
________________________________________________________________________________

2021-07-17 bdee486e efibootmgr: update for new env
2021-07-15 a35e998f efibootmgr: use VERSION
2021-07-06 6e5bd2a1 efibootmgr: use latest commit
2021-07-01 e4433ed7 efibootmgr: remove usage of install
2021-07-01 35e7f7be efibootmgr: use new checksums format
2020-02-14 56cfe43e efibootmgr: Remove popt dependency
2020-02-13 acf66a01 efibootmgr: Swap source to pull in needed fixes. Closes #148
2020-02-12 54a7ffdc efibootmgr: Use cc @konimex
2020-01-08 a7ecbd4a efibootmgr: Revert patch
2020-01-07 e36d67f9 efibootmgr: Fix verbose
2019-10-08 c2dce028 efibootmgr: clean clean clean
2019-06-25 80b84491 efibootmgr: Fixed build
2019-06-25 ae65b943 efibootmgr: Fix build.


[007] References
________________________________________________________________________________

[0] https://github.com/rhboot/efibootmgr
[1] https://github.com/systemd/systemd/issues/2402


________________________________________________________________________________

Dylan Araps (C) 2019-2021

The registered trademark Linux(R) is used pursuant to a sublicense from the
Linux Foundation, the exclusive licensee of Linus Torvalds, owner of the mark
on a world­wide basis.