summaryrefslogtreecommitdiffstats
path: root/Documentation/nvme-io-passthru.1
diff options
context:
space:
mode:
Diffstat (limited to 'Documentation/nvme-io-passthru.1')
-rw-r--r--Documentation/nvme-io-passthru.153
1 files changed, 33 insertions, 20 deletions
diff --git a/Documentation/nvme-io-passthru.1 b/Documentation/nvme-io-passthru.1
index da0e301..102da64 100644
--- a/Documentation/nvme-io-passthru.1
+++ b/Documentation/nvme-io-passthru.1
@@ -2,12 +2,12 @@
.\" Title: nvme-io-passthru
.\" Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
-.\" Date: 06/30/2023
+.\" Date: 12/21/2023
.\" Manual: NVMe Manual
.\" Source: NVMe
.\" Language: English
.\"
-.TH "NVME\-IO\-PASSTHRU" "1" "06/30/2023" "NVMe" "NVMe Manual"
+.TH "NVME\-IO\-PASSTHRU" "1" "12/21/2023" "NVMe" "NVMe Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
@@ -32,23 +32,22 @@ nvme-io-passthru \- Submit an arbitrary io command, return results
.SH "SYNOPSIS"
.sp
.nf
-\fInvme\-io\-passthru\fR <device> [\-\-opcode=<opcode> | \-o <opcode>]
- [\-\-flags=<flags> | \-f <flags>] [\-rsvd=<rsvd> | \-R <rsvd>]
- [\-\-namespace\-id=<nsid> | \-nsid <nsid>]
- [\-\-cdw2=<cdw2>] [\-\-cdw3=<cdw3>] [\-\-cdw10=<cdw10>]
- [\-\-cdw11=<cdw11>] [\-\-cdw12=<cdw12>] [\-\-cdw13=<cdw13>]
- [\-\-cdw14=<cdw14>] [\-\-cdw15=<cdw15>]
- [\-\-data\-len=<data\-len> | \-l <data\-len>]
- [\-\-metadata\-len=<len> | \-m <len>]
- [\-\-read | \-r ] [\-\-write | \-w]
- [\-\-input\-file=<file> | \-i <file>]
- [\-\-metadata=<file> | \-M <file>]
- [\-\-timeout=<to> | \-t <to>]
- [\-\-show\-command | \-s]
- [\-\-dry\-run | \-d]
- [\-\-raw\-binary | \-b]
- [\-\-prefill=<prefill> | \-p <prefill>]
- [\-\-latency | \-T]
+\fInvme\-io\-passthru\fR <device> [\-\-opcode=<opcode> | \-O <opcode>]
+ [\-\-flags=<flags> | \-f <flags>] [\-rsvd=<rsvd> | \-R <rsvd>]
+ [\-\-namespace\-id=<nsid> | \-nsid <nsid>]
+ [\-\-cdw2=<cdw2>] [\-\-cdw3=<cdw3>] [\-\-cdw10=<cdw10>]
+ [\-\-cdw11=<cdw11>] [\-\-cdw12=<cdw12>] [\-\-cdw13=<cdw13>]
+ [\-\-cdw14=<cdw14>] [\-\-cdw15=<cdw15>]
+ [\-\-data\-len=<data\-len> | \-l <data\-len>]
+ [\-\-metadata\-len=<len> | \-m <len>]
+ [\-\-read | \-r] [\-\-write | \-w]
+ [\-\-input\-file=<file> | \-i <file>]
+ [\-\-metadata=<file> | \-M <file>]
+ [\-\-timeout=<to> | \-t <to>] [\-\-show\-command | \-s]
+ [\-\-dry\-run | \-d] [\-\-raw\-binary | \-b]
+ [\-\-prefill=<prefill> | \-p <prefill>]
+ [\-\-latency | \-T]
+ [\-\-output\-format=<fmt> | \-o <fmt>] [\-\-verbose | \-v]
.fi
.SH "DESCRIPTION"
.sp
@@ -59,7 +58,7 @@ The <device> parameter is mandatory and may be either the NVMe character device
On success, the returned structure (if applicable) may be returned in one of several ways depending on the option flags; the structure may printed by the program as a hex dump, or may be returned as a raw buffer printed to stdout for another program to parse\&.
.SH "OPTIONS"
.PP
-\-o <opcode>, \-\-opcode=<opcode>
+\-O <opcode>, \-\-opcode=<opcode>
.RS 4
The NVMe opcode to send to the device in the command
.RE
@@ -137,6 +136,20 @@ Prefill the buffer with a predetermined byte value\&. Defaults to 0\&. This may
.RS 4
Print out the latency the IOCTL took (in us)\&.
.RE
+.PP
+\-o <fmt>, \-\-output\-format=<fmt>
+.RS 4
+Set the reporting format to
+\fInormal\fR,
+\fIjson\fR
+or
+\fIbinary\fR\&. Only one output format can be used at a time\&.
+.RE
+.PP
+\-v, \-\-verbose
+.RS 4
+Increase the information detail in the output\&.
+.RE
.SH "EXAMPLES"
.sp
nvme io\-passthru /dev/nvme0n1 \-\-opcode=2 \-\-namespace\-id=1 \-\-data\-len=4096 \-\-read \-\-cdw10=0 \-\-cdw11=0 \-\-cdw12=0x70000 \-\-raw\-binary