summaryrefslogtreecommitdiff
path: root/man/os-release.xml
diff options
context:
space:
mode:
authorKai Lueke <kailuke@microsoft.com>2022-08-09 17:07:20 +0200
committerKai Lueke <kailuke@microsoft.com>2022-08-15 10:54:32 +0200
commit16c1ca0db4cf6dd33cff1239df8dd9c366cee914 (patch)
treec34d3a4cdeaa0de6ddfba1e6802f33888cb1f5bc /man/os-release.xml
parentab4d43c54e977e5e53a98da3e77fd71a62b4fbfb (diff)
downloadsystemd-16c1ca0db4cf6dd33cff1239df8dd9c366cee914.tar.gz
sysext: introduce ARCHITECTURE field to match host architecture
When an extension image has binaries they should match the host architecture. Currently there is no way to specify this requirement. Introduce an ARCHITECTURE field in the extension's release file that may be set to prevent loading on the wrong host architecture. Since this new field is introduced late, we don't want to make specifying it mandatory as it would break existing sysext images. See https://github.com/systemd/systemd/issues/24061
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 fc880c4765..168c1675a9 100644
--- a/man/os-release.xml
+++ b/man/os-release.xml
@@ -412,6 +412,18 @@
</varlistentry>
<varlistentry>
+ <term><varname>ARCHITECTURE=</varname></term>
+ <listitem><para>A string that specifies which CPU architecture the userspace binaries require.
+ The architecture identifiers are the same as for <varname>ConditionArchitecture=</varname>
+ described in <citerefentry><refentrytitle>systemd.unit</refentrytitle><manvolnum>5</manvolnum></citerefentry>.
+ The field is optional and should only be used when just single architecture is supported.
+ It may provide redundant information when used in a GPT partition with a GUID type that already
+ encodes the architecture. If this is not the case, the architecture should be specified in
+ e.g., an extension image, to prevent an incompatible host from loading it.
+ </para></listitem>
+ </varlistentry>
+
+ <varlistentry>
<term><varname>SYSEXT_LEVEL=</varname></term>
<listitem><para>A lower-case string (mostly numeric, no spaces or other characters outside of 0–9,