cuda.bindings.nvml.device_set_gpu_locked_clocks#

cuda.bindings.nvml.device_set_gpu_locked_clocks( intptr_t device, unsigned int min_gpu_clock_m_hz, unsigned int max_gpu_clock_m_hz, )#

Set clocks that device will lock to.

Sets the clocks that the device will be running at to the value in the range of min_gpu_clock_m_hz to max_gpu_clock_m_hz. Can be used as a setting to request constant performance. This can be called with a pair of integer clock frequencies in MHz, or a pair of /ref nvmlClockLimitId_t values. See the table below for valid combinations of these values. minGpuClock | maxGpuClock | Effect ————+———-—+———————————————–— tdp | tdp | Lock clock to TDP unlimited | tdp | Upper bound is TDP but clock may drift below this tdp | unlimited | Lower bound is TDP but clock may boost above this unlimited | unlimited | Unlocked (== nvmlDeviceResetGpuLockedClocks). If one arg takes one of these values, the other must be one of these values as well. Mixed numeric and symbolic calls return NVML_ERROR_INVALID_ARGUMENT. Requires root/admin permissions. After system reboot or driver reload GPU clocks go back to their default value. See nvmlDeviceResetGpuLockedClocks. For Volta ™️ or newer fully supported devices.

Parameters:

device (intptr_t) – The identifier of the target device.
min_gpu_clock_m_hz (unsigned int) – Requested minimum gpu clock in MHz.
max_gpu_clock_m_hz (unsigned int) – Requested maximum gpu clock in MHz.