SYSTEMD.KILL(5)                 systemd.kill                 SYSTEMD.KILL(5)

NAME         top

       systemd.kill - Process killing procedure configuration

SYNOPSIS         top

       service.service, socket.socket, mount.mount, swap.swap, scope.scope

DESCRIPTION         top

       Unit configuration files for services, sockets, mount points, swap
       devices and scopes share a subset of configuration options which
       define the killing procedure of processes belonging to the unit.

       This man page lists the configuration options shared by these five
       unit types. See systemd.unit(5) for the common options shared by all
       unit configuration files, and systemd.service(5), systemd.socket(5),
       systemd.swap(5), systemd.mount(5) and systemd.scope(5) for more
       information on the configuration file options specific to each unit

       The kill procedure configuration options are configured in the
       [Service], [Socket], [Mount] or [Swap] section, depending on the unit

OPTIONS         top

           Specifies how processes of this unit shall be killed. One of
           control-group, process, mixed, none.

           If set to control-group, all remaining processes in the control
           group of this unit will be killed on unit stop (for services:
           after the stop command is executed, as configured with
           ExecStop=). If set to process, only the main process itself is
           killed. If set to mixed, the SIGTERM signal (see below) is sent
           to the main process while the subsequent SIGKILL signal (see
           below) is sent to all remaining processes of the unit's control
           group. If set to none, no process is killed. In this case, only
           the stop command will be executed on unit stop, but no process be
           killed otherwise. Processes remaining alive after stop are left
           in their control group and the control group continues to exist
           after stop unless it is empty.

           Processes will first be terminated via SIGTERM (unless the signal
           to send is changed via KillSignal=). Optionally, this is
           immediately followed by a SIGHUP (if enabled with SendSIGHUP=).
           If then, after a delay (configured via the TimeoutStopSec=
           option), processes still remain, the termination request is
           repeated with the SIGKILL signal (unless this is disabled via the
           SendSIGKILL= option). See kill(2) for more information.

           Defaults to control-group.

           Specifies which signal to use when killing a service. This
           controls the signal that is sent as first step of shutting down a
           unit (see above), and is usually followed by SIGKILL (see above
           and below). For a list of valid signals, see signal(7). Defaults
           to SIGTERM.

           Note that, right after sending the signal specified in this
           setting, systemd will always send SIGCONT, to ensure that even
           suspended tasks can be terminated cleanly.

           Specifies whether to send SIGHUP to remaining processes
           immediately after sending the signal configured with KillSignal=.
           This is useful to indicate to shells and shell-like programs that
           their connection has been severed. Takes a boolean value.
           Defaults to "no".

           Specifies whether to send SIGKILL to remaining processes after a
           timeout, if the normal shutdown procedure left processes of the
           service around. Takes a boolean value. Defaults to "yes".

SEE ALSO         top

       systemd(1), systemctl(1), journalctl(8), systemd.unit(5),
       systemd.service(5), systemd.socket(5), systemd.swap(5),
       systemd.mount(5), systemd.exec(5), systemd.directives(7), kill(2),

COLOPHON         top

       This page is part of the systemd (systemd system and service manager)
       project.  Information about the project can be found at 
       ⟨⟩.  If you have a bug
       report for this manual page, see
       ⟨⟩.  This
       page was obtained from the project's upstream Git repository
       ⟨⟩ on 2019-11-19.  (At that
       time, the date of the most recent commit that was found in the repos‐
       itory was 2019-11-19.)  If you discover any rendering problems in
       this HTML version of the page, or you believe there is a better or
       more up-to-date source for the page, or you have corrections or
       improvements to the information in this COLOPHON (which is not part
       of the original manual page), send a mail to

systemd 234                                                  SYSTEMD.KILL(5)

Pages that refer to this page: systemd-run(1)systemd.exec(5)systemd.mount(5)systemd.service(5)systemd.socket(5)systemd.swap(5)systemd.directives(7)systemd.index(7)