summaryrefslogtreecommitdiffstats
path: root/Help/envvar
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/envvar
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/envvar')
-rw-r--r--Help/envvar/HIPHOSTCXX.rst19
1 files changed, 19 insertions, 0 deletions
diff --git a/Help/envvar/HIPHOSTCXX.rst b/Help/envvar/HIPHOSTCXX.rst
new file mode 100644
index 0000000..871fbfb
--- /dev/null
+++ b/Help/envvar/HIPHOSTCXX.rst
@@ -0,0 +1,19 @@
+HIPHOSTCXX
+-----------
+
+.. versionadded:: 3.28
+
+.. include:: ENV_VAR.txt
+
+Preferred executable for compiling host code when compiling ``HIP``
+language files with the NVIDIA CUDA Compiler. Will only be used by CMake
+on the first configuration to determine ``HIP`` host compiler, after which
+the value for ``HIPHOSTCXX`` is stored in the cache as
+:variable:`CMAKE_HIP_HOST_COMPILER <CMAKE_<LANG>_HOST_COMPILER>`.
+
+This environment variable is primarily meant for use with projects that
+enable ``HIP`` as a first-class language.
+
+.. note::
+
+ Ignored when using :ref:`Visual Studio Generators`.