X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fsystemd.service.xml;h=8b17f857ceb7b1403a9d452a58a97848b5b8c269;hb=1b6d7fa742e303611dff8d7ebfa86ee5fb8b7dc7;hp=1d804807721d5a613d51bf07ac75638791c11b73;hpb=8d0e0ddda6501479eb69164687c83c1a7667b33a;p=elogind.git
diff --git a/man/systemd.service.xml b/man/systemd.service.xml
index 1d8048077..8b17f857c 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
@@ -1103,29 +1131,49 @@ ExecStart=/bin/echo $ONE $TWO ${TWO}
hit. Takes one of
,
,
- , or
- . If
- is set,
- hitting the rate limit will trigger no
- action besides that the start will not
- be permitted.
+ ,
+ ,
+ ,
+ or
+ . If
+ is set, hitting
+ the rate limit will trigger no action
+ besides that the start will not be
+ permitted.
causes a reboot following the normal
shutdown procedure (i.e. equivalent to
systemctl reboot).
- causes
- a forced reboot which will terminate
- all processes forcibly but should
- cause no dirty file systems on reboot
+ causes a
+ forced reboot which will terminate all
+ processes forcibly but should cause no
+ dirty file systems on reboot
(i.e. equivalent to systemctl
reboot -f) and
causes immediate execution of the
reboot2
system call, which might result in
- data loss. Defaults to
+ data loss. Similar,
+ ,
+ ,
+
+ have the effect of powering down the
+ system with similar
+ semantics. Defaults to
.
+
+ FailureAction=
+ Configure the action
+ to take when the service enters a failed
+ state. Takes the same values as
+ StartLimitAction=
+ and executes the same actions.
+ Defaults to .
+
+
+
RebootArgument=Configure the optional
@@ -1133,23 +1181,13 @@ ExecStart=/bin/echo $ONE $TWO ${TWO}
reboot2
system call if
StartLimitAction=
+ or FailureAction=
is a reboot action. This works just
like the optional argument to
systemctl reboot
command.
-
- FailureAction=
- Configure the action
- to take when the service enters a failed
- state. Takes the same values as
- StartLimitAction=
- and executes the same actions.
- Defaults to .
-
-
-
Check