1NVME-SELF-TEST-LO(1)              NVMe Manual             NVME-SELF-TEST-LO(1)
2
3
4

NAME

6       nvme-self-test-log - Retrieve the log information initiated by
7       device-self-test and display it
8

SYNOPSIS

10       nvme self-test-log <device> [--log-entries=<entries> | -e <entries>]
11                           [--output-format=<FMT> | -o <FMT>]
12

DESCRIPTION

14       Retrieves the log pages from an NVMe device corresponding to the
15       requested self-test by the user and provides 20-most recent result
16       returned structure.
17
18       The <device> parameter is mandatory and may be either the NVMe
19       character device (ex: /dev/nvme0), or a namespace block device (ex:
20       /dev/nvme0n1).
21
22       On success, the returned log structure may be returned in one of
23       several ways depending on the option flags; the structure may parsed by
24       the program and printed in a readable format or the raw buffer or the
25       json format.
26
27       By default the log is printed out in the normal readable format.
28

OPTION

30       -e <entries>, --log-entries=<entries>
31           Specifies how many DST log entries the program should request from
32           the device. This must be at least one, and shouldn’t exceed the 20
33           entries. Defaults to 20 DST log entries.
34
35       -o <format>, --output-format=<format>
36           Set the reporting format to normal, json, or binary. Only one
37           output format can be used at a time.
38

EXAMPLES

40       •   Get the self-test-log and print it in a human readable format:
41
42               # nvme self-test-log /dev/nvme0
43
44       •   Print the raw output to a file:
45
46               # nvme self-test-log /dev/nvme0 -o "binary"
47
48       •   Get the self-test-log and print it in a json format:
49
50               # nvme self-test-log /dev/nvme0 -o "json"
51

NVME

53       Part of the nvme-user suite
54
55
56
57NVMe                              09/29/2023              NVME-SELF-TEST-LO(1)