NVME-LIST-SECONDAR(1)

📦 version 3.2, in arch rolling

💅 NVME-LIST-SECONDAR(1) — the NVMe Manual page, but make it group chat

okay so bestie, welcome to the nvme-user suite's own little corner of the man pages 💖 this one is short, sweet, and honestly a little nostalgic — let's get into it.

✨ NAME ✨

nvme-list-secondary — shows you the secondary controller list that's hanging out with the primary controller of whatever device you point at. lowkey iconic. also, heads up: deprecated 🫠

🦋 SYNOPSIS 🦋

nvme [<global-options>] list-secondary <device>
                        [--cntid=<cntid> | -c <cntid>]
                        [--num-entries=<entries> | -e <entries>]

that's it, that's the shape of it ✨ <device> is required, the two flag pairs are optional and each pair is either/or — no doubling up, bestie.

🌸 DESCRIPTION 🌸

so here's the tea ☕: this is a deprecated alias for nvme-id-secondary-ctrl-list(1). it exists purely for the scripts that were written against nvme-cli versions older than 3.0. the options and behavior are identical — the only thing kept around is the top-level command name. the vibes, the flags, the output: same. 💅

new scripts should use nvme id secondary-ctrl-list instead, fr fr. this alias prints a deprecation warning on stderr 😭 and may be removed in a future release — so don't get too attached.

heads up bestie: the full option reference lives over in nvme-id-secondary-ctrl-list(1). go read that one for the whole menu. 🍓

👑 GLOBAL OPTIONS 👑

these bad boys are defined at the top-level nvme command, and they're all available to this subcommand. main character energy, they travel. ✨

  • --dry-run — prints the command that would be executed, but doesn't actually execute it. window shopping for syscalls, we love to see it 🛍️
  • --no-ioctl-probing — turns off probing for 64-bit IOCTL support. no probing, no thanks 🚫
  • --no-retries — disables retry logic on transient errors. one shot, no take-backs 💀
  • -o <fmt>, --output-format=<fmt> — sets the reporting format to normal, tabular, 'json, or binary. only one output format at a time, okurrr? pick one and commit 💅
  • --output-format-version=<version> — picks the output format version. version 1 uses the original field naming, while version 2 (the default) gives you more consistent and script-friendly field names. other versions get rejected 🙈
  • --quiet — suppresses informational messages. errors are still reported (sorry bestie, you can't mute the truth), and --quiet cancels any --verbose for the library log level. they cancel out, it's giving enemies to lovers 😭
  • --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). forever and ever, no cap ⭐
  • -v, --verbose — increases the level of detail in the output. may be specified multiple times to further increase verbosity. stack 'em like bracelets 🫶

alsooo, these options can be set as machine-wide defaults in nvme-cli.conf(5). and a command-line flag always overrides the file — CLI is the main character here, no debate 🌈

🧚 EXAMPLES 🧚

No Examples

literally none. not a single one. we're free 💀

💜 NVME 💜

Part of the nvme-user suite 🎀

🌟 SEE ALSO 🌟

💖 that's the whole page, bestie. and yes, this is from the NVMe manual, dated 10/30/2026 — so if you're reading this in the future, hi, slay, and please go use nvme id secondary-ctrl-list instead of this deprecated alias 😭🫶✨
📦 where this page comes from