X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fsystemd.kill.xml;h=caee371c815b98ab0bf646e721d6c3d1e6da29a8;hb=b705ab6a838937f947216af7b2d1fffb00f8b0dc;hp=b41ce460b585234ba7ce44a3948652b4c502797d;hpb=e670b166a08b7c1031a9e7d7675fa9a29c3e19c9;p=elogind.git
diff --git a/man/systemd.kill.xml b/man/systemd.kill.xml
index b41ce460b..caee371c8 100644
--- a/man/systemd.kill.xml
+++ b/man/systemd.kill.xml
@@ -44,39 +44,44 @@
systemd.kill
- Kill environment configuration
+ Process killing procedure
+ configurationservice.service,
socket.socket,
mount.mount,
- swap.swap
+ swap.swap,
+ scope.scopeDescriptionUnit 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
- killed. In this case only the stop
- command will be executed on unit
- stop, but no process be killed
+ 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
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".
+
@@ -156,7 +199,7 @@