io_uring_cqe_seen(3)

💖 io_uring_cqe_seen — mark io_uring completion event as consumed 💖

okay bestie, welcome to the liburing manual, this one's short and sweet and honestly kind of a queen for it.

✨ NAME ✨

io_uring_cqe_seen — mark an io_uring completion event as consumed 🎀

🌸 SYNOPSIS 🌸

#include <liburing.h>

void io_uring_cqe_seen(struct io_uring *ring,
                       struct io_uring_cqe *cqe);

🦋 DESCRIPTION 🦋

so the way this works: io_uring_cqe_seen(3) marks the IO completion cqe that belongs to the ring param as consumed. that's it. that's the whole job. iconic honestly 💅

here's the flow, bestie. after the caller has submitted a request with io_uring_submit(3), the application can grab the completion with io_uring_wait_cqe(3), io_uring_peek_cqe(3), or literally any of the other CQE retrieval helpers — and then it marks that completion as consumed with io_uring_cqe_seen(3). full circle, main character energy ✨

and this part matters, no cap: completions must be marked as completed so their slot can get reused. skip this and you're just hoarding slots, and nobody wants that 🫶

💜 RETURN VALUE 💜

None. zero. nothing. it's giving void and she's thriving 🌈

⭐ SEE ALSO ⭐

• io_uring_submit(3)
• io_uring_peek_cqe(3)
• io_uring_wait_cqe(3)
• io_uring_wait_cqes(3)
• io_uring_wait_cqe_timeout(3)

and that's the whole page, bestie 🍓 this one came from liburing-2.1, dated November 15, 2021 — go mark those completions as seen, periodt 💖✨👑