1io_uring_prep_statx(3)          liburing Manual         io_uring_prep_statx(3)
2
3
4

NAME

6       io_uring_prep_statx - prepare a statx request
7

SYNOPSIS

9       #include <sys/types.h>
10       #include <sys/stat.h>
11       #include <unistd.h>
12       #include <fcntl.h>
13       #include <liburing.h>
14
15       void io_uring_prep_statx(struct io_uring_sqe *sqe,
16                                int dirfd,
17                                const char *path,
18                                int flags,
19                                unsigned mask,
20                                struct statx *statxbuf);
21

DESCRIPTION

23       The  io_uring_prep_statx(3) function prepares a statx request. The sub‐
24       mission queue entry sqe is setup to use the directory  file  descriptor
25       pointed  to  by dirfd to start a statx operation on the path identified
26       by path and using the flags given in flags for the fields specified  by
27       mask and into the buffer located at statxbuf.
28
29       This function prepares an async statx(2) request. See that man page for
30       details.
31
32

RETURN VALUE

34       None
35

ERRORS

37       The CQE res field will contain the result of the operation. See the re‐
38       lated man page for details on possible values. Note that where synchro‐
39       nous system calls will return -1 on failure and set errno to the actual
40       error value, io_uring never uses errno.  Instead it returns the negated
41       errno directly in the CQE res field.
42

NOTES

44       As with any request that passes in data in a struct, that data must re‐
45       main  valid  until the request has been successfully submitted. It need
46       not remain valid until completion. Once a request has  been  submitted,
47       the in-kernel state is stable. Very early kernels (5.4 and earlier) re‐
48       quired state to be stable until the completion  occurred.  Applications
49       can  test for this behavior by inspecting the IORING_FEAT_SUBMIT_STABLE
50       flag passed back from io_uring_queue_init_params(3).
51

SEE ALSO

53       io_uring_get_sqe(3), io_uring_submit(3), statx(2)
54
55
56
57liburing-2.2                    March 13, 2022          io_uring_prep_statx(3)
Impressum