Linux 4.19.133
[linux/fpc-iii.git] / security / selinux / avc.c
blobd52be7b9f08c86c9b3040e920add68194a327acb
1 /*
2 * Implementation of the kernel access vector cache (AVC).
4 * Authors: Stephen Smalley, <sds@tycho.nsa.gov>
5 * James Morris <jmorris@redhat.com>
7 * Update: KaiGai, Kohei <kaigai@ak.jp.nec.com>
8 * Replaced the avc_lock spinlock by RCU.
10 * Copyright (C) 2003 Red Hat, Inc., James Morris <jmorris@redhat.com>
12 * This program is free software; you can redistribute it and/or modify
13 * it under the terms of the GNU General Public License version 2,
14 * as published by the Free Software Foundation.
16 #include <linux/types.h>
17 #include <linux/stddef.h>
18 #include <linux/kernel.h>
19 #include <linux/slab.h>
20 #include <linux/fs.h>
21 #include <linux/dcache.h>
22 #include <linux/init.h>
23 #include <linux/skbuff.h>
24 #include <linux/percpu.h>
25 #include <linux/list.h>
26 #include <net/sock.h>
27 #include <linux/un.h>
28 #include <net/af_unix.h>
29 #include <linux/ip.h>
30 #include <linux/audit.h>
31 #include <linux/ipv6.h>
32 #include <net/ipv6.h>
33 #include "avc.h"
34 #include "avc_ss.h"
35 #include "classmap.h"
37 #define AVC_CACHE_SLOTS 512
38 #define AVC_DEF_CACHE_THRESHOLD 512
39 #define AVC_CACHE_RECLAIM 16
41 #ifdef CONFIG_SECURITY_SELINUX_AVC_STATS
42 #define avc_cache_stats_incr(field) this_cpu_inc(avc_cache_stats.field)
43 #else
44 #define avc_cache_stats_incr(field) do {} while (0)
45 #endif
47 struct avc_entry {
48 u32 ssid;
49 u32 tsid;
50 u16 tclass;
51 struct av_decision avd;
52 struct avc_xperms_node *xp_node;
55 struct avc_node {
56 struct avc_entry ae;
57 struct hlist_node list; /* anchored in avc_cache->slots[i] */
58 struct rcu_head rhead;
61 struct avc_xperms_decision_node {
62 struct extended_perms_decision xpd;
63 struct list_head xpd_list; /* list of extended_perms_decision */
66 struct avc_xperms_node {
67 struct extended_perms xp;
68 struct list_head xpd_head; /* list head of extended_perms_decision */
71 struct avc_cache {
72 struct hlist_head slots[AVC_CACHE_SLOTS]; /* head for avc_node->list */
73 spinlock_t slots_lock[AVC_CACHE_SLOTS]; /* lock for writes */
74 atomic_t lru_hint; /* LRU hint for reclaim scan */
75 atomic_t active_nodes;
76 u32 latest_notif; /* latest revocation notification */
79 struct avc_callback_node {
80 int (*callback) (u32 event);
81 u32 events;
82 struct avc_callback_node *next;
85 #ifdef CONFIG_SECURITY_SELINUX_AVC_STATS
86 DEFINE_PER_CPU(struct avc_cache_stats, avc_cache_stats) = { 0 };
87 #endif
89 struct selinux_avc {
90 unsigned int avc_cache_threshold;
91 struct avc_cache avc_cache;
94 static struct selinux_avc selinux_avc;
96 void selinux_avc_init(struct selinux_avc **avc)
98 int i;
100 selinux_avc.avc_cache_threshold = AVC_DEF_CACHE_THRESHOLD;
101 for (i = 0; i < AVC_CACHE_SLOTS; i++) {
102 INIT_HLIST_HEAD(&selinux_avc.avc_cache.slots[i]);
103 spin_lock_init(&selinux_avc.avc_cache.slots_lock[i]);
105 atomic_set(&selinux_avc.avc_cache.active_nodes, 0);
106 atomic_set(&selinux_avc.avc_cache.lru_hint, 0);
107 *avc = &selinux_avc;
110 unsigned int avc_get_cache_threshold(struct selinux_avc *avc)
112 return avc->avc_cache_threshold;
115 void avc_set_cache_threshold(struct selinux_avc *avc,
116 unsigned int cache_threshold)
118 avc->avc_cache_threshold = cache_threshold;
121 static struct avc_callback_node *avc_callbacks;
122 static struct kmem_cache *avc_node_cachep;
123 static struct kmem_cache *avc_xperms_data_cachep;
124 static struct kmem_cache *avc_xperms_decision_cachep;
125 static struct kmem_cache *avc_xperms_cachep;
127 static inline int avc_hash(u32 ssid, u32 tsid, u16 tclass)
129 return (ssid ^ (tsid<<2) ^ (tclass<<4)) & (AVC_CACHE_SLOTS - 1);
133 * avc_dump_av - Display an access vector in human-readable form.
134 * @tclass: target security class
135 * @av: access vector
137 static void avc_dump_av(struct audit_buffer *ab, u16 tclass, u32 av)
139 const char **perms;
140 int i, perm;
142 if (av == 0) {
143 audit_log_format(ab, " null");
144 return;
147 BUG_ON(!tclass || tclass >= ARRAY_SIZE(secclass_map));
148 perms = secclass_map[tclass-1].perms;
150 audit_log_format(ab, " {");
151 i = 0;
152 perm = 1;
153 while (i < (sizeof(av) * 8)) {
154 if ((perm & av) && perms[i]) {
155 audit_log_format(ab, " %s", perms[i]);
156 av &= ~perm;
158 i++;
159 perm <<= 1;
162 if (av)
163 audit_log_format(ab, " 0x%x", av);
165 audit_log_format(ab, " }");
169 * avc_dump_query - Display a SID pair and a class in human-readable form.
170 * @ssid: source security identifier
171 * @tsid: target security identifier
172 * @tclass: target security class
174 static void avc_dump_query(struct audit_buffer *ab, struct selinux_state *state,
175 u32 ssid, u32 tsid, u16 tclass)
177 int rc;
178 char *scontext;
179 u32 scontext_len;
181 rc = security_sid_to_context(state, ssid, &scontext, &scontext_len);
182 if (rc)
183 audit_log_format(ab, "ssid=%d", ssid);
184 else {
185 audit_log_format(ab, "scontext=%s", scontext);
186 kfree(scontext);
189 rc = security_sid_to_context(state, tsid, &scontext, &scontext_len);
190 if (rc)
191 audit_log_format(ab, " tsid=%d", tsid);
192 else {
193 audit_log_format(ab, " tcontext=%s", scontext);
194 kfree(scontext);
197 BUG_ON(!tclass || tclass >= ARRAY_SIZE(secclass_map));
198 audit_log_format(ab, " tclass=%s", secclass_map[tclass-1].name);
202 * avc_init - Initialize the AVC.
204 * Initialize the access vector cache.
206 void __init avc_init(void)
208 avc_node_cachep = kmem_cache_create("avc_node", sizeof(struct avc_node),
209 0, SLAB_PANIC, NULL);
210 avc_xperms_cachep = kmem_cache_create("avc_xperms_node",
211 sizeof(struct avc_xperms_node),
212 0, SLAB_PANIC, NULL);
213 avc_xperms_decision_cachep = kmem_cache_create(
214 "avc_xperms_decision_node",
215 sizeof(struct avc_xperms_decision_node),
216 0, SLAB_PANIC, NULL);
217 avc_xperms_data_cachep = kmem_cache_create("avc_xperms_data",
218 sizeof(struct extended_perms_data),
219 0, SLAB_PANIC, NULL);
222 int avc_get_hash_stats(struct selinux_avc *avc, char *page)
224 int i, chain_len, max_chain_len, slots_used;
225 struct avc_node *node;
226 struct hlist_head *head;
228 rcu_read_lock();
230 slots_used = 0;
231 max_chain_len = 0;
232 for (i = 0; i < AVC_CACHE_SLOTS; i++) {
233 head = &avc->avc_cache.slots[i];
234 if (!hlist_empty(head)) {
235 slots_used++;
236 chain_len = 0;
237 hlist_for_each_entry_rcu(node, head, list)
238 chain_len++;
239 if (chain_len > max_chain_len)
240 max_chain_len = chain_len;
244 rcu_read_unlock();
246 return scnprintf(page, PAGE_SIZE, "entries: %d\nbuckets used: %d/%d\n"
247 "longest chain: %d\n",
248 atomic_read(&avc->avc_cache.active_nodes),
249 slots_used, AVC_CACHE_SLOTS, max_chain_len);
253 * using a linked list for extended_perms_decision lookup because the list is
254 * always small. i.e. less than 5, typically 1
256 static struct extended_perms_decision *avc_xperms_decision_lookup(u8 driver,
257 struct avc_xperms_node *xp_node)
259 struct avc_xperms_decision_node *xpd_node;
261 list_for_each_entry(xpd_node, &xp_node->xpd_head, xpd_list) {
262 if (xpd_node->xpd.driver == driver)
263 return &xpd_node->xpd;
265 return NULL;
268 static inline unsigned int
269 avc_xperms_has_perm(struct extended_perms_decision *xpd,
270 u8 perm, u8 which)
272 unsigned int rc = 0;
274 if ((which == XPERMS_ALLOWED) &&
275 (xpd->used & XPERMS_ALLOWED))
276 rc = security_xperm_test(xpd->allowed->p, perm);
277 else if ((which == XPERMS_AUDITALLOW) &&
278 (xpd->used & XPERMS_AUDITALLOW))
279 rc = security_xperm_test(xpd->auditallow->p, perm);
280 else if ((which == XPERMS_DONTAUDIT) &&
281 (xpd->used & XPERMS_DONTAUDIT))
282 rc = security_xperm_test(xpd->dontaudit->p, perm);
283 return rc;
286 static void avc_xperms_allow_perm(struct avc_xperms_node *xp_node,
287 u8 driver, u8 perm)
289 struct extended_perms_decision *xpd;
290 security_xperm_set(xp_node->xp.drivers.p, driver);
291 xpd = avc_xperms_decision_lookup(driver, xp_node);
292 if (xpd && xpd->allowed)
293 security_xperm_set(xpd->allowed->p, perm);
296 static void avc_xperms_decision_free(struct avc_xperms_decision_node *xpd_node)
298 struct extended_perms_decision *xpd;
300 xpd = &xpd_node->xpd;
301 if (xpd->allowed)
302 kmem_cache_free(avc_xperms_data_cachep, xpd->allowed);
303 if (xpd->auditallow)
304 kmem_cache_free(avc_xperms_data_cachep, xpd->auditallow);
305 if (xpd->dontaudit)
306 kmem_cache_free(avc_xperms_data_cachep, xpd->dontaudit);
307 kmem_cache_free(avc_xperms_decision_cachep, xpd_node);
310 static void avc_xperms_free(struct avc_xperms_node *xp_node)
312 struct avc_xperms_decision_node *xpd_node, *tmp;
314 if (!xp_node)
315 return;
317 list_for_each_entry_safe(xpd_node, tmp, &xp_node->xpd_head, xpd_list) {
318 list_del(&xpd_node->xpd_list);
319 avc_xperms_decision_free(xpd_node);
321 kmem_cache_free(avc_xperms_cachep, xp_node);
324 static void avc_copy_xperms_decision(struct extended_perms_decision *dest,
325 struct extended_perms_decision *src)
327 dest->driver = src->driver;
328 dest->used = src->used;
329 if (dest->used & XPERMS_ALLOWED)
330 memcpy(dest->allowed->p, src->allowed->p,
331 sizeof(src->allowed->p));
332 if (dest->used & XPERMS_AUDITALLOW)
333 memcpy(dest->auditallow->p, src->auditallow->p,
334 sizeof(src->auditallow->p));
335 if (dest->used & XPERMS_DONTAUDIT)
336 memcpy(dest->dontaudit->p, src->dontaudit->p,
337 sizeof(src->dontaudit->p));
341 * similar to avc_copy_xperms_decision, but only copy decision
342 * information relevant to this perm
344 static inline void avc_quick_copy_xperms_decision(u8 perm,
345 struct extended_perms_decision *dest,
346 struct extended_perms_decision *src)
349 * compute index of the u32 of the 256 bits (8 u32s) that contain this
350 * command permission
352 u8 i = perm >> 5;
354 dest->used = src->used;
355 if (dest->used & XPERMS_ALLOWED)
356 dest->allowed->p[i] = src->allowed->p[i];
357 if (dest->used & XPERMS_AUDITALLOW)
358 dest->auditallow->p[i] = src->auditallow->p[i];
359 if (dest->used & XPERMS_DONTAUDIT)
360 dest->dontaudit->p[i] = src->dontaudit->p[i];
363 static struct avc_xperms_decision_node
364 *avc_xperms_decision_alloc(u8 which)
366 struct avc_xperms_decision_node *xpd_node;
367 struct extended_perms_decision *xpd;
369 xpd_node = kmem_cache_zalloc(avc_xperms_decision_cachep, GFP_NOWAIT);
370 if (!xpd_node)
371 return NULL;
373 xpd = &xpd_node->xpd;
374 if (which & XPERMS_ALLOWED) {
375 xpd->allowed = kmem_cache_zalloc(avc_xperms_data_cachep,
376 GFP_NOWAIT);
377 if (!xpd->allowed)
378 goto error;
380 if (which & XPERMS_AUDITALLOW) {
381 xpd->auditallow = kmem_cache_zalloc(avc_xperms_data_cachep,
382 GFP_NOWAIT);
383 if (!xpd->auditallow)
384 goto error;
386 if (which & XPERMS_DONTAUDIT) {
387 xpd->dontaudit = kmem_cache_zalloc(avc_xperms_data_cachep,
388 GFP_NOWAIT);
389 if (!xpd->dontaudit)
390 goto error;
392 return xpd_node;
393 error:
394 avc_xperms_decision_free(xpd_node);
395 return NULL;
398 static int avc_add_xperms_decision(struct avc_node *node,
399 struct extended_perms_decision *src)
401 struct avc_xperms_decision_node *dest_xpd;
403 node->ae.xp_node->xp.len++;
404 dest_xpd = avc_xperms_decision_alloc(src->used);
405 if (!dest_xpd)
406 return -ENOMEM;
407 avc_copy_xperms_decision(&dest_xpd->xpd, src);
408 list_add(&dest_xpd->xpd_list, &node->ae.xp_node->xpd_head);
409 return 0;
412 static struct avc_xperms_node *avc_xperms_alloc(void)
414 struct avc_xperms_node *xp_node;
416 xp_node = kmem_cache_zalloc(avc_xperms_cachep, GFP_NOWAIT);
417 if (!xp_node)
418 return xp_node;
419 INIT_LIST_HEAD(&xp_node->xpd_head);
420 return xp_node;
423 static int avc_xperms_populate(struct avc_node *node,
424 struct avc_xperms_node *src)
426 struct avc_xperms_node *dest;
427 struct avc_xperms_decision_node *dest_xpd;
428 struct avc_xperms_decision_node *src_xpd;
430 if (src->xp.len == 0)
431 return 0;
432 dest = avc_xperms_alloc();
433 if (!dest)
434 return -ENOMEM;
436 memcpy(dest->xp.drivers.p, src->xp.drivers.p, sizeof(dest->xp.drivers.p));
437 dest->xp.len = src->xp.len;
439 /* for each source xpd allocate a destination xpd and copy */
440 list_for_each_entry(src_xpd, &src->xpd_head, xpd_list) {
441 dest_xpd = avc_xperms_decision_alloc(src_xpd->xpd.used);
442 if (!dest_xpd)
443 goto error;
444 avc_copy_xperms_decision(&dest_xpd->xpd, &src_xpd->xpd);
445 list_add(&dest_xpd->xpd_list, &dest->xpd_head);
447 node->ae.xp_node = dest;
448 return 0;
449 error:
450 avc_xperms_free(dest);
451 return -ENOMEM;
455 static inline u32 avc_xperms_audit_required(u32 requested,
456 struct av_decision *avd,
457 struct extended_perms_decision *xpd,
458 u8 perm,
459 int result,
460 u32 *deniedp)
462 u32 denied, audited;
464 denied = requested & ~avd->allowed;
465 if (unlikely(denied)) {
466 audited = denied & avd->auditdeny;
467 if (audited && xpd) {
468 if (avc_xperms_has_perm(xpd, perm, XPERMS_DONTAUDIT))
469 audited &= ~requested;
471 } else if (result) {
472 audited = denied = requested;
473 } else {
474 audited = requested & avd->auditallow;
475 if (audited && xpd) {
476 if (!avc_xperms_has_perm(xpd, perm, XPERMS_AUDITALLOW))
477 audited &= ~requested;
481 *deniedp = denied;
482 return audited;
485 static inline int avc_xperms_audit(struct selinux_state *state,
486 u32 ssid, u32 tsid, u16 tclass,
487 u32 requested, struct av_decision *avd,
488 struct extended_perms_decision *xpd,
489 u8 perm, int result,
490 struct common_audit_data *ad)
492 u32 audited, denied;
494 audited = avc_xperms_audit_required(
495 requested, avd, xpd, perm, result, &denied);
496 if (likely(!audited))
497 return 0;
498 return slow_avc_audit(state, ssid, tsid, tclass, requested,
499 audited, denied, result, ad);
502 static void avc_node_free(struct rcu_head *rhead)
504 struct avc_node *node = container_of(rhead, struct avc_node, rhead);
505 avc_xperms_free(node->ae.xp_node);
506 kmem_cache_free(avc_node_cachep, node);
507 avc_cache_stats_incr(frees);
510 static void avc_node_delete(struct selinux_avc *avc, struct avc_node *node)
512 hlist_del_rcu(&node->list);
513 call_rcu(&node->rhead, avc_node_free);
514 atomic_dec(&avc->avc_cache.active_nodes);
517 static void avc_node_kill(struct selinux_avc *avc, struct avc_node *node)
519 avc_xperms_free(node->ae.xp_node);
520 kmem_cache_free(avc_node_cachep, node);
521 avc_cache_stats_incr(frees);
522 atomic_dec(&avc->avc_cache.active_nodes);
525 static void avc_node_replace(struct selinux_avc *avc,
526 struct avc_node *new, struct avc_node *old)
528 hlist_replace_rcu(&old->list, &new->list);
529 call_rcu(&old->rhead, avc_node_free);
530 atomic_dec(&avc->avc_cache.active_nodes);
533 static inline int avc_reclaim_node(struct selinux_avc *avc)
535 struct avc_node *node;
536 int hvalue, try, ecx;
537 unsigned long flags;
538 struct hlist_head *head;
539 spinlock_t *lock;
541 for (try = 0, ecx = 0; try < AVC_CACHE_SLOTS; try++) {
542 hvalue = atomic_inc_return(&avc->avc_cache.lru_hint) &
543 (AVC_CACHE_SLOTS - 1);
544 head = &avc->avc_cache.slots[hvalue];
545 lock = &avc->avc_cache.slots_lock[hvalue];
547 if (!spin_trylock_irqsave(lock, flags))
548 continue;
550 rcu_read_lock();
551 hlist_for_each_entry(node, head, list) {
552 avc_node_delete(avc, node);
553 avc_cache_stats_incr(reclaims);
554 ecx++;
555 if (ecx >= AVC_CACHE_RECLAIM) {
556 rcu_read_unlock();
557 spin_unlock_irqrestore(lock, flags);
558 goto out;
561 rcu_read_unlock();
562 spin_unlock_irqrestore(lock, flags);
564 out:
565 return ecx;
568 static struct avc_node *avc_alloc_node(struct selinux_avc *avc)
570 struct avc_node *node;
572 node = kmem_cache_zalloc(avc_node_cachep, GFP_NOWAIT);
573 if (!node)
574 goto out;
576 INIT_HLIST_NODE(&node->list);
577 avc_cache_stats_incr(allocations);
579 if (atomic_inc_return(&avc->avc_cache.active_nodes) >
580 avc->avc_cache_threshold)
581 avc_reclaim_node(avc);
583 out:
584 return node;
587 static void avc_node_populate(struct avc_node *node, u32 ssid, u32 tsid, u16 tclass, struct av_decision *avd)
589 node->ae.ssid = ssid;
590 node->ae.tsid = tsid;
591 node->ae.tclass = tclass;
592 memcpy(&node->ae.avd, avd, sizeof(node->ae.avd));
595 static inline struct avc_node *avc_search_node(struct selinux_avc *avc,
596 u32 ssid, u32 tsid, u16 tclass)
598 struct avc_node *node, *ret = NULL;
599 int hvalue;
600 struct hlist_head *head;
602 hvalue = avc_hash(ssid, tsid, tclass);
603 head = &avc->avc_cache.slots[hvalue];
604 hlist_for_each_entry_rcu(node, head, list) {
605 if (ssid == node->ae.ssid &&
606 tclass == node->ae.tclass &&
607 tsid == node->ae.tsid) {
608 ret = node;
609 break;
613 return ret;
617 * avc_lookup - Look up an AVC entry.
618 * @ssid: source security identifier
619 * @tsid: target security identifier
620 * @tclass: target security class
622 * Look up an AVC entry that is valid for the
623 * (@ssid, @tsid), interpreting the permissions
624 * based on @tclass. If a valid AVC entry exists,
625 * then this function returns the avc_node.
626 * Otherwise, this function returns NULL.
628 static struct avc_node *avc_lookup(struct selinux_avc *avc,
629 u32 ssid, u32 tsid, u16 tclass)
631 struct avc_node *node;
633 avc_cache_stats_incr(lookups);
634 node = avc_search_node(avc, ssid, tsid, tclass);
636 if (node)
637 return node;
639 avc_cache_stats_incr(misses);
640 return NULL;
643 static int avc_latest_notif_update(struct selinux_avc *avc,
644 int seqno, int is_insert)
646 int ret = 0;
647 static DEFINE_SPINLOCK(notif_lock);
648 unsigned long flag;
650 spin_lock_irqsave(&notif_lock, flag);
651 if (is_insert) {
652 if (seqno < avc->avc_cache.latest_notif) {
653 pr_warn("SELinux: avc: seqno %d < latest_notif %d\n",
654 seqno, avc->avc_cache.latest_notif);
655 ret = -EAGAIN;
657 } else {
658 if (seqno > avc->avc_cache.latest_notif)
659 avc->avc_cache.latest_notif = seqno;
661 spin_unlock_irqrestore(&notif_lock, flag);
663 return ret;
667 * avc_insert - Insert an AVC entry.
668 * @ssid: source security identifier
669 * @tsid: target security identifier
670 * @tclass: target security class
671 * @avd: resulting av decision
672 * @xp_node: resulting extended permissions
674 * Insert an AVC entry for the SID pair
675 * (@ssid, @tsid) and class @tclass.
676 * The access vectors and the sequence number are
677 * normally provided by the security server in
678 * response to a security_compute_av() call. If the
679 * sequence number @avd->seqno is not less than the latest
680 * revocation notification, then the function copies
681 * the access vectors into a cache entry, returns
682 * avc_node inserted. Otherwise, this function returns NULL.
684 static struct avc_node *avc_insert(struct selinux_avc *avc,
685 u32 ssid, u32 tsid, u16 tclass,
686 struct av_decision *avd,
687 struct avc_xperms_node *xp_node)
689 struct avc_node *pos, *node = NULL;
690 int hvalue;
691 unsigned long flag;
692 spinlock_t *lock;
693 struct hlist_head *head;
695 if (avc_latest_notif_update(avc, avd->seqno, 1))
696 return NULL;
698 node = avc_alloc_node(avc);
699 if (!node)
700 return NULL;
702 avc_node_populate(node, ssid, tsid, tclass, avd);
703 if (avc_xperms_populate(node, xp_node)) {
704 avc_node_kill(avc, node);
705 return NULL;
708 hvalue = avc_hash(ssid, tsid, tclass);
709 head = &avc->avc_cache.slots[hvalue];
710 lock = &avc->avc_cache.slots_lock[hvalue];
711 spin_lock_irqsave(lock, flag);
712 hlist_for_each_entry(pos, head, list) {
713 if (pos->ae.ssid == ssid &&
714 pos->ae.tsid == tsid &&
715 pos->ae.tclass == tclass) {
716 avc_node_replace(avc, node, pos);
717 goto found;
720 hlist_add_head_rcu(&node->list, head);
721 found:
722 spin_unlock_irqrestore(lock, flag);
723 return node;
727 * avc_audit_pre_callback - SELinux specific information
728 * will be called by generic audit code
729 * @ab: the audit buffer
730 * @a: audit_data
732 static void avc_audit_pre_callback(struct audit_buffer *ab, void *a)
734 struct common_audit_data *ad = a;
735 audit_log_format(ab, "avc: %s ",
736 ad->selinux_audit_data->denied ? "denied" : "granted");
737 avc_dump_av(ab, ad->selinux_audit_data->tclass,
738 ad->selinux_audit_data->audited);
739 audit_log_format(ab, " for ");
743 * avc_audit_post_callback - SELinux specific information
744 * will be called by generic audit code
745 * @ab: the audit buffer
746 * @a: audit_data
748 static void avc_audit_post_callback(struct audit_buffer *ab, void *a)
750 struct common_audit_data *ad = a;
751 audit_log_format(ab, " ");
752 avc_dump_query(ab, ad->selinux_audit_data->state,
753 ad->selinux_audit_data->ssid,
754 ad->selinux_audit_data->tsid,
755 ad->selinux_audit_data->tclass);
756 if (ad->selinux_audit_data->denied) {
757 audit_log_format(ab, " permissive=%u",
758 ad->selinux_audit_data->result ? 0 : 1);
762 /* This is the slow part of avc audit with big stack footprint */
763 noinline int slow_avc_audit(struct selinux_state *state,
764 u32 ssid, u32 tsid, u16 tclass,
765 u32 requested, u32 audited, u32 denied, int result,
766 struct common_audit_data *a)
768 struct common_audit_data stack_data;
769 struct selinux_audit_data sad;
771 if (!a) {
772 a = &stack_data;
773 a->type = LSM_AUDIT_DATA_NONE;
776 sad.tclass = tclass;
777 sad.requested = requested;
778 sad.ssid = ssid;
779 sad.tsid = tsid;
780 sad.audited = audited;
781 sad.denied = denied;
782 sad.result = result;
783 sad.state = state;
785 a->selinux_audit_data = &sad;
787 common_lsm_audit(a, avc_audit_pre_callback, avc_audit_post_callback);
788 return 0;
792 * avc_add_callback - Register a callback for security events.
793 * @callback: callback function
794 * @events: security events
796 * Register a callback function for events in the set @events.
797 * Returns %0 on success or -%ENOMEM if insufficient memory
798 * exists to add the callback.
800 int __init avc_add_callback(int (*callback)(u32 event), u32 events)
802 struct avc_callback_node *c;
803 int rc = 0;
805 c = kmalloc(sizeof(*c), GFP_KERNEL);
806 if (!c) {
807 rc = -ENOMEM;
808 goto out;
811 c->callback = callback;
812 c->events = events;
813 c->next = avc_callbacks;
814 avc_callbacks = c;
815 out:
816 return rc;
820 * avc_update_node Update an AVC entry
821 * @event : Updating event
822 * @perms : Permission mask bits
823 * @ssid,@tsid,@tclass : identifier of an AVC entry
824 * @seqno : sequence number when decision was made
825 * @xpd: extended_perms_decision to be added to the node
826 * @flags: the AVC_* flags, e.g. AVC_NONBLOCKING, AVC_EXTENDED_PERMS, or 0.
828 * if a valid AVC entry doesn't exist,this function returns -ENOENT.
829 * if kmalloc() called internal returns NULL, this function returns -ENOMEM.
830 * otherwise, this function updates the AVC entry. The original AVC-entry object
831 * will release later by RCU.
833 static int avc_update_node(struct selinux_avc *avc,
834 u32 event, u32 perms, u8 driver, u8 xperm, u32 ssid,
835 u32 tsid, u16 tclass, u32 seqno,
836 struct extended_perms_decision *xpd,
837 u32 flags)
839 int hvalue, rc = 0;
840 unsigned long flag;
841 struct avc_node *pos, *node, *orig = NULL;
842 struct hlist_head *head;
843 spinlock_t *lock;
846 * If we are in a non-blocking code path, e.g. VFS RCU walk,
847 * then we must not add permissions to a cache entry
848 * because we will not audit the denial. Otherwise,
849 * during the subsequent blocking retry (e.g. VFS ref walk), we
850 * will find the permissions already granted in the cache entry
851 * and won't audit anything at all, leading to silent denials in
852 * permissive mode that only appear when in enforcing mode.
854 * See the corresponding handling of MAY_NOT_BLOCK in avc_audit()
855 * and selinux_inode_permission().
857 if (flags & AVC_NONBLOCKING)
858 return 0;
860 node = avc_alloc_node(avc);
861 if (!node) {
862 rc = -ENOMEM;
863 goto out;
866 /* Lock the target slot */
867 hvalue = avc_hash(ssid, tsid, tclass);
869 head = &avc->avc_cache.slots[hvalue];
870 lock = &avc->avc_cache.slots_lock[hvalue];
872 spin_lock_irqsave(lock, flag);
874 hlist_for_each_entry(pos, head, list) {
875 if (ssid == pos->ae.ssid &&
876 tsid == pos->ae.tsid &&
877 tclass == pos->ae.tclass &&
878 seqno == pos->ae.avd.seqno){
879 orig = pos;
880 break;
884 if (!orig) {
885 rc = -ENOENT;
886 avc_node_kill(avc, node);
887 goto out_unlock;
891 * Copy and replace original node.
894 avc_node_populate(node, ssid, tsid, tclass, &orig->ae.avd);
896 if (orig->ae.xp_node) {
897 rc = avc_xperms_populate(node, orig->ae.xp_node);
898 if (rc) {
899 avc_node_kill(avc, node);
900 goto out_unlock;
904 switch (event) {
905 case AVC_CALLBACK_GRANT:
906 node->ae.avd.allowed |= perms;
907 if (node->ae.xp_node && (flags & AVC_EXTENDED_PERMS))
908 avc_xperms_allow_perm(node->ae.xp_node, driver, xperm);
909 break;
910 case AVC_CALLBACK_TRY_REVOKE:
911 case AVC_CALLBACK_REVOKE:
912 node->ae.avd.allowed &= ~perms;
913 break;
914 case AVC_CALLBACK_AUDITALLOW_ENABLE:
915 node->ae.avd.auditallow |= perms;
916 break;
917 case AVC_CALLBACK_AUDITALLOW_DISABLE:
918 node->ae.avd.auditallow &= ~perms;
919 break;
920 case AVC_CALLBACK_AUDITDENY_ENABLE:
921 node->ae.avd.auditdeny |= perms;
922 break;
923 case AVC_CALLBACK_AUDITDENY_DISABLE:
924 node->ae.avd.auditdeny &= ~perms;
925 break;
926 case AVC_CALLBACK_ADD_XPERMS:
927 avc_add_xperms_decision(node, xpd);
928 break;
930 avc_node_replace(avc, node, orig);
931 out_unlock:
932 spin_unlock_irqrestore(lock, flag);
933 out:
934 return rc;
938 * avc_flush - Flush the cache
940 static void avc_flush(struct selinux_avc *avc)
942 struct hlist_head *head;
943 struct avc_node *node;
944 spinlock_t *lock;
945 unsigned long flag;
946 int i;
948 for (i = 0; i < AVC_CACHE_SLOTS; i++) {
949 head = &avc->avc_cache.slots[i];
950 lock = &avc->avc_cache.slots_lock[i];
952 spin_lock_irqsave(lock, flag);
954 * With preemptable RCU, the outer spinlock does not
955 * prevent RCU grace periods from ending.
957 rcu_read_lock();
958 hlist_for_each_entry(node, head, list)
959 avc_node_delete(avc, node);
960 rcu_read_unlock();
961 spin_unlock_irqrestore(lock, flag);
966 * avc_ss_reset - Flush the cache and revalidate migrated permissions.
967 * @seqno: policy sequence number
969 int avc_ss_reset(struct selinux_avc *avc, u32 seqno)
971 struct avc_callback_node *c;
972 int rc = 0, tmprc;
974 avc_flush(avc);
976 for (c = avc_callbacks; c; c = c->next) {
977 if (c->events & AVC_CALLBACK_RESET) {
978 tmprc = c->callback(AVC_CALLBACK_RESET);
979 /* save the first error encountered for the return
980 value and continue processing the callbacks */
981 if (!rc)
982 rc = tmprc;
986 avc_latest_notif_update(avc, seqno, 0);
987 return rc;
991 * Slow-path helper function for avc_has_perm_noaudit,
992 * when the avc_node lookup fails. We get called with
993 * the RCU read lock held, and need to return with it
994 * still held, but drop if for the security compute.
996 * Don't inline this, since it's the slow-path and just
997 * results in a bigger stack frame.
999 static noinline
1000 struct avc_node *avc_compute_av(struct selinux_state *state,
1001 u32 ssid, u32 tsid,
1002 u16 tclass, struct av_decision *avd,
1003 struct avc_xperms_node *xp_node)
1005 rcu_read_unlock();
1006 INIT_LIST_HEAD(&xp_node->xpd_head);
1007 security_compute_av(state, ssid, tsid, tclass, avd, &xp_node->xp);
1008 rcu_read_lock();
1009 return avc_insert(state->avc, ssid, tsid, tclass, avd, xp_node);
1012 static noinline int avc_denied(struct selinux_state *state,
1013 u32 ssid, u32 tsid,
1014 u16 tclass, u32 requested,
1015 u8 driver, u8 xperm, unsigned int flags,
1016 struct av_decision *avd)
1018 if (flags & AVC_STRICT)
1019 return -EACCES;
1021 if (enforcing_enabled(state) &&
1022 !(avd->flags & AVD_FLAGS_PERMISSIVE))
1023 return -EACCES;
1025 avc_update_node(state->avc, AVC_CALLBACK_GRANT, requested, driver,
1026 xperm, ssid, tsid, tclass, avd->seqno, NULL, flags);
1027 return 0;
1031 * The avc extended permissions logic adds an additional 256 bits of
1032 * permissions to an avc node when extended permissions for that node are
1033 * specified in the avtab. If the additional 256 permissions is not adequate,
1034 * as-is the case with ioctls, then multiple may be chained together and the
1035 * driver field is used to specify which set contains the permission.
1037 int avc_has_extended_perms(struct selinux_state *state,
1038 u32 ssid, u32 tsid, u16 tclass, u32 requested,
1039 u8 driver, u8 xperm, struct common_audit_data *ad)
1041 struct avc_node *node;
1042 struct av_decision avd;
1043 u32 denied;
1044 struct extended_perms_decision local_xpd;
1045 struct extended_perms_decision *xpd = NULL;
1046 struct extended_perms_data allowed;
1047 struct extended_perms_data auditallow;
1048 struct extended_perms_data dontaudit;
1049 struct avc_xperms_node local_xp_node;
1050 struct avc_xperms_node *xp_node;
1051 int rc = 0, rc2;
1053 xp_node = &local_xp_node;
1054 BUG_ON(!requested);
1056 rcu_read_lock();
1058 node = avc_lookup(state->avc, ssid, tsid, tclass);
1059 if (unlikely(!node)) {
1060 node = avc_compute_av(state, ssid, tsid, tclass, &avd, xp_node);
1061 } else {
1062 memcpy(&avd, &node->ae.avd, sizeof(avd));
1063 xp_node = node->ae.xp_node;
1065 /* if extended permissions are not defined, only consider av_decision */
1066 if (!xp_node || !xp_node->xp.len)
1067 goto decision;
1069 local_xpd.allowed = &allowed;
1070 local_xpd.auditallow = &auditallow;
1071 local_xpd.dontaudit = &dontaudit;
1073 xpd = avc_xperms_decision_lookup(driver, xp_node);
1074 if (unlikely(!xpd)) {
1076 * Compute the extended_perms_decision only if the driver
1077 * is flagged
1079 if (!security_xperm_test(xp_node->xp.drivers.p, driver)) {
1080 avd.allowed &= ~requested;
1081 goto decision;
1083 rcu_read_unlock();
1084 security_compute_xperms_decision(state, ssid, tsid, tclass,
1085 driver, &local_xpd);
1086 rcu_read_lock();
1087 avc_update_node(state->avc, AVC_CALLBACK_ADD_XPERMS, requested,
1088 driver, xperm, ssid, tsid, tclass, avd.seqno,
1089 &local_xpd, 0);
1090 } else {
1091 avc_quick_copy_xperms_decision(xperm, &local_xpd, xpd);
1093 xpd = &local_xpd;
1095 if (!avc_xperms_has_perm(xpd, xperm, XPERMS_ALLOWED))
1096 avd.allowed &= ~requested;
1098 decision:
1099 denied = requested & ~(avd.allowed);
1100 if (unlikely(denied))
1101 rc = avc_denied(state, ssid, tsid, tclass, requested,
1102 driver, xperm, AVC_EXTENDED_PERMS, &avd);
1104 rcu_read_unlock();
1106 rc2 = avc_xperms_audit(state, ssid, tsid, tclass, requested,
1107 &avd, xpd, xperm, rc, ad);
1108 if (rc2)
1109 return rc2;
1110 return rc;
1114 * avc_has_perm_noaudit - Check permissions but perform no auditing.
1115 * @ssid: source security identifier
1116 * @tsid: target security identifier
1117 * @tclass: target security class
1118 * @requested: requested permissions, interpreted based on @tclass
1119 * @flags: AVC_STRICT, AVC_NONBLOCKING, or 0
1120 * @avd: access vector decisions
1122 * Check the AVC to determine whether the @requested permissions are granted
1123 * for the SID pair (@ssid, @tsid), interpreting the permissions
1124 * based on @tclass, and call the security server on a cache miss to obtain
1125 * a new decision and add it to the cache. Return a copy of the decisions
1126 * in @avd. Return %0 if all @requested permissions are granted,
1127 * -%EACCES if any permissions are denied, or another -errno upon
1128 * other errors. This function is typically called by avc_has_perm(),
1129 * but may also be called directly to separate permission checking from
1130 * auditing, e.g. in cases where a lock must be held for the check but
1131 * should be released for the auditing.
1133 inline int avc_has_perm_noaudit(struct selinux_state *state,
1134 u32 ssid, u32 tsid,
1135 u16 tclass, u32 requested,
1136 unsigned int flags,
1137 struct av_decision *avd)
1139 struct avc_node *node;
1140 struct avc_xperms_node xp_node;
1141 int rc = 0;
1142 u32 denied;
1144 BUG_ON(!requested);
1146 rcu_read_lock();
1148 node = avc_lookup(state->avc, ssid, tsid, tclass);
1149 if (unlikely(!node))
1150 node = avc_compute_av(state, ssid, tsid, tclass, avd, &xp_node);
1151 else
1152 memcpy(avd, &node->ae.avd, sizeof(*avd));
1154 denied = requested & ~(avd->allowed);
1155 if (unlikely(denied))
1156 rc = avc_denied(state, ssid, tsid, tclass, requested, 0, 0,
1157 flags, avd);
1159 rcu_read_unlock();
1160 return rc;
1164 * avc_has_perm - Check permissions and perform any appropriate auditing.
1165 * @ssid: source security identifier
1166 * @tsid: target security identifier
1167 * @tclass: target security class
1168 * @requested: requested permissions, interpreted based on @tclass
1169 * @auditdata: auxiliary audit data
1171 * Check the AVC to determine whether the @requested permissions are granted
1172 * for the SID pair (@ssid, @tsid), interpreting the permissions
1173 * based on @tclass, and call the security server on a cache miss to obtain
1174 * a new decision and add it to the cache. Audit the granting or denial of
1175 * permissions in accordance with the policy. Return %0 if all @requested
1176 * permissions are granted, -%EACCES if any permissions are denied, or
1177 * another -errno upon other errors.
1179 int avc_has_perm(struct selinux_state *state, u32 ssid, u32 tsid, u16 tclass,
1180 u32 requested, struct common_audit_data *auditdata)
1182 struct av_decision avd;
1183 int rc, rc2;
1185 rc = avc_has_perm_noaudit(state, ssid, tsid, tclass, requested, 0,
1186 &avd);
1188 rc2 = avc_audit(state, ssid, tsid, tclass, requested, &avd, rc,
1189 auditdata, 0);
1190 if (rc2)
1191 return rc2;
1192 return rc;
1195 int avc_has_perm_flags(struct selinux_state *state,
1196 u32 ssid, u32 tsid, u16 tclass, u32 requested,
1197 struct common_audit_data *auditdata,
1198 int flags)
1200 struct av_decision avd;
1201 int rc, rc2;
1203 rc = avc_has_perm_noaudit(state, ssid, tsid, tclass, requested,
1204 (flags & MAY_NOT_BLOCK) ? AVC_NONBLOCKING : 0,
1205 &avd);
1207 rc2 = avc_audit(state, ssid, tsid, tclass, requested, &avd, rc,
1208 auditdata, flags);
1209 if (rc2)
1210 return rc2;
1211 return rc;
1214 u32 avc_policy_seqno(struct selinux_state *state)
1216 return state->avc->avc_cache.latest_notif;
1219 void avc_disable(void)
1222 * If you are looking at this because you have realized that we are
1223 * not destroying the avc_node_cachep it might be easy to fix, but
1224 * I don't know the memory barrier semantics well enough to know. It's
1225 * possible that some other task dereferenced security_ops when
1226 * it still pointed to selinux operations. If that is the case it's
1227 * possible that it is about to use the avc and is about to need the
1228 * avc_node_cachep. I know I could wrap the security.c security_ops call
1229 * in an rcu_lock, but seriously, it's not worth it. Instead I just flush
1230 * the cache and get that memory back.
1232 if (avc_node_cachep) {
1233 avc_flush(selinux_state.avc);
1234 /* kmem_cache_destroy(avc_node_cachep); */