Limitations#

Known Issues#

Decoding of NVTX annotations with extended payloads (used by libraries like NCCL) is not supported by CUPTI Python.

Known Limitations#

CUPTI Python cannot collect tracing data when the Python interpreter is tearing down or is not in a proper state. The callbacks registered by functions cupti.cupti.activity_register_callbacks(), cupti.cupti.activity_register_timestamp_callback(), cupti.cupti.subscribe(), and cupti.cupti.subscribe_v2() will not be dispatched in such cases. For example, CUDA API calls that occur in a class’s __del__ method will not be traced.

CUPTI Python does not support the following CUDA Runtime API function parameter class members:

Python Class	Member
`cupti.cupti.CudaMalloc3DV3020Params`	`extent`
`cupti.cupti.CudaMalloc3DArrayV3020Params`	`extent`
`cupti.cupti.CudaMallocMipmappedArrayV5000Params`	`extent`
`cupti.cupti.CudaMemset3DV3020Params`	`pitched_dev_ptr`
`cupti.cupti.CudaMemset3DV3020Params`	`extent`
`cupti.cupti.CudaMemset3DPtdsV7000Params`	`pitched_dev_ptr`
`cupti.cupti.CudaMemset3DPtdsV7000Params`	`extent`
`cupti.cupti.CudaMemset3DAsyncV3020Params`	`pitched_dev_ptr`
`cupti.cupti.CudaMemset3DAsyncV3020Params`	`extent`
`cupti.cupti.CudaMemset3DAsyncPtszV7000Params`	`pitched_dev_ptr`
`cupti.cupti.CudaMemset3DAsyncPtszV7000Params`	`extent`
`cupti.cupti.CudaMemAdviseV12020Params`	`location`
`cupti.cupti.CudaMemPrefetchAsyncV12020Params`	`location`
`cupti.cupti.CudaMemPrefetchAsyncPtszV12020Params`	`location`

CUPTI Python does not support the following CUDA Driver API function parameter class members:

Python Class	Member
`cupti.cupti.CuIpcOpenEventHandleParams`	`handle`
`cupti.cupti.CuIpcOpenMemHandleParams`	`handle`
`cupti.cupti.CuIpcOpenMemHandleV2Params`	`handle`
`cupti.cupti.CuMemAdviseV2Params`	`location`
`cupti.cupti.CuMemPrefetchAsyncV2Params`	`location`
`cupti.cupti.CuMemPrefetchAsyncV2PtszParams`	`location`