lpfc_issue_fabric_iocb(9)

📦 version 7.3.1, in nixpkgs unstable

💫 lpfc_issue_fabric_iocb(9) — from the Kernel API Manual ✨

okay bestie, gather round, because today we're looking at lpfc_issue_fabric_iocb(9) straight out of the Kernel API Manual and honestly? it's a little drama queen of a function 🎀

🌸 NAME 🌸

lpfc_issue_fabric_iocb — issue a fabric iocb command 💅

✨ SYNOPSIS ✨

int lpfc_issue_fabric_iocb (struct lpfc_hba *phba , struct lpfc_iocbq
*iocb );

like, that's the whole vibe right there 🫶

🎀 ARGUMENTS 🎀

  • phba — pointer to lpfc hba data structure. (the big one, the main character, the hba itself 👑)
  • iocb — pointer to lpfc command iocb data structure. (the actual command being sent out, bestie 💌)

🦋 DESCRIPTION 🦋

So this routine is the top-level API for issuing a fabric iocb command — think stuff like FLOGI and FDISC. 🌈

Here's the whole reason it exists: certain switch fabrics are picky, so this driver function makes sure that only one fabric bound iocb is outstanding at any given time. literally one (1) at a time. no cap. 🙈

So what it does first is check whether there's already an outstanding fabric iocb on the wire:

  • If there is one, it puts the newly issued iocb onto the driver internal fabric iocb list, just waiting to be issued later. 💤
  • If there isn't one, it issues the iocb on the wire and updates the fabric iocb count to indicate that there is one fabric iocb on the wire. 🚀
⚠️ okay um, warning time ⚠️ — note that this implementation has a potential for sending out fabric IOCBs out of order. the problem is caused by the construction of the "ready" boolean not including the condition that the internal fabric IOCB list is empty. as such, it's possible a fabric IOCB issued by this routine might "jump" ahead of the fabric IOCBs in the internal list. 😭 like it just cuts the line. rude.

Return code 🌟

  • IOCB_SUCCESS — either fabric iocb put on the list or issued successfully 🎉
  • IOCB_ERROR — failed to issue fabric iocb 💀

👑 SEE ALSO 👑

Kernel file ./drivers/scsi/lpfc/lpfc_els.c — and bestie, the friend group here is enormous, so buckle up 🧚

and that's the page, bestie!! 🫶✨ this came out of ./drivers/scsi/lpfc with a date stamp of October 2026 — ily, go read your kernel source, mwah 💖🎀🦋

📦 where this page comes from