Files
reverse-engineering-anything/docs/specs/native/gdb-executable/plan.md
T
Ysopwnableandgensokyo-dev 230db70fb4 feat(gdb): bind sessions to an optional executable
Hash and load an optional initial executable before GDB readiness, without running it. Preserve initial identity and completed hash diagnostics through cancellation and cleanup retry; share the file owner with Rizin.

Fixes #11581. Refs #11682.

Co-authored-by: gensokyo-dev <342580529+gensokyo-dev@users.noreply.github.com>
2026-11-16 16:19:33 +08:00

1.3 KiB

Implementation plan

The contract owns the optional input. MCP bindings and the one-shot CLI forward it to GdbSessionManager; the manager owns path admission, file observation, protocol startup and publication.

Extract Rizin's existing stable launch-file observation into one shared debugger helper. Each manager retains failed file handles in its existing resource scope or an equivalent startup scope drained by shutdown and cleanup retry. Preserve Rizin's current outcome policy and caller-path semantics. Completed hash facts also survive cancellation or failed final descriptor close in both managers; startup still fails, retaining the exact failed cleanup owner.

Observe the file once per admitted GDB start, before dialect negotiation. Pass the same observation into each protocol attempt. The adapter quotes the load path using its MI string owner and requires a complete successful reply. A refused file load is a semantic startup failure, not a reason to repeat it with another MI dialect.

One GDB Evidence producer attaches the session's immutable initial selection and its provenance to ordinary and partial observations. Native and simulated tests exercise the public adapters and the startup lifecycle boundaries. Update the owning CLI/Evidence documentation and regenerate ignored catalogs as required.