lpfc_issue_els_logo(9)

πŸ“¦ version 7.3.1, in nixpkgs unstable

πŸ’… lpfc_issue_els_logo β€” from the Kernel API Manual, bestie

okay so picture this: you're deep in the kernel, the file is ./drivers/scsi/lpfc/lpfc_els.c, and somebody needs to send a LOGO. this page is the whole lore. it lives in the Kernel API Manual, the header literally says lpfc_issue_els_logo(9), and we're about to break it all the way down πŸŽ€


✨ NAME ✨

lpfc_issue_els_logo β€” Issue a logo to an node on a vport

(yes, "an node", we don't fix the kernel's grammar, we respect it 🫢)


🌸 SYNOPSIS 🌸

int lpfc_issue_els_logo (struct lpfc_vport *vport , struct lpfc_nodelist
*ndlp , uint8_t retry );

πŸ¦‹ ARGUMENTS πŸ¦‹

  • vport β€” pointer to a virtual N_Port data structure. that's your vport bestie πŸ’œ
  • ndlp β€” pointer to a node-list data structure. the node in question πŸŽ€
  • retry β€” number of retries to the command IOCB. how many second chances the command IOCB gets 😭

πŸ”₯ DESCRIPTION πŸ”₯

so what this routine actually does is construct and issue an ELS Logout (LOGO) iocb command to a remote node β€” and that remote node is referred to by an ndlp on a vport. it builds the payload of the IOCB, sets up the ndlp state properly (like, properly properly), and then invokes the lpfc_sli_issue_iocb routine to send out the LOGO ELS command. chef's kiss ✨

heads up, this part matters: the ndlp reference count will be incremented by 1 for holding the ndlp, and the reference to ndlp will be stored into the ndlp field of the IOCB β€” all so the completion callback function for the LOGO ELS command has something to work with. no cap πŸ’…

and lowkey the most important bit: callers of this routine are expected to unregister the RPI first. like, before you call it. that's on you, not on this function πŸ™ˆ

Return code:

  • 0 β€” successfully issued logo πŸ‘‘
  • 1 β€” failed to issue logo πŸ’€

⭐ SEE ALSO ⭐

Kernel file ./drivers/scsi/lpfc/lpfc_els.c and, like, the entire extended universe of functions. all of them, we're not skipping a single one 🫑


🧚 the sign-off 🧚

and that's the whole page, periodt πŸ’– it came out of ./drivers/scsi/lpfc, dated October 2026, and the page itself is lpfc_issue_els_logo(9) from the Kernel API Manual β€” go unregister that RPI first, bestie, and slay πŸŒˆπŸ‘‘βœ¨

πŸ“¦ where this page comes from