xref: /aosp_15_r20/external/liburing/man/io_uring_cq_advance.3 (revision 25da2bea747f3a93b4c30fd9708b0618ef55a0e6)
Copyright (C) 2022 Stefan Roesch <[email protected]>

SPDX-License-Identifier: LGPL-2.0-or-later

io_uring_cq_advance 3 "January 25, 2022" "liburing-2.1" "liburing Manual"
NAME
io_uring_cq_advance - 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)