1io_uring_submit_and_wait_timeout(l3i)buring Maniuoa_luring_submit_and_wait_timeout(3)
2
3
4
6 io_uring_submit_and_wait_timeout - submit requests to the submission
7 queue and wait for the completion with timeout
8
10 #include <liburing.h>
11
12 int io_uring_submit_and_wait_timeout(struct io_uring *ring,
13 struct io_uring_cqe **cqe_ptr,
14 unsigned wait_nr,
15 struct __kernel_timespec *ts,
16 sigset_t *sigmask);
17
19 The io_uring_submit_and_wait_timeout(3) function submits the next re‐
20 quests from the submission queue belonging to the ring and waits for
21 wait_nr completion events, or until the timeout ts expires. The comple‐
22 tion events are stored in the cqe_ptr array. The sigmask specifies the
23 set of signals to block. The prevailing signal mask is restored before
24 returning.
25
26 After the caller retrieves a submission queue entry (SQE) with io_ur‐
27 ing_get_sqe(3) and prepares the SQE, it can be submitted with io_ur‐
28 ing_submit_and_wait_timeout(3).
29
30
32 On success io_uring_submit_and_wait_timeout(3) returns the number of
33 submitted submission queue entries. On failure it returns -errno. Note
34 that in earlier versions of the liburing library, the return value was
35 0 on success. The most common failure case is not receiving a comple‐
36 tion within the specified timeout, -ETIME is returned in this case.
37
39 io_uring_get_sqe(3), io_uring_submit(3), io_uring_submit_and_wait(3),
40 io_uring_wait_cqe(3)
41
42
43
44liburing-2.1 November 15,i2o0_2u1ring_submit_and_wait_timeout(3)