From d4298f7794c4e0d7367e0743f08a5386dcf39f6e Mon Sep 17 00:00:00 2001 From: Marcos Slomp Date: Mon, 1 Jun 2026 11:06:59 -0700 Subject: [PATCH 1/3] document CUDA version --- manual/tracy.tex | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/manual/tracy.tex b/manual/tracy.tex index ec007ed6..f1344904 100644 --- a/manual/tracy.tex +++ b/manual/tracy.tex @@ -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 tooklkit (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. From cbad012980cefe9b5dc1e369f4c9696effe701aa Mon Sep 17 00:00:00 2001 From: Marcos Slomp Date: Mon, 1 Jun 2026 11:09:01 -0700 Subject: [PATCH 2/3] typo --- manual/tracy.tex | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/manual/tracy.tex b/manual/tracy.tex index f1344904..014dcbfb 100644 --- a/manual/tracy.tex +++ b/manual/tracy.tex @@ -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, make sure you have the NVIDIA CUDA Toolkit v12.8 (or later) installed, and that the NVIDIA CUPTI library is available in the tooklkit (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. From 21b9f50cea6b3894b9b5c0c4b0511dbede08f9ba Mon Sep 17 00:00:00 2001 From: Marcos Slomp Date: Mon, 1 Jun 2026 11:25:40 -0700 Subject: [PATCH 3/3] CUDA version check --- public/tracy/TracyCUDA.hpp | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/public/tracy/TracyCUDA.hpp b/public/tracy/TracyCUDA.hpp index 132e1564..7a297146 100644 --- a/public/tracy/TracyCUDA.hpp +++ b/public/tracy/TracyCUDA.hpp @@ -19,6 +19,10 @@ using CUDACtx = std::nullptr_t; #else #include +#if CUDA_VERSION < 12080 +#error "CUDA v12.8 (or later) is required by TracyCUDA.hpp" +#endif + #include #include #include