ROCgdb documentation#
The AMD ROCm Debugger (ROCgdb) is the AMD source-level debugger for Linux, based on the GNU Debugger (GDB). ROCgdb enables heterogeneous debugging on the ROCm software that consists of an x86-based host architecture along with commercially available AMD GPU architectures supported by the AMD Debugger API Library (ROCdbgapi). ROCdbgapi is included with ROCm.
ROCgdb provides the following features:
Debugs ROCm applications running on actual hardware
Debugs applications without the potential variations introduced by simulation and emulation environments
Offers a seamless debugging environment that allows simultaneous GPU and CPU code debugging within the same application, just like programming in HIP, which is a seamless extension of C++ programming
Additional features to support debugging ROCm device code on top of the existing GDB debugging features, which are inherently present for debugging the host code
Supports HIP kernel debugging
Allows you to set breakpoints, single-step ROCm applications, and inspect and modify the memory and variables of any given thread running on the hardware
The code is open source and hosted at: ROCm/ROCgdb
To contribute to the documentation, refer to Contributing to ROCm.
You can find licensing information on the Licensing page.