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.