NVME-ID-NS-GRANUL(1)

📦 version 3.2, in arch rolling

💅 NVME-ID-NS-GRANUL(1) — nvme-id-ns-granularity

okay bestie, welcome to the NVMe Manual ✨ — this one's all about nvme-id-ns-granularity, and it's genuinely so straightforward you're gonna eat it up 🍓

🌸 NAME 🌸

nvme-id-ns-granularity — sends an Identify Namespace Granularity List command to the device you point at 🎯

🎀 SYNOPSIS 🎀

nvme [<global-options>] id ns-granularity <device>

🦋 DESCRIPTION 🦋

So what it does is: it sends a Identify Namespace Granularity List command command to the device you specified, and then it returns the results. That's the whole vibe. No cap. 💖

The <device> parameter is mandatory — like, you literally cannot skip it, it's giving main character energy and refuses to be optional. And it can be either the NVMe character device (ex: /dev/nvme0) or the block device (ex: /dev/nvme0n1). Either one slays, your choice 🫶

On success it returns 0. On error, it returns an error code instead. Simple as that, periodt.

okay so this next bit matters — the bare nvme id-ns-granularity form (without a space) still works as a deprecated alias, and it will be removed in a future major version. So like… it's not dead yet but it's on thin ice 💀. New scripts should use nvme id ns-granularity instead. iykyk.

✨ OPTIONS ✨

🌈 GLOBAL OPTIONS 🌈

These ones are defined at the top-level nvme command and are available to this subcommand too — so they're not even exclusively ours, we're just borrowing them and they're iconic for it 👑

  • --dry-run — prints the command that would be executed, but does not actually execute it. It's the "look but don't touch" of flags 🙈
  • --no-ioctl-probing — disables probing for 64-bit IOCTL support. Bye probe 👋
  • --no-retries — disables the retry logic on transient errors. One shot, no do-overs 💀
  • -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 — pick a lane bestie 🎯
  • --output-format-version=<version> — selects the output format version. Version 1 uses the original field naming, while version 2 (the default) provides more consistent and script-friendly field names. Any other versions are rejected — not on the list, not invited 🚫
  • --quiet — suppresses informational messages. Errors are still reported, and --quiet cancels any --verbose for the library log level. Shhh 🤫
  • --set-options=<key=value>[,<key=value>...] — sets libnvme library options for this invocation. The 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). Time is a construct ⏳
  • -v, --verbose — increases the level of detail in the output. May be specified multiple times to further increase verbosity. Stack it like accessories 💅
Also!! These options can be set as machine-wide defaults in nvme-cli.conf(5). But a command-line flag always overrides the file — CLI stays winning, always 👑

🔥 EXAMPLES 🔥

  • Has the program issue a id-ns-granularity to display structure.
# nvme id ns-granularity /dev/nvme0

👑 NVME 👑

Part of the nvme-user suite. You're welcome 💜

okay that's the whole page, you're officially an expert now, go forth and granularate (?) 🌟 — this masterpiece is from the NVMe source, dated 10/30/2026, mwah 💋

📦 where this page comes from