Files
NX2navi/tests/hang_watch_check.c
chrg6 b4556957c2 Add a hang watch that logs a report when no frame is shown with the window in front, or the GPU does not finish, for 20 s.
A present, a submission or a completion that never came back (a deadlock, a driver wait that does not return, a
GPU hang without a reset) left a log that just stopped: kernel.c wait_watch covers guest lock and thread-end waits
only and is off by default, and nothing watched the present, submit or completion threads.

hang_watch.c runs a thread of its own in a game run (main.c starts it before the boot; never in the tool modes).
Once a second it reads, without a lock, gfx_counters.frames and the submissions issued and done (the new
vk_sync.c vk_sync_progress, no device call). It reports a stall of the frames while the guest runs, the window is
in front and not minimized (gfx_window_in_front) and no orderly end has begun (rt_exit_started): the game stops
presenting without the focus, so a focus change starts the count again, and the boot screen is not judged. It
reports submissions issued and not done, "done" unchanged for N s, whatever the focus. One report per stall, a
new stall needs progress, at most 3 a run. A report names the stall with the counts, the focus and the world
clock; who holds the present, queue and window-start locks (gfx_present.c gfx_lock_holders, read from
PlatRMutex.owner and depth); the guest threads' lock and thread-end waits (kernel.c kern_wait_report, wait_watch's
walk factored out as wait_pass, run with limit 0 under ten 10 ms trylocks of the kernel lock); and then writes the
log out with logq_flush, never rt_log_sync, which would put every later line on the thread that logs it in a run
that may recover. It never ends the process and adds no wait to a drawing thread. The per-thread wait sites and
lock owner wrappers are left for a later change.

NX2NAVI_HANG_WATCH_S sets the seconds (default 20, 0..600, read at start, 0 off): a metas row, a known[] name, a
diagnostics sections[] entry and an nx2navi.ini.example entry.

Not reproduced before the change (a diagnostic). The new tests/hang_watch_check.py drives hang_watch.c's decisions
on made-up readings: no report while things move, unfocused, minimized or ending; one per stall of the frames with
the window in front and one again after progress; one for submissions not done whatever the focus; none for an
idle GPU; at most 3; logq_flush called and logq_sync never. tests/cfg_rows_check.py (0 problems), the scratchpad
rows check ("missing []") and the compile checks of every runtime file pass.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-13 18:42:34 -05:00

92 lines
3.5 KiB
C

// runtime/hang_watch.c's decisions on made-up readings, a second apart, with stand-ins for what it reads and calls.
// Built and run by tests/hang_watch_check.py; prints each failed check and exits 1 on any.
#include "hang_watch.c"
#include <stdarg.h>
#include <stdio.h>
static int fails;
#define CHECK(c, ...) do { if (!(c)) { fails++; printf("FAIL line %d: ", __LINE__); printf(__VA_ARGS__); printf("\n"); } } while (0)
// ---- the runtime hang_watch.c reaches
GfxStats gfx_counters;
uint64_t rt_guest_start_ns = 1;
static int focused = 1, minimized, ending, flushes, syncs, wait_reports;
static uint64_t issued_v, done_v;
void vk_sync_progress(uint64_t *issued, uint64_t *done) { *issued = issued_v, *done = done_v; }
int gfx_window_in_front(void) { return focused && !minimized; }
int rt_exit_started(void) { return ending; }
int64_t frame_step_world_us(void) { return 1000000; }
void gfx_lock_holders(GfxLockHolders *h) { *h = (GfxLockHolders){7, 1, 0, 0, 0}; }
void kern_wait_report(void) { wait_reports++; }
void logq_flush(void) { flushes++; }
void logq_sync(void) { syncs++; }
void rt_log(const char *fmt, ...) {
va_list ap;
va_start(ap, fmt);
printf(" log: ");
vprintf(fmt, ap);
printf("\n");
va_end(ap);
}
int cfg_int(const char *name) { (void)name; return 20; }
// ---- the readings: t seconds, the frames shown so far, focus, and the GPU's issued and done values
static HangWatch w;
static uint64_t t_s;
static int run(int seconds, int frames_move, int gpu_move) {
int reports = 0;
for (int i = 0; i < seconds; i++) {
t_s++;
if (frames_move) gfx_counters.frames++;
if (gpu_move) issued_v++, done_v++;
HwBeat b;
hw_read(&b);
b.now_ns = t_s * 1000000000ull;
int kind = hw_step(&w, &b);
if (kind) {
hw_report(kind, &b, &w);
reports++;
}
}
return reports;
}
int main(void) {
setvbuf(stdout, NULL, _IONBF, 0);
w = (HangWatch){.limit_ns = 20000000000ull};
CHECK(!run(100, 1, 1), "a report while frames and the GPU move");
focused = 0;
CHECK(!run(100, 0, 0), "a report while the window is not in front");
focused = 1, minimized = 1;
CHECK(!run(100, 0, 0), "a report while the window is minimized");
minimized = 0, ending = 1;
CHECK(!run(100, 0, 0), "a report while the process ends");
ending = 0;
int r = run(19, 0, 0);
CHECK(!r, "a report before 20 s without a frame in front");
r = run(60, 0, 0);
CHECK(r == 1, "%d reports for one stall of the frames, want 1", r);
CHECK(flushes == 1 && wait_reports == 1 && !syncs, "the report wrote %d flushes, %d wait lists and %d syncs", flushes,
wait_reports, syncs);
r = run(5, 1, 1) + run(30, 0, 0);
CHECK(r == 1, "%d reports for a second stall after progress, want 1", r);
focused = 0; // the GPU stops: reported whatever the focus
issued_v += 3;
r = run(30, 0, 0);
CHECK(r == 1, "%d reports for submissions not done, want 1", r);
issued_v = done_v;
r = run(5, 1, 1);
focused = 1;
r += run(60, 0, 0);
CHECK(r == 0, "%d reports after the third: at most 3 a run", r);
CHECK(w.reports == 3, "%d reports in all, want 3", w.reports);
// a fresh watch: the GPU idle (nothing outstanding) is no stall
w = (HangWatch){.limit_ns = 20000000000ull};
focused = 0;
issued_v = done_v;
CHECK(!run(100, 0, 0), "a report for an idle GPU");
printf("hang_watch_check: %s\n", fails ? "FAILED" : "ok");
return fails ? 1 : 0;
}