Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.thru.org/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

The Thru VM supports debugging via the GDB remote server protocol. Clients such as GDB and LLDB which support RISC-V can connect to a running VM instance, and can inspect and alter execution.

​
Remote Server Protocol

The GDB remote server protocol specifies how clients, such as GDB, interact with a running remote, which in this case is the Thru VM. When the VM is run in debug mode, it accepts a connection over TCP, by default on port 9001. Using target remote localhost:9001, GDB can connect to the VM and start debugging. Several important commands are supported, including:
  • g/G: Read and write registers
  • m/M: Read and write memory
  • z/Z: Set and clear breakpoints and watchpoints