ibmvscsis_free_command_q(9)

📦 version 7.3.1, in nixpkgs unstable

💖 ibmvscsis_free_command_q(9) 💖

hey bestie, welcome to this Kernel API Manual page — it's giving kernel-function realness, and we're gonna get through it together. 💅

🌸 NAME 🌸

ibmvscsis_free_command_q — Free Command Queue

✨ SYNOPSIS ✨

long ibmvscsis_free_command_q (struct scsi_info *vscsi );

🎀 ARGUMENTS 🎀

  • vscsi — pointer to our adapter structure. that's the whole vibe. 🫶

🦋 DESCRIPTION 🦋

okay so here's the tea: this function calls unregister_command_q, then it clears interrupts and any pending interrupt acknowledgments that are associated with the command q. it also clears memory if there is no error. ✨

PHYP did not meet the PAPR architecture, so that means we have to give up the lock. 😭 that causes a timing hole regarding state change. to close that hole, this routine does accounting on any change that occurred during the time the lock is not held. 🫶

💀 NOTE 💀

because it must give up and then acquire the interrupt lock, the caller must make sure that state and/or flags will prevent the interrupt handler from scheduling work. no cap, that part matters. 👑

EXECUTION ENVIRONMENT: Process level, interrupt lock is held.

🌈 SEE ALSO 🌈

Kernel file ./drivers/scsi/ibmvscsi_tgt/ibmvscsi_tgt.c — and honestly, the whole squad is here:

source/version is ./drivers/scsi/ibmvscsi_tgt, dated October 2026, and the page is ibmvscsis_free_command_q(9) — byeee, bestie 💅🎀

📦 where this page comes from