X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fsystemd.service.xml;h=4f1102021f2b2864e08cf60dc5656ce88654699f;hp=c77992d07c6e1749df86f434fdcef0629064d48b;hb=c375a7f750d0ac3ab130b8d84ebbcbbf32b96c72;hpb=f8553ccbb3b774ab39acfc5b4dc1564bb31ef801 diff --git a/man/systemd.service.xml b/man/systemd.service.xml index c77992d07..4f1102021 100644 --- a/man/systemd.service.xml +++ b/man/systemd.service.xml @@ -180,7 +180,7 @@ acquired. Service units with this option configured implicitly gain dependencies on the - dbus.target + dbus.socket unit. Behaviour of @@ -215,6 +215,30 @@ + + GuessMainPID= + + Takes a boolean value + that specifies whether systemd should + try to guess the main PID of a service + should if it cannot be determined + reliably. This option is ignored + unless + is set and + is unset because for the other types + or with an explicitly configured PID + file the main PID is always known. The + guessing algorithm might come to + incorrect conclusions if a daemon + consists of more than one process. If + the main PID cannot be determined + failure detection and automatic + restarting of a service will not work + reliably. Defaults to + . + + + PIDFile= @@ -223,7 +247,11 @@ daemon. Use of this option is recommended for services where Type= is set to - . + . systemd will + read the PID of the main process of + the daemon after start-up of the + service. systemd will not write to the + file configured here. @@ -271,11 +299,11 @@ - an exit code of the command normally considered a failure (i.e. non-zero exit status or - abormal exit due to signal) is ignored + abnormal exit due to signal) is ignored and considered success. If both - and @ are used for the - same command the former must preceed + same command the former must precede the latter. Unless Type=forking is set, the process started via this @@ -314,7 +342,7 @@ after the other, serially. Alternatively, these directives may be specified more than - once whith the same effect. However, + once with the same effect. However, the latter syntax is not recommended for compatibility with parsers suitable for XDG @@ -420,7 +448,7 @@ time span value such as "5min 20s". Pass 0 to disable the timeout logic. Defaults to - 60s. + 90s. @@ -441,7 +469,7 @@ i.e. terminated with an exit code of 0. If set to it will be - restared only when it exited with an + restarted only when it exited with an exit code not equalling 0, or when terminated by a signal. If set to it will be @@ -530,7 +558,6 @@ processes of this service shall be killed. One of , - , , . @@ -542,10 +569,6 @@ stop command (as configured with ExecStop=) is executed. If set to - only - the members of the process group of - the main service process are - killed. If set to only the main process itself is killed. If set to no process is @@ -560,17 +583,41 @@ . Processes will first be - terminated via SIGTERM. If then after - a delay (configured via the + terminated via SIGTERM (unless the + signal to send is changed via + KillSignal=). If + then after a delay (configured via the TimeoutSec= option) processes still remain, the termination request is repeated with - the SIGKILL signal. See + the SIGKILL signal (unless this is + disabled via the + SendSIGKILL= + option). See kill2 for more information. + + KillSignal= + Specifies which signal + to use when killing a + service. Defaults to SIGTERM. + + + + + SendSIGKILL= + 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". + + + NonBlocking= Set O_NONBLOCK flag