lpfc_issue_els_fdisc(9)

πŸ“¦ version 7.3.1, in nixpkgs unstable

🌸 lpfc_issue_els_fdisc 🌸

bestie, welcome to lpfc_issue_els_fdisc(9) β€” this is a page straight out of the Kernel API Manual, and it's all about firing off one very specific little command into the fibre channel void. let's get into it πŸ¦‹


✨ NAME ✨

lpfc_issue_els_fdisc β€” issue a fdisc iocb command πŸ’… (yes that's the whole name, we love a one-liner)


πŸŽ€ SYNOPSIS πŸŽ€

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

πŸ’– ARGUMENTS πŸ’–

  • vport β€” pointer to a virtual N_Port data structure. your vport, your vibe ✨
  • ndlp β€” pointer to a node-list data structure. the node bestie in question 🫢
  • retry β€” number of retries to the command IOCB. a uint8_t, so like, small numbers only πŸ”₯

πŸ‘‘ DESCRIPTION πŸ‘‘

okay so what does this routine actually do? it prepares and issues a Fabric Discover (FDISC) IOCB to a remote node (ndlp) off a vport. that's the whole main character moment 😌

the way it works: it uses the lpfc_issue_fabric_iocb routine to issue that IOCB, and that's the slay, because it makes sure only one outstanding fabric IOCB will be sent off the HBA at any given time. one at a time, no chaotic group-chat energy, periodt πŸ’€

⚠️ important note, don't skip this: 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 for the completion callback function to the FDISC ELS command. so like, the reference is being held on purpose, iykyk 🌈

and the return codes, bestie:

  • 0 β€” Successfully issued fdisc iocb command βœ…
  • 1 β€” Failed to issue fdisc iocb command 😭

πŸ¦‹ SEE ALSO πŸ¦‹

located in the kernel file ./drivers/scsi/lpfc/lpfc_els.c β€” and ngl, this list is iconic, it's giving whole-family-reunion energy, so here's every single one, no cap, nothing cut πŸ’œ


that's the whole page bestie, you ate that πŸ“ mwah πŸ’‹

cute little sign-off: this one lives in ./drivers/scsi/lpfc and the page is dated October 2026 β€” the version/date situation, handled ✨ go forth and issue those IOCBs responsibly πŸ’…
πŸ“¦ where this page comes from