pmcraid_init_buffers(9)

📦 version 7.3.1, in nixpkgs unstable

💖 pmcraid_init_buffers 💖

okay so real talk, this page is straight out of the Kernel API Manual (section 9, we love a classic), and it's all about pmcraid_init_buffers. buckle up bestie, it's a memory-allocating girlie 🎀

✨ NAME ✨

pmcraid_init_buffers — allocates memory and initializes various structures. that's it, that's the whole vibe. she allocates, she initializes, she leaves 💅

🌸 SYNOPSIS 🌸

int pmcraid_init_buffers (struct pmcraid_instance *pinstance );

(yes the space before the closing paren is canon, don't come for me 🫶)

🎀 ARGUMENTS 🎀

  • pinstance — pointer to per adapter instance structure. one pointer, one adapter, one destiny ✨

💅 DESCRIPTION 💅

so this routine pre-allocates memory — like, ahead of time, before anyone's panicking — and the kind of memory she grabs depends on the type of block. it's giving "organized bestie with labeled bins" 🧺

here's the full breakdown, no cap:

  • cmdblocks (PMCRAID_MAX_CMD) — kernel memory using kernel's slab_allocator
  • IOARCBs (PMCRAID_MAX_CMD) — DMAable memory, using pci pool allocator
  • config-table entries — DMAable memory using dma_alloc_coherent
  • HostRRQs — DMAable memory, using dma_alloc_coherent

lowkey iconic how there are two whole PMCRAID_MAX_CMD situations and two whole dma_alloc_coherent situations. that's not a coincidence, that's a pattern, iykyk 💀

🔥 Return Value 🔥

she returns 0 in case all of the blocks are allocated. if not? -ENOMEM. that's the whole story — all-or-nothing energy, main character behavior fr fr 😭

🦋 SEE ALSO 🦋

this is the part where the page goes absolutely feral with cross-references, and i respect it. also flagging the source file first: Kernel file ./drivers/scsi/pmcraid.c 👑

the whole extended friend group, in order, no skips, no edits:

like i said. absolutely unhinged cross-reference list and honestly? obsessed 💜

and that's the page!! source lives in ./drivers/scsi, dated October 2026 — so she's recent, she's relevant, she's serving kernel documentation realness 🌈✨ mwah, go allocate responsibly bestie 🫶💖

📦 where this page comes from