1 | /* SPDX-License-Identifier: GPL-2.0 */ |
2 | /* |
3 | * Security server interface. |
4 | * |
5 | * Author : Stephen Smalley, <stephen.smalley.work@gmail.com> |
6 | * |
7 | */ |
8 | |
9 | #ifndef _SELINUX_SECURITY_H_ |
10 | #define _SELINUX_SECURITY_H_ |
11 | |
12 | #include <linux/compiler.h> |
13 | #include <linux/dcache.h> |
14 | #include <linux/magic.h> |
15 | #include <linux/types.h> |
16 | #include <linux/rcupdate.h> |
17 | #include <linux/refcount.h> |
18 | #include <linux/workqueue.h> |
19 | #include <linux/delay.h> |
20 | #include <linux/printk.h> |
21 | #include "flask.h" |
22 | #include "policycap.h" |
23 | |
24 | #define SECSID_NULL 0x00000000 /* unspecified SID */ |
25 | #define SECSID_WILD 0xffffffff /* wildcard SID */ |
26 | #define SECCLASS_NULL 0x0000 /* no class */ |
27 | |
28 | /* Identify specific policy version changes */ |
29 | #define POLICYDB_VERSION_BASE 15 |
30 | #define POLICYDB_VERSION_BOOL 16 |
31 | #define POLICYDB_VERSION_IPV6 17 |
32 | #define POLICYDB_VERSION_NLCLASS 18 |
33 | #define POLICYDB_VERSION_VALIDATETRANS 19 |
34 | #define POLICYDB_VERSION_MLS 19 |
35 | #define POLICYDB_VERSION_AVTAB 20 |
36 | #define POLICYDB_VERSION_RANGETRANS 21 |
37 | #define POLICYDB_VERSION_POLCAP 22 |
38 | #define POLICYDB_VERSION_PERMISSIVE 23 |
39 | #define POLICYDB_VERSION_BOUNDARY 24 |
40 | #define POLICYDB_VERSION_FILENAME_TRANS 25 |
41 | #define POLICYDB_VERSION_ROLETRANS 26 |
42 | #define POLICYDB_VERSION_NEW_OBJECT_DEFAULTS 27 |
43 | #define POLICYDB_VERSION_DEFAULT_TYPE 28 |
44 | #define POLICYDB_VERSION_CONSTRAINT_NAMES 29 |
45 | #define POLICYDB_VERSION_XPERMS_IOCTL 30 |
46 | #define POLICYDB_VERSION_INFINIBAND 31 |
47 | #define POLICYDB_VERSION_GLBLUB 32 |
48 | #define POLICYDB_VERSION_COMP_FTRANS 33 /* compressed filename transitions */ |
49 | |
50 | /* Range of policy versions we understand*/ |
51 | #define POLICYDB_VERSION_MIN POLICYDB_VERSION_BASE |
52 | #define POLICYDB_VERSION_MAX POLICYDB_VERSION_COMP_FTRANS |
53 | |
54 | /* Mask for just the mount related flags */ |
55 | #define SE_MNTMASK 0x0f |
56 | /* Super block security struct flags for mount options */ |
57 | /* BE CAREFUL, these need to be the low order bits for selinux_get_mnt_opts */ |
58 | #define CONTEXT_MNT 0x01 |
59 | #define FSCONTEXT_MNT 0x02 |
60 | #define ROOTCONTEXT_MNT 0x04 |
61 | #define DEFCONTEXT_MNT 0x08 |
62 | #define SBLABEL_MNT 0x10 |
63 | /* Non-mount related flags */ |
64 | #define SE_SBINITIALIZED 0x0100 |
65 | #define SE_SBPROC 0x0200 |
66 | #define SE_SBGENFS 0x0400 |
67 | #define SE_SBGENFS_XATTR 0x0800 |
68 | #define SE_SBNATIVE 0x1000 |
69 | |
70 | #define CONTEXT_STR "context" |
71 | #define FSCONTEXT_STR "fscontext" |
72 | #define ROOTCONTEXT_STR "rootcontext" |
73 | #define DEFCONTEXT_STR "defcontext" |
74 | #define SECLABEL_STR "seclabel" |
75 | |
76 | struct netlbl_lsm_secattr; |
77 | |
78 | extern int selinux_enabled_boot; |
79 | |
80 | /* |
81 | * type_datum properties |
82 | * available at the kernel policy version >= POLICYDB_VERSION_BOUNDARY |
83 | */ |
84 | #define TYPEDATUM_PROPERTY_PRIMARY 0x0001 |
85 | #define TYPEDATUM_PROPERTY_ATTRIBUTE 0x0002 |
86 | |
87 | /* limitation of boundary depth */ |
88 | #define POLICYDB_BOUNDS_MAXDEPTH 4 |
89 | |
90 | struct selinux_policy; |
91 | |
92 | struct selinux_state { |
93 | #ifdef CONFIG_SECURITY_SELINUX_DEVELOP |
94 | bool enforcing; |
95 | #endif |
96 | bool initialized; |
97 | bool policycap[__POLICYDB_CAP_MAX]; |
98 | |
99 | struct page *status_page; |
100 | struct mutex status_lock; |
101 | |
102 | struct selinux_policy __rcu *policy; |
103 | struct mutex policy_mutex; |
104 | } __randomize_layout; |
105 | |
106 | void selinux_avc_init(void); |
107 | |
108 | extern struct selinux_state selinux_state; |
109 | |
110 | static inline bool selinux_initialized(void) |
111 | { |
112 | /* do a synchronized load to avoid race conditions */ |
113 | return smp_load_acquire(&selinux_state.initialized); |
114 | } |
115 | |
116 | static inline void selinux_mark_initialized(void) |
117 | { |
118 | /* do a synchronized write to avoid race conditions */ |
119 | smp_store_release(&selinux_state.initialized, true); |
120 | } |
121 | |
122 | #ifdef CONFIG_SECURITY_SELINUX_DEVELOP |
123 | static inline bool enforcing_enabled(void) |
124 | { |
125 | return READ_ONCE(selinux_state.enforcing); |
126 | } |
127 | |
128 | static inline void enforcing_set(bool value) |
129 | { |
130 | WRITE_ONCE(selinux_state.enforcing, value); |
131 | } |
132 | #else |
133 | static inline bool enforcing_enabled(void) |
134 | { |
135 | return true; |
136 | } |
137 | |
138 | static inline void enforcing_set(bool value) |
139 | { |
140 | } |
141 | #endif |
142 | |
143 | static inline bool checkreqprot_get(void) |
144 | { |
145 | /* non-zero/true checkreqprot values are no longer supported */ |
146 | return 0; |
147 | } |
148 | |
149 | static inline bool selinux_policycap_netpeer(void) |
150 | { |
151 | return READ_ONCE(selinux_state.policycap[POLICYDB_CAP_NETPEER]); |
152 | } |
153 | |
154 | static inline bool selinux_policycap_openperm(void) |
155 | { |
156 | return READ_ONCE(selinux_state.policycap[POLICYDB_CAP_OPENPERM]); |
157 | } |
158 | |
159 | static inline bool selinux_policycap_extsockclass(void) |
160 | { |
161 | return READ_ONCE(selinux_state.policycap[POLICYDB_CAP_EXTSOCKCLASS]); |
162 | } |
163 | |
164 | static inline bool selinux_policycap_alwaysnetwork(void) |
165 | { |
166 | return READ_ONCE(selinux_state.policycap[POLICYDB_CAP_ALWAYSNETWORK]); |
167 | } |
168 | |
169 | static inline bool selinux_policycap_cgroupseclabel(void) |
170 | { |
171 | return READ_ONCE(selinux_state.policycap[POLICYDB_CAP_CGROUPSECLABEL]); |
172 | } |
173 | |
174 | static inline bool selinux_policycap_nnp_nosuid_transition(void) |
175 | { |
176 | return READ_ONCE( |
177 | selinux_state.policycap[POLICYDB_CAP_NNP_NOSUID_TRANSITION]); |
178 | } |
179 | |
180 | static inline bool selinux_policycap_genfs_seclabel_symlinks(void) |
181 | { |
182 | return READ_ONCE( |
183 | selinux_state.policycap[POLICYDB_CAP_GENFS_SECLABEL_SYMLINKS]); |
184 | } |
185 | |
186 | static inline bool selinux_policycap_ioctl_skip_cloexec(void) |
187 | { |
188 | return READ_ONCE( |
189 | selinux_state.policycap[POLICYDB_CAP_IOCTL_SKIP_CLOEXEC]); |
190 | } |
191 | |
192 | static inline bool selinux_policycap_userspace_initial_context(void) |
193 | { |
194 | return READ_ONCE( |
195 | selinux_state.policycap[POLICYDB_CAP_USERSPACE_INITIAL_CONTEXT]); |
196 | } |
197 | |
198 | struct selinux_policy_convert_data; |
199 | |
200 | struct selinux_load_state { |
201 | struct selinux_policy *policy; |
202 | struct selinux_policy_convert_data *convert_data; |
203 | }; |
204 | |
205 | int security_mls_enabled(void); |
206 | int security_load_policy(void *data, size_t len, |
207 | struct selinux_load_state *load_state); |
208 | void selinux_policy_commit(struct selinux_load_state *load_state); |
209 | void selinux_policy_cancel(struct selinux_load_state *load_state); |
210 | int security_read_policy(void **data, size_t *len); |
211 | int security_read_state_kernel(void **data, size_t *len); |
212 | int security_policycap_supported(unsigned int req_cap); |
213 | |
214 | #define SEL_VEC_MAX 32 |
215 | struct av_decision { |
216 | u32 allowed; |
217 | u32 auditallow; |
218 | u32 auditdeny; |
219 | u32 seqno; |
220 | u32 flags; |
221 | }; |
222 | |
223 | #define XPERMS_ALLOWED 1 |
224 | #define XPERMS_AUDITALLOW 2 |
225 | #define XPERMS_DONTAUDIT 4 |
226 | |
227 | #define security_xperm_set(perms, x) ((perms)[(x) >> 5] |= 1 << ((x)&0x1f)) |
228 | #define security_xperm_test(perms, x) (1 & ((perms)[(x) >> 5] >> ((x)&0x1f))) |
229 | struct extended_perms_data { |
230 | u32 p[8]; |
231 | }; |
232 | |
233 | struct extended_perms_decision { |
234 | u8 used; |
235 | u8 driver; |
236 | struct extended_perms_data *allowed; |
237 | struct extended_perms_data *auditallow; |
238 | struct extended_perms_data *dontaudit; |
239 | }; |
240 | |
241 | struct extended_perms { |
242 | u16 len; /* length associated decision chain */ |
243 | struct extended_perms_data drivers; /* flag drivers that are used */ |
244 | }; |
245 | |
246 | /* definitions of av_decision.flags */ |
247 | #define AVD_FLAGS_PERMISSIVE 0x0001 |
248 | |
249 | void security_compute_av(u32 ssid, u32 tsid, u16 tclass, |
250 | struct av_decision *avd, |
251 | struct extended_perms *xperms); |
252 | |
253 | void security_compute_xperms_decision(u32 ssid, u32 tsid, u16 tclass, u8 driver, |
254 | struct extended_perms_decision *xpermd); |
255 | |
256 | void security_compute_av_user(u32 ssid, u32 tsid, u16 tclass, |
257 | struct av_decision *avd); |
258 | |
259 | int security_transition_sid(u32 ssid, u32 tsid, u16 tclass, |
260 | const struct qstr *qstr, u32 *out_sid); |
261 | |
262 | int security_transition_sid_user(u32 ssid, u32 tsid, u16 tclass, |
263 | const char *objname, u32 *out_sid); |
264 | |
265 | int security_member_sid(u32 ssid, u32 tsid, u16 tclass, u32 *out_sid); |
266 | |
267 | int security_change_sid(u32 ssid, u32 tsid, u16 tclass, u32 *out_sid); |
268 | |
269 | int security_sid_to_context(u32 sid, char **scontext, u32 *scontext_len); |
270 | |
271 | int security_sid_to_context_force(u32 sid, char **scontext, u32 *scontext_len); |
272 | |
273 | int security_sid_to_context_inval(u32 sid, char **scontext, u32 *scontext_len); |
274 | |
275 | int security_context_to_sid(const char *scontext, u32 scontext_len, |
276 | u32 *out_sid, gfp_t gfp); |
277 | |
278 | int security_context_str_to_sid(const char *scontext, u32 *out_sid, gfp_t gfp); |
279 | |
280 | int security_context_to_sid_default(const char *scontext, u32 scontext_len, |
281 | u32 *out_sid, u32 def_sid, gfp_t gfp_flags); |
282 | |
283 | int security_context_to_sid_force(const char *scontext, u32 scontext_len, |
284 | u32 *sid); |
285 | |
286 | int security_get_user_sids(u32 callsid, char *username, u32 **sids, u32 *nel); |
287 | |
288 | int security_port_sid(u8 protocol, u16 port, u32 *out_sid); |
289 | |
290 | int security_ib_pkey_sid(u64 subnet_prefix, u16 pkey_num, u32 *out_sid); |
291 | |
292 | int security_ib_endport_sid(const char *dev_name, u8 port_num, u32 *out_sid); |
293 | |
294 | int security_netif_sid(char *name, u32 *if_sid); |
295 | |
296 | int security_node_sid(u16 domain, void *addr, u32 addrlen, u32 *out_sid); |
297 | |
298 | int security_validate_transition(u32 oldsid, u32 newsid, u32 tasksid, |
299 | u16 tclass); |
300 | |
301 | int security_validate_transition_user(u32 oldsid, u32 newsid, u32 tasksid, |
302 | u16 tclass); |
303 | |
304 | int security_bounded_transition(u32 oldsid, u32 newsid); |
305 | |
306 | int security_sid_mls_copy(u32 sid, u32 mls_sid, u32 *new_sid); |
307 | |
308 | int security_net_peersid_resolve(u32 nlbl_sid, u32 nlbl_type, u32 xfrm_sid, |
309 | u32 *peer_sid); |
310 | |
311 | int security_get_classes(struct selinux_policy *policy, char ***classes, |
312 | u32 *nclasses); |
313 | int security_get_permissions(struct selinux_policy *policy, const char *class, |
314 | char ***perms, u32 *nperms); |
315 | int security_get_reject_unknown(void); |
316 | int security_get_allow_unknown(void); |
317 | |
318 | #define SECURITY_FS_USE_XATTR 1 /* use xattr */ |
319 | #define SECURITY_FS_USE_TRANS 2 /* use transition SIDs, e.g. devpts/tmpfs */ |
320 | #define SECURITY_FS_USE_TASK 3 /* use task SIDs, e.g. pipefs/sockfs */ |
321 | #define SECURITY_FS_USE_GENFS 4 /* use the genfs support */ |
322 | #define SECURITY_FS_USE_NONE 5 /* no labeling support */ |
323 | #define SECURITY_FS_USE_MNTPOINT 6 /* use mountpoint labeling */ |
324 | #define SECURITY_FS_USE_NATIVE 7 /* use native label support */ |
325 | #define SECURITY_FS_USE_MAX 7 /* Highest SECURITY_FS_USE_XXX */ |
326 | |
327 | int security_fs_use(struct super_block *sb); |
328 | |
329 | int security_genfs_sid(const char *fstype, const char *path, u16 sclass, |
330 | u32 *sid); |
331 | |
332 | int selinux_policy_genfs_sid(struct selinux_policy *policy, const char *fstype, |
333 | const char *path, u16 sclass, u32 *sid); |
334 | |
335 | #ifdef CONFIG_NETLABEL |
336 | int security_netlbl_secattr_to_sid(struct netlbl_lsm_secattr *secattr, |
337 | u32 *sid); |
338 | |
339 | int security_netlbl_sid_to_secattr(u32 sid, struct netlbl_lsm_secattr *secattr); |
340 | #else |
341 | static inline int |
342 | security_netlbl_secattr_to_sid(struct netlbl_lsm_secattr *secattr, u32 *sid) |
343 | { |
344 | return -EIDRM; |
345 | } |
346 | |
347 | static inline int |
348 | security_netlbl_sid_to_secattr(u32 sid, struct netlbl_lsm_secattr *secattr) |
349 | { |
350 | return -ENOENT; |
351 | } |
352 | #endif /* CONFIG_NETLABEL */ |
353 | |
354 | const char *security_get_initial_sid_context(u32 sid); |
355 | |
356 | /* |
357 | * status notifier using mmap interface |
358 | */ |
359 | extern struct page *selinux_kernel_status_page(void); |
360 | |
361 | #define SELINUX_KERNEL_STATUS_VERSION 1 |
362 | struct selinux_kernel_status { |
363 | u32 version; /* version number of the structure */ |
364 | u32 sequence; /* sequence number of seqlock logic */ |
365 | u32 enforcing; /* current setting of enforcing mode */ |
366 | u32 policyload; /* times of policy reloaded */ |
367 | u32 deny_unknown; /* current setting of deny_unknown */ |
368 | /* |
369 | * The version > 0 supports above members. |
370 | */ |
371 | } __packed; |
372 | |
373 | extern void selinux_status_update_setenforce(bool enforcing); |
374 | extern void selinux_status_update_policyload(u32 seqno); |
375 | extern void selinux_complete_init(void); |
376 | extern struct path selinux_null; |
377 | extern void selnl_notify_setenforce(int val); |
378 | extern void selnl_notify_policyload(u32 seqno); |
379 | extern int selinux_nlmsg_lookup(u16 sclass, u16 nlmsg_type, u32 *perm); |
380 | |
381 | extern void avtab_cache_init(void); |
382 | extern void ebitmap_cache_init(void); |
383 | extern void hashtab_cache_init(void); |
384 | extern int security_sidtab_hash_stats(char *page); |
385 | |
386 | #endif /* _SELINUX_SECURITY_H_ */ |
387 | |