man: add note about systemctl stop return value

Fixes #13104.

(I know a lot more could be added to that  man page. This patch only addresses that
once specific complaint.)
This commit is contained in:
Zbigniew Jędrzejewski-Szmek 2019-07-18 10:14:52 +02:00 committed by Lennart Poettering
parent ffc1c11938
commit 4f0acdb366
1 changed files with 8 additions and 2 deletions

View File

@ -816,8 +816,14 @@ Sun 2017-02-26 20:57:49 EST 2h 3min left Sun 2017-02-26 11:56:36 EST 6h ago
<term><command>stop <replaceable>PATTERN</replaceable></command></term>
<listitem>
<para>Stop (deactivate) one or more units specified on the
command line.</para>
<para>Stop (deactivate) one or more units specified on the command line.</para>
<para>This command will fail if the unit does exist or if stopping of the unit is prohibited (see
<varname>RefuseManualStop=</varname> in
<citerefentry><refentrytitle>systemd.unit</refentrytitle><manvolnum>5</manvolnum></citerefentry>).
It will <emphasis>not</emphasis> fail if any of the commands configured to stop the unit
(<varname>ExecStop=</varname>, etc.) fail, because the manager will still forcibly terminate the
unit.</para>
</listitem>
</varlistentry>
<varlistentry>