asd_ascb_alloc_list(9)

💖 asd_ascb_alloc_list(9) 💖

okay bestie, welcome to the Kernel API Manual page for asd_ascb_alloc_list — yes that's a (9) section page, we're in the deep kernel lore now and honestly? iconic behavior. 🎀

---

✨ NAME ✨

asd_ascb_alloc_list — allocate a list of aSCBs 🦋

---

✨ SYNOPSIS ✨

struct asd_ascb * asd_ascb_alloc_list (struct asd_ha_struct *asd_ha ,
int *num , gfp_t gfp_flags );

like, that's the whole signature. no cap. 🌸

---

✨ ARGUMENTS ✨

• asd_ha — pointer to the host adapter structure 🫶 (the main-character struct, obviously)
• num — pointer to an integer number of aSCBs 🔢
• gfp_flags — GFP_ flags ⭐ (yes, with the underscore, we're being precise)

---

✨ DESCRIPTION ✨

okay so listen 💅 this is the only function which is used to allocate aSCBs. the only one. main character energy fr fr. and like, it's flexible too — it can allocate one, or it can allocate many. lowkey overachiever.

if it's more than one, then they form a linked list in two ways:

• by their list field of the ascb struct 🎀
• and by the next_scb field of the scb_header 🌈

double-linked-list realness. the way that it threads itself twice?? obsessed. ✨

So what does it return?? It returns NULL if no memory was available 😭 — that's the sad path, no memory, nothing for you. Else, it returns a pointer to a list of ascbs. 💖

and here's the lil plot twist you gotta know: when this function returns, num would be the number of SCBs which were not able to be allocated — so 0 if all requested were able to be allocated. 🫶 yes bestie, it's the failure count, not the success count. read it twice. iykyk. 🔥

⚠️ heads up: num is a pointer to an integer, and it gets written to on return. that's the vibe check you need to pass before calling. 💀

---

✨ SEE ALSO ✨

Kernel file ./drivers/scsi/aic94xx/aic94xx_hwi.c — and the whole friend group:

• asd_init_scbs(9)
• asd_init_escbs(9)
• asd_chip_hardrst(9)
• asd_init_chip(9)
• asd_init_ctxmem(9)
• asd_chip_reset(9)
• asd_process_donelist_isr(9)
• asd_com_sas_isr(9)
• asd_dch_sas_isr(9)
• asd_rbi_exsi_isr(9)
• asd_hst_pcix_isr(9)
• asd_hw_isr(9)
• asd_swap_head_scb(9)
• asd_start_scb_timers(9)
• asd_post_ascb_list(9)
• asd_post_escb_list(9)
• asd_turn_led(9)
• asd_control_led(9)

go read them, they're all baddies. 👑

---

and that's the page!! 🎉 it lives over in ./drivers/scsi/aic94xx, and the version vibe stamped on it is October 2026 — so like, future-dated, we love a forward-thinking era. 💜 slay, bye!! 🧚‍♀️