A meta-layer for integration of efibootguard into a yocto project.
You can contribute to the project via pull requests and the mailing list.
Contribution by PR (Pull Request)
Contribution by mailing list:
- Signed patches can be sent to the mailing list efibootguard-dev@googlegroups.com.
- The mailing list is used for "efibootguard" and "meta-efibootguard". Please use for patches the prefix "meta-efibootguard".
git commit -s
git send-email --to=efibootguard-dev@googlegroups.com --confirm=always -M -1 --subject-prefix="meta-efibootguard][PATCH"
Archive:
https://www.mail-archive.com/efibootguard-dev@googlegroups.com
The layer on master branch is compatible with the following Yocto version:
| Version | Codename | LTS |
|---|---|---|
| 5.0 | Scarthgap | Yes |
| 4.0 | Kirkstone | Yes |
The layer on dunfell branch is compatible with the following Yocto version:
| Version | Codename | LTS |
|---|---|---|
| 3.1 | Dunfell | Yes |
Steps:
-
Include this meta layer into your project
-
Set
EFI_PROVIDERto "efibootguard" in your local.conf or in yourconf/machine/<MACHINE>.conf:
EFI_PROVIDER="efibootguard"
-
Provide a project-specific .wks file using the python source plugins of this layer for image creation
-
Build the roots and the hdd image using the new .wks file
# short-description: Create a bootable disk image with efibootguard
# long-description: Creates a partitioned EFI disk image,
# using efibootguard, that the user can directly dd to boot media.
# EFI partition containing efibootguard
part --source efibootguard-efi --size 32 --extra-space 0 --overhead-factor 1 --ondisk mmcblk0 --label efi --part-type=EF00 --align 1024
# Two root partitions for updateability, leave away 2nd if not used
part / --source rootfs --size 1024 --extra-space 0 --overhead-factor 1 --ondisk mmcblk0 --fstype=ext4 --label platform0 --align 1024
part --source rootfs --size 1024 --extra-space 0 --overhead-factor 1 --ondisk mmcblk0 --fstype=ext4 --label plaftorm1 --align 1024
# Two config partitions to load boot configuration and kernel
part --source efibootguard-boot --size 32 --extra-space 0 --overhead-factor 1 --ondisk mmcblk0 --label boot0 --align 1024 --part-type=0700 --sourceparams "watchdog=60,revision=2"
part --source efibootguard-boot --size 32 --extra-space 0 --overhead-factor 1 --ondisk mmcblk0 --label boot1 --align 1024 --part-type=0700 --sourceparams "watchdog=60,revision=1"
# Other partitions
part --size 1024 --extra-space 0 --overhead-factor 1 --ondisk mmcblk0 --label persistent --align 1024 --fstype=ext4
part swap --ondisk mmcblk0 --size 512 --fstype=swap --label swap --align 1024
# Important for type of partition table
bootloader --ptable gpt --append="console=ttyS1,115200n8 reboot=efi,warm rw debugshell=5 rootwait"
NOTE: The --append option to the bootloader gives kernel parameters that are written into the efibootguard environment file.