os-release: Add VERSION_CODENAME field (#3445)

Debian and their derivatives (Ubuntu, Trisquel, etc.) use a code name
for their repositories. Thus record the code name in os-release for
processing.

Closes systemd/systemd#3429

diff --git a/man/os-release.xml b/man/os-release.xml
index 4557abc4a32a620d7fd3561a2519fccd9b3f991c..99bbb61004f7da9deb2f9876a8fbd32a8504f6ad 100644 (file)
--- a/man/os-release.xml
+++ b/man/os-release.xml
@@ -175,6 +175,22 @@
         appropriate.</para></listitem>
       </varlistentry>
 
+      <varlistentry>
+        <term><varname>VERSION_CODENAME=</varname></term>
+
+        <listitem><para>
+        A lower-case string (no spaces or other characters outside of
+        0–9, a–z, ".", "_" and "-") identifying the operating system
+        release code name, excluding any OS name information or
+        release version, and suitable for processing by scripts or
+        usage in generated filenames. This field is optional and may
+        not be implemented on all systems.
+        Examples:
+        <literal>VERSION_CODENAME=buster</literal>,
+        <literal>VERSION_CODENAME=xenial</literal>
+        </para></listitem>
+      </varlistentry>
+
       <varlistentry>
         <term><varname>VERSION_ID=</varname></term>