NVME-ZNS-ZONE-MGM(1)

📦
version 3.2 · 14 versions
, in arch rolling

💅 NVME-ZNS-ZONE-MGM(1) — nvme-cli manual, bestie edition 🎀

okay so this is the nvme-cli manual page for nvme-zns-zone-mgmt-recv, and I'm gonna walk you through it like we're texting at 2am. grab a snack. 🍓

✨ NAME ✨

nvme-zns-zone-mgmt-recv — the Zone Management Receive command. that's the whole name, that's the whole vibe. 👑

🦋 SYNOPSIS 🦋

nvme [<global-options>] zns zone-mgmt-recv <device>
                        [--namespace-id=<NUM> | -n <NUM>]
                        [--start-lba=<LBA> | -s <LBA>]
                        [--data-len=<IONUM>, -l <IONUM>]
                        [--zra=<NUM>, -z <NUM>]
                        [--zrasf=<NUM>, -a <NUM>]
                        [--zra-spec-feat, -f]

like, you give it a <device> and then sprinkle your flags on top. iconic behavior honestly.

🌸 DESCRIPTION 🌸

so for the NVMe device you hand it, this bad boy issues the Zone Management Receive command with whatever receive action you asked for plus the extra action-specific parameters you threw in. ✨

and here's the tea: it's the generic interface, provided for forward compatibility, because new actions keep getting created that this program literally didn't know about when it was being developed. so it's a generic command that does not do any additional decoding for the specific types of data received. no cap. it will only report the data as a hex dump, or binary. that's it, that's the whole deal. 💀

💖 OPTIONS 💖

  • -n <NUM>, --namespace-id=<NUM> — use this provided namespace id for the command. if you don't provide it, the namespace id of the block device gets used instead. but lowkey if the command is issued to a non-block device, the parameter is required — no skipping. also the broadcast value 0xffffffff can be given as all or -1. slay.
  • -s <lba>, --start-lba=<lba> — the starting LBA of the zone to manage receive. 🎀
  • -l <NUM>, --data-len=<NUM> — the received data buffer length. that's the length of the buffer that receives data, fr fr.
  • -z <NUM>, --zra=<NUM> — Zone Receive Action. 🦋
  • -a <NUM>, --zrasf=<NUM> — Zone Receive Action Specific field.
  • -f, --zra-spec-feat — enable Zone Receive Action Specific features. she's little but she matters. ✨

👑 GLOBAL OPTIONS 👑

these options are defined at the top-level nvme command and they're available to this subcommand too. the nepo baby options, if you will. 💅

  • --dry-run — print the command that would be executed, but do not actually execute it. practice mode, no consequences.
  • --no-ioctl-probing — disable probing for 64-bit IOCTL support.
  • --no-retries — disable retry logic on transient errors. one shot, one opportunity.
  • -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. (yes, the 'json with the stray quote is literally how it's written, I'm not touching it 😭)
  • --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. rude but fair.
  • --quiet — suppress informational messages. errors are still reported, and --quiet cancels any --verbose for the library log level. they cannot coexist bestie 💀
  • --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.
  • --timeout=<ms> — set the timeout for the command in milliseconds. infinite or -1 waits without a time limit (0xffffffff). forever girl vibes 🫶
  • -v, --verbose — increase the level of detail in the output. may be specified multiple times to further increase verbosity. the more the merrier honestly.
these options can also be set as machine-wide defaults in nvme-cli.conf(5). a command-line flag always overrides the file. periodt. 💅

🌈 EXAMPLES 🌈

  • hex dump of a report all zones:
# nvme zns zone-mgmt-recv /dev/nvme0 -n 1 -s 0 -z 0 -a 0 -l 4k
  • binary dump of a report all zones:
# nvme zns zone-mgmt-recv /dev/nvme0 -n 1 -s 0 -z 0 -a 0 -o -l 4k binary > report.out

ate. no notes. 🔥

⭐ NVME ⭐

part of nvme-cli. one of us, one of us 🧚

and that's the whole page bestie 💜 this little number is from the nvme-cli manual, dated 10/30/2026 (NVMe manual, 10/30/2026 energy — mark your calendars, she's timeless 👑✨). now go forth and receive those zones 🦋💖

📦 where this page comes from