GNU Linux-libre 6.9.2-gnu
[releases.git] / include / uapi / linux / openat2.h
1 /* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */
2 #ifndef _UAPI_LINUX_OPENAT2_H
3 #define _UAPI_LINUX_OPENAT2_H
4
5 #include <linux/types.h>
6
7 /*
8  * Arguments for how openat2(2) should open the target path. If only @flags and
9  * @mode are non-zero, then openat2(2) operates very similarly to openat(2).
10  *
11  * However, unlike openat(2), unknown or invalid bits in @flags result in
12  * -EINVAL rather than being silently ignored. @mode must be zero unless one of
13  * {O_CREAT, O_TMPFILE} are set.
14  *
15  * @flags: O_* flags.
16  * @mode: O_CREAT/O_TMPFILE file mode.
17  * @resolve: RESOLVE_* flags.
18  */
19 struct open_how {
20         __u64 flags;
21         __u64 mode;
22         __u64 resolve;
23 };
24
25 /* how->resolve flags for openat2(2). */
26 #define RESOLVE_NO_XDEV         0x01 /* Block mount-point crossings
27                                         (includes bind-mounts). */
28 #define RESOLVE_NO_MAGICLINKS   0x02 /* Block traversal through procfs-style
29                                         "magic-links". */
30 #define RESOLVE_NO_SYMLINKS     0x04 /* Block traversal through all symlinks
31                                         (implies OEXT_NO_MAGICLINKS) */
32 #define RESOLVE_BENEATH         0x08 /* Block "lexical" trickery like
33                                         "..", symlinks, and absolute
34                                         paths which escape the dirfd. */
35 #define RESOLVE_IN_ROOT         0x10 /* Make all jumps to "/" and ".."
36                                         be scoped inside the dirfd
37                                         (similar to chroot(2)). */
38 #define RESOLVE_CACHED          0x20 /* Only complete if resolution can be
39                                         completed through cached lookup. May
40                                         return -EAGAIN if that's not
41                                         possible. */
42
43 #endif /* _UAPI_LINUX_OPENAT2_H */