diff options
| author | David Tardon <dtardon@redhat.com> | 2021-03-19 10:05:47 +0100 |
|---|---|---|
| committer | The Plumber <50238977+systemd-rhel-bot@users.noreply.github.com> | 2021-06-22 14:30:38 +0200 |
| commit | 102f4ff97a24c2ddaf6e569c678a0a713f972863 (patch) | |
| tree | 2da5f5d603d2c87d677086072c32b156fdaaf651 | |
| parent | 48dacf8d30cd61b72939e9c3419acced4b2fde74 (diff) | |
| download | systemd-102f4ff97a24c2ddaf6e569c678a0a713f972863.tar.gz | |
man: document differences in clean exit status for Type=oneshot
See commit 1f0958f640b87175cd547c1e69084cfe54a22e9d .
(cherry picked from commit f055cf77862bc580f3afbfaac161d1c060f39411)
Resolves: #1940078
| -rw-r--r-- | man/systemd.service.xml | 24 |
1 files changed, 15 insertions, 9 deletions
diff --git a/man/systemd.service.xml b/man/systemd.service.xml index 54586d1948..1e30a564df 100644 --- a/man/systemd.service.xml +++ b/man/systemd.service.xml @@ -669,14 +669,19 @@ If set to <option>no</option> (the default), the service will not be restarted. If set to <option>on-success</option>, it will be restarted only when the service process exits cleanly. - In this context, a clean exit means an exit code of 0, or one - of the signals - <constant>SIGHUP</constant>, - <constant>SIGINT</constant>, - <constant>SIGTERM</constant> or - <constant>SIGPIPE</constant>, and - additionally, exit statuses and signals specified in - <varname>SuccessExitStatus=</varname>. If set to + In this context, a clean exit means any of the following: + <itemizedlist> + <listitem><simpara>exit code of 0;</simpara></listitem> + <listitem><simpara>for types other than + <varname>Type=oneshot</varname>, one of the signals + <constant>SIGHUP</constant>, + <constant>SIGINT</constant>, + <constant>SIGTERM</constant>, or + <constant>SIGPIPE</constant>;</simpara></listitem> + <listitem><simpara>exit statuses and signals specified in + <varname>SuccessExitStatus=</varname>.</simpara></listitem> + </itemizedlist> + If set to <option>on-failure</option>, the service will be restarted when the process exits with a non-zero exit code, is terminated by a signal (including on core dump, but excluding @@ -798,7 +803,8 @@ <listitem><para>Takes a list of exit status definitions that, when returned by the main service process, will be considered successful termination, in addition to the normal successful - exit code 0 and the signals <constant>SIGHUP</constant>, + exit code 0 and, except for <varname>Type=oneshot</varname>, + the signals <constant>SIGHUP</constant>, <constant>SIGINT</constant>, <constant>SIGTERM</constant>, and <constant>SIGPIPE</constant>. Exit status definitions can either be numeric exit codes or termination signal names, |