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

NAME

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

nvme [<global-options>] wdc vs-temperature-stats <device>

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.

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.

-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. Other versions are rejected.

--quiet: Suppress informational messages. Errors are still reported, and --quiet cancels any --verbose for the library log level.

--set-options=<key=value>[,<key=value>...]: Set libnvme library options for this invocation. Supported keys are force-4k, mi-probe-enabled, test-base-dir and test-sysfs-dir.

--timeout=<ms>: Set the timeout for the command in milliseconds. infinite or -1 waits without a time limit (0xffffffff).

-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.

• Displays the temperature stats for the device:

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

Part of the nvme-user suite.