man: Clarify when OnFailure= activates after restarts (#7646)

diff --git a/man/systemd.service.xml b/man/systemd.service.xml
index 76dfe60be49b350e4d5a8835d035262516cd485c..b0aee3329f99fd2aedbbdd3c517270f8b17ad95b 100644 (file)
--- a/man/systemd.service.xml
+++ b/man/systemd.service.xml
@@ -754,7 +754,8 @@
         limiting configured with <varname>StartLimitIntervalSec=</varname>
         and <varname>StartLimitBurst=</varname>, see
         <citerefentry><refentrytitle>systemd.unit</refentrytitle><manvolnum>5</manvolnum></citerefentry>
-        for details.</para>
+        for details.  A restarted service enters the failed state only
+        after the start limits are reached.</para>
 
         <para>Setting this to <option>on-failure</option> is the
         recommended choice for long-running services, in order to

diff --git a/man/systemd.unit.xml b/man/systemd.unit.xml
index 5cd8be310d643e6c52253d57010a343a85cd5302..445c26f3e501bde909323b90cc734ced521cdaa2 100644 (file)
--- a/man/systemd.unit.xml
+++ b/man/systemd.unit.xml
@@ -665,7 +665,9 @@
 
         <listitem><para>A space-separated list of one or more units
         that are activated when this unit enters the
-        <literal>failed</literal> state.</para></listitem>
+        <literal>failed</literal> state.  A service unit using
+        <varname>Restart=</varname> enters the failed state only after
+        the start limits are reached.</para></listitem>
       </varlistentry>
 
       <varlistentry>

diff --git a/man/systemd.xml b/man/systemd.xml
index 62ececb6e9bbc13e0253a7c7999d98139abd9e60..a881b392a7be89aa321ea3f0d8aa99dd9be5cf6e 100644 (file)
--- a/man/systemd.xml
+++ b/man/systemd.xml
@@ -297,11 +297,12 @@
     states are called "activating", "deactivating"). A special
     "failed" state is available as well, which is very similar to
     "inactive" and is entered when the service failed in some way
-    (process returned error code on exit, or crashed, or an operation
-    timed out). If this state is entered, the cause will be logged,
-    for later reference. Note that the various unit types may have a
-    number of additional substates, which are mapped to the five
-    generalized unit states described here.</para>
+    (process returned error code on exit, or crashed, an operation
+    timed out, or after too many restarts). If this state is entered,
+    the cause will be logged, for later reference. Note that the
+    various unit types may have a number of additional substates,
+    which are mapped to the five generalized unit states described
+    here.</para>
 
     <para>The following unit types are available:</para>