cachepc-linux

Fork of AMDESE/linux with modifications for CachePC side-channel attack
git clone https://git.sinitax.com/sinitax/cachepc-linux
Log | Files | Refs | README | LICENSE | sfeed.txt

fanotify.h (4347B)


      1/* SPDX-License-Identifier: GPL-2.0 */
      2#ifndef _LINUX_FANOTIFY_H
      3#define _LINUX_FANOTIFY_H
      4
      5#include <linux/sysctl.h>
      6#include <uapi/linux/fanotify.h>
      7
      8#define FAN_GROUP_FLAG(group, flag) \
      9	((group)->fanotify_data.flags & (flag))
     10
     11/*
     12 * Flags allowed to be passed from/to userspace.
     13 *
     14 * We intentionally do not add new bits to the old FAN_ALL_* constants, because
     15 * they are uapi exposed constants. If there are programs out there using
     16 * these constant, the programs may break if re-compiled with new uapi headers
     17 * and then run on an old kernel.
     18 */
     19
     20/* Group classes where permission events are allowed */
     21#define FANOTIFY_PERM_CLASSES	(FAN_CLASS_CONTENT | \
     22				 FAN_CLASS_PRE_CONTENT)
     23
     24#define FANOTIFY_CLASS_BITS	(FAN_CLASS_NOTIF | FANOTIFY_PERM_CLASSES)
     25
     26#define FANOTIFY_FID_BITS	(FAN_REPORT_DFID_NAME_TARGET)
     27
     28#define FANOTIFY_INFO_MODES	(FANOTIFY_FID_BITS | FAN_REPORT_PIDFD)
     29
     30/*
     31 * fanotify_init() flags that require CAP_SYS_ADMIN.
     32 * We do not allow unprivileged groups to request permission events.
     33 * We do not allow unprivileged groups to get other process pid in events.
     34 * We do not allow unprivileged groups to use unlimited resources.
     35 */
     36#define FANOTIFY_ADMIN_INIT_FLAGS	(FANOTIFY_PERM_CLASSES | \
     37					 FAN_REPORT_TID | \
     38					 FAN_REPORT_PIDFD | \
     39					 FAN_UNLIMITED_QUEUE | \
     40					 FAN_UNLIMITED_MARKS)
     41
     42/*
     43 * fanotify_init() flags that are allowed for user without CAP_SYS_ADMIN.
     44 * FAN_CLASS_NOTIF is the only class we allow for unprivileged group.
     45 * We do not allow unprivileged groups to get file descriptors in events,
     46 * so one of the flags for reporting file handles is required.
     47 */
     48#define FANOTIFY_USER_INIT_FLAGS	(FAN_CLASS_NOTIF | \
     49					 FANOTIFY_FID_BITS | \
     50					 FAN_CLOEXEC | FAN_NONBLOCK)
     51
     52#define FANOTIFY_INIT_FLAGS	(FANOTIFY_ADMIN_INIT_FLAGS | \
     53				 FANOTIFY_USER_INIT_FLAGS)
     54
     55/* Internal group flags */
     56#define FANOTIFY_UNPRIV		0x80000000
     57#define FANOTIFY_INTERNAL_GROUP_FLAGS	(FANOTIFY_UNPRIV)
     58
     59#define FANOTIFY_MARK_TYPE_BITS	(FAN_MARK_INODE | FAN_MARK_MOUNT | \
     60				 FAN_MARK_FILESYSTEM)
     61
     62#define FANOTIFY_MARK_FLAGS	(FANOTIFY_MARK_TYPE_BITS | \
     63				 FAN_MARK_ADD | \
     64				 FAN_MARK_REMOVE | \
     65				 FAN_MARK_DONT_FOLLOW | \
     66				 FAN_MARK_ONLYDIR | \
     67				 FAN_MARK_IGNORED_MASK | \
     68				 FAN_MARK_IGNORED_SURV_MODIFY | \
     69				 FAN_MARK_EVICTABLE | \
     70				 FAN_MARK_FLUSH)
     71
     72/*
     73 * Events that can be reported with data type FSNOTIFY_EVENT_PATH.
     74 * Note that FAN_MODIFY can also be reported with data type
     75 * FSNOTIFY_EVENT_INODE.
     76 */
     77#define FANOTIFY_PATH_EVENTS	(FAN_ACCESS | FAN_MODIFY | \
     78				 FAN_CLOSE | FAN_OPEN | FAN_OPEN_EXEC)
     79
     80/*
     81 * Directory entry modification events - reported only to directory
     82 * where entry is modified and not to a watching parent.
     83 */
     84#define FANOTIFY_DIRENT_EVENTS	(FAN_MOVE | FAN_CREATE | FAN_DELETE | \
     85				 FAN_RENAME)
     86
     87/* Events that can be reported with event->fd */
     88#define FANOTIFY_FD_EVENTS (FANOTIFY_PATH_EVENTS | FANOTIFY_PERM_EVENTS)
     89
     90/* Events that can only be reported with data type FSNOTIFY_EVENT_INODE */
     91#define FANOTIFY_INODE_EVENTS	(FANOTIFY_DIRENT_EVENTS | \
     92				 FAN_ATTRIB | FAN_MOVE_SELF | FAN_DELETE_SELF)
     93
     94/* Events that can only be reported with data type FSNOTIFY_EVENT_ERROR */
     95#define FANOTIFY_ERROR_EVENTS	(FAN_FS_ERROR)
     96
     97/* Events that user can request to be notified on */
     98#define FANOTIFY_EVENTS		(FANOTIFY_PATH_EVENTS | \
     99				 FANOTIFY_INODE_EVENTS | \
    100				 FANOTIFY_ERROR_EVENTS)
    101
    102/* Events that require a permission response from user */
    103#define FANOTIFY_PERM_EVENTS	(FAN_OPEN_PERM | FAN_ACCESS_PERM | \
    104				 FAN_OPEN_EXEC_PERM)
    105
    106/* Extra flags that may be reported with event or control handling of events */
    107#define FANOTIFY_EVENT_FLAGS	(FAN_EVENT_ON_CHILD | FAN_ONDIR)
    108
    109/* Events that may be reported to user */
    110#define FANOTIFY_OUTGOING_EVENTS	(FANOTIFY_EVENTS | \
    111					 FANOTIFY_PERM_EVENTS | \
    112					 FAN_Q_OVERFLOW | FAN_ONDIR)
    113
    114/* Events and flags relevant only for directories */
    115#define FANOTIFY_DIRONLY_EVENT_BITS	(FANOTIFY_DIRENT_EVENTS | \
    116					 FAN_EVENT_ON_CHILD | FAN_ONDIR)
    117
    118#define ALL_FANOTIFY_EVENT_BITS		(FANOTIFY_OUTGOING_EVENTS | \
    119					 FANOTIFY_EVENT_FLAGS)
    120
    121/* Do not use these old uapi constants internally */
    122#undef FAN_ALL_CLASS_BITS
    123#undef FAN_ALL_INIT_FLAGS
    124#undef FAN_ALL_MARK_FLAGS
    125#undef FAN_ALL_EVENTS
    126#undef FAN_ALL_PERM_EVENTS
    127#undef FAN_ALL_OUTGOING_EVENTS
    128
    129#endif /* _LINUX_FANOTIFY_H */