Overview¶
CUPTI Python supports a subset of CUPTI C Activity and Callback APIs.
The following CUPTI APIs are not supported:
Host Profiling
Range Profiling
PC Sampling
SASS Metrics
PM Sampling
Profiling
Event
Metric
Checkpoint
The CUPTI Python APIs are implemented as wrappers over the corresponding CUPTI C APIs.
The CUPTI Python APIs use snake case naming (lower case and words separated by underscore). e.g. activity_enable. While the CUPTI C APIs use camel case naming (first character of word is upper case). e.g. cuptiActivityEnable .
Refer the CUPTI C document for details.
Supported CUPTI Activities¶
Each supported CUPTI Activity Struct corresponds to an equivalent Python class. The activity records are returned through the func_buffer_completed callback as corresponding Python objects. To identify the type of activity record represented by the Python object, refer to the kind field. The table below links each supported Activity Kind to its corresponding Activity Record and equivalent Python class.
Supported Activity Kinds |
Activity Record |
Python Class |
|
|---|---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Supported CUPTI Callback Domains¶
Only the following subset of CUPTI Callback Domains defined in enum CUpti_CallbackDomain from the CUPTI C header file cupti_callbacks.h are supported :
CUPTI_CB_DOMAIN_DRIVER_APICUPTI_CB_DOMAIN_RESOURCECUPTI_CB_DOMAIN_SYNCHRONIZECUPTI_CB_DOMAIN_STATE