1NVME-WDC-CAP-DIAG(1)              NVMe Manual             NVME-WDC-CAP-DIAG(1)
2
3
4

NAME

6       nvme-wdc-cap-diag - Retrieve WDC device's diagnostic log and save to
7       file.
8

SYNOPSIS

10       nvme wdc cap-diag <device> [--output-file=<FILE>, -o <FILE>] [--transfer-size=<SIZE>, -s <SIZE>]
11

DESCRIPTION

13       For the NVMe device given, sends the WDC Vendor Unique
14       Capture-Diagnostics request and saves the result to a file.
15
16       The <device> parameter is mandatory NVMe character device (ex:
17       /dev/nvme0).
18
19       This will only work on WDC devices supporting this feature. Results for
20       any other device are undefined.
21

OPTIONS

23       -o <FILE>, --output-file=<FILE>
24           Output file; defaults to device serial number followed by
25           "cap_diag" suffix
26
27       -s <SIZE>, --transfer-size=<SIZE>
28           Transfer size; defaults to 0x10000 (65536 decimal) bytes
29

EXAMPLES

31       •   Gets the capture diagnostics log from the device and saves to
32           default file in current directory (e.g. STM00019F3F9cap_diag.bin):
33
34               # nvme wdc cap-diag /dev/nvme0
35
36       •   Gets the capture diagnostics log from the device and saves to
37           defined file in current directory (e.g.
38           testSTM00019F3F9cap_diag.bin):
39
40               # nvme wdc cap-diag /dev/nvme0 -o test
41
42       •   Gets the capture diagnostics log from the device and saves to
43           defined file with pathname (e.g.
44           /tmp/testSTM00019F3F9cap_diag.bin):
45
46               # nvme wdc cap-diag /dev/nvme0 -o /tmp/test
47
48       •   Gets the capture diagnostics log from the device transferring the
49           data in 64k chunks and saves to default file in current directory
50           (e.g. STM00019F3F9internal_fw_log.bin):
51
52               # nvme wdc cap-diag /dev/nvme0 -s 0x10000
53
54       •   Gets the capture diagnostics log from the device transferring the
55           data in 16k chunks and saves to default file in current directory
56           (e.g. STM00019F3F9internal_fw_log.bin):
57
58               # nvme wdc cap-diag /dev/nvme0 -s 16384
59

NVME

61       Part of the nvme-user suite.
62
63
64
65NVMe                              09/29/2023              NVME-WDC-CAP-DIAG(1)
Impressum