CUPTI User's Guide

More documents

Recommendations

Info

Parameters:device The CUDA deviceeventName The name of the event to findevent Returns the ID of the found event or undefined if unable to find the eventReturn values:CUPTI_SUCCESSCUPTI_ERROR_NOT_INITIALIZEDCUPTI_ERROR_INVALID_DEVICECUPTI_ERROR_INVALID_EVENT_NAME if unable to find an event with nameeventName. In this case ∗event is undefinedCUPTI_ERROR_INVALID_PARAMETER if eventName or event are NULLCUptiResult cuptiEventGroupAddEvent (CUpti_EventGroupeventGroup, CUpti_EventID event)Add an event to an event group. The event add can fail for a number of reasons:◮ The event group is enabled◮ The event does not belong to the same event domain as the events that are alreadyin the event group◮ Device limitations on the events that can belong to the same group◮ The event group is fullParameters:eventGroup The event groupevent The event to add to the groupReturn values:CUPTI_SUCCESSCUPTI_ERROR_NOT_INITIALIZEDCUPTI_ERROR_INVALID_EVENT_IDCUPTI_ERROR_OUT_OF_MEMORYCUPTI_ERROR_INVALID_OPERATION if eventGroup is enabledCUPTI_ERROR_NOT_COMPATIBLE if event belongs to a different eventdomain than the events already in eventGroup, or if a device limitation preventsevent from being collected at the same time as the events already in eventGroupCUPTI_ERROR_MAX_LIMIT_REACHED if eventGroup is fullCUPTI_ERROR_INVALID_PARAMETER if eventGroup is NULLCUDA Tools SDK CUPTI User’s Guide DA-05679-001_v01 | 90
CUptiResult cuptiEventGroupCreate (CUcontext context,CUpti_EventGroup ∗ eventGroup, uint32_t flags)Creates a new event group for context and returns the new group in ∗eventGroup.Note:flags are reserved for future use and should be set to zero.Parameters:context The context for the event groupeventGroup Returns the new event groupflags Reserved - must be zeroReturn values:CUPTI_SUCCESSCUPTI_ERROR_NOT_INITIALIZEDCUPTI_ERROR_INVALID_CONTEXTCUPTI_ERROR_OUT_OF_MEMORYCUPTI_ERROR_INVALID_PARAMETER if eventGroup is NULLCUptiResult cuptiEventGroupDestroy (CUpti_EventGroupeventGroup)Destroy an eventGroup and free its resources. An event group cannot be destroyed if it isenabled.Parameters:eventGroup The event group to destroyReturn values:CUPTI_SUCCESSCUPTI_ERROR_NOT_INITIALIZEDCUPTI_ERROR_INVALID_OPERATION if the event group is enabledCUPTI_ERROR_INVALID_PARAMETER if eventGroup is NULLCUptiResult cuptiEventGroupDisable (CUpti_EventGroupeventGroup)Disable an event group. Disabling an event group stops collection of events contained inthe group.CUDA Tools SDK CUPTI User’s Guide DA-05679-001_v01 | 91
Page 1 and 2:
CUDA Tools SDKCUPTI User’s GuideD
Page 3 and 4:
CUPTIThe CUDA Profiling Tools Inter
Page 5 and 6:
CUPTI_CBID_RESOURCE_CONTEXT_CREATED
Page 7 and 8:
twice each time any of the CUDA run
Page 9 and 10:
device-specific limits. At any give
Page 11 and 12:
Sampling EventsThe event API can al
Page 13:
CapabilityEvent Name Description Ty
Page 16 and 17:
Page 18 and 19:
Page 20:
Page 26 and 27:
CUPTI ReferenceCUPTI VersionDefines
Page 28 and 29:
CUPTI Result CodesEnumerations◮ e
Page 30 and 31:
CUPTI_ERROR_INVALID_METRIC_IDCUPTI_
Page 32 and 33:
CUPTI_ACTIVITY_COMPUTE_API_OPENCL =
Page 34 and 35:
size_t ∗validBufferSizeBytes)Quer
Page 36 and 37:
CUPTI_ACTIVITY_MEMCPY_KIND_HTOAcopy
Page 38 and 39:
CUptiResult cuptiActivityEnqueueBuf
Page 40 and 41: CUptiResult cuptiActivityGetNumDrop
Page 42 and 43: CUpti_Activity Type ReferenceThe ba
Page 44 and 45: CUpti_ActivityKind CUpti_ActivityAP
Page 46 and 47: Detailed DescriptionThis activity r
Page 48 and 49: uint32_t CUpti_ActivityDevice::maxI
Page 50 and 51: uint64_t CUpti_ActivityEvent::value
Page 52 and 53: Field Documentationint32_t CUpti_Ac
Page 54 and 55: uint16_t CUpti_ActivityKernel::regi
Page 56 and 57: uint8_t CUpti_ActivityMemcpy::copyK
Page 58 and 59: CUpti_ActivityMemset Type Reference
Page 60 and 61: CUpti_ActivityMetric Type Reference
Page 62 and 63: CUPTI Callback APIData Structures
Page 64 and 65: Enable or disabled all callbacks fo
Page 66 and 67: Enumerator:CUPTI_CBID_RESOURCE_INVA
Page 68 and 69: Parameters:enable New enable state
Page 70 and 71: CUptiResult cuptiUnsubscribe (CUpti
Page 72 and 73: context.uint32_t CUpti_CallbackData
Page 74 and 75: CUpti_ResourceData Type ReferenceDa
Page 76 and 77: CUPTI Event APIData Structures◮ s
Page 78 and 79: CUPTI_EVENT_GROUP_ATTR_NUM_EVENTS =
Page 80 and 81: ∗eventValueBuffer, size_t ∗even
Page 82 and 83: CUPTI_DEVICE_ATTR_MAX_EVENT_DOMAIN_
Page 84 and 85: CUPTI_EVENT_GROUP_ATTR_PROFILE_ALL_
Page 86 and 87: valueSize The size of the value buf
Page 88 and 89: Return values:CUPTI_SUCCESSCUPTI_ER
Page 92 and 93: Parameters:eventGroup The event gro
Page 94 and 95: flags Flags controlling the reading
Page 96 and 97: Return values:CUPTI_SUCCESSCUPTI_ER
Page 98 and 99: CUPTI_ERROR_INVALID_OPERATION if an
Page 100 and 101: CUPTI_METRIC_VALUE_KIND_PERCENT = 2
Page 102 and 103: enum CUpti_MetricCategoryEach metri
Page 104 and 105: metricArray Returns the IDs of the
Page 106 and 107: CUPTI_ERROR_NOT_INITIALIZEDCUPTI_ER
Page 108 and 109: CUPTI_ERROR_INVALID_PARAMETER if me
show all

CUPTI User's Guide

Create successful ePaper yourself

Delete template?

Save as template?