X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fsystemd.kill.xml;h=a4009aa38a8f86c1bb1a9726c17cd4f43320547c;hp=5ff8feee6345a814601700336057c706e6f7764a;hb=58ea275a68cd242ad60161bcb7582614d1d89f13;hpb=ccc9a4f9ffdab069b0b785627c48962fdadf6d46 diff --git a/man/systemd.kill.xml b/man/systemd.kill.xml index 5ff8feee6..a4009aa38 100644 --- a/man/systemd.kill.xml +++ b/man/systemd.kill.xml @@ -44,39 +44,44 @@ systemd.kill - Kill environment configuration + Process killing procedure + configuration - systemd.service, - systemd.socket, - systemd.mount, - systemd.swap + service.service, + socket.socket, + mount.mount, + swap.swap, + scope.scope Description Unit configuration files for services, sockets, - mount points and swap devices share a subset of - configuration options which define the process killing - parameters of spawned processes. + 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 four unit types. See + shared by these five unit types. See systemd.unit5 - for the common options of all unit configuration - files, and + for the common options shared by all unit + configuration files, and systemd.service5, systemd.socket5, - systemd.swap5 - and + systemd.swap5, systemd.mount5 - for more information on the specific unit - configuration files. The execution specific + and + systemd.scope5 + for more information on the configuration file options + specific to each unit type. + + The kill procedure configuration options are configured in the [Service], - [Socket], [Mount], or [Swap] section, depending on the unit - type. + [Socket], [Mount] or [Swap] section, depending on the + unit type. @@ -87,68 +92,106 @@ KillMode= Specifies how - processes of this service shall be + processes of this unit shall be killed. One of , , + , . If set to - all + , all remaining processes in the control - group of this unit will be terminated - on unit stop (for services: after the + 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 only the + to , only the main process itself is killed. If set - to no process is + to 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 + , no process is killed. In this case only the stop - command will be executed on unit - stop, but no process be killed + 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. Defaults to - . + empty. Processes will first be - terminated via SIGTERM (unless the - signal to send is changed via - KillSignal=). If - then after a delay (configured via the - TimeoutSec= option) + 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= + the SIGKILL + signal (unless this is disabled via + the SendSIGKILL= option). See kill2 for more - information. + information. + + Defaults to + . KillSignal= Specifies which signal - to use when killing a - service. Defaults to SIGTERM. + 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 + signal7. Defaults + to SIGTERM. + + + + + SendSIGHUP= + 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". SendSIGKILL= Specifies whether to - send SIGKILL to remaining processes + 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". + @@ -164,7 +207,9 @@ systemd.swap5, systemd.mount5, systemd.exec5, - systemd.directives7 + systemd.directives7, + kill2, + signal7