1io_uring_register_sync_cancel(3)liburing Manualio_uring_register_sync_cancel(3)
2
3
4
6 io_uring_register_sync_cancel - issue a synchronous cancelation request
7
9 #include <liburing.h>
10
11 int io_uring_register_sync_cancel(struct io_uring *ring,
12 struct io_uring_sync_cancel_reg *reg);
13
15 The io_uring_register_sync_cancel(3) function performs a synchronous
16 cancelation request based on the parameters specified in reg .
17
18 The reg argument must be filled in with the appropriate information for
19 the cancelation request. It looks as follows:
20
21 struct io_uring_sync_cancel_reg {
22 __u64 addr;
23 __s32 fd;
24 __u32 flags;
25 struct __kernel_timespec timeout;
26 __u64 pad[4];
27 };
28
29 The arguments largely mirror what the async prep functions support, see
30 io_uring_prep_cancel(3) for details. Similarly, the return value is the
31 same. The exception is the timeout argument, which can be used to limit
32 the time that the kernel will wait for cancelations to be successful.
33 If the tv_sec and tv_nsec values are set to anything but -1UL , then
34 they indicate a relative timeout upon which cancelations should be com‐
35 pleted by.
36
37 The pad values must be zero filled.
38
39
41 See io_uring_prep_cancel(3) for details on the return value. If timeout
42 is set to indicate a timeout, then -ETIME will be returned if exceeded.
43 If an unknown value is set in the request, or if the pad values are not
44 cleared to zero, then -EINVAL is returned.
45
47 io_uring_prep_cancel(3)
48
49
50
51liburing-2.3 September 21, 202i2o_uring_register_sync_cancel(3)