96 lines
2.2 KiB
Text
96 lines
2.2 KiB
Text
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
|