summaryrefslogtreecommitdiffstats
path: root/Help/variable/CMAKE_LANG_HOST_COMPILER.rst
diff options
context:
space:
mode:
authorBrad King <brad.king@kitware.com>2023-09-25 20:00:22 (GMT)
committerBrad King <brad.king@kitware.com>2023-09-25 20:11:18 (GMT)
commitb3e92775ab5defa49783b5ff46627c3d3662ab2b (patch)
tree99c8fe9512f897863ac63820529cedca8b20fb0b /Help/variable/CMAKE_LANG_HOST_COMPILER.rst
parente43918b4caf8de881cb24a0a7494e086202cff34 (diff)
downloadCMake-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.rst13
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::