Skip to content

Commit

Permalink
[HIPIFY][doc] LLVM 18.1.7 is the latest supported LLVM release
Browse files Browse the repository at this point in the history 
+ No patches are needed
+ Updated the `README.md` accordingly
+ Tested on Windows 11 and Ubuntu 23.10
  • Loading branch information
@emankov
emankov committed Jun 17, 2024
1 parent 455103c commit 7b278a2
Showing 1 changed file with 32 additions and 31 deletions.
63 changes: 32 additions & 31 deletions docs/hipify-clang.rst
View file
Original file line number Diff line number Diff line change
Expand Up @@ -37,7 +37,7 @@ Dependencies

* `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:
`18.1.6 <https://github.com/llvm/llvm-project/releases/tag/llvmorg-18.1.6>`_.
`18.1.7 <https://github.com/llvm/llvm-project/releases/tag/llvmorg-18.1.7>`_.

* `CUDA <https://developer.nvidia.com/cuda-downloads>`_ of at least version
`7.0 <https://developer.nvidia.com/cuda-toolkit-70>`_, the latest supported version is
Expand Down Expand Up @@ -178,7 +178,8 @@ Dependencies
`18.1.3 <https://github.com/llvm/llvm-project/releases/tag/llvmorg-18.1.3>`_,
`18.1.4 <https://github.com/llvm/llvm-project/releases/tag/llvmorg-18.1.4>`_,
`18.1.5 <https://github.com/llvm/llvm-project/releases/tag/llvmorg-18.1.5>`_,
`18.1.6 <https://github.com/llvm/llvm-project/releases/tag/llvmorg-18.1.6>`_ :sup:`4`
`18.1.6 <https://github.com/llvm/llvm-project/releases/tag/llvmorg-18.1.6>`_,
`18.1.7 <https://github.com/llvm/llvm-project/releases/tag/llvmorg-18.1.7>`_ :sup:`4`
- `12.3.2 <https://developer.nvidia.com/cuda-downloads>`_ :sup:`4`
- **Latest stable config**
- **Latest stable config**
Expand Down Expand Up @@ -225,7 +226,7 @@ Dependencies
In most cases, you can get a suitable version of ``LLVM+Clang`` with your package manager. However, you can also
`download a release archive <http://releases.llvm.org/>`_ and build or install it. In case of multiple versions of ``LLVM`` installed, set
`CMAKE_PREFIX_PATH <https://cmake.org/cmake/help/latest/variable/CMAKE_PREFIX_PATH.html>`_ so that
``CMake`` can find the desired version of ``LLVM``. For example, ``-DCMAKE_PREFIX_PATH=D:\LLVM\18.1.6\dist``.
``CMake`` can find the desired version of ``LLVM``. For example, ``-DCMAKE_PREFIX_PATH=D:\LLVM\18.1.7\dist``.

Usage
============================================================
Expand Down Expand Up @@ -258,7 +259,7 @@ header files used during the hipification process:

.. code:: shell
./hipify-clang square.cu --cuda-path=/usr/local/cuda-12.3 --clang-resource-directory=/usr/llvm/18.1.6/dist/lib/clang/18
./hipify-clang square.cu --cuda-path=/usr/local/cuda-12.3 --clang-resource-directory=/usr/llvm/18.1.7/dist/lib/clang/18
For more information, refer to the `Clang manual for compiling CUDA <https://llvm.org/docs/CompileCudaWithLLVM.html#compiling-cuda-code>`_.

Expand Down Expand Up @@ -395,7 +396,7 @@ To ensure LLVM being found or in case of multiple LLVM instances, specify the pa

.. code-block:: bash
-DCMAKE_PREFIX_PATH=/usr/llvm/18.1.6/dist
-DCMAKE_PREFIX_PATH=/usr/llvm/18.1.7/dist
On Windows, specify the following option for CMake in the first place:
``-G "Visual Studio 17 2022"``.
Expand Down Expand Up @@ -469,7 +470,7 @@ LLVM <= 9.0.1
LLVM >= 10.0.0
-----------------

1. Download `LLVM project <https://github.com/llvm/llvm-project/releases/tag/llvmorg-18.1.6>`_ sources.
1. Download `LLVM project <https://github.com/llvm/llvm-project/releases/tag/llvmorg-18.1.7>`_ sources.

2. Build `LLVM project <http://llvm.org/docs/CMake.html>`_:

Expand Down Expand Up @@ -571,13 +572,13 @@ LLVM >= 10.0.0

.. code-block:: bash
python /usr/llvm/18.1.6/llvm-project/llvm/utils/lit/setup.py install
python /usr/llvm/18.1.7/llvm-project/llvm/utils/lit/setup.py install
**Windows**:

.. code-block:: shell
python D:/LLVM/18.1.6/llvm-project/llvm/utils/lit/setup.py install
python D:/LLVM/18.1.7/llvm-project/llvm/utils/lit/setup.py install
In case of errors similar to ``ModuleNotFoundError: No module named 'setuptools'``, upgrade the ``setuptools`` package:

Expand All @@ -591,23 +592,23 @@ LLVM >= 10.0.0

.. code-block:: bash
-DLLVM_EXTERNAL_LIT=/usr/llvm/18.1.6/build/bin/llvm-lit
-DLLVM_EXTERNAL_LIT=/usr/llvm/18.1.7/build/bin/llvm-lit
**Windows**:

.. code-block:: shell
-DLLVM_EXTERNAL_LIT=D:/LLVM/18.1.6/build/Release/bin/llvm-lit.py
-DLLVM_EXTERNAL_LIT=D:/LLVM/18.1.7/build/Release/bin/llvm-lit.py
* ``FileCheck``:

**Linux**:

Copy from ``/usr/llvm/18.1.6/build/bin/`` to ``CMAKE_INSTALL_PREFIX/dist/bin``.
Copy from ``/usr/llvm/18.1.7/build/bin/`` to ``CMAKE_INSTALL_PREFIX/dist/bin``.

**Windows**:

Copy from ``D:/LLVM/18.1.6/build/Release/bin`` to ``CMAKE_INSTALL_PREFIX/dist/bin``.
Copy from ``D:/LLVM/18.1.7/build/Release/bin`` to ``CMAKE_INSTALL_PREFIX/dist/bin``.

Alternatively, specify the path to ``FileCheck`` in the ``CMAKE_INSTALL_PREFIX`` option.

Expand All @@ -634,8 +635,8 @@ On Linux, the following configurations are tested:

* Ubuntu 14: LLVM 4.0.0 - 7.1.0, CUDA 7.0 - 9.0, cuDNN 5.0.5 - 7.6.5
* Ubuntu 16-19: LLVM 8.0.0 - 14.0.6, CUDA 7.0 - 10.2, cuDNN 5.1.10 - 8.0.5
* Ubuntu 20-21: LLVM 9.0.0 - 18.1.6, CUDA 7.0 - 12.3.2, cuDNN 5.1.10 - 9.2.0
* Ubuntu 22-23: LLVM 13.0.0 - 18.1.6, CUDA 7.0 - 12.3.2, cuDNN 8.0.5 - 9.2.0
* Ubuntu 20-21: LLVM 9.0.0 - 18.1.7, CUDA 7.0 - 12.3.2, cuDNN 5.1.10 - 9.2.0
* Ubuntu 22-23: LLVM 13.0.0 - 18.1.7, CUDA 7.0 - 12.3.2, cuDNN 8.0.5 - 9.2.0

Minimum build system requirements for the above configurations:

Expand All @@ -653,11 +654,11 @@ Here's how to build ``hipify-clang`` with testing support on ``Ubuntu 23.10.01``
-DHIPIFY_CLANG_TESTS=ON \
-DCMAKE_BUILD_TYPE=Release \
-DCMAKE_INSTALL_PREFIX=../dist \
-DCMAKE_PREFIX_PATH=/usr/llvm/18.1.6/dist \
-DCMAKE_PREFIX_PATH=/usr/llvm/18.1.7/dist \
-DCUDA_TOOLKIT_ROOT_DIR=/usr/local/cuda-12.3.2 \
-DCUDA_DNN_ROOT_DIR=/usr/local/cudnn-9.2.0 \
-DCUDA_CUB_ROOT_DIR=/usr/local/cub-2.1.0 \
-DLLVM_EXTERNAL_LIT=/usr/llvm/18.1.6/build/bin/llvm-lit \
-DLLVM_EXTERNAL_LIT=/usr/llvm/18.1.7/build/bin/llvm-lit \
../hipify
The corresponding successful output is:
Expand All @@ -681,11 +682,11 @@ The corresponding successful output is:
-- - Test hipify-clang : ON
-- - Is part of HIP SDK : OFF
-- Found ZLIB: /usr/lib/x86_64-linux-gnu/libz.so (found version "1.2.13")
-- Found LLVM 18.1.6:
-- - CMake module path : /usr/llvm/18.1.6/dist/lib/cmake/llvm
-- - Clang include path : /usr/llvm/18.1.6/dist/include
-- - LLVM Include path : /usr/llvm/18.1.6/dist/include
-- - Binary path : /usr/llvm/18.1.6/dist/bin
-- Found LLVM 18.1.7:
-- - CMake module path : /usr/llvm/18.1.7/dist/lib/cmake/llvm
-- - Clang include path : /usr/llvm/18.1.7/dist/include
-- - LLVM Include path : /usr/llvm/18.1.7/dist/include
-- - Binary path : /usr/llvm/18.1.7/dist/bin
-- Linker detection: GNU ld
-- ---- The below configuring for hipify-clang testing only ----
-- Found Python: /usr/bin/python3.12 (found version "3.12.4") found components: Interpreter
Expand Down Expand Up @@ -720,7 +721,7 @@ The corresponding successful output is:
Running HIPify regression tests
===============================================================
CUDA 12.3.107 - will be used for testing
LLVM 18.1.6 - will be used for testing
LLVM 18.1.7 - will be used for testing
x86_64 - Platform architecture
Linux 6.5.0-15-generic - Platform OS
64 - hipify-clang binary bitness
Expand Down Expand Up @@ -814,7 +815,7 @@ Tested configurations:
- ``2019.16.11.29, 2022.17.7.1``
- ``3.27.3``
- ``3.11.4``
* - ``17.0.1`` :sup:`6` - ``18.1.6`` :sup:`7`
* - ``17.0.1`` :sup:`6` - ``18.1.7`` :sup:`7`
- ``7.0 - 12.3.2``
- ``8.0.5 - 9.2.0``
- ``2019.16.11.36, 2022.17.10.1``
Expand Down Expand Up @@ -850,12 +851,12 @@ Building with testing support using ``Visual Studio 17 2022`` on ``Windows 11``:
-DHIPIFY_CLANG_TESTS=ON \
-DCMAKE_BUILD_TYPE=Release \
-DCMAKE_INSTALL_PREFIX=../dist \
-DCMAKE_PREFIX_PATH=D:/LLVM/18.1.6/dist \
-DCMAKE_PREFIX_PATH=D:/LLVM/18.1.7/dist \
-DCUDA_TOOLKIT_ROOT_DIR="C:/Program Files/NVIDIA GPU Computing Toolkit/CUDA/v12.3" \
-DCUDA_SDK_ROOT_DIR="C:/ProgramData/NVIDIA Corporation/CUDA Samples/v12.3" \
-DCUDA_DNN_ROOT_DIR=D:/CUDA/cuDNN/9.2.0 \
-DCUDA_CUB_ROOT_DIR=D:/CUDA/CUB/cub-2.1.0 \
-DLLVM_EXTERNAL_LIT=D:/LLVM/18.1.6/build/Release/bin/llvm-lit.py \
-DLLVM_EXTERNAL_LIT=D:/LLVM/18.1.7/build/Release/bin/llvm-lit.py \
../hipify
The corresponding successful output is:
Expand All @@ -879,15 +880,15 @@ The corresponding successful output is:
-- - Build hipify-clang : ON
-- - Test hipify-clang : ON
-- - Is part of HIP SDK : OFF
-- Found LLVM 18.1.6:
-- - CMake module path : D:/LLVM/18.1.6/dist/lib/cmake/llvm
-- - Clang include path : D:/LLVM/18.1.6/dist/include
-- - LLVM Include path : D:/LLVM/18.1.6/dist/include
-- - Binary path : D:/LLVM/18.1.6/dist/bin
-- Found LLVM 18.1.7:
-- - CMake module path : D:/LLVM/18.1.7/dist/lib/cmake/llvm
-- - Clang include path : D:/LLVM/18.1.7/dist/include
-- - LLVM Include path : D:/LLVM/18.1.7/dist/include
-- - Binary path : D:/LLVM/18.1.7/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.4") found components: Interpreter
-- Found lit: C:/Users/TT/AppData/Local/Programs/Python/Python312/Scripts/lit.exe
-- Found FileCheck: D:/LLVM/18.1.6/dist/bin/FileCheck.exe
-- Found FileCheck: D:/LLVM/18.1.7/dist/bin/FileCheck.exe
-- Initial CUDA to configure:
-- - CUDA Toolkit path : C:/Program Files/NVIDIA GPU Computing Toolkit/CUDA/v12.3
-- - CUDA Samples path : C:/ProgramData/NVIDIA Corporation/CUDA Samples/v12.3
Expand Down

0 comments on commit 7b278a2

Please sign in to comment.