summaryrefslogtreecommitdiff
path: root/share/cmake-3.22/Help/envvar/CUDAHOSTCXX.rst
diff options
context:
space:
mode:
Diffstat (limited to 'share/cmake-3.22/Help/envvar/CUDAHOSTCXX.rst')
-rw-r--r--share/cmake-3.22/Help/envvar/CUDAHOSTCXX.rst24
1 files changed, 24 insertions, 0 deletions
diff --git a/share/cmake-3.22/Help/envvar/CUDAHOSTCXX.rst b/share/cmake-3.22/Help/envvar/CUDAHOSTCXX.rst
new file mode 100644
index 0000000..cf65927
--- /dev/null
+++ b/share/cmake-3.22/Help/envvar/CUDAHOSTCXX.rst
@@ -0,0 +1,24 @@
+CUDAHOSTCXX
+-----------
+
+.. versionadded:: 3.8
+
+.. include:: ENV_VAR.txt
+
+Preferred executable for compiling host code when compiling ``CUDA``
+language files. Will only be used by CMake on the first configuration to
+determine ``CUDA`` host compiler, after which the value for ``CUDAHOSTCXX`` is
+stored in the cache as :variable:`CMAKE_CUDA_HOST_COMPILER`. For any
+configuration run (including the first), the environment variable will be
+ignored if the :variable:`CMAKE_CUDA_HOST_COMPILER` variable is defined.
+
+This environment variable is primarily meant for use with projects that
+enable ``CUDA`` as a first-class language.
+
+.. note::
+
+ Ignored when using :ref:`Visual Studio Generators`.
+
+.. versionadded:: 3.13
+ The :module:`FindCUDA`
+ module will use this variable to initialize its ``CUDA_HOST_COMPILER`` setting.