NVME-FDP-USAGE(1)

💅 NVME-FDP-USAGE(1) 💅

okay bestie, welcome to the NVMe Manual entry for the nvme-fdp-usage command. this one is all about peeking at your Reclaim Unit Handle usage, and yes it's giving storage-nerd main character energy. 🫶

✨ NAME ✨

nvme-fdp-usage — get the Reclaim Unit Handle Usage. 💖

🌸 SYNOPSIS 🌸

       nvme [<global-options>] fdp usage <device>
                               [--endgrp-id=<NUM> | -e <NUM>]
                               [--raw-binary | -b]

🦋 DESCRIPTION 🦋

so for the NVMe device you give it, this command serves up info about the Reclaim Unit Handles that are associated with the Placement Handles of the namespaces in the Endurance Group you specified. literally that's the whole vibe: device in, reclaim-unit-handle usage tea out. ✨

🎀 OPTIONS 🎀

• -e <NUM>, --endgrp-id=<NUM> — the endurance group identifier to use when requesting the log page. bestie, this is how you tell it which endurance group's business you want. 👑
• -b, --raw-binary — print the raw buffer to the standard output stream. no pretty formatting, just raw buffer behavior. 💀

🔥 GLOBAL OPTIONS 🔥

these are defined at the top-level nvme command and are available to this subcommand, so they're not just for show. iykyk. 💅

• --dry-run — print the command that would be executed, but do not actually execute it. it's giving "look but don't touch." 🙈
• --no-ioctl-probing — disable probing for 64-bit IOCTL support. no poking around for that support, bestie. 🚫
• --no-retries — disable retry logic on transient errors. one shot, no second chances. 💅
• -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. not me wanting to pick all of them 😭
• --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. no cap. 🚫
• --quiet — suppress informational messages. errors are still reported, and --quiet cancels any --verbose for the library log level. so it's quiet-quiet, but not "hide the actual problems" quiet. 🫶
• --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. cute little knobs, use responsibly. 🎛️
• --timeout=<ms> — set the timeout for the command in milliseconds. infinite or -1 waits without a time limit (0xffffffff). so yeah, you can literally tell it to wait forever. 💀
• -v, --verbose — increase the level of detail in the output. may be specified multiple times to further increase verbosity. stack it like a lil verbose tower. 🗼

these options can also be set as machine-wide defaults in nvme-cli.conf(5). a command-line flag always overrides the file. periodt. 💅

👑 NVME 👑

part of nvme-cli. 💖

and that's the page, bestie! source/version: NVMe; date: 10/30/2026. stay slay and don't forget your --dry-run. 💅✨