|author||Pavel Begunkov <email@example.com>||2021-12-01 13:20:37 +0000|
|committer||Jens Axboe <firstname.lastname@example.org>||2021-12-07 09:17:36 -0700|
man/io_uring_enter.2: notes about cqe-skip & drain interoperability
IOSQE_CQE_SKIP_SUCCESS can't be used together with draining in a single ring, add a paragraph explaining what are the restrictions. Signed-off-by: Pavel Begunkov <email@example.com> Link: https://firstname.lastname@example.org [axboe: tweak the wording] Signed-off-by: Jens Axboe <email@example.com>
1 files changed, 9 insertions, 0 deletions
diff --git a/man/io_uring_enter.2 b/man/io_uring_enter.2
index b003e05..589f3ef 100644
@@ -1115,6 +1115,15 @@ CQEs in cases where the side effects of a successfully executed operation is
enough for userspace to know the state of the system. One such example would
be writing to a synchronisation file.
+This flag is incompatible with
+Using both of them in a single ring is undefined behavior, even when they are
+not used together in a single request. Currently, after the first request with
+all subsequent requests marked with drain will be failed at submission time.
+Note that the error reporting is best effort only, and restrictions may change
+in the future.
Available since 5.17.