summaryrefslogtreecommitdiffstats
path: root/man/os-release.xml
diff options
context:
space:
mode:
authorAdrian Vovk <adrianvovk@gmail.com>2024-05-23 00:06:54 +0200
committerLuca Boccassi <bluca@debian.org>2024-08-01 18:22:13 +0200
commit7102dc52e6b03248da1f01b3a8a4b83c6d7a1316 (patch)
tree161abab72b0de3fa5bb246c3e6504ca9d8c1ffb9 /man/os-release.xml
parenttest: attempt to install sshd-session from multiple places (diff)
downloadsystemd-7102dc52e6b03248da1f01b3a8a4b83c6d7a1316.tar.xz
systemd-7102dc52e6b03248da1f01b3a8a4b83c6d7a1316.zip
os-release: Add RELEASE_TYPE=
This will allow GUIs to customize their behavior a little based on the type of release. For example, an OS installer may display a warning/disclaimer if RELEASE_TYPE=prerelease. The software updates app might be a bit more insistent about upgrading to the next major release if RELEASE_TYPE=stable than if RELEASE_TYPE=lts
Diffstat (limited to 'man/os-release.xml')
-rw-r--r--man/os-release.xml23
1 files changed, 23 insertions, 0 deletions
diff --git a/man/os-release.xml b/man/os-release.xml
index afdb21fc57..32edc088df 100644
--- a/man/os-release.xml
+++ b/man/os-release.xml
@@ -325,6 +325,29 @@
<xi:include href="version-info.xml" xpointer="v249"/></listitem>
</varlistentry>
+
+ <varlistentry>
+ <term><varname>RELEASE_TYPE=</varname></term>
+
+ <listitem><para>A lower-case string (no spaces or other characters outside of 0-9, a-z, ".",
+ "_", and "-"), describing what kind of release this version of the OS is. Known values follow:
+ <literal>stable</literal> is for normal releases of the system, suitable for production use.
+ Generally, stable releases become end-of-life soon after the next major stable release is out.
+ Examples include Fedora 40, Ubuntu 23.10, OpenSUSE Tumbleweed, and Arch Linux.
+ <literal>lts</literal> is for long term support releases of the system, suitable for production
+ use and supported for an extended period of time. Generally, LTS releases continue to recieve
+ support even if newer major releases of the distribution are available. Examples include Ubuntu
+ 24.04, Debian 12 Bookworm and RHEL 9.4.
+ <literal>pre-release</literal> is for unstable versions of the system, unsuitable for production
+ use, such as alpha, beta, or rolling unstable releases. Examples include Fedora Rawhide, Debian
+ Testing, Fedora 40 Beta, and GNOME OS Nightly.
+ If unset, or an unknown value, assume that the release is <literal>stable</literal>.</para>
+
+ <para>Examples: <literal>RELEASE_TYPE=pre-release</literal>, <literal>RELEASE_TYPE=lts</literal>.
+ </para>
+
+ <xi:include href="version-info.xml" xpointer="v257"/></listitem>
+ </varlistentry>
</variablelist>
<para>To summarize: if the image updates are built and shipped as comprehensive units,