summaryrefslogtreecommitdiffstats
path: root/Documentation/nvme-zns-open-zone.txt
blob: 4639bcc120f723576a11f46af27242bb272f6839 (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
nvme-zns-open-zone(1)
======================

NAME
----
nvme-zns-open-zone - Opens one or all zones

SYNOPSIS
--------
[verse]
'nvme zns open-zone' <device> [--namespace-id=<NUM> | -n <NUM>]
			[--start-lba=<LBA> | -s <LBA>] [--zrwaa | -r]
			[--select-all | -a] [--timeout=<timeout> | -t <timeout>]

DESCRIPTION
-----------
For the NVMe device given, issues the Zone Management Send command with the
"Open Zone" action. This will transition the zone to the opened state.

The <device> parameter is mandatory and may be either the NVMe character
device (ex: /dev/nvme0), or a namespace block device (ex: /dev/nvme0n1).

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 <lba>::
--start-lba=<lba>::
	The starting LBA of the zone to open.

-r::
--zrwaa::
	Allocate Zone Random Write Area to zone

-a::
--select-all::
	Select all zones for this action

-t <timeout>::
--timeout=<timeout>::
	Override default timeout value. In milliseconds.

EXAMPLES
--------
* Open the first zone on namespace 1:
+
------------
# nvme zns open-zone /dev/nvme0 -n 1 -s 0
------------

NVME
----
Part of nvme-cli