summaryrefslogtreecommitdiff
path: root/man/sd_notify.xml
diff options
context:
space:
mode:
authorMichael Olbrich <m.olbrich@pengutronix.de>2012-02-01 17:17:12 +0100
committerLennart Poettering <lennart@poettering.net>2012-02-01 19:29:19 +0100
commita6927d7ffc18c51fbb9940f5f1e89f5c7695ed63 (patch)
treea56630fa33002013683a69126a2caec16ef31b6c /man/sd_notify.xml
parentc4aa65e7147dc742886edf25593e10466b02fc3a (diff)
downloadsystemd-a6927d7ffc18c51fbb9940f5f1e89f5c7695ed63.tar.gz
service: add watchdog timestamp
This patch adds WatchdogTimestamp[Monotonic] to the systemd service D-Bus API. The timestamp is updated to the current time when the service calls 'sd_nofity("WATCHDOG=1\n")'. Using a timestamp instead of an 'alive' flag has two advantages: 1. No timeout is needed to define when a service is no longer alive. This simplifies both configuration (no timeout value) and implementation (no timeout event). 2. It is more robust. A 'dead' service might not be detected should systemd 'forget' to reset an 'alive' flag. It is much less likely to get a valid new timestamp if a service died.
Diffstat (limited to 'man/sd_notify.xml')
-rw-r--r--man/sd_notify.xml12
1 files changed, 12 insertions, 0 deletions
diff --git a/man/sd_notify.xml b/man/sd_notify.xml
index 020914607c..9797a5f801 100644
--- a/man/sd_notify.xml
+++ b/man/sd_notify.xml
@@ -151,6 +151,18 @@
itself. Example:
"MAINPID=4711"</para></listitem>
</varlistentry>
+
+ <varlistentry>
+ <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>
+ </varlistentry>
</variablelist>
<para>It is recommended to prefix variable names that