STRUCT SDMA_ENGINE(9)

💅 struct sdma_engine(9) — bestie edition

okay so sticky note first: this is a page from the Kernel API Manual, and the star of the show is struct sdma_engine(9). yes the title is literally the name of the struct. iconic behavior tbh.

---

✨ NAME ✨

struct sdma_engine — the data that pertains to each SDMA engine. one of these per engine, no cap. 🦋

---

🌸 SYNOPSIS 🌸

like, here's the whole struct, and honestly it's giving "small but mighty":

struct sdma_engine {
    struct hfi1_devdata *dd;
    struct hfi1_pportdata *ppd;
 };

lowkey obsessed with how short that is. two pointers. that's the whole vibe. 💀

---

🎀 Members 🎀

• dd — a back-pointer to the device data. it's the "who's your device" link, fr fr. 🫶
• ppd — the per port back-pointer. one port, one pointer, periodt. ✨

---

💖 Description 💖

so this structure has the state for each sdma_engine. that's it, that's the whole job — it's the main character energy container holding an engine's state. 👑

and here's the part where i have to be a responsible bestie: accessing the non-public fields is not supported, because those private members are subject to change. like, they will absolutely get rearranged on you. so don't go poking at the private stuff, ngl. 🙈

⚠️ warning, gently: private members = subject to change = not your business. touch the public stuff only. 💅

---

🌈 SEE ALSO 🌈

go read these next, i promise they're worth it:

• Kernel file ./drivers/infiniband/hw/hfi1/sdma.h
• sdma exported routines(9)
• sdma PSM/verbs API(9)
• Infrastructure calls(9)
• sdma_empty(9)
• sdma_running(9)
• sdma_txinit_ahg(9)
• sdma_txinit(9)
• sdma_txadd_page(9)
• sdma_txadd_daddr(9)
• sdma_txadd_kvaddr(9)
• sdma_progress(9)
• struct sdma_map_elem(9)
• sdma_engine_progress_schedule(9)

---

okay that's the whole page, you ate that 🍓 and for the record, this one lives in ./drivers/infiniband/hw/hfi1 and it's dated October 2026 — so like, future vibes 💜 bye bestie!! 🧚🔥