Skip to content

UAPI.1: introduce "extra" stanza #212

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
brauner merged 1 commit into from
Apr 21, 2026
+12 −0
Merged

UAPI.1: introduce "extra" stanza #212

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 12 additions & 0 deletions specs/boot_loader_specification.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -361,6 +361,16 @@ The following keys are recognized:

Example: `profile 1`

* `extra` refers to additional resources to pass to the invoked kernel. This takes a path relative to the
root of the file system containing the snippet itself, referring to a regular file. The file name must be
suffixed with a recognized suffix which indicates the type of additional resource. Currently, recognized
suffixes are `.confext.raw` (for systemd-style configuration extension DDIs), `.sysext.raw` (for
systemd-style system extenion configuration extension DDIs) and `.cred` (for systemd-style encrypted system
credential files). In future additional suffixes will be defined and implementations must gracefully handle
unrecognized suffixes. This key may appear multiple times.

Example: `extra /6a9857a393724b7a981ebb5b8495b9ea/somedata.cred`

Each boot loader menu entry drop-in snippet must include at least a `linux` or an `efi`
key. Here is an example for a complete drop-in file:

Expand All @@ -373,6 +383,8 @@ key. Here is an example for a complete drop-in file:
architecture x64
linux /6a9857a393724b7a981ebb5b8495b9ea/3.8.0-2.fc19.x86_64/linux
initrd /6a9857a393724b7a981ebb5b8495b9ea/3.8.0-2.fc19.x86_64/initrd
extra /6a9857a393724b7a981ebb5b8495b9ea/3.8.0-2.fc19.x86_64/somedata.cred
extra /6a9857a393724b7a981ebb5b8495b9ea/3.8.0-2.fc19.x86_64/somethingelse.cred
Comment thread
brauner marked this conversation as resolved.

On EFI systems all Linux kernel images *should* be EFI PE images, or in case of the `uki` or `uki-url` key
*must* be EFI PE images conforming to the [UKI Specification](unified_kernel_image.md). In order to increase
Expand Down
Loading