Eric Paris | ff0b16a | 2009-12-17 21:24:25 -0500 | [diff] [blame] | 1 | #ifndef _LINUX_FANOTIFY_H |
| 2 | #define _LINUX_FANOTIFY_H |
| 3 | |
| 4 | #include <linux/types.h> |
| 5 | |
| 6 | /* the following events that user-space can register for */ |
| 7 | #define FAN_ACCESS 0x00000001 /* File was accessed */ |
| 8 | #define FAN_MODIFY 0x00000002 /* File was modified */ |
| 9 | #define FAN_CLOSE_WRITE 0x00000008 /* Unwrittable file closed */ |
| 10 | #define FAN_CLOSE_NOWRITE 0x00000010 /* Writtable file closed */ |
| 11 | #define FAN_OPEN 0x00000020 /* File was opened */ |
| 12 | |
| 13 | #define FAN_EVENT_ON_CHILD 0x08000000 /* interested in child events */ |
| 14 | |
| 15 | /* FIXME currently Q's have no limit.... */ |
| 16 | #define FAN_Q_OVERFLOW 0x00004000 /* Event queued overflowed */ |
| 17 | |
Eric Paris | 9e66e42 | 2009-12-17 21:24:34 -0500 | [diff] [blame] | 18 | #define FAN_OPEN_PERM 0x00010000 /* File open in perm check */ |
| 19 | #define FAN_ACCESS_PERM 0x00020000 /* File accessed in perm check */ |
| 20 | |
Eric Paris | ff0b16a | 2009-12-17 21:24:25 -0500 | [diff] [blame] | 21 | /* helper events */ |
| 22 | #define FAN_CLOSE (FAN_CLOSE_WRITE | FAN_CLOSE_NOWRITE) /* close */ |
| 23 | |
Eric Paris | 2a3edf8 | 2009-12-17 21:24:26 -0500 | [diff] [blame] | 24 | /* flags used for fanotify_init() */ |
Eric Paris | 52c923d | 2009-12-17 21:24:26 -0500 | [diff] [blame] | 25 | #define FAN_CLOEXEC 0x00000001 |
| 26 | #define FAN_NONBLOCK 0x00000002 |
| 27 | |
Eric Paris | 4231a23 | 2010-10-28 17:21:56 -0400 | [diff] [blame] | 28 | /* These are NOT bitwise flags. Both bits are used togther. */ |
| 29 | #define FAN_CLASS_NOTIF 0x00000000 |
| 30 | #define FAN_CLASS_CONTENT 0x00000004 |
| 31 | #define FAN_CLASS_PRE_CONTENT 0x00000008 |
| 32 | |
| 33 | #define FAN_ALL_CLASS_BITS (FAN_CLASS_NOTIF | FAN_CLASS_CONTENT | \ |
| 34 | FAN_CLASS_PRE_CONTENT) |
| 35 | |
| 36 | #define FAN_ALL_INIT_FLAGS (FAN_CLOEXEC | FAN_NONBLOCK | \ |
| 37 | FAN_ALL_CLASS_BITS) |
Eric Paris | 2a3edf8 | 2009-12-17 21:24:26 -0500 | [diff] [blame] | 38 | |
| 39 | /* flags used for fanotify_modify_mark() */ |
| 40 | #define FAN_MARK_ADD 0x00000001 |
| 41 | #define FAN_MARK_REMOVE 0x00000002 |
| 42 | #define FAN_MARK_DONT_FOLLOW 0x00000004 |
| 43 | #define FAN_MARK_ONLYDIR 0x00000008 |
Andreas Gruenbacher | eac8e9e | 2009-12-17 21:24:29 -0500 | [diff] [blame] | 44 | #define FAN_MARK_MOUNT 0x00000010 |
Eric Paris | b9e4e3b | 2009-12-17 21:24:33 -0500 | [diff] [blame] | 45 | #define FAN_MARK_IGNORED_MASK 0x00000020 |
Eric Paris | c9778a9 | 2009-12-17 21:24:33 -0500 | [diff] [blame] | 46 | #define FAN_MARK_IGNORED_SURV_MODIFY 0x00000040 |
Eric Paris | 4d92604 | 2009-12-17 21:24:34 -0500 | [diff] [blame] | 47 | #define FAN_MARK_FLUSH 0x00000080 |
Eric Paris | 2a3edf8 | 2009-12-17 21:24:26 -0500 | [diff] [blame] | 48 | |
| 49 | #define FAN_ALL_MARK_FLAGS (FAN_MARK_ADD |\ |
| 50 | FAN_MARK_REMOVE |\ |
| 51 | FAN_MARK_DONT_FOLLOW |\ |
Eric Paris | 0ff21db | 2009-12-17 21:24:29 -0500 | [diff] [blame] | 52 | FAN_MARK_ONLYDIR |\ |
Eric Paris | b9e4e3b | 2009-12-17 21:24:33 -0500 | [diff] [blame] | 53 | FAN_MARK_MOUNT |\ |
Eric Paris | c9778a9 | 2009-12-17 21:24:33 -0500 | [diff] [blame] | 54 | FAN_MARK_IGNORED_MASK |\ |
| 55 | FAN_MARK_IGNORED_SURV_MODIFY) |
Eric Paris | 2a3edf8 | 2009-12-17 21:24:26 -0500 | [diff] [blame] | 56 | |
Eric Paris | ff0b16a | 2009-12-17 21:24:25 -0500 | [diff] [blame] | 57 | /* |
| 58 | * All of the events - we build the list by hand so that we can add flags in |
| 59 | * the future and not break backward compatibility. Apps will get only the |
| 60 | * events that they originally wanted. Be sure to add new events here! |
| 61 | */ |
| 62 | #define FAN_ALL_EVENTS (FAN_ACCESS |\ |
| 63 | FAN_MODIFY |\ |
| 64 | FAN_CLOSE |\ |
| 65 | FAN_OPEN) |
| 66 | |
Eric Paris | 9e66e42 | 2009-12-17 21:24:34 -0500 | [diff] [blame] | 67 | /* |
| 68 | * All events which require a permission response from userspace |
| 69 | */ |
| 70 | #define FAN_ALL_PERM_EVENTS (FAN_OPEN_PERM |\ |
| 71 | FAN_ACCESS_PERM) |
| 72 | |
Eric Paris | a1014f1 | 2009-12-17 21:24:26 -0500 | [diff] [blame] | 73 | #define FAN_ALL_OUTGOING_EVENTS (FAN_ALL_EVENTS |\ |
Eric Paris | 9e66e42 | 2009-12-17 21:24:34 -0500 | [diff] [blame] | 74 | FAN_ALL_PERM_EVENTS |\ |
Eric Paris | a1014f1 | 2009-12-17 21:24:26 -0500 | [diff] [blame] | 75 | FAN_Q_OVERFLOW) |
| 76 | |
Tvrtko Ursulin | 0fb8562 | 2010-08-20 10:02:15 +0100 | [diff] [blame] | 77 | #define FANOTIFY_METADATA_VERSION 2 |
Eric Paris | a1014f1 | 2009-12-17 21:24:26 -0500 | [diff] [blame] | 78 | |
| 79 | struct fanotify_event_metadata { |
| 80 | __u32 event_len; |
| 81 | __u32 vers; |
Eric Paris | 2868201 | 2010-10-28 17:21:56 -0400 | [diff] [blame^] | 82 | __aligned_u64 mask; |
Tvrtko Ursulin | 0fb8562 | 2010-08-20 10:02:15 +0100 | [diff] [blame] | 83 | __s32 fd; |
| 84 | __s32 pid; |
Eric Paris | 2868201 | 2010-10-28 17:21:56 -0400 | [diff] [blame^] | 85 | }; |
Eric Paris | a1014f1 | 2009-12-17 21:24:26 -0500 | [diff] [blame] | 86 | |
Eric Paris | b2d8790 | 2009-12-17 21:24:34 -0500 | [diff] [blame] | 87 | struct fanotify_response { |
| 88 | __s32 fd; |
| 89 | __u32 response; |
| 90 | } __attribute__ ((packed)); |
| 91 | |
Eric Paris | 9e66e42 | 2009-12-17 21:24:34 -0500 | [diff] [blame] | 92 | /* Legit userspace responses to a _PERM event */ |
| 93 | #define FAN_ALLOW 0x01 |
| 94 | #define FAN_DENY 0x02 |
| 95 | |
Eric Paris | a1014f1 | 2009-12-17 21:24:26 -0500 | [diff] [blame] | 96 | /* Helper functions to deal with fanotify_event_metadata buffers */ |
| 97 | #define FAN_EVENT_METADATA_LEN (sizeof(struct fanotify_event_metadata)) |
| 98 | |
| 99 | #define FAN_EVENT_NEXT(meta, len) ((len) -= (meta)->event_len, \ |
| 100 | (struct fanotify_event_metadata*)(((char *)(meta)) + \ |
| 101 | (meta)->event_len)) |
| 102 | |
| 103 | #define FAN_EVENT_OK(meta, len) ((long)(len) >= (long)FAN_EVENT_METADATA_LEN && \ |
| 104 | (long)(meta)->event_len >= (long)FAN_EVENT_METADATA_LEN && \ |
| 105 | (long)(meta)->event_len <= (long)(len)) |
| 106 | |
Eric Paris | ff0b16a | 2009-12-17 21:24:25 -0500 | [diff] [blame] | 107 | #endif /* _LINUX_FANOTIFY_H */ |