man: describe ordering in case of Conflicts=

Fixes #13421.
This commit is contained in:
Zbigniew Jędrzejewski-Szmek 2019-11-06 13:42:13 +01:00
parent d19cd71a8a
commit 38c432b37c
1 changed files with 10 additions and 7 deletions

View File

@ -671,13 +671,16 @@
<varlistentry> <varlistentry>
<term><varname>Conflicts=</varname></term> <term><varname>Conflicts=</varname></term>
<listitem><para>A space-separated list of unit names. <listitem><para>A space-separated list of unit names. Configures negative requirement
Configures negative requirement dependencies. If a unit has a dependencies. If a unit has a <varname>Conflicts=</varname> setting on another unit, starting the
<varname>Conflicts=</varname> setting on another unit, former will stop the latter and vice versa.</para>
starting the former will stop the latter and vice versa. Note
that this setting is independent of and orthogonal to the <para>Note that this setting does not imply an ordering dependency, similarly to the
<varname>After=</varname> and <varname>Before=</varname> <varname>Wants=</varname> and <varname>Requires=</varname> dependencies described above. This means
ordering dependencies.</para> that to ensure that the conflicting unit is stopped before the other unit is started, an
<varname>After=</varname> or <varname>Before=</varname> dependency must be declared. It doesn't
matter which of the two ordering dependencies is used, because stop jobs are always ordered before
start jobs, see the discussion in <varname>Before=</varname>/<varname>After=</varname> below.</para>
<para>If unit A that conflicts with unit B is scheduled to <para>If unit A that conflicts with unit B is scheduled to
be started at the same time as B, the transaction will either be started at the same time as B, the transaction will either