security/selinux/include/avc.h

   1 /*
   2  * Access vector cache interface for object managers.
   3  *
   4  * Author : Stephen Smalley, <sds@epoch.ncsc.mil>
   5  */
   6 #ifndef _SELINUX_AVC_H_
   7 #define _SELINUX_AVC_H_
   8
   9 #include <linux/stddef.h>
  10 #include <linux/errno.h>
  11 #include <linux/kernel.h>
  12 #include <linux/kdev_t.h>
  13 #include <linux/spinlock.h>
  14 #include <linux/init.h>
  15 #include <linux/audit.h>
  16 #include <linux/lsm_audit.h>
  17 #include <linux/in6.h>
  18 #include "flask.h"
  19 #include "av_permissions.h"
  20 #include "security.h"
  21
  22 #ifdef CONFIG_SECURITY_SELINUX_DEVELOP
  23 extern int selinux_enforcing;
  24 #else
  25 #define selinux_enforcing 1
  26 #endif
  27
  28 /*
  29  * An entry in the AVC.
  30  */
  31 struct avc_entry;
  32
  33 struct task_struct;
  34 struct inode;
  35 struct sock;
  36 struct sk_buff;
  37
  38 /*
  39  * AVC statistics
  40  */
  41 struct avc_cache_stats {
  42         unsigned int lookups;
  43         unsigned int misses;
  44         unsigned int allocations;
  45         unsigned int reclaims;
  46         unsigned int frees;
  47 };
  48
  49 /*
  50  * We only need this data after we have decided to send an audit message.
  51  */
  52 struct selinux_late_audit_data {
  53         u32 ssid;
  54         u32 tsid;
  55         u16 tclass;
  56         u32 requested;
  57         u32 audited;
  58         u32 denied;
  59         int result;
  60 };
  61
  62 /*
  63  * We collect this at the beginning or during an selinux security operation
  64  */
  65 struct selinux_audit_data {
  66         struct selinux_late_audit_data *slad;
  67 };
  68
  69 /*
  70  * AVC operations
  71  */
  72
  73 void __init avc_init(void);
  74
  75 static inline u32 avc_audit_required(u32 requested,
  76                               struct av_decision *avd,
  77                               int result,
  78                               u32 auditdeny,
  79                               u32 *deniedp)
  80 {
  81         u32 denied, audited;
  82         denied = requested & ~avd->allowed;
  83         if (unlikely(denied)) {
  84                 audited = denied & avd->auditdeny;
  85                 /*
  86                  * auditdeny is TRICKY!  Setting a bit in
  87                  * this field means that ANY denials should NOT be audited if
  88                  * the policy contains an explicit dontaudit rule for that
  89                  * permission.  Take notice that this is unrelated to the
  90                  * actual permissions that were denied.  As an example lets
  91                  * assume:
  92                  *
  93                  * denied == READ
  94                  * avd.auditdeny & ACCESS == 0 (not set means explicit rule)
  95                  * auditdeny & ACCESS == 1
  96                  *
  97                  * We will NOT audit the denial even though the denied
  98                  * permission was READ and the auditdeny checks were for
  99                  * ACCESS
 100                  */
 101                 if (auditdeny && !(auditdeny & avd->auditdeny))
 102                         audited = 0;
 103         } else if (result)
 104                 audited = denied = requested;
 105         else
 106                 audited = requested & avd->auditallow;
 107         *deniedp = denied;
 108         return audited;
 109 }
 110
 111 int slow_avc_audit(u32 ssid, u32 tsid, u16 tclass,
 112                    u32 requested, u32 audited, u32 denied,
 113                    struct common_audit_data *a,
 114                    unsigned flags);
 115
 116 /**
 117  * avc_audit - Audit the granting or denial of permissions.
 118  * @ssid: source security identifier
 119  * @tsid: target security identifier
 120  * @tclass: target security class
 121  * @requested: requested permissions
 122  * @avd: access vector decisions
 123  * @result: result from avc_has_perm_noaudit
 124  * @a:  auxiliary audit data
 125  * @flags: VFS walk flags
 126  *
 127  * Audit the granting or denial of permissions in accordance
 128  * with the policy.  This function is typically called by
 129  * avc_has_perm() after a permission check, but can also be
 130  * called directly by callers who use avc_has_perm_noaudit()
 131  * in order to separate the permission check from the auditing.
 132  * For example, this separation is useful when the permission check must
 133  * be performed under a lock, to allow the lock to be released
 134  * before calling the auditing code.
 135  */
 136 static inline int avc_audit(u32 ssid, u32 tsid,
 137                             u16 tclass, u32 requested,
 138                             struct av_decision *avd,
 139                             int result,
 140                             struct common_audit_data *a, unsigned flags)
 141 {
 142         u32 audited, denied;
 143         audited = avc_audit_required(requested, avd, result, 0, &denied);
 144         if (likely(!audited))
 145                 return 0;
 146         return slow_avc_audit(ssid, tsid, tclass,
 147                               requested, audited, denied,
 148                               a, flags);
 149 }
 150
 151 #define AVC_STRICT 1 /* Ignore permissive mode. */
 152 int avc_has_perm_noaudit(u32 ssid, u32 tsid,
 153                          u16 tclass, u32 requested,
 154                          unsigned flags,
 155                          struct av_decision *avd);
 156
 157 int avc_has_perm_flags(u32 ssid, u32 tsid,
 158                        u16 tclass, u32 requested,
 159                        struct common_audit_data *auditdata,
 160                        unsigned);
 161
 162 static inline int avc_has_perm(u32 ssid, u32 tsid,
 163                                u16 tclass, u32 requested,
 164                                struct common_audit_data *auditdata)
 165 {
 166         return avc_has_perm_flags(ssid, tsid, tclass, requested, auditdata, 0);
 167 }
 168
 169 u32 avc_policy_seqno(void);
 170
 171 #define AVC_CALLBACK_GRANT              1
 172 #define AVC_CALLBACK_TRY_REVOKE         2
 173 #define AVC_CALLBACK_REVOKE             4
 174 #define AVC_CALLBACK_RESET              8
 175 #define AVC_CALLBACK_AUDITALLOW_ENABLE  16
 176 #define AVC_CALLBACK_AUDITALLOW_DISABLE 32
 177 #define AVC_CALLBACK_AUDITDENY_ENABLE   64
 178 #define AVC_CALLBACK_AUDITDENY_DISABLE  128
 179
 180 int avc_add_callback(int (*callback)(u32 event, u32 ssid, u32 tsid,
 181                                      u16 tclass, u32 perms,
 182                                      u32 *out_retained),
 183                      u32 events, u32 ssid, u32 tsid,
 184                      u16 tclass, u32 perms);
 185
 186 /* Exported to selinuxfs */
 187 int avc_get_hash_stats(char *page);
 188 extern unsigned int avc_cache_threshold;
 189
 190 /* Attempt to free avc node cache */
 191 void avc_disable(void);
 192
 193 #ifdef CONFIG_SECURITY_SELINUX_AVC_STATS
 194 DECLARE_PER_CPU(struct avc_cache_stats, avc_cache_stats);
 195 #endif
 196
 197 #endif /* _SELINUX_AVC_H_ */
 198