diff --git a/specs/unified_kernel_image.md b/specs/unified_kernel_image.md index 702bc93..147e74f 100644 --- a/specs/unified_kernel_image.md +++ b/specs/unified_kernel_image.md @@ -192,7 +192,7 @@ individual resources listed above at once, and their combination. Standard Linux [`pesign`](https://github.com/rhboot/pesign) can be used to sign UKI files. The signature format and process again match the ones already used for PE files, so they will not be redefined here. -## Distribution-built UKIs Installed by Package Managers +## Locations for Distribution-built UKIs Installed by Package Managers UKIs that are built centrally by distributions and installed via the package manager should be installed in `/usr/lib/modules/$UNAME/`, where `$UNAME` is the output of `uname -r` of the kernel included in the UKI, so @@ -201,13 +201,12 @@ that tools staging or consuming UKIs have a common place to store and look for t The installed UKIs should have a filename `.efi`, i.e. the filename is left to implementers but must be valid for comparisons according to the [Version Format Specification](version_format_specification.md). -### Auxiliary resources +## Locations and Naming for UKI Auxiliary Resources -Auxiliary UKI resources (such as PE addons for command line extensions and similar, -as well as systemd-sysext and systemd-confext DDIs) built centrally by distributions and -installed via package manager should be installed into locations depending on -whether they should be applied to all UKIs installed in the ESP, or only to a -single specific UKI. +Auxiliary UKI resources (such as PE addons for kernel command line extensions and similar, as well as +systemd-sysext and systemd-confext DDIs) built centrally by distributions and installed via package manager +should be installed into locations depending on whether they should be applied to all UKIs installed in the +ESP, or only to a single specific UKI. UKI auxiliary resources that apply to *all* installed UKIs should be installed into `/usr/lib/modules/uki.extra.d/`. UKI auxiliary resources that @@ -222,7 +221,7 @@ depends on the resource type: * `.sysext.raw` for sysext DDIs, * `.confext.raw` for confext DDIs -#### Example +### Example Given a UKI `bar_123.efi` that includes a kernel `6.9.1-1.foo`, consider * a PE addon `machine-id` that should apply to all installed UKIs,