diff options
author | Lennart Poettering <lennart@poettering.net> | 2019-03-13 20:28:28 +0100 |
---|---|---|
committer | Zbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl> | 2019-03-14 08:11:12 +0100 |
commit | 5763971014a8e2bea44d1f8754cf9e41144fdf19 (patch) | |
tree | 936bbd4c4fb97986dc086b3ceaeddfa0778c6e72 /man/systemd.service.xml | |
parent | 6c8a2c679313f8283514923daf65f5e9d050d94c (diff) | |
download | systemd-5763971014a8e2bea44d1f8754cf9e41144fdf19.tar.gz |
man: be even more explicit that RestartPreventExitStatus= does not affect ExecStartPre=
The man page was already pretty clear about this, but apparently not
clear enough, let's hence extend this further.
Fixes: #11868
Diffstat (limited to 'man/systemd.service.xml')
-rw-r--r-- | man/systemd.service.xml | 32 |
1 files changed, 17 insertions, 15 deletions
diff --git a/man/systemd.service.xml b/man/systemd.service.xml index b8f3bcad60..2bc318f9a9 100644 --- a/man/systemd.service.xml +++ b/man/systemd.service.xml @@ -807,24 +807,26 @@ <varlistentry> <term><varname>RestartPreventExitStatus=</varname></term> - <listitem><para>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 <varname>Restart=</varname>. 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: + + <listitem><para>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 + <varname>Restart=</varname>. 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: <programlisting>RestartPreventExitStatus=1 6 SIGABRT</programlisting> - ensures that exit codes 1 and 6 and the termination signal - <constant>SIGABRT</constant> 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.</para></listitem> + ensures that exit codes 1 and 6 and the termination signal <constant>SIGABRT</constant> 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.</para> + + <para>Note that this setting has no effect on processes configured via + <varname>ExecStartPre=</varname>, <varname>ExecStartPost=</varname>, <varname>ExecStop=</varname>, + <varname>ExecStopPost=</varname> or <varname>ExecReload=</varname>, but only on the main service + process, i.e. either the one invoked by <varname>ExecStart=</varname> or (depending on + <varname>Type=</varname>, <varname>PIDFile=</varname>, …) the otherwise configured main + process.</para></listitem> </varlistentry> <varlistentry> |