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 上的支援。