lpfc_nvme_create_queue(9)

📦 version 7.3.1, in nixpkgs unstable

✨ lpfc_nvme_create_queue ✨

ok so first thing, the NAME section is literally empty bestie 😭 — like the manpage gave us the title and then... nothing. silence. a blank. so we're going in blind and figuring it out from the synopsis, which honestly? iconic behaviour. the page is lpfc_nvme_create_queue, from the Kernel API Manual (man section 9), and it's about the lpfc driver setting up an NVMe queue for you 🎀

💅 SYNOPSIS 💅

int lpfc_nvme_create_queue (struct nvme_fc_local_port *pnvme_lport ,
unsigned int qidx , u16 qsize , void **handle );

it returns an int, it takes four things, and yes you have to pass all of them. no shortcuts. periodt ✨

🦋 ARGUMENTS 🦋

  • pnvme_lport — the transport localport that the LS is gonna be issued from. that's your entry point, your home base, your main character port 👑
  • qidx — a cpu index, and its whole personality is affinitizing IO queues and MSIX vectors. it's the "which queue is this one" number, ngl 🔥
  • qsize — size of the queue, in bytes. bytes!! not entries, not vibes, bytes 🫶
  • handle — an opaque driver handle that gets used in the follow-up calls. you don't look inside it, you just carry it around like a little tote bag 💖

🌸 DESCRIPTION 🌸

so the driver registers this routine to preallocate and initialize any internal data structures it needs, so it can bind the qidx to its internal IO queues. think of it as the driver doing its skincare routine before the IO happens — prep first, slay later ✨

and the mapping is the cute part: a hardware queue maps (qidx) to a specific driver MSI-X vector / EQ / CQ / WQ. one index, one little squad of hardware queues. iykyk 🧚

Return value — read this part, it's important:

  • 0 — Success 💚
  • -EINVAL — Unsupported input value 🙈
  • -ENOMEM — Could not alloc necessary memory 💀
bestie if you get -ENOMEM the driver literally could not get the memory it needed. it's not being dramatic, it's just out of room. handle accordingly 😭

🌈 SEE ALSO 🌈

the kernel file ./drivers/scsi/lpfc/lpfc_nvme.c, and then a whole friend group of functions, all in section 9:

go read those too, they're all invited to the group chat 🫶

ok and that's the whole page!! mwah 💋 this little number lives in ./drivers/scsi/lpfc, and it's stamped October 2026 — so yeah, future-dated manual page, main character energy fr. see you in the next one bestie, stay hydrated and don't leak your handles 💜✨

📦 where this page comes from