man: document that "systemctl reset-failed" also reset the start limit counters

Fixes: #10529

diff --git a/man/systemctl.xml b/man/systemctl.xml
index e32ee6cacb5e68e2562c8b3e26ad5690b6c0611a..09cb03948afb878e9447b3087e4cd622fc4a81d9 100644 (file)
--- a/man/systemctl.xml
+++ b/man/systemctl.xml
@@ -1058,6 +1058,12 @@ Jan 12 10:46:45 example.com bluetoothd[8900]: gatt-time-server: Input/output err
             terminating abnormally or timing out), it will automatically enter the <literal>failed</literal> state and
             its exit code and status is recorded for introspection by the administrator until the service is
             stopped/re-started or reset with this command.</para>
+
+            <para>In addition to resetting the <literal>failed</literal> state of a unit it also resets various other
+            per-unit properties: the start rate limit counter of all unit types is reset to zero, as is the restart
+            counter of service units. Thus, if a unit's start limit (as configured with
+            <varname>StartLimitIntervalSec=</varname>/<varname>StartLimitBurst=</varname>) is hit and the unit refuses
+            to be started again, use this command to make it startable again.</para>
           </listitem>
         </varlistentry>