diff options
Diffstat (limited to 'Documentation/nvme-create-ns.txt')
-rw-r--r-- | Documentation/nvme-create-ns.txt | 160 |
1 files changed, 160 insertions, 0 deletions
diff --git a/Documentation/nvme-create-ns.txt b/Documentation/nvme-create-ns.txt new file mode 100644 index 0000000..352a945 --- /dev/null +++ b/Documentation/nvme-create-ns.txt @@ -0,0 +1,160 @@ +nvme-create-ns(1) +================= + +NAME +---- +nvme-create-ns - Send NVMe Namespace management command to create namespace, returns results. + +SYNOPSIS +-------- +[verse] +'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 |