NVME-LIST(1)

💅 NVME-LIST(1) — the NVMe Manual, but make it make sense

okay bestie, gather round, because nvme-list is literally the glow-up of "wait, what disks do I even have??" — it's a page from the NVMe Manual and it's about to be your new fave.

---

✨ NAME ✨

nvme-list — list all the recognized NVMe devices. every single one. no gatekeeping. 👑

---

🦋 SYNOPSIS 🦋

nvme [<global-options>] list

that's it. that's the whole vibe. 💅

---

🌸 DESCRIPTION 🌸

so what it does is: it goes and scans the sysfs tree for NVM Express devices, and hands you back the /dev node for each one, plus some pertinent deets about them. lowkey iconic behavior.

and the namespace usage it prints? that's in powers of 1,000 with SI prefixes (e.g., 1.02 TB) — so it's giving metric system realness, not the weird 1024 stuff. 🧚

---

🎀 OPTIONS 🎀

👑 GLOBAL OPTIONS 👑

bestie listen — these options are defined up at the top-level nvme command, and they're available to this subcommand too. so they're like, main character options that deign to show up here. 🫶

• --dry-run — prints the command that would be executed, but doesn't actually execute it. it's the "adding to cart" of commands. 🙈
• --no-ioctl-probing — disables probing for 64-bit IOCTL support. no probing. we're minding our business.
• --no-retries — disables the retry logic on transient errors. one shot, one opportunity. 💀
• -o <fmt>, --output-format=<fmt> — sets the reporting format to normal, tabular, json, or binary. and ngl, only one output format may be used at a time. 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 — no custom versions, no exceptions. 🚫
• --quiet — suppresses informational messages. errors are still reported though (we're not hiding the truth from you), and --quiet cancels any --verbose for the library log level. they literally cannot coexist. 😭
• --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. that's the whole list, don't come for me. 🍓
• --timeout=<ms> — sets the timeout for the command in milliseconds. infinite or -1 waits without a time limit (0xffffffff). so basically "i'll wait forever, and I mean it". 💜
• -v, --verbose — increases the level of detail in the output. and yes, it may be specified multiple times to further increase verbosity. stack 'em. 🔥

also!! these options can be set as machine-wide defaults in nvme-cli.conf(5) — and a command-line flag always overrides the file. the flag is the main character, the file is the supporting cast. periodt. 👑

---

🌈 ENVIRONMENT 🌈

• PCI_IDS_PATH — full path of the pci.ids file, in case nvme could not find it in the common locations. it's the emergency contact for when pci.ids goes missing. 😭🫶

---

⭐ EXAMPLES ⭐

• has the program issue a list 💅

# nvme list
Node                  Generic               SN                   Model                                    Namespace  Usage                      Format           FW Rev
--------------------- --------------------- -------------------- ---------------------------------------- ---------- -------------------------- ---------------- --------
/dev/nvme0n1          /dev/ng0n1            BTNH922508PS1P0B     INTEL SSDPEKNW010T8                      0x1          1.02  TB /   1.02  TB    512   B +  0 B   002C

• has the program issue a list with verbose 🔥

# nvme list -v
Subsystem        Subsystem-NQN                                                                                    Controllers
---------------- ------------------------------------------------------------------------------------------------ ----------------
nvme-subsys0     nqn.2019-22.com.intel:nvm-subsystem-sn-btnh922508ps1p0b                                          nvme0

Device           Orchestrator Cntlid SN                   MN                                       FR       TxPort Address        Slot   Subsystem    Namespaces
---------------- ------------ ------ -------------------- ---------------------------------------- -------- ------ -------------- ------ ------------ ----------------
nvme0            kernel       1      BTNH922508PS1P0B     INTEL SSDPEKNW010T8                      002C     pcie   0000:0d:00.0          nvme-subsys0 nvme0n1

Device            Generic           NSID       Usage                      Format           Controllers
----------------- ----------------- ---------- -------------------------- ---------------- ----------------
/dev/nvme0n1 /dev/ng0n1   0x1          1.02  TB /   1.02  TB    512   B +  0 B   nvme0

---

🧚 NVME 🧚

part of the nvme-user suite. family. 💖

---

and that's the whole page, bestie — no cap, every flag accounted for. 🦋

this lil drop was brought to you by the NVMe peeps, dated 10/30/2026, and it's page NVME-LIST(1) — go forth and list your devices, you absolute icon. 🌟👑💅