lpfc_sli4_cgn_parm_chg_evt(9)

📦 version 7.3.1, in nixpkgs unstable

💅 lpfc_sli4_cgn_parm_chg_evt — NAME

okay so bestie, this is a page straight out of the Kernel API Manual, section 9, and it's all about lpfc_sli4_cgn_parm_chg_evt — Process a FW congestion param change event. 🎀 That's the whole name, no notes, iconic behaviour.

✨ SYNOPSIS ✨

int lpfc_sli4_cgn_parm_chg_evt (struct lpfc_hba *phba );

like, it takes one thing and returns an int. we love a simple signature. 🫶

🌸 ARGUMENTS 🌸

  • phba — pointer to lpfc hba data structure. that's it. that's the whole argument list. queen of minimalism. 👑

🦋 DESCRIPTION 🦋

okay so here's the lore. The FW generated Async ACQE SLI event calls this routine when the event type is an SLI Internal Port Event and the Event Code indicates a change to the FW maintained congestion parameters. so like, the firmware is basically texting the driver "hey girl, the congestion params moved" 💅

When that happens, this routine executes a Read_Object mailbox call to obtain the current congestion parameters maintained in FW, and then corrects the driver's active congestion parameters. no cap, that's the whole job — go get the real numbers, fix up what the driver thinks it knows. ✨

not me pointing out that the acqe event is not passed — that's on purpose, because there is no further data required. zero extra info needed, so it just doesn't come along. 🙈

Return value: returns nonzero error if event processing encountered an error. Zero otherwise for success. so 0 = slay, nonzero = 😭.

fr fr, don't ignore a nonzero return here. that's the driver telling you something went sideways while it was trying to fix its congestion params. 💀

👑 SEE ALSO 👑

the squad of related calls, all living in Kernel file ./drivers/scsi/lpfc/lpfc_init.c — every single one of them, exactly as listed, because we do not skip entries in this house:

iykyk, that's a full friend group and they're all invited. 🧚

🌈 the cute sign-off 🌈

this iconic little page shipped out of ./drivers/scsi/lpfc, dated October 2026, and answers to the name lpfc_sli4_cgn_parm_chg_evt(9). go read your congestion params, bestie, and stan a driver that keeps them fresh. ⭐🦋💜

📦 where this page comes from