k3_ringacc_request_ring(9)

💖 k3_ringacc_request_ring 💖

okay so this is a page from the Kernel API Manual bestie, and it's all about grabbing yourself a ring from the ringacc. yes, the ring accumulator. it's giving hardware-queue realness and honestly? kind of iconic. let's get into it 🎀

---

✨ NAME ✨

k3_ringacc_request_ring — request ring from ringacc 💅

like, you're politely asking the ringacc for a ring. that's the whole vibe. no cap.

---

🌸 SYNOPSIS 🌸

struct k3_ring * k3_ringacc_request_ring (struct k3_ringacc *ringacc ,
int id , u32 flags );

look at that signature, she's serving. struct k3_ring * coming back at you, and she takes a struct k3_ringacc *ringacc, an int id, and a u32 flags. three lil args and you're in business. 🦋

---

🫶 ARGUMENTS 🫶

• ringacc — pointer on ringacc. literally just a pointer to your ringacc, that's her whole job. give her the pointer, she does the rest. ✨
• id — ring id or K3_RINGACC_RING_ID_ANY for any general purpose ring. so like, you can be picky and ask for a specific ring id, OR you can be chill and use K3_RINGACC_RING_ID_ANY and let it pick any general purpose ring for you. main character energy either way. 👑
• flags — (that's it bestie, the manpage doesn't say more about this one, so I'm not gonna invent lore. it's just flags. 🙈)

---

🔥 DESCRIPTION 🔥

Returns pointer on the Ring — struct k3_ring — or NULL in case of failure.

that's the tea. you call her, she hands you back a pointer to your very own struct k3_ring. and if things go sideways? you get NULL. no ring for you. 💀 so fr fr, always check that return value before you go dereferencing, okay? 🧚

ngl a NULL return is your cue to bail gracefully — she's not gonna crash for you, that part's on you 💜

---

🌈 SEE ALSO 🌈

• Kernel file ./include/linux/soc/ti/k3-ringacc.h — and then a whole friend group of related pages: enum k3_ring_mode(9), enum k3_ring_size(9), of_k3_ringacc_get_by_phandle(9), k3_ringacc_ring_reset(9), k3_ringacc_ring_free(9), k3_ringacc_get_ring_id(9), k3_ringacc_get_ring_irq_num(9), k3_ringacc_ring_cfg(9), k3_ringacc_ring_get_size(9), k3_ringacc_ring_get_free(9), k3_ringacc_ring_get_occ(9), k3_ringacc_ring_is_full(9), k3_ringacc_ring_push(9), k3_ringacc_ring_pop(9), k3_ringacc_ring_push_head(9), k3_ringacc_ring_pop_tail(9)

like, the whole k3_ringacc_ring_* friend group is listed there — go say hi if you need push/pop/reset/free energy, or peek at the size/free/occ/is_full girlies for the state checks. iykyk 🌸

---

⭐ and that's the page! this one lives in ./include/linux/soc/ti, dated October 2026, and the page itself is k3_ringacc_request_ring(9) 💖 go request your ring bestie, you got this 🎀🦋✨