Files
xen/tools/hotplug/Linux/systemd/xen-watchdog-sleep.sh
T
Mykola Kvach e54a6cd6a1 systemd: Add hooks to stop/start xen-watchdog on suspend/resume
This patch adds a systemd sleep hook script to stop the xen-watchdog
service before system suspend and start it again after resume.

Stopping the watchdog before a system suspend operation may look unsafe.
Let's imagine the following situation: 'systemctl suspend' does not
interact with the running service at all. In such a case, the Xen
watchdog daemon freezes just before suspend. If this happens, for
example, right before sending a ping, and Xen has not yet marked the
domain as suspended (is_shutting_down), the Xen watchdog timer may
trigger a false alert.

This is an almost impossible situation, because typically:
    ping time = watchdog timeout / 2

and the watchdog timeout is usually set to a relatively large value
(dozens of seconds).

Still, this is more likely with very short watchdog timeouts. It may
happen in the following scenarios:
    * Significant delays occur between freezing Linux tasks and
      triggering the ACPI or PSCI sleep request or handler.
    * Long delays happen inside Xen between the entrance to the sleep
      trigger and the actual forwarding of the sleep request further.

A similar situation may occur on resume with short timeouts. During the
resume operation, Xen restores timers and the domain context. The Xen
watchdog timer also resumes. If it schedules the domain right before the
watchdog timeout expires, and the daemon responsible for pinging is not
yet running, a timeout might occur.

Both scenarios are rare and typically require very small watchdog
timeouts combined with significant delays in Xen or the Linux kernel
during suspend/resume flows.

Conceptually, however, if activating and pinging the Xen watchdog is the
responsibility of the domain and its services, then the domain should
also manage the watchdog service/daemon lifecycle. This is similar to
what is already done by the Xen watchdog driver inside the Linux kernel.

Signed-off-by: Mykola Kvach <mykola_kvach@epam.com>
Reviewed-by: Denis Mukhin <dmukhin@ford.com>
Reviewed-by: Anthony PERARD <anthony.perard@vates.tech>
2025-08-01 15:36:02 +02:00

35 lines
782 B
Bash

#!/bin/sh
# The first argument ($1) is:
# "pre" or "post"
# The second argument ($2) is:
# "suspend", "hibernate", "hybrid-sleep", or "suspend-then-hibernate"
. /etc/xen/scripts/hotplugpath.sh
SERVICE_NAME="xen-watchdog.service"
STATE_FILE="${XEN_RUN_DIR}/xen-watchdog-sleep-flag"
case "$1" in
pre)
if systemctl is-active --quiet "${SERVICE_NAME}"; then
touch "${STATE_FILE}"
echo "Stopping ${SERVICE_NAME} before $2."
systemctl stop "${SERVICE_NAME}"
fi
;;
post)
if [ -f "${STATE_FILE}" ]; then
echo "Starting ${SERVICE_NAME} after $2."
systemctl start "${SERVICE_NAME}"
rm "${STATE_FILE}"
fi
;;
*)
echo "Script called with unknown action '$1'. Arguments: '$@'"
exit 1
;;
esac
exit 0