diff --git a/man/systemd.unit.xml b/man/systemd.unit.xml index c37eb323612..043c4ed16eb 100644 --- a/man/systemd.unit.xml +++ b/man/systemd.unit.xml @@ -764,14 +764,14 @@ - StartLimitIntervalSec= - StartLimitBurst= + StartLimitIntervalSec=interval + StartLimitBurst=burst - Configure unit start rate limiting. By default, units which are started more than 5 times - within 10 seconds are not permitted to start any more times until the 10 second interval ends. With these two - options, this rate limiting may be modified. Use StartLimitIntervalSec= to configure the + Configure unit start rate limiting. Units which are started more than + burst times within an interval time interval + are not permitted to start any more. Use StartLimitIntervalSec= to configure the checking interval (defaults to DefaultStartLimitIntervalSec= in manager configuration file, - set to 0 to disable any kind of rate limiting). Use StartLimitBurst= to configure how many + set it to 0 to disable any kind of rate limiting). Use StartLimitBurst= to configure how many starts per interval are allowed (defaults to DefaultStartLimitBurst= in manager configuration file). These configuration options are particularly useful in conjunction with the service setting Restart= (see @@ -779,13 +779,14 @@ they apply to all kinds of starts (including manual), not just those triggered by the Restart= logic. Note that units which are configured for Restart= and which reach the start limit are not attempted to be restarted anymore; however, they may still be restarted - manually at a later point, from which point on, the restart logic is again activated. Note that + manually at a later point, after the interval has passed. + From this point on, the restart logic is activated again. Note that systemctl reset-failed will cause the restart rate counter for a service to be flushed, which is useful if the administrator wants to manually start a unit and the start limit interferes with that. Note that this rate-limiting is enforced after any unit condition checks are executed, and hence unit - activations with failing conditions are not counted by this rate limiting. Slice, target, device and scope - units do not enforce this setting, as they are unit types whose activation may either never fail, or may - succeed only a single time. + activations with failing conditions do not count towards this rate limit. This setting does not apply to + slice, target, device, and scope units, since they are unit types whose activation may either never fail, or + may succeed only a single time.