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 */ 44