|
Packit Service |
b7b338 |
nvme-sanitize(1)
|
|
Packit Service |
b7b338 |
================
|
|
Packit Service |
b7b338 |
|
|
Packit Service |
b7b338 |
NAME
|
|
Packit Service |
b7b338 |
----
|
|
Packit Service |
b7b338 |
nvme-sanitize - Send NVMe Sanitize Command, return result
|
|
Packit Service |
b7b338 |
|
|
Packit Service |
b7b338 |
SYNOPSIS
|
|
Packit Service |
b7b338 |
--------
|
|
Packit Service |
b7b338 |
[verse]
|
|
Packit Service |
b7b338 |
'nvme sanitize' <device> [--no-dealloc | -d]
|
|
Packit Service |
b7b338 |
[--oipbp | -i]
|
|
Packit Service |
b7b338 |
[--owpass=<overwrite-pass-count> | -n <overwrite-pass-count>]
|
|
Packit Service |
b7b338 |
[--ause | -u]
|
|
Packit Service |
b7b338 |
[--sanact=<action> | -a <action>]
|
|
Packit Service |
b7b338 |
[--ovrpat=<overwrite-pattern> | -p <overwrite-pattern>]
|
|
Packit Service |
b7b338 |
|
|
Packit Service |
b7b338 |
DESCRIPTION
|
|
Packit Service |
b7b338 |
-----------
|
|
Packit Service |
b7b338 |
For the NVMe device given, sends a Sanitize command and
|
|
Packit Service |
b7b338 |
provides the result.
|
|
Packit Service |
b7b338 |
|
|
Packit Service |
b7b338 |
The <device> parameter is mandatory NVMe character device (ex: /dev/nvme0).
|
|
Packit Service |
b7b338 |
|
|
Packit Service |
b7b338 |
On success it returns 0, error code otherwise.
|
|
Packit Service |
b7b338 |
|
|
Packit Service |
b7b338 |
OPTIONS
|
|
Packit Service |
b7b338 |
-------
|
|
Packit Service |
b7b338 |
-d::
|
|
Packit Service |
b7b338 |
--no-delloc::
|
|
Packit Service |
b7b338 |
No Deallocate After Sanitize:
|
|
Packit Service |
b7b338 |
If set, then the controller shall not deallocate any logical
|
|
Packit Service |
b7b338 |
blocks as a result of successfully completing the sanitize
|
|
Packit Service |
b7b338 |
operation. If cleared, then the controller should deallocate
|
|
Packit Service |
b7b338 |
logical blocks as a result of successfully completing the
|
|
Packit Service |
b7b338 |
sanitize operation. This bit shall be ignored if the Sanitize
|
|
Packit Service |
b7b338 |
Action field is set to 001b (i.e., Exit Failure Mode).
|
|
Packit Service |
b7b338 |
|
|
Packit Service |
b7b338 |
-i::
|
|
Packit Service |
b7b338 |
--oipbp::
|
|
Packit Service |
b7b338 |
Overwrite Invert Pattern Between Passes:
|
|
Packit Service |
b7b338 |
If set, then the Overwrite Pattern shall be inverted between
|
|
Packit Service |
b7b338 |
passes. If cleared, then the overwrite pattern shall not be
|
|
Packit Service |
b7b338 |
inverted between passes. This bit shall be ignored unless the
|
|
Packit Service |
b7b338 |
Sanitize Action field is set to 011b (i.e., Overwrite).
|
|
Packit Service |
b7b338 |
|
|
Packit Service |
b7b338 |
-n <overwrite-pass-count>::
|
|
Packit Service |
b7b338 |
--owpass=<overwrite-pass-count>::
|
|
Packit Service |
b7b338 |
Overwrite Pass Count:
|
|
Packit Service |
b7b338 |
This field specifies the number of overwrite passes (i.e.,
|
|
Packit Service |
b7b338 |
how many times the media is to be overwritten) using the data
|
|
Packit Service |
b7b338 |
from the Overwrite Pattern field of this command. A value of 0
|
|
Packit Service |
b7b338 |
specifies 16 overwrite passes. This field shall be ignored
|
|
Packit Service |
b7b338 |
unless the Sanitize Action field is set to 011b (i.e., Overwrite).
|
|
Packit Service |
b7b338 |
|
|
Packit Service |
b7b338 |
-u::
|
|
Packit Service |
b7b338 |
--ause::
|
|
Packit Service |
b7b338 |
Allow Unrestricted Sanitize Exit:
|
|
Packit Service |
b7b338 |
If set, then the sanitize operation is performed in unrestricted
|
|
Packit Service |
b7b338 |
completion mode. If cleared then the sanitize operation is
|
|
Packit Service |
b7b338 |
performed in restricted completion mode. This bit shall be ignored
|
|
Packit Service |
b7b338 |
if the Sanitize Action field is set to 001b (i.e., Exit Failure Mode).
|
|
Packit Service |
b7b338 |
|
|
Packit Service |
b7b338 |
-a <action>::
|
|
Packit Service |
b7b338 |
--sanact=<action>::
|
|
Packit Service |
b7b338 |
Sanitize Action:
|
|
Packit Service |
b7b338 |
000b - Reserved
|
|
Packit Service |
b7b338 |
001b - Exit Failure Mode
|
|
Packit Service |
b7b338 |
010b - Start a Block Erase sanitize operation
|
|
Packit Service |
b7b338 |
011b - Start an Overwrite sanitize operation
|
|
Packit Service |
b7b338 |
100b - Start a Crypto Erase sanitize operation
|
|
Packit Service |
b7b338 |
|
|
Packit Service |
b7b338 |
-p <overwrite-pattern>::
|
|
Packit Service |
b7b338 |
--ovrpat=<overwrite-pattern>::
|
|
Packit Service |
b7b338 |
Overwrite Pattern:
|
|
Packit Service |
b7b338 |
This field is ignored unless the Sanitize Action field in
|
|
Packit Service |
b7b338 |
Command Dword 10 is set to 011b (i.e., Overwrite). This field
|
|
Packit Service |
b7b338 |
specifies a 32-bit pattern that is used for the Overwrite
|
|
Packit Service |
b7b338 |
sanitize operation.
|
|
Packit Service |
b7b338 |
|
|
Packit Service |
b7b338 |
EXAMPLES
|
|
Packit Service |
b7b338 |
--------
|
|
Packit Service |
b7b338 |
* Has the program issue Sanitize Command :
|
|
Packit Service |
b7b338 |
+
|
|
Packit Service |
b7b338 |
------------
|
|
Packit Service |
b7b338 |
# nvme sanitize /dev/nvme0n1 -a 0x02
|
|
Packit Service |
b7b338 |
# nvme sanitize /dev/nvme0n1 --sanact=0x01
|
|
Packit Service |
b7b338 |
|
|
Packit Service |
b7b338 |
------------
|
|
Packit Service |
b7b338 |
|
|
Packit Service |
b7b338 |
NVME
|
|
Packit Service |
b7b338 |
----
|
|
Packit Service |
b7b338 |
Part of the nvme-user suite.
|