From a35ff2236ebe2610ee756c45e35dbd20739b59df Mon Sep 17 00:00:00 2001 From: Pavel Begunkov Date: Wed, 21 Sep 2022 12:21:57 +0100 Subject: [PATCH] man: note about notification generation Add a small note to clarify expectations on when to expect a notification. Signed-off-by: Pavel Begunkov Link: https://lore.kernel.org/r/4ae18336994f973d2e5e111479844c79547d7922.1663759148.git.asml.silence@gmail.com Signed-off-by: Jens Axboe --- man/io_uring_enter.2 | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/man/io_uring_enter.2 b/man/io_uring_enter.2 index d87f2541..e0ce051e 100644 --- a/man/io_uring_enter.2 +++ b/man/io_uring_enter.2 @@ -1091,7 +1091,10 @@ long time, e.g. waiting for a TCP ACK, and having a separate cqe for request completions allows userspace to push more data without extra delays. Note, notifications are only responsible for controlling the lifetime of the buffers, and as such don't mean anything about whether the data has atually been sent -out or received by the other end. +out or received by the other end. Even errored requests may generate a +notification, and the user must check for +.B IORING_CQE_F_MORE +rather than relying on the result. .I fd must be set to the socket file descriptor,