diff --git a/man/sd_notify.xml b/man/sd_notify.xml
index eb449555cb..a91c1bb4bf 100644
--- a/man/sd_notify.xml
+++ b/man/sd_notify.xml
@@ -156,12 +156,19 @@
WATCHDOG=1Tells systemd to
- update the watchdog timestamp.
- Services using this feature should do
- this in regular intervals. A watchdog
- framework can use the timestamps to
- detect failed
- services.
+ update the watchdog timestamp. This is
+ the keep-alive ping that services need
+ to issue in regular intervals if
+ WatchdogSec= is
+ enabled for it. See
+ systemd.service5
+ for details. It is recommended to send
+ this message if the
+ WATCHDOG_USEC=
+ environment variable has been set for
+ the service process, in every half the
+ time interval that is specified in the
+ variable.
diff --git a/man/systemd.service.xml b/man/systemd.service.xml
index 233807d2b3..c57bce0ecf 100644
--- a/man/systemd.service.xml
+++ b/man/systemd.service.xml
@@ -482,26 +482,29 @@
is activated when the start-up is
completed. The service must call
sd_notify3
- regularly with "WATCHDOG=1". If the
- time between two such calls is larger
- than the configured time then the
- service is placed in a failure
- state. By setting
- Restart=
- to or
+ regularly with "WATCHDOG=1" (i.e. the
+ "keep-alive ping"). If the time
+ between two such calls is larger than
+ the configured time then the service
+ is placed in a failure state. By
+ setting Restart= to
+ or
the service
will be automatically restarted. The
time configured here will be passed to
the executed service process in the
WATCHDOG_USEC=
- environment variable. If
+ environment variable. This allows
+ daemons to automatically enable the
+ keep-alive pinging logic if watchdog
+ support is enabled for the service. If
this option is used
NotifyAccess= (see
below) should be set to open access to
the notification socket provided by
systemd. If
- NotifyAccess= is not
- set, it will be implicitly set to
+ NotifyAccess= is
+ not set, it will be implicitly set to
. Defaults to 0,
which disables this
feature.