lpfc_debugfs_lockstat_data(9)

📦 version 7.3.1, in nixpkgs unstable

💅 lpfc_debugfs_lockstat_data — the (9) kernel API manual page, bestie edition

okay so you found the lockstat dumper, love that for you 🫶 this is section 9 of the kernel API manual — the big-brain kernel-space section — and yeah, the whole name is lpfc_debugfs_lockstat_data(9), say it with your chest.

✨ NAME ✨

lpfc_debugfs_lockstat_data — literally just dumps Hardware Queue info into a buffer. that's the whole job. she's a dumper. 💅

🦋 SYNOPSIS 🦋

int lpfc_debugfs_lockstat_data (struct lpfc_hba *phba , char *buf , int
size );

that's it, that's the signature, three args and an int coming back at you ✨

🎀 ARGUMENTS 🎀

  • phba — the HBA you're gathering host buffer info from. she's the main character here, everybody else is a supporting role 👑
  • buf — the buffer where the log gets dumped. your canvas, your stage, your little text parking spot 🌸
  • size — the maximum amount of data to process. like a word count but make it a byte count, no cap 🫶

🔥 DESCRIPTION 🔥

so this routine dumps the Hardware Queue info from phba into buf, and it will not go past size bytes. periodt.

and the way it does that is honestly kind of iconic: first it dumps a header into buf that describes the current hdwq state, and then it dumps info on each hdwq entry into buf — and it keeps going until either size bytes have been dumped or all the hdwq info has been dumped. whichever comes first, bestie, she's not gonna overstay 💀

💀 NOTES 💀

this routine will rotate through each configured Hardware Queue each time it's called. so every call she's serving a different queue — it's giving carousel, it's giving "you get a turn, you get a turn" 🎠

Return Value: this routine returns the amount of bytes that were dumped into buf, and it will not exceed size. so like, if you asked for a small size, don't act surprised when the number is small 🙈

👑 SEE ALSO 👑

the kernel file that holds the whole thing:

Kernel file ./drivers/scsi/lpfc/lpfc_debugfs.c

and now, the full friend group — every single one, bestie, no skipping, I promised 🌈:

🧚 sign-off 🧚

this whole page lives under ./drivers/scsi/lpfc in the source tree, dated October 2026, and yes it's still filed as lpfc_debugfs_lockstat_data(9) because she's consistent like that 💜

go dump some queues, bestie — you're gonna slay ✨🎀🦋

📦 where this page comes from