Skip to content

Add a gdb stub and an arm jit so that we can debug clvm in gdb.#431

Draft
prozacchiwawa wants to merge 136 commits intomainfrom
20260408-gdb-debug
Draft

Add a gdb stub and an arm jit so that we can debug clvm in gdb.#431
prozacchiwawa wants to merge 136 commits intomainfrom
20260408-gdb-debug

Conversation

@prozacchiwawa
Copy link
Copy Markdown
Contributor

@prozacchiwawa prozacchiwawa commented Apr 9, 2026

Note

High Risk
Introduces a large new ARM JIT/ELF/DWARF generation and GDB remote-stub execution path, plus new external deps and CI requirements; bugs here could affect correctness of debug output and test stability.

Overview
Adds a new ARM-based JIT debugging pipeline that can compile CLVM/Chialisp into an ARM ELF with DWARF line info, execute it in an embedded ARMv4T emulator, and expose execution via a gdbstub remote server (new compiler::debug::armjit module).

Introduces a new armtx CLI for generating the ELF and launching the emulator/stub, plus GDB helper scripts/tests and CI updates to install gdb-multiarch so the new debug smoke tests run in GitHub Actions.

Updates core compiler plumbing to support this path (exports apply_op for emulator-side operator execution) and adds several new dependencies (gimli, faerie, elf_rs, armv4t_emu, gdbstub, subprocess, etc.), with corresponding lockfile changes.

Reviewed by Cursor Bugbot for commit 1232a68. Bugbot is set up for automated code reviews on this repo. Configure here.

…mething akin to a program with instructions annotated by dwarf.
…issing an element to enable gdb to do this mapping.
…e reach the first SWI instruction. We need to emulate those
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants