nvme-wdc-vs-temperature-stats(1)

# nvme-wdc-vs-temperature-stats(1) Manual Page

## NAME

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

## SYNOPSIS

    nvme [<global-options>] 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.

## OPTIONS

## GLOBAL OPTIONS

The following options are defined at the top-level `nvme` command and are available to this subcommand:

--dry-run

  Print the command that would be executed, but do not actually execute it.

--no-ioctl-probing

  Disable probing for 64-bit IOCTL support.

--no-retries

  Disable retry logic on transient errors.

-o <fmt>
--output-format=<fmt>

  Set the reporting format to normal, tabular, 'json, or binary. Only one output format may be used at a time.

--output-format-version=<version>

  Select the output format version. Version 1 uses the original field naming, while version 2 (default) provides more consistent and script-friendly field names.

--timeout=<ms>

  Set the timeout for the command in milliseconds.

-v
--verbose

  Increase the level of detail in the output. May be specified multiple times to further increase verbosity.

These options can also be set as machine-wide defaults in nvme-cli.conf(5). A command-line flag always overrides the file.

## EXAMPLES

- Displays the temperature stats for the device:

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

## NVME

Part of the nvme-user suite.