1
0
Fork 0
nvme-cli/Documentation/nvme-attach-ns.txt
Daniel Baumann 8599c7290c
Merging upstream version 2.13.
Signed-off-by: Daniel Baumann <daniel@debian.org>
2025-04-13 11:50:38 +02:00

57 lines
1.4 KiB
Text

nvme-attach-ns(1)
=================
NAME
----
nvme-attach-ns - Send NVMe attach namespace, return result.
SYNOPSIS
--------
[verse]
'nvme attach-ns' <device> [--namespace-id=<nsid> | -n <nsid>]
[--controllers=<ctrl-list,> | -c <ctrl-list,>]
[--output-format=<fmt> | -o <fmt>] [--verbose | -v]
DESCRIPTION
-----------
For the NVMe device given, sends the nvme namespace attach command for
the provided namespace identifier, attaching to the provided list of
controller identifiers.
The <device> parameter is mandatory NVMe character device (ex: /dev/nvme0) but
not a namespace block device (ex: /dev/nvme0n1).
OPTIONS
-------
-n <nsid>::
--namespace-id=<nsid>::
The namespace identifier to attach but not attached already.
-c <ctrl-list,>::
-controllers=<ctrl-list,>::
The comma separated list of controller identifiers to attach the
namespace too. If no list is provided, the namespace will be attached
to the <device> controller used for this command.
-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
--------
Attach namespace 2 to the controllers with id 0x21 and 0x22:
# nvme attach-ns /dev/nvme1 -n 0x2 -c 0x21,0x22
Attach namespace 3 to nvme0:
# nvme attach-ns /dev/nvme0 -n 3
NVME
----
Part of the nvme-user suite