summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJens Axboe <axboe@kernel.dk>2020-01-30 10:34:14 -0700
committerJens Axboe <axboe@kernel.dk>2020-01-30 10:34:14 -0700
commit352a7b7085f7e1450c432c53a56ea5c1d2e28ec1 (patch)
treea42ae5ca77574383de76d9417883a1b3f10db38a
parentb9c4d35ffc9156243b5502443648592a0ed457a9 (diff)
downloadliburing-352a7b7085f7e1450c432c53a56ea5c1d2e28ec1.tar.gz
liburing-352a7b7085f7e1450c432c53a56ea5c1d2e28ec1.tar.bz2
man/io_uring_enter.2: add IOSQE_ASYNC
Also include kernel version availability for all the other flags. Signed-off-by: Jens Axboe <axboe@kernel.dk>
-rw-r--r--man/io_uring_enter.215
1 files changed, 12 insertions, 3 deletions
diff --git a/man/io_uring_enter.2 b/man/io_uring_enter.2
index 3fac4fd..ca8a736 100644
--- a/man/io_uring_enter.2
+++ b/man/io_uring_enter.2
@@ -530,12 +530,12 @@ is an index into the files array registered with the io_uring instance (see the
.B IORING_REGISTER_FILES
section of the
.BR io_uring_register (2)
-man page).
+man page). Available since 5.1.
.TP
.B IOSQE_IO_DRAIN
When this flag is specified, the SQE will not be started before previously
submitted SQEs have completed, and new SQEs will not be started before this
-one completes.
+one completes. Available since 5.2.
.TP
.B IOSQE_IO_LINK
When this flag is specified, it forms a link with the next SQE in the
@@ -545,13 +545,22 @@ of the chain is denoted by the first SQE that does not have this flag set.
This flag has no effect on previous SQE submissions, nor does it impact SQEs
that are outside of the chain tail. This means that multiple chains can be
executing in parallel, or chains and individual SQEs. Only members inside the
-chain are serialized.
+chain are serialized. Available since 5.3.
.TP
.B IOSQE_IO_HARDLINK
Like IOSQE_IO_LINK, but it doesn't sever regardless of the completion result.
Note that the link will still sever if we fail submitting the parent request,
hard links are only resilient in the presence of completion results for
requests that did submit correctly. IOSQE_IO_HARDLINK implies IOSQE_IO_LINK.
+Available since 5.5.
+.TP
+.B IOSQE_ASYNC
+Normal operation for io_uring is to try and issue an sqe as non-blockin first,
+and if that fails, execute it in an async manner. To support more efficient
+overlapped operation of requests that the application knows/assumes will
+always (or most of the time) block, the applocation can ask for an sqe to be
+issued async from the start. Available since 5.6.
+
.PP
.I ioprio