Skip to content

Commit

Permalink
uki: make clear that sections at bottom mostly are concerned with loc…
Browse files Browse the repository at this point in the history
…ations/naming of UKIs/addons
  • Loading branch information
poettering authored and bluca committed Jul 5, 2024
1 parent 22e4aee commit 69d14a5
Showing 1 changed file with 7 additions and 8 deletions.
15 changes: 7 additions & 8 deletions specs/unified_kernel_image.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand All @@ -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 `<version format specification>.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
Expand All @@ -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,
Expand Down

0 comments on commit 69d14a5

Please sign in to comment.