lpfc_sli4_alloc_xri(9)

📦 version 7.3.1, in nixpkgs unstable

💖 lpfc_sli4_alloc_xri — Kernel API Manual, section 9 💖

okay so bestie, we're in the kernel API manual (that's the <kbd>9</kbd> section vibe, the deep-lore one ✨) and today's main character is lpfc_sli4_alloc_xri. she's a little allocation girlie and she's about to hand you an rpi. let's get into it 🎀

✨ NAME ✨

lpfc_sli4_alloc_xri — Get an available rpi in the device's range 💅

🦋 SYNOPSIS 🦋

uint16_t lpfc_sli4_alloc_xri (struct lpfc_hba *phba );

literally that's the whole signature, no cap. one argument, one uint16_t coming back at you 🫶

🌸 ARGUMENTS 🌸

  • phba — pointer to lpfc hba data structure. that's your hba bestie, she's the one holding all the state 🧚

💜 DESCRIPTION 💜

so like, this routine is invoked to post rpi header templates to the HBA consistent with the SLI-4 interface spec. and when we say post, we mean she genuinely goes and does it — this routine posts a SLI4_PAGE_SIZE memory region to the port to hold up to SLI4_PAGE_SIZE modulo 64 rpi context headers. yes, SLI4_PAGE_SIZE modulo 64. that's the math, we don't make the rules, we just vibe-check them ⭐

Returns a nonzero rpi defined as rpi_base <= rpi < max_rpi if successful — like, a real one, inside the range, slaying — or LPFC_RPI_ALLOC_ERROR if no rpis are available 😭 so if you get that error, it's not personal, there was just nothing left in the pool.

🔥 SEE ALSO 🔥

the whole kernel file ./drivers/scsi/lpfc/lpfc_sli.c and, i'm not kidding, the entire extended friend group 💀 no gatekeeping, here's every single one:

also, and this is important bestie: note the little _lpfc_move_xri_pbl_to_pvt(9) with a single leading underscore sitting right next to lpfc_move_xri_pbl_to_pvt(9) — they are different girls, do not confuse them 💀

🌈 okay that's the whole page!! and now for the cute sign-off: this absolute icon lives in the source path ./drivers/scsi/lpfc, and this edition is dated October 2026. so yeah — future-dated, still relevant, still serving 💅✨ go get yourself an rpi, bestie, you got this 🫶💖

📦 where this page comes from