a9339c
From 273a3d35df021128bd72e124d943cbb7b1c7194c Mon Sep 17 00:00:00 2001
a9339c
From: Jan Synacek <jsynacek@redhat.com>
a9339c
Date: Fri, 22 Jun 2018 09:11:49 +0200
a9339c
Subject: [PATCH] man: correct the meaning of TimeoutStopSec=
a9339c
a9339c
Fixes: #9325
a9339c
(cherry picked from commit 9a6da355a06e2b272717f2ac23e41945ce56eb6d)
a9339c
Resolves: #1305509
a9339c
---
a9339c
 man/systemd.service.xml | 12 ++++++------
a9339c
 1 file changed, 6 insertions(+), 6 deletions(-)
a9339c
a9339c
diff --git a/man/systemd.service.xml b/man/systemd.service.xml
a9339c
index a274db480..d147e449a 100644
a9339c
--- a/man/systemd.service.xml
a9339c
+++ b/man/systemd.service.xml
a9339c
@@ -429,12 +429,12 @@
a9339c
 
a9339c
       <varlistentry>
a9339c
         <term><varname>TimeoutStopSec=</varname></term>
a9339c
-        <listitem><para>Configures the time to wait for stop. If a
a9339c
-        service is asked to stop, but does not terminate in the
a9339c
-        specified time, it will be terminated forcibly via
a9339c
-        <constant>SIGTERM</constant>, and after another timeout of
a9339c
-        equal duration with <constant>SIGKILL</constant> (see
a9339c
-        <varname>KillMode=</varname> in
a9339c
+        <listitem><para>This option serves two purposes. First, it configures the time to wait for each
a9339c
+        <constant>ExecStop=</constant> command. If any of them times out, subsequent <constant>ExecStop=</constant> commands
a9339c
+        are skipped and the service will be terminated by <constant>SIGTERM</constant>. If no <constant>ExecStop=</constant>
a9339c
+        commands are specified, the service gets the <constant>SIGTERM</constant> immediately. Second, it configures the time
a9339c
+        to wait for the service itself to stop. If it doesn't terminate in the specified time, it will be forcibly terminated
a9339c
+        by <constant>SIGKILL</constant> (see <varname>KillMode=</varname> in
a9339c
         <citerefentry><refentrytitle>systemd.kill</refentrytitle><manvolnum>5</manvolnum></citerefentry>).
a9339c
         Takes a unit-less value in seconds, or a time span value such
a9339c
         as "5min 20s". Pass <literal>0</literal> to disable the