From 2e60a5f0eda729d1c4fee6d900962a70c290f8dd Mon Sep 17 00:00:00 2001 From: Dana Robinson Date: Fri, 27 Feb 2026 12:35:44 -0700 Subject: [PATCH 1/5] Update INSTALL dependencies --- INSTALL.md | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/INSTALL.md b/INSTALL.md index 0dd3d071..361dd8ac 100644 --- a/INSTALL.md +++ b/INSTALL.md @@ -81,7 +81,7 @@ If CMake can't find hipcc/nvcc, you can set `-DCMAKE_HIP_COMPILER=` Supported platforms: Linux (Windows may be supported in a future release) -Supported filesystems: Only ext4 is supported at this time +Supported filesystems: Only ext4 and xfs are supported at this time Targeting NVIDIA requires cuFile to be installed @@ -95,8 +95,12 @@ sudo systemctl reboot ### Prerequisites -> [!NOTE] -> hipFile relies on the unreleased [ROCm 7.2](https://github.com/ROCm/TheRock) libraries and associated [amdgpu](https://github.com/ROCm/amdgpu) drivers. We will update the install instructions when these are released. +* CMake >= 3.21 +* C++ >= 17 (tested w/ clang++ & g++, we don't use GNU extensions) +* ROCm >= 7.2 +* amdgpu >= 30.10.1 +* Boost +* libmount ### Configure From 4f7c63defe8931b7c4d145a96747d55f19fa0324 Mon Sep 17 00:00:00 2001 From: Dana Robinson Date: Mon, 16 Mar 2026 11:50:50 -0600 Subject: [PATCH 2/5] Update INSTALL.md --- INSTALL.md | 15 ++++++++++++--- 1 file changed, 12 insertions(+), 3 deletions(-) diff --git a/INSTALL.md b/INSTALL.md index 361dd8ac..9b95a793 100644 --- a/INSTALL.md +++ b/INSTALL.md @@ -95,12 +95,21 @@ sudo systemctl reboot ### Prerequisites +#### Build Tools * CMake >= 3.21 * C++ >= 17 (tested w/ clang++ & g++, we don't use GNU extensions) +* The `ais-check` script requires Python 3.x + +#### AMD Components * ROCm >= 7.2 -* amdgpu >= 30.10.1 -* Boost -* libmount + * `rocm-developer-tools` + * `rocm-hip-runtime-dev(el)` + * `rocm-hip-sdk` +* amdgpu-dkms >= 30.20.1 + +#### Other Developer Packages +* Boost.Program\_options (libboost-program-options-dev or similar) +* libmount (usually libmount-dev or libmount-devel) ### Configure From 073a7b9fb0c874ce7dfc03998e77ab11489cc76d Mon Sep 17 00:00:00 2001 From: Dana Robinson Date: Mon, 16 Mar 2026 11:58:50 -0600 Subject: [PATCH 3/5] Added additional file system and kernel notes --- INSTALL.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/INSTALL.md b/INSTALL.md index 9b95a793..25af2e1b 100644 --- a/INSTALL.md +++ b/INSTALL.md @@ -81,10 +81,12 @@ If CMake can't find hipcc/nvcc, you can set `-DCMAKE_HIP_COMPILER=` Supported platforms: Linux (Windows may be supported in a future release) -Supported filesystems: Only ext4 and xfs are supported at this time +Supported filesystems: Only ext4 and xfs are supported at this time. ext4 only supports `data=ordered` mode. Targeting NVIDIA requires cuFile to be installed +The kernel must have `CONFIG_PCI_P2PDMA` enabled + Multipath NVMe devices are not supported at this time. If you are using a multipath-supporting device, you may need to disable multipath in the nvme\_core kernel driver. On Ubuntu 24.04, this can be done by running the following: ``` From 5a35b468d7011a37e81c97e26f94d12782240009 Mon Sep 17 00:00:00 2001 From: Dana Robinson Date: Mon, 16 Mar 2026 15:49:02 -0600 Subject: [PATCH 4/5] Clean up packages --- INSTALL.md | 15 +++++++++------ 1 file changed, 9 insertions(+), 6 deletions(-) diff --git a/INSTALL.md b/INSTALL.md index 25af2e1b..d9269411 100644 --- a/INSTALL.md +++ b/INSTALL.md @@ -104,14 +104,17 @@ sudo systemctl reboot #### AMD Components * ROCm >= 7.2 - * `rocm-developer-tools` - * `rocm-hip-runtime-dev(el)` - * `rocm-hip-sdk` + * `hip-dev` (Debian/Ubuntu) + * `hip-devel` (RHEL/Fedora/openSUSE) * amdgpu-dkms >= 30.20.1 -#### Other Developer Packages -* Boost.Program\_options (libboost-program-options-dev or similar) -* libmount (usually libmount-dev or libmount-devel) +#### Other Packages +* Boost.Program\_options + * `libboost-program-options-dev` (Debian/Ubuntu) + * `libboost-program-options-devel` (RHEL/Fedora/openSUSE) +* libmount + * `libmount-dev` (Debian/Ubuntu) + * `libmount-devel` (RHEL/Fedora/openSUSE) ### Configure From 1e3f26c3a72226af0e37286d5b110171c4a19b27 Mon Sep 17 00:00:00 2001 From: Dana Robinson Date: Mon, 16 Mar 2026 16:08:17 -0600 Subject: [PATCH 5/5] Update note about file systems --- INSTALL.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/INSTALL.md b/INSTALL.md index d9269411..b2e9cc97 100644 --- a/INSTALL.md +++ b/INSTALL.md @@ -81,7 +81,7 @@ If CMake can't find hipcc/nvcc, you can set `-DCMAKE_HIP_COMPILER=` Supported platforms: Linux (Windows may be supported in a future release) -Supported filesystems: Only ext4 and xfs are supported at this time. ext4 only supports `data=ordered` mode. +Supported filesystems: Only ext4 and xfs are supported at this time. ext4 must be mounted with the default data=ordered mount option. Targeting NVIDIA requires cuFile to be installed