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      | device temperature       |
       |temperature                |                          |
       +---------------------------+--------------------------+
       |Warning Composite          | temp of overheating      |
       |TEMPerature threshold      |                          |
       +---------------------------+--------------------------+
       |Critical Composite         | temp of critical         |
       |TEMPerature threshold      | overheating              |
       +---------------------------+--------------------------+
       |Device Initiated Thermal   | 0 = unsupported, 1 =     |
       |Throttling support status  | supported                |
       +---------------------------+--------------------------+
       |Host Controlled Thermal    | 0 = unsupported, 1 =     |
       |Management support         | supported                |
       +---------------------------+--------------------------+
       |Thermal Management         | temp to start light      |
       |Temperature 1 (Light       | throttle                 |
       |throttle)                  |                          |
       +---------------------------+--------------------------+
       |Thermal Management         | # times switched into    |
       |Temperature 1 Transition   | light throttle           |
       |Counter                    |                          |
       +---------------------------+--------------------------+
       |Thermal Management         | # seconds spent in light |
       |Temperature 1 Total Time   | throttle                 |
       +---------------------------+--------------------------+
       |Thermal Management         | temp to start heavy      |
       |Temperature 2 (Heavy       | throttle                 |
       |throttle)                  |                          |
       +---------------------------+--------------------------+
       |Thermal Management         | # times switched into    |
       |Temperature 2 Transition   | heavy throttle           |
       |Counter                    |                          |
       +---------------------------+--------------------------+
       |Thermal Management         | # seconds spent in heavy |
       |Temperature 2 Total Time   | throttle                 |
       +---------------------------+--------------------------+
       |Thermal Shutdown Threshold | temp of device shutdown  |
       +---------------------------+--------------------------+

       On success it returns 0, error code otherwise.

EXAMPLES
       o   Displays the temperature stats for the device:

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

NVME
       Part of the nvme-user suite.

NVMe                              02/16/2024              NVME-WDC-VS-TEMPE(1)