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

FreeBSD Manual Pages

  
 
  

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

NAME
       nvme-sanitize-log - Send	NVMe sanitize-log Command, return result

SYNOPSIS
       nvme sanitize-log <device> [--rae | -r] [--human-readable | -H]
			       [--raw-binary | -b]
			       [--output-format=<fmt> |	-o <fmt>] [--verbose | -v]

DESCRIPTION
       Retrieves the NVMe Sanitize log page from an NVMe device	and provides
       the status of sanitize command.

       The <device> parameter is mandatory NVMe	character device (ex:
       /dev/nvme0).

       Expected	status and description :-
       +-------------+----------------------------+
       | Status	Code | Description		  |
       +-------------+----------------------------+
       |	     |				  |
       | 0x0000	     | NVM subsystem has never	  |
       |	     | been sanitized.		  |
       +-------------+----------------------------+
       |	     |				  |
       | 0x0001	     | The most	recent sanitize	  |
       |	     | operation completed	  |
       |	     | successfully.		  |
       +-------------+----------------------------+
       |	     |				  |
       | 0x0002	     | A sanitize operation is	  |
       |	     | currently in progress.	  |
       +-------------+----------------------------+
       |	     |				  |
       | 0x0003	     | The most	recent sanitize	  |
       |	     | operation failed.	  |
       +-------------+----------------------------+
       |	     |				  |
       | 0x0100	     | Global Data Erased bit If  |
       |	     | set to 1	then non-volatile |
       |	     | storage in the NVM	  |
       |	     | subsystem has not been	  |
       |	     | written to: a) since being |
       |	     | manufactured and	the NVM	  |
       |	     | subsystem has never been	  |
       |	     | sanitized; or b)	since the |
       |	     | most recent successful	  |
       |	     | sanitize	operation. If	  |
       |	     | cleared to 0, then	  |
       |	     | non-volatile storage in	  |
       |	     | the NVM subsystem has been |
       |	     | written to: a) since being |
       |	     | manufactured and	the NVM	  |
       |	     | subsystem has never been	  |
       |	     | sanitized; or b)	since the |
       |	     | most recent successful	  |
       |	     | sanitize	operation of the  |
       |	     | NVM subsystem.		  |
       +-------------+----------------------------+

       Sanitize	Progress - percentage complete

       On success it returns 0,	error code otherwise.

OPTIONS
       -r, --rae
	   Retain an Asynchronous Event.

       -H, --human-readable
	   This	option will parse and format many of the bit fields into
	   human-readable formats.

       -b, --raw-binary
	   Print the raw buffer	to stdout. Structure is	not parsed by program.
	   This	overrides the vendor specific and human	readable options.

       -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
          Has the program issue Sanitize-log Command :

	       # nvme sanitize-log /dev/nvme0

NVME
       Part of the nvme-user suite.

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

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

home | help