summaryrefslogtreecommitdiffstats
path: root/man/os-release.xml
diff options
context:
space:
mode:
authorLuca Boccassi <luca.boccassi@microsoft.com>2020-05-22 17:05:12 +0200
committerLuca Boccassi <luca.boccassi@microsoft.com>2020-06-23 13:57:05 +0200
commit34e0d56ce23fcdfd264ad5e8ada58a520c23a80f (patch)
tree0254a326366ae75d36e23669dfd878ce12535d9c /man/os-release.xml
parentnspawn: use mkdir_p_safe instead of homegrown version (diff)
downloadsystemd-34e0d56ce23fcdfd264ad5e8ada58a520c23a80f.tar.xz
systemd-34e0d56ce23fcdfd264ad5e8ada58a520c23a80f.zip
Container interface: document exposing the host's os-release
In order to allow applications to detect the host OS version or other metadata, ask container managers to expose the os-release files as read-only bind mounts. For systemd-nspawn, we will also expose ID, BUILD_ID, VERSION_ID and VARIANT_ID as lowercase environment variables prefixed by the container_host_ string.
Diffstat (limited to 'man/os-release.xml')
-rw-r--r--man/os-release.xml7
1 files changed, 7 insertions, 0 deletions
diff --git a/man/os-release.xml b/man/os-release.xml
index a2e3d0d8ac..675daf3ede 100644
--- a/man/os-release.xml
+++ b/man/os-release.xml
@@ -339,6 +339,13 @@
name in order to avoid name clashes. Applications
reading this file must ignore unknown fields. Example:
<literal>DEBIAN_BTS="debbugs://bugs.debian.org/"</literal></para>
+
+ <para>Container and sandbox runtime managers may make the host's
+ identification data available to applications by providing the host's
+ <filename>/etc/os-release</filename> and
+ <filename>/usr/lib/os-release</filename> as respectively
+ <filename>/run/host/etc/os-release</filename> and
+ <filename>/run/host/usr/lib/os-release</filename>.</para>
</refsect1>
<refsect1>