1CMAKE_CUDA_RUNTIME_LIBRARY
2--------------------------
3
4.. versionadded:: 3.17
5
6Select the CUDA runtime library for use when compiling and linking CUDA.
7This variable is used to initialize the :prop_tgt:`CUDA_RUNTIME_LIBRARY`
8property on all targets as they are created.
9
10The allowed case insensitive values are:
11
12.. include:: ../prop_tgt/CUDA_RUNTIME_LIBRARY-VALUES.txt
13
14Contents of ``CMAKE_CUDA_RUNTIME_LIBRARY`` may use
15:manual:`generator expressions <cmake-generator-expressions(7)>`.
16
17If this variable is not set then the :prop_tgt:`CUDA_RUNTIME_LIBRARY` target
18property will not be set automatically.  If that property is not set then
19CMake uses an appropriate default value based on the compiler to select the
20CUDA runtime library.
21
22.. note::
23
24  This property has effect only when the ``CUDA`` language is enabled. To
25  control the CUDA runtime linking when only using the CUDA SDK with the
26  ``C`` or ``C++`` language we recommend using the :module:`FindCUDAToolkit`
27  module.
28