Logo
  • 1. Release Notes
  • 2. Usage
  • 3. Library support
  • 4. Special Configurations
  • 5. Tutorial
  • 6. Modules
  • 7. Data Structures
    • 7.1. CUpti_Activity
    • 7.2. CUpti_ActivityAPI
    • 7.3. CUpti_ActivityAutoBoostState
    • 7.4. CUpti_ActivityBranch
    • 7.5. CUpti_ActivityBranch2
    • 7.6. CUpti_ActivityCdpKernel
    • 7.7. CUpti_ActivityConfidentialComputeRotation
    • 7.8. CUpti_ActivityContext
    • 7.9. CUpti_ActivityContext2
    • 7.10. CUpti_ActivityContext3
    • 7.11. CUpti_ActivityCudaEvent
    • 7.12. CUpti_ActivityCudaEvent2
    • 7.13. CUpti_ActivityDevice
    • 7.14. CUpti_ActivityDevice2
    • 7.15. CUpti_ActivityDevice3
    • 7.16. CUpti_ActivityDevice4
    • 7.17. CUpti_ActivityDevice5
    • 7.18. CUpti_ActivityDeviceAttribute
    • 7.19. CUpti_ActivityDeviceGraphTrace
    • 7.20. CUpti_ActivityEnvironment
    • 7.21. CUpti_ActivityEvent
    • 7.22. CUpti_ActivityEventInstance
    • 7.23. CUpti_ActivityExternalCorrelation
    • 7.24. CUpti_ActivityFunction
    • 7.25. CUpti_ActivityGlobalAccess
    • 7.26. CUpti_ActivityGlobalAccess2
    • 7.27. CUpti_ActivityGlobalAccess3
    • 7.28. CUpti_ActivityGraphTrace
    • 7.29. CUpti_ActivityGraphTrace2
    • 7.30. CUpti_ActivityInstantaneousEvent
    • 7.31. CUpti_ActivityInstantaneousEventInstance
    • 7.32. CUpti_ActivityInstantaneousMetric
    • 7.33. CUpti_ActivityInstantaneousMetricInstance
    • 7.34. CUpti_ActivityInstructionCorrelation
    • 7.35. CUpti_ActivityInstructionExecution
    • 7.36. CUpti_ActivityJit
    • 7.37. CUpti_ActivityJit2
    • 7.38. CUpti_ActivityKernel
    • 7.39. CUpti_ActivityKernel10
    • 7.40. CUpti_ActivityKernel2
    • 7.41. CUpti_ActivityKernel3
    • 7.42. CUpti_ActivityKernel4
    • 7.43. CUpti_ActivityKernel5
    • 7.44. CUpti_ActivityKernel6
    • 7.45. CUpti_ActivityKernel7
    • 7.46. CUpti_ActivityKernel8
    • 7.47. CUpti_ActivityKernel9
    • 7.48. CUpti_ActivityMarker
    • 7.49. CUpti_ActivityMarker2
    • 7.50. CUpti_ActivityMarkerData
    • 7.51. CUpti_ActivityMarkerData2
    • 7.52. CUpti_ActivityMemDecompress
    • 7.53. CUpti_ActivityMemcpy
    • 7.54. CUpti_ActivityMemcpy3
    • 7.55. CUpti_ActivityMemcpy4
    • 7.56. CUpti_ActivityMemcpy5
    • 7.57. CUpti_ActivityMemcpy6
    • 7.58. CUpti_ActivityMemcpyPtoP
    • 7.59. CUpti_ActivityMemcpyPtoP2
    • 7.60. CUpti_ActivityMemcpyPtoP3
    • 7.61. CUpti_ActivityMemcpyPtoP4
    • 7.62. CUpti_ActivityMemory
    • 7.63. CUpti_ActivityMemory2
    • 7.64. CUpti_ActivityMemory3
    • 7.65. CUpti_ActivityMemory4
    • 7.66. CUpti_ActivityMemoryPool
    • 7.67. CUpti_ActivityMemoryPool2
    • 7.68. CUpti_ActivityMemoryPool3
    • 7.69. CUpti_ActivityMemset
    • 7.70. CUpti_ActivityMemset2
    • 7.71. CUpti_ActivityMemset3
    • 7.72. CUpti_ActivityMemset4
    • 7.73. CUpti_ActivityMetric
    • 7.74. CUpti_ActivityMetricInstance
    • 7.75. CUpti_ActivityModule
    • 7.76. CUpti_ActivityName
    • 7.77. CUpti_ActivityNvLink
    • 7.78. CUpti_ActivityNvLink2
    • 7.79. CUpti_ActivityNvLink3
    • 7.80. CUpti_ActivityNvLink4
    • 7.81. CUpti_ActivityObjectKindId
    • 7.82. CUpti_ActivityOpenAcc
    • 7.83. CUpti_ActivityOpenAccData
    • 7.84. CUpti_ActivityOpenAccLaunch
    • 7.85. CUpti_ActivityOpenAccOther
    • 7.86. CUpti_ActivityOpenMp
    • 7.87. CUpti_ActivityOverhead
    • 7.88. CUpti_ActivityOverhead2
    • 7.89. CUpti_ActivityOverhead3
    • 7.90. CUpti_ActivityOverheadCommandBufferFullData
    • 7.91. CUpti_ActivityPCSampling
    • 7.92. CUpti_ActivityPCSampling2
    • 7.93. CUpti_ActivityPCSampling3
    • 7.94. CUpti_ActivityPCSamplingConfig
    • 7.95. CUpti_ActivityPCSamplingRecordInfo
    • 7.96. CUpti_ActivityPcie
    • 7.97. CUpti_ActivityPreemption
    • 7.98. CUpti_ActivitySharedAccess
    • 7.99. CUpti_ActivitySourceLocator
    • 7.100. CUpti_ActivityStream
    • 7.101. CUpti_ActivitySynchronization
    • 7.102. CUpti_ActivitySynchronization2
    • 7.103. CUpti_ActivityUnifiedMemoryCounter
    • 7.104. CUpti_ActivityUnifiedMemoryCounter2
    • 7.105. CUpti_ActivityUnifiedMemoryCounter3
    • 7.106. CUpti_ActivityUnifiedMemoryCounterConfig
    • 7.107. CUpti_CallbackData
    • 7.108. CUpti_GetCubinCrcParams
    • 7.109. CUpti_GetSassToSourceCorrelationParams
    • 7.110. CUpti_GraphData
    • 7.111. CUpti_ModuleResourceData
    • 7.112. CUpti_NvtxData
    • 7.113. CUpti_NvtxExtPayloadAttr
    • 7.114. CUpti_PCSamplingConfigurationInfo
    • 7.115. CUpti_PCSamplingConfigurationInfoParams
    • 7.116. CUpti_PCSamplingData
    • 7.117. CUpti_PCSamplingDisableParams
    • 7.118. CUpti_PCSamplingEnableParams
    • 7.119. CUpti_PCSamplingGetDataParams
    • 7.120. CUpti_PCSamplingGetNumStallReasonsParams
    • 7.121. CUpti_PCSamplingGetStallReasonsParams
    • 7.122. CUpti_PCSamplingPCData
    • 7.123. CUpti_PCSamplingStallReason
    • 7.124. CUpti_PCSamplingStartParams
    • 7.125. CUpti_PCSamplingStopParams
    • 7.126. CUpti_PmSampling_CounterDataImage_Initialize_Params
    • 7.127. CUpti_PmSampling_CounterData_GetSampleInfo_Params
    • 7.128. CUpti_PmSampling_DecodeData_Params
    • 7.129. CUpti_PmSampling_Disable_Params
    • 7.130. CUpti_PmSampling_Enable_Params
    • 7.131. CUpti_PmSampling_GetCounterAvailability_Params
    • 7.132. CUpti_PmSampling_GetCounterDataInfo_Params
    • 7.133. CUpti_PmSampling_GetCounterDataSize_Params
    • 7.134. CUpti_PmSampling_SetConfig_Params
    • 7.135. CUpti_PmSampling_Start_Params
    • 7.136. CUpti_PmSampling_Stop_Params
    • 7.137. CUpti_Profiler_BeginPass_Params
    • 7.138. CUpti_Profiler_BeginSession_Params
    • 7.139. CUpti_Profiler_CounterDataImageOptions
    • 7.140. CUpti_Profiler_CounterDataImage_CalculateScratchBufferSize_Params
    • 7.141. CUpti_Profiler_CounterDataImage_CalculateSize_Params
    • 7.142. CUpti_Profiler_CounterDataImage_InitializeScratchBuffer_Params
    • 7.143. CUpti_Profiler_CounterDataImage_Initialize_Params
    • 7.144. CUpti_Profiler_DeInitialize_Params
    • 7.145. CUpti_Profiler_DeviceSupported_Params
    • 7.146. CUpti_Profiler_DisableProfiling_Params
    • 7.147. CUpti_Profiler_EnableProfiling_Params
    • 7.148. CUpti_Profiler_EndPass_Params
    • 7.149. CUpti_Profiler_EndSession_Params
    • 7.150. CUpti_Profiler_FlushCounterData_Params
    • 7.151. CUpti_Profiler_GetCounterAvailability_Params
    • 7.152. CUpti_Profiler_Host_ConfigAddMetrics_Params
    • 7.153. CUpti_Profiler_Host_Deinitialize_Params
    • 7.154. CUpti_Profiler_Host_EvaluateToGpuValues_Params
    • 7.155. CUpti_Profiler_Host_GetBaseMetrics_Params
    • 7.156. CUpti_Profiler_Host_GetConfigImageSize_Params
    • 7.157. CUpti_Profiler_Host_GetConfigImage_Params
    • 7.158. CUpti_Profiler_Host_GetMaxNumHardwareMetricsPerPass_Params
    • 7.159. CUpti_Profiler_Host_GetMetricProperties_Params
    • 7.160. CUpti_Profiler_Host_GetNumOfPasses_Params
    • 7.161. CUpti_Profiler_Host_GetRangeName_Params
    • 7.162. CUpti_Profiler_Host_GetSubMetrics_Params
    • 7.163. CUpti_Profiler_Host_GetSupportedChips_Params
    • 7.164. CUpti_Profiler_Host_Initialize_Params
    • 7.165. CUpti_Profiler_Initialize_Params
    • 7.166. CUpti_Profiler_IsPassCollected_Params
    • 7.167. CUpti_Profiler_PopRange_Params
    • 7.168. CUpti_Profiler_PushRange_Params
    • 7.169. CUpti_Profiler_SetConfig_Params
    • 7.170. CUpti_Profiler_UnsetConfig_Params
    • 7.171. CUpti_RangeProfiler_CounterDataImage_Initialize_Params
    • 7.172. CUpti_RangeProfiler_CounterData_GetRangeInfo_Params
    • 7.173. CUpti_RangeProfiler_DecodeData_Params
    • 7.174. CUpti_RangeProfiler_Disable_Params
    • 7.175. CUpti_RangeProfiler_Enable_Params
    • 7.176. CUpti_RangeProfiler_GetCounterDataInfo_Params
    • 7.177. CUpti_RangeProfiler_GetCounterDataSize_Params
    • 7.178. CUpti_RangeProfiler_PopRange_Params
    • 7.179. CUpti_RangeProfiler_PushRange_Params
    • 7.180. CUpti_RangeProfiler_SetConfig_Params
    • 7.181. CUpti_RangeProfiler_Start_Params
    • 7.182. CUpti_RangeProfiler_Stop_Params
    • 7.183. CUpti_ResourceData
    • 7.184. CUpti_SassMetricsDisable_Params
    • 7.185. CUpti_SassMetricsEnable_Params
    • 7.186. CUpti_SassMetricsFlushData_Params
    • 7.187. CUpti_SassMetricsGetDataProperties_Params
    • 7.188. CUpti_SassMetricsSetConfig_Params
    • 7.189. CUpti_SassMetricsUnsetConfig_Params
    • 7.190. CUpti_SassMetrics_Config
    • 7.191. CUpti_SassMetrics_Data
    • 7.192. CUpti_SassMetrics_GetMetrics_Params
    • 7.193. CUpti_SassMetrics_GetNumOfMetrics_Params
    • 7.194. CUpti_SassMetrics_GetProperties_Params
    • 7.195. CUpti_SassMetrics_InstanceValue
    • 7.196. CUpti_SassMetrics_MetricDetails
    • 7.197. CUpti_StateData
    • 7.198. CUpti_StreamAttrData
    • 7.199. CUpti_SubscriberParams
    • 7.200. CUpti_SynchronizeData
  • 8. Namespaces
  • Copyright and Licenses
  • Notices
Cupti
  • »
  • 7. Data Structures »
  • 7.77. CUpti_ActivityNvLink
  • v2025.3.1 | Archive  

7.77. 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 Sep 02, 2025.