Linux repositories inspector

nvmlClocksThrottleReasons(3)

Version 1.1
8 Feb 2019
Aliases: nvmlClocksThrottleReasonAll(3), nvmlClocksThrottleReasonAll(3), nvmlClocksThrottleReasonApplicationsClocksSetting(3), nvmlClocksThrottleReasonApplicationsClocksSetting(3), nvmlClocksThrottleReasonDisplayClockSetting(3), nvmlClocksThrottleReasonGpuIdle(3), nvmlClocksThrottleReasonGpuIdle(3), nvmlClocksThrottleReasonHwPowerBrakeSlowdown(3), nvmlClocksThrottleReasonHwPowerBrakeSlowdown(3), nvmlClocksThrottleReasonHwSlowdown(3), nvmlClocksThrottleReasonHwSlowdown(3), nvmlClocksThrottleReasonHwThermalSlowdown(3), nvmlClocksThrottleReasonHwThermalSlowdown(3), nvmlClocksThrottleReasonNone(3), nvmlClocksThrottleReasonNone(3), nvmlClocksThrottleReasonSwPowerCap(3), nvmlClocksThrottleReasonSwPowerCap(3), nvmlClocksThrottleReasonSwThermalSlowdown(3), nvmlClocksThrottleReasonSwThermalSlowdown(3), nvmlClocksThrottleReasonSyncBoost(3), nvmlClocksThrottleReasonSyncBoost(3), nvmlClocksThrottleReasonUnknown(3), nvmlClocksThrottleReasonUserDefinedClocks(3), nvmlClocksThrottleReasonUserDefinedClocks(3)

nvidia-cuda-dev

NVIDIA CUDA development files

cuda

NVIDIA's GPU programming toolkit

NAME

NvmlClocksThrottleReasons -

Defines

#define nvmlClocksThrottleReasonGpuIdle 0x0000000000000001LL
#define nvmlClocksThrottleReasonApplicationsClocksSetting 0x0000000000000002LL
#define nvmlClocksThrottleReasonUserDefinedClocks nvmlClocksThrottleReasonApplicationsClocksSetting
#define nvmlClocksThrottleReasonSwPowerCap 0x0000000000000004LL
#define nvmlClocksThrottleReasonHwSlowdown 0x0000000000000008LL
#define nvmlClocksThrottleReasonSyncBoost 0x0000000000000010LL
#define nvmlClocksThrottleReasonSwThermalSlowdown 0x0000000000000020LL
#define nvmlClocksThrottleReasonHwThermalSlowdown 0x0000000000000040LL
#define nvmlClocksThrottleReasonHwPowerBrakeSlowdown 0x0000000000000080LL
#define nvmlClocksThrottleReasonDisplayClockSetting 0x0000000000000100LL
#define nvmlClocksThrottleReasonNone 0x0000000000000000LL
#define nvmlClocksThrottleReasonAll

Define Documentation

#define nvmlClocksThrottleReasonAll

Value:
(nvmlClocksThrottleReasonNone
      | nvmlClocksThrottleReasonGpuIdle
      | nvmlClocksThrottleReasonApplicationsClocksSetting
      | nvmlClocksThrottleReasonSwPowerCap
      | nvmlClocksThrottleReasonHwSlowdown
      | nvmlClocksThrottleReasonSyncBoost
      | nvmlClocksThrottleReasonSwThermalSlowdown
      | nvmlClocksThrottleReasonHwThermalSlowdown
      | nvmlClocksThrottleReasonHwPowerBrakeSlowdown
      | nvmlClocksThrottleReasonDisplayClockSetting
)
Bit mask representing all supported clocks throttling reasons New reasons might be added to this list in the future

#define nvmlClocksThrottleReasonApplicationsClocksSetting 0x0000000000000002LL

GPU clocks are limited by current setting of applications clocks
See also:
nvmlDeviceSetApplicationsClocks
nvmlDeviceGetApplicationsClock

#define nvmlClocksThrottleReasonDisplayClockSetting 0x0000000000000100LL

GPU clocks are limited by current setting of Display clocks
See also:
bug 1997531

#define nvmlClocksThrottleReasonGpuIdle 0x0000000000000001LL

Nothing is running on the GPU and the clocks are dropping to Idle state
Note:
This limiter may be removed in a later release

#define nvmlClocksThrottleReasonHwPowerBrakeSlowdown 0x0000000000000080LL

HW Power Brake Slowdown (reducing the core clocks by a factor of 2 or more) is engaged
This is an indicator of:
o External Power Brake Assertion being triggered (e.g. by the system power supply)
See also:
nvmlDeviceGetTemperature
nvmlDeviceGetTemperatureThreshold
nvmlDeviceGetPowerUsage

#define nvmlClocksThrottleReasonHwSlowdown 0x0000000000000008LL

HW Slowdown (reducing the core clocks by a factor of 2 or more) is engaged
This is an indicator of:
o temperature being too high
o External Power Brake Assertion is triggered (e.g. by the system power supply)
o Power draw is too high and Fast Trigger protection is reducing the clocks
o May be also reported during PState or clock change
o This behavior may be removed in a later release.
See also:
nvmlDeviceGetTemperature
nvmlDeviceGetTemperatureThreshold
nvmlDeviceGetPowerUsage

#define nvmlClocksThrottleReasonHwThermalSlowdown 0x0000000000000040LL

HW Thermal Slowdown (reducing the core clocks by a factor of 2 or more) is engaged
This is an indicator of:
o temperature being too high
See also:
nvmlDeviceGetTemperature
nvmlDeviceGetTemperatureThreshold
nvmlDeviceGetPowerUsage

#define nvmlClocksThrottleReasonNone 0x0000000000000000LL

Bit mask representing no clocks throttling
Clocks are as high as possible.

#define nvmlClocksThrottleReasonSwPowerCap 0x0000000000000004LL

SW Power Scaling algorithm is reducing the clocks below requested clocks
See also:
nvmlDeviceGetPowerUsage
nvmlDeviceSetPowerManagementLimit
nvmlDeviceGetPowerManagementLimit

#define nvmlClocksThrottleReasonSwThermalSlowdown 0x0000000000000020LL

SW Thermal Slowdown
This is an indicator of one or more of the following:
o Current GPU temperature above the GPU Max Operating Temperature
o Current memory temperature above the Memory Max Operating Temperature

#define nvmlClocksThrottleReasonSyncBoost 0x0000000000000010LL

Sync Boost
This GPU has been added to a Sync boost group with nvidia-smi or DCGM in order to maximize performance per watt. All GPUs in the sync boost group will boost to the minimum possible clocks across the entire group. Look at the throttle reasons for other GPUs in the system to see why those GPUs are holding this one at lower clocks.

#define nvmlClocksThrottleReasonUserDefinedClocks nvmlClocksThrottleReasonApplicationsClocksSetting

Deprecated
Renamed to nvmlClocksThrottleReasonApplicationsClocksSetting as the name describes the situation more accurately.

Author

Generated automatically by Doxygen for NVML from the source code.
⇧ Top