CUPTI User's Guide

More documents

Recommendations

Info

CUPTI_ERROR_NOT_INITIALIZEDCUPTI_ERROR_INVALID_METRIC_IDCUPTI_ERROR_INVALID_PARAMETER if valueSize or value is NULL, or ifattrib is not a metric attributeCUPTI_ERROR_PARAMETER_SIZE_NOT_SUFFICIENT For non-c-stringattribute values, indicates that the value buffer is too small to hold the attributevalue.CUptiResult cuptiMetricGetIdFromName (CUdevice device, constchar ∗ metricName, CUpti_MetricID ∗ metric)Find a metric by name and return the metric ID in ∗metric.Parameters:device The CUDA devicemetricName The name of metric to findmetric Returns the ID of the found metric or undefined if unable to find the metricReturn values:CUPTI_SUCCESSCUPTI_ERROR_NOT_INITIALIZEDCUPTI_ERROR_INVALID_DEVICECUPTI_ERROR_INVALID_METRIC_NAME if unable to find a metric with namemetricName. In this case ∗metric is undefinedCUPTI_ERROR_INVALID_PARAMETER if metricName or metric are NULL.CUptiResult cuptiMetricGetNumEvents (CUpti_MetricID metric,uint32_t ∗ numEvents)Returns the number of events in numEvents that are required to calculate a metric.Parameters:metric ID of the metricnumEvents Returns the number of events required for the metricReturn values:CUPTI_SUCCESSCUPTI_ERROR_NOT_INITIALIZEDCUPTI_ERROR_INVALID_METRIC_IDCUPTI_ERROR_INVALID_PARAMETER if numEvents is NULLCUDA Tools SDK CUPTI User’s Guide DA-05679-001_v01 | 106
CUptiResult cuptiMetricGetValue (CUdevice device,CUpti_MetricID metric, size_t eventIdArraySizeBytes,CUpti_EventID ∗ eventIdArray, size_t eventValueArraySizeBytes,uint64_t ∗ eventValueArray, uint64_t timeDuration,CUpti_MetricValue ∗ metricValue)Use the events collected for a metric to calculate the metric value. Metric value calculationassumes that event values are normalized to represent all domain instances on a device.For the most accurate metric collection, the events required for the metric should becollected for all profiled domain instances. For example, to collect all instances of an event,set the CUPTI_EVENT_GROUP_ATTR_PROFILE_ALL_DOMAIN_INSTANCESattribute on the group containing the event to 1. The normalized value for the event isthen: (sum_event_values ∗ totalInstanceCount) / instanceCount, wheresum_event_values is the summation of the event values across all profiled domaininstances, totalInstanceCount is obtained from queryingCUPTI_EVENT_DOMAIN_ATTR_TOTAL_INSTANCE_COUNT andinstanceCount is obtained from queryingCUPTI_EVENT_GROUP_ATTR_INSTANCE_COUNT (orCUPTI_EVENT_DOMAIN_ATTR_INSTANCE_COUNT).Parameters:device The CUDA device that the metric is being calculated formetric The metric IDeventIdArraySizeBytes The size of eventIdArray in byteseventIdArray The event IDs required to calculate metriceventValueArraySizeBytes The size of eventValueArray in byteseventValueArray The normalized event values required to calculate metric. Thevalues must be order to match the order of events in eventIdArraytimeDuration The duration over which the events were collected, in nsmetricValue Returns the value for the metricReturn values:CUPTI_SUCCESSCUPTI_ERROR_NOT_INITIALIZEDCUPTI_ERROR_INVALID_METRIC_IDCUPTI_ERROR_INVALID_OPERATIONCUPTI_ERROR_PARAMETER_SIZE_NOT_SUFFICIENT if the eventIdArraydoes not contain all the events needed for metricCUPTI_ERROR_INVALID_EVENT_VALUE if any of the event values requiredfor the metric is CUPTI_EVENT_OVERFLOWCUDA Tools SDK CUPTI User’s Guide DA-05679-001_v01 | 107
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 90 and 91: Parameters:device The CUDA deviceev
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 108 and 109: CUPTI_ERROR_INVALID_PARAMETER if me
show all

CUPTI User's Guide

Create successful ePaper yourself

Delete template?

Save as template?