X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fsystemd.service.xml;h=0baddd1d4f02cf97d5c77696ed4f527476014873;hp=2db146b719daf9407fe96bc88f0eaf6681cad502;hb=7c8bbccd071a9a12efdd8a7770b53d7786eb3a9c;hpb=2ba545f1a098fc5621d4d1f1049af2f40793819a diff --git a/man/systemd.service.xml b/man/systemd.service.xml index 2db146b71..0baddd1d4 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 @@ -283,20 +311,28 @@ main process of the daemon. The command line accepts % specifiers as described in - systemd.unit5. On - top of that basic environment variable - substitution is supported, where - ${FOO} is replaced - by the string value of the environment - variable of the same name. Also - $FOO may appear as - separate word on the command line in - which case the variable is replaced by - its value split at whitespaces. Note - that the first argument (i.e. the - binary to execute) may not be a - variable, and must be a literal and - absolute path name. + systemd.unit5. + + On top of that basic environment + variable substitution is + supported. Use + ${FOO} as part of a + word, or as word of its own on the + command line, in which case it will be + replaced by the value of the + environment variable including all + whitespace it contains, resulting in a + single argument. Use + $FOO as a separate + word on the command line, in which + case it will be replaced by the value + of the environment variable split up + at whitespace, resulting in no or more + arguments. Note that the first + argument (i.e. the program to execute) + may not be a variable, and must be a + literal and absolute path + name. @@ -314,7 +350,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,14 +456,14 @@ time span value such as "5min 20s". Pass 0 to disable the timeout logic. Defaults to - 60s. + 90s. Restart= Configures whether the main service process shall be - restarted when it exists. Takes one of + restarted when it exits. Takes one of , , , @@ -441,7 +477,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 +566,6 @@ processes of this service shall be killed. One of , - , , . @@ -542,10 +577,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 @@ -557,20 +588,44 @@ group and the control group continues to exist after stop unless it is empty. Defaults to - . + . 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 @@ -597,7 +652,7 @@ or . If no daemon status - updates are accepted by the service + updates are accepted from the service processes, all status update messages are ignored. If only service updates sent from the @@ -616,11 +671,11 @@ Specifies the name of the socket units this service shall inherit the sockets from when the - service (ignoring the different suffix - of course) is started. Normally it + service is started. Normally it should not be necessary to use this setting as all sockets whose unit shares the same name as the service + (ignoring the different suffix of course) are passed to the spawned process.