Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
NVME-ERROR-LOG(1)		   NVMe Manual		       NVME-ERROR-LOG(1)

NAME
     nvme-error-log - Send NVME Error log page request, return result and log

SYNOPSIS
     nvme error-log <device> [--log-entries=<entries> | -e <entries>]
			     [--raw-binary | -b]
			     [--output-format=<fmt> | -o <fmt>] [--verbose | -v]

DESCRIPTION
     Retrieves NVMe Error log page from an NVMe device and provides the 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 error log structure may be returned in one of sev-
     eral ways depending on the option flags; the structure may  parsed  by  the
     program  and  printed in a readable format or the raw buffer may be printed
     to stdout for another program to parse.

OPTIONS
     -e <entries>, --log-entries=<entries>
	 Specifies how many log entries the program should request from the  de-
	 vice.	This must be at least one, and shouldn't exceed the device's ca-
	 pabilities. Defaults to 64 log entries.

     -b, --raw-binary
	 Print the raw error log buffer to stdout.

     -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 error log and print it in a human readable format:

	     # nvme error-log /dev/nvme0

     *	 Print the raw output to a file:

	     # nvme error-log /dev/nvme0 --raw-binary > error_log.raw

	 It is probably a bad idea to not redirect stdout when using this mode.

NVME
     Part of the nvme-user suite

NVMe				   10/31/2024		       NVME-ERROR-LOG(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=nvme-error-log&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help