diff options
author | Jannis Pohlmann <jannis.pohlmann@codethink.co.uk> | 2012-08-07 15:03:59 +0100 |
---|---|---|
committer | Jannis Pohlmann <jannis.pohlmann@codethink.co.uk> | 2012-08-07 15:03:59 +0100 |
commit | 8188ae8c8f46c8ddc6707ff897008d9d3864d30c (patch) | |
tree | 7e245d85bad63dd0ab6061c61ee666115c5cd06e | |
parent | 9031d8581af77a649a91be6e1ddacdad9883c1ab (diff) | |
download | node-startup-controller-8188ae8c8f46c8ddc6707ff897008d9d3864d30c.tar.gz |
Improve WatchdogClient documentation a bit
-rw-r--r-- | common/watchdog-client.c | 16 |
1 files changed, 10 insertions, 6 deletions
diff --git a/common/watchdog-client.c b/common/watchdog-client.c index 4ccf15c..1087024 100644 --- a/common/watchdog-client.c +++ b/common/watchdog-client.c @@ -22,15 +22,19 @@ /** * SECTION: watchdog-client - * @title: Watchdog Client - * @short_description: Notifies the systemd watchdog over a set period. + * @title: WatchdogClient + * @short_description: Notifies the systemd watchdog in regular intervals. * @stability: Internal * - * The watchdog client notifies systemd's watchdog regularly over a period of seconds - * defined in watchdog_client_new(). If the appropriate service file has %WatchdogSec set - * then systemd will restart the service if it has not replied during that period (e.g. it + * The #WatchdogClient notifies systemd's watchdog in a regular interval that + * is specified upon construction. If the unit file associated with the + * application has %WatchdogSec set then systemd will restart the application + * if it does not update the watchdog timestamp in this interval (e.g. if it * has crashed or is stuck in an infinite loop). - * + * + * In order to avoid problems with delays it is recommended to notify the + * systemd watchdog twice in the %WatchdogSec interval, so usually the + * value passed to #watchdog_client_new will be half of %WatchdogSec. */ |