From dc597ce8df5ae6efd2728a2d7ba7d92486028f79 Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Fri, 2 Jul 2021 22:40:30 +0200 Subject: Adding upstream version 1.12. Signed-off-by: Daniel Baumann --- Documentation/nvme-wdc-get-crash-dump.txt | 52 +++++++++++++++++++++++++++++++ 1 file changed, 52 insertions(+) create mode 100644 Documentation/nvme-wdc-get-crash-dump.txt (limited to 'Documentation/nvme-wdc-get-crash-dump.txt') diff --git a/Documentation/nvme-wdc-get-crash-dump.txt b/Documentation/nvme-wdc-get-crash-dump.txt new file mode 100644 index 0000000..109daca --- /dev/null +++ b/Documentation/nvme-wdc-get-crash-dump.txt @@ -0,0 +1,52 @@ +nvme-wdc-get-crash-dump(1) +========================== + +NAME +---- +nvme-wdc-get-crash-dump - Retrieve WDC device's crash dump. + +SYNOPSIS +-------- +[verse] +'nvme wdc get-crash-dump' [--output-file=, -o ] + +DESCRIPTION +----------- +For the NVMe device given, sends the WDC vendor unique crash dump +request and saves the result to file. In current implementation crash dump is +captured if it is present. On success it will save the dump in file with +appropriate suffix. Note that this command will clear the available +dump from the device on success. + +The parameter is mandatory NVMe character device (ex: /dev/nvme0). + +This will only work on WDC devices supporting this feature. +Results for any other device are undefined. + +OPTIONS +------- +-o :: +--output-file=:: + Output file; defaults to device serial number followed by "crash_dump" suffix + +EXAMPLES +-------- +* Gets the crash dump from the device and saves to default file in current directory (e.g. STM00019F3F9crash_dump.bin): ++ +------------ +# nvme wdc get-crash-dump /dev/nvme0 +------------ +* Gets the crash dump from the device and saves to defined file in current directory (e.g. testSTM00019F3F9crash_dump.bin): ++ +------------ +# nvme wdc get-crash-dump /dev/nvme0 -o test +------------ +* Gets the crash dump from the device and saves to defined file with pathname (e.g. /tmp/testSTM00019F3F9crash_dump.bin): ++ +------------ +# nvme wdc get-crash-dump /dev/nvme0 -o /tmp/test +------------ + +NVME +---- +Part of the nvme-user suite -- cgit v1.2.3