NVME-ZNS-ID-CTRL(1)

📦
version 3.2 · 14 versions
, in arch rolling

💅 nvme-zns-id-ctrl 💅

🌸 NAME 🌸

okay bestie, this is nvme-zns-id-ctrl, straight outta the NVMe Manual ✨ it sends the NVMe Zoned Command Set Identify Controller command, then returns the result and the returned structure 💖

✨ SYNOPSIS ✨

nvme [<global-options>] zns id-ctrl <device>

🦋 DESCRIPTION 🦋

For the NVMe device you give it, this sends the zoned command set’s identify controller command and gives you back the result and the returned structure. no cap 🫶

The <device> parameter is mandatory — like, you literally cannot skip it — and it can be either the NVMe character device (example: /dev/nvme0) or a namespace block device (example: /dev/nvme0n1) 💅

On success, the data structure returned by the device gets decoded and displayed in one of several ways. slay ✨

💅 OPTIONS 💅

🎀 GLOBAL OPTIONS 🎀

These options are defined at the top-level nvme command, and they’re available to this subcommand too:

  • --dry-run — prints the command that would be executed, but does not actually execute it 🙈
  • --no-ioctl-probing — disables probing for 64-bit IOCTL support
  • --no-retries — disables retry logic on transient errors
  • -o <fmt>, --output-format=<fmt> — sets the reporting format to normal, tabular, 'json, or binary. only one output format may be used at a time, bestie 💖
  • --output-format-version=<version> — selects the output format version. version 1 uses the original field naming, while version 2 is the default and gives more consistent and script-friendly field names. other versions are rejected 🚫
  • --quiet — suppresses informational messages. errors are still reported, and --quiet cancels any --verbose for the library log level 🤫
  • --set-options=<key=value>[,<key=value>...] — sets libnvme library options for this invocation. supported keys are force-4k, mi-probe-enabled, test-base-dir and test-sysfs-dir 🔧
  • --timeout=<ms> — sets the timeout for the command in milliseconds. infinite or -1 waits without a time limit (0xffffffff) ⏳
  • -v, --verbose — increases the level of detail in the output. may be specified multiple times to further increase verbosity 👑

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 🌈

  • has the program interpret the returned buffer and display the known fields in a human readable format:
# nvme zns id-ctrl /dev/nvme0
  • show the output in json format:
# nvme zns id-ctrl /dev/nvme0 -o json

👑 NVME 👑

part of nvme-cli 🫶

mwah 💋 this iconic page came from the NVMe Manual, dated 10/30/2026. bye bestie, go flex that zoned command set knowledge 🌟

📦 where this page comes from