NVME-WDC-PURGE(1)

🦋 nvme-wdc-purge — the NVMe Manual page, bestie edition ✨

okay so picture this: you're holding a man page from the NVMe Manual, and it's about one very specific little command. let's get into it 💅

---

💖 NAME 💖

nvme-wdc-purge — sends the NVMe WDC Purge Vendor Unique Command, and then hands you back the result. that's it, that's the vibe 🫶

---

✨ SYNOPSIS ✨

nvme [<global-options>] wdc purge <device>

---

🌸 DESCRIPTION 🌸

so for the NVMe device you point at, this thing sends a Vendor Unique WDC Purge command and gives you the result back. slay.

the <device> parameter is mandatory — like, non-negotiable, you gotta give it one 🙈 — and it can be either:

• the NVMe character device (example: /dev/nvme0), or
• a namespace block device (example: /dev/nvme0n1)

⚠️ real talk: this will only work on WDC devices that support this feature. results for any other device are undefined — as in, nobody knows what happens, and we're not finding out together 💀

on success it returns 0. otherwise you get an error code. periodt.

---

🎀 OPTIONS 🎀

no options yet. literally none. she's minimal, she's mysterious, she's iconic ✨

---

👑 GLOBAL OPTIONS 👑

these bad boys are defined at the top-level nvme command and they're all available to this subcommand too:

• --dry-run — prints the command that would be executed, but does not actually execute it. window shopping, essentially 🛍️
• --no-ioctl-probing — turns off probing for 64-bit IOCTL support.
• --no-retries — disables the retry logic on transient errors. no second chances, we move 💅
• -o <fmt>, --output-format=<fmt> — sets the reporting format to normal, tabular, 'json, or binary. only one output format at a time, pick your fighter.
• --output-format-version=<version> — selects the output format version. version 1 uses the original field naming, while version 2 (the default) gives you more consistent and script-friendly field names. any other version? rejected. hard pass 🚫
• --quiet — suppresses informational messages. errors still get 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. 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). the patience of a saint, fr.
• -v, --verbose — increases the level of detail in the output. you can specify it multiple times to crank the verbosity even higher 📈

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

---

🌈 EXAMPLES 🌈

• has the program issue the WDC Purge Vendor Unique Command:

# nvme wdc purge /dev/nvme0n1

---

⭐ NVME ⭐

part of the nvme-user suite 🧚

---

and that's the whole page, bestie 💖 this was <NVMe>, dated 10/30/2026 — catch you on the next NVME-WDC-PURGE(1) 🎀