lpfc_cmpl_els_flogi(9)

📦 version 7.3.1, in nixpkgs unstable

💅 lpfc_cmpl_els_flogi(9) 💅

okay so this is a page from the Kernel API Manual bestie, and today's main character is lpfc_cmpl_els_flogi. yes it's a mouthful. yes it slays. let's get into it 🦋

✨ NAME ✨

lpfc_cmpl_els_flogi — the completion callback function for flogi, no cap 🎀

✨ SYNOPSIS ✨

void lpfc_cmpl_els_flogi (struct lpfc_hba *phba , struct lpfc_iocbq
*cmdiocb , struct lpfc_iocbq *rspiocb );

✨ ARGUMENTS ✨

  • phba — pointer to the lpfc hba data structure. your hba bestie fr.
  • cmdiocb — pointer to the lpfc command iocb data structure. the command one 💌
  • rspiocb — pointer to the lpfc response iocb data structure. the response one 💌

✨ DESCRIPTION ✨

okay so picture this: this routine is the top-level completion callback function for issuing a Fabric Login (FLOGI) command. very main character energy honestly 👑

so first thing, bestie — if the response IOCB reported an error, the lpfc_els_retry routine shall be invoked to retry the FLOGI. that's the move.

now if a retry has been made (either immediately, or, like, delayed — that's when lpfc_els_retry returns 1), the command IOCB will be released and the function returned. done and dusted 💅

but if the retry attempt has been given up (possibly because it reached the maximum number of retries 😭), one additional decrement of the ndlp reference shall be invoked before going out, after releasing the command IOCB. and like — this will actually release the remote node. quick note though, so you're not confused: lpfc_els_free_iocb will also invoke one decrement of the ndlp reference count. two decrements, two different places, iykyk 🔥

and if there's no error reported in the IOCB status? then the command Port ID field is used to determine whether this is a point-to-point topology or a fabric topology:

  • if the Port ID field is assigned → it's a fabric topology ✨
  • otherwise → it's a point-to-point topology 🦋

and then the routine lpfc_cmpl_els_flogi_fabric or lpfc_cmpl_els_flogi_nport shall be invoked accordingly, to handle the specific topology completion conditions. like, each one handles its own vibe. periodt.

✨ SEE ALSO ✨

kernel file ./drivers/scsi/lpfc/lpfc_els.c — and honestly the whole friend group showed up for this one:

and that's the whole page bestie, you ate that 💖 ok bye, this came from ./drivers/scsi/lpfc and it's dated October 2026 — mwah, see you in the next man page 🫶✨

📦 where this page comes from