3.8. Device Properties

Variables

CUDBGResult  ( *CUDBGAPI_st::getDeviceName )( uint32_t dev, char* buf, uint32_t sz )
Get the device name string.
CUDBGResult  ( *CUDBGAPI_st::getDeviceType )( uint32_t dev, char* buf, uint32_t sz )
Get the string description of the device.
CUDBGResult  ( *CUDBGAPI_st::getNumDevices )( uint32_t* numDev )
Get the number of installed CUDA devices.
CUDBGResult  ( *CUDBGAPI_st::getNumLanes )( uint32_t dev, uint32_t* numLanes )
Get the number of lanes per warp on the device.
CUDBGResult  ( *CUDBGAPI_st::getNumPredicates )( uint32_t dev, uint32_t* numPredicates )
Get the number of predicate registers per lane on the device.
CUDBGResult  ( *CUDBGAPI_st::getNumRegisters )( uint32_t dev, uint32_t* numRegs )
Get the maximum number of registers per lane on the device.
CUDBGResult  ( *CUDBGAPI_st::getNumSMs )( uint32_t dev, uint32_t* numSMs )
Get the total number of SMs on the device.
CUDBGResult  ( *CUDBGAPI_st::getNumUniformPredicates )( uint32_t dev, uint32_t* numPredicates )
Get the number of uniform predicate registers per warp on the device.
CUDBGResult  ( *CUDBGAPI_st::getNumUniformRegisters )( uint32_t dev, uint32_t* numRegs )
Get the number of uniform registers per warp on the device.
CUDBGResult  ( *CUDBGAPI_st::getNumWarps )( uint32_t dev, uint32_t* numWarps )
Get the number of warps per SM on the device.
CUDBGResult  ( *CUDBGAPI_st::getSmType )( uint32_t dev, char* buf, uint32_t sz )
Get the SM type of the device.

Variables

CUDBGResult ( *CUDBGAPI_st::getDeviceName )( uint32_t dev, char* buf, uint32_t sz )

Get the device name string. Returns CUDBG_ERROR_BUFFER_TOO_SMALL if the provided buffer is not large enough. This value is constant within a single session for a given device.

Since CUDA 6.5.

See also:

getDeviceType

getSMType

Parameters
dev
- device index
buf
- the destination buffer
sz
- buffer size in bytes
Returns

CUDBG_SUCCESS, CUDBG_ERROR_BUFFER_TOO_SMALL, CUDBG_ERROR_INVALID_ARGS, CUDBG_ERROR_UNINITIALIZED, CUDBG_ERROR_INITIALIZATION_FAILURE, CUDBG_ERROR_RECURSIVE_API_CALL

CUDBGResult ( *CUDBGAPI_st::getDeviceType )( uint32_t dev, char* buf, uint32_t sz )

Get the string description of the device. Returns CUDBG_ERROR_BUFFER_TOO_SMALL if the provided buffer is not large enough. This value is constant within a single session for a given device.

Since CUDA 3.0.

See also:

getDeviceName

getSMType

Parameters
dev
- device index
buf
- the destination buffer
sz
- buffer size in bytes
Returns

CUDBG_SUCCESS, CUDBG_ERROR_BUFFER_TOO_SMALL, CUDBG_ERROR_INVALID_ARGS, CUDBG_ERROR_UNINITIALIZED, CUDBG_ERROR_INITIALIZATION_FAILURE, CUDBG_ERROR_RECURSIVE_API_CALL

CUDBGResult ( *CUDBGAPI_st::getNumDevices )( uint32_t* numDev )

Get the number of installed CUDA devices. This value is constant within a single session.

Since CUDA 3.0.

See also:

getNumLanes

getNumPredicates

getNumRegisters

getNumSMs

getNumUniformPredicates

getNumUniformRegisters

getNumWarps

Parameters
numDev
- the returned number of devices
Returns

CUDBG_SUCCESS, CUDBG_ERROR_INVALID_ARGS, CUDBG_ERROR_UNINITIALIZED, CUDBG_ERROR_INITIALIZATION_FAILURE, CUDBG_ERROR_RECURSIVE_API_CALL

CUDBGResult ( *CUDBGAPI_st::getNumLanes )( uint32_t dev, uint32_t* numLanes )

Get the number of lanes per warp on the device. This value is constant within a single session for a given device.

Since CUDA 3.0.

See also:

getNumDevices

getNumPredicates

getNumRegisters

getNumSMs

getNumUniformPredicates

getNumUniformRegisters

getNumWarps

Parameters
dev
- device index
numLanes
- the returned number of lanes
Returns

CUDBG_SUCCESS, CUDBG_ERROR_INVALID_ARGS, CUDBG_ERROR_UNINITIALIZED, CUDBG_ERROR_INITIALIZATION_FAILURE, CUDBG_ERROR_RECURSIVE_API_CALL

CUDBGResult ( *CUDBGAPI_st::getNumPredicates )( uint32_t dev, uint32_t* numPredicates )

Get the number of predicate registers per lane on the device. This value is constant within a single session for a given device.

Since CUDA 6.5.

See also:

getNumDevices

getNumLanes

getNumRegisters

getNumSMs

getNumUniformPredicates

getNumUniformRegisters

getNumWarps

Parameters
dev
- device index
numPredicates
- the returned number of predicate registers
Returns

CUDBG_SUCCESS, CUDBG_ERROR_INVALID_ARGS, CUDBG_ERROR_UNINITIALIZED, CUDBG_ERROR_INITIALIZATION_FAILURE, CUDBG_ERROR_RECURSIVE_API_CALL

CUDBGResult ( *CUDBGAPI_st::getNumRegisters )( uint32_t dev, uint32_t* numRegs )

Get the maximum number of registers per lane on the device. This value is constant within a single session for a given device. Note that the actual number of registers can change per warp, use readWarpResources() to query that number dynamically.

Since CUDA 3.0.

See also:

getNumDevices

getNumLanes

getNumPredicates

getNumSMs

getNumUniformPredicates

getNumUniformRegisters

getNumWarps

readWarpResources

Parameters
dev
- device index
numRegs
- the returned number of registers
Returns

CUDBG_SUCCESS, CUDBG_ERROR_INVALID_ARGS, CUDBG_ERROR_UNINITIALIZED, CUDBG_ERROR_INITIALIZATION_FAILURE, CUDBG_ERROR_RECURSIVE_API_CALL

CUDBGResult ( *CUDBGAPI_st::getNumSMs )( uint32_t dev, uint32_t* numSMs )

Get the total number of SMs on the device. This value is constant within a single session for a given device.

Since CUDA 3.0.

See also:

getNumDevices

getNumLanes

getNumPredicates

getNumRegisters

getNumUniformPredicates

getNumUniformRegisters

getNumWarps

Parameters
dev
- device index
numSMs
- the returned number of SMs
Returns

CUDBG_SUCCESS, CUDBG_ERROR_INVALID_ARGS, CUDBG_ERROR_UNINITIALIZED, CUDBG_ERROR_INITIALIZATION_FAILURE, CUDBG_ERROR_RECURSIVE_API_CALL

CUDBGResult ( *CUDBGAPI_st::getNumUniformPredicates )( uint32_t dev, uint32_t* numPredicates )

Get the number of uniform predicate registers per warp on the device. This value is constant within a single session for a given device.

Since CUDA 10.0.

See also:

getNumDevices

getNumLanes

getNumPredicates

getNumRegisters

getNumSMs

getNumUniformRegisters

getNumWarps

Parameters
dev
- device index
numPredicates
- the returned number of uniform predicate registers
Returns

CUDBG_SUCCESS, CUDBG_ERROR_INVALID_ARGS, CUDBG_ERROR_UNINITIALIZED, CUDBG_ERROR_INITIALIZATION_FAILURE, CUDBG_ERROR_RECURSIVE_API_CALL

CUDBGResult ( *CUDBGAPI_st::getNumUniformRegisters )( uint32_t dev, uint32_t* numRegs )

Get the number of uniform registers per warp on the device. This value is constant within a single session for a given device.

Since CUDA 10.0.

See also:

getNumDevices

getNumLanes

getNumPredicates

getNumRegisters

getNumSMs

getNumUniformPredicates

getNumWarps

Parameters
dev
- device index
numRegs
- the returned number of uniform registers
Returns

CUDBG_SUCCESS, CUDBG_ERROR_INVALID_ARGS, CUDBG_ERROR_UNINITIALIZED, CUDBG_ERROR_INITIALIZATION_FAILURE, CUDBG_ERROR_RECURSIVE_API_CALL

CUDBGResult ( *CUDBGAPI_st::getNumWarps )( uint32_t dev, uint32_t* numWarps )

Get the number of warps per SM on the device. This value is constant within a single session for a given device.

Since CUDA 3.0.

See also:

getNumDevices

getNumLanes

getNumPredicates

getNumRegisters

getNumSMs

getNumUniformPredicates

getNumUniformRegisters

Parameters
dev
- device index
numWarps
- the returned number of warps
Returns

CUDBG_SUCCESS, CUDBG_ERROR_INVALID_ARGS, CUDBG_ERROR_UNINITIALIZED, CUDBG_ERROR_INITIALIZATION_FAILURE, CUDBG_ERROR_RECURSIVE_API_CALL

CUDBGResult ( *CUDBGAPI_st::getSmType )( uint32_t dev, char* buf, uint32_t sz )

Get the SM type of the device. Returns CUDBG_ERROR_BUFFER_TOO_SMALL if the provided buffer is not large enough. This value is constant within a single session for a given device.

Since CUDA 3.0.

See also:

getDeviceName

getDeviceType

Parameters
dev
- device index
buf
- the destination buffer
sz
- buffer size in bytes
Returns

CUDBG_SUCCESS, CUDBG_ERROR_BUFFER_TOO_SMALL, CUDBG_ERROR_INVALID_ARGS, CUDBG_ERROR_UNINITIALIZED, CUDBG_ERROR_INITIALIZATION_FAILURE, CUDBG_ERROR_RECURSIVE_API_CALL