Logo
  • CUPTI
  • Overview
  • 1. Release Notes
  • 2. Usage
  • 3. Library support
  • 4. Special Configurations
  • 5. Modules
  • 6. Data Structures
    • 6.1. CUpti_Activity
    • 6.2. CUpti_ActivityAPI
    • 6.3. CUpti_ActivityAutoBoostState
    • 6.4. CUpti_ActivityBranch
    • 6.5. CUpti_ActivityBranch2
    • 6.6. CUpti_ActivityCdpKernel
    • 6.7. CUpti_ActivityConfidentialComputeRotation
    • 6.8. CUpti_ActivityContext
    • 6.9. CUpti_ActivityContext2
    • 6.10. CUpti_ActivityContext3
    • 6.11. CUpti_ActivityCudaEvent
    • 6.12. CUpti_ActivityCudaEvent2
    • 6.13. CUpti_ActivityDevice
    • 6.14. CUpti_ActivityDevice2
    • 6.15. CUpti_ActivityDevice3
    • 6.16. CUpti_ActivityDevice4
    • 6.17. CUpti_ActivityDevice5
    • 6.18. CUpti_ActivityDeviceAttribute
    • 6.19. CUpti_ActivityDeviceGraphTrace
    • 6.20. CUpti_ActivityEnvironment
    • 6.21. CUpti_ActivityEvent
    • 6.22. CUpti_ActivityEventInstance
    • 6.23. CUpti_ActivityExternalCorrelation
    • 6.24. CUpti_ActivityFunction
    • 6.25. CUpti_ActivityGlobalAccess
    • 6.26. CUpti_ActivityGlobalAccess2
    • 6.27. CUpti_ActivityGlobalAccess3
    • 6.28. CUpti_ActivityGraphTrace
    • 6.29. CUpti_ActivityGraphTrace2
    • 6.30. CUpti_ActivityInstantaneousEvent
    • 6.31. CUpti_ActivityInstantaneousEventInstance
    • 6.32. CUpti_ActivityInstantaneousMetric
    • 6.33. CUpti_ActivityInstantaneousMetricInstance
    • 6.34. CUpti_ActivityInstructionCorrelation
    • 6.35. CUpti_ActivityInstructionExecution
    • 6.36. CUpti_ActivityJit
    • 6.37. CUpti_ActivityJit2
    • 6.38. CUpti_ActivityKernel
    • 6.39. CUpti_ActivityKernel2
    • 6.40. CUpti_ActivityKernel3
    • 6.41. CUpti_ActivityKernel4
    • 6.42. CUpti_ActivityKernel5
    • 6.43. CUpti_ActivityKernel6
    • 6.44. CUpti_ActivityKernel7
    • 6.45. CUpti_ActivityKernel8
    • 6.46. CUpti_ActivityKernel9
    • 6.47. CUpti_ActivityMarker
    • 6.48. CUpti_ActivityMarker2
    • 6.49. CUpti_ActivityMarkerData
    • 6.50. CUpti_ActivityMemDecompress
    • 6.51. CUpti_ActivityMemcpy
    • 6.52. CUpti_ActivityMemcpy3
    • 6.53. CUpti_ActivityMemcpy4
    • 6.54. CUpti_ActivityMemcpy5
    • 6.55. CUpti_ActivityMemcpy6
    • 6.56. CUpti_ActivityMemcpyPtoP
    • 6.57. CUpti_ActivityMemcpyPtoP2
    • 6.58. CUpti_ActivityMemcpyPtoP3
    • 6.59. CUpti_ActivityMemcpyPtoP4
    • 6.60. CUpti_ActivityMemory
    • 6.61. CUpti_ActivityMemory2
    • 6.62. CUpti_ActivityMemory3
    • 6.63. CUpti_ActivityMemory4
    • 6.64. CUpti_ActivityMemoryPool
    • 6.65. CUpti_ActivityMemoryPool2
    • 6.66. CUpti_ActivityMemset
    • 6.67. CUpti_ActivityMemset2
    • 6.68. CUpti_ActivityMemset3
    • 6.69. CUpti_ActivityMemset4
    • 6.70. CUpti_ActivityMetric
    • 6.71. CUpti_ActivityMetricInstance
    • 6.72. CUpti_ActivityModule
    • 6.73. CUpti_ActivityName
    • 6.74. CUpti_ActivityNvLink
    • 6.75. CUpti_ActivityNvLink2
    • 6.76. CUpti_ActivityNvLink3
    • 6.77. CUpti_ActivityNvLink4
    • 6.78. CUpti_ActivityObjectKindId
    • 6.79. CUpti_ActivityOpenAcc
    • 6.80. CUpti_ActivityOpenAccData
    • 6.81. CUpti_ActivityOpenAccLaunch
    • 6.82. CUpti_ActivityOpenAccOther
    • 6.83. CUpti_ActivityOpenMp
    • 6.84. CUpti_ActivityOverhead
    • 6.85. CUpti_ActivityOverhead2
    • 6.86. CUpti_ActivityOverhead3
    • 6.87. CUpti_ActivityOverheadCommandBufferFullData
    • 6.88. CUpti_ActivityPCSampling
    • 6.89. CUpti_ActivityPCSampling2
    • 6.90. CUpti_ActivityPCSampling3
    • 6.91. CUpti_ActivityPCSamplingConfig
    • 6.92. CUpti_ActivityPCSamplingRecordInfo
    • 6.93. CUpti_ActivityPcie
    • 6.94. CUpti_ActivityPreemption
    • 6.95. CUpti_ActivitySharedAccess
    • 6.96. CUpti_ActivitySourceLocator
    • 6.97. CUpti_ActivityStream
    • 6.98. CUpti_ActivitySynchronization
    • 6.99. CUpti_ActivitySynchronization2
    • 6.100. CUpti_ActivityUnifiedMemoryCounter
    • 6.101. CUpti_ActivityUnifiedMemoryCounter2
    • 6.102. CUpti_ActivityUnifiedMemoryCounter3
    • 6.103. CUpti_ActivityUnifiedMemoryCounterConfig
    • 6.104. CUpti_CallbackData
    • 6.105. CUpti_EventGroupSet
    • 6.106. CUpti_EventGroupSets
    • 6.107. CUpti_GetCubinCrcParams
    • 6.108. CUpti_GetSassToSourceCorrelationParams
    • 6.109. CUpti_GraphData
    • 6.110. CUpti_MetricValue
    • 6.111. CUpti_ModuleResourceData
    • 6.112. CUpti_NvtxData
    • 6.113. CUpti_PCSamplingConfigurationInfo
    • 6.114. CUpti_PCSamplingConfigurationInfoParams
    • 6.115. CUpti_PCSamplingData
    • 6.116. CUpti_PCSamplingDisableParams
    • 6.117. CUpti_PCSamplingEnableParams
    • 6.118. CUpti_PCSamplingGetDataParams
    • 6.119. CUpti_PCSamplingGetNumStallReasonsParams
    • 6.120. CUpti_PCSamplingGetStallReasonsParams
    • 6.121. CUpti_PCSamplingPCData
    • 6.122. CUpti_PCSamplingStallReason
    • 6.123. CUpti_PCSamplingStartParams
    • 6.124. CUpti_PCSamplingStopParams
    • 6.125. CUpti_PmSampling_CounterDataImage_Initialize_Params
    • 6.126. CUpti_PmSampling_CounterData_GetSampleInfo_Params
    • 6.127. CUpti_PmSampling_DecodeData_Params
    • 6.128. CUpti_PmSampling_Disable_Params
    • 6.129. CUpti_PmSampling_Enable_Params
    • 6.130. CUpti_PmSampling_GetCounterAvailability_Params
    • 6.131. CUpti_PmSampling_GetCounterDataInfo_Params
    • 6.132. CUpti_PmSampling_GetCounterDataSize_Params
    • 6.133. CUpti_PmSampling_SetConfig_Params
    • 6.134. CUpti_PmSampling_Start_Params
    • 6.135. CUpti_PmSampling_Stop_Params
    • 6.136. CUpti_Profiler_BeginPass_Params
    • 6.137. CUpti_Profiler_BeginSession_Params
    • 6.138. CUpti_Profiler_CounterDataImageOptions
    • 6.139. CUpti_Profiler_CounterDataImage_CalculateScratchBufferSize_Params
    • 6.140. CUpti_Profiler_CounterDataImage_CalculateSize_Params
    • 6.141. CUpti_Profiler_CounterDataImage_InitializeScratchBuffer_Params
    • 6.142. CUpti_Profiler_CounterDataImage_Initialize_Params
    • 6.143. CUpti_Profiler_DeInitialize_Params
    • 6.144. CUpti_Profiler_DeviceSupported_Params
    • 6.145. CUpti_Profiler_DisableProfiling_Params
    • 6.146. CUpti_Profiler_EnableProfiling_Params
    • 6.147. CUpti_Profiler_EndPass_Params
    • 6.148. CUpti_Profiler_EndSession_Params
    • 6.149. CUpti_Profiler_FlushCounterData_Params
    • 6.150. CUpti_Profiler_GetCounterAvailability_Params
    • 6.151. CUpti_Profiler_Host_ConfigAddMetrics_Params
    • 6.152. CUpti_Profiler_Host_Deinitialize_Params
    • 6.153. CUpti_Profiler_Host_EvaluateToGpuValues_Params
    • 6.154. CUpti_Profiler_Host_GetBaseMetrics_Params
    • 6.155. CUpti_Profiler_Host_GetConfigImageSize_Params
    • 6.156. CUpti_Profiler_Host_GetConfigImage_Params
    • 6.157. CUpti_Profiler_Host_GetMaxNumHardwareMetricsPerPass_Params
    • 6.158. CUpti_Profiler_Host_GetMetricProperties_Params
    • 6.159. CUpti_Profiler_Host_GetNumOfPasses_Params
    • 6.160. CUpti_Profiler_Host_GetRangeName_Params
    • 6.161. CUpti_Profiler_Host_GetSubMetrics_Params
    • 6.162. CUpti_Profiler_Host_GetSupportedChips_Params
    • 6.163. CUpti_Profiler_Host_Initialize_Params
    • 6.164. CUpti_Profiler_Initialize_Params
    • 6.165. CUpti_Profiler_IsPassCollected_Params
    • 6.166. CUpti_Profiler_PopRange_Params
    • 6.167. CUpti_Profiler_PushRange_Params
    • 6.168. CUpti_Profiler_SetConfig_Params
    • 6.169. CUpti_Profiler_UnsetConfig_Params
    • 6.170. CUpti_RangeProfiler_CounterDataImage_Initialize_Params
    • 6.171. CUpti_RangeProfiler_CounterData_GetRangeInfo_Params
    • 6.172. CUpti_RangeProfiler_DecodeData_Params
    • 6.173. CUpti_RangeProfiler_Disable_Params
    • 6.174. CUpti_RangeProfiler_Enable_Params
    • 6.175. CUpti_RangeProfiler_GetCounterDataInfo_Params
    • 6.176. CUpti_RangeProfiler_GetCounterDataSize_Params
    • 6.177. CUpti_RangeProfiler_PopRange_Params
    • 6.178. CUpti_RangeProfiler_PushRange_Params
    • 6.179. CUpti_RangeProfiler_SetConfig_Params
    • 6.180. CUpti_RangeProfiler_Start_Params
    • 6.181. CUpti_RangeProfiler_Stop_Params
    • 6.182. CUpti_ResourceData
    • 6.183. CUpti_SassMetricsDisable_Params
    • 6.184. CUpti_SassMetricsEnable_Params
    • 6.185. CUpti_SassMetricsFlushData_Params
    • 6.186. CUpti_SassMetricsGetDataProperties_Params
    • 6.187. CUpti_SassMetricsSetConfig_Params
    • 6.188. CUpti_SassMetricsUnsetConfig_Params
    • 6.189. CUpti_SassMetrics_Config
    • 6.190. CUpti_SassMetrics_Data
    • 6.191. CUpti_SassMetrics_GetMetrics_Params
    • 6.192. CUpti_SassMetrics_GetNumOfMetrics_Params
    • 6.193. CUpti_SassMetrics_GetProperties_Params
    • 6.194. CUpti_SassMetrics_InstanceValue
    • 6.195. CUpti_SassMetrics_MetricDetails
    • 6.196. CUpti_StateData
    • 6.197. CUpti_StreamAttrData
    • 6.198. CUpti_SynchronizeData
  • 7. Namespaces
  • Copyright and Licenses
  • Notices
Cupti
  • »
  • 6. Data Structures »
  • 6.74. CUpti_ActivityNvLink
  • v2025.2.0 | Archive  

6.74. CUpti_ActivityNvLink

struct CUpti_ActivityNvLink

NVLink information.

(deprecated in CUDA 9.0)

This structure gives capabilities of each logical NVLink connection between two devices, gpu<->gpu or gpu<->CPU which can be used to understand the topology. NVLink information are now reported using the CUpti_ActivityNvLink2 activity record.

Public Members

CUpti_ActivityKind kind

The activity record kind, must be CUPTI_ACTIVITY_KIND_NVLINK.

uint32_t nvlinkVersion

NVLink version.

CUpti_DevType typeDev0

Type of device 0 CUpti_DevType.

CUpti_DevType typeDev1

Type of device 1 CUpti_DevType.

uint32_t index

Index of the NPU.

First index will always be zero.

uint32_t domainId

Domain ID of NPU.

On Linux, this can be queried using lspci.

union CUpti_ActivityNvLink::[anonymous] idDev0

If typeDev0 is CUPTI_DEV_TYPE_GPU, UUID for device 0.

CUpti_ActivityDevice5. If typeDev0 is CUPTI_DEV_TYPE_NPU, struct npu for NPU.

union CUpti_ActivityNvLink::[anonymous] idDev1

If typeDev1 is CUPTI_DEV_TYPE_GPU, UUID for device 1.

CUpti_ActivityDevice5. If typeDev1 is CUPTI_DEV_TYPE_NPU, struct npu for NPU.

uint32_t flag

Flag gives capabilities of the link.

See also

CUpti_LinkFlag

uint32_t physicalNvLinkCount

Number of physical NVLinks present between two devices.

int8_t portDev0[4]

Port numbers for maximum 4 NVLinks connected to device 0.

If typeDev0 is CUPTI_DEV_TYPE_NPU, ignore this field. In case of invalid/unknown port number, this field will be set to value CUPTI_NVLINK_INVALID_PORT. This will be used to correlate the metric values to individual physical link and attribute traffic to the logical NVLink in the topology.

int8_t portDev1[4]

Port numbers for maximum 4 NVLinks connected to device 1.

If typeDev1 is CUPTI_DEV_TYPE_NPU, ignore this field. In case of invalid/unknown port number, this field will be set to value CUPTI_NVLINK_INVALID_PORT. This will be used to correlate the metric values to individual physical link and attribute traffic to the logical NVLink in the topology.

uint64_t bandwidth

Bandwidth of NVLink in kbytes/sec.


Privacy Policy | Manage My Privacy | Do Not Sell or Share My Data | Terms of Service | Accessibility | Corporate Policies | Product Security | Contact

Copyright © 2018-2025, NVIDIA Corporation & Affiliates. All rights reserved.

Last updated on Mar 14, 2025.