summaryrefslogtreecommitdiff
path: root/man/systemctl.xml
diff options
context:
space:
mode:
authorZbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl>2019-07-18 10:14:52 +0200
committerLennart Poettering <lennart@poettering.net>2019-07-18 16:20:38 +0200
commit4f0acdb36615d7e27bef9d951001daf3addc2f25 (patch)
tree28b425691e50ffa59d244f33b38337450edc3ca2 /man/systemctl.xml
parentffc1c1193843492780f12c1f8b9374f237edc7a5 (diff)
downloadsystemd-4f0acdb36615d7e27bef9d951001daf3addc2f25.tar.gz
systemd-4f0acdb36615d7e27bef9d951001daf3addc2f25.tar.bz2
systemd-4f0acdb36615d7e27bef9d951001daf3addc2f25.zip
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.)
Diffstat (limited to 'man/systemctl.xml')
-rw-r--r--man/systemctl.xml10
1 files changed, 8 insertions, 2 deletions
diff --git a/man/systemctl.xml b/man/systemctl.xml
index 6f93e1cd2c..0f06a88f42 100644
--- a/man/systemctl.xml
+++ b/man/systemctl.xml
@@ -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>