lpfc_get_io_buf(9)

📦 version 7.3.1, in nixpkgs unstable

🦋 lpfc_get_io_buf(9) — bestie edition

okay so you're reading the kernel API manual, and this specific page is all about lpfc_get_io_buf(9). pull up a chair, grab a strawberry, we're doing this 💖

✨ NAME ✨

lpfc_get_io_buf — get one IO buffer from free pool. that's the whole vibe. one buffer, from the free pool, no cap 🎀

🌸 SYNOPSIS 🌸

struct lpfc_io_buf * lpfc_get_io_buf (struct lpfc_hba *phba , struct lpfc_nodelist *ndlp , u32 hwqid , int expedite );

it returns a struct lpfc_io_buf * and takes four things. yes four. i counted twice 💅

💜 ARGUMENTS 💜

  • phba — the HBA that this call is being executed for. it's the main character of the whole operation, honestly 👑
  • ndlp — pointer to the lpfc nodelist data structure.
  • hwqid — which HWQ this one belongs to.
  • expedite — 1 means this request is urgent. like, urgent urgent. 🔥

🧚 DESCRIPTION 🧚

so what does it actually do? this routine gets one IO buffer from the free pool. that's the core job 🫶

but there's a fork in the road, and it depends on cfg_xri_rebalancing:

  • if cfg_xri_rebalancing==1, it removes an IO buffer from the multiXRI pools.
  • if cfg_xri_rebalancing==0, it removes an IO buffer from the head of the hdwq io_buf_list and returns it to the caller.

two paths, same energy. pick your fighter 💀

⭐ NOTE ⭐

listen up, this part matters 🙈

ndlp is only used on the SCSI side, for RRQ testing. so on the NVME side, the caller should pass NULL for ndlp. don't be out here passing something else, i'm begging 😭

Return codes, and yes we're listing both:

  • NULL — Error
  • Pointer to lpfc_io_buf — Success

like, that's it. either you get your buffer or you get nothing. high stakes, honestly 🌈

🎀 SEE ALSO 🎀

first up, the kernel file: ./drivers/scsi/lpfc/lpfc_sli.c

and now the roster. i'm not skipping a single one of these, bestie, we're going the whole way through fr fr 💖

like... look at that list. iconic. every single one accounted for, bestie, i did not leave anyone on read 🫶✨

and that's the page!! the source is ./drivers/scsi/lpfc and it's dated October 2026 — so like, cute little timestamp from the future, slay 🎀💖 go get your IO buffers, you've got this 👑🌟

📦 where this page comes from