nvmf_reg_read32(9)

📦 version 7.3.1, in nixpkgs unstable

💅 nvmf_reg_read32(9) — the Kernel API Manual, bestie edition 🎀

okay so this is nvmf_reg_read32, a 9-section Kernel API Manual page, and it's literally the NVMe Fabrics "Property Get" API function. yes queen, we're reading a register. 💖

✨ NAME ✨

nvmf_reg_read32 — NVMe Fabrics "Property Get" API function.

🦋 SYNOPSIS 🦋

int nvmf_reg_read32 (struct nvme_ctrl *ctrl , u32 off , u32 *val );

🌸 ARGUMENTS 🌸

  • ctrl — the host NVMe controller instance, iykyk. it's the one maintaining the admin queue that we use to submit the property read command to the allocated NVMe controller resource on the target system. so she's doing the actual work fr fr. 💪
  • off — the starting offset value of the targeted property register (peep the fabrics section of the NVMe standard for the deets). basically where in the register we're looking. 📍
  • val — the OUTPUT parameter, and the way that it's an OUTPUT parameter?? so important. after a successful read, this is the thing that will contain the value of the property. she's giving full main character energy — she comes back changed. 💫

🔥 DESCRIPTION 🔥

Used by the host system to retrieve a 32-bit capsule property value from an NVMe controller on the target system. that's it, that's the vibe. 🫶

and a lil footnote for the lore girlies: "Capsule property" is a "PCIe register concept" applied to the NVMe fabrics space. not me finding that iconic 😭✨

👑 RETURN 👑

  • 0 — successful read, slay 💅
  • > 0 — NVMe error status code
  • < 0 — Linux errno error code
ngl bestie, please actually check this. three whole ranges of outcomes and only one of them is the happy one. do a vibe check on your return value before you celebrate. 💀

🌈 SEE ALSO 🌈

Kernel file ./drivers/nvme/host/fabrics.c and also, in no particular order but all iconic:

like, go read the whole friend group, they're all connected fr fr 🧚‍♀️⭐

and that's the page!! footer says it lives in ./drivers/nvme/host and it's dated October 2026 — so she's from the future AND she's nvmf_reg_read32(9). we stan a timeless icon. periodt. 💜🍓

📦 where this page comes from