Merge pull request #1379 from wolfpld/slomp/cuda-version-doc

Document and check for required CUDA version
This commit is contained in:
Bartosz Taudul
2026-06-01 22:21:40 +02:00
committed by GitHub
2 changed files with 5 additions and 1 deletions

View File

@@ -1773,7 +1773,7 @@ Similar to Vulkan and OpenGL, you also need to periodically collect the OpenCL e
\subsubsection{CUDA}
CUDA support is enabled by including the \texttt{public/tracy/TracyCUDA.hpp} header file. To use it, the NVIDIA CUPTI library is required. This library comes with the NVIDIA CUDA Toolkit and is located at \texttt{CUDA\_INSTALLATION\_PATH/extras/CUPTI}.
CUDA support is enabled by including the \texttt{public/tracy/TracyCUDA.hpp} header file. To use it, make sure you have the NVIDIA CUDA Toolkit v12.8 (or later) installed, and that the NVIDIA CUPTI library is available in the toolkit (located at \texttt{CUDA\_INSTALLATION\_PATH/extras/CUPTI}).
Tracing CUDA requires the creation of a Tracy CUDA context using the macro \texttt{TracyCUDAContext()}, which returns an instance of a \texttt{tracy::CUDACtx} object. TracyCUDA allows only a single \texttt{tracy::CUDACtx} object at any given time. Subsequent calls to \texttt{TracyCUDAContext()} will return the same reference-counted object. There is no need for clients to instantiate multiple \texttt{tracy::CUDACtx} objects, as a single context is capable of instrumenting all CUDA contexts and streams.

View File

@@ -19,6 +19,10 @@ using CUDACtx = std::nullptr_t;
#else
#include <cupti.h>
#if CUDA_VERSION < 12080
#error "CUDA v12.8 (or later) is required by TracyCUDA.hpp"
#endif
#include <cassert>
#include <cmath>
#include <string>