diff options
Diffstat (limited to 'man/io_uring_sqe_set_flags.3')
| -rw-r--r-- | man/io_uring_sqe_set_flags.3 | 26 |
1 files changed, 25 insertions, 1 deletions
diff --git a/man/io_uring_sqe_set_flags.3 b/man/io_uring_sqe_set_flags.3 index 23f5c8c..75e836b 100644 --- a/man/io_uring_sqe_set_flags.3 +++ b/man/io_uring_sqe_set_flags.3 @@ -35,7 +35,9 @@ Normal operation for io_uring is to try and issue an sqe as non-blocking 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 application can ask for an sqe to be -issued async from the start. +issued async from the start. Note that this flag immediately causes the SQE +to be offloaded to an async helper thread with no initial non-blocking attempt. +This may be less efficient and should not be used sporadically. .TP .B IOSQE_IO_LINK When this flag is specified, the SQE forms a link with the next SQE in the @@ -50,13 +52,35 @@ executing in parallel, or chains and individual SQEs. Only members inside the chain are serialized. A chain of SQEs will be broken if any request in that chain ends in error. .TP +.B IOSQE_IO_HARDLINK +Like +.B IOSQE_IO_LINK , +except the links aren't severed if an error or unexpected result occurs. +.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. +.TP +.B IOSQE_CQE_SKIP_SUCCESS +Request that no CQE be generated for this request, if it completes successfully. +This can be useful in cases where the application doesn't need to know when +a specific request completed, if it completed succesfully. +.TP +.B IOSQE_BUFFER_SELECT +If set, and if the request types supports it, select an IO buffer from the +indicated buffer group. This can be used with requests that read or receive +data from a file or socket, where buffer selection is deferred until the kernel +is ready to transfer data, instead of when the IO is originally submitted. The +application must also set the +.I buf_group +field in the SQE, indicating which previously registered buffer group to select +a buffer from. .SH RETURN VALUE None .SH SEE ALSO .BR io_uring_submit (3), .BR io_uring_register (3) +.BR io_uring_register_buffers (3) +.BR io_uring_register_buf_ring (3) |