summaryrefslogtreecommitdiffstats
path: root/man/os-release.xml
diff options
context:
space:
mode:
authorLennart Poettering <lennart@poettering.net>2021-11-18 22:00:31 +0100
committerLennart Poettering <lennart@poettering.net>2021-11-23 22:55:11 +0100
commit60c5f7002bfee928fb8799eb35e5cc95da982a48 (patch)
tree914764af8704c787ece225a0f97aa01afefa4c22 /man/os-release.xml
parentdissect-image: when extracting metadata from image also check if it contains ... (diff)
downloadsystemd-60c5f7002bfee928fb8799eb35e5cc95da982a48.tar.xz
systemd-60c5f7002bfee928fb8799eb35e5cc95da982a48.zip
extension-release.d/: add a new field SYSEXT_SCOPE= for clarifying what a system extension is for
This should make things a bit more robust since it ensures system extension can only applied to the right environments. Right now three different "scopes" are defined: 1. "system" (for regular OS systems, after the initrd transition) 2. "initrd" (for sysext images that apply to the initrd environment) 3. "portable" (for sysext images that apply to portable images) If not specified we imply a default of "system portable", i.e. any image where the field is not specified is implicitly OK for application to OS images and for portable services – but not for initrds.
Diffstat (limited to 'man/os-release.xml')
-rw-r--r--man/os-release.xml12
1 files changed, 12 insertions, 0 deletions
diff --git a/man/os-release.xml b/man/os-release.xml
index ef5ef8b2e1..a985151b4d 100644
--- a/man/os-release.xml
+++ b/man/os-release.xml
@@ -407,6 +407,18 @@
<para>Examples: <literal>SYSEXT_LEVEL=2</literal>, <literal>SYSEXT_LEVEL=15.14</literal>.
</para></listitem>
</varlistentry>
+
+ <varlistentry>
+ <term><varname>SYSEXT_SCOPE=</varname></term>
+ <listitem><para>Takes a space-separated list of one or more of the strings
+ <literal>system</literal>, <literal>initrd</literal> and <literal>portable</literal>. This field is
+ only supported in <filename>extension-release.d/</filename> files and indicates what environments
+ the system extension is applicable to: i.e. to regular systems, to initial RAM filesystems
+ ("initrd") or to portable service images. If unspecified, <literal>SYSEXT_SCOPE=system
+ portable</literal> is implied, i.e. any system extension without this field is applicable to
+ regular systems and to portable service environments, but not to initrd
+ environments.</para></listitem>
+ </varlistentry>
</variablelist>
</refsect2>