Cupti: CUpti_ActivityKernel3 Struct Reference

# CUpti_ActivityKernel3 Struct Reference
[CUPTI Activity API]

The activity record for a kernel (CUDA 6.5(with sm_52 support) onwards). (deprecated in CUDA 9.0). More...

## Data Fields
int32_t | blockX
int32_t | blockY
int32_t | blockZ
uint64_t | completed
uint32_t | contextId
uint32_t | correlationId
uint32_t | deviceId
int32_t | dynamicSharedMemory
uint64_t | end
int64_t | gridId
int32_t | gridX
int32_t | gridY
int32_t | gridZ
CUpti_ActivityKind | kind
uint32_t | localMemoryPerThread
uint32_t | localMemoryTotal
const char * | name
CUpti_ActivityPartitionedGlobalCacheConfig | partitionedGlobalCacheExecuted
CUpti_ActivityPartitionedGlobalCacheConfig | partitionedGlobalCacheRequested
uint16_t | registersPerThread
void * | reserved0
uint8_t | sharedMemoryConfig
uint64_t | start
int32_t | staticSharedMemory
uint32_t | streamId
uint8_t | executed:4
uint8_t | requested:4

## Detailed Description

This activity record represents a kernel execution (CUPTI_ACTIVITY_KIND_KERNEL and CUPTI_ACTIVITY_KIND_CONCURRENT_KERNEL). Kernel activities are now reported using the CUpti_ActivityKernel8 activity record.

## Field Documentation

int32_t CUpti_ActivityKernel3::blockX

The X-dimension block size for the kernel.

int32_t CUpti_ActivityKernel3::blockY

The Y-dimension block size for the kernel.

int32_t CUpti_ActivityKernel3::blockZ

The Z-dimension grid size for the kernel.

uint64_t CUpti_ActivityKernel3::completed

The completed timestamp for the kernel execution, in ns. It represents the completion of all it's child kernels and the kernel itself. A value of CUPTI_TIMESTAMP_UNKNOWN indicates that the completion time is unknown.

uint32_t CUpti_ActivityKernel3::contextId

The ID of the context where the kernel is executing.

uint32_t CUpti_ActivityKernel3::correlationId

The correlation ID of the kernel. Each kernel execution is assigned a unique correlation ID that is identical to the correlation ID in the driver or runtime API activity record that launched the kernel.

uint32_t CUpti_ActivityKernel3::deviceId

The ID of the device where the kernel is executing.

int32_t CUpti_ActivityKernel3::dynamicSharedMemory

The dynamic shared memory reserved for the kernel, in bytes.

uint64_t CUpti_ActivityKernel3::end

The end timestamp for the kernel execution, in ns. A value of 0 for both the start and end timestamps indicates that timestamp information could not be collected for the kernel.

uint8_t CUpti_ActivityKernel3::executed

The cache configuration used for the kernel. The value is one of the CUfunc_cache enumeration values from cuda.h.

int64_t CUpti_ActivityKernel3::gridId

The grid ID of the kernel. Each kernel is assigned a unique grid ID at runtime.

int32_t CUpti_ActivityKernel3::gridX

The X-dimension grid size for the kernel.

int32_t CUpti_ActivityKernel3::gridY

The Y-dimension grid size for the kernel.

int32_t CUpti_ActivityKernel3::gridZ

The Z-dimension grid size for the kernel.

CUpti_ActivityKind CUpti_ActivityKernel3::kind

The activity record kind, must be CUPTI_ACTIVITY_KIND_KERNEL or CUPTI_ACTIVITY_KIND_CONCURRENT_KERNEL.

uint32_t CUpti_ActivityKernel3::localMemoryPerThread

The amount of local memory reserved for each thread, in bytes.

uint32_t CUpti_ActivityKernel3::localMemoryTotal

The total amount of local memory reserved for the kernel, in bytes.

const char* CUpti_ActivityKernel3::name

The name of the kernel. This name is shared across all activity records representing the same kernel, and so should not be modified.

CUpti_ActivityPartitionedGlobalCacheConfig CUpti_ActivityKernel3::partitionedGlobalCacheExecuted

The partitioned global caching executed for the kernel. Partitioned global caching is required to enable caching on certain chips, such as devices with compute capability 5.2. Partitioned global caching can be automatically disabled if the occupancy requirement of the launch cannot support caching.

CUpti_ActivityPartitionedGlobalCacheConfig CUpti_ActivityKernel3::partitionedGlobalCacheRequested

The partitioned global caching requested for the kernel. Partitioned global caching is required to enable caching on certain chips, such as devices with compute capability 5.2.

uint16_t CUpti_ActivityKernel3::registersPerThread

The number of registers required for each thread executing the kernel.

uint8_t CUpti_ActivityKernel3::requested

The cache configuration requested by the kernel. The value is one of the CUfunc_cache enumeration values from cuda.h.

void* CUpti_ActivityKernel3::reserved0

Undefined. Reserved for internal use.

uint8_t CUpti_ActivityKernel3::sharedMemoryConfig

The shared memory configuration used for the kernel. The value is one of the CUsharedconfig enumeration values from cuda.h.

uint64_t CUpti_ActivityKernel3::start

The start timestamp for the kernel execution, in ns. A value of 0 for both the start and end timestamps indicates that timestamp information could not be collected for the kernel.

int32_t CUpti_ActivityKernel3::staticSharedMemory

The static shared memory allocated for the kernel, in bytes.

uint32_t CUpti_ActivityKernel3::streamId

The ID of the stream where the kernel is executing.