NVME-WDC-NAMESPACE(1)

🦋 NVME-WDC-NAMESPACE(1) 🦋

okay so this is a page from the NVMe Manual, and bestie, we're talking about nvme-wdc-namespace-resize today — a whole vibe of a command that literally resizes your device's namespace. no cap. let's get into it 💅

---

✨ NAME ✨

nvme-wdc-namespace-resize — resizes the device's namespace. that's it, that's the whole thing 🎀

---

✨ SYNOPSIS ✨

nvme [<global-options>] wdc namespace-resize <device>
                        [--nsid=<NAMESPACE ID>, -n <NAMSPACE ID>]
                        [--op-option=<OP OPTION>, -O <OP OPTION>]

(yes, <NAMSPACE ID> is spelled exactly like that in the synopsis — we don't fix, we report 🫶)

---

✨ DESCRIPTION ✨

so for the NVMe device you hand it, this sends the WDC Vendor Specific Command that modifies the namespace size reported by the device. like, the device is out here reporting a size and we're like "girl, change it." 💖

the <device> parameter is mandatory and it's an NVMe character device (ex: /dev/nvme0), iykyk.

⚠️ this will only work on WDC devices that support this feature. results for any other device are undefined — so please don't come for me if you try it on something random 😭

---

✨ OPTIONS ✨

• -n <NAMESPACE ID>, --namespace-id=<NAMESPACE_ID> — namespace ID; the ID of the namespace you wanna resize. the broadcast value 0xffffffff can also be given as all or -1. iconic little shortcut, honestly 👑
• -O <OP OPTION>, --op-option=<OP OPTION> — overprovisioning option; defaults to 0xF. valid values, bestie, listen up:
  • 0x1 — 7% of Original TNVMCAP reported value
  • 0x2 — 28% of Original TNVMCAP reported value
  • 0x3 — 50% of Original TNVMCAP reported value
  • 0xF — 0% of Original TNVMCAP reported value (original config)
  • all other values — reserved 🚫

---

✨ GLOBAL OPTIONS ✨

these are defined at the top-level nvme command and are available to this subcommand too. so they're like the main character options that let the subcommands hang out with them 💜

• --dry-run — print the command that would be executed, but do not actually execute it. a little peek, no commitment 🙈
• --no-ioctl-probing — disable probing for 64-bit IOCTL support.
• --no-retries — disable retry logic on transient errors.
• -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. (that stray apostrophe before json` is canon, don't @ me 🍓)
• --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. sorry to those versions 💀
• --quiet — suppress informational messages. errors are still reported, and --quiet cancels any --verbose for the library log level. shhh 🤫
• --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. mix and match, slay ✨
• --timeout=<ms> — set the timeout for the command in milliseconds. infinite or -1 waits without a time limit (0xffffffff). no clock, no stress ⏳
• -v, --verbose — increase the level of detail in the output. may be specified multiple times to further increase verbosity. say it with me: more v's, more tea 🔥

these options can also be set as machine-wide defaults in nvme-cli.conf(5). a command-line flag always overrides the file. periodt 👑

---

✨ EXAMPLES ✨

• resizes namespace 1 to 50% of the original TNVMCAP reported value:

# nvme wdc namespace-resize /dev/nvme0 -n 1 -O 3

• resizes namespace 2 to 7% of the original TNVMCAP reported value:

# nvme wdc namespace-resize /dev/nvme0 --namespace-id=2 --op-option=1

see? two lines and you're a namespace-resizing legend 🌈

---

✨ NVME ✨

part of the nvme-user suite. you're in good company, bestie 🧚

---

and that's the whole page, no crumbs left 💖 this gorgeous little number comes from the NVMe folks, dated 10/30/2026, filed under NVME-WDC-NAMESPACE(1) — go forth and resize responsibly, mwah 😘