diff --git a/docs/hipify-clang.md b/docs/hipify-clang.md index 2eaa857e..09078abc 100644 --- a/docs/hipify-clang.md +++ b/docs/hipify-clang.md @@ -21,7 +21,7 @@ After applying all the matchers, the output HIP source is produced. `hipify-clang` requires: -1. [**LLVM+CLANG**](http://releases.llvm.org) of at least version [4.0.0](http://releases.llvm.org/download.html#4.0.0); the latest stable and recommended release: [**17.0.5**](https://github.com/llvm/llvm-project/releases/tag/llvmorg-17.0.5). +1. [**LLVM+CLANG**](http://releases.llvm.org) of at least version [4.0.0](http://releases.llvm.org/download.html#4.0.0); the latest stable and recommended release: [**17.0.6**](https://github.com/llvm/llvm-project/releases/tag/llvmorg-17.0.6). 2. [**CUDA**](https://developer.nvidia.com/cuda-downloads) of at least version [8.0](https://developer.nvidia.com/cuda-80-ga2-download-archive), the latest supported version is [**12.2.2**](https://developer.nvidia.com/cuda-downloads). @@ -177,8 +177,9 @@ After applying all the matchers, the output HIP source is produced. 17.0.1, 17.0.2, 17.0.3,
- 17.0.4 - 17.0.5 + 17.0.4, + 17.0.5, + 17.0.6 12.2.2 LATEST STABLE CONFIG @@ -200,7 +201,7 @@ After applying all the matchers, the output HIP source is produced. In most cases, you can get a suitable version of `LLVM+CLANG` with your package manager. Failing that or having multiple versions of `LLVM`, you can [download a release archive](http://releases.llvm.org/), build or install it, and set -[CMAKE_PREFIX_PATH](https://cmake.org/cmake/help/v3.5/variable/CMAKE_PREFIX_PATH.html) so `cmake` can find it; for instance: `-DCMAKE_PREFIX_PATH=D:\LLVM\17.0.5\dist` +[CMAKE_PREFIX_PATH](https://cmake.org/cmake/help/v3.5/variable/CMAKE_PREFIX_PATH.html) so `cmake` can find it; for instance: `-DCMAKE_PREFIX_PATH=D:\LLVM\17.0.6\dist` ### hipify-clang: usage @@ -300,7 +301,7 @@ Run `Visual Studio 16 2019`, open the generated `LLVM.sln`, build all, and build **LLVM >= 10.0.0:** -1. download [`LLVM project`](https://github.com/llvm/llvm-project/releases/tag/llvmorg-17.0.5) sources; +1. download [`LLVM project`](https://github.com/llvm/llvm-project/releases/tag/llvmorg-17.0.6) sources; 2. build [`LLVM project`](http://llvm.org/docs/CMake.html): ```bash @@ -367,9 +368,9 @@ Run `Visual Studio 17 2022`, open the generated `LLVM.sln`, build all, build pro * Install `lit` into `python`: - - ***Linux***: `python /usr/llvm/17.0.5/llvm-project/llvm/utils/lit/setup.py install` + - ***Linux***: `python /usr/llvm/17.0.6/llvm-project/llvm/utils/lit/setup.py install` - - ***Windows***: `python D:/LLVM/17.0.5/llvm-project/llvm/utils/lit/setup.py install` + - ***Windows***: `python D:/LLVM/17.0.6/llvm-project/llvm/utils/lit/setup.py install` In case of errors, similar to `ModuleNotFoundError: No module named 'setuptools'`, upgrade the `setuptools` package: @@ -377,15 +378,15 @@ Run `Visual Studio 17 2022`, open the generated `LLVM.sln`, build all, build pro * Starting with LLVM 6.0.1 path to `llvm-lit` python script should be specified by the `LLVM_EXTERNAL_LIT` option: - - ***Linux***: `-DLLVM_EXTERNAL_LIT=/usr/llvm/17.0.5/build/bin/llvm-lit` + - ***Linux***: `-DLLVM_EXTERNAL_LIT=/usr/llvm/17.0.6/build/bin/llvm-lit` - - ***Windows***: `-DLLVM_EXTERNAL_LIT=D:/LLVM/17.0.5/build/Release/bin/llvm-lit.py` + - ***Windows***: `-DLLVM_EXTERNAL_LIT=D:/LLVM/17.0.6/build/Release/bin/llvm-lit.py` * `FileCheck`: - - ***Linux***: copy from `/usr/llvm/17.0.5/build/bin/` to `CMAKE_INSTALL_PREFIX/dist/bin` + - ***Linux***: copy from `/usr/llvm/17.0.6/build/bin/` to `CMAKE_INSTALL_PREFIX/dist/bin` - - ***Windows***: copy from `D:/LLVM/17.0.5/build/Release/bin` to `CMAKE_INSTALL_PREFIX/dist/bin` + - ***Windows***: copy from `D:/LLVM/17.0.6/build/Release/bin` to `CMAKE_INSTALL_PREFIX/dist/bin` - Or specify the path to `FileCheck` in `CMAKE_INSTALL_PREFIX` option @@ -407,9 +408,9 @@ Ubuntu 14: LLVM 4.0.0 - 7.1.0, CUDA 7.0 - 9.0, cuDNN 5.0.5 - 7.6.5 Ubuntu 16-18: LLVM 8.0.0 - 14.0.6, CUDA 8.0 - 10.2, cuDNN 5.1.10 - 8.0.5 -Ubuntu 20-21: LLVM 9.0.0 - 17.0.5, CUDA 8.0 - 12.2.2, cuDNN 5.1.10 - 8.9.6 +Ubuntu 20-21: LLVM 9.0.0 - 17.0.6, CUDA 8.0 - 12.2.2, cuDNN 5.1.10 - 8.9.6 -Ubuntu 22: LLVM 13.0.0 - 17.0.5, CUDA 10.0 - 12.2.2, cuDNN 8.0.5 - 8.9.6 +Ubuntu 22: LLVM 13.0.0 - 17.0.6, CUDA 10.0 - 12.2.2, cuDNN 8.0.5 - 8.9.6 Minimum build system requirements for the above configurations: @@ -426,11 +427,11 @@ cmake -DHIPIFY_CLANG_TESTS=ON \ -DCMAKE_BUILD_TYPE=Release \ -DCMAKE_INSTALL_PREFIX=../dist \ - -DCMAKE_PREFIX_PATH=/usr/llvm/17.0.5/dist \ + -DCMAKE_PREFIX_PATH=/usr/llvm/17.0.6/dist \ -DCUDA_TOOLKIT_ROOT_DIR=/usr/local/cuda \ -DCUDA_DNN_ROOT_DIR=/usr/local/cuda \ -DCUDA_CUB_ROOT_DIR=/usr/CUB \ - -DLLVM_EXTERNAL_LIT=/usr/llvm/17.0.5/build/bin/llvm-lit \ + -DLLVM_EXTERNAL_LIT=/usr/llvm/17.0.6/build/bin/llvm-lit \ ../hipify ``` @@ -450,14 +451,14 @@ cmake -- Detecting CXX compile features -- Detecting CXX compile features - done -- Found ZLIB: /usr/lib/x86_64-linux-gnu/libz.so (found version "1.2.11") --- Found LLVM 17.0.5: --- - CMake module path: /usr/llvm/17.0.5/dist/lib/cmake/llvm --- - Include path : /usr/llvm/17.0.5/dist/include --- - Binary path : /usr/llvm/17.0.5/dist/bin +-- Found LLVM 17.0.6: +-- - CMake module path: /usr/llvm/17.0.6/dist/lib/cmake/llvm +-- - Include path : /usr/llvm/17.0.6/dist/include +-- - Binary path : /usr/llvm/17.0.6/dist/bin -- Linker detection: GNU ld -- Found PythonInterp: /usr/bin/python (found suitable version "3.9.7", minimum required is "2.7") -- Found lit: /usr/local/bin/lit --- Found FileCheck: /usr/llvm/17.0.5/dist/bin/FileCheck +-- Found FileCheck: /usr/llvm/17.0.6/dist/bin/FileCheck -- Looking for pthread.h -- Looking for pthread.h - found -- Performing Test CMAKE_HAVE_LIBC_PTHREAD @@ -478,7 +479,7 @@ make test-hipify Running HIPify regression tests ======================================== CUDA 12.2 - will be used for testing -LLVM 17.0.5 - will be used for testing +LLVM 17.0.6 - will be used for testing x86_64 - Platform architecture Linux 5.13.0-21-generic - Platform OS 64 - hipify-clang binary bitness @@ -597,7 +598,7 @@ Testing Time: 7.90s | 14.0.0 - 14.0.6 | 7.0 - 11.7.1 | 8.0.5 - 8.4.1 | 2017.15.9.57*, 2019.16.11.17, 2022.17.2.6 | 3.24.0 | 3.10.6 | | 15.0.0 - 15.0.7 | 7.0 - 11.8.0 | 8.0.5 - 8.8.1 | 2019.16.11.25, 2022.17.5.2 | 3.26.0 | 3.11.2 | | 16.0.0 - 16.0.6 | 7.0 - 12.2.2 | 8.0.5 - 8.9.5 | 2019.16.11.29, 2022.17.7.1 | 3.27.3 | 3.11.4 | -| 17.0.1** 17.0.5 | 7.0 - 12.2.2 | 8.0.5 - 8.9.6 | 2019.16.11.30, 2022.17.7.4 | 3.27.6 | 3.12.0 | +| 17.0.1** 17.0.6 | 7.0 - 12.2.2 | 8.0.5 - 8.9.6 | 2019.16.11.30, 2022.17.7.4 | 3.27.6 | 3.12.0 | | 18.0.0git | 7.0 - 12.2.2 | 8.0.5 - 8.9.6 | 2019.16.11.30, 2022.17.7.4 | 3.27.6 | 3.12.0 | `*` LLVM 14.x.x is the latest major release supporting Visual Studio 2017. @@ -616,12 +617,12 @@ cmake -DHIPIFY_CLANG_TESTS=ON \ -DCMAKE_BUILD_TYPE=Release \ -DCMAKE_INSTALL_PREFIX=../dist \ - -DCMAKE_PREFIX_PATH=D:/LLVM/17.0.5/dist \ + -DCMAKE_PREFIX_PATH=D:/LLVM/17.0.6/dist \ -DCUDA_TOOLKIT_ROOT_DIR="C:/Program Files/NVIDIA GPU Computing Toolkit/CUDA/v12.2" \ -DCUDA_SDK_ROOT_DIR="C:/ProgramData/NVIDIA Corporation/CUDA Samples/v12.2" \ -DCUDA_DNN_ROOT_DIR=D:/CUDA/cuDNN/8.9.6 \ -DCUDA_CUB_ROOT_DIR=D:/CUDA/CUB/cub-2.1.0 \ - -DLLVM_EXTERNAL_LIT=D:/LLVM/17.0.5/build/Release/bin/llvm-lit.py \ + -DLLVM_EXTERNAL_LIT=D:/LLVM/17.0.6/build/Release/bin/llvm-lit.py \ ../hipify ``` *A corresponding successful output:* @@ -643,15 +644,15 @@ cmake -- - Build hipify-clang : ON -- - Test hipify-clang : ON -- - Is part of HIP SDK : OFF --- Found LLVM 17.0.5: --- - CMake module path : D:/LLVM/17.0.5/dist/lib/cmake/llvm --- - Clang include path : D:/LLVM/17.0.5/dist/include --- - LLVM Include path : D:/LLVM/17.0.5/dist/include --- - Binary path : D:/LLVM/17.0.5/dist/bin +-- Found LLVM 17.0.6: +-- - CMake module path : D:/LLVM/17.0.6/dist/lib/cmake/llvm +-- - Clang include path : D:/LLVM/17.0.6/dist/include +-- - LLVM Include path : D:/LLVM/17.0.6/dist/include +-- - Binary path : D:/LLVM/17.0.6/dist/bin -- ---- The below configuring for hipify-clang testing only ---- -- Found Python: C:/Users/TT/AppData/Local/Programs/Python/Python312/python.exe (found version "3.12.0") found components: Interpreter -- Found lit: C:/Users/TT/AppData/Local/Programs/Python/Python312/Scripts/lit.exe --- Found FileCheck: D:/LLVM/17.0.5/dist/bin/FileCheck.exe +-- Found FileCheck: D:/LLVM/17.0.6/dist/bin/FileCheck.exe -- Initial CUDA to configure: -- - CUDA Toolkit path : C:/Program Files/NVIDIA GPU Computing Toolkit/CUDA/v12.2 -- - CUDA Samples path : C:/ProgramData/NVIDIA Corporation/CUDA Samples/v12.2