man: extend documentation for RestartPreventExitStatus= and SuccessExitStatus= a bit

diff --git a/TODO b/TODO
index 0a36aee643af4413a885afac8fb1781a38b49b22..102a8138b995a6cee8179e5920990df2b58f24d3 100644 (file)
--- a/TODO
+++ b/TODO
@@ -397,6 +397,7 @@ Features:
   - resource control in systemd
   - inhibiting
   - testing with Harald's awesome test kit
+  - restart
 
 * allow port=0 in .socket units
 

diff --git a/man/systemd.service.xml b/man/systemd.service.xml
index c4bd65e349497531a34af4762b88b9e3aebc07ff..72b67c698801c2a00b44f8849ea82ee28a43471e 100644 (file)
--- a/man/systemd.service.xml
+++ b/man/systemd.service.xml
@@ -580,17 +580,46 @@
                         </varlistentry>
 
                         <varlistentry>
-                                <term><varname>RestartPreventExitStatus=</varname></term>
-                                <listitem><para>Specify exit status list, which
-                                will prevent service from restart. Codes are
-                                separated by whitespace (e.g. "1 6 SIGKILL").</para></listitem>
+                                <term><varname>SuccessExitStatus=</varname></term>
+                                <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 SIGHUP, SIGINT,
+                                SIGTERM and SIGPIPE. Exit status
+                                definitions can either be numeric exit
+                                codes or termination signal names, and
+                                are are separated by spaces. Example:
+                                "<literal>SuccessExitStatus=1 2 8
+                                SIGKILL</literal>", ensures that exit
+                                codes 1, 2, 8 and the termination
+                                signal SIGKILL are considered clean
+                                service
+                                terminations.</para></listitem>
                         </varlistentry>
 
                         <varlistentry>
-                                <term><varname>SuccessExitStatus=</varname></term>
-                                <listitem><para>Specify exit status list, which
-                                will be considered as successful exit. Codes are
-                                separated by whitespace (e.g. "1 6 SIGKILL").</para></listitem>
+                                <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. Example:
+                                "<literal>RestartPreventExitStatus=1 6
+                                SIGABRT</literal>", ensures that exit
+                                codes 1 and 6 and the termination signal
+                                SIGABRT will not result in automatic
+                                service restarting.</para></listitem>
                         </varlistentry>
 
                         <varlistentry>