]> git.ipfire.org Git - thirdparty/systemd.git/commit
man: improve documentation for RestartSteps (#40879)
authorVal Markovic <val@markovic.io>
Mon, 2 Mar 2026 03:38:35 +0000 (04:38 +0100)
committerLuca Boccassi <luca.boccassi@gmail.com>
Thu, 12 Mar 2026 20:13:23 +0000 (20:13 +0000)
commitf12bf01d1d28d241f2a5f2aff8cb1eebe19f62db
treefe4463c51a6250660f8c98c4dadb84ba475fa17e
parent2e337e9e6dd47b04de50e02a07da1f736a89b0b6
man: improve documentation for RestartSteps (#40879)

I found the existing explanation of RestartSteps to be simply
impenetrable. Even providing the full docs context to several of our new
AI overlords resulted in wildly different (and completely incorrect)
explanations of the final restart intervals.

Digging through the code, I found the restart delay computation in
`service_restart_usec_next` in `src/core/service.c`.

I've updated the documentation for RestartSteps with an example,
suggested value range and a detailed enough explanation that accurately
describes the current behavior.

(cherry picked from commit 4724cf5526b5c6a08267d1b1bb23e962ebe60521)
(cherry picked from commit 7b1ea2374aa9834e41d4e444f54e25cc5bd7f7b9)
(cherry picked from commit 4479c8a0fa937f5e7dc0f519f5b184e3ad86f11a)
man/systemd.service.xml