1 /* SPDX-License-Identifier: GPL-2.0-only */ 1
2 /*
3 * Landlock LSM - Filesystem management and ho
4 *
5 * Copyright © 2017-2020 Mickaël Salaün <mi
6 * Copyright © 2018-2020 ANSSI
7 */
8
9 #ifndef _SECURITY_LANDLOCK_FS_H
10 #define _SECURITY_LANDLOCK_FS_H
11
12 #include <linux/fs.h>
13 #include <linux/init.h>
14 #include <linux/rcupdate.h>
15
16 #include "ruleset.h"
17 #include "setup.h"
18
19 /**
20 * struct landlock_inode_security - Inode secu
21 *
22 * Enable to reference a &struct landlock_obje
23 * underlying object).
24 */
25 struct landlock_inode_security {
26 /**
27 * @object: Weak pointer to an allocat
28 * new object are protected by the und
29 * atomically disassociating @object f
30 * by @object->lock, from the time @ob
31 * zero to the time this pointer is nu
32 * hook_sb_delete()). Indeed, such di
33 * inode->i_lock thanks to the careful
34 * performed by get_inode_object().
35 */
36 struct landlock_object __rcu *object;
37 };
38
39 /**
40 * struct landlock_file_security - File securi
41 *
42 * This information is populated when opening
43 * tracks the relevant Landlock access rights
44 * of opening the file. Other LSM hooks use th
45 * operations on already opened files.
46 */
47 struct landlock_file_security {
48 /**
49 * @allowed_access: Access rights that
50 * opening the file. This is not neces
51 * rights available at that time, but
52 * needed to authorize later operation
53 */
54 access_mask_t allowed_access;
55 /**
56 * @fown_domain: Domain of the task th
57 * signal e.g., SIGURG when writing MS
58 * This pointer is protected by the re
59 * fown_struct's members: pid, uid, an
60 */
61 struct landlock_ruleset *fown_domain;
62 };
63
64 /**
65 * struct landlock_superblock_security - Super
66 *
67 * Enable hook_sb_delete() to wait for concurr
68 */
69 struct landlock_superblock_security {
70 /**
71 * @inode_refs: Number of pending inod
72 * are being released by release_inode
73 * Cf. struct super_block->s_fsnotify_
74 */
75 atomic_long_t inode_refs;
76 };
77
78 static inline struct landlock_file_security *
79 landlock_file(const struct file *const file)
80 {
81 return file->f_security + landlock_blo
82 }
83
84 static inline struct landlock_inode_security *
85 landlock_inode(const struct inode *const inode
86 {
87 return inode->i_security + landlock_bl
88 }
89
90 static inline struct landlock_superblock_secur
91 landlock_superblock(const struct super_block *
92 {
93 return superblock->s_security + landlo
94 }
95
96 __init void landlock_add_fs_hooks(void);
97
98 int landlock_append_fs_rule(struct landlock_ru
99 const struct path
100 access_mask_t acce
101
102 #endif /* _SECURITY_LANDLOCK_FS_H */
103
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.