1 /* SPDX-License-Identifier: GPL-2.0-only */ 1
2 /*
3 * Landlock LSM - Object management
4 *
5 * Copyright © 2016-2020 Mickaël Salaün <mi
6 * Copyright © 2018-2020 ANSSI
7 */
8
9 #ifndef _SECURITY_LANDLOCK_OBJECT_H
10 #define _SECURITY_LANDLOCK_OBJECT_H
11
12 #include <linux/compiler_types.h>
13 #include <linux/refcount.h>
14 #include <linux/spinlock.h>
15
16 struct landlock_object;
17
18 /**
19 * struct landlock_object_underops - Operation
20 */
21 struct landlock_object_underops {
22 /**
23 * @release: Releases the underlying o
24 */
25 void (*release)(struct landlock_object
26 __releases(object->lock);
27 };
28
29 /**
30 * struct landlock_object - Security blob tied
31 *
32 * The goal of this structure is to enable to
33 * rights (pertaining to different domains) to
34 * in a safe way. This implies to handle conc
35 *
36 * The lifetime of a &struct landlock_object d
37 * it.
38 */
39 struct landlock_object {
40 /**
41 * @usage: This counter is used to tie
42 * it or to keep it alive while adding
43 * reaches zero, this struct must not
44 * still be read from within an RCU re
45 * adding a new rule to an object with
46 * wait until the pointer to this obje
47 */
48 refcount_t usage;
49 /**
50 * @lock: Protects against concurrent
51 * held from the time @usage drops to
52 * from @underobj to this object have
53 *
54 * Lock ordering: inode->i_lock nests
55 */
56 spinlock_t lock;
57 /**
58 * @underobj: Used when cleaning up an
59 * tied to its underlying kernel struc
60 * by @lock. Cf. landlock_release_ino
61 */
62 void *underobj;
63 union {
64 /**
65 * @rcu_free: Enables lockless
66 * @underobj from within an RC
67 * @rcu_free and @underops are
68 * landlock_put_object().
69 */
70 struct rcu_head rcu_free;
71 /**
72 * @underops: Enables landlock
73 * underlying object (e.g. ino
74 */
75 const struct landlock_object_u
76 };
77 };
78
79 struct landlock_object *
80 landlock_create_object(const struct landlock_o
81 void *const underobj);
82
83 void landlock_put_object(struct landlock_objec
84
85 static inline void landlock_get_object(struct
86 {
87 if (object)
88 refcount_inc(&object->usage);
89 }
90
91 #endif /* _SECURITY_LANDLOCK_OBJECT_H */
92
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.