|
1 #ifndef _LINUX_FANOTIFY_H |
|
2 #define _LINUX_FANOTIFY_H |
|
3 |
|
4 /* This is a Linux header generated by "make headers_install" */ |
|
5 |
|
6 #include <linux/types.h> |
|
7 |
|
8 /* the following events that user-space can register for */ |
|
9 #define FAN_ACCESS 0x00000001 /* File was accessed */ |
|
10 #define FAN_MODIFY 0x00000002 /* File was modified */ |
|
11 #define FAN_CLOSE_WRITE 0x00000008 /* Writtable file closed */ |
|
12 #define FAN_CLOSE_NOWRITE 0x00000010 /* Unwrittable file closed */ |
|
13 #define FAN_OPEN 0x00000020 /* File was opened */ |
|
14 |
|
15 #define FAN_Q_OVERFLOW 0x00004000 /* Event queued overflowed */ |
|
16 |
|
17 #define FAN_OPEN_PERM 0x00010000 /* File open in perm check */ |
|
18 #define FAN_ACCESS_PERM 0x00020000 /* File accessed in perm check */ |
|
19 |
|
20 #define FAN_ONDIR 0x40000000 /* event occurred against dir */ |
|
21 |
|
22 #define FAN_EVENT_ON_CHILD 0x08000000 /* interested in child events */ |
|
23 |
|
24 /* helper events */ |
|
25 #define FAN_CLOSE (FAN_CLOSE_WRITE | FAN_CLOSE_NOWRITE) /* close */ |
|
26 |
|
27 /* flags used for fanotify_init() */ |
|
28 #define FAN_CLOEXEC 0x00000001 |
|
29 #define FAN_NONBLOCK 0x00000002 |
|
30 |
|
31 /* These are NOT bitwise flags. Both bits are used togther. */ |
|
32 #define FAN_CLASS_NOTIF 0x00000000 |
|
33 #define FAN_CLASS_CONTENT 0x00000004 |
|
34 #define FAN_CLASS_PRE_CONTENT 0x00000008 |
|
35 #define FAN_ALL_CLASS_BITS (FAN_CLASS_NOTIF | FAN_CLASS_CONTENT | \ |
|
36 FAN_CLASS_PRE_CONTENT) |
|
37 |
|
38 #define FAN_UNLIMITED_QUEUE 0x00000010 |
|
39 #define FAN_UNLIMITED_MARKS 0x00000020 |
|
40 |
|
41 #define FAN_ALL_INIT_FLAGS (FAN_CLOEXEC | FAN_NONBLOCK | \ |
|
42 FAN_ALL_CLASS_BITS | FAN_UNLIMITED_QUEUE |\ |
|
43 FAN_UNLIMITED_MARKS) |
|
44 |
|
45 /* flags used for fanotify_modify_mark() */ |
|
46 #define FAN_MARK_ADD 0x00000001 |
|
47 #define FAN_MARK_REMOVE 0x00000002 |
|
48 #define FAN_MARK_DONT_FOLLOW 0x00000004 |
|
49 #define FAN_MARK_ONLYDIR 0x00000008 |
|
50 #define FAN_MARK_MOUNT 0x00000010 |
|
51 #define FAN_MARK_IGNORED_MASK 0x00000020 |
|
52 #define FAN_MARK_IGNORED_SURV_MODIFY 0x00000040 |
|
53 #define FAN_MARK_FLUSH 0x00000080 |
|
54 |
|
55 #define FAN_ALL_MARK_FLAGS (FAN_MARK_ADD |\ |
|
56 FAN_MARK_REMOVE |\ |
|
57 FAN_MARK_DONT_FOLLOW |\ |
|
58 FAN_MARK_ONLYDIR |\ |
|
59 FAN_MARK_MOUNT |\ |
|
60 FAN_MARK_IGNORED_MASK |\ |
|
61 FAN_MARK_IGNORED_SURV_MODIFY |\ |
|
62 FAN_MARK_FLUSH) |
|
63 |
|
64 /* |
|
65 * All of the events - we build the list by hand so that we can add flags in |
|
66 * the future and not break backward compatibility. Apps will get only the |
|
67 * events that they originally wanted. Be sure to add new events here! |
|
68 */ |
|
69 #define FAN_ALL_EVENTS (FAN_ACCESS |\ |
|
70 FAN_MODIFY |\ |
|
71 FAN_CLOSE |\ |
|
72 FAN_OPEN) |
|
73 |
|
74 /* |
|
75 * All events which require a permission response from userspace |
|
76 */ |
|
77 #define FAN_ALL_PERM_EVENTS (FAN_OPEN_PERM |\ |
|
78 FAN_ACCESS_PERM) |
|
79 |
|
80 #define FAN_ALL_OUTGOING_EVENTS (FAN_ALL_EVENTS |\ |
|
81 FAN_ALL_PERM_EVENTS |\ |
|
82 FAN_Q_OVERFLOW) |
|
83 |
|
84 #define FANOTIFY_METADATA_VERSION 3 |
|
85 |
|
86 struct fanotify_event_metadata { |
|
87 __u32 event_len; |
|
88 __u8 vers; |
|
89 __u8 reserved; |
|
90 __u16 metadata_len; |
|
91 __u64 mask; |
|
92 __s32 fd; |
|
93 __s32 pid; |
|
94 }; |
|
95 |
|
96 struct fanotify_response { |
|
97 __s32 fd; |
|
98 __u32 response; |
|
99 }; |
|
100 |
|
101 /* Legit userspace responses to a _PERM event */ |
|
102 #define FAN_ALLOW 0x01 |
|
103 #define FAN_DENY 0x02 |
|
104 /* No fd set in event */ |
|
105 #define FAN_NOFD -1 |
|
106 |
|
107 /* Helper functions to deal with fanotify_event_metadata buffers */ |
|
108 #define FAN_EVENT_METADATA_LEN (sizeof(struct fanotify_event_metadata)) |
|
109 |
|
110 #define FAN_EVENT_NEXT(meta, len) ((len) -= (meta)->event_len, \ |
|
111 (struct fanotify_event_metadata*)(((char *)(meta)) + \ |
|
112 (meta)->event_len)) |
|
113 |
|
114 #define FAN_EVENT_OK(meta, len) ((long)(len) >= (long)FAN_EVENT_METADATA_LEN && \ |
|
115 (long)(meta)->event_len >= (long)FAN_EVENT_METADATA_LEN && \ |
|
116 (long)(meta)->event_len <= (long)(len)) |
|
117 |
|
118 #endif /* _LINUX_FANOTIFY_H */ |