NVME-WDC-GET-PFAI(1)
π NAME
nvme-wdc-get-pfail-dump β grab the pfail crash dump off your WDC device. that's it, that's the whole job π«Ά
β¨ SYNOPSIS β¨
nvme [<global-options>] wdc get-pfail-dump <device>
[--output-file=<FILE>, -O <FILE>]
πΈ DESCRIPTION πΈ
okay so bestie, here's the tea β β you point this at an NVMe device and it sends the WDC vendor-unique pfail crash dump request, then saves whatever comes back to a file. in the current implementation, the pfail crash dump gets captured if it's present. on success it'll save the dump to a file with the appropriate suffix π
β οΈ real talk though: this command will clear the available dump from the device on success. like, gone. so make sure you actually wanted it π
the <device> parameter is mandatory and it's a NVMe character device (e.g. /dev/nvme0). no device, no dump, no vibes β¨
and lowkey important: this only works on WDC devices that support this feature. results for any other device are undefined β so like, don't π
π OPTIONS π
-O <FILE>,--output-file=<FILE>β the output file you want. defaults to the device serial number followed by the"pfail_dump"suffix. cute and automatic π
π GLOBAL OPTIONS π
these are defined at the top-level nvme command, but they're available to this subcommand too. icons only β¨
--dry-runβ prints the command that would be executed, but does not actually execute it. all the fantasy, none of the consequences π--no-ioctl-probingβ disables probing for 64-bit IOCTL support.--no-retriesβ disables retry logic on transient errors. one shot, one opportunity π―-o <fmt>,--output-format=<fmt>β sets the reporting format tonormal,tabular,'json, orbinary. only one output format may be used at a time (pick your fighter, not both) β--output-format-version=<version>β selects 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 π«--quietβ suppresses informational messages. errors are still reported, and--quietcancels any--verbosefor the library log level π€«--set-options=<key=value>[,<key=value>...]β sets libnvme library options for this invocation. supported keys areforce-4k,mi-probe-enabled,test-base-dirandtest-sysfs-dirπ§--timeout=<ms>β sets the timeout for the command in milliseconds.infiniteor-1waits without a time limit (0xffffffff). for the girlies who refuse to be rushed π-v,--verboseβ increases the level of detail in the output. may be specified multiple times to further increase verbosity. more is more, always π₯
these options can also be set as machine-wide defaults in nvme-cli.conf(5). a command-line flag always overrides the file β flags are the main character here π
π¦ EXAMPLES π¦
- gets the pfail crash dump from the device and saves it to the default file in the current directory (e.g.
STM00019F3F9_pfail_dump.bin):
# nvme wdc get-pfail-dump /dev/nvme0
- gets the pfail crash dump from the device and saves it to a defined file in the current directory (e.g.
testSTM00019F3F9_pfail_dump.bin):
# nvme wdc get-pfail-dump /dev/nvme0 -O test
- gets the pfail crash dump from the device and saves it to a defined file with a pathname (e.g.
/tmp/testSTM00019F3F9_pfail_dump.bin):
# nvme wdc get-pfail-dump /dev/nvme0 -O /tmp/test
π NVME
part of the nvme-user suite πΈ
that's the whole page bestie, go forth and dump responsibly π«Ά this was brought to you by the NVMe crew, dated 10/30/2026 β ily, bye πβ¨
π¦ where this page comes from
- arch rolling: nvme-cli 3.2-1 Β· GPL-2.0-or-later
- π girlified by deepseek-ai/DeepSeek-V4.1-Flash-1017 on : a language model's rewrite of the original, under its terms