From fb32fdeba1f428a3f6c30c8951e82f2a2eec23a8 Mon Sep 17 00:00:00 2001
From: Daniel Baumann
Date: Thu, 12 Aug 2021 14:01:09 +0200
Subject: Merging upstream version 1.15.
Signed-off-by: Daniel Baumann
---
Documentation/nvme-admin-passthru.1 | 14 +-
Documentation/nvme-admin-passthru.html | 26 +-
Documentation/nvme-admin-passthru.txt | 5 +
Documentation/nvme-capacity-mgmt.1 | 71 ++
Documentation/nvme-capacity-mgmt.html | 845 +++++++++++++++++++++++
Documentation/nvme-capacity-mgmt.txt | 54 ++
Documentation/nvme-compare.1 | 14 +-
Documentation/nvme-compare.html | 27 +-
Documentation/nvme-compare.txt | 6 +
Documentation/nvme-connect-all.txt | 10 +-
Documentation/nvme-connect.txt | 17 +-
Documentation/nvme-discover.txt | 20 +-
Documentation/nvme-get-feature.1 | 26 +-
Documentation/nvme-get-feature.html | 33 +-
Documentation/nvme-get-feature.txt | 9 +
Documentation/nvme-get-lba-status.1 | 134 ++++
Documentation/nvme-get-lba-status.html | 903 +++++++++++++++++++++++++
Documentation/nvme-get-lba-status.txt | 82 +++
Documentation/nvme-get-log.1 | 40 +-
Documentation/nvme-get-log.html | 53 +-
Documentation/nvme-get-log.txt | 30 +-
Documentation/nvme-id-domain.1 | 62 ++
Documentation/nvme-id-domain.html | 819 +++++++++++++++++++++++
Documentation/nvme-id-domain.txt | 40 ++
Documentation/nvme-id-iocs.1 | 43 +-
Documentation/nvme-id-iocs.html | 38 +-
Documentation/nvme-id-iocs.txt | 17 +-
Documentation/nvme-io-passthru.1 | 14 +-
Documentation/nvme-io-passthru.html | 21 +-
Documentation/nvme-io-passthru.txt | 5 +
Documentation/nvme-list-ctrl.1 | 18 +-
Documentation/nvme-list-ctrl.html | 28 +-
Documentation/nvme-list-ctrl.txt | 7 +-
Documentation/nvme-list-ns.1 | 59 +-
Documentation/nvme-list-ns.html | 37 +-
Documentation/nvme-list-ns.txt | 19 +-
Documentation/nvme-micron-smart-add-log.1 | 87 +++
Documentation/nvme-micron-smart-add-log.html | 815 +++++++++++++++++++++++
Documentation/nvme-micron-smart-add-log.txt | 54 ++
Documentation/nvme-primary-ctrl-caps.1 | 104 +++
Documentation/nvme-primary-ctrl-caps.html | 842 +++++++++++++++++++++++
Documentation/nvme-primary-ctrl-caps.txt | 53 ++
Documentation/nvme-read.1 | 14 +-
Documentation/nvme-read.html | 17 +-
Documentation/nvme-read.txt | 6 +
Documentation/nvme-resv-register.1 | 2 +-
Documentation/nvme-resv-register.html | 2 +-
Documentation/nvme-resv-register.txt | 2 +-
Documentation/nvme-set-feature.1 | 16 +-
Documentation/nvme-set-feature.html | 27 +-
Documentation/nvme-set-feature.txt | 7 +
Documentation/nvme-verify.1 | 151 +++++
Documentation/nvme-verify.html | 961 +++++++++++++++++++++++++++
Documentation/nvme-verify.txt | 93 +++
Documentation/nvme-write-zeroes.1 | 34 +-
Documentation/nvme-write-zeroes.html | 49 +-
Documentation/nvme-write-zeroes.txt | 13 +-
Documentation/nvme-write.1 | 14 +-
Documentation/nvme-write.html | 17 +-
Documentation/nvme-write.txt | 6 +
Documentation/nvme-zns-close-zone.1 | 12 +-
Documentation/nvme-zns-finish-zone.1 | 12 +-
Documentation/nvme-zns-offline-zone.1 | 12 +-
Documentation/nvme-zns-open-zone.1 | 12 +-
Documentation/nvme-zns-reset-zone.1 | 10 +-
Documentation/nvme-zns-set-zone-desc.1 | 10 +-
Documentation/nvme-zns-zone-mgmt-send.1 | 16 +-
67 files changed, 6945 insertions(+), 171 deletions(-)
create mode 100644 Documentation/nvme-capacity-mgmt.1
create mode 100644 Documentation/nvme-capacity-mgmt.html
create mode 100644 Documentation/nvme-capacity-mgmt.txt
create mode 100644 Documentation/nvme-get-lba-status.1
create mode 100644 Documentation/nvme-get-lba-status.html
create mode 100644 Documentation/nvme-get-lba-status.txt
create mode 100644 Documentation/nvme-id-domain.1
create mode 100644 Documentation/nvme-id-domain.html
create mode 100644 Documentation/nvme-id-domain.txt
create mode 100644 Documentation/nvme-micron-smart-add-log.1
create mode 100644 Documentation/nvme-micron-smart-add-log.html
create mode 100644 Documentation/nvme-micron-smart-add-log.txt
create mode 100644 Documentation/nvme-primary-ctrl-caps.1
create mode 100644 Documentation/nvme-primary-ctrl-caps.html
create mode 100644 Documentation/nvme-primary-ctrl-caps.txt
create mode 100644 Documentation/nvme-verify.1
create mode 100644 Documentation/nvme-verify.html
create mode 100644 Documentation/nvme-verify.txt
(limited to 'Documentation')
diff --git a/Documentation/nvme-admin-passthru.1 b/Documentation/nvme-admin-passthru.1
index 286709f..8cf0095 100644
--- a/Documentation/nvme-admin-passthru.1
+++ b/Documentation/nvme-admin-passthru.1
@@ -1,13 +1,13 @@
'\" t
.\" Title: nvme-admin-passthru
-.\" Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author]
-.\" Generator: DocBook XSL Stylesheets vsnapshot
-.\" Date: 10/20/2020
+.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
+.\" Generator: DocBook XSL Stylesheets v1.79.1
+.\" Date: 06/04/2021
.\" Manual: NVMe Manual
.\" Source: NVMe
.\" Language: English
.\"
-.TH "NVME\-ADMIN\-PASSTHR" "1" "10/20/2020" "NVMe" "NVMe Manual"
+.TH "NVME\-ADMIN\-PASSTHR" "1" "06/04/2021" "NVMe" "NVMe Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
@@ -46,6 +46,7 @@ nvme-admin-passthru \- Submit an arbitrary admin command, return results
[\-\-dry\-run | \-d]
[\-\-raw\-binary | \-b]
[\-\-prefill= | \-p ]
+ [\-\-latency | \-T]
.fi
.SH "DESCRIPTION"
.sp
@@ -123,6 +124,11 @@ Print the raw returned buffer to stdout if the command returns a structure\&.
.RS 4
Prefill the buffer with a predetermined byte value\&. Defaults to 0\&. This may be useful if the data you are writing is shorter than the required buffer, and you need to pad it with a known value\&. It may also be useful if you need to confirm if a device is overwriting a buffer for a data\-in command\&.
.RE
+.PP
+\-T, \-\-latency
+.RS 4
+Print out the latency the IOCTL took (in us)\&.
+.RE
.SH "EXAMPLES"
.sp
.RS 4
diff --git a/Documentation/nvme-admin-passthru.html b/Documentation/nvme-admin-passthru.html
index 4a113ba..63a7a10 100644
--- a/Documentation/nvme-admin-passthru.html
+++ b/Documentation/nvme-admin-passthru.html
@@ -1,9 +1,10 @@
+
-
+
nvme-admin-passthru(1)
+
+
+
+
+
+
+
SYNOPSIS
+
+
+
nvme capacity-mgmt <device> [--operation=<operation> | -o <operation>]
+ [--element-id=<element-id> | -i <element-id>]
+ [--cap-lower=<cap-lower> | -l <cap-lower>]
+ [--cap-upper=<cap-upper> | -u <cap-upper>]
+
+
+
+
+
+
DESCRIPTION
+
+
For the NVMe device given, sends a capacity management command to configure/create/delete
+the Endurance Groups or NVM Sets with the requested operation and element_id. On success,
+if the Operation is Create Endurance group or NVM Set, CQE CDW0 contains Created element
+identifier else CQE CDW0 is reserved.
+
The <device> parameter is mandatory and may be either the NVMe character
+device (ex: /dev/nvme0), or a namespace block device (ex: /dev/nvme0n1).
+
+
+
+
OPTIONS
+
+
+-
+-o <operation>
+
+-
+--operation=<operation>
+
+-
+
+ Operation to be performed by the controller
+
+
+-
+-i <element-id>
+
+-
+--element-id=<element-id>
+
+-
+
+ Value specific to the value of the Operation field.
+
+
+-
+-l <cap-lower>
+
+-
+--cap-lower=<cap-lower>
+
+-
+
+ Least significant 32 bits of the capacity in bytes of the Endurance Group or
+ NVM Set to be created
+
+
+-
+-u <cap-upper>
+
+-
+--cap-upper=<cap-upper>
+
+-
+
+ Most significant 32 bits of the capacity in bytes of the Endurance Group or
+ NVM Set to be created
+
+
+
+
+
+
+
EXAMPLES
+
+
No examples provided yet.
+
+
+
+
NVME
+
+
Part of the nvme-user suite
+
+
+
+
+
+
+
diff --git a/Documentation/nvme-capacity-mgmt.txt b/Documentation/nvme-capacity-mgmt.txt
new file mode 100644
index 0000000..96274cf
--- /dev/null
+++ b/Documentation/nvme-capacity-mgmt.txt
@@ -0,0 +1,54 @@
+nvme-capacity-mgmt(1)
+=====================
+
+NAME
+----
+nvme-capacity-mgmt - Send capacity management command to configure/create/delete
+ Endurance Groups or NVM Sets, returns results.
+
+SYNOPSIS
+--------
+[verse]
+'nvme capacity-mgmt' [--operation= | -o ]
+ [--element-id= | -i ]
+ [--cap-lower= | -l ]
+ [--cap-upper= | -u ]
+
+DESCRIPTION
+-----------
+For the NVMe device given, sends a capacity management command to
+configure/create/delete the Endurance Groups or NVM Sets with the requested
+operation and element_id. On success, if the Operation is Create Endurance
+group or NVM Set, CQE CDW0 contains Created element identifier else CQE CDW0 is
+reserved.
+
+The parameter is mandatory and may be either the NVMe character
+device (ex: /dev/nvme0), or a namespace block device (ex: /dev/nvme0n1).
+
+OPTIONS
+-------
+-o ::
+--operation=::
+ Operation to be performed by the controller
+
+-i ::
+--element-id=::
+ Value specific to the value of the Operation field.
+
+-l ::
+--cap-lower=::
+ Least significant 32 bits of the capacity in bytes of the Endurance Group or
+ NVM Set to be created
+
+-u ::
+--cap-upper=::
+ Most significant 32 bits of the capacity in bytes of the Endurance Group or
+ NVM Set to be created
+
+EXAMPLES
+--------
+No examples provided yet.
+
+NVME
+----
+Part of the nvme-user suite
\ No newline at end of file
diff --git a/Documentation/nvme-compare.1 b/Documentation/nvme-compare.1
index 0638190..ada1790 100644
--- a/Documentation/nvme-compare.1
+++ b/Documentation/nvme-compare.1
@@ -1,13 +1,13 @@
'\" t
.\" Title: nvme-compare
-.\" Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author]
-.\" Generator: DocBook XSL Stylesheets vsnapshot
-.\" Date: 10/20/2020
+.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
+.\" Generator: DocBook XSL Stylesheets v1.79.1
+.\" Date: 07/09/2021
.\" Manual: NVMe Manual
.\" Source: NVMe
.\" Language: English
.\"
-.TH "NVME\-COMPARE" "1" "10/20/2020" "NVMe" "NVMe Manual"
+.TH "NVME\-COMPARE" "1" "07/09/2021" "NVMe" "NVMe Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
@@ -50,6 +50,7 @@ nvme-compare \- Send an NVMe Compare command, provide results
[\-\-show\-command | \-v]
[\-\-dry\-run | \-w]
[\-\-latency | \-t]
+ [\-\-storage\-tag\-check | \-C ]
.fi
.SH "DESCRIPTION"
.sp
@@ -202,6 +203,11 @@ be set\&. Otherwise \-\-dry\-run option will be
.RS 4
Print out the latency the IOCTL took (in us)\&.
.RE
+.PP
+\-\-storage\-tag\-check=, \-C
+.RS 4
+This bit specifies the Storage Tag field shall be checked as part of end\-to\-end data protection processing\&.
+.RE
.SH "EXAMPLES"
.sp
No examples yet\&.
diff --git a/Documentation/nvme-compare.html b/Documentation/nvme-compare.html
index e3b6857..0c13e32 100644
--- a/Documentation/nvme-compare.html
+++ b/Documentation/nvme-compare.html
@@ -1,9 +1,10 @@
+
-
+
nvme-compare(1)
+
+
+
+
+
+
+
SYNOPSIS
+
+
+
nvme get-lba-status <device> [--namespace-id=<nsid> | -n <nsid>]
+ [--start-lba=<slba> | -s <slba>]
+ [--max-dw=<max-dw> | -m <max-dw>]
+ [--action=<action-type> | -a <action-type>]
+ [--range-len=<range-len> | -l <range-len>]
+ [--timeout=<timeout> | -t <timeout> ]
+ [--output-format=<format> | -o <format>]
+
+
+
+
+
+
DESCRIPTION
+
+
For the NVMe device given, send an nvme Get LBA Status admin command
+and provides the results.
+
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 get lba data 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 may be
+printed to stdout for another program to parse.
+
+
+
+
OPTIONS
+
+
+-
+-n <nsid>
+
+-
+--namespace-id=<nsid>
+
+-
+
+ Send the Get LBA Status command for the specified nsid. This can be
+ used to override the default value for either character device
+ (unspecified) or the block device (result from NVME_IOCTL_ID).
+
+
+-
+-s <slba>
+
+-
+--start-lba=<slba>
+
+-
+
+ Starting LBA(SLBA) in 64-bit address of the first logical block addressed
+
+
+-
+-m <max-dw>
+
+-
+--max-dw=<max-dw>
+
+-
+
+ Maximum Number of Dwords(MNDW) specifies maximum number of dwords to return
+
+
+-
+-a <action-type>
+
+-
+--action=<action-type>
+
+-
+
+ Action Type(ATYPE) specifies the mechanism it uses in determining the LBA Status Descriptors.
+
+
+-
+-l <range-len>
+
+-
+--range-len=<range-len>
+
+-
+
+ Range Length(RL) specifies the length of the range of contiguous LBAs beginning at SLBA
+
+
+-
+-t <timeout>
+
+-
+--timeout=<timeout>
+
+-
+
+ Override default timeout value. In milliseconds.
+
+
+-
+-o <format>
+
+-
+--output-format=<format>
+
+-
+
+ Set the reporting format to normal, json, or
+ binary. Only one output format can be used at a time.
+
+
+
+
+
+
+
+
NVME
+
+
Part of the nvme-user suite
+
+
+
+
+
+
+
diff --git a/Documentation/nvme-get-lba-status.txt b/Documentation/nvme-get-lba-status.txt
new file mode 100644
index 0000000..157dc41
--- /dev/null
+++ b/Documentation/nvme-get-lba-status.txt
@@ -0,0 +1,82 @@
+nvme-get-lba-status(1)
+======================
+
+NAME
+----
+nvme-get-lba-status - Get LBA Status from NVMe device
+
+SYNOPSIS
+--------
+[verse]
+'nvme get-lba-status' [--namespace-id= | -n ]
+ [--start-lba= | -s ]
+ [--max-dw= | -m ]
+ [--action= | -a ]
+ [--range-len= | -l ]
+ [--timeout= | -t ]
+ [--output-format= | -o ]
+
+DESCRIPTION
+-----------
+For the NVMe device given, send an nvme Get LBA Status admin command
+and provides the results.
+
+The 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 get lba data 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 may be
+printed to stdout for another program to parse.
+
+OPTIONS
+-------
+-n ::
+--namespace-id=::
+ Send the Get LBA Status command for the specified nsid. This can be
+ used to override the default value for either character device
+ (unspecified) or the block device (result from NVME_IOCTL_ID).
+
+-s ::
+--start-lba=::
+ Starting LBA(SLBA) in 64-bit address of the first logical block addressed
+
+-m ::
+--max-dw=::
+ Maximum Number of Dwords(MNDW) specifies maximum number of dwords to return
+
+-a ::
+--action=::
+ Action Type(ATYPE) specifies the mechanism it uses in determining the LBA Status Descriptors.
+
+-l ::
+--range-len=::
+ Range Length(RL) specifies the length of the range of contiguous LBAs beginning at SLBA
+
+-t ::
+--timeout=::
+ Override default timeout value. In milliseconds.
+
+-o ::
+--output-format=::
+ Set the reporting format to 'normal', 'json', or
+ 'binary'. Only one output format can be used at a time.
+
+EXAMPLES
+--------
+* Get the LBA Status of the device using all defaults:
++
+------------
+# nvme get-lba-status /dev/nvme0n1
+------------
++
+
+* Get LBA Status of the namespace 1 from SLBA 10 for the max Dwords of 0x1000
++
+------------
+# nvme get-lba-status /dev/nvme0 --namespace-id=1 --start-lba=10 --max-dw=0x1000
+------------
+
+NVME
+----
+Part of the nvme-user suite
diff --git a/Documentation/nvme-get-log.1 b/Documentation/nvme-get-log.1
index 98f81a8..ccc5ab8 100644
--- a/Documentation/nvme-get-log.1
+++ b/Documentation/nvme-get-log.1
@@ -1,13 +1,13 @@
'\" t
.\" Title: nvme-get-log
-.\" Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author]
-.\" Generator: DocBook XSL Stylesheets vsnapshot
-.\" Date: 10/20/2020
+.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
+.\" Generator: DocBook XSL Stylesheets v1.79.1
+.\" Date: 06/12/2021
.\" Manual: NVMe Manual
.\" Source: NVMe
.\" Language: English
.\"
-.TH "NVME\-GET\-LOG" "1" "10/20/2020" "NVMe" "NVMe Manual"
+.TH "NVME\-GET\-LOG" "1" "06/12/2021" "NVMe" "NVMe Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
@@ -33,13 +33,16 @@ nvme-get-log \- Retrieves a log page from an NVMe device
.sp
.nf
\fInvme get\-log\fR [\-\-log\-id= | \-i ]
- [\-\-log\-len= | \-l ]
- [\-\-aen= | \-a ]
- [\-\-namespace\-id= | \-n ]
- [\-\-raw\-binary | \-b]
- [\-\-lpo= | \-o ]
- [\-\-lsp= | \-s ]
- [\-\-rae | \-r]
+ [\-\-log\-len= | \-l ]
+ [\-\-aen= | \-a ]
+ [\-\-namespace\-id= | \-n ]
+ [\-\-raw\-binary | \-b]
+ [\-\-lpo= | \-o ]
+ [\-\-lsp= | \-s ]
+ [\-\-lsi= | \-S ]
+ [\-\-rae | \-r]
+ [\-\-csi= | \-y ]
+ [\-\-ot | \-O]
.fi
.SH "DESCRIPTION"
.sp
@@ -85,10 +88,25 @@ The log page offset specifies the location within a log page to start returning
The log specified field of LID\&.
.RE
.PP
+\-S , \-\-lsi=
+.RS 4
+The log specified field of Log Specific Identifier\&.
+.RE
+.PP
\-r, \-\-rae
.RS 4
Retain an Asynchronous Event\&.
.RE
+.PP
+\-y , \-\-csi=
+.RS 4
+This field specifies the identifier of command set\&. if not issued, NVM Command Set will be selected\&.
+.RE
+.PP
+\-O, \-\-ot
+.RS 4
+Offset Type
+.RE
.SH "EXAMPLES"
.sp
.RS 4
diff --git a/Documentation/nvme-get-log.html b/Documentation/nvme-get-log.html
index 9aa20e0..53af505 100644
--- a/Documentation/nvme-get-log.html
+++ b/Documentation/nvme-get-log.html
@@ -750,13 +750,16 @@ nvme-get-log(1) Manual Page
nvme get-log <device> [--log-id=<log-id> | -i <log-id>]
- [--log-len=<log-len> | -l <log-len>]
- [--aen=<aen> | -a <aen>]
- [--namespace-id=<nsid> | -n <nsid>]
- [--raw-binary | -b]
- [--lpo=<offset> | -o <offset>]
- [--lsp=<field> | -s <field>]
- [--rae | -r]
+ [--log-len=<log-len> | -l <log-len>]
+ [--aen=<aen> | -a <aen>]
+ [--namespace-id=<nsid> | -n <nsid>]
+ [--raw-binary | -b]
+ [--lpo=<offset> | -o <offset>]
+ [--lsp=<field> | -s <field>]
+ [--lsi=<field> | -S <field>]
+ [--rae | -r]
+ [--csi=<command_set_identifier> | -y <command_set_identifier>]
+ [--ot | -O]
@@ -864,6 +867,17 @@ program to parse.
+-S <field>
+
+
+--lsi=<field>
+
+
+
+ The log specified field of Log Specific Identifier.
+
+
+
-r
@@ -874,6 +888,29 @@ program to parse.
Retain an Asynchronous Event.
+
+-y <command_set_identifier>
+
+
+--csi=<command_set_identifier>
+
+
+
+ This field specifies the identifier of command set.
+ if not issued, NVM Command Set will be selected.
+
+
+
+-O
+
+
+--ot
+
+
+
+ Offset Type
+
+
@@ -918,7 +955,7 @@ Have the program return the raw log page in binary: