1NVME-DSM(1) NVMe Manual NVME-DSM(1)
2
3
4
6 nvme-dsm - Send NVMe Data Set Management, return results
7
9 nvme dsm <device> [ --namespace-id=<nsid> | -n <nsid> ]
10 [ --ctx-attrs=<attribute-list,> | -a <attribute-list,> ]
11 [ --blocks=<nlb-list,> | -b <nlb-list,> ]
12 [ --slbs=<slba-list,> | -s <slba-list,> ]
13 [ --ad | -d ] [ --idw | -w ] [ --idr | -r ]
14 [ --cdw11=<cdw11> | -c <cdw11> ]
15
17 For the NVMe device given, sends a Data Set Management command and
18 provides the result and returned structure.
19
20 The <device> parameter is mandatory and may be either the NVMe
21 character device (ex: /dev/nvme0), or a namespace block device (ex:
22 /dev/nvme0n1). If the character device is given, the '--namespace-id'
23 option is mandatory, otherwise it will use the ns-id of the namespace
24 for the block device you opened. For block devices, the ns-id used can
25 be overridden with the same option.
26
27 You must specify at least one of the values for range list. If the
28 range lists provided do not list the same number of elements, the
29 default values for the remaining in the range will be set to 0.
30
31 The command dword 11 may be provided at the command line. For
32 convenience, the current defined attributes (discard, integral
33 read/write) for a data-set management have flags. If cdw11 is
34 specified, this will override any settings from the flags may have
35 provided.
36
38 -n <nsid>, --namespace-id=<nsid>
39 Sends the command with the requested nsid. This is required for the
40 character devices, or overrides the block nsid if given.
41
42 -a <attribute-list,>, --ctx-attrs=<attribute-list>
43 Comma separated list of the context attributes in each range
44
45 -b <nlb-list,>, --blocks=<nlb-list,>
46 Comma separated list of the number of blocks in each range
47
48 -s <slba-list,>, --slbs=<slba-list,>
49 Comma separated list of the starting block in each range
50
51 -d <deallocate>, --ad=<deallocate>
52 Attribute Deallocate.
53
54 -w <write>, --idw=<write>
55 Attribute Integral Dataset for Write.
56
57 -r <read>, --idr=<read>
58 Attribute Integral Dataset for Read.
59
60 -c <cdw11>, --cdw11=<cdw11>
61 All the command command dword 11 attributes. Use exclusive from
62 specifying individual attributes
63
65 No examples yet
66
68 Part of the nvme-user suite
69
70
71
72NVMe 09/29/2023 NVME-DSM(1)