NVME-FEAT-HCTM(1)

📦 version 3.2, in arch rolling

💅 nvme-feat-hctm — get & set the host controlled thermal management feature 🥵✨

okay so bestie, this one's from the NVMe manual, and it's lowkey one of the coziest subcommands to explain: it's all about telling your drive "hey girl, chill" before she gets too hot 🔥. Let's get into it 🫶

🌸 NAME 🌸

nvme-feat-hctm — get and set host controlled thermal management feature 💖

✨ SYNOPSIS ✨

nvme [<global-options>] feat hctm <device>
                        [--tmt1=<tmt1> | -t <tmt1>] [--tmt2=<tmt2> | -T <tmt2>]
                        [--sel=<select> | -S <select>] [--save | -s]

that's the whole vibe check right there, no cap 💅

🦋 DESCRIPTION 🦋

Get and set the host controlled thermal management feature, bestie. That's literally the whole mission 🎀

The <device> parameter is mandatory — can't skip her, she's the main character — and it can be either the NVMe character device (ex: /dev/nvme0) or a namespace block device (ex: /dev/nvme0n1) 🫶

Here's how the behavior works, and this part is important so pay attention:

  • If any of the setting options (--tmt1 or --tmt2) are specified, the command will update the host controlled thermal management configuration ✨
  • If none of these options are specified, it will retrieve and display the current configuration 👑

On success it returns 0, error code otherwise. periodt 💅

👑 OPTIONS 👑

  • -t <tmt1>, --tmt1=<tmt1> — Thermal Management Temperature 1. This one specifies the temperature threshold in Kelvin at which the controller transitions to lower power states or throttling 🥵 she's the first "slow down girl" signal.
  • -T <tmt2>, --tmt2=<tmt2> — Thermal Management Temperature 2. This specifies the secondary temperature threshold in Kelvin, for heavy throttling or critical cooling actions 😭 yeah this one's the serious talk.
  • -S <select>, --sel=<select> — Select (SEL): this field specifies which value of the attributes to return in the provided data. Table time, bestie 🎀:
    • 0 — current — Current
    • 1 — default — Default
    • 2 — saved — Saved
    • 3 — supported — Supported capabilities
  • -s, --save — Save the attribute so that it persists through all power states and resets 💾 she sticks around, fr fr.

🌈 GLOBAL OPTIONS 🌈

The following options are defined at the top-level nvme command and are available to this subcommand. yes, they're shared, they're generous like that 🫶

  • --dry-run — Print the command that would be executed, but do not actually execute it. peeking without touching 🙈
  • --no-ioctl-probing — Disable probing for 64-bit IOCTL support.
  • --no-retries — Disable retry logic on transient errors. one strike and she's out 💀
  • -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 👑

💜 EXAMPLES 💜

  • Has the program issue a feat hctm to get the current configuration:
# nvme feat hctm /dev/nvme0
  • Has the program issue a feat hctm to set TMT1 and TMT2 thresholds with saving enabled:
# nvme feat hctm /dev/nvme0 --tmt1=320 --tmt2=330 --save

look at her go 😭💖

⭐ NVME ⭐

Part of the nvme-user suite.

💌 a lil sign-off from me to you: this page came from the NVMe manual, dated 10/30/2026, and you're looking at NVME-FEAT-HCTM(1). go keep your drives cool and your thresholds cute, bestie 🧚‍♀️🌸💅
📦 where this page comes from