diff --git a/man/systemd.path.xml b/man/systemd.path.xml index 39cca8cf51..f6fe3d8388 100644 --- a/man/systemd.path.xml +++ b/man/systemd.path.xml @@ -52,6 +52,15 @@ limitations as inotify, and for example cannot be used to monitor files or directories changed by other machines on remote NFS file systems. + + When a service unit triggered by a path unit terminates (regardless whether it exited successfully + or failed), monitored paths are checked immediately again, and the service accordingly restarted + instantly. As protection against busy looping in this trigger/start cycle, a start rate limit is enforced + on the service unit, see StartLimitIntervalSec= and + StartLimitBurst= in + systemd.unit5. Unlike + other service failures, the error condition that the start rate limit is hit is propagated from the + service unit to the path unit and causes the path unit to fail as well, thus ending the loop.