diff --git a/man/systemd.service.xml b/man/systemd.service.xml index 8b9994a46a..549f36af1d 100644 --- a/man/systemd.service.xml +++ b/man/systemd.service.xml @@ -590,7 +590,29 @@ RestartSteps= Configures the number of exponential steps to take to increase the interval of auto-restarts from RestartSec= to RestartMaxDelaySec=. - Takes a positive integer or 0 to disable it. Defaults to 0. + Takes a positive integer or 0 to disable it. Defaults to 0. Hint: values + between 3 and 5 are good choices when exponential backoff is desired. + + Example: + + RestartSec=10s +RestartSteps=4 +RestartMaxDelaySec=160s + + This will produce the following restart intervals: 10s, 20s, 40s, 80s, 160s, 160s, 160s, etc. + Notice the geometric interpolation and the resulting constant ratio between intervals; here it is 2. + The formula for the ratio is + + + (RestartMaxDelaySec / RestartSec)^(1 / RestartSteps) + + . A (repeating) delay equal to RestartMaxDelaySec= is always + reached after + + + RestartSteps + 1 + + steps. This setting is effective only if RestartMaxDelaySec= is also set and RestartSec= is not zero.