hisi_acc_sg...ap_to_hw_sgl(9)

💅 hisi_acc_sg_buf_map_to_hw_sgl — the Kernel API Manual page, bestie edition ✨

okay so this is a page out of the Linux Kernel API Manual (that's the manual name, iykyk), and it's literally all about one function: hisi_acc_sg_buf_map_to_hw_sgl. Say that five times fast, I dare you 😭

---

🎀 NAME 🎀

hisi_acc_sg_buf_map_to_hw_sgl — it maps a scatterlist to a hw sgl. That's it, that's the whole job. Slay. 💅

---

✨ SYNOPSIS ✨

struct hisi_acc_hw_sgl * hisi_acc_sg_buf_map_to_hw_sgl (struct device
*dev , struct scatterlist *sgl , struct hisi_acc_sgl_pool *pool , u32
index , dma_addr_t *hw_sgl_dma , enum dma_data_direction dir );

like… look at that signature. it's giving "six arguments and every single one of them matters" energy 👑

---

🫶 ARGUMENTS 🫶

• dev — the device which hw sgl belongs to. the main character, fr fr 💖
• sgl — the scatterlist which will be mapped to hw sgl. it's getting a glow-up ✨
• pool — the pool which hw sgl memory will be allocated in. this is where the memory lives, no cap 🏠
• index — the index of hisi_acc_hw_sgl in pool. you gotta know your place bestie 💅
• hw_sgl_dma — the dma address of allocated hw sgl. this is the output, the whole point, the moment 🔥
• dir — DMA direction. which way are we going? yes. 🌈

---

🦋 DESCRIPTION 🦋

okay so here's the tea ☕: this function builds hw sgl according to the input sgl. then — and this is the good part — the user can use hw_sgl_dma as src/dst in its BD. chef's kiss, ate, no crumbs 🍓

and the plot twist: it only supports single hw sgl currently. that's it. one. singular. a solo act. 🧚 not me finding that lowkey iconic

ngl bestie, don't go expecting multiples here — single hw sgl is the whole vibe check 💀

---

👑 SEE ALSO 👑

• the Kernel file ./drivers/crypto/hisilicon/sgl.c — go read the source, it's right there, iykyk 📖
• hisi_acc_create_sgl_pool(9) — the pool-making one 🏊
• hisi_acc_free_sgl_pool(9) — the pool-freeing one, cleanup crew 🧹
• hisi_acc_sg_buf_unmap(9) — the unmap one, the reverse icon 🔁

---

and that's the page!! 🎀 this absolute gem comes to you from ./drivers/crypto/hisilicon (the source/version bestie), dated October 2026 — yes, she's from the future, and she's still slaying. periodt. 💜🦋✨🌸