correct information about implicit dependencies (#3730)

systemd.special.xml: corrections about implicit
dependencies for basic.target, sysinit.target and shutdown.target.

systemd.target.xml: corrections about implicit dependencies for
target units in general.
This commit is contained in:
Michal Soltys 2016-07-15 04:20:45 +02:00 committed by Zbigniew Jędrzejewski-Szmek
parent 20f873deb2
commit f749954d92
2 changed files with 25 additions and 10 deletions

View File

@ -127,9 +127,9 @@
<listitem> <listitem>
<para>A special target unit covering basic boot-up.</para> <para>A special target unit covering basic boot-up.</para>
<para>systemd automatically adds dependencies of the types <para>systemd automatically adds dependency of the type
<varname>Requires=</varname> and <varname>After=</varname> <varname>After=</varname> for this target unit to all
for this target unit to all services (except for those with services (except for those with
<varname>DefaultDependencies=no</varname>).</para> <varname>DefaultDependencies=no</varname>).</para>
<para>Usually, this should pull-in all local mount points plus <para>Usually, this should pull-in all local mount points plus
@ -509,8 +509,9 @@
system shutdown.</para> system shutdown.</para>
<para>Services that shall be terminated on system shutdown <para>Services that shall be terminated on system shutdown
shall add <varname>Conflicts=</varname> dependencies to this shall add <varname>Conflicts=</varname> and
unit for their service unit, which is implicitly done when <varname>Before=</varname> dependencies to this unit for
their service unit, which is implicitly done when
<varname>DefaultDependencies=yes</varname> is set (the <varname>DefaultDependencies=yes</varname> is set (the
default).</para> default).</para>
</listitem> </listitem>
@ -579,6 +580,11 @@
<varlistentry> <varlistentry>
<term><filename>sysinit.target</filename></term> <term><filename>sysinit.target</filename></term>
<listitem> <listitem>
<para>systemd automatically adds dependencies of the types
<varname>Requires=</varname> and <varname>After=</varname>
for this target unit to all services (except for those with
<varname>DefaultDependencies=no</varname>).</para>
<para>This target pulls in the services required for system <para>This target pulls in the services required for system
initialization. System services pulled in by this target should initialization. System services pulled in by this target should
declare <varname>DefaultDependencies=no</varname> and specify declare <varname>DefaultDependencies=no</varname> and specify

View File

@ -82,11 +82,20 @@
<refsect1> <refsect1>
<title>Automatic Dependencies</title> <title>Automatic Dependencies</title>
<para>Unless <varname>DefaultDependencies=</varname> in the <literal>[Unit]</literal> section is set to <para>Unless <varname>DefaultDependencies=</varname> is set to
<option>no</option>, target units will implicitly complement all configured dependencies of type <option>no</option> in either of releated units or an explicit ordering
<varname>Wants=</varname>, <varname>Requires=</varname> with dependencies of type <varname>After=</varname>, unless dependency is already defined, target units will implicitly complement all
an ordering dependency of any kind between the target and the respective other unit is already in place. Note that configured dependencies of type <varname>Wants=</varname> or
this behaviour is disabled if either unit has <varname>DefaultDependencies=no</varname>.</para> <varname>Requires=</varname> with dependencies of type
<varname>After=</varname>. Note that <varname>Wants=</varname> or
<varname>Requires=</varname> must be defined in the target unit itself - if
you for example define <varname>Wants=</varname>some.target in
some.service, the implicit ordering will not be added.</para>
<para>All target units automatically gain <varname>Conflicts=</varname>
dependency against shutdown.target unless <varname>DefaultDependencies=</varname>
is set to <option>no</option>.</para>
</refsect1> </refsect1>
<refsect1> <refsect1>