summaryrefslogtreecommitdiffstats
path: root/man/systemd-sysext.xml
diff options
context:
space:
mode:
authorKai Lueke <kailuke@microsoft.com>2022-08-09 13:34:18 +0200
committerKai Lueke <kailuke@microsoft.com>2022-08-15 10:51:01 +0200
commitab4d43c54e977e5e53a98da3e77fd71a62b4fbfb (patch)
tree6254849284a4f0c44be765528c8ba5c4122d259f /man/systemd-sysext.xml
parentcore/cgroup: use bus locator (#24251) (diff)
downloadsystemd-ab4d43c54e977e5e53a98da3e77fd71a62b4fbfb.tar.xz
systemd-ab4d43c54e977e5e53a98da3e77fd71a62b4fbfb.zip
sysext: support distribution-independent extensions using ID=_any
A sysext image that merely contains static binaries has no dependency on the host distribution and should be able to be used anywhere. Support the special '_any' value for the ID field in the extension to opt-out of ID and VERSION_ID/SYSEXT_LEVEL matching. See https://github.com/systemd/systemd/issues/24061
Diffstat (limited to 'man/systemd-sysext.xml')
-rw-r--r--man/systemd-sysext.xml5
1 files changed, 3 insertions, 2 deletions
diff --git a/man/systemd-sysext.xml b/man/systemd-sysext.xml
index 42e8e12df9..c2cf87c9cb 100644
--- a/man/systemd-sysext.xml
+++ b/man/systemd-sysext.xml
@@ -115,8 +115,9 @@
<para>A simple mechanism for version compatibility is enforced: a system extension image must carry a
<filename>/usr/lib/extension-release.d/extension-release.<replaceable>$name</replaceable></filename>
file, which must match its image name, that is compared with the host <filename>os-release</filename>
- file: the contained <varname>ID=</varname> fields have to match, as well as the
- <varname>SYSEXT_LEVEL=</varname> field (if defined). If the latter is not defined, the
+ file: the contained <varname>ID=</varname> fields have to match unless <literal>_any</literal> is set
+ for the extension. If the extension <varname>ID=</varname> is not <literal>_any</literal>, the
+ <varname>SYSEXT_LEVEL=</varname> field (if defined) has to match. If the latter is not defined, the
<varname>VERSION_ID=</varname> field has to match instead. System extensions should not ship a
<filename>/usr/lib/os-release</filename> file (as that would be merged into the host
<filename>/usr/</filename> tree, overriding the host OS version data, which is not desirable). The