From efeb864cb547a2cbf96dc0053a8bdb4d9190b364 Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Wed, 12 Jun 2024 05:50:45 +0200 Subject: Merging upstream version 256. Signed-off-by: Daniel Baumann --- man/systemd.service.xml | 66 ++++++++++++++++++++++++++++--------------------- 1 file changed, 38 insertions(+), 28 deletions(-) (limited to 'man/systemd.service.xml') diff --git a/man/systemd.service.xml b/man/systemd.service.xml index 86d7108..58439df 100644 --- a/man/systemd.service.xml +++ b/man/systemd.service.xml @@ -1,6 +1,6 @@ + "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> @@ -992,16 +992,22 @@ Takes a list of exit status definitions that, when returned by the main service process, will prevent automatic service restarts, regardless of the restart setting configured with - Restart=. Exit status definitions can either be numeric exit codes or termination - signal names, and are separated by spaces. Defaults to the empty list, so that, by default, no exit - status is excluded from the configured restart logic. For example: + Restart=. Exit status definitions can be numeric termination statuses, termination + status names, or termination signal names, separated by spaces. Defaults to the empty list, so that, + by default, no exit status is excluded from the configured restart logic. - RestartPreventExitStatus=1 6 SIGABRT + + A service with the <varname>RestartPreventExitStatus=</varname> setting + + RestartPreventExitStatus=TEMPFAIL 250 SIGKILL + + Exit status 75 (TEMPFAIL), 250, and the termination signal + SIGKILL will not result in automatic service restarting. + - ensures that exit codes 1 and 6 and the termination signal SIGABRT will not - result in automatic service restarting. This option may appear more than once, in which case the list - of restart-preventing statuses is merged. If the empty string is assigned to this option, the list is - reset and all prior assignments of this option will have no effect. + This option may appear more than once, in which case the list of restart-preventing statuses is merged. + If the empty string is assigned to this option, the list is reset and all prior assignments of this + option will have no effect. Note that this setting has no effect on processes configured via ExecStartPre=, ExecStartPost=, ExecStop=, @@ -1015,12 +1021,15 @@ 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=. + + 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=. + + + Note that for Type=oneshot services, a success exit status will prevent + them from auto-restarting, no matter whether the corresponding exit statuses are listed in this + option or not. @@ -1313,8 +1322,9 @@ ExecStartPre=, ExecStartPost=, ExecReload=, - ExecStop=, and - ExecStopPost= options. + ExecStop=, + ExecStopPost=, and + ExecCondition= options. Multiple command lines may be concatenated in a single directive by separating them with semicolons (these semicolons must be passed as separate words). Lone semicolons may be escaped as @@ -1752,17 +1762,17 @@ WantedBy=multi-user.target See Also - - systemd1, - systemctl1, - systemd-system.conf5, - systemd.unit5, - systemd.exec5, - systemd.resource-control5, - systemd.kill5, - systemd.directives7, - systemd-run1 - + + systemd1 + systemctl1 + systemd-system.conf5 + systemd.unit5 + systemd.exec5 + systemd.resource-control5 + systemd.kill5 + systemd.directives7 + systemd-run1 + -- cgit v1.2.3