From 1c99bfbeffff04529f6f669601fdf835a73778da Mon Sep 17 00:00:00 2001 From: Arthur Hanson Rasmusson Date: Fri, 2 Oct 2026 11:44:31 -0400 Subject: rename (cosmetic): green-eye -> risc-v-gsp-rm-debugger in user-facing names, docs, CLI, launcher and CI workflow; internal greeneye package/module identifiers unchanged (includes in-flight greeneye module edits present in the tree) --- debug/risc-v-gsp-rm-vm/docs/13-GHIDRA-CONTROL.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) (limited to 'debug/risc-v-gsp-rm-vm/docs/13-GHIDRA-CONTROL.md') diff --git a/debug/risc-v-gsp-rm-vm/docs/13-GHIDRA-CONTROL.md b/debug/risc-v-gsp-rm-vm/docs/13-GHIDRA-CONTROL.md index 26e534d..4d45160 100644 --- a/debug/risc-v-gsp-rm-vm/docs/13-GHIDRA-CONTROL.md +++ b/debug/risc-v-gsp-rm-vm/docs/13-GHIDRA-CONTROL.md @@ -2,7 +2,7 @@ > **# TOOL IN DEVELOPMENT - NOT READY YET!** See 00 for status. -The bridge lets a GhidraScript drive a live green-eye session: execute the +The bridge lets a GhidraScript drive a live risc-v-gsp-rm-debugger session: execute the target until a point **chosen in the decompiler**, set/clear breakpoints, read memory and registers, make remote calls, and export hit lists back into the Ghidra project. Nothing about the firmware has to be rebuilt or re-hosted to @@ -18,7 +18,7 @@ Ghidra (Java script) ── JSON lines over localhost ──► greeneye gdbridg ```bash # Terminal 1: a live target + bridge (records by default) -./greeneye.sh ghidra --kernel firmware/uproc_demo/build/uproc_demo.elf --bridge-port 7000 +./risc-v-gsp-rm-debugger.sh ghidra --kernel firmware/uproc_demo/build/uproc_demo.elf --bridge-port 7000 # prints: ghidra bridge on 127.0.0.1:7000 # Terminal 2: Ghidra headless, run until the decompiler's address @@ -120,7 +120,7 @@ the decompiler (unit-test style), then inspect memory with ## 5. Address conventions Ghidra shows **program addresses** (e.g. libcuda file vaddr + image base). -green-eye resolves **runtime addresses**. For firmware linked at its load +risc-v-gsp-rm-debugger resolves **runtime addresses**. For firmware linked at its load address these coincide; otherwise export symbols with the right bias (docs/05-GHIDRA-BRIDGE.md) and prefer `resolve(name)` over hardcoded numbers. @@ -140,7 +140,7 @@ address these coincide; otherwise export symbols with the right bias | Symptom | Cause / fix | |---|---| | `Connection refused` | bridge not started, wrong port, or it exited (`close`) | -| `green-eye bridge closed the connection` | the server was stopped or the target session closed | +| `risc-v-gsp-rm-debugger bridge closed the connection` | the server was stopped or the target session closed | | timeout on `run_until` | address not executed; check symbol bias and that the target is not wedged | | empty `hits` | the session was started without recording; use the CLI (records by default) | | Java compile error on script load | Ghidra API drift; the script targets Ghidra 11/12 `GhidraScript` | -- cgit v1.2.3