Expand description
Β§Boot Loader Specification entry management
This module implements support for merging disparate kernel argument sources
into the single BLS entry options field. Each source (e.g., TuneD, admin,
bootc kargs.d) can independently manage its own set of kernel arguments,
which are tracked via x-options-source-<name> extension keys in BLS config
files.
See https://github.com/ostreedev/ostree/pull/3570 See https://github.com/bootc-dev/bootc/issues/899
StructsΒ§
- Source
Name π - A validated source name (alphanumeric + hyphens + underscores, non-empty).
ConstantsΒ§
- OPTIONS_
SOURCE_ πKEY_ PREFIX - The BLS extension key prefix for source-tracked options.
- OSTREE_
BOOTCONFIG_ πEXTRA_ VERSION - The ostree release (year, release) that introduced
bootconfig-extraserialization, which preservesx-prefixed BLS keys across staged deployment roundtrips. See https://github.com/ostreedev/ostree/pull/3570.
FunctionsΒ§
- compute_
merged_ πoptions - Compute the merged
optionsline from all sources. - extract_
source_ πoptions_ from_ bls - Extract source options from BLS entry content. Parses
x-options-source-*keys from the raw BLS text since the ostree BootconfigParser doesnβt expose key iteration. - ostree_
supports_ πbootconfig_ extra - Whether the libostree loaded at runtime supports
bootconfig-extra. - read_
bls_ πentry_ for_ deployment - Read the BLS entry file content for a deployment from /boot/loader/entries/.
- read_
staged_ πbootconfig_ extra_ sources - Read x-options-source-* keys from the staged deployment data file.
- set_
options_ πfor_ source_ staged - Set the kernel arguments for a specific source via ostree staged deployment.
- unsupported_
ostree_ πerror - The error reported when the host ostree lacks
bootconfig-extrasupport.