We do not want to add new bits to the FAN_ALL_* uapi constants because they have been exposed to userspace. If there are programs out there using these constants, those programs could break if re-compiled with modified FAN_ALL_* constants and run on an old kernel. We deprecate the uapi constants FAN_ALL_* and define new FANOTIFY_* constants for internal use to replace them. New feature bits will be added only to the new constants.
Showing the changes to include/uapi/linux (1 of 5 files). Show all
Unified · Split
| @@ -31,6 +31,8 @@ · 30 unmodified lines | ||
| 31 | 31 | #define FAN_CLASS_NOTIF 0x00000000 |
| 32 | 32 | #define FAN_CLASS_CONTENT 0x00000004 |
| 33 | 33 | #define FAN_CLASS_PRE_CONTENT 0x00000008 |
| 34 | + | |
| 35 | +/* Deprecated - do not use this in programs and do not add new flags here! */ | |
| 34 | 36 | #define FAN_ALL_CLASS_BITS (FAN_CLASS_NOTIF | FAN_CLASS_CONTENT | \ |
| 35 | 37 | FAN_CLASS_PRE_CONTENT) |
| 36 | 38 | |
| @@ -38,6 +40,7 @@ · 1 unmodified line | ||
| 38 | 40 | #define FAN_UNLIMITED_MARKS 0x00000020 |
| 39 | 41 | #define FAN_ENABLE_AUDIT 0x00000040 |
| 40 | 42 | |
| 43 | +/* Deprecated - do not use this in programs and do not add new flags here! */ | |
| 41 | 44 | #define FAN_ALL_INIT_FLAGS (FAN_CLOEXEC | FAN_NONBLOCK | \ |
| 42 | 45 | FAN_ALL_CLASS_BITS | FAN_UNLIMITED_QUEUE |\ |
| 43 | 46 | FAN_UNLIMITED_MARKS) |
| @@ -57,23 +60,18 @@ · 13 unmodified lines | ||
| 57 | 60 | #define FAN_MARK_INODE 0x00000000 |
| 58 | 61 | #define FAN_MARK_MOUNT 0x00000010 |
| 59 | 62 | #define FAN_MARK_FILESYSTEM 0x00000100 |
| 60 | −#define FAN_MARK_TYPE_MASK (FAN_MARK_INODE | FAN_MARK_MOUNT | \ | |
| 61 | − FAN_MARK_FILESYSTEM) | |
| 62 | 63 | |
| 64 | +/* Deprecated - do not use this in programs and do not add new flags here! */ | |
| 63 | 65 | #define FAN_ALL_MARK_FLAGS (FAN_MARK_ADD |\ |
| 64 | 66 | FAN_MARK_REMOVE |\ |
| 65 | 67 | FAN_MARK_DONT_FOLLOW |\ |
| 66 | 68 | FAN_MARK_ONLYDIR |\ |
| 69 | + FAN_MARK_MOUNT |\ | |
| 67 | 70 | FAN_MARK_IGNORED_MASK |\ |
| 68 | 71 | FAN_MARK_IGNORED_SURV_MODIFY |\ |
| 69 | − FAN_MARK_FLUSH|\ | |
| 70 | − FAN_MARK_TYPE_MASK) | |
| 72 | + FAN_MARK_FLUSH) | |
| 71 | 73 | |
| 72 | −/* | |
| 73 | − * All of the events - we build the list by hand so that we can add flags in | |
| 74 | − * the future and not break backward compatibility. Apps will get only the | |
| 75 | − * events that they originally wanted. Be sure to add new events here! | |
| 76 | − */ | |
| 74 | +/* Deprecated - do not use this in programs and do not add new flags here! */ | |
| 77 | 75 | #define FAN_ALL_EVENTS (FAN_ACCESS |\ |
| 78 | 76 | FAN_MODIFY |\ |
| 79 | 77 | FAN_CLOSE |\ |
| @@ -82,9 +80,11 @@ · 2 unmodified lines | ||
| 82 | 80 | /* |
| 83 | 81 | * All events which require a permission response from userspace |
| 84 | 82 | */ |
| 83 | +/* Deprecated - do not use this in programs and do not add new flags here! */ | |
| 85 | 84 | #define FAN_ALL_PERM_EVENTS (FAN_OPEN_PERM |\ |
| 86 | 85 | FAN_ACCESS_PERM) |
| 87 | 86 | |
| 87 | +/* Deprecated - do not use this in programs and do not add new flags here! */ | |
| 88 | 88 | #define FAN_ALL_OUTGOING_EVENTS (FAN_ALL_EVENTS |\ |
| 89 | 89 | FAN_ALL_PERM_EVENTS |\ |
| 90 | 90 | FAN_Q_OVERFLOW) |