mirror of
https://github.com/Kitware/CMake.git
synced 2026-01-06 21:59:54 -06:00
a57beabb78
We should refer to the compiler ID in the documentation to avoid users checking compiler executable names, since that seems fragile.
26 lines
1.1 KiB
ReStructuredText
26 lines
1.1 KiB
ReStructuredText
CMAKE_CUDA_HOST_COMPILER
|
|
------------------------
|
|
|
|
.. versionadded:: 3.10
|
|
|
|
When :variable:`CMAKE_CUDA_COMPILER_ID <CMAKE_<LANG>_COMPILER_ID>` is
|
|
``NVIDIA``, ``CMAKE_CUDA_HOST_COMPILER`` selects the compiler executable to use
|
|
when compiling host code for ``CUDA`` language files.
|
|
This maps to the ``nvcc -ccbin`` option.
|
|
|
|
The ``CMAKE_CUDA_HOST_COMPILER`` variable may be set explicitly before CUDA is
|
|
first enabled by a :command:`project` or :command:`enable_language` command.
|
|
This can be done via ``-DCMAKE_CUDA_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 provide a default value.
|
|
|
|
Once the CUDA language is enabled, the ``CMAKE_CUDA_HOST_COMPILER`` variable
|
|
is read-only and changes to it are undefined behavior.
|
|
|
|
.. note::
|
|
|
|
Since ``CMAKE_CUDA_HOST_COMPILER`` is meaningful only when the
|
|
:variable:`CMAKE_CUDA_COMPILER_ID <CMAKE_<LANG>_COMPILER_ID>` is ``NVIDIA``,
|
|
it does not make sense to set ``CMAKE_CUDA_HOST_COMPILER`` without also
|
|
setting ``CMAKE_CUDA_COMPILER`` to NVCC.
|