blob: 65e0fb237d5ce081356a93e79f7b6a69da3a5eb5 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
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
|
