ata_scsi_rbuf_fill(9)

📦 version 7.3.1, in nixpkgs unstable

💅 ata_scsi_rbuf_fill(9) — the kernel API manual, bestie edition 🎀

okay so this is a page from the Kernel API Manual, section 9 (iykyk), and it's all about ata_scsi_rbuf_fill — the little wrapper that does the unglamorous backstage work so your SCSI command simulators can main-character their way through. ✨

🌸 NAME 🌸

ata_scsi_rbuf_fill — literally just a wrapper for SCSI command simulators. that's the whole vibe. 🫶

🦋 SYNOPSIS 🦋

void ata_scsi_rbuf_fill (struct ata_device *dev , struct scsi_cmnd *cmd
, unsigned int (*actor)(struct ata_device *dev, struct scsi_cmnd *cmd,
u8 *rbuf) );

no cap, that's the signature. the function-pointer parameter goes hard. 🔥

💖 ARGUMENTS 💖

  • dev — the Target device. like, who are we even talking to here. 👑
  • cmd — the SCSI command of interest. the one we're simming. 🎯
  • actor — the Callback hook for desired SCSI command simulator. yes bestie, you bring your own handler and this thing calls it for you. 🧚

✨ DESCRIPTION ✨

so here's the tea: this function takes care of the hard work of simulating a SCSI command... and by "the hard work" we mean the boring-but-essential trio:

  • Mapping the response buffer
  • calling the command's handler
  • and handling the handler's return value

and that return value? it's the handler's way of telling you what it wants to happen next:

  • 0 → the handler wishes the SCSI command to be completed successfully 💚
  • anything else (not 0) → nope, not successful, and in that case cmd->result and the sense buffer are assumed to be set — like, the handler already did that part, don't come for it. 🙈
LOCKING: spin_lock_irqsave(host lock) — yes, this is the locking context. respect the lock, bestie. 💀

👑 SEE ALSO 👑

first off, the source vibes come from the kernel file ./drivers/ata/libata-scsi.c — go look, it's giving lore. 🌈

and now, the full squad (all of these, no skips, we don't do that here):

okay and finally, the cute lil sign-off: this whole thing lives over in ./drivers/ata, and the version/date stamp says October 2026 with the title ata_scsi_rbuf_fill(9). periodt. 💅🎀💜

📦 where this page comes from