海光DCU-DTK 23.04.1 hipgdb使用手册.pdf

### 海光DCU-DTK 23.04.1 hipgdb使用手册解析 #### 1. 简介 ##### 1.1 hipgdb hipgdb 是一款针对海光数据中心处理器（DCU）开发的高性能调试工具，主要用于支持基于 HIP (Heterogeneous-Compute Interface for Portability) API 的程序调试。该工具为开发者提供了丰富的调试功能，旨在帮助用户高效地定位和解决GPU计算中的问题。 ##### 1.2 配置安装 为了确保hipgdb能够正常运行，开发者需要按照以下步骤进行配置和安装： 1. **系统环境准备**：首先确认目标机器上已安装了必要的基础软件包，如GCC、GDB等。 2. **HIP环境搭建**：安装HIP工具链，包括HIP runtime库和编译器等。 3. **hipgdb下载与编译**：从官方源码仓库下载hipgdb源代码，并根据文档完成编译过程。 4. **环境变量设置**：将hipgdb可执行文件路径添加到系统PATH变量中，以便在任何目录下都能调用此工具。 ##### 1.3 调试Kernel的基本步骤 使用hipgdb进行Kernel调试的一般流程如下： 1. **启动hipgdb**：通过命令行启动hipgdb，可以指定待调试的程序。 2. **设置断点**：在感兴趣的核函数或代码行设置断点。 3. **运行程序**：启动程序执行，在遇到断点时自动暂停。 4. **分析状态**：查看当前程序的状态，包括寄存器值、内存数据等。 5. **单步执行**：逐行执行代码，观察程序行为变化。 6. **调试完成**：解决所有问题后，退出hipgdb结束调试。 #### 2. hipgdb核函数调试功能 ##### 2.1 核函数断点添加的方式 ###### 2.1.1 添加函数名断点 开发者可以通过提供核函数的名称来设置断点，例如： ``` break kernelName ``` 这种设置方式简单直接，适用于明确知道需要调试哪个核函数的情况。 ###### 2.1.2 添加行号断点 如果需要在特定行设置断点，则可以使用行号断点，格式如下： ``` break kernelName + 行号 ``` 这种方式特别适合于核函数内部具体逻辑的调试。 ###### 2.1.3 添加模糊匹配断点 当开发者不确定具体函数名但知道部分关键字时，可以使用模糊匹配断点。命令格式为： ``` break *kernelName* ``` 此方法提高了灵活性，尤其是在处理大型项目时非常有用。 ##### 2.2 核函数调试要点 ###### 2.2.1 使用 tbreak `tbreak` 命令用于设置一次性断点，即程序在此断点处暂停后，该断点会自动删除，不会再次触发。这对于需要调试初始化阶段或某些仅需执行一次的代码块非常有用。 示例： ``` tbreak kernelName ``` ###### 2.2.2 手动删除断点 有时候，开发者可能需要手动删除不再需要的断点，可以通过以下命令实现： ``` clear [断点编号] ``` 其中，断点编号是设置断点时系统自动生成的编号。 ###### 2.2.3 设置条件断点 条件断点允许开发者指定触发断点的条件，只有当满足这些条件时才会暂停程序。这对于调试复杂的条件分支特别有用。 ``` break [条件] kernelName ``` 例如，可以设置一个只在某个变量等于特定值时才触发的断点： ``` break if (var == 10) kernelName ``` ###### 2.2.4 设置 scheduler-locking 在多线程环境中，为了保证程序状态的一致性，可以使用 `scheduler-locking` 命令来锁定调度器。这有助于避免在调试过程中由于其他线程的干扰而导致的问题。 命令示例： ``` set scheduler-locking on ``` #### 3. hipgdb环境信息打印功能 ##### 3.1 预定义变量 hipgdb提供了多个预定义变量，用于访问当前调试环境的信息。例如： - `$hipDeviceId`：表示当前设备ID。 - `$hipStreamId`：表示当前流ID。 这些变量可以帮助开发者更好地理解程序执行的上下文。 ##### 3.2 环境信息相关命令 ###### 3.2.1 查看配置信息 使用 `info` 命令可以查看当前调试环境的详细配置信息，包括但不限于版本信息、支持的功能等。 ``` info ``` 此外，还可以使用更具体的子命令来获取特定方面的信息，如： ``` info breakpoints ``` 用于列出所有设置的断点信息。 以上内容详细介绍了海光DCU-DTK 23.04.1版本中hipgdb的基本使用方法，包括安装配置、核函数调试功能及环境信息打印等方面。通过掌握这些知识点，开发者可以更加高效地利用hipgdb进行GPU程序的开发与调试工作。