tb_ring_poll(9)

💖 tb_ring_poll(9) — bestie edition 💖

okay so this is a page straight out of the Kernel API Manual, and it's literally called tb_ring_poll(9) — yes the number is part of the name, that's just how kernel manpages do it, iykyk 🎀

---

🌸 NAME 🌸

tb_ring_poll — poll one completed frame from the ring 🦋

like… grab exactly one finished frame out of the ring. one. just one. ✨

✨ SYNOPSIS ✨

struct ring_frame * tb_ring_poll (struct tb_ring *ring );

that's the whole signature, copy it exactly bestie, no cap 💅

🎀 ARGUMENTS 🎀

• ring — the ring you're polling 💖 (the ring to poll, that's the whole vibe)

🔥 DESCRIPTION 🔥

so here's when you're allowed to call this, and it is lowkey specific:

• when the start_poll callback of the ring has been called, OR
• the ring was created with RING_FLAG_NO_INTERRUPT 🫶

in those cases this function will read one completed frame from the ring and return it to the caller. that's it. one frame. it's giving minimalism, it's giving "one job and it does it" 👑

⭐ RETURN ⭐

it hands you back a pointer to struct ring_frame 💫

and if there are no more completed frames? you get NULL. that's the signal, don't ignore it 🙈

🌈 SEE ALSO 🌈

Kernel file ./drivers/thunderbolt/nhi.c — go read it, it's the main character of this whole story 📖

• tb_ring_poll_complete(9)
• tb_ring_alloc_tx(9)
• tb_ring_alloc_rx(9)
• tb_ring_start(9)
• tb_ring_flush(9)
• tb_ring_stop(9)
• tb_ring_throttling(9)
• nhi_mailbox_cmd(9)
• nhi_mailbox_mode(9)

all of these, no skips, collect them like Pokémon 🧚💜

---

and that's the whole page bestie 🎀 sign-off time: this one lives in ./drivers/thunderbolt, dated October 2026 — periodt, end of page, go poll some rings 💅✨🌸