Gestionnaire d'entrées d'amorçage Efibootmgr

Mise à jour : Debian 10.8 - Buster

Ce document décrit la gestion des entrées d'amorçage au moyen de la commande efibootmgr

Sommaire

1 - Préalable

Installer la commande efibootmgr depuis le paquet homonyme

$ sudo aptitude install efibootmgr

Note : Les entrées d'amorçage sont définies dans la Nvram de la plate-forme, à la fois

par les demandes de l'utilisateur à travers les commandes efibootmgr
et par le logiciel de gestion de la plate-forme, qui peut procéder, à des modifications, des suppressions, des ajouts pour raisons de fiabilité ou de sécurité. Cet aspect est pris en compte partiellement dans ce document, et peut venir perturber, en particulier après un redémarrage, les informations rentrées par l'utilisateur. De plus ces perturbations peuvent être fonction du type de plate-forme

2 - Liste des entrées

La commande efbootmgr fournit des informations sur les entrées d'amorçage présentes dans la mémoire Nvme de la plate-forme

$ efibootmgr
BootCurrent: 0002
Timeout: 1 seconds
BootOrder: 0002,0004,0001,0000
Boot0000* Windows Boot Manager
Boot0001* debian
Boot0002* debian
Boot0004* UEFI : Built-in EFI Shell

Dans l'exemple ci-dessus,

BootCurrent: 0002 indique que le système a été amorcé depuis l'entrée d'amorçage numéro 2
Timeout: 1 seconds indique que le temps avant amorçage est de 1 seconde
BootOrder: 00202,004,0001,0000 indique l'ordre dans le quel les entrées (présentes ou absentes) seront testées APRES prise en compte de l'ordre des périphériques défini dans l'UEFI de la plateforme

Les lignes de la forme BootNNNN <texte>, par exemple Boot0001 debian indiquent que l'entrée d'amorçage 0001 a pour nom debian. L'astérisque (*) indique des entrées activées

3 - Identification

Chaque entrée est associée à une adresse vers un fichier exécutable, cette adresse pouvant soit être affichée "en clair", soit sous la forme d'un identifiant

$ efibootmgr -v
BootCurrent: 0002
Timeout: 1 seconds
BootOrder: 0002,0004,0001,0000
Boot0000* Windows Boot Manager       VenHw(99e275e7-75a0-4b37-a2e6-c5385e6c00cb)WINDOWS.........x...B.C.D.O.B.J.E.C.T.=.{.9.d.e.a.8.6.2.c.-.5.c.d.d.-.4.e.7.0.-.a.c.c.1.-.f.3.2.b.3.4.4.d.4.7.9.5.}....................
Boot0001* debian  HD(1,GPT,77ed79e1-ae0b-4979-827f-ad7b119d688b,0x1000,0xff000)/File(\EFI\DEBIAN\shimx64.efi)
Boot0002* debian HD(1,GPT,fe906d3a-ed18-4d9a-a6cd-41b14322b3ad,0x800,0x106000)/File(\EFI\debian\shimx64.efi)
Boot0004* UEFI : Built-in EFI Shell      VenMedia(5023b95c-db26-429b-a648-bd47664c8012)..BO

3.1 - Identification par l'adresse

Lorsqu'une adresse correspond à un fichier détecté présent sur la partition ESP d'un disque utilisateur (disque interne ou amovible) lors de l'amorçage, elle est affichée sous la forme de deux champs principaux

Champs 1 > Disque (Numéro, Type de partition, PARTUUID de la partition ESP, ......)

HD(1,GPT,77ed79e1-ae0b-4979-827f-ad7b119d688b,0x1000,0xff000)

Champs 2 >Chemin sur la partition ESP vers le fichier à lancer, par exemple

/File(\EFI\DEBIAN\shimx64.efi)

L'identifiant de partition PARTUUID est l'UUID de la partition et non l'UUID du système de fichier. Dans le système ci-dessus, les fichiers des entrées 0001 et 0002 sont situés sur deux partitions ESP différentes

$ lsblk -o NAME,FSTYPE,PARTUUID |grep vfat
├─sdb1      vfat        77ed79e1-ae0b-4979-827f-ad7b119d688b
├─nvme0n1p1 vfat        fe906d3a-ed18-4d9a-a6cd-41b14322b3ad

L'entrée 0001 debian correspond donc à un fichier situé sur la partition ESP /dev/sdb1
L'entrée 0002 debian correspond donc à un fichier sur la partition ESP /dev/nvme0n1p1

Remarques :

Le nom de l'entrée est généralement, mais pas nécessairement identique au nom du répertoire du fichier dans l'ESP.
Il peut y avoir plusieurs entrées avec le même nom, associées à des entrées différentes (situées sur la même partition ESP ou sur des partitions ESP différentes)
La présence d'un fichier efi sur une partition ESP ne signifie pas qu'une entrée correspondante soit disponible dans la Nvram, mais il est possible d'en créer une : voir plus loin Création entrées

3.2 - Identification par code vendeur

Lorsque l'adresse correspond à un fichier sur une partition ESP utilisateur, mais que le fichier n'a pas été détecté lors du démarrage de la machine (disque amovible non connecté ou fichier déplacé ou supprimé par exemple), elle est remplacée par un code "vendeur"

Boot0001* debian     VenHw(99e275e7-75a0-4b37-a2e6-c5385e6c00cb)

L'adresse d'origine sera à nouveau affiché si le fichier est présent lors d'un prochain démarrage

Lorsque le fichier est situé sur la plate-forme (cas d'un shell uefi interne) un code vendeur est uniquement affiché

Boot0004* UEFI : Built-in EFI Shell  VenMedia(5023b95c-db26-429b-a648-bd47664c8012)..BO

3.3 -Entrée par défaut

Lorsque le système a démarré sur une entrée par défaut (EFI/BOOT/boox64.efi), il crée automatiquement une entrée dans la NVME. Exemple d'une entrée de chargement de grub, sur un disque USB

Boot0005* UEFI : USB : ST9250410AS 0223 : PART 0 : OS Bootloader     PciRoot(0x0)/Pci(0x14,0x0)/USB(1,0)/HD(1,GPT,77ed79e1-ae0b-4979-827f-ad7b119d688b,0x1000,0xff000)..BO

4 - Création - activation - suppression des entrées

4.1 - Création

Les entrées d'amorçage sont généralement créées par grub lors de l'installation sur la partition ESP, il est néanmoins possible de créer "manuellement" une entrée dans la Nvme de la plate-forme.

La commande suivante

crée (option -c ou --create) dans la Nvme de la plate-forme
une entrée de nom (option -L ou --label) "nom de l'entrée"
située sur le disque (option -d ou --disk) /dev/nvme01, partition (option -p ou --part) 1
pour un chargeur d'amorçage (option -l ou --loader) /EFI/GRUB/grubx64.efi
avec priorité d'amorçage 0 (la plus prioritaire)

$ sudo efibootmgr --create --disk /dev/nvme0n1 --part 1 --label "grub" --loader /EFI/GRUB/grubx64.efi
BootOrder: 0004,0007,0006,0003,0000
...
Boot0004* grub
....

->> Attention à la syntaxe du chemin du chargeur d'amorçage

/EFI/GRUB/grubx64.efi                # Pas de quote ou double quote

'\EFI\GRUB\grubx64.efi'           # Simple quote

\\EFI\\GRUB\\grubx64.efi  # Pas de quote ou double quote

-->> Attention, l'entrée est créée dans la Nvme indépendamment du fait qu'elle soit présente et valide dans la partition ESP

Note : L'entrée d'amorçage peut également comprendre un champ utilisé pour passer des paramètres à l'exécutable, par exemple

r.o.o.t.=.U.U.I.D.=.0.6.....e. .r.o. .q.u.i.e.t. .i.n.i.t.r.d.=.\.E.F.I.\.s.t.u.b.\.i.n.i.t.r.d...i.m.g.

voir Linux - Amorçage EFISTUB

4.2 - Activation

Les entrées actives sont marquées par une étoile

$ sudo efibootmgr |grep Boot0000
Boot0000*  Windows Boot Manager
....

Rendre une entrée inactive

$ sudo efibootmgr -b 0 -A |grep Boot0000
Boot0000  Windows Boot Manager

Rendre une entrée active

$ sudo efibootmgr -b 0 -a |grep Boot0000
Boot0000* Windows Boot Manager

4.3 - Suppression

Supprimer l'entrée 0008

$ sudo efibootmgr -b 8 -B

5 - Délai et ordre d'amorçage

5.1 - Délai d'amorçage

Pour modifier le délai d'amorçage (Timeout), par exemple 3s

$ sudo efibootmgr -t 3

Redémarrer pour vérifier la bonne prise en compte. Si la nouvelle valeur n'est pas mémorisée, essayer de modifier directement depuis l'interface UEFI de la machine. Ou bien essayer de supprimer préalablement la valeur :

$ sudo efibootmgr -T

5.2 - Ordre d'amorçage

Note : l'ordre d'amorçage défini par l'utilisateur peut-être modifié par l'uefi, en cas de non détection du fichier de démarrage d'une entrée (cas des medias amovibles) au redémarrage. Il semble que si une entrée n'est pas détectée, sa priorité régresse dans l'ordre de démarrage derrière les autres entrées présentes. Lorsqu'elle sera à nouveau présente, elle ne récupérera pas sa priorité antérieure.

Pour modifier l'ordre d'amorçage, supprimer l'ordre d'amorçage existant (option -O), puis définir le nouvel ordre (option -o)

$ sudo efibootmgr -O
$ sudo efibootmgr -o 7,6,3,8,0 |grep BootOrder
BootOrder: 0007,0006,0003,0008,0000

Pour définir l'entrée d'amorçage à utiliser au prochain redémarrage uniquement (option --bootnext)

$ sudo efibootmgr -n 6