diff options
author | Brad King <brad.king@kitware.com> | 2023-09-25 20:00:22 (GMT) |
---|---|---|
committer | Brad King <brad.king@kitware.com> | 2023-09-25 20:11:18 (GMT) |
commit | b3e92775ab5defa49783b5ff46627c3d3662ab2b (patch) | |
tree | 99c8fe9512f897863ac63820529cedca8b20fb0b /Help/variable/CMAKE_LANG_HOST_COMPILER.rst | |
parent | e43918b4caf8de881cb24a0a7494e086202cff34 (diff) | |
download | CMake-b3e92775ab5defa49783b5ff46627c3d3662ab2b.zip CMake-b3e92775ab5defa49783b5ff46627c3d3662ab2b.tar.gz CMake-b3e92775ab5defa49783b5ff46627c3d3662ab2b.tar.bz2 |
HIP: Add CMAKE_HIP_HOST_COMPILER when compiler is NVCC
Also add `HIPHOSTCXX` environment variable.
Diffstat (limited to 'Help/variable/CMAKE_LANG_HOST_COMPILER.rst')
-rw-r--r-- | Help/variable/CMAKE_LANG_HOST_COMPILER.rst | 13 |
1 files changed, 8 insertions, 5 deletions
diff --git a/Help/variable/CMAKE_LANG_HOST_COMPILER.rst b/Help/variable/CMAKE_LANG_HOST_COMPILER.rst index 2759784..cf3ba62 100644 --- a/Help/variable/CMAKE_LANG_HOST_COMPILER.rst +++ b/Help/variable/CMAKE_LANG_HOST_COMPILER.rst @@ -4,22 +4,25 @@ CMAKE_<LANG>_HOST_COMPILER .. versionadded:: 3.10 ``CMAKE_CUDA_HOST_COMPILER`` -This variable is available when ``<LANG>`` is ``CUDA``. +.. versionadded:: 3.28 + ``CMAKE_HIP_HOST_COMPILER`` + +This variable is available when ``<LANG>`` is ``CUDA`` or ``HIP``. When :variable:`CMAKE_<LANG>_COMPILER_ID` is ``NVIDIA``, ``CMAKE_<LANG>_HOST_COMPILER`` selects the compiler executable -to use when compiling host code for ``CUDA`` language files. +to use when compiling host code for ``CUDA`` or ``HIP`` language files. This maps to the ``nvcc -ccbin`` option. The ``CMAKE_<LANG>_HOST_COMPILER`` variable may be set explicitly before CUDA -is first enabled by a :command:`project` or :command:`enable_language` +or HIP is first enabled by a :command:`project` or :command:`enable_language` command. This can be done via ``-DCMAKE_<LANG>_HOST_COMPILER=...`` on the command line or in a :ref:`toolchain file <Cross Compiling Toolchain>`. Or, one may set -the :envvar:`CUDAHOSTCXX` environment variable to +the :envvar:`CUDAHOSTCXX` or :envvar:`HIPHOSTCXX` environment variable to provide a default value. -Once the CUDA language is enabled, the ``CMAKE_<LANG>_HOST_COMPILER`` +Once the CUDA or HIP language is enabled, the ``CMAKE_<LANG>_HOST_COMPILER`` variable is read-only and changes to it are undefined behavior. .. note:: |