From: Matthijs Kooijman <matthijs@stdin.nl>
Date: Thu, 8 Jan 2026 22:37:08 +0000 (+0100)
Subject: man/systemd.service: Note RestartSteps only works with RestartSec= set
X-Git-Tag: v257.11~102
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=23cdcbc0d6cf53f1c767633a41621043acf4f235;p=thirdparty%2Fsystemd.git

man/systemd.service: Note RestartSteps only works with RestartSec= set

Setting Restart=0 seems reasonable to have no delay on the first
restart, if you do not realize this is impossible with an exponential
restart. So explicitly mention that RestartSec must be set.

(cherry picked from commit af88aa17c71f3072788e7780fa0b16bb241faf9b)
(cherry picked from commit e70240c3d631976ca93aea90bb3b969a774a882a)
(cherry picked from commit 7910079dce73cd730925d7decdd4350ef3f73c3a)
---

diff --git a/man/systemd.service.xml b/man/systemd.service.xml
index 284d87631e5..f6d535bda42 100644
--- a/man/systemd.service.xml
+++ b/man/systemd.service.xml
@@ -583,7 +583,8 @@
         of auto-restarts from <varname>RestartSec=</varname> to <varname>RestartMaxDelaySec=</varname>.
         Takes a positive integer or 0 to disable it. Defaults to 0.</para>
 
-        <para>This setting is effective only if <varname>RestartMaxDelaySec=</varname> is also set.</para>
+        <para>This setting is effective only if <varname>RestartMaxDelaySec=</varname> is also set and
+        <varname>RestartSec=</varname> is not zero.</para>
 
         <xi:include href="version-info.xml" xpointer="v254"/></listitem>
       </varlistentry>
@@ -595,7 +596,8 @@
         in the same format as <varname>RestartSec=</varname>, or <literal>infinity</literal>
         to disable the setting. Defaults to <literal>infinity</literal>.</para>
 
-        <para>This setting is effective only if <varname>RestartSteps=</varname> is also set.</para>
+        <para>This setting is effective only if <varname>RestartSteps=</varname> is also set and
+        <varname>RestartSec=</varname> is not zero.</para>
 
         <xi:include href="version-info.xml" xpointer="v254"/></listitem>
       </varlistentry>