ROCm项目中roc-obj-ls工具在6.4版本中的使用问题分析

在ROCm 6.4版本中，开发者在使用rocm/dev-ubuntu-24.04:6.4容器镜像时，可能会遇到roc-obj-ls工具无法正常工作的问题。这个问题主要表现为工具运行时提示缺少Perl模块File::Which和URI。

问题现象

当开发者尝试使用roc-obj-ls工具分析编译生成的HIP代码对象时，会收到类似以下的错误信息：

Can't locate File/Which.pm in @INC (you may need to install the File::Which module)...
BEGIN failed--compilation aborted at /usr/bin/roc-obj-ls line 25.

这个错误表明系统缺少必要的Perl模块依赖，导致工具无法正常执行。

问题根源

经过分析，这个问题源于ROCm 6.4版本中的包依赖关系变更。在之前的版本中，hip-base包会自动安装libfile-which-perl和liburi-perl这两个Perl模块作为依赖。但在6.4版本中，这些依赖关系被移除了，而Docker镜像构建时又使用了--no-install-recommends参数，导致这些必要的Perl模块没有被自动安装。

解决方案

对于这个问题，开发者有以下两种解决方案：

1. 安装缺失的Perl模块
   可以通过手动安装libfile-which-perl和liburi-perl包来解决依赖问题：

   apt-get install libfile-which-perl liburi-perl
   

   安装完成后，roc-obj-ls工具即可正常使用。

2. 迁移到新的工具链
   ROCm 6.4版本已经将roc-obj系列工具标记为弃用(deprecated)，并推荐使用llvm-objdump工具作为替代。开发者可以使用以下命令来提取代码对象：

   llvm-objdump --offloading --arch-name=gfx906 saxpy.o
   

工具链迁移注意事项

虽然llvm-objdump是未来的发展方向，但目前版本(6.4)的功能还比较有限：

• 可以提取代码对象内容
• 但尚不具备列出所有代码对象的功能（类似roc-obj-ls的功能）

根据ROCm开发团队的说明，完整的代码对象列表功能将在未来的版本中加入llvm-objdump工具中。

建议

对于现有项目：

• 如果需要立即使用代码对象分析功能，建议采用第一种方案，安装缺失的Perl模块继续使用roc-obj-ls
• 如果是新项目或可以接受功能限制，可以开始迁移到llvm-objdump工具链

长期来看，随着ROCm工具链的演进，llvm-objdump将成为标准的代码对象分析工具，开发者应做好相应的技术迁移准备。