NVME-ZNS-REPORT-Z(1)

📦
version 3.2 · 14 versions
, in arch rolling

💖 nvme-zns-report-zones(1) — the NVMe Manual, bestie edition 🎀

okay so this is nvme-zns-report-zones, from the NVMe Manual (yes, that manual), and it's the glow-up for nvme-zns-report-zones — like, the page you're reading right now. we're retrieving and displaying the Report Zones data structure and honestly? she's iconic. ✨

🌸 NAME 🌸

nvme-zns-report-zones — retrieve and display the Report Zones data structure 💅 no cap, that's the whole job.

🦋 SYNOPSIS 🦋

nvme [<global-options>] 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]

like, look at her. so many little flags. so organized. 🫶

✨ DESCRIPTION ✨

so for the NVMe device you give her, this 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 way she just knows which one you want 🧚

the <device> parameter is mandatory, periodt — and it can be either the NVMe character device (ex: /dev/nvme0) or a namespace block device (ex: /dev/nvme0n1). you literally cannot skip it, she will not let you. 😭

on success, the data structure the device hands back gets decoded and displayed in one of several ways. very main character of it. 👑

💜 OPTIONS 💜

  • -n <NUM>, --namespace-id=<NUM> — use the namespace id you provided for the command. if you don't provide one, the namespace id of the block device gets used instead. and heads up: if the command is issued to a non-block device, this parameter is required (no vibes-based guessing, sorry). also the broadcast value 0xffffffff can be given as all or -1 — little shortcut slay. 🌈
  • -s <lba>, --start-lba=<lba> — the starting LBA of the zone where the report begins. that's the launch point, bestie 🚀
  • -d <NUM>, --descs=<NUM> — the number of descriptors to request in the report. ask for what you want fr fr.
  • -S <NUM>, --state=<NUM> — the state of zones to request in the report. known values include:
    • 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

(yes that was a table in the original, we've gone full bullet-list era. aesthetic upgrade, no cap. 🎀)

  • -e, --extended — request to use the Extended Report Zones option. quick warning though: the extended data is not decoded — it just comes back raw, no fancy parsing. don't say I didn't tell you 💀
  • -p, --partial — if set, the device returns the number of zones that match the state rather than the number of zones returned in the report. subtle but important, iykyk.

👑 GLOBAL OPTIONS 👑

these are defined at the top-level nvme command, and they're available to this subcommand too. so generous of them honestly 🫶

  • --dry-run — print the command that would be executed, but don't actually execute it. manifesting the command without running it ✨
  • --no-ioctl-probing — disable probing for 64-bit IOCTL support.
  • --no-retries — disable retry logic on transient errors. no second chances, we're moving on 💅
  • -o <fmt>, --output-format=<fmt> — set the reporting format to normal, tabular, 'json, or binary. only one output format may be used at a time — pick a lane, bestie. 🔥
  • --output-format-version=<version> — select the output format version. version 1 uses the original field naming, while version 2 (default) provides more consistent and script-friendly field names. other versions are rejected — literally not invited to the party 🙈
  • --quiet — suppress informational messages. errors are still reported, and --quiet cancels any --verbose for the library log level. she's quiet but she's still watching. 👀
  • --set-options=<key=value>[,<key=value>...] — set libnvme library options for this invocation. supported keys are force-4k, mi-probe-enabled, test-base-dir and test-sysfs-dir. mix and match with commas, go off 🌟
  • --timeout=<ms> — set the timeout for the command in milliseconds. infinite or -1 waits without a time limit (0xffffffff). she can wait forever, she's patient like that ⏳
  • -v, --verbose — increase the level of detail in the output. may be specified multiple times to further increase verbosity. stack 'em, why not 📚
these options can also be set as machine-wide defaults in nvme-cli.conf(5). and a command-line flag always overrides the file. always. no exceptions. periodt. 💖

🌈 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

like, she ate that. both commands. flawless. 🔥

🍓 NVME 🍓

part of nvme-cli. family. found family, even. 💜

okay so that's the whole page — huge shoutout to the NVMe crew, this one's from nvme-cli, dated 10/30/2026, and it's the NVME-ZNS-REPORT-Z(1) page you just read. go report some zones, bestie 🦋✨

📦 where this page comes from