ROCm/HIPIFY

什么是 HIPIFY？

HIPIFY 是一组工具的集合，可自动将 CUDA C++ 源代码转换为 HIP（可移植性异构计算接口）C++。通过将 CUDA 代码转换为 HIP，开发者可以更轻松地在 AMD GPU 和 NVIDIA GPU 上运行其 GPU 加速应用程序。

主要功能

• CUDA 到 HIP 的转换 – 主要工具 hipify-clang 会解析 CUDA 源文件并生成等效的 HIP 代码。
• 文档生成 – hipify-clang 还可以生成 Markdown 或 CSV 格式的文档，列出 HIP 支持的 CUDA API，支持不同输出格式（full、strict、compact）。
• 命令行选项 – 使用 --help 或 --help-hidden 列出所有标志；常用标志包括 --md 用于 Markdown 输出，--doc-format/--doc-roc 用于控制生成文档的样式。

如何本地构建文档

cd docs
pip3 install -r .sphinx/requirements.txt
python3 -m sphinx -T -E -b html -d _build/doctrees -D language=en . _build/html

这将生成可浏览的 HIPIFY 文档 HTML 版本。

生成 CUDA 到 HIP 的 API 参考

# 完整文档（单个合并文件）
hipify-clang --md --doc-format=full --doc-roc=joint

# 或按 API 组分别生成文件
hipify-clang --md --doc-format=full --doc-roc=separate

将 --md 替换为 --csv 可获得 CSV 输出，您还可以将 --doc-format 切换为 strict 或 compact 以获得更简洁的列表。

如何获取更多信息

• 官方在线文档：https://rocm.docs.amd.com/projects/HIPIFY/en/latest/index.html
• 文档源代码位于仓库的 HIPIFY/docs 目录中。
• ROCm 文档的贡献指南可在在线文档中找到链接。

---

核心要点： HIPIFY 帮助开发者将基于 CUDA 的 GPU 代码移植到可移植的 HIP 框架，从而简化 AI、机器学习及其他高性能计算工作负载在不同厂商 GPU 间的支持。