io_uring_cq_advance - Man Page

mark one or more io_uring completion events as consumed

Synopsis

#include <liburing.h>

void io_uring_cq_advance(struct io_uring *ring,
                          unsigned nr);

Description

The io_uring_cq_advance(3) function marks nr IO completions belonging to the ring param as consumed.

After the caller has submitted a request with io_uring_submit(3), the application can retrieve the completion with io_uring_wait_cqe(3), io_uring_peek_cqe(3), or any of the other CQE retrieval helpers, and mark it as consumed with io_uring_cqe_seen(3).

The function io_uring_cqe_seen(3) calls the function io_uring_cq_advance(3).

Completions must be marked as seen, so their slot can get reused. Failure to do so will result in the same completion being returned on the next invocation.

Return Value

None

See Also

io_uring_submit(3), io_uring_wait_cqe(3), io_uring_peek_cqe(3), io_uring_wait_cqes(3), io_uring_wait_cqe_timeout(3), io_uring_cqe_seen(3)

Referenced By

io_uring_buf_ring_cq_advance(3), io_uring_for_each_cqe(3).

January 25, 2022 liburing-2.1 liburing Manual