diff options
author | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-29 04:41:05 +0000 |
---|---|---|
committer | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-29 04:41:05 +0000 |
commit | 1cc8413aaf5f8fa6595aece1933462c096e88639 (patch) | |
tree | e97b4f25c511372d73bdd96c389c5f468d99138a /Documentation/nvme-zns-report-zones.txt | |
parent | Initial commit. (diff) | |
download | nvme-cli-upstream.tar.xz nvme-cli-upstream.zip |
Adding upstream version 2.4+really2.3.upstream/2.4+really2.3upstream
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'Documentation/nvme-zns-report-zones.txt')
-rw-r--r-- | Documentation/nvme-zns-report-zones.txt | 102 |
1 files changed, 102 insertions, 0 deletions
diff --git a/Documentation/nvme-zns-report-zones.txt b/Documentation/nvme-zns-report-zones.txt new file mode 100644 index 0000000..35d5eda --- /dev/null +++ b/Documentation/nvme-zns-report-zones.txt @@ -0,0 +1,102 @@ +nvme-zns-report-zones(1) +======================== + +NAME +---- +nvme-zns-report-zones - Retrieve and display the Report Zones data structure + +SYNOPSIS +-------- +[verse] +'nvme zns report-zones' <device> [--namespace-id=<NUM> | -n <NUM>] + [--start-lba=<IONUM> | -s <IONUM>] + [--descs=<NUM> | -d <NUM>] + [--state=<NUM> | -S <NUM>] + [--extended | -e] + [--partial | -p] + [--verbose | -v] + [--output-format=<FMT> | -o <FMT>] + +DESCRIPTION +----------- +For the NVMe device given, sends the Zone Management Receive command with the +Zone Receive Action set to either Report Zones or Extended Report Zones, +depending on the 'extended' option. + +The <device> parameter is mandatory and may be either the NVMe character +device (ex: /dev/nvme0), or a namespace block device (ex: /dev/nvme0n1). + +On success, the data structure returned by the device will be decoded and +displayed in one of several ways. + +OPTIONS +------- +-n <NUM>:: +--namespace-id=<NUM>:: + Use the provided namespace id for the command. If not provided, the + namespace id of the block device will be used. If the command is issued + to a non-block device, the parameter is required. + +-s <lba>:: +--start-lba=<lba>:: + The starting LBA of the zone to begin the report + +-d <NUM>:: +--descs=<NUM>:: + The number of descriptors to request in the report. + +-S <NUM>:: +--state=<NUM>:: + The state of zones to request in the report. Known values include: ++ +[] +|================= +|Value|Definition +|0|List all zones (default) +|1|Empty State +|2|Implicitly Opened State +|3|Explicitly Opened State +|4|Closed State +|5|Full State +|6|Read Only State +|7|Offline State +|================= + +-e:: +--extended:: + Request to use the Extended Report Zones option. The extended data is + not decoded. + +-p:: +--partial:: + If set, the device will return the number of zones that match the state + rather than the number of zones returned in the report. + +-v:: +--verbose:: + Increase the information detail in the output. + +-o <format>:: +--output-format=<format>:: + Set the reporting format to 'normal', 'json', or + 'binary'. Only one output format can be used at a time. + +EXAMPLES +-------- +* Has the program interpret the report for 16 zones, and display the known +fields in a human readable format: ++ +------------ +# nvme zns report-zones /dev/nvme0 -n 1 -d 16 +------------ ++ + +* Show the output in json format with extra details ++ +------------ +# nvme zns report-zones /dev/nvme0 -n 1 -d 16 -o json +------------ + +NVME +---- +Part of nvme-cli |