nvme-zns-zone-append − Send an NVMe write command, provide results
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>]
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.
−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.
• 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
Part of the nvme−user suite