From 2512508fee58a7acd04924d0a52f618d6cbe0139 Mon Sep 17 00:00:00 2001 From: Ani Sinha Date: Tue, 12 Nov 2024 15:52:58 +0530 Subject: [PATCH] uki: describe .fwauto section Add description for the firmware section (`.efifw`) in the specs. --- specs/unified_kernel_image.md | 1 + 1 file changed, 1 insertion(+) diff --git a/specs/unified_kernel_image.md b/specs/unified_kernel_image.md index 97ee6291..089f3258 100644 --- a/specs/unified_kernel_image.md +++ b/specs/unified_kernel_image.md @@ -52,6 +52,7 @@ UKIs consist of the following resources: * Optionally, the initrd that the kernel shall unpack and invoke, in the `.initrd` section. * Optionally, a microcode initrd in the `.ucode` section, to be handed to the kernel before any other initrd. * Optionally, a splash image to bring to screen before transitioning into the Linux kernel, in the `.splash` section. +* Optionally, a firmware image in the `.efifw` section. This UEFI firmware image is an opaque binary blob that can be used as firmware in the next reset. If multiple `.efifw` sections exist then one of them is selected according to the matching hardware. * Optionally, one or more compiled Device Trees, for systems which need it, each in its separate `.dtb` section. If multiple `.dtb` sections exist then one of them is selected according to an implementation-specific algorithm. * Optionally, information describing kernel release information (i.e. `uname -r` output) in the `.uname` section. This is also useful for presentation of the UKI in the boot loader menu, and ordering it against other entries. * Optionally, a CSV file encoding the SBAT metadata for the image, in the `.sbat` section. The [SBAT format is defined by the Shim project](https://github.com/rhboot/shim/blob/main/SBAT.md), and used for UEFI revocation purposes.