NVML API Reference Guide (PDF) - v535 (older) - Last updated January 31, 2024 - Send Feedback

4.13. System Queries

This chapter describes the queries that NVML can perform against the local system. These queries are not device-specific.

Defines

#define NVML_CUDA_DRIVER_VERSION_MAJOR ( v ) ((v)/1000)

Functions

nvmlReturn_t nvmlSystemGetCudaDriverVersion ( int* cudaDriverVersion )
nvmlReturn_t nvmlSystemGetCudaDriverVersion_v2 ( int* cudaDriverVersion )
nvmlReturn_t nvmlSystemGetDriverVersion ( char* version, unsigned int  length )
nvmlReturn_t nvmlSystemGetNVMLVersion ( char* version, unsigned int  length )
nvmlReturn_t nvmlSystemGetProcessName ( unsigned int  pid, char* name, unsigned int  length )

Defines

#define NVML_CUDA_DRIVER_VERSION_MAJOR ( v ) ((v)/1000)

Macros for converting the CUDA driver version number to Major and Minor version numbers.

Functions

nvmlReturn_t nvmlSystemGetCudaDriverVersion ( int* cudaDriverVersion )
Parameters
cudaDriverVersion
Reference in which to return the version identifier
Returns

Description

Retrieves the version of the CUDA driver.

For all products.

The CUDA driver version returned will be retreived from the currently installed version of CUDA. If the cuda library is not found, this function will return a known supported version number.

nvmlReturn_t nvmlSystemGetCudaDriverVersion_v2 ( int* cudaDriverVersion )
Parameters
cudaDriverVersion
Reference in which to return the version identifier
Returns

Description

Retrieves the version of the CUDA driver from the shared library.

For all products.

The returned CUDA driver version by calling cuDriverGetVersion()

nvmlReturn_t nvmlSystemGetDriverVersion ( char* version, unsigned int  length )
Parameters
version
Reference in which to return the version identifier
length
The maximum allowed length of the string returned in version
Returns

Description

Retrieves the version of the system's graphics driver.

For all products.

The version identifier is an alphanumeric string. It will not exceed 80 characters in length (including the NULL terminator). See nvmlConstants::NVML_SYSTEM_DRIVER_VERSION_BUFFER_SIZE.

nvmlReturn_t nvmlSystemGetNVMLVersion ( char* version, unsigned int  length )
Parameters
version
Reference in which to return the version identifier
length
The maximum allowed length of the string returned in version
Returns

Description

Retrieves the version of the NVML library.

For all products.

The version identifier is an alphanumeric string. It will not exceed 80 characters in length (including the NULL terminator). See nvmlConstants::NVML_SYSTEM_NVML_VERSION_BUFFER_SIZE.

nvmlReturn_t nvmlSystemGetProcessName ( unsigned int  pid, char* name, unsigned int  length )
Parameters
pid
The identifier of the process
name
Reference in which to return the process name
length
The maximum allowed length of the string returned in name
Returns

Description

Gets name of the process with provided process id

For all products.

Returned process name is cropped to provided length. name string is encoded in ANSI.


NVML API Reference Guide (PDF) - v535 (older) - Last updated January 31, 2024 - Send Feedback