lpfc_issue_els_flogi(9)

πŸ“¦ version 7.3.1, in nixpkgs unstable

πŸ’… lpfc_issue_els_flogi β€” like, the FLOGI sender, but make it kernel ✨

okay so bestie, welcome to the Kernel API Manual page for lpfc_issue_els_flogi(9) β€” the function that yeets a FLOGI IOCB command out for a vport. yes it's a mouthful, no you don't have to say it out loud in class 🫢


✨ SYNOPSIS ✨

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

that's the whole vibe. three args, one int coming back at you. iconic honestly πŸ”₯


🌸 ARGUMENTS 🌸

  • vport β€” pointer to a host virtual N_Port data structure. like, the vport. the whole main character here πŸ‘‘
  • ndlp β€” pointer to a node-list data structure. your node-list bestie, you'll be seeing them again in a sec πŸ’–
  • retry β€” number of retries to the command IOCB. it's a uint8_t, so keep it smol πŸ“

πŸ¦‹ DESCRIPTION πŸ¦‹

so what actually happens? this routine issues a Fabric Login (FLOGI) Request ELS command for a vport. that's the whole point, that's the assignment, slay πŸ’…

here's the tea tho:

  • the initiator service parameters get put into the payload of the FLOGI Request IOCB ✨
  • the top-level callback function pointer to lpfc_cmpl_els_flogi gets put into the IOCB completion callback function field πŸŽ€
  • then lpfc_issue_fabric_iocb is invoked to send out the FLOGI ELS command β€” and ngl, that's with one outstanding fabric IOCB at a time. only one. no cap, no crowd, single file line πŸ™ˆ
⚠️ heads up bestie: note that 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, so the completion callback function for the FLOGI ELS command can get at it later. it's giving "took a number, will call you back" energy 😭

and the return codes, because you know we don't skip those:

  • return code 0 β€” successfully issued flogi iocb for vport 🌈
  • return code 1 β€” failed to issue flogi iocb for vport πŸ’€

⭐ SEE ALSO ⭐

the kernel file lives at ./drivers/scsi/lpfc/lpfc_els.c β€” and okay, the cross-reference list is literally a friend group at this point, there's so many of them. full roster, nobody left behind, iykyk πŸ‘‘


🧚 and that's the page!! source: ./drivers/scsi/lpfc, dated October 2026, living in the Kernel API Manual as lpfc_issue_els_flogi(9). go forth and FLOGI responsibly bestie, mwah πŸ’œ
πŸ“¦ where this page comes from