nvme-create-ns(1)

SYNOPSIS

nvme create-ns <device> [--nsze=<nsze> | -s <nsze>]
+                        [--ncap=<ncap> | -c <ncap>]
+                        [--flbas=<flbas> | -f <flbas>]
+                        [--dps=<dps> | -d <dps>]
+                        [--nmic=<nmic> | -m <nmic>]
+                        [--anagrp-id=<anagrpid> | -a <anagrpid>]
+                        [--nvmset-id=<nvmsetid> | -i <nvmsetid>]
+                        [--endg-id=<endgid> | -e <endgid>]
+                        [--csi=<command_set_identifier> | -y <command_set_identifier>]
+                        [--lbstm=<lbstm> | -l <lbstm>]
+                        [--nphndls=<nphndls> | -n <nphndls>]
+                        [--block-size=<block-size> | -b <block-size>]
+                        [--timeout=<timeout> | -t <timeout>]
+                        [--nsze-si=<nsze-si> | -S <nsze-si>]
+                        [--ncap-si=<ncap-si> | -C <ncap-si>]
+                        [--azr | -z]
+                        [--rar=<rar> | -r <rar>]
+                        [--ror=<ror> | -O <ror>]
+                        [--rnumzrwa=<rnumzrwa> | -u <rnumzrwa>]
+                        [--phndls=<placement-handle-list,> | -p <placement-handle-list,>]
+                        [--output-format=<fmt> | -o <fmt>] [--verbose | -v]

DESCRIPTION

For the NVMe device given, sends a namespace management command to create +the namespace with the requested settings. On success, the namespace +identifier assigned by the controller is returned.

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

+-s +
+--nsze +: +
+ The namespace size. +
+
+-c +
+--ncap +: +
+ The namespace capacity. +
+
+-f +
+--flbas +: +
+ The namespace formatted logical block size setting. + Conflicts with --block-size argument. +
+
+-d +
+--dps +: +
+ The data protection settings. +
+
+-m +
+--nmic +: +
+ Namespace multipath and sharing capabilities. +
+
+-a +
+--anagrp-id +: +
+ ANA Group Identifier. If this value is 0h specifies + that the controller determines the value to use +
+
+-i <nvmsetid> +
+--nvmset-id=<nvmsetid> +: +
+ This field specifies the identifier of the NVM Set. +
+
+-e <endgid> +
+--endg-id=<endgid> +: +
+ This field specifies the identifier of the endurance group. +
+
+-y <command_set_identifier> +
+--csi=<command_set_identifier> +: +
+ This field specifies the identifier of command set. + if not issued, NVM Command Set will be selected. +
+
+-l <lbstm> +
+--lbstm=<lbstm> +: +
+ Logical Block Storage Tag Mask for end-to-end protection. +
+
+-n <nphndls> +
+--nphndls=<nphndls> +: +
+ Number of Placement Handle included in the Placement Handle List. + If the Flexible Data Placement capability is not supported or not enabled + in specified Endurance Group, then the controller shall ignore this field. +
+
+-b +
+--block-size +: +
+ Target block size the new namespace should be formatted as. Potential FLBAS + values will be values will be scanned and the lowest numbered will be + selected for the create-ns operation. Conflicts with --flbas argument. +
+
+-S +
+--nsze-si +: +
+ The namespace size (NSZE) in standard SI units (aligned on 1Mib boundaries, + unless the controller recommends a smaller value). + The value SI suffixed is divided by the namespace LBA size to set as NSZE. + If the value not suffixed it is set as same with the nsze option. +
+
+-C +
+--ncap-si +: +
+ The namespace capacity (NCAP) in standard SI units (aligned on 1Mib boundaries, + unless the controller recommends a smaller value). + The value SI suffixed is divided by the namespace LBA size to set as NCAP. + If the value not suffixed it is set as same with the ncap option. +
+
+-z +
+--azr +: +
+ Allocate ZRWA Resources. + If set to 1, then the namespace is to be created with the number of ZRWA + resource specified in the RNUMZRWA field of this data structure. If cleared + to 0, then no ZRWA resources are allocated to the namespace to be created. +
+
+-r <rar> +
+--rar=<rar> +: +
+ Requested Active Resources. This field specifies the number of active + resources to be allocated to the created namespace. +
+
+-O <ror> +
+--ror=<ror> +: +
+ Requested Open Resources. This field specifies the number of open resources + to be allocated to the created namespace. +
+
+-u <rnumzrwa> +
+--rnumzrwa=<rnumzrwa> +: +
+ Requested Number of ZRWA Resources. This field specifies the number of ZRWA + resources to be allocated to the created namespace. +
+
+-p <placement-handle-list,> +
+--phndls=<placement-handle-list,> +: +
+ The comma separated list of Reclaim Unit Handle Identifier to be associated + with each Placement Handle. +
+
+-o <fmt> +
+--output-format=<fmt> +: +
+ Set the reporting format to normal, json or binary. Only one + output format can be used at a time. +
+
+-v +
+--verbose +: +
+ Increase the information detail in the output. +
+

EXAMPLES

+Create a namespace: +

# nvme create-ns /dev/nvme0 --nsze 11995709440 --ncap 1199570940 --flbas 0 --dps 0 --nmic 0
+# nvme create-ns /dev/nvme0 --nsze-si 6.14T --ncap 1199570940 --flbas 0 --dps 0 --nmic 0

NVME

Part of the nvme-user suite

+nvme-create-ns(1) Manual Page +

NAME

SYNOPSIS

DESCRIPTION

OPTIONS

EXAMPLES

NVME