summaryrefslogtreecommitdiff
path: root/include/arch/x86_64/linux/openat2.h
blob: 5041a70e5000bf916c38e240490dc5d522c17d34 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
/* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */
#ifndef _LINUX_OPENAT2_H
#define _LINUX_OPENAT2_H

#include <linux/types.h>

/*
 * Arguments for how openat2(2) should open the target path. If only @flags and
 * @mode are non-zero, then openat2(2) operates very similarly to openat(2).
 *
 * However, unlike openat(2), unknown or invalid bits in @flags result in
 * -EINVAL rather than being silently ignored. @mode must be zero unless one of
 * {O_CREAT, O_TMPFILE} are set.
 *
 * @flags: O_* flags.
 * @mode: O_CREAT/O_TMPFILE file mode.
 * @resolve: RESOLVE_* flags.
 */
struct open_how {
	__u64 flags;
	__u64 mode;
	__u64 resolve;
};

/* how->resolve flags for openat2(2). */
#define RESOLVE_NO_XDEV                     \
	0x01 /* Block mount-point crossings \
		(includes bind-mounts). */
#define RESOLVE_NO_MAGICLINKS                        \
	0x02 /* Block traversal through procfs-style \
		"magic-links". */
#define RESOLVE_NO_SYMLINKS                          \
	0x04 /* Block traversal through all symlinks \
		(implies OEXT_NO_MAGICLINKS) */
#define RESOLVE_BENEATH                       \
	0x08 /* Block "lexical" trickery like \
		"..", symlinks, and absolute  \
		paths which escape the dirfd. */
#define RESOLVE_IN_ROOT                        \
	0x10 /* Make all jumps to "/" and ".." \
		be scoped inside the dirfd     \
		(similar to chroot(2)). */
#define RESOLVE_CACHED                               \
	0x20 /* Only complete if resolution can be   \
		completed through cached lookup. May \
		return -EAGAIN if that's not         \
		possible. */

#endif /* _LINUX_OPENAT2_H */