From f2c543b4ccad3b9f8871d952cddf66b3b438595b Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Fri, 2 Jul 2021 22:49:35 +0200 Subject: Merging upstream version 1.14. Signed-off-by: Daniel Baumann --- Documentation/nvme-zns-zone-append.html | 947 ++++++++++++++++++++++++++++++++ 1 file changed, 947 insertions(+) create mode 100644 Documentation/nvme-zns-zone-append.html (limited to 'Documentation/nvme-zns-zone-append.html') diff --git a/Documentation/nvme-zns-zone-append.html b/Documentation/nvme-zns-zone-append.html new file mode 100644 index 0000000..5acc06a --- /dev/null +++ b/Documentation/nvme-zns-zone-append.html @@ -0,0 +1,947 @@ + + + + + + +nvme-zns-zone-append(1) + + + + + +
+
+

SYNOPSIS

+
+
+
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 sucess, 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

+
+
+
+
+ + + -- cgit v1.2.3