From: Lukas Nykryn <lnykryn@redhat.com>
Date: Tue, 1 Oct 2024 09:30:18 +0000 (+0200)
Subject: man: using WantedBy=default.target is not a good idea
X-Git-Tag: v257-rc1~338
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=67b6404b80cf8078f3d9ec6d4c2f34ac25b15077;p=thirdparty%2Fsystemd.git

man: using WantedBy=default.target is not a good idea

We had several users, that wrote their unit files with
WantedBy=default.target because it should be started "every time".
But for example in Fedora/CentOS/RHEL, this often breaks for
example selinux relabels (where we just want to do a relabel and reboot).
---

diff --git a/man/systemd.special.xml b/man/systemd.special.xml
index 192d09732a9..5fa4baed204 100644
--- a/man/systemd.special.xml
+++ b/man/systemd.special.xml
@@ -240,6 +240,11 @@
             names like <varname>single</varname>, <varname>rescue</varname>, <varname>1</varname>,
             <varname>3</varname>, <varname>5</varname>, …; see
             <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>.</para>
+
+            <para>For typical unit files please set <literal>WantedBy=</literal> to a regular target (like
+            <filename>multi-user.target</filename> or <filename>graphical.target</filename>),
+            instead of <filename>default.target</filename>, since such a service will also be run on special
+            boots like on system update, emergency boot…</para>
           </listitem>
         </varlistentry>
         <varlistentry>