Container interface: document exposing the host's os-release

[thirdparty/systemd.git] / man / os-release.xml

diff --git a/man/os-release.xml b/man/os-release.xml
index 5a5e318f75bd3c6713880328eee8534893402719..675daf3ede59abd44938323606f21a9350e7f198 100644 (file)
--- a/man/os-release.xml
+++ b/man/os-release.xml
@@ -192,13 +192,11 @@
       <varlistentry>
         <term><varname>ANSI_COLOR=</varname></term>
 
-        <listitem><para>A suggested presentation color when showing
-        the OS name on the console. This should be specified as string
-        suitable for inclusion in the ESC [ m ANSI/ECMA-48 escape code
-        for setting graphical rendition. This field is optional.
-        Example: <literal>ANSI_COLOR="0;31"</literal> for red, or
-        <literal>ANSI_COLOR="1;34"</literal> for light
-        blue.</para></listitem>
+        <listitem><para>A suggested presentation color when showing the OS name on the console. This should
+        be specified as string suitable for inclusion in the ESC [ m ANSI/ECMA-48 escape code for setting
+        graphical rendition. This field is optional.  Example: <literal>ANSI_COLOR="0;31"</literal> for red,
+        <literal>ANSI_COLOR="1;34"</literal> for light blue, or
+        <literal>ANSI_COLOR="0;38;2;60;110;180"</literal> for Fedora blue.</para></listitem>
       </varlistentry>
 
       <varlistentry>
@@ -220,7 +218,7 @@
         <term><varname>BUG_REPORT_URL=</varname></term>
         <term><varname>PRIVACY_POLICY_URL=</varname></term>
 
-        <listitem><para>Links to resources on the Internet related to 
+        <listitem><para>Links to resources on the Internet related to
         the operating system.
         <varname>HOME_URL=</varname> should refer to the homepage of
         the operating system, or alternatively some homepage of the
@@ -341,20 +339,37 @@
     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>
     <title>Example</title>
 
     <programlisting>NAME=Fedora
-VERSION="17 (Beefy Miracle)"
+VERSION="32 (Workstation Edition)"
 ID=fedora
-VERSION_ID=17
-PRETTY_NAME="Fedora 17 (Beefy Miracle)"
-ANSI_COLOR="0;34"
-CPE_NAME="cpe:/o:fedoraproject:fedora:17"
+VERSION_ID=32
+PRETTY_NAME="Fedora 32 (Workstation Edition)"
+ANSI_COLOR="0;38;2;60;110;180"
+LOGO=fedora-logo-icon
+CPE_NAME="cpe:/o:fedoraproject:fedora:32"
 HOME_URL="https://fedoraproject.org/"
-BUG_REPORT_URL="https://bugzilla.redhat.com/"</programlisting>
+DOCUMENTATION_URL="https://docs.fedoraproject.org/en-US/fedora/f32/system-administrators-guide/"
+SUPPORT_URL="https://fedoraproject.org/wiki/Communicating_and_getting_help"
+BUG_REPORT_URL="https://bugzilla.redhat.com/"
+REDHAT_BUGZILLA_PRODUCT="Fedora"
+REDHAT_BUGZILLA_PRODUCT_VERSION=32
+REDHAT_SUPPORT_PRODUCT="Fedora"
+REDHAT_SUPPORT_PRODUCT_VERSION=32
+PRIVACY_POLICY_URL="https://fedoraproject.org/wiki/Legal:PrivacyPolicy"
+VARIANT="Workstation Edition"
+VARIANT_ID=workstation</programlisting>
   </refsect1>
 
   <refsect1>