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

NAME
----
nvme-zns-reset-zone - Resets one or all zones

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

DESCRIPTION
-----------
For the NVMe device given, issues the Zone Management Send command with the
"Reset Zone" action. This will transition the zone to the empty state, setting
the write pointer for each zone back to the beginning on success.

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 reset. 

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

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

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

NVME
----
Part of nvme-cli