X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fsystemd.service.xml;h=e584a1f006f54c5062cc31f65e3e2a2a5aab9146;hb=96fb8242cc1ef6b0e28f6c86a4f57950095dd7f1;hp=640318ba4412779ce9d8b2c750c2c369a124f52d;hpb=6cfe2fde1cc919c2333a5749ea1cbc31fa757077;p=elogind.git
diff --git a/man/systemd.service.xml b/man/systemd.service.xml
index 640318ba4..e584a1f00 100644
--- a/man/systemd.service.xml
+++ b/man/systemd.service.xml
@@ -139,9 +139,10 @@
If set to
(the default
- value if neither
+ if neither
Type= nor
- BusName= are
+ BusName=, but
+ ExecStart= are
specified), it is expected that the
process configured with
ExecStart= is the
@@ -177,13 +178,17 @@
exits.Behavior of
- is similar
- to ; however,
- it is expected that the process has to
+ is similar to
+ ; however, it
+ is expected that the process has to
exit before systemd starts follow-up
units. RemainAfterExit=
is particularly useful for this type
- of service.
+ of service. This is the implied
+ default if neither
+ Type= or
+ ExecStart= are
+ specified.
Behavior of
is similar to
@@ -313,22 +318,27 @@
When Type is
not , only one
- command may be given. When
+ command may and must be given. When
Type=oneshot is
- used, more than one command may be
- specified. Multiple command lines may
- be concatenated in a single directive
- by separating them with semicolons
- (these semicolons must be passed as
- separate words). Alternatively, this
- directive may be specified more than
- once with the same effect.
- Lone semicolons may be escaped as
+ used, none or more than one command
+ may be specified. Multiple command
+ lines may be concatenated in a single
+ directive by separating them with
+ semicolons (these semicolons must be
+ passed as separate
+ words). Alternatively, this directive
+ may be specified more than once with
+ the same effect. Lone semicolons may
+ be escaped as
\;. If the empty
string is assigned to this option, the
list of commands to start is reset,
prior assignments of this option will
- have no effect.
+ have no effect. If no
+ ExecStart= is
+ specified, then the service must have
+ RemainAfterExit=yes
+ set.Each command line is split on
whitespace, with the first item being
@@ -605,11 +615,12 @@ ExecStart=/bin/echo $ONE $TWO ${TWO}
time span value such as "5min
20s". Pass 0 to
disable the timeout logic. Defaults to
- TimeoutStartSec= from
+ DefaultTimeoutStartSec= from
the manager configuration file, except
when Type=oneshot is
used, in which case the timeout
- is disabled by default.
+ is disabled by default
+ (see systemd-systemd.conf5).
@@ -628,8 +639,9 @@ ExecStart=/bin/echo $ONE $TWO ${TWO}
time span value such as "5min
20s". Pass 0 to disable
the timeout logic. Defaults to
- TimeoutStartSec= from the
- manager configuration file.
+ DefaultTimeoutStopSec= from the
+ manager configuration file
+ (see systemd-systemd.conf5).
@@ -825,10 +837,15 @@ ExecStart=/bin/echo $ONE $TWO ${TWO}
- In addition to the above settings,
- the service will not be restarted if the
- exit code or signal is specified in
+ As exceptions to the setting
+ above the service will not be
+ restarted if the exit code or signal
+ is specified in
RestartPreventExitStatus=
+ (see below). Also, the services will
+ always be restarted if the exit code
+ or signal is specified in
+ RestartForceExitStatus=
(see below).Setting this to
@@ -838,8 +855,8 @@ ExecStart=/bin/echo $ONE $TWO ${TWO}
reliability by attempting automatic
recovery from errors. For services
that shall be able to terminate on
- their own choice (and avoiding
- immediate restart)
+ their own choice (and avoid
+ immediate restarting),
is an
alternative choice.
@@ -857,7 +874,7 @@ ExecStart=/bin/echo $ONE $TWO ${TWO}
definitions can either be numeric exit
codes or termination signal names,
separated by spaces. For example:
- SuccessExitStatus=1 2 8 SIGKILL
+ SuccessExitStatus=1 2 8 SIGKILL
ensures that exit codes 1, 2, 8 and
the termination signal
SIGKILL are
@@ -897,9 +914,8 @@ ExecStart=/bin/echo $ONE $TWO ${TWO}
spaces. Defaults to the empty list, so
that, by default, no exit status is
excluded from the configured restart
- logic. Example:
- RestartPreventExitStatus=1 6
- SIGABRT, ensures that exit
+ logic. For example:
+ RestartPreventExitStatus=1 6 SIGABRT ensures that exit
codes 1 and 6 and the termination
signal SIGABRT will
not result in automatic service
@@ -913,6 +929,18 @@ ExecStart=/bin/echo $ONE $TWO ${TWO}
effect.
+
+ RestartForceExitStatus=
+ Takes a list of exit
+ status definitions that when returned
+ by the main service process will force
+ automatic service restarts, regardless
+ of the restart setting configured with
+ Restart=. The
+ argument format is similar to
+ RestartPreventExitStatus=.
+
+
PermissionsStartOnly=Takes a boolean