nvme-zns-zone-append - Man Page

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

nvme(1).