]> git.ipfire.org Git - thirdparty/systemd.git/commitdiff
man: Align ExecStop= documentation with actual kill behavior (#4974)
authorFelipe Sateler <fsateler@users.noreply.github.com>
Sat, 24 Dec 2016 10:34:26 +0000 (07:34 -0300)
committerLennart Poettering <lennart@poettering.net>
Sat, 24 Dec 2016 10:34:26 +0000 (11:34 +0100)
The manpage claimed that ExecStop would be followed immediately by
SIGKILL, whereas the actual behavior is to go through KillMode= and
KillSignal= first.

Fixes #4490

man/systemd.service.xml

index 684029bdb445b49533a56b2e3ac91230cce88ef9..ad91817820ddfbf77128be3fb4d66abf144b7993 100644 (file)
         variable substitution is supported (including
         <varname>$MAINPID</varname>, see above).</para>
 
-        <para>Note that it is usually not sufficient to specify a
-        command for this setting that only asks the service to
-        terminate (for example, by queuing some form of termination
-        signal for it), but does not wait for it to do so. Since the
-        remaining processes of the services are killed using
-        <constant>SIGKILL</constant> immediately after the command
-        exited, this would not result in a clean stop. The specified
-        command should hence be a synchronous operation, not an
-        asynchronous one.</para>
+        <para>Note that it is usually not sufficient to specify a command for this setting that only asks the service
+        to terminate (for example, by queuing some form of termination signal for it), but does not wait for it to do
+        so. Since the remaining processes of the services are killed according to <varname>KillMode=</varname> and
+        <varname>KillSignal=</varname> as described above immediately after the command exited, this may not result in
+        a clean stop. The specified command should hence be a synchronous operation, not an asynchronous one.</para>
 
         <para>Note that the commands specified in <varname>ExecStop=</varname> are only executed when the service
         started successfully first. They are not invoked if the service was never started at all, or in case its