summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJens Axboe <axboe@kernel.dk>2022-04-14 11:22:51 -0600
committerJens Axboe <axboe@kernel.dk>2022-04-14 11:22:51 -0600
commit7cea31e742c175b8df2895b57f472b49ff514ee0 (patch)
tree4eb7f8de9a95a3d3d104ad9aa6ff465f36c070ae
parentb418e563026380ee697c7cf9d9fbb26ea62d6cb8 (diff)
downloadliburing-7cea31e742c175b8df2895b57f472b49ff514ee0.tar.gz
liburing-7cea31e742c175b8df2895b57f472b49ff514ee0.tar.bz2
man/io_uring_setup.2: document recent FEAT flag additions
The man page was missing IORING_FEAT_CQE_SKIP and IORING_FEAT_LINKED_FILE, add an explanation for them. Signed-off-by: Jens Axboe <axboe@kernel.dk>
-rw-r--r--man/io_uring_setup.219
1 files changed, 19 insertions, 0 deletions
diff --git a/man/io_uring_setup.2 b/man/io_uring_setup.2
index c54c5da..f3911af 100644
--- a/man/io_uring_setup.2
+++ b/man/io_uring_setup.2
@@ -337,6 +337,25 @@ If this flag is set, then io_uring supports a variety of features related
to fixed files and buffers. In particular, it indicates that registered
buffers can be updated in-place, whereas before the full set would have to
be unregistered first. Available since kernel 5.13.
+.TP
+.B IORING_FEAT_CQE_SKIP
+If this flag is set, then io_uring supports setting
+.B IOSQE_CQE_SKIP_SUCCESS
+in the submitted SQE, indicating that no CQE should be generated for this
+SQE if it executes normally. If an error happens processing the SQE, a
+CQE with the appropriate error value will still be generated. Available since
+kernel 5.17.
+.TP
+.B IORING_FEAT_LINKED_FILE
+If this flag is set, then io_uring supports sane assignment of files for SQEs
+that have dependencies. For example, if a chain of SQEs are submitted with
+.B IOSQE_IO_LINK,
+then kernels without this flag will prepare the file for each link upfront.
+If a previous link opens a file with a known index, eg if direct descriptors
+are used with open or accept, then file assignment needs to happen post
+execution of that SQE. If this flag is set, then the kernel will defer
+file assignment until execution of a given request is started. Available since
+kernel 5.17.
.PP
The rest of the fields in the