Manpages

NAME

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

SYNOPSIS

nvme self-test-log <device> [--log-entries=<entries> | -e <entries>]
[--output-format=<fmt> | -o <fmt>] [--verbose | -v]

DESCRIPTION

Retrieves the log pages from an NVMe device corresponding to the requested self-test by the user and provides 20-most recent result returned structure.

The <device> parameter is mandatory and may be either the NVMe character device (ex: /dev/nvme0), or a namespace block device (ex: /dev/nvme0n1).

On success, the returned log structure may be returned in one of several ways depending on the option flags; the structure may parsed by the program and printed in a readable format or the raw buffer or the json format.

By default the log is printed out in the normal readable format.

OPTION

-e <entries>, --log-entries=<entries>

Specifies how many DST log entries the program should request from the device. This must be at least one, and shouldn’t exceed the 20 entries. Defaults to 20 DST log entries.

-o <fmt>, --output-format=<fmt>

Set the reporting format to normal, json or binary. Only one output format can be used at a time.

-v, --verbose

Increase the information detail in the output.

EXAMPLES

• Get the self-test-log and print it in a human readable format:

# nvme self-test-log /dev/nvme0

• Print the raw output to a file:

# nvme self-test-log /dev/nvme0 -o "binary"

• Get the self-test-log and print it in a json format:

# nvme self-test-log /dev/nvme0 -o "json"

NVME

Part of the nvme-user suite