CUPTI User's Guide

CUPTIThe CUDA Profiling Tools Interface (CUPTI) enables the creation of profiling and tracingtools that target CUDA applications. CUPTI provides four APIs, the Activity API, theCallback API, the Event API, and the Metric API. Using these APIs, you can developprofiling tools that give insight into the CPU and GPU behavior of CUDA applications.CUPTI is delivered as a dynamic library on all platforms supported by CUDA.CUPTI Compatibility and RequirementsNew versions of the CUDA driver are backwards compatible with older versions of CUPTI.For example, a developer using a profiling tool based on CUPTI 4.0 can update theirCUDA driver to 4.1. However, new versions of CUPTI are not backwards compatible witholder versions of the CUDA driver. For example, a developer using a profiling tool basedon CUPTI 4.1 must have the 4.1 version of the CUDA driver (or later) installed as well.CUPTI calls will fail with CUPTI_ERROR_NOT_INITIALIZED if the CUDA driver version isnot compatible with the CUPTI version.CUPTI InitializationCUPTI initialization occurs lazily the first time you invoke any CUPTI function. The theEvent, Metric, and Callback APIs there are no requirements on when this initializationmust occur (i.e. you can invoke the first CUPTI function at any point). For correctoperation, the Activity API does require that CUPTI be initialized before any CUDAdriver or runtime API is invoked. See the CUPTI Activity API section for moreinformation on CUPTI initialization requirements for the activity API.CUDA Tools SDK CUPTI User’s Guide DA-05679-001_v01 | 3