04 - 运行 rocrtst 第一个测试

本文档帮助你成功运行 rocrtst 的第一个测试并掌握各种运行方式。1. 运行前检查清单在运行测试之前确认以下条件# ✅ 1. rocrtst64 已构建并安装ls$ROCM_PREFIX/bin/rocrtst64# ✅ 2. GPU kernel 已编译检查你的 GPU 型号目录ls$ROCM_PREFIX/share/rocrtst/gfx942/# 替换为你的 GPU 型号# ✅ 3. HSA 运行时库可找到ls$ROCM_PREFIX/lib/libhsa-runtime64.so# ✅ 4. GPU 设备正常rocminfo|grepName:|head-3# ✅ 5. 设置库路径exportLD_LIBRARY_PATH$ROCM_PREFIX/lib:$LD_LIBRARY_PATH2. 运行第一个测试2.1 从安装目录运行推荐推荐从对应 GPU 的 ASIC 目录运行这样 rocrtst 能自动找到.hsacokernel 文件cd$ROCM_PREFIX/share/rocrtst/gfx942# 替换为你的 GPU 型号# 运行一个简单的测试sudo$ROCM_PREFIX/bin/rocrtst64--gtest_filterrocrtst.Test_Example2.2 从 build 目录运行构建后也可直接从 build 目录运行cdrocrtst/suites/test_common/build/gfx942# 替换为你的 GPU 型号sudo../rocrtst64--gtest_filterrocrtst.Test_Example2.3 预期输出成功运行后输出类似 ROC Runtime Test Suite Platform detected: Bare Metal Configuration: /opt/rocm-7.3.0/share/rocrtst/platform_config.yaml [] Running 1 test from 1 test suite. [----------] Global test environment set-up. [----------] 1 test from rocrtst [ RUN ] rocrtst.Test_Example ***** Test_Example ***** Setup: HSA Runtime Initialization ... Agent and Queue Info: Agent: gfx942 Queue Size: 131072 ... Kernel File: test_case_template_kernels.hsaco Running ... Closing ... [ OK ] rocrtst.Test_Example (XXX ms) [----------] 1 test from rocrtst (XXX ms total) [] 1 test from 1 test suite ran. (XXX ms total) [ PASSED ] 1 test.3. 测试套件与测试用例命名rocrtst 中的测试按测试套件.测试用例格式命名测试套件含义示例rocrtst通用/模板测试rocrtst.Test_ExamplerocrtstFunc功能测试rocrtstFunc.MemoryAccessTestsrocrtstPerf性能测试rocrtstPerf.Memory_Async_CopyrocrtstNeg负面测试rocrtstNeg.Memory_Allocation_Negative_TestsrocrtstStress压力测试rocrtstStress.Memory_Concurrent_Allocate_Test4. 列出所有测试sudo$ROCM_PREFIX/bin/rocrtst64--gtest_list_tests输出格式rocrtst. Test_Example Test_Example_InterruptDisabled Test_MetadataPrefetchPacket rocrtstFunc. MemoryAccessTests MemoryAccessCoherent GroupMemoryAllocationTest MemoryAllocateAndFreeTest SvmMemoryBasic VirtualMemoryManagement ... rocrtstPerf. Memory_Async_Copy AQL_Dispatch_Time_Single_SpinWait ... rocrtstNeg. Memory_Allocation_Negative_Tests ... rocrtstStress. Memory_Concurrent_Allocate_Test ...5. 筛选运行测试使用--gtest_filter按模式筛选支持通配符*和-排除5.1 运行单个测试sudorocrtst64--gtest_filterrocrtstFunc.SvmMemoryBasic5.2 运行整个套件# 运行所有功能测试sudorocrtst64--gtest_filterrocrtstFunc.*# 运行所有性能测试sudorocrtst64--gtest_filterrocrtstPerf.*# 运行所有压力测试sudorocrtst64--gtest_filterrocrtstStress.*5.3 按关键字筛选# 运行所有包含 Memory 的测试sudorocrtst64--gtest_filter*Memory*# 运行所有 SVM 相关测试sudorocrtst64--gtest_filter*Svm*# 运行所有 Queue 相关测试sudorocrtst64--gtest_filter*Queue*5.4 排除特定测试# 运行所有功能测试但排除 IPCsudorocrtst64--gtest_filterrocrtstFunc.*:-*IPC*# 运行所有测试排除性能测试和压力测试sudorocrtst64--gtest_filter*:-rocrtstPerf.*:rocrtstStress.*5.5 组合多个模式# 运行内存相关的功能测试和信号测试sudorocrtst64--gtest_filterrocrtstFunc.*Memory*:rocrtstFunc.*Signal*6. rocrtst 专用参数除了 gtest 标准参数外rocrtst 提供了额外的命令行参数6.1 参数一览参数简写说明默认值--iterations N-i每个测试的迭代次数5--verbosity N-v输出详细程度1--monitor_verbosity N-mGPU 监控信息级别0--rocrtst_help-r显示 rocrtst 帮助—6.2 verbosity 详细级别级别说明适用场景0最简输出仅显示摘要CI/CD 自动化1标准输出显示中间数据日常测试默认2显示进度信息长时间运行的测试≥3调试输出排查问题6.3 monitor_verbosity GPU 监控级别说明0不读取/显示任何 GPU 监控信息默认1在第一个测试前和每个测试后打印所有可用的 GPU 监控信息≥2打印更多详细的监控信息测试特定⚠️ 使用-m 1或更高级别需要系统安装amd_smi库。6.4 使用示例# 运行 SVM 测试10 次迭代进度显示sudorocrtst64--gtest_filter*Svm*-i10-v2# 运行性能测试附带 GPU 监控数据sudorocrtst64--gtest_filterrocrtstPerf.*-m1# 运行全部测试最简输出sudorocrtst64-v0# 查看 rocrtst 专用帮助sudorocrtst64-r7. gtest 常用参数参数说明示例--gtest_list_tests列出所有测试不运行--gtest_filterPATTERN按模式筛选测试*Memory*--gtest_repeatN重复运行 N 次--gtest_repeat3--gtest_shuffle随机化测试顺序--gtest_outputxml:FILE输出 XML 格式报告--gtest_outputxml:result.xml--gtest_break_on_failure测试失败时触发断点配合 GDB 使用--gtest_also_run_disabled_tests运行被 DISABLED_ 前缀禁用的测试8. 测试结果解读8.1 通过[ OK ] rocrtstFunc.SvmMemoryBasic (1234 ms) [ PASSED ] 1 test.8.2 失败[ FAILED ] rocrtstFunc.SvmMemoryBasic (5678 ms) [ FAILED ] 1 test, listed below: [ FAILED ] rocrtstFunc.SvmMemoryBasic失败时查看详细错误信息通常包含 HSA 状态码和错误位置。8.3 跳过部分测试会因平台不支持而跳过如该 GPU 不支持 SVM输出中 SetUp 阶段会提示 skip[ RUN ] rocrtstFunc.SvmMemoryBasic Test skipped: platform filtering (not supported on this GPU) [ OK ] rocrtstFunc.SvmMemoryBasic (10 ms)8.4 DISABLED 测试以DISABLED_前缀命名的测试默认不运行。如需运行sudorocrtst64--gtest_also_run_disabled_tests--gtest_filter*DISABLED*9. 生成测试报告# 生成 XML 格式报告可被 Jenkins/CI 解析sudorocrtst64--gtest_outputxml:rocrtst_report.xml# 生成 JSON 格式报告sudorocrtst64--gtest_outputjson:rocrtst_report.json10. 常见运行问题Q: 提示 “Permission denied” 或 “HSA_STATUS_ERROR”A:大多数测试需要 root 权限sudorocrtst64...Q: 提示找不到 kernel 文件 (.hsaco)A:确保从对应 GPU 的目录运行cd$ROCM_PREFIX/share/rocrtst/gfx942# 你的 GPU 型号sudo$ROCM_PREFIX/bin/rocrtst64...Q: 提示 “libhsa-runtime64.so: cannot open shared object file”A:设置库搜索路径exportLD_LIBRARY_PATH$ROCM_PREFIX/lib:$LD_LIBRARY_PATHQ: 测试长时间卡住不动A:可能是 GPU hang。按CtrlC终止检查dmesg中是否有 GPU 错误sudodmesg|grep-iamdgpu\|gpu\|hang|tail-20上一篇03-构建指南下一篇05-功能测试详解 — 深入了解各功能测试模块