nvme-self-test-log

NVME-SELF-TEST-LO(1) NVMe Manual NVME-SELF-TEST-LO(1)

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 shouldnt 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

NVMe 05/02/2025 NVME-SELF-TEST-LO(1)