X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fsd_watchdog_enabled.xml;h=0e4df3750668585b9dd6afa5fa2ee1d8fe51a1d7;hp=5b0d7e21cb2b4fc2f303de33f5274b5069e66d51;hb=26e3ff59a6a197e442255d8adfa2df239405c7e5;hpb=494a66821815e8109afa136bd42818b85da38c09 diff --git a/man/sd_watchdog_enabled.xml b/man/sd_watchdog_enabled.xml index 5b0d7e21c..0e4df3750 100644 --- a/man/sd_watchdog_enabled.xml +++ b/man/sd_watchdog_enabled.xml @@ -80,7 +80,7 @@ inherited by child processes. If the usec parameter is - non-NULL sd_watchdog_enabled() + non-NULL, sd_watchdog_enabled() will return the timeout in µs for the watchdog logic. The service manager will usually terminate a service when it did not get a notification message @@ -94,7 +94,7 @@ WATCHDOG=1. To enable service supervision with the watchdog - logic use WatchdogSec= in service + logic, use WatchdogSec= in service files. See systemd.service5 for details. @@ -107,7 +107,7 @@ errno-style error code. If the service manager expects watchdog keep-alive notification messages to be sent, > 0 is returned, otherwise 0 is returned. Only if - the return value is > 0 the + the return value is > 0, the usec parameter is valid after the call. @@ -115,13 +115,10 @@ Notes - This function is provided by the reference - implementation of APIs for new-style daemons and - distributed with the systemd package. The algorithm - it implements is simple, and can easily be - reimplemented in daemons if it is important to support - this interface without using the reference - implementation. + These APIs are implemented as a shared library, + which can be compiled and linked to with the + libsystemd pkg-config1 + file. Internally, this functions parses the $WATCHDOG_PID and @@ -129,32 +126,9 @@ variable. The call will ignore these variables if $WATCHDOG_PID does containe the PID of the current process, under the assumption that in - that case the variables were set for a different + that case, the variables were set for a different process further up the process tree. - For details about the algorithm check the - liberally licensed reference implementation sources: - - and - - sd_watchdog_enabled() is - implemented in the reference implementation's - sd-daemon.c and - sd-daemon.h files. These - interfaces are available as a shared library, which can - be compiled and linked to with the - libsystemd-daemon pkg-config1 - file. Alternatively, applications consuming these APIs - may copy the implementation into their source - tree. For more details about the reference - implementation see - sd-daemon3. - - If the reference implementation is used as - drop-in files and -DDISABLE_SYSTEMD is set during - compilation, these functions will always return 0 and - otherwise become a NOP.