Files
Sylpheed/docs/re/structures/title-a-press-fault.md
sylph-decoder e94e203a71 re: the A-press fault is SOLVED -- Xenia swallows input, the guest pump is unbounded
The 326 MB log from the failing run was still on disk, so this needed no
emulator time at all.

Mechanism: Xenia's XamInputGetKeystrokeEx returns X_ERROR_SUCCESS with a zeroed
keystroke on every call while a XAM dialog is up (xam_input.cc:197, upstream
Canary). The game's keystroke pump -- sub_82457038, read out of the image -- is
an unbounded 'while (GetKeystrokeEx() == SUCCESS) queue.push_back()'. It queued
8 388 608 empty keystrokes, grew its vector to 64 MB, asked for 128 MB, got a
failed allocation back unchecked, and copied off the top of the guest stack.

Two independent instruments agree to within 7: the Canary counter's last report
before the crash says 8 388 601 swallowed calls; the crash dump's r29 says the
vector held 8 388 608. The reporting granularity is 600.

Retracts this page's own 'r9 is a wild pointer above 4 GB'. Xenia prints
si_addr, a host address; the guest is mapped at 0x100000000, so the fault
address is guest 0x701D0000 -- which is exactly r9 in the register dump.

Also refutes nothing of the port's, but answers its ask #3: the two press-a
captures are different frames (40.84 % of the band's pixels differ at the
best alignment, which has a sharp minimum), so its 0.301 % is not an
instrument floor.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Wuu56cE8vJGTBtn1ppsk8v
2026-08-30 06:44:49 +00:00

10 KiB
Raw Blame History

Pressing Ⓐ on the title faults the guest — SOLVED, and it is the emulator swallowing input

Classification: measured (the mechanism, from the run's own retained log) on a decoded code path (the three functions, read out of the image). Xenia Canary, 2026-08-29. This is the blocker that gated every menu-side dynamic question in this container, and it is not a mystery any more.

The one-line answer

Xenia's XamInputGetKeystrokeEx returns X_ERROR_SUCCESS with a zeroed keystroke, on every call, for as long as a XAM dialog is up. The game's keystroke pump is while (GetKeystrokeEx(...) == SUCCESS) queue.push_back(ks); with no bound. Something raised a XAM dialog immediately after the third Ⓐ was delivered, and the pump then queued 8 388 608 empty keystrokes, grew its vector to 64 MB, asked for 128 MB, got a failed allocation back unchecked, and copied off the end of the guest thread stack.

So the fault is a symptom two levels down from an emulator-side input blackout. Nothing is wrong with the disc, the title screen, or the Ⓐ button.

🔴 Retraction — "r9 is a wild pointer, above 4 GB, never a guest address"

That is this page's own claim, written 2026-08-29 at 72e45a7, and it is wrong.

Access Violation: write at 0x00000001701D0000 prints ex->fault_address(), which exception_handler_posix.cc:154 fills from signal_info->si_addr — a host address. Xenia maps the guest at mapping_base_, chosen in memory.cc:193 as the first 1ull << n from n=32 that maps, i.e. 0x100000000.

The register file proves the translation rather than assuming it: the faulting instruction is sth r6, 0(r9) and the dump shows

 r9   = 00000000701D0000      Access Violation: write at 0x00000001701D0000

0x1701D0000 0x100000000 = 0x701D0000 = r9. So r9 is a guest address, in the v40000000 heap (0x40000000 … 0x7EFFFFFF), and the page is simply not committed. The distinction matters: "garbage pointer" pointed the next probe at memory corruption; the truth points it at an allocation that failed.

⚠️ Generalise this. Every Access Violation: … at 0x1________ in a Canary log from this container is a guest address plus 0x100000000. Subtract before reading.

The code path, read out of the image (0 mismatches against sylpheed.db)

All three functions were disassembled from /image/sylpheed.pe and cross-checked word-for-word against the database: 466 + 120 instructions, zero disagreements across sub_82457038, sub_82457780 and their callees.

what it is how that is known
sub_824574C0 lazy singleton getter for the input manager at guest 0x828F3888, guarded by a bit-0 "constructed" flag at 0x828F3A70 lis r11,0x828F; addi r30,r11,14472 = 0x828F3888; classic guard-variable shape
sub_82457038 the keystroke pump: drains XamInputGetKeystrokeEx into a vector at this+68 = 0x828F38CC calls sub_824AA870, which is b 0x8284DBDC = the XamInputGetKeystrokeEx import thunk (imports, ordinal 408)
sub_82457780 that vector's insert-with-grow {ptr@+0, size@+4, capacity@+8}; doubles capacity, clamps at 0x1FFFFFFF, slwi r3,r27,3 for the byte count

The element is 8 bytes copied as four halfwords at offsets 0/2/4/6 — which is exactly X_INPUT_KEYSTROKE {u16 VirtualKey; u16 Unicode; u16 Flags; u8 UserIndex; u8 HidCode}. That is what makes the vector identifiable as a keystroke queue and not some other 8-byte record.

The pump, in C:

// sub_82457038, 0x82457174 … 0x824571C8
while (XamInputGetKeystrokeEx(&user, 3, &ks) == X_ERROR_SUCCESS) {
    if (v->size < v->capacity) v->data[v->size++] = ks;   // 0x8245718C
    else                       insert_slow(v, end, &ks);  // 0x824571B0 → sub_82457780
}

There is no iteration cap and no check on the allocator's return.

The emulator half — xam_input.cc:197

if (kernel_state()->xam_state()->IsUIActive()) {
    ...
    return X_ERROR_SUCCESS;      // keystroke was zeroed above
}

IsUIActive() is is_xam_dialog_present_, set to true by every non-headless XamShow*UI path in xam_ui.cc and cleared only by a dialog's close handler. While it is set, the guest's == SUCCESS loop can never terminate.

⚠️ This is upstream Canary behaviour, not one of this container's RE patches. The RE patch is only the [RE-INPUT] logging around it — and that logging is what made the diagnosis possible, so it earned its keep.

The number that closes it

The instrumentation reports one line per 600 swallowed calls. Immediately before the first crash dump:

[RE-INPUT] XamInputGetKeystrokeEx swallowed by IsUIActive (ui_active=true, 8388601 so far)

and the crash dump's own registers say how many records the vector held:

 r29 = 0000000000800000     = 8 388 608  elements to copy
 r26 = 0000000000800001     = new size
 r27 = 0000000001000000     = new capacity (doubled)
 r30 = FFFFFFFF828F38CC     = the vector object — the pump's queue
 r31 = 00000000A7AC0000     r7 = 00000000A3AC0000   → 0x04000000 = 64 MB of live data

8 388 601 swallowed calls against 8 388 608 queued records — a gap of 7, inside the 600-call reporting granularity. One push per swallowed poll. The two numbers are independent instruments (a Canary log counter and a guest register file) and they agree; that is the whole argument, and it needs no further run.

Why r3 looked like a stack pointer

slwi r3, r27, 3 = 0x8000000 = 128 MB requested from sub_824F7240 (b 0x82150000, the game's heap_alloc(*0x828E2B14, size, &out) wrapper). It came back as 0x701CF5F0below the pump thread's own r1 = 0x701CF7B0, i.e. a pointer into a stack frame that had already been popped. The copy then walked +0xA18 and hit the top of the thread's 64 KB stack at 0x701D0000.

So: the allocation failed, the failure path left a stale &local in r3, and the caller never checked. A 128 MB request on top of a live 64 MB one, in a guest with 512 MB total, is not a surprising failure.

The timeline, from the log

log line event
1149 first XamInputGetKeystrokeEx reaches a driver
11851252 three Ⓐ press/release pairs delivered — vk=5800, flags 0001 down / 0002 up
1253 the third Ⓐ up is handed to the guest
1254 swallowed by IsUIActive (ui_active=true, 1 so far) — the blackout starts
125415242 13 982 swallow reports = ~8.39 M swallowed calls
15243 first ==== CRASH DUMP ====, PC 0x824578A0

Evidence: ../data/a-press-fault-log-extract.txt.

⚠️ Note the feedback loop that produces 32 356 dumps rather than one: a guest crash makes Xenia call ImGuiDialog::ShowMessageBox (emulator.cc:1487), which is itself a UI — so the swallow can only get worse after the first fault.

🟡 What is still open: which dialog

is_xam_dialog_present_ is a single bool with no logging on the setting side, so the log says a XAM dialog exists and not which one. The static reach:

  • XamShowDeviceSelectorUIruled out. The run's own config dump carries storage_selection_dialog = false, and xam_ui.cc:550 takes the headless path in that case, which never sets the flag.
  • XamShowSigninUI and XamShowMessageBoxUIEx — both set it, both are imported, and both reach the guest. sub_821D03A0 calls the game's XamShowSigninUI and XamShowDeviceSelectorUI wrappers, which is the shape of a "sign in, then pick storage" flow — exactly what a title screen's Ⓐ would start.
  • XamShowKeyboardUI, XamShowDirtyDiscErrorUI — imported; not excluded, but neither fits the moment.

The experiment that settles it is one line of Canary, not another blind boot: log the function name at each is_xam_dialog_present_.store(true) site in xam_ui.cc. Recorded rather than done, because it is an emulator change and this iteration's budget went to the diagnosis.

What this unblocks, and how

The blocked list — main-menu sweeps, whether a .tbm draws pixels, pbafc.prm's blend — needs a screen behind an Ⓐ press. Three routes now exist where before there were none, in cost order:

  1. Dismiss the dialog. It is an ImGui window on the emulator surface; the run had a display. If it can be clicked or key-dismissed, the flag clears and the pump drains normally. Cheapest, and testable in one boot.
  2. --headless. Both xeXamShowSigninUI and XamShowMessageBoxUIEx take a dispatch-headless path that never sets the flag. ⚠️ It also removes the window the capture harness grabs, so this trades the fault for a different blocker.
  3. Patch the swallow. Returning X_ERROR_EMPTY instead of X_ERROR_SUCCESS at xam_input.cc:217 terminates the pump immediately and is closer to hardware (a real Xbox does not hand a game an infinite run of empty keystrokes). This is an emulator change and needs to be recorded as one wherever it is used.

⚠️ Whichever route is taken, keep tools/re-capture/frame_clock.sh's size guard. It killed this run at its 300 MB cap and worked exactly as designed; without it the next fault fills a filesystem that was already at 91 %.

It was never the same failure as the other two

PC crash dumps cause
cache-flush crash (../title-crash-stl-tree.md) 0x82307128 yes different
loader stall (../canary-scripted-input-traps.md) zero different
this 0x824578A0 32 356 emulator input blackout → unbounded guest queue

And it explains the thing the old page could not: why Q4 and Q5 pressed Ⓐ successfully and these runs did not. Nothing about the game differs. What differs is whether a XAM dialog happened to be up, which is emulator state, not guest state — so "it reproduced 4/4" and "it worked before" are both true and always were.

🔴 Also refuted: the earlier "unimplemented instruction" hypothesis

Kept from the previous version of this page because the negative still stands. break_on_unimplemented_instructions = true looked like a one-flag fix; booting with it false faults identically, and no Unimplemented instr line is ever logged. That path emits its XELOGE before the guarded break, so its absence rules the mechanism out. The dump comes from Emulator::ExceptionCallback, which fires on a genuine guest exception.