GDB helper functions for debugging tlib

tlib_helper is a collection of helper functions that give the user a better context of the whole Renode simulation while debugging the translated guest code execution in tlib.

Features

Create breakpoint on next guest instruction,
Disassemble current instruction,
Disassemble current Translation Block,
Read bytes from the system bus,
Support for multiple CPUs through the $_cpu(index) convenience function,
Access to current guest PC through the $guest_pc variable.

Usage

All functionality is self-contained in the single gdbscript.py, therefore it is enough to just source the script in GDB using the source command. For example, to attach GDB to already running dotnet-built Renode instance the following command can be used:

$ gdb -ex 'source tools/tlib_helper/gdbscript.py' \
      -ex 'handle SIG34 nostop noprint' \
      -p $(pgrep --full 'dotnet.*Renode.dll')"

Additional information about commands can be accessed through help renode GDB command.