summaryrefslogtreecommitdiffstats
path: root/Documentation/nvme-zns-zone-append.txt
diff options
context:
space:
mode:
Diffstat (limited to 'Documentation/nvme-zns-zone-append.txt')
-rw-r--r--Documentation/nvme-zns-zone-append.txt96
1 files changed, 96 insertions, 0 deletions
diff --git a/Documentation/nvme-zns-zone-append.txt b/Documentation/nvme-zns-zone-append.txt
new file mode 100644
index 0000000..65e0fb2
--- /dev/null
+++ b/Documentation/nvme-zns-zone-append.txt
@@ -0,0 +1,96 @@
+nvme-zns-zone-append(1)
+=======================
+
+NAME
+----
+nvme-zns-zone-append - Send an NVMe write command, provide results
+
+SYNOPSIS
+--------
+[verse]
+'nvme-zns-zone-append' <device> [--namespace-id=<NUM> | -n <NUM>]
+ [--zslba=<IONUM> | -s <IONUM>]
+ [--data-size=<IONUM> | -z <IONUM>]
+ [--metadata-size=<IONUM> | -y <IONUM>]
+ [--data=<FILE> | -d <FILE>]
+ [--metadata=<FILE> | -M <FILE>]
+ [--limited-retry | -l]
+ [--force-unit-access | -f]
+ [--ref-tag=<NUM> | -r <NUM>]
+ [--app-tag-mask=<NUM> | -m <NUM>]
+ [--app-tag=<NUM> | -a <NUM>]
+ [--prinfo=<NUM> | -p <NUM>]
+
+DESCRIPTION
+-----------
+The zone append command writes the logical blocks specified by the command to
+the medium from the data data buffer provided. Will use stdin by default
+if you don't provide a file.
+
+On success, the program will report the LBA that was assigned to the data for
+the append operation.
+
+OPTIONS
+-------
+-n <NUM>::
+--namespace-id=<NUM>::
+ Use the provided namespace id for the command. If not provided, the
+ namespace id of the block device will be used. If the command is issued
+ to a non-block device, the parameter is required.
+
+-s <IONUM>::
+--zslba=<IONUM>::
+
+-z <IONUM>::
+--data-size=<IONUM>::
+ Size of data, in bytes.
+
+-y <IONUM>::
+--metadata-size=<IONUM>::
+ Size of metadata in bytes.
+
+-d <FILE>::
+--data=<FILE>::
+ Data file providing the data to write. If none provided, contents are
+ sent from STDIN.
+
+-M <FILE>::
+--metadata=<FILE>::
+ Metadata file, if necessary.
+
+-l::
+--limited-retry::
+ Sets the limited retry flag.
+
+-f::
+--force-unit-access::
+ Set the force-unit access flag.
+
+-r <NUM>::
+--ref-tag=<NUM>::
+ Optional reftag when used with protection information.
+
+-m <NUM>::
+--app-tag-mask=<NUM>::
+ Optional application tag mask when used with protection information.
+
+-a <NUM>::
+--app-tag=<NUM>::
+ Optional application tag when used with protection information.
+
+-p <NUM>::
+--prinfo=<NUM>::
+ Protection Information field definition.
+
+EXAMPLES
+--------
+* Append the data "hello world" into 4k worth of blocks into the zone starting
+ at block 0 for namespace 1:
++
+------------
+# echo "hello world" | nvme zns zone-append /dev/nvme0 -n 1 -s 0 -z 4k
+------------
+
+NVME
+----
+Part of the nvme-user suite