nvme-wdc-vs-temperature-stats

NVME-WDC-VS-TEMPE(1) NVMe Manual NVME-WDC-VS-TEMPE(1)

NAME

   nvme-wdc-vs-temperature-stats - Display temperature-related statistics

SYNOPSIS

   nvme wdc vs-temperature-stats <device>

DESCRIPTION

   For the NVMe device given, displays temperature statistics.

   The <device> parameter is mandatory NVMe character device (ex: /dev/nvme0).

   This will only work on WDC devices supporting this feature. Results for any other device are undefined.

   Expected status and description :-
   ┌─────────────────────────────────────────────────────┬──────────────────────────────────────┐
   │ Statistic                                           │ Description                          │
   ├─────────────────────────────────────────────────────┼──────────────────────────────────────┤
   │                                                     │                                      │
   │ The current composite temperature                   │ device temperature                   │
   ├─────────────────────────────────────────────────────┼──────────────────────────────────────┤
   │                                                     │                                      │
   │ Warning Composite TEMPerature threshold             │ temp of overheating                  │
   ├─────────────────────────────────────────────────────┼──────────────────────────────────────┤
   │                                                     │                                      │
   │ Critical Composite TEMPerature threshold            │ temp of critical overheating         │
   ├─────────────────────────────────────────────────────┼──────────────────────────────────────┤
   │                                                     │                                      │
   │ Device Initiated Thermal Throttling support status  │ 0 = unsupported, 1 = supported       │
   ├─────────────────────────────────────────────────────┼──────────────────────────────────────┤
   │                                                     │                                      │
   │ Host Controlled Thermal Management support          │ 0 = unsupported, 1 = supported       │
   ├─────────────────────────────────────────────────────┼──────────────────────────────────────┤
   │                                                     │                                      │
   │ Thermal Management Temperature 1 (Light throttle)   │ temp to start light throttle         │
   ├─────────────────────────────────────────────────────┼──────────────────────────────────────┤
   │                                                     │                                      │
   │ Thermal Management Temperature 1 Transition Counter │ # times switched into light throttle │
   ├─────────────────────────────────────────────────────┼──────────────────────────────────────┤
   │                                                     │                                      │
   │ Thermal Management Temperature 1 Total Time         │ # seconds spent in light throttle    │
   ├─────────────────────────────────────────────────────┼──────────────────────────────────────┤
   │                                                     │                                      │
   │ Thermal Management Temperature 2 (Heavy throttle)   │ temp to start heavy throttle         │
   ├─────────────────────────────────────────────────────┼──────────────────────────────────────┤
   │                                                     │                                      │
   │ Thermal Management Temperature 2 Transition Counter │ # times switched into heavy throttle │
   ├─────────────────────────────────────────────────────┼──────────────────────────────────────┤
   │                                                     │                                      │
   │ Thermal Management Temperature 2 Total Time         │ # seconds spent in heavy throttle    │
   ├─────────────────────────────────────────────────────┼──────────────────────────────────────┤
   │                                                     │                                      │
   │ Thermal Shutdown Threshold                          │ temp of device shutdown              │
   └─────────────────────────────────────────────────────┴──────────────────────────────────────┘

   On success it returns 0, error code otherwise.

EXAMPLES

   •   Displays the temperature stats for the device:

           # nvme wdc vs-temperature-stats /dev/nvme0

NVME

   Part of the nvme-user suite.

NVMe 05/02/2025 NVME-WDC-VS-TEMPE(1)