nvme-registry-retrieve(1)
=========================

NAME
----
nvme-registry-retrieve - Read an attribute from a controller's registry entry

SYNOPSIS
--------
[verse]
'nvme' [<global-options>] 'registry retrieve' <device>
			--attr=<ATTR> | -a <ATTR>

DESCRIPTION
-----------
Read a single attribute from the ownership registry entry for an NVMe-oF
controller.  The registry is stored under /run/nvme/registry/ as one
directory per live controller, with one plain-text file per attribute
(e.g. /run/nvme/registry/nvme3/owner).

The <device> is the NVMe controller name (e.g. nvme3), given as a
positional argument; the /dev/ prefix is optional.

OPTIONS
-------
-a <ATTR>::
--attr=<ATTR>::
	Attribute name to retrieve (e.g. owner, note).  Required.

include::global-options.txt[]

EXAMPLES
--------
* Retrieve the owner of nvme3:
+
------------
# nvme registry retrieve nvme3 --attr owner
stas
------------

SEE ALSO
--------
nvme-registry-list(1)
nvme-registry-update(1)
nvme-registry-delete(1)

NVME
----
Part of the nvme-user suite
