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

diff --git a/man/os-release.xml b/man/os-release.xml
index 52323df6c7de1317490e311fee91c1a4b5aa027c..fb24eda18252c94102eeca6bdde5f3c433149ff5 100644 (file)
--- 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 05b087db3e6921b60c933dfbe2ffa57a123ba96a..1cfb54723aeccb03f4be53b8b2eb92dcc644bdb8 100644 (file)
--- 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'],