SD_WATCHDOG_ENABLED - Online Linux Manual PageSection : 3
Updated :
Source : systemd 250
Note : sd_watchdog_enabled
NAMEsd_watchdog_enabled − Check whether the service manager expects watchdog keep−alive notifications from a service
SYNOPSIS#include <systemd/sd−daemon.h>int sd_watchdog_enabled(int unset_environment, uint64_t *usec);
DESCRIPTIONsd_watchdog_enabled() may be called by a service to detect whether the service manager expects regular keep−alive watchdog notification events from it, and the timeout after which the manager will act on the service if it did not get such a notification. If the $WATCHDOG_USEC environment variable is set, and the $WATCHDOG_PID variable is unset or set to the PID of the current process, the service manager expects notifications from this process. The manager will usually terminate a service when it does not get a notification message within the specified time after startup and after each previous message. It is recommended that a daemon sends a keep−alive notification message to the service manager every half of the time returned here. Notification messages may be sent with sd_notify(3) with a message string of "WATCHDOG=1". If the unset_environment parameter is non−zero, sd_watchdog_enabled() will unset the $WATCHDOG_USEC and $WATCHDOG_PID environment variables before returning (regardless of whether the function call itself succeeded or not). Those variables are no longer inherited by child processes. Further calls to sd_watchdog_enabled() will also return with zero. If the usec parameter is non−NULL, sd_watchdog_enabled() will write the timeout in µs for the watchdog logic to it. To enable service supervision with the watchdog logic, use WatchdogSec= in service files. See systemd.service(5) for details. Use sd_event_set_watchdog(3) to enable automatic watchdog support in sd-event(3)−based event loops.
RETURN VALUEOn failure, this call returns a negative 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 usec parameter is valid after the call.
NOTESThese APIs are implemented as a shared library, which can be compiled and linked to with the libsystemd pkg-config(1) file. Internally, this function parses the $WATCHDOG_PID and $WATCHDOG_USEC environment variable. The call will ignore these variables if $WATCHDOG_PID does not contain the PID of the current process, under the assumption that in that case, the variables were set for a different process further up the process tree.
ENVIRONMENT$WATCHDOG_PID Set by the system manager for supervised process for which watchdog support is enabled, and contains the PID of that process. See above for details. $WATCHDOG_USEC Set by the system manager for supervised process for which watchdog support is enabled, and contains the watchdog timeout in µs. See above for details.
SEE ALSOsystemd(1), sd-daemon(3), daemon(7), systemd.service(5), sd_notify(3), sd_event_set_watchdog(3) 0
Johanes Gumabo
Data Size : 10,721 byte
man-sd_watchdog_enabled.3Build : 2024-12-05, 20:55 :
Visitor Screen : x
Visitor Counter ( page / site ) : 2 / 184,637
Visitor ID : :
Visitor IP : 3.144.237.52 :
Visitor Provider : AMAZON-02 :
Provider Position ( lat x lon ) : 39.962500 x -83.006100 : x
Provider Accuracy Radius ( km ) : 1000 :
Provider City : Columbus :
Provider Province : Ohio , : ,
Provider Country : United States :
Provider Continent : North America :
Visitor Recorder : Version :
Visitor Recorder : Library :
Online Linux Manual Page : Version : Online Linux Manual Page - Fedora.40 - march=x86-64 - mtune=generic - 24.12.05
Online Linux Manual Page : Library : lib_c - 24.10.03 - march=x86-64 - mtune=generic - Fedora.40
Online Linux Manual Page : Library : lib_m - 24.10.03 - march=x86-64 - mtune=generic - Fedora.40
Data Base : Version : Online Linux Manual Page Database - 24.04.13 - march=x86-64 - mtune=generic - fedora-38
Data Base : Library : lib_c - 23.02.07 - march=x86-64 - mtune=generic - fedora.36
Very long time ago, I have the best tutor, Wenzel Svojanovsky . If someone knows the email address of Wenzel Svojanovsky , please send an email to johanes_gumabo@yahoo.co.id .
If error, please print screen and send to johanes_gumabo@yahoo.co.id
Under development. Support me via PayPal.