NvmlClocksEventReasons#

Macros#

nvmlClocksEventReasonAll

Bit mask representing all supported clocks throttling reasons New reasons might be added to this list in the future.

nvmlClocksEventReasonApplicationsClocksSetting

Clocks are set to application-specific values.

nvmlClocksEventReasonBoardLimit

Board limit.

nvmlClocksEventReasonDisplayClockSetting

GPU clocks are limited by current setting of Display clocks.

nvmlClocksEventReasonGpuIdle

Nothing is running on the GPU and the clocks are dropping to Idle state.

nvmlClocksEventReasonNone

Bit mask representing no clocks throttling.

nvmlClocksEventReasonReliability

Reliability.

nvmlClocksEventReasonSwPowerCap

The clocks have been optimized to ensure not to exceed currently set power limits.

nvmlClocksEventReasonSwThermalSlowdown

SW Thermal Slowdown.

nvmlClocksEventReasonSyncBoost

Sync Boost.

nvmlClocksThrottleReasonAll

Deprecated: All clock throttling reasons.

nvmlClocksThrottleReasonApplicationsClocksSetting

Deprecated: Application clocks setting.

nvmlClocksThrottleReasonDisplayClockSetting

Deprecated: Display clock setting.

nvmlClocksThrottleReasonGpuIdle

Deprecated: GPU idle.

nvmlClocksThrottleReasonHwPowerBrakeSlowdown

HW Power Brake Slowdown (reducing the core clocks by a factor of 2 or more) is engaged.

nvmlClocksThrottleReasonHwSlowdown

HW Slowdown (reducing the core clocks by a factor of 2 or more) is engaged.

nvmlClocksThrottleReasonHwThermalSlowdown

HW Thermal Slowdown (reducing the core clocks by a factor of 2 or more) is engaged.

nvmlClocksThrottleReasonNone

Deprecated: No clock throttling.

nvmlClocksThrottleReasonSwPowerCap

Deprecated: Software power cap.

nvmlClocksThrottleReasonSwThermalSlowdown

Deprecated: Software thermal slowdown.

nvmlClocksThrottleReasonSyncBoost

Deprecated: Sync boost.

nvmlClocksThrottleReasonUserDefinedClocks

Deprecated: User-defined clocks.

Macros#

nvmlClocksEventReasonAll#

Bit mask representing all supported clocks throttling reasons New reasons might be added to this list in the future.

Bitmask of all clock event reasons.

nvmlClocksEventReasonApplicationsClocksSetting#

Clocks are set to application-specific values.

nvmlClocksEventReasonBoardLimit#

Board limit.

The board limit (operating) policy is currently limiting the GPU clocks. Board limit policy is limiting clocks.

nvmlClocksEventReasonDisplayClockSetting#

GPU clocks are limited by current setting of Display clocks.

See also

bug 1997531 Display clock setting limited.

nvmlClocksEventReasonGpuIdle#

Nothing is running on the GPU and the clocks are dropping to Idle state.

Note

This limiter may be removed in a later release GPU is idle.

nvmlClocksEventReasonNone#

Bit mask representing no clocks throttling.

Clocks are as high as possible. No clock throttling.

nvmlClocksEventReasonReliability#

Reliability.

The reliability policy is currently limiting the GPU clocks. Reliability policy is limiting clocks.

nvmlClocksEventReasonSwPowerCap#

The clocks have been optimized to ensure not to exceed currently set power limits.

See also

nvmlDeviceGetPowerManagementLimit Software power cap activated.

nvmlClocksEventReasonSwThermalSlowdown#

SW Thermal Slowdown.

The current clocks have been optimized to ensure the the following is true:

  • Current GPU temperature does not exceed GPU Max Operating Temperature

  • Current memory temperature does not exceeed Memory Max Operating Temperature Software thermal slowdown activated.

nvmlClocksEventReasonSyncBoost#

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. Sync boost activated.

nvmlClocksThrottleReasonAll#

Deprecated: All clock throttling reasons.

Deprecated:

Use nvmlClocksEventReasonAll instead

nvmlClocksThrottleReasonApplicationsClocksSetting#

Deprecated: Application clocks setting.

Deprecated:

nvmlClocksThrottleReasonDisplayClockSetting#

Deprecated: Display clock setting.

Deprecated:

Use nvmlClocksEventReasonDisplayClockSetting instead

nvmlClocksThrottleReasonGpuIdle#

Deprecated: GPU idle.

Deprecated:

Use nvmlClocksEventReasonGpuIdle instead

nvmlClocksThrottleReasonHwPowerBrakeSlowdown#

HW Power Brake Slowdown (reducing the core clocks by a factor of 2 or more) is engaged.

This is an indicator of:

  • External Power Brake Assertion being triggered (e.g. by the system power supply)

See also

nvmlDeviceGetPowerUsage Hardware power brake slowdown activated.

nvmlClocksThrottleReasonHwSlowdown#

HW Slowdown (reducing the core clocks by a factor of 2 or more) is engaged.

This is an indicator of:

  • temperature being too high

  • External Power Brake Assertion is triggered (e.g. by the system power supply)

  • Power draw is too high and Fast Trigger protection is reducing the clocks

  • May be also reported during PState or clock change

    • This behavior may be removed in a later release.

See also

nvmlDeviceGetPowerUsage Hardware slowdown activated.

nvmlClocksThrottleReasonHwThermalSlowdown#

HW Thermal Slowdown (reducing the core clocks by a factor of 2 or more) is engaged.

This is an indicator of:

  • temperature being too high

See also

nvmlDeviceGetPowerUsage Hardware thermal slowdown activated.

nvmlClocksThrottleReasonNone#

Deprecated: No clock throttling.

Deprecated:

Use nvmlClocksEventReasonNone instead

nvmlClocksThrottleReasonSwPowerCap#

Deprecated: Software power cap.

Deprecated:

Use nvmlClocksEventReasonSwPowerCap instead

nvmlClocksThrottleReasonSwThermalSlowdown#

Deprecated: Software thermal slowdown.

Deprecated:

Use nvmlClocksEventReasonSwThermalSlowdown instead

nvmlClocksThrottleReasonSyncBoost#

Deprecated: Sync boost.

Deprecated:

Use nvmlClocksEventReasonSyncBoost instead

nvmlClocksThrottleReasonUserDefinedClocks#

Deprecated: User-defined clocks.

Deprecated:

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