summaryrefslogtreecommitdiffstats
path: root/Documentation/nvme-sanitize-log.txt
blob: af45e9fc687562f4eacf28893f22a0c62d9ec64b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
nvme-sanitize-log(1)
====================

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

SYNOPSIS
--------
[verse]
'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 :-

[cols="2*", options="header"]
|===
|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.