Help: Clarify CMAKE_CUDA_RESOLVE_DEVICE_SYMBOLS behavior

Fixes: #24373
This commit is contained in:
Robert Maynard
2023-01-30 10:34:55 -05:00
parent b96d7418b7
commit 8c57f7b45e
2 changed files with 10 additions and 3 deletions

View File

@@ -14,8 +14,13 @@ executable is generated, allowing for multiple static libraries to resolve
device symbols at the same time when they are used by a shared library or
executable.
By default static library targets have this property is disabled,
while shared, module, and executable targets have this property enabled.
If this property or :variable:`CMAKE_CUDA_RESOLVE_DEVICE_SYMBOLS` is unset,
static libraries are treated as if it is disabled while shared, module,
and executable targets behave as if it is on.
If :variable:`CMAKE_CUDA_RESOLVE_DEVICE_SYMBOLS` has been defined,
this property is initialized to the value the variable and overriding
the default behavior.
Note that device linking is not supported for :ref:`Object Libraries`.

View File

@@ -4,5 +4,7 @@ CMAKE_CUDA_RESOLVE_DEVICE_SYMBOLS
.. versionadded:: 3.16
Default value for :prop_tgt:`CUDA_RESOLVE_DEVICE_SYMBOLS` target
property. This variable is used to initialize the property on each target as
property when defined. By default this variable is not defined.
This variable is used to initialize the property on each target as
it is created.