summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJens Axboe <axboe@kernel.dk>2020-02-01 11:04:41 -0700
committerJens Axboe <axboe@kernel.dk>2020-02-01 11:04:41 -0700
commit9416351377f04211f859667f39a58d2a223cbd21 (patch)
treedfbb31febcbb386afac59f2c462b468505c4bfd0
parent75d088eaecaa9006fd9e38344a050e9fba5abe10 (diff)
downloadliburing-9416351377f04211f859667f39a58d2a223cbd21.tar.gz
liburing-9416351377f04211f859667f39a58d2a223cbd21.tar.bz2
man/io_uring_enter.2: clarify how/when IOSQE_IO_LINK are terminated
Signed-off-by: Jens Axboe <axboe@kernel.dk>
-rw-r--r--man/io_uring_enter.28
1 files changed, 7 insertions, 1 deletions
diff --git a/man/io_uring_enter.2 b/man/io_uring_enter.2
index ca8a736..94ab625 100644
--- a/man/io_uring_enter.2
+++ b/man/io_uring_enter.2
@@ -545,7 +545,13 @@ 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. Available since 5.3.
+chain are serialized. A chain of SQEs will be broken, if any request in that
+chain ends in error. io_uring considers any unexpected result an error. This
+means that, eg, a short read will also terminate the remainder of the chain.
+If a chain of SQE links is broken, the remaining unstarted part of the chain
+will be terminated and completed with
+.B -ECANCELED
+as the error code. Available since 5.3.
.TP
.B IOSQE_IO_HARDLINK
Like IOSQE_IO_LINK, but it doesn't sever regardless of the completion result.