NVME-SHOW-HOSTNQN(1)

📦
version 3.2 · 14 versions
, in arch rolling

💅 NVME-SHOW-HOSTNQN 💅

okay bestie, welcome to the nvme-show-hostnqn page — part of the NVMe Manual, and honestly? it's a short one, so we're gonna get through it together and you're gonna feel so smart after 🫶

✨ NAME ✨

nvme-show-hostnqn — show the host NQN that's configured for the system 👑

✨ SYNOPSIS ✨

nvme [<global-options>] show-hostnqn

that's it. that's the whole vibe. no cap 🌸

✨ DESCRIPTION ✨

So the whole point of this one: it shows the host NQN that's configured for the system. Slay, that's the job. 💖

But here's the little plot twist you need to know about: if /usr/local/etc/nvme/hostnqn is not present, and systemd application-specific machine IDs are available, then this will show the systemd-generated host NQN for the system. so the systemd girlies get their moment too 🧚✨

✨ OPTIONS ✨

💅 GLOBAL OPTIONS 💅

These following options are defined up at the top-level nvme command, and they're available to this subcommand too — they trickle down, main character energy 👑

  • --dry-run — prints the command that would be executed, but doesn't actually execute it. like a rehearsal, but for your terminal 🎀
  • --no-ioctl-probing — disables probing for 64-bit IOCTL support. no poking around, we're just not doing it 🙈
  • --no-retries — disables the retry logic on transient errors. one shot, one opportunity 😭
  • -o <fmt>, --output-format=<fmt> — sets the reporting format to normal, tabular, json, or binary. only one output format at a time, bestie — you can't collect them all 💀
  • --output-format-version=<version> — picks the output format version. version 1 uses the original field naming, while version 2 (the default, and honestly the icon) gives you more consistent and script-friendly field names. any other version? rejected. no discussion 🔥
  • --quiet — suppresses informational messages. errors are still reported, and heads up: --quiet cancels any --verbose for the library log level. it's giving "silence, but make it honest" 🤫
  • --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. mix and match, comma-separated, go off ⭐
  • --timeout=<ms> — sets the timeout for the command in milliseconds. infinite or -1 waits without a time limit (0xffffffff) — literally forever, no clock-watching 💜
  • -v, --verbose — increases the level of detail in the output. you can specify it multiple times to crank the verbosity even further. more flag = more lore 🌈
lowkey important note: these options can also be set as machine-wide defaults in nvme-cli.conf(5). and a command-line flag always overrides the file. always. periodt 💅

✨ EXAMPLES ✨

nvme show-hostnqn

that's the example. run it, get your host NQN, live your life 🦋

✨ NVME ✨

Part of the nvme-user suite. yeah, she's in the family 👑

and that's the page!! 🎀 fr fr you now understand nvme-show-hostnqn better than most people. this little slice of the NVMe manual is dated 10/30/2026, so go forth, be iconic, and show that host NQN bestie 💖✨🍓

📦 where this page comes from