rapids_cpm_nvtx3

Added in version v24.06.00.

Allow projects to find nvtx3 via CPM with built-in tracking of dependencies for correct export support.

Uses the version of nvtx3 specified in the version file for consistency across all RAPIDS projects.

rapids_cpm_nvtx3( [BUILD_EXPORT_SET <export-name>]
                  [INSTALL_EXPORT_SET <export-name>]
                  [EXCLUDE_FROM_ALL]
                  [<CPM_ARGS> ...])

BUILD_EXPORT_SET: Record that a CPMFindPackage() for nvtx3 is required in our build directory export set.
INSTALL_EXPORT_SET: Record that a find_dependency() for nvtx3 is required in our install directory export set.

Note

Installation of nvtx3 will occur if an INSTALL_EXPORT_SET is provided, and nvtx3 is added to the project via add_subdirectory by CPM.

EXCLUDE_FROM_ALL: When provided, marks the package as excluded from the install() target. This overrides the default value from the versions.json configuration. When EXCLUDE_FROM_ALL is specified alongside INSTALL_EXPORT_SET, the package will not be installed.
CPM_ARGS: Any arguments after CPM_ARGS will be forwarded to the underlying nvtx3 CPMFindPackage`() call

Result Targets

nvtx3::nvtx3-c, nvtx3::nvtx3-cpp targets will be created

Result Variables

nvtx3_SOURCE_DIR is set to the path to the source directory of nvtx3. nvtx3_BINARY_DIR is set to the path to the build directory of nvtx3. nvtx3_ADDED is set to a true value if nvtx3 has not been added before. nvtx3_VERSION is set to the version of nvtx3 specified by the versions.json.