_scsih_io_done(9)

📦 version 7.3.1, in nixpkgs unstable

💅 _scsih_io_done(9) — yes bestie, we're reading a kernel callback page 🎀

okay so real talk, this is from the Kernel API Manual, section 9, and it's literally just one tiny function page. but she's important, so grab a matcha 🍵 and let's go.

✨ NAME ✨

_scsih_io_done — the scsi request callback. that's it, that's the whole name. main character energy fr 💅

🌸 SYNOPSIS 🌸

u8 _scsih_io_done (struct MPT3SAS_ADAPTER *ioc , u16 smid , u8
msix_index , u32 reply );

no cap, that's the exact signature, copy it exactly if you're typing it, do not "fix" the spacing, i am begging 🙏

🦋 ARGUMENTS 🦋

okay so she takes four things, let's meet them:

  • ioc — the per adapter object 💖 this is your adapter, your whole vibe, your struct MPT3SAS_ADAPTER *.
  • smid — the system request message index (a u16). it's the little ticket number for the message 🔥
  • msix_index — the MSIX table index, and it's supplied by the OS, not by us. thank u, operating system 🫶
  • reply — the reply message frame, and specifically the lower 32bit addr of it. a u32. cute little address slice ✨

💜 DESCRIPTION 💜

so basically: this is the callback handler when you're using _scsih_qcmd. that's the tea ☕ like, _scsih_qcmd fires something off, and then this girl right here is the one who gets called back when it's done. she's the "your call is complete, mwah" text message 💌

that's it. that's the description. short and iconic.

⭐ RETURN ⭐

she returns a u8, and the two moods are:

  1. 1 — meaning the mf should be freed from _base_interrupt 💀
  2. 0 — meaning the mf is freed from this function. she handled it herself, no notes 👑
🙈 lowkey important: which one you get tells you who is responsible for cleaning up the message frame. don't mix them up, bestie. that's a memory situation and we don't play with those.

🌈 SEE ALSO 🌈

okay so this is the part where the page goes absolutely feral — the cross-reference list is long long. like, genuinely, someone was in a mood. but we do not skip a single one, because every detail matters. here we go, hydrate first 💧

first, the file itself:

  • Kernel file ./drivers/scsi/mpt3sas/mpt3sas_scsih.c — that's the home base for all of this 🏠

and the icon lineup:

like… 219 entries. she ate and left no crumbs 👑 and yes, that's every single one, don't come for me.

🎀 quick recap so it sticks: _scsih_io_done is the callback for _scsih_qcmd, you hand her ioc, smid, msix_index and reply, and she tells you with a 1 or a 0 whether the message frame needs freeing from _base_interrupt or whether she already freed it herself. periodt. 💜

and that's the whole page bestie! this beauty lives in ./drivers/scsi/mpt3sas, she's dated October 2026, and she's _scsih_io_done(9) from the Kernel API Manual 💖✨ bye, go free your message frames responsibly 🦋

📦 where this page comes from