lpfc_initial_fdisc(9)

📦 version 7.3.1, in nixpkgs unstable

💅 lpfc_initial_fdisc — from the Kernel API Manual ✨

okay so picture this: you're a virtual port (a vport, bestie) and you've literally never done fabric discovery before. not once. brand new. and this function? this is the glow-up. 🦋 lpfc_initial_fdisc is the routine that kicks off your very first Fabric Discover (FDISC) — your debut into the fabric, your main character entrance, your "hi bestie, i'm here" moment. periodt.

✨ SYNOPSIS ✨

int lpfc_initial_fdisc (struct lpfc_vport *vport );

🎀 ARGUMENTS 🎀

  • vport — pointer to a host virtual N_Port data structure. yeah. it's the vport. it's the one getting the whole FDISC treatment. she's the moment. 💖

🌸 DESCRIPTION 🌸

so this routine issues an initial Fabric Discover (FDISC) for the vport you handed it. that's the whole vibe. but the way that it does it is lowkey a little three-act structure, so let's break it down:

  1. first thing, it goes searching through the vport's ndlp list for an ndlp with Fabric_DID (0xfffffe). like, "do i already have my fabric buddy in here somewhere, or…" 👀
  2. if no such ndlp is found — no fabric buddy, tragic — it just creates one and drops it into the vport's ndlp list. making friends out of thin air, iconic honestly. 💅
  3. if an inactive ndlp is found on the list? oh, she's not new, she's just resting. it gets enabled and made active. no new allocation needed, we're reviving the existing one. slay. ✨

then, once the whole ndlp situation is sorted, lpfc_issue_els_fdisc is invoked with the vport and the ndlp to actually perform the FDISC for the vport. that's the fireworks moment. 🎆

and what do you get back? two possible return codes, no in-between:

  • 0 — failed to issue initial fdisc for vport. 😭 rough. not the vibe. we don't talk about it.
  • 1 — successfully issued initial fdisc for vport. 🔥 ate. no crumbs. the fabric now knows about you.
ngl the 0 vs 1 thing is a real vibe check — don't assume 0 means "all good," because in this house 0 is the failure. read your return value carefully bestie, i'm begging. 🫶

👑 SEE ALSO 👑

this is the entire friendship group, and honestly they're all in the same file, so it's giving family reunion:

and yes, all of these live in the kernel file ./drivers/scsi/lpfc/lpfc_els.c — one file, one giant friend group, no cap. 💀

kay that's the whole page bestie!! 🌈 this lil gem comes to you from the good people at ./drivers/scsi/lpfc, dated October 2026, and it's filed under lpfc_initial_fdisc(9) — go forth and discover some fabric, you absolute icon 💖✨🎀

📦 where this page comes from