diff options
Diffstat (limited to 'docs/05-operations/03-risc-v-gsp-rm-vm.md')
| -rw-r--r-- | docs/05-operations/03-risc-v-gsp-rm-vm.md | 29 |
1 files changed, 21 insertions, 8 deletions
diff --git a/docs/05-operations/03-risc-v-gsp-rm-vm.md b/docs/05-operations/03-risc-v-gsp-rm-vm.md index 8d3cf7c..c21124b 100644 --- a/docs/05-operations/03-risc-v-gsp-rm-vm.md +++ b/docs/05-operations/03-risc-v-gsp-rm-vm.md @@ -18,7 +18,14 @@ its runtime behaviour inspectable with Frida-like primitives: * memory read/write/hexdump/search, structure decoding, snapshot diffing, * recorded sessions: a replayable event stream plus memory dumps (`events.jsonl`, snapshots, `summary.md`), -* declarative probe specs, a plugin API and a Ghidra symbol/hit bridge. +* Frida-like remote calls (`Session.call`) and run-to-cursor + (`Session.run_until`), +* **code injection**: build a position-independent RV64 service with the + `sdk/`, load it into the running firmware and register it so the firmware + dispatches to it (`greeneye inject`), +* declarative probe specs, a plugin API, a Ghidra symbol/hit bridge and a + **Ghidra control bridge** (`greeneye ghidra` + `GreenEyeControl.java`) for + "execute until here" from the decompiler. Its stated purpose is **simulating and inspecting the GSP firmware's runtime memory for `gsp-rm-vfio` accuracy measurements**: capture how the firmware @@ -66,24 +73,30 @@ From the repository root: ```bash cd debug/risc-v-gsp-rm-vm ./greeneye.sh info # environment check (QEMU, toolchain) -make demo # build the bundled RV64 uproc demo +make demo sdk # build the demo uproc and the injection SDK ./greeneye.sh demo # canned instrumentation pass; records a session ./greeneye.sh analyze dumps/<session> ./greeneye.sh probe # real GSP image: report the first divergence +./greeneye.sh inject # load and invoke an injected service +./greeneye.sh ghidra # serve the session to GhidraScripts ``` Requirements: `qemu-system-riscv64` (Ubuntu `qemu-system-misc`), Python 3.10+ -(stdlib only), `clang` + `lld` for the demo firmware. The tool touches no GPU, -no mdev, no kernel module and no host driver. +(stdlib only), `clang` + `lld` for the demo firmware and the SDK. The tool +touches no GPU, no mdev, no kernel module and no host driver. ## 5. Status and limits (v0.1) Working and live-verified: QEMU boot and gdbstub transport without GDB, hooks/breakpoints/watchpoints, memory tools, structure decoding, session -recording and analysis, declarative probes, plugins, the Ghidra bridge, and -the real-firmware first-fault probe. The TCG full-memory trace plugin builds -and records. Not implemented: device model (R1), custom simulator (R2), MCP -plugin (R3) — all roadmap. +recording and analysis, declarative probes, plugins, remote calls and +run-to-cursor, the injection SDK with direct and firmware-dispatched service +invocation, the Ghidra symbol/hit bridge and Ghidra control bridge, the +real-firmware first-fault probe, and the TCG full-memory trace plugin. Not +implemented: device model (R1), custom simulator (R2), MCP plugin (R3) — all +roadmap. The long-term program (adversarial navigation, adjacent +microcontrollers, custom simulator, Verilog soft-core, agentic platform) is +documented in `debug/risc-v-gsp-rm-vm/GREEN-EYE-ROADMAP.md`. ## 6. When the development flag can be removed |