diff --git a/man/systemd.service.xml b/man/systemd.service.xml index 76dfe60be4..b0aee3329f 100644 --- a/man/systemd.service.xml +++ b/man/systemd.service.xml @@ -754,7 +754,8 @@ limiting configured with StartLimitIntervalSec= and StartLimitBurst=, see systemd.unit5 - for details. + for details. A restarted service enters the failed state only + after the start limits are reached. Setting this to is the recommended choice for long-running services, in order to diff --git a/man/systemd.unit.xml b/man/systemd.unit.xml index 5cd8be310d..445c26f3e5 100644 --- a/man/systemd.unit.xml +++ b/man/systemd.unit.xml @@ -665,7 +665,9 @@ A space-separated list of one or more units that are activated when this unit enters the - failed state. + failed state. A service unit using + Restart= enters the failed state only after + the start limits are reached. diff --git a/man/systemd.xml b/man/systemd.xml index 62ececb6e9..a881b392a7 100644 --- 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. + (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. The following unit types are available: