NVME-SUBSYSTEM-RES(1)

📦
version 3.2 · 14 versions
, in arch rolling

💅 NVME-SUBSYSTEM-RES(1) — like, the NVMe Manual, bestie

okay so real talk: this is nvme-subsystem-reset, one of the little icons living inside the NVMe Manual (yes that NVMe, the one your server is emotionally dependent on). Buckle up 🎀

✨ NAME ✨

nvme-subsystem-reset — reset the nvme subsystem. that's it. that's the whole vibe. 💅

🌸 SYNOPSIS 🌸

nvme [<global-options>] subsystem-reset <device>

🦋 DESCRIPTION 🦋

So you wanna hit the big red button 🔥 — this command requests an NVMe subsystem reset. No cap, that's what it does.

The <device> param is mandatory (not optional, not "I'll add it later", mandatory fr fr) and it must be an NVMe character device, like for example /dev/nvme0. so like, don't hand it a random file and expect main character energy 🙈

💖 OPTIONS 💖

👑 GLOBAL OPTIONS 👑

okay so these are defined up at the top-level nvme command — they're the ones available to this subcommand too. mother ship options, basically:

  • --dry-run — prints the command it would run, but does not actually execute it. all the aesthetics of doing it, zero of the consequences ✨
  • --no-ioctl-probing — disables probing for 64-bit IOCTL support. just… turns the probing off. she said no thanks 💅
  • --no-retries — disables retry logic on transient errors, so if it flops, it flops. no second chances 🫶
  • -o <fmt>, --output-format=<fmt> ** — sets the reporting format to normal, tabular, json, or binary. only **one output format at a time, bestie, pick a lane ⭐
  • --output-format-version=<version> ** — selects the output format version. **Version 1 uses the original field naming, while version 2 (the default) provides more consistent and script-friendly field names. other versions are rejected, like, hard no 💀
  • --quiet — suppresses informational messages. errors are still reported, and --quiet cancels any --verbose for the library log level. shhh 🤫
  • --set-options=<key=value>[,<key=value>...] — sets libnvme library options for this invocation. the supported keys are force-4k, mi-probe-enabled, test-base-dir and test-sysfs-dir. yes those four, no you can't make up new ones 🌈
  • --timeout=<ms> ** — sets the timeout for the command in **milliseconds. infinite or -1 waits without a time limit (0xffffffff). time is a construct, lowkey 🕰️
  • -v, --verbose — increases the level of detail in the output. may be specified multiple times to further increase verbosity — stack 'em like bracelets 💜
also!! these options can be set as machine-wide defaults in nvme-cli.conf(5). a command-line flag always overrides the file. periodt. 👑

💀 EXAMPLES 💀

  • resets the subsystem. she does exactly what it says on the tin:
# nvme subsystem-reset /dev/nvme0

🎀 NVME 🎀

part of the nvme-user suite 🧚

and that's the whole page, bestie — go reset something responsibly ✨

sign-off from the manpage itself: NVMe, dated 10/30/2026 — mwah, catch you in the next manual 🫶💖

📦 where this page comes from