X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fsd_notify.xml;h=a91c1bb4bf4c6893afaa7c85c6a34a0bbec3c7cf;hp=eb449555cb4437342c17d02cdcd8a5484783dc7f;hb=9946996cda11a18b44d82344676e5a0e96339408;hpb=5430f7f2bc7330f3088b894166bf3524a067e3d8

diff --git a/man/sd_notify.xml b/man/sd_notify.xml
index eb449555c..a91c1bb4b 100644
--- a/man/sd_notify.xml
+++ b/man/sd_notify.xml
@@ -156,12 +156,19 @@
                                 <term>WATCHDOG=1</term>
 
                                 <listitem><para>Tells 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.</para></listitem>
+                                update the watchdog timestamp. This is
+                                the keep-alive ping that services need
+                                to issue in regular intervals if
+                                <varname>WatchdogSec=</varname> is
+                                enabled for it. See
+                                <citerefentry><refentrytitle>systemd.service</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+                                for details. It is recommended to send
+                                this message if the
+                                <varname>WATCHDOG_USEC=</varname>
+                                environment variable has been set for
+                                the service process, in every half the
+                                time interval that is specified in the
+                                variable.</para></listitem>
                         </varlistentry>
                 </variablelist>