1CUDACXX
2-------
3
4.. versionadded:: 3.8
5
6.. include:: ENV_VAR.txt
7
8Preferred executable for compiling ``CUDA`` language files. Will only be used by
9CMake on the first configuration to determine ``CUDA`` compiler, after which the
10value for ``CUDA`` is stored in the cache as
11:variable:`CMAKE_CUDA_COMPILER <CMAKE_<LANG>_COMPILER>`. For any configuration
12run (including the first), the environment variable will be ignored if the
13:variable:`CMAKE_CUDA_COMPILER <CMAKE_<LANG>_COMPILER>` variable is defined.
14
15.. note::
16  Options that are required to make the compiler work correctly can be included;
17  they can not be changed.
18
19.. code-block:: console
20
21  $ export CUDACXX="custom-compiler --arg1 --arg2"
22