NVME-SHOW-TOPOLOGY(1)

📦
version 3.2 · 13 versions
, in arch rolling

💅 nvme-show-topology 💅

okay so welcome to the glow-up of nvme-show-topology, straight out of the NVMe Manual, section 1 (the big main-character section, iykyk). bestie, this one's a little cutie — it just shows you the whole family tree of every NVMe subsystem on your machine. no cap. 🌸

✨ NAME ✨

nvme-show-topology — literally just shows the topology of all NVMe subsystems 🦋

🎀 SYNOPSIS 🎀

nvme [<global-options>] show-topology

💖 DESCRIPTION 💖

Show the topology of all NVMe subsystems. that's it, that's the whole vibe 💅 it's giving "family tree but make it storage" and honestly? obsessed.

🌈 OPTIONS 🌈

  • -r <order>, --ranking=<order> — sets the ranking order, and your choices are namespace (this is the default, bestie) or ctrl. heads up though: this only does anything for the normal output format — the JSON output is always namespace ordered, no exceptions, periodt.

👑 GLOBAL OPTIONS 👑

these are the ones defined up at the top-level nvme command, and they're all available to this subcommand too. very generous of them fr fr.

  • --dry-run — prints the command that would be executed, but does not actually execute it. it's the "look but don't touch" of flags 🙈
  • --no-ioctl-probing — disables probing for 64-bit IOCTL support.
  • --no-retries — disables retry logic on transient errors.
  • -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, and honestly the slay) provides more consistent and script-friendly field names. other versions get rejected, sorry not sorry.
  • --quiet — suppresses informational messages. errors are still reported, and --quiet cancels any --verbose for the library log level. it's giving "don't talk to me unless it's urgent" 💜
  • --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.
  • --timeout=<ms> — sets the timeout for the command in milliseconds. infinite or -1 waits without a time limit (0xffffffff). patience is a virtue, apparently 🧚
  • -v, --verbose — increases the level of detail in the output. may be specified multiple times to further increase verbosity. go off, stack those -vs, we love a maximalist 🔥
also important: these options can also be set as machine-wide defaults in nvme-cli.conf(5). a command-line flag always overrides the file — CLI stays the main character, always. 👑

⭐ EXAMPLES ⭐

the one and only iconic example:

nvme show-topology

🫶 NVME 🫶

part of the nvme-user suite. one big happy family 💖

okay that's the whole page, you ate that. go forth and admire your topology, bestie 🌟

sign-off moment 🎀 — this was NVMe (that's the source, and the version, all in one little word), dated 10/30/2026, and the page itself is NVME-SHOW-TOPOLOGY(1). mwah 💋

📦 where this page comes from