@@ -37,11 +37,11 @@ Dependencies
37
37
38
38
* `LLVM+Clang <http://releases.llvm.org >`_ of at least version
39
39
`4.0.0 <http://releases.llvm.org/download.html#4.0.0 >`_; the latest stable and recommended release:
40
- `19.1.1 <https://github.com/llvm/llvm-project/releases/tag/llvmorg-19.1.1 >`_.
40
+ `19.1.3 <https://github.com/llvm/llvm-project/releases/tag/llvmorg-19.1.3 >`_.
41
41
42
42
* `CUDA <https://developer.nvidia.com/cuda-downloads >`_ of at least version
43
43
`7.0 <https://developer.nvidia.com/cuda-toolkit-70 >`_, the latest supported version is
44
- `12.6.1 <https://developer.nvidia.com/cuda-downloads >`_.
44
+ `12.6.2 <https://developer.nvidia.com/cuda-downloads >`_.
45
45
46
46
.. list-table ::
47
47
@@ -185,8 +185,10 @@ Dependencies
185
185
- ✅
186
186
- ✅
187
187
* - `19.1.0 <https://github.com/llvm/llvm-project/releases/tag/llvmorg-19.1.0 >`_,
188
- `19.1.1 <https://github.com/llvm/llvm-project/releases/tag/llvmorg-19.1.1 >`_:sup: `4 `
189
- - `12.6.1 <https://developer.nvidia.com/cuda-downloads >`_:sup: `4 `
188
+ `19.1.1 <https://github.com/llvm/llvm-project/releases/tag/llvmorg-19.1.1 >`_,
189
+ `19.1.2 <https://github.com/llvm/llvm-project/releases/tag/llvmorg-19.1.2 >`_,
190
+ `19.1.3 <https://github.com/llvm/llvm-project/releases/tag/llvmorg-19.1.3 >`_:sup: `4 `
191
+ - `12.6.2 <https://developer.nvidia.com/cuda-downloads >`_:sup: `4 `
190
192
- **Latest stable config **
191
193
- **Latest stable config **
192
194
@@ -228,7 +230,7 @@ Dependencies
228
230
In most cases, you can get a suitable version of ``LLVM+Clang `` with your package manager. However, you can also
229
231
`download a release archive <http://releases.llvm.org/ >`_ and build or install it. In case of multiple versions of ``LLVM `` installed, set
230
232
`CMAKE_PREFIX_PATH <https://cmake.org/cmake/help/latest/variable/CMAKE_PREFIX_PATH.html >`_ so that
231
- ``CMake `` can find the desired version of ``LLVM ``. For example, ``-DCMAKE_PREFIX_PATH=D:\LLVM\19.1.1 \dist ``.
233
+ ``CMake `` can find the desired version of ``LLVM ``. For example, ``-DCMAKE_PREFIX_PATH=D:\LLVM\19.1.3 \dist ``.
232
234
233
235
Usage
234
236
============================================================
@@ -261,7 +263,7 @@ header files used during the hipification process:
261
263
262
264
.. code :: shell
263
265
264
- ./hipify-clang square.cu --cuda-path=/usr/local/cuda-12.6 --clang-resource-directory=/usr/llvm/19.1.1 /dist/lib/clang/19
266
+ ./hipify-clang square.cu --cuda-path=/usr/local/cuda-12.6 --clang-resource-directory=/usr/llvm/19.1.3 /dist/lib/clang/19
265
267
266
268
For more information, refer to the `Clang manual for compiling CUDA <https://llvm.org/docs/CompileCudaWithLLVM.html#compiling-cuda-code >`_.
267
269
@@ -398,7 +400,7 @@ To ensure LLVM being found or in case of multiple LLVM instances, specify the pa
398
400
399
401
.. code-block :: bash
400
402
401
- -DCMAKE_PREFIX_PATH=/usr/llvm/19.1.1 /dist
403
+ -DCMAKE_PREFIX_PATH=/usr/llvm/19.1.3 /dist
402
404
403
405
On Windows, specify the following option for CMake in the first place:
404
406
``-G "Visual Studio 17 2022" ``.
@@ -472,7 +474,7 @@ LLVM <= 9.0.1
472
474
LLVM >= 10.0.0
473
475
-----------------
474
476
475
- 1. Download `LLVM project <https://github.com/llvm/llvm-project/releases/tag/llvmorg-19.1.1 >`_ sources.
477
+ 1. Download `LLVM project <https://github.com/llvm/llvm-project/releases/tag/llvmorg-19.1.3 >`_ sources.
476
478
477
479
2. Build `LLVM project <http://llvm.org/docs/CMake.html >`_:
478
480
@@ -546,7 +548,7 @@ LLVM >= 10.0.0
546
548
547
549
.. code-block :: shell
548
550
549
- -DCUDA_DNN_ROOT_DIR=D:/CUDA/cuDNN/9.5.0
551
+ -DCUDA_DNN_ROOT_DIR=D:/CUDA/cuDNN/9.5.1
550
552
551
553
5. [Optional] Install `CUB 1.9.8 <https://github.com/NVIDIA/cub/releases/tag/1.9.8 >`_ for ``CUDA < 11.0 `` only;
552
554
for ``CUDA >= 11.0 ``, the CUB shipped with CUDA will be used for testing.
@@ -565,7 +567,7 @@ LLVM >= 10.0.0
565
567
566
568
-DCUDA_CUB_ROOT_DIR=D:/CUDA/CUB
567
569
568
- 6. Install `Python <https://www.python.org/downloads >`_ version 2.7 or greater.
570
+ 6. Install `Python <https://www.python.org/downloads >`_ version 3.0 or greater.
569
571
570
572
7. Install ``lit `` and ``FileCheck ``; these are distributed with LLVM.
571
573
@@ -575,13 +577,13 @@ LLVM >= 10.0.0
575
577
576
578
.. code-block :: bash
577
579
578
- python /usr/llvm/19.1.1 /llvm-project/llvm/utils/lit/setup.py install
580
+ python /usr/llvm/19.1.3 /llvm-project/llvm/utils/lit/setup.py install
579
581
580
582
**Windows **:
581
583
582
584
.. code-block :: shell
583
585
584
- python D:/LLVM/19.1.1 /llvm-project/llvm/utils/lit/setup.py install
586
+ python D:/LLVM/19.1.3 /llvm-project/llvm/utils/lit/setup.py install
585
587
586
588
In case of errors similar to ``ModuleNotFoundError: No module named 'setuptools' ``, upgrade the ``setuptools `` package:
587
589
@@ -595,23 +597,23 @@ LLVM >= 10.0.0
595
597
596
598
.. code-block :: bash
597
599
598
- -DLLVM_EXTERNAL_LIT=/usr/llvm/19.1.1 /build/bin/llvm-lit
600
+ -DLLVM_EXTERNAL_LIT=/usr/llvm/19.1.3 /build/bin/llvm-lit
599
601
600
602
**Windows **:
601
603
602
604
.. code-block :: shell
603
605
604
- -DLLVM_EXTERNAL_LIT=D:/LLVM/19.1.1 /build/Release/bin/llvm-lit.py
606
+ -DLLVM_EXTERNAL_LIT=D:/LLVM/19.1.3 /build/Release/bin/llvm-lit.py
605
607
606
608
* ``FileCheck ``:
607
609
608
610
**Linux **:
609
611
610
- Copy from ``/usr/llvm/19.1.1 /build/bin/ `` to ``CMAKE_INSTALL_PREFIX/dist/bin ``.
612
+ Copy from ``/usr/llvm/19.1.3 /build/bin/ `` to ``CMAKE_INSTALL_PREFIX/dist/bin ``.
611
613
612
614
**Windows **:
613
615
614
- Copy from ``D:/LLVM/19.1.1 /build/Release/bin `` to ``CMAKE_INSTALL_PREFIX/dist/bin ``.
616
+ Copy from ``D:/LLVM/19.1.3 /build/Release/bin `` to ``CMAKE_INSTALL_PREFIX/dist/bin ``.
615
617
616
618
Alternatively, specify the path to ``FileCheck `` in the ``CMAKE_INSTALL_PREFIX `` option.
617
619
@@ -638,16 +640,16 @@ On Linux, the following configurations are tested:
638
640
639
641
* Ubuntu 14: LLVM 4.0.0 - 7.1.0, CUDA 7.0 - 9.0, cuDNN 5.0.5 - 7.6.5
640
642
* Ubuntu 16-19: LLVM 8.0.0 - 14.0.6, CUDA 7.0 - 10.2, cuDNN 5.1.10 - 8.0.5
641
- * Ubuntu 20-21: LLVM 9.0.0 - 19.1.1 , CUDA 7.0 - 12.6.1 , cuDNN 5.1.10 - 9.5.0
642
- * Ubuntu 22-23: LLVM 13.0.0 - 19.1.1 , CUDA 7.0 - 12.6.1 , cuDNN 8.0.5 - 9.5.0
643
+ * Ubuntu 20-21: LLVM 9.0.0 - 19.1.3 , CUDA 7.0 - 12.6.2 , cuDNN 5.1.10 - 9.5.1
644
+ * Ubuntu 22-23: LLVM 13.0.0 - 19.1.3 , CUDA 7.0 - 12.6.2 , cuDNN 8.0.5 - 9.5.1
643
645
644
646
Minimum build system requirements for the above configurations:
645
647
646
648
* CMake 3.16.8, GNU C/C++ 9.2, Python 3.0.
647
649
648
650
Recommended build system requirements:
649
651
650
- * CMake 3.30.4 , GNU C/C++ 13.2, Python 3.12.7 .
652
+ * CMake 3.31.0 , GNU C/C++ 13.2, Python 3.13.0 .
651
653
652
654
Here's how to build ``hipify-clang `` with testing support on ``Ubuntu 23.10.01 ``:
653
655
@@ -657,10 +659,10 @@ Here's how to build ``hipify-clang`` with testing support on ``Ubuntu 23.10.01``
657
659
-DHIPIFY_CLANG_TESTS=ON \
658
660
-DCMAKE_BUILD_TYPE=Release \
659
661
-DCMAKE_INSTALL_PREFIX=../dist \
660
- -DCMAKE_PREFIX_PATH=/usr/llvm/19.1.1 /dist \
661
- -DCUDA_TOOLKIT_ROOT_DIR=/usr/local/cuda-12.6.1 \
662
- -DCUDA_DNN_ROOT_DIR=/usr/local/cudnn-9.5.0 \
663
- -DLLVM_EXTERNAL_LIT=/usr/llvm/19.1.1 /build/bin/llvm-lit \
662
+ -DCMAKE_PREFIX_PATH=/usr/llvm/19.1.3 /dist \
663
+ -DCUDA_TOOLKIT_ROOT_DIR=/usr/local/cuda-12.6.2 \
664
+ -DCUDA_DNN_ROOT_DIR=/usr/local/cudnn-9.5.1 \
665
+ -DLLVM_EXTERNAL_LIT=/usr/llvm/19.1.3 /build/bin/llvm-lit \
664
666
../hipify
665
667
666
668
The corresponding successful output is:
@@ -684,30 +686,30 @@ The corresponding successful output is:
684
686
-- - Test hipify-clang : ON
685
687
-- - Is part of HIP SDK : OFF
686
688
-- Found ZLIB: /usr/lib/x86_64-linux-gnu/libz.so (found version " 1.2.13" )
687
- -- Found LLVM 19.1.1 :
688
- -- - CMake module path : /usr/llvm/19.1.1 /dist/lib/cmake/llvm
689
- -- - Clang include path : /usr/llvm/19.1.1 /dist/include
690
- -- - LLVM Include path : /usr/llvm/19.1.1 /dist/include
691
- -- - Binary path : /usr/llvm/19.1.1 /dist/bin
689
+ -- Found LLVM 19.1.3 :
690
+ -- - CMake module path : /usr/llvm/19.1.3 /dist/lib/cmake/llvm
691
+ -- - Clang include path : /usr/llvm/19.1.3 /dist/include
692
+ -- - LLVM Include path : /usr/llvm/19.1.3 /dist/include
693
+ -- - Binary path : /usr/llvm/19.1.3 /dist/bin
692
694
-- Linker detection: GNU ld
693
695
-- ---- The below configuring for hipify-clang testing only ----
694
- -- Found Python: /usr/bin/python3.12 (found version " 3.12.7 " ) found components: Interpreter
696
+ -- Found Python: /usr/bin/python3.13 (found version " 3.13.0 " ) found components: Interpreter
695
697
-- Found lit: /usr/local/bin/lit
696
698
-- Found FileCheck: /GIT/LLVM/trunk/dist/FileCheck
697
699
-- Initial CUDA to configure:
698
- -- - CUDA Toolkit path : /usr/local/cuda-12.6.1
700
+ -- - CUDA Toolkit path : /usr/local/cuda-12.6.2
699
701
-- - CUDA Samples path :
700
- -- - cuDNN path : /usr/local/cudnn-9.5.0
702
+ -- - cuDNN path : /usr/local/cudnn-9.5.1
701
703
-- - CUB path :
702
- -- Found CUDAToolkit: /usr/local/cuda-12.6.1 /targets/x86_64-linux/include (found version " 12.6.68" )
704
+ -- Found CUDAToolkit: /usr/local/cuda-12.6.2 /targets/x86_64-linux/include (found version " 12.6.68" )
703
705
-- Performing Test CMAKE_HAVE_LIBC_PTHREAD
704
706
-- Performing Test CMAKE_HAVE_LIBC_PTHREAD - Success
705
707
-- Found Threads: TRUE
706
708
-- Found CUDA config:
707
- -- - CUDA Toolkit path : /usr/local/cuda-12.6.1
709
+ -- - CUDA Toolkit path : /usr/local/cuda-12.6.2
708
710
-- - CUDA Samples path : OFF
709
- -- - cuDNN path : /usr/local/cudnn-9.5.0
710
- -- - CUB path : /usr/local/cuda-12.6.1 /include/cub
711
+ -- - cuDNN path : /usr/local/cudnn-9.5.1
712
+ -- - CUB path : /usr/local/cuda-12.6.2 /include/cub
711
713
-- Configuring done (0.5s)
712
714
-- Generating done (0.0s)
713
715
-- Build files have been written to: /usr/hipify/build
@@ -723,11 +725,11 @@ The corresponding successful output is:
723
725
Running HIPify regression tests
724
726
===============================================================
725
727
CUDA 12.6.68 - will be used for testing
726
- LLVM 19.1.1 - will be used for testing
728
+ LLVM 19.1.3 - will be used for testing
727
729
x86_64 - Platform architecture
728
730
Linux 6.5.0-15-generic - Platform OS
729
731
64 - hipify-clang binary bitness
730
- 64 - python 3.12.7 binary bitness
732
+ 64 - python 3.13.0 binary bitness
731
733
===============================================================
732
734
-- Testing: 106 tests, 12 threads --
733
735
Testing Time: 6.91s
@@ -819,16 +821,16 @@ Tested configurations:
819
821
- ``3.11.4 ``
820
822
* - ``17.0.1 `` :sup: `6` - ``18.1.8 `` :sup: `7`
821
823
- ``7.0 - 12.3.2 ``
822
- - ``8.0.5 - 9.5.0 ``
823
- - ``2019.16.11.40 , 2022.17.11.4 ``
824
- - ``3.30.4 ``
825
- - ``3.12.7 ``
826
- * - ``19.1.1 ``
827
- - ``7.0 - 12.6.1 ``
828
- - ``8.0.5 - 9.5.0 ``
829
- - ``2019.16.11.40 , 2022.17.11.4 ``
830
- - ``3.30.4 ``
831
- - ``3.12.7 ``
824
+ - ``8.0.5 - 9.5.1 ``
825
+ - ``2019.16.11.42 , 2022.17.11.6 ``
826
+ - ``3.31.0 ``
827
+ - ``3.13.0 ``
828
+ * - ``19.1.0 - 19.1.3 ``
829
+ - ``7.0 - 12.6.2 ``
830
+ - ``8.0.5 - 9.5.1 ``
831
+ - ``2019.16.11.42 , 2022.17.11.6 ``
832
+ - ``3.31.0 ``
833
+ - ``3.13.0 ``
832
834
833
835
:sup: `5` LLVM 14.x.x is the latest major release supporting Visual Studio 2017.
834
836
@@ -853,11 +855,11 @@ Building with testing support using ``Visual Studio 17 2022`` on ``Windows 11``:
853
855
-DHIPIFY_CLANG_TESTS=ON \
854
856
-DCMAKE_BUILD_TYPE=Release \
855
857
-DCMAKE_INSTALL_PREFIX=../dist \
856
- -DCMAKE_PREFIX_PATH=D:/LLVM/19.1.1 /dist \
858
+ -DCMAKE_PREFIX_PATH=D:/LLVM/19.1.3 /dist \
857
859
-DCUDA_TOOLKIT_ROOT_DIR=" C:/Program Files/NVIDIA GPU Computing Toolkit/CUDA/v12.6" \
858
860
-DCUDA_SDK_ROOT_DIR=" C:/ProgramData/NVIDIA Corporation/CUDA Samples/v12.5" \
859
- -DCUDA_DNN_ROOT_DIR=D:/CUDA/cuDNN/9.5.0 \
860
- -DLLVM_EXTERNAL_LIT=D:/LLVM/19.1.1 /build/Release/bin/llvm-lit.py \
861
+ -DCUDA_DNN_ROOT_DIR=D:/CUDA/cuDNN/9.5.1 \
862
+ -DLLVM_EXTERNAL_LIT=D:/LLVM/19.1.3 /build/Release/bin/llvm-lit.py \
861
863
../hipify
862
864
863
865
The corresponding successful output is:
@@ -881,25 +883,25 @@ The corresponding successful output is:
881
883
-- - Build hipify-clang : ON
882
884
-- - Test hipify-clang : ON
883
885
-- - Is part of HIP SDK : OFF
884
- -- Found LLVM 19.1.1 :
885
- -- - CMake module path : D:/LLVM/19.1.1 /dist/lib/cmake/llvm
886
- -- - Clang include path : D:/LLVM/19.1.1 /dist/include
887
- -- - LLVM Include path : D:/LLVM/19.1.1 /dist/include
888
- -- - Binary path : D:/LLVM/19.1.1 /dist/bin
886
+ -- Found LLVM 19.1.3 :
887
+ -- - CMake module path : D:/LLVM/19.1.3 /dist/lib/cmake/llvm
888
+ -- - Clang include path : D:/LLVM/19.1.3 /dist/include
889
+ -- - LLVM Include path : D:/LLVM/19.1.3 /dist/include
890
+ -- - Binary path : D:/LLVM/19.1.3 /dist/bin
889
891
-- ---- The below configuring for hipify-clang testing only ----
890
- -- Found Python: C:/Users/TT/AppData/Local/Programs/Python/Python312 /python.exe (found version " 3.12.7 " ) found components: Interpreter
891
- -- Found lit: C:/Users/TT/AppData/Local/Programs/Python/Python312 /Scripts/lit.exe
892
- -- Found FileCheck: D:/LLVM/19.1.1 /dist/bin/FileCheck.exe
892
+ -- Found Python: C:/Users/TT/AppData/Local/Programs/Python/Python313 /python.exe (found version " 3.13.0 " ) found components: Interpreter
893
+ -- Found lit: C:/Users/TT/AppData/Local/Programs/Python/Python313 /Scripts/lit.exe
894
+ -- Found FileCheck: D:/LLVM/19.1.3 /dist/bin/FileCheck.exe
893
895
-- Initial CUDA to configure:
894
896
-- - CUDA Toolkit path : C:/Program Files/NVIDIA GPU Computing Toolkit/CUDA/v12.6
895
897
-- - CUDA Samples path : C:/ProgramData/NVIDIA Corporation/CUDA Samples/v12.5
896
- -- - cuDNN path : D:/CUDA/cuDNN/9.5.0
898
+ -- - cuDNN path : D:/CUDA/cuDNN/9.5.1
897
899
-- - CUB path :
898
900
-- Found CUDAToolkit: C:/Program Files/NVIDIA GPU Computing Toolkit/CUDA/v12.6/include (found version " 12.6.68" )
899
901
-- Found CUDA config:
900
902
-- - CUDA Toolkit path : C:/Program Files/NVIDIA GPU Computing Toolkit/CUDA/v12.6
901
903
-- - CUDA Samples path : C:/ProgramData/NVIDIA Corporation/CUDA Samples/v12.5
902
- -- - cuDNN path : D:/CUDA/cuDNN/9.5.0
904
+ -- - cuDNN path : D:/CUDA/cuDNN/9.5.1
903
905
-- - CUB path : C:/Program Files/NVIDIA GPU Computing Toolkit/CUDA/v12.6/include/cub
904
906
-- Configuring done (2.1s)
905
907
-- Generating done (0.1s)
0 commit comments