mirror of
https://github.com/kuhyx/utils.git
synced 2026-11-10 19:07:17 +01:00
Krzysztof kuhy Rudnicki
694c013b6b
Some checks failed
dependency freshness / dependencies on newest stable (push) Has been cancelled
file length / file-length (push) Has been cancelled
md-naming / markdown naming convention (push) Has been cancelled
palette drift / palette (push) Has been cancelled
shared gate tests / gate unit tests (push) Has been cancelled
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
91 lines
3.5 KiB
Bash
91 lines
3.5 KiB
Bash
#!/bin/bash
|
|
# ============================================================================
|
|
# vmbox: classify what happened to a guest, from the HOST.
|
|
#
|
|
# A guest cannot report its own poweroff: the connection carrying the report
|
|
# dies with it, and ssh returns 255 for a clean shutdown, a crash, a killed
|
|
# sshd and a network blip alike. So the verdict is read from two host-side
|
|
# artefacts that outlive the VM -- the QMP event log and the serial log.
|
|
# ============================================================================
|
|
|
|
# shellcheck source=common.sh
|
|
source "$(dirname "${BASH_SOURCE[0]}")/common.sh"
|
|
|
|
# The line the kernel prints as the very last thing on a complete poweroff.
|
|
readonly POWEROFF_MARKER='reboot: Power down'
|
|
|
|
# Read the last SHUTDOWN/panic event out of events.jsonl.
|
|
# Echoes one of: guest-shutdown | hibernate | guest-reset | host-* | panic | none
|
|
verdict_last_event() {
|
|
local events="$1"
|
|
[[ -s "$events" ]] || { printf 'none'; return 0; }
|
|
python3 "$VMBOX_LIB_DIR/last_event.py" "$events"
|
|
}
|
|
|
|
# Did the guest reach the end of its shutdown sequence, or die partway?
|
|
# This is what separates "shut down" from "shut down COMPLETELY".
|
|
verdict_serial_complete() {
|
|
local serial="$1"
|
|
[[ -s "$serial" ]] || return 1
|
|
grep -qa "$POWEROFF_MARKER" "$serial"
|
|
}
|
|
|
|
# Liveness probe, so a merely SLOW script (an installer running pacman -Syu)
|
|
# is not reported as hung.
|
|
verdict_is_alive() {
|
|
local name="$1" serial="$2" before after
|
|
vm_is_running "$name" || return 1
|
|
before=$(stat -c %s "$serial" 2>/dev/null || echo 0)
|
|
sleep 3
|
|
after=$(stat -c %s "$serial" 2>/dev/null || echo 0)
|
|
[[ "$after" != "$before" ]] && return 0
|
|
source "$VMBOX_LIB_DIR/ssh.sh"
|
|
vm_ssh_exec "$name" -o BatchMode=yes -o ConnectTimeout=3 true 2>/dev/null
|
|
}
|
|
|
|
# Print the human-readable verdict and return a distinct exit code per outcome:
|
|
# 0 clean poweroff 3 dirty 4 rebooted 5 panicked 6 hung 7 still running
|
|
# 8 hibernated
|
|
verdict_report() {
|
|
local name="$1" serial="$2" events="$3" kind
|
|
kind="$(verdict_last_event "$events")"
|
|
|
|
case "$kind" in
|
|
guest-shutdown)
|
|
if verdict_serial_complete "$serial"; then
|
|
ok "VERDICT: clean poweroff -- guest powered itself off and reached '$POWEROFF_MARKER'"
|
|
return 0
|
|
fi
|
|
warn "VERDICT: DIRTY shutdown -- the VM stopped, but the serial log never reached"
|
|
warn " '$POWEROFF_MARKER'; the sequence was cut short (see $serial)"
|
|
return 3
|
|
;;
|
|
hibernate)
|
|
# Not a failure and not a poweroff: S4 leaves no 'Power down' line,
|
|
# which used to be misreported as a DIRTY shutdown.
|
|
ok "VERDICT: hibernated -- the guest entered ACPI S4 (QMP SUSPEND_DISK)"
|
|
return 8
|
|
;;
|
|
guest-reset)
|
|
warn "VERDICT: REBOOTED, did not power off -- the guest reset instead of halting"
|
|
return 4
|
|
;;
|
|
panic)
|
|
warn "VERDICT: KERNEL PANIC -- the guest crashed rather than shutting down"
|
|
return 5
|
|
;;
|
|
host*|none)
|
|
if vm_is_running "$name"; then
|
|
ok "VERDICT: still running (no shutdown event)"
|
|
return 7
|
|
fi
|
|
warn "VERDICT: stopped without a guest shutdown event (host-initiated or killed)"
|
|
return 6
|
|
;;
|
|
*)
|
|
warn "VERDICT: unrecognised shutdown reason '$kind'"
|
|
return 6
|
|
;;
|
|
esac
|
|
}
|