summaryrefslogtreecommitdiff
path: root/man/systemd.special.xml
diff options
context:
space:
mode:
authorZbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl>2018-09-14 16:39:47 +0200
committerZbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl>2018-09-14 16:39:47 +0200
commit4aabca00581f262fc0c5a1a31ab3978e68cb0ddf (patch)
treeac82d72a6fce7e51e53881e91efef2292c21b26f /man/systemd.special.xml
parent23a9ffb0935b6814c6b267fe22f94f1436bb7a5e (diff)
downloadsystemd-4aabca00581f262fc0c5a1a31ab3978e68cb0ddf.tar.gz
man: remove recommendation to pull in slices from slices.target
That recommendation is likely to cause more trouble and for pretty much all end-user units is not useful. Let's recommend relying on the implicit dependency instead. Fixes #10015.
Diffstat (limited to 'man/systemd.special.xml')
-rw-r--r--man/systemd.special.xml16
1 files changed, 10 insertions, 6 deletions
diff --git a/man/systemd.special.xml b/man/systemd.special.xml
index 38006c6abd..0d25e40d03 100644
--- a/man/systemd.special.xml
+++ b/man/systemd.special.xml
@@ -596,14 +596,18 @@
<listitem>
<para>A special target unit that sets up all slice units (see
<citerefentry><refentrytitle>systemd.slice</refentrytitle><manvolnum>5</manvolnum></citerefentry>
- for details) that shall be active after boot. By default the generic
- <filename>system.slice</filename> slice unit, as well as the root slice unit
- <filename>-.slice</filename>, is pulled in and ordered before this unit (see
+ for details) that shall always be active after boot. By default the generic
+ <filename>system.slice</filename> slice unit as well as the root slice unit
+ <filename>-.slice</filename> are pulled in and ordered before this unit (see
below).</para>
- <para>It's a good idea to add <varname>WantedBy=slices.target</varname> lines to the
- <literal>[Install]</literal> section of all slices units that may be installed
- dynamically.</para>
+ <para>Adding slice units to <filename>slices.target</filename> is generally not
+ necessary. Instead, when some unit that uses <varname>Slice=</varname> is started, the
+ specified slice will be started automatically. Adding
+ <varname>WantedBy=slices.target</varname> lines to the <literal>[Install]</literal>
+ section should only be done for units that need to be always active. In that case care
+ needs to be taken to avoid creating a loop through the automatic dependencies on
+ "parent" slices.</para>
</listitem>
</varlistentry>
<varlistentry>