nvme-resv-report - Man Page

Send NVMe Reservation Report, parse the result


nvme resv-report <device> [--namespace-id=<nsid> | -n <nsid>]
                        [--numd=<num-dwords> | -d <num-dwords>]
                        [--eds | -e]
                        [--raw-binary | -b]
                        [--output-format=<fmt> | -o <fmt>]


The Reservation Report command returns a Reservation Status data structure to host memory that describes the registration and reservation status of a namespace.

The size of the Reservation Status data structure is a function of the number of controllers in the NVM Subsystem that are associated with hosts that are registrants of the namespace (i.e., there is a Registered Controller data structure for each such controller).


-n <nsid>, --namespace-id=<nsid>

Retrieve the reservation report structure for the given nsid. This is required for the character devices, or overrides the block nsid if given.

-d <num-dwords>, --numd=<num-dwords>

Specify the number of Dwords of the Reservation Status structure to transfer. Defaults to 4k.

-e, ā€‰--eds

Request extended Data Structure: If this bit is set to a 1, then the controller returns the Extended Data Structure.

-b, ā€‰--raw-binary

Print the raw buffer to stdout. Structure is not parsed by program.

-o <format>, --output-format=<format>

Set the reporting format to normal, json, or binary. Only one output format can be used at a time.


No examples yet.


Part of the nvme-user suite

Referenced By


08/17/2023 NVMe Manual