1NVME-CREATE-NS(1) NVMe Manual NVME-CREATE-NS(1)
2
6 nvme-create-ns - Send NVMe Namespace management command to create
7 namespace, returns results.
8
10 nvme create-ns <device> [--nsze=<nsze> | -s <nsze>]
11 [--ncap=<ncap> | -c <ncap>]
12 [--flbas=<flbas> | -f <flbas>]
13 [--dps=<dps> | -d <dps>]
14 [--nmic=<nmic> | -m <nmic>]
15 [--anagrp-id=<anagrpid> | -a <anagrpid>]
16 [--nvmset-id=<nvmsetid> | -i <nvmsetid>]
17 [--endg-id=<endgid> | -e <endgid>]
18 [--csi=<command_set_identifier> | -y <command_set_identifier>]
19 [--lbstm=<lbstm> | -l <lbstm>]
20 [--nphndls=<nphndls> | -n <nphndls>]
21 [--block-size=<block-size> | -b <block-size>]
22 [--timeout=<timeout> | -t <timeout>]
23 [--nsze-si=<nsze-si> | -S <nsze-si>]
24 [--ncap-si=<ncap-si> | -C <ncap-si>]
25 [--azr | -z]
26 [--rar=<rar> | -r <rar>]
27 [--ror=<ror> | -o <ror>]
28 [--rnumzrwa=<rnumzrwa> | -u <rnumzrwa>]
29 [--phndls=<placement-handle-list,> | -p <placement-handle-list,>]
30
32 For the NVMe device given, sends a namespace management command to
33 create the namespace with the requested settings. On success, the
34 namespace identifier assigned by the controller is returned.
35 The <device> parameter is mandatory and may be either the NVMe
37 character device (ex: /dev/nvme0), or a namespace block device (ex:
38 /dev/nvme0n1).
39
41 -s, --nsze
42 The namespace size.
43 -c, --ncap
45 The namespace capacity.
46 -f, --flbas
48 The namespace formatted logical block size setting. Conflicts with
49 --block-size argument.
50 -d, --dps
52 The data protection settings.
53 -m, --nmic
55 Namespace multipath and sharing capabilities.
56 -a, --anagrp-id
58 ANA Group Identifier. If this value is 0h specifies that the
59 controller determines the value to use
60 -i <nvmsetid>, --nvmset-id=<nvmsetid>
62 This field specifies the identifier of the NVM Set.
63 -e <endgid>, --endg-id=<endgid>
65 This field specifies the identifier of the endurance group.
66 -y <command_set_identifier>, --csi=<command_set_identifier>
68 This field specifies the identifier of command set. if not issued,
69 NVM Command Set will be selected.
70 -l <lbstm>, --lbstm=<lbstm>
72 Logical Block Storage Tag Mask for end-to-end protection.
73 -n <nphndls>, --nphndls=<nphndls>
75 Number of Placement Handle included in the Placement Handle List.
76 If the Flexible Data Placement capability is not supported or not
77 enabled in specified Endurance Group, then the controller shall
78 ignore this field.
79 -b, --block-size
81 Target block size the new namespace should be formatted as.
82 Potential FLBAS values will be values will be scanned and the
83 lowest numbered will be selected for the create-ns operation.
84 Conflicts with --flbas argument.
85 -S, --nsze-si
87 The namespace size (NSZE) in standard SI units. The value SI
88 suffixed is divided by the namespace LBA size to set as NSZE. If
89 the value not suffixed it is set as same with the nsze option.
90 -C, --ncap-si
92 The namespace capacity (NCAP) in standard SI units. The value SI
93 suffixed is divided by the namespace LBA size to set as NCAP. If
94 the value not suffixed it is set as same with the ncap option.
95 -z, --azr
97 Allocate ZRWA Resources. If set to 1, then the namespace is to be
98 created with the number of ZRWA resource specified in the RNUMZRWA
99 field of this data structure. If cleared to 0, then no ZRWA
100 resources are allocated to the namespace to be created.
101 -r <rar>, --rar=<rar>
103 Requested Active Resources. This field specifies the number of
104 active resources to be allocated to the created namespace.
105 -o <ror>, --ror=<ror>
107 Requested Open Resources. This field specifies the number of open
108 resources to be allocated to the created namespace.
109 -u <rnumzrwa>, --rnumzrwa=<rnumzrwa>
111 Requested Number of ZRWA Resources. This field specifies the number
112 of ZRWA resources to be allocated to the created namespace.
113 -p <placement-handle-list,>, --phndls=<placement-handle-list,>
115 The comma separated list of Reclaim Unit Handle Identifier to be
116 associated with each Placement Handle.
117
119 • Create a namespace:
120 # nvme create-ns /dev/nvme0 --nsze 11995709440 --ncap 1199570940 --flbas 0 --dps 0 --nmic 0
122 # nvme create-ns /dev/nvme0 --nsze-si 6.14T --ncap 1199570940 --flbas 0 --dps 0 --nmic 0
123
125 Part of the nvme-user suite
126NVMe 09/29/2023 NVME-CREATE-NS(1)