From: Zbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl>
Date: Fri, 21 May 2021 09:11:01 +0000 (+0200)
Subject: man: say that initrd-release is like os-release
X-Git-Tag: v249-rc1~173^2~1
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=c0527e1f951a9fafb6009445c365bc41f5992817;p=thirdparty%2Fsystemd.git

man: say that initrd-release is like os-release
---

diff --git a/man/os-release.xml b/man/os-release.xml
index 52323df6c7d..fb24eda1825 100644
--- a/man/os-release.xml
+++ b/man/os-release.xml
@@ -16,12 +16,14 @@
 
   <refnamediv>
     <refname>os-release</refname>
+    <refname>initrd-release</refname>
     <refpurpose>Operating system identification</refpurpose>
   </refnamediv>
 
   <refsynopsisdiv>
     <para><filename>/etc/os-release</filename></para>
     <para><filename>/usr/lib/os-release</filename></para>
+    <para><filename>/etc/initrd-release</filename></para>
   </refsynopsisdiv>
 
   <refsect1>
@@ -79,6 +81,19 @@
     <para>For a longer rationale for <filename>os-release</filename>
     please refer to the <ulink
     url="http://0pointer.de/blog/projects/os-release">Announcement of <filename>/etc/os-release</filename></ulink>.</para>
+
+    <refsect2>
+      <title><filename>/etc/initrd-release</filename></title>
+
+      <para>In the <ulink
+      url="https://www.kernel.org/doc/html/latest/admin-guide/initrd.html">initrd</ulink>,
+      <filename>/etc/initrd-release</filename> plays the same role as <filename>os-release</filename> in the
+      main system. Additionally, the presence of that file means that the system is in the initrd phase.
+      <filename>/etc/os-release</filename> should be symlinked to <filename>/etc/initrd-release</filename>
+      (or vice versa), so programs that only look for <filename>/etc/os-release</filename> (as described
+      above) work correctly. The rest of this document that talks about <filename>os-release</filename>
+      should be understood to apply to <filename>initrd-release</filename> too.</para>
+    </refsect2>
   </refsect1>
 
   <refsect1>
diff --git a/man/rules/meson.build b/man/rules/meson.build
index 05b087db3e6..1cfb54723ae 100644
--- a/man/rules/meson.build
+++ b/man/rules/meson.build
@@ -61,7 +61,7 @@ manpages = [
  ['org.freedesktop.resolve1', '5', [], 'ENABLE_RESOLVE'],
  ['org.freedesktop.systemd1', '5', [], ''],
  ['org.freedesktop.timedate1', '5', [], 'ENABLE_TIMEDATED'],
- ['os-release', '5', [], ''],
+ ['os-release', '5', ['initrd-release'], ''],
  ['pam_systemd', '8', [], 'HAVE_PAM'],
  ['pam_systemd_home', '8', [], 'ENABLE_PAM_HOME'],
  ['portablectl', '1', [], 'ENABLE_PORTABLED'],