Commit | Line | Data |
---|---|---|
9590837b KT |
1 | /* |
2 | * security/tomoyo/common.h | |
3 | * | |
76bb0895 | 4 | * Header file for TOMOYO. |
9590837b | 5 | * |
76bb0895 | 6 | * Copyright (C) 2005-2010 NTT DATA CORPORATION |
9590837b KT |
7 | */ |
8 | ||
9 | #ifndef _SECURITY_TOMOYO_COMMON_H | |
10 | #define _SECURITY_TOMOYO_COMMON_H | |
11 | ||
12 | #include <linux/ctype.h> | |
13 | #include <linux/string.h> | |
14 | #include <linux/mm.h> | |
15 | #include <linux/file.h> | |
16 | #include <linux/kmod.h> | |
17 | #include <linux/fs.h> | |
18 | #include <linux/sched.h> | |
19 | #include <linux/namei.h> | |
20 | #include <linux/mount.h> | |
21 | #include <linux/list.h> | |
76bb0895 | 22 | #include <linux/cred.h> |
17fcfbd9 | 23 | #include <linux/poll.h> |
76bb0895 TH |
24 | struct linux_binprm; |
25 | ||
26 | /********** Constants definitions. **********/ | |
27 | ||
28 | /* | |
29 | * TOMOYO uses this hash only when appending a string into the string | |
30 | * table. Frequency of appending strings is very low. So we don't need | |
31 | * large (e.g. 64k) hash size. 256 will be sufficient. | |
32 | */ | |
33 | #define TOMOYO_HASH_BITS 8 | |
34 | #define TOMOYO_MAX_HASH (1u<<TOMOYO_HASH_BITS) | |
35 | ||
c8c57e84 | 36 | #define TOMOYO_EXEC_TMPSIZE 4096 |
76bb0895 TH |
37 | |
38 | /* Profile number is an integer between 0 and 255. */ | |
39 | #define TOMOYO_MAX_PROFILES 256 | |
40 | ||
cb0abe6a TH |
41 | enum tomoyo_mode_index { |
42 | TOMOYO_CONFIG_DISABLED, | |
43 | TOMOYO_CONFIG_LEARNING, | |
44 | TOMOYO_CONFIG_PERMISSIVE, | |
57c2590f TH |
45 | TOMOYO_CONFIG_ENFORCING, |
46 | TOMOYO_CONFIG_USE_DEFAULT = 255 | |
cb0abe6a TH |
47 | }; |
48 | ||
76bb0895 | 49 | /* Keywords for ACLs. */ |
1084307c | 50 | #define TOMOYO_KEYWORD_AGGREGATOR "aggregator " |
76bb0895 | 51 | #define TOMOYO_KEYWORD_ALIAS "alias " |
2106ccd9 | 52 | #define TOMOYO_KEYWORD_ALLOW_MOUNT "allow_mount " |
76bb0895 TH |
53 | #define TOMOYO_KEYWORD_ALLOW_READ "allow_read " |
54 | #define TOMOYO_KEYWORD_DELETE "delete " | |
55 | #define TOMOYO_KEYWORD_DENY_REWRITE "deny_rewrite " | |
56 | #define TOMOYO_KEYWORD_FILE_PATTERN "file_pattern " | |
57 | #define TOMOYO_KEYWORD_INITIALIZE_DOMAIN "initialize_domain " | |
58 | #define TOMOYO_KEYWORD_KEEP_DOMAIN "keep_domain " | |
59 | #define TOMOYO_KEYWORD_NO_INITIALIZE_DOMAIN "no_initialize_domain " | |
60 | #define TOMOYO_KEYWORD_NO_KEEP_DOMAIN "no_keep_domain " | |
7762fbff | 61 | #define TOMOYO_KEYWORD_PATH_GROUP "path_group " |
4c3e9e2d | 62 | #define TOMOYO_KEYWORD_NUMBER_GROUP "number_group " |
76bb0895 TH |
63 | #define TOMOYO_KEYWORD_SELECT "select " |
64 | #define TOMOYO_KEYWORD_USE_PROFILE "use_profile " | |
65 | #define TOMOYO_KEYWORD_IGNORE_GLOBAL_ALLOW_READ "ignore_global_allow_read" | |
9b244373 TH |
66 | #define TOMOYO_KEYWORD_QUOTA_EXCEEDED "quota_exceeded" |
67 | #define TOMOYO_KEYWORD_TRANSITION_FAILED "transition_failed" | |
76bb0895 TH |
68 | /* A domain definition starts with <kernel>. */ |
69 | #define TOMOYO_ROOT_NAME "<kernel>" | |
70 | #define TOMOYO_ROOT_NAME_LEN (sizeof(TOMOYO_ROOT_NAME) - 1) | |
71 | ||
4c3e9e2d TH |
72 | /* Value type definition. */ |
73 | #define TOMOYO_VALUE_TYPE_INVALID 0 | |
74 | #define TOMOYO_VALUE_TYPE_DECIMAL 1 | |
75 | #define TOMOYO_VALUE_TYPE_OCTAL 2 | |
76 | #define TOMOYO_VALUE_TYPE_HEXADECIMAL 3 | |
77 | ||
76bb0895 | 78 | /* Index numbers for Access Controls. */ |
084da356 | 79 | enum tomoyo_acl_entry_type_index { |
7ef61233 TH |
80 | TOMOYO_TYPE_PATH_ACL, |
81 | TOMOYO_TYPE_PATH2_ACL, | |
a1f9bb6a TH |
82 | TOMOYO_TYPE_PATH_NUMBER_ACL, |
83 | TOMOYO_TYPE_PATH_NUMBER3_ACL, | |
2106ccd9 | 84 | TOMOYO_TYPE_MOUNT_ACL, |
084da356 | 85 | }; |
76bb0895 TH |
86 | |
87 | /* Index numbers for File Controls. */ | |
88 | ||
89 | /* | |
a1f9bb6a TH |
90 | * TOMOYO_TYPE_READ_WRITE is special. TOMOYO_TYPE_READ_WRITE is automatically |
91 | * set if both TOMOYO_TYPE_READ and TOMOYO_TYPE_WRITE are set. | |
92 | * Both TOMOYO_TYPE_READ and TOMOYO_TYPE_WRITE are automatically set if | |
93 | * TOMOYO_TYPE_READ_WRITE is set. | |
94 | * TOMOYO_TYPE_READ_WRITE is automatically cleared if either TOMOYO_TYPE_READ | |
95 | * or TOMOYO_TYPE_WRITE is cleared. | |
96 | * Both TOMOYO_TYPE_READ and TOMOYO_TYPE_WRITE are automatically cleared if | |
97 | * TOMOYO_TYPE_READ_WRITE is cleared. | |
76bb0895 TH |
98 | */ |
99 | ||
084da356 | 100 | enum tomoyo_path_acl_index { |
7ef61233 TH |
101 | TOMOYO_TYPE_READ_WRITE, |
102 | TOMOYO_TYPE_EXECUTE, | |
103 | TOMOYO_TYPE_READ, | |
104 | TOMOYO_TYPE_WRITE, | |
7ef61233 | 105 | TOMOYO_TYPE_UNLINK, |
7ef61233 | 106 | TOMOYO_TYPE_RMDIR, |
7ef61233 TH |
107 | TOMOYO_TYPE_TRUNCATE, |
108 | TOMOYO_TYPE_SYMLINK, | |
109 | TOMOYO_TYPE_REWRITE, | |
7ef61233 | 110 | TOMOYO_TYPE_CHROOT, |
7ef61233 TH |
111 | TOMOYO_TYPE_UMOUNT, |
112 | TOMOYO_MAX_PATH_OPERATION | |
084da356 TH |
113 | }; |
114 | ||
237ab459 TH |
115 | #define TOMOYO_RW_MASK ((1 << TOMOYO_TYPE_READ) | (1 << TOMOYO_TYPE_WRITE)) |
116 | ||
a1f9bb6a TH |
117 | enum tomoyo_path_number3_acl_index { |
118 | TOMOYO_TYPE_MKBLOCK, | |
119 | TOMOYO_TYPE_MKCHAR, | |
120 | TOMOYO_MAX_PATH_NUMBER3_OPERATION | |
121 | }; | |
122 | ||
084da356 | 123 | enum tomoyo_path2_acl_index { |
7ef61233 TH |
124 | TOMOYO_TYPE_LINK, |
125 | TOMOYO_TYPE_RENAME, | |
126 | TOMOYO_TYPE_PIVOT_ROOT, | |
127 | TOMOYO_MAX_PATH2_OPERATION | |
084da356 TH |
128 | }; |
129 | ||
a1f9bb6a TH |
130 | enum tomoyo_path_number_acl_index { |
131 | TOMOYO_TYPE_CREATE, | |
132 | TOMOYO_TYPE_MKDIR, | |
133 | TOMOYO_TYPE_MKFIFO, | |
134 | TOMOYO_TYPE_MKSOCK, | |
135 | TOMOYO_TYPE_IOCTL, | |
136 | TOMOYO_TYPE_CHMOD, | |
137 | TOMOYO_TYPE_CHOWN, | |
138 | TOMOYO_TYPE_CHGRP, | |
139 | TOMOYO_MAX_PATH_NUMBER_OPERATION | |
140 | }; | |
141 | ||
084da356 TH |
142 | enum tomoyo_securityfs_interface_index { |
143 | TOMOYO_DOMAINPOLICY, | |
144 | TOMOYO_EXCEPTIONPOLICY, | |
145 | TOMOYO_DOMAIN_STATUS, | |
146 | TOMOYO_PROCESS_STATUS, | |
147 | TOMOYO_MEMINFO, | |
148 | TOMOYO_SELFDOMAIN, | |
149 | TOMOYO_VERSION, | |
150 | TOMOYO_PROFILE, | |
17fcfbd9 | 151 | TOMOYO_QUERY, |
084da356 TH |
152 | TOMOYO_MANAGER |
153 | }; | |
9590837b | 154 | |
57c2590f TH |
155 | enum tomoyo_mac_index { |
156 | TOMOYO_MAC_FILE_EXECUTE, | |
157 | TOMOYO_MAC_FILE_OPEN, | |
158 | TOMOYO_MAC_FILE_CREATE, | |
159 | TOMOYO_MAC_FILE_UNLINK, | |
160 | TOMOYO_MAC_FILE_MKDIR, | |
161 | TOMOYO_MAC_FILE_RMDIR, | |
162 | TOMOYO_MAC_FILE_MKFIFO, | |
163 | TOMOYO_MAC_FILE_MKSOCK, | |
164 | TOMOYO_MAC_FILE_TRUNCATE, | |
165 | TOMOYO_MAC_FILE_SYMLINK, | |
166 | TOMOYO_MAC_FILE_REWRITE, | |
167 | TOMOYO_MAC_FILE_MKBLOCK, | |
168 | TOMOYO_MAC_FILE_MKCHAR, | |
169 | TOMOYO_MAC_FILE_LINK, | |
170 | TOMOYO_MAC_FILE_RENAME, | |
171 | TOMOYO_MAC_FILE_CHMOD, | |
172 | TOMOYO_MAC_FILE_CHOWN, | |
173 | TOMOYO_MAC_FILE_CHGRP, | |
174 | TOMOYO_MAC_FILE_IOCTL, | |
175 | TOMOYO_MAC_FILE_CHROOT, | |
176 | TOMOYO_MAC_FILE_MOUNT, | |
177 | TOMOYO_MAC_FILE_UMOUNT, | |
178 | TOMOYO_MAC_FILE_PIVOT_ROOT, | |
179 | TOMOYO_MAX_MAC_INDEX | |
180 | }; | |
181 | ||
182 | enum tomoyo_mac_category_index { | |
183 | TOMOYO_MAC_CATEGORY_FILE, | |
184 | TOMOYO_MAX_MAC_CATEGORY_INDEX | |
185 | }; | |
186 | ||
17fcfbd9 TH |
187 | #define TOMOYO_RETRY_REQUEST 1 /* Retry this request. */ |
188 | ||
76bb0895 | 189 | /********** Structure definitions. **********/ |
9590837b | 190 | |
82e0f001 TH |
191 | /* |
192 | * tomoyo_acl_head is a structure which is used for holding elements not in | |
193 | * domain policy. | |
194 | * It has following fields. | |
195 | * | |
196 | * (1) "list" which is linked to tomoyo_policy_list[] . | |
197 | * (2) "is_deleted" is a bool which is true if marked as deleted, false | |
198 | * otherwise. | |
199 | */ | |
200 | struct tomoyo_acl_head { | |
201 | struct list_head list; | |
202 | bool is_deleted; | |
203 | } __packed; | |
204 | ||
cb0abe6a TH |
205 | /* |
206 | * tomoyo_request_info is a structure which is used for holding | |
207 | * | |
208 | * (1) Domain information of current process. | |
17fcfbd9 TH |
209 | * (2) How many retries are made for this request. |
210 | * (3) Profile number used for this request. | |
211 | * (4) Access control mode of the profile. | |
cb0abe6a TH |
212 | */ |
213 | struct tomoyo_request_info { | |
214 | struct tomoyo_domain_info *domain; | |
cf6e9a64 TH |
215 | /* For holding parameters. */ |
216 | union { | |
217 | struct { | |
218 | const struct tomoyo_path_info *filename; | |
219 | u8 operation; | |
220 | } path; | |
221 | struct { | |
222 | const struct tomoyo_path_info *filename1; | |
223 | const struct tomoyo_path_info *filename2; | |
224 | u8 operation; | |
225 | } path2; | |
226 | struct { | |
227 | const struct tomoyo_path_info *filename; | |
228 | unsigned int mode; | |
229 | unsigned int major; | |
230 | unsigned int minor; | |
231 | u8 operation; | |
232 | } mkdev; | |
233 | struct { | |
234 | const struct tomoyo_path_info *filename; | |
235 | unsigned long number; | |
236 | u8 operation; | |
237 | } path_number; | |
238 | struct { | |
239 | const struct tomoyo_path_info *type; | |
240 | const struct tomoyo_path_info *dir; | |
241 | const struct tomoyo_path_info *dev; | |
242 | unsigned long flags; | |
243 | int need_dev; | |
244 | } mount; | |
245 | } param; | |
246 | u8 param_type; | |
247 | bool granted; | |
17fcfbd9 TH |
248 | u8 retry; |
249 | u8 profile; | |
cb0abe6a | 250 | u8 mode; /* One of tomoyo_mode_index . */ |
57c2590f | 251 | u8 type; |
cb0abe6a TH |
252 | }; |
253 | ||
c3fa109a TH |
254 | /* |
255 | * tomoyo_path_info is a structure which is used for holding a string data | |
256 | * used by TOMOYO. | |
257 | * This structure has several fields for supporting pattern matching. | |
258 | * | |
259 | * (1) "name" is the '\0' terminated string data. | |
260 | * (2) "hash" is full_name_hash(name, strlen(name)). | |
261 | * This allows tomoyo_pathcmp() to compare by hash before actually compare | |
262 | * using strcmp(). | |
263 | * (3) "const_len" is the length of the initial segment of "name" which | |
264 | * consists entirely of non wildcard characters. In other words, the length | |
265 | * which we can compare two strings using strncmp(). | |
266 | * (4) "is_dir" is a bool which is true if "name" ends with "/", | |
267 | * false otherwise. | |
268 | * TOMOYO distinguishes directory and non-directory. A directory ends with | |
269 | * "/" and non-directory does not end with "/". | |
270 | * (5) "is_patterned" is a bool which is true if "name" contains wildcard | |
271 | * characters, false otherwise. This allows TOMOYO to use "hash" and | |
272 | * strcmp() for string comparison if "is_patterned" is false. | |
c3fa109a | 273 | */ |
9590837b KT |
274 | struct tomoyo_path_info { |
275 | const char *name; | |
276 | u32 hash; /* = full_name_hash(name, strlen(name)) */ | |
9590837b KT |
277 | u16 const_len; /* = tomoyo_const_part_length(name) */ |
278 | bool is_dir; /* = tomoyo_strendswith(name, "/") */ | |
279 | bool is_patterned; /* = tomoyo_path_contains_pattern(name) */ | |
9590837b KT |
280 | }; |
281 | ||
282 | /* | |
76bb0895 TH |
283 | * tomoyo_name_entry is a structure which is used for linking |
284 | * "struct tomoyo_path_info" into tomoyo_name_list . | |
9590837b | 285 | */ |
76bb0895 TH |
286 | struct tomoyo_name_entry { |
287 | struct list_head list; | |
288 | atomic_t users; | |
289 | struct tomoyo_path_info entry; | |
290 | }; | |
9590837b | 291 | |
7762fbff TH |
292 | struct tomoyo_name_union { |
293 | const struct tomoyo_path_info *filename; | |
294 | struct tomoyo_path_group *group; | |
295 | u8 is_group; | |
296 | }; | |
297 | ||
4c3e9e2d TH |
298 | struct tomoyo_number_union { |
299 | unsigned long values[2]; | |
300 | struct tomoyo_number_group *group; | |
301 | u8 min_type; | |
302 | u8 max_type; | |
303 | u8 is_group; | |
304 | }; | |
305 | ||
7762fbff TH |
306 | /* Structure for "path_group" directive. */ |
307 | struct tomoyo_path_group { | |
308 | struct list_head list; | |
309 | const struct tomoyo_path_info *group_name; | |
310 | struct list_head member_list; | |
311 | atomic_t users; | |
312 | }; | |
313 | ||
4c3e9e2d TH |
314 | /* Structure for "number_group" directive. */ |
315 | struct tomoyo_number_group { | |
316 | struct list_head list; | |
317 | const struct tomoyo_path_info *group_name; | |
318 | struct list_head member_list; | |
319 | atomic_t users; | |
320 | }; | |
321 | ||
7762fbff TH |
322 | /* Structure for "path_group" directive. */ |
323 | struct tomoyo_path_group_member { | |
82e0f001 | 324 | struct tomoyo_acl_head head; |
7762fbff TH |
325 | const struct tomoyo_path_info *member_name; |
326 | }; | |
327 | ||
4c3e9e2d TH |
328 | /* Structure for "number_group" directive. */ |
329 | struct tomoyo_number_group_member { | |
82e0f001 | 330 | struct tomoyo_acl_head head; |
4c3e9e2d TH |
331 | struct tomoyo_number_union number; |
332 | }; | |
333 | ||
9590837b | 334 | /* |
c3fa109a TH |
335 | * tomoyo_acl_info is a structure which is used for holding |
336 | * | |
337 | * (1) "list" which is linked to the ->acl_info_list of | |
338 | * "struct tomoyo_domain_info" | |
237ab459 TH |
339 | * (2) "is_deleted" is a bool which is true if this domain is marked as |
340 | * "deleted", false otherwise. | |
341 | * (3) "type" which tells type of the entry. | |
9590837b KT |
342 | * |
343 | * Packing "struct tomoyo_acl_info" allows | |
237ab459 TH |
344 | * "struct tomoyo_path_acl" to embed "u16" and "struct tomoyo_path2_acl" |
345 | * "struct tomoyo_path_number_acl" "struct tomoyo_path_number3_acl" to embed | |
346 | * "u8" without enlarging their structure size. | |
9590837b KT |
347 | */ |
348 | struct tomoyo_acl_info { | |
349 | struct list_head list; | |
237ab459 TH |
350 | bool is_deleted; |
351 | u8 type; /* = one of values in "enum tomoyo_acl_entry_type_index". */ | |
9590837b KT |
352 | } __packed; |
353 | ||
c3fa109a TH |
354 | /* |
355 | * tomoyo_domain_info is a structure which is used for holding permissions | |
356 | * (e.g. "allow_read /lib/libc-2.5.so") given to each domain. | |
357 | * It has following fields. | |
358 | * | |
359 | * (1) "list" which is linked to tomoyo_domain_list . | |
360 | * (2) "acl_info_list" which is linked to "struct tomoyo_acl_info". | |
361 | * (3) "domainname" which holds the name of the domain. | |
362 | * (4) "profile" which remembers profile number assigned to this domain. | |
363 | * (5) "is_deleted" is a bool which is true if this domain is marked as | |
364 | * "deleted", false otherwise. | |
365 | * (6) "quota_warned" is a bool which is used for suppressing warning message | |
366 | * when learning mode learned too much entries. | |
ea13ddba TH |
367 | * (7) "ignore_global_allow_read" is a bool which is true if this domain |
368 | * should ignore "allow_read" directive in exception policy. | |
369 | * (8) "transition_failed" is a bool which is set to true when this domain was | |
370 | * unable to create a new domain at tomoyo_find_next_domain() because the | |
371 | * name of the domain to be created was too long or it could not allocate | |
372 | * memory. If set to true, more than one process continued execve() | |
373 | * without domain transition. | |
ec8e6a4e TH |
374 | * (9) "users" is an atomic_t that holds how many "struct cred"->security |
375 | * are referring this "struct tomoyo_domain_info". If is_deleted == true | |
376 | * and users == 0, this struct will be kfree()d upon next garbage | |
377 | * collection. | |
c3fa109a TH |
378 | * |
379 | * A domain's lifecycle is an analogy of files on / directory. | |
380 | * Multiple domains with the same domainname cannot be created (as with | |
381 | * creating files with the same filename fails with -EEXIST). | |
382 | * If a process reached a domain, that process can reside in that domain after | |
383 | * that domain is marked as "deleted" (as with a process can access an already | |
384 | * open()ed file after that file was unlink()ed). | |
385 | */ | |
9590837b KT |
386 | struct tomoyo_domain_info { |
387 | struct list_head list; | |
388 | struct list_head acl_info_list; | |
389 | /* Name of this domain. Never NULL. */ | |
390 | const struct tomoyo_path_info *domainname; | |
391 | u8 profile; /* Profile number to use. */ | |
a0558fc3 | 392 | bool is_deleted; /* Delete flag. */ |
9590837b | 393 | bool quota_warned; /* Quota warnning flag. */ |
ea13ddba TH |
394 | bool ignore_global_allow_read; /* Ignore "allow_read" flag. */ |
395 | bool transition_failed; /* Domain transition failed flag. */ | |
ec8e6a4e | 396 | atomic_t users; /* Number of referring credentials. */ |
9590837b KT |
397 | }; |
398 | ||
9590837b | 399 | /* |
7ef61233 | 400 | * tomoyo_path_acl is a structure which is used for holding an |
c3fa109a TH |
401 | * entry with one pathname operation (e.g. open(), mkdir()). |
402 | * It has following fields. | |
403 | * | |
404 | * (1) "head" which is a "struct tomoyo_acl_info". | |
405 | * (2) "perm" which is a bitmask of permitted operations. | |
7762fbff | 406 | * (3) "name" is the pathname. |
c3fa109a TH |
407 | * |
408 | * Directives held by this structure are "allow_read/write", "allow_execute", | |
a1f9bb6a | 409 | * "allow_read", "allow_write", "allow_unlink", "allow_rmdir", |
2106ccd9 TH |
410 | * "allow_truncate", "allow_symlink", "allow_rewrite", "allow_chroot" and |
411 | * "allow_unmount". | |
9590837b | 412 | */ |
7ef61233 TH |
413 | struct tomoyo_path_acl { |
414 | struct tomoyo_acl_info head; /* type = TOMOYO_TYPE_PATH_ACL */ | |
9590837b | 415 | u16 perm; |
7762fbff | 416 | struct tomoyo_name_union name; |
9590837b KT |
417 | }; |
418 | ||
a1f9bb6a TH |
419 | /* |
420 | * tomoyo_path_number_acl is a structure which is used for holding an | |
421 | * entry with one pathname and one number operation. | |
422 | * It has following fields. | |
423 | * | |
424 | * (1) "head" which is a "struct tomoyo_acl_info". | |
425 | * (2) "perm" which is a bitmask of permitted operations. | |
426 | * (3) "name" is the pathname. | |
427 | * (4) "number" is the numeric value. | |
428 | * | |
429 | * Directives held by this structure are "allow_create", "allow_mkdir", | |
430 | * "allow_ioctl", "allow_mkfifo", "allow_mksock", "allow_chmod", "allow_chown" | |
431 | * and "allow_chgrp". | |
432 | * | |
433 | */ | |
434 | struct tomoyo_path_number_acl { | |
435 | struct tomoyo_acl_info head; /* type = TOMOYO_TYPE_PATH_NUMBER_ACL */ | |
436 | u8 perm; | |
437 | struct tomoyo_name_union name; | |
438 | struct tomoyo_number_union number; | |
439 | }; | |
440 | ||
441 | /* | |
442 | * tomoyo_path_number3_acl is a structure which is used for holding an | |
443 | * entry with one pathname and three numbers operation. | |
444 | * It has following fields. | |
445 | * | |
446 | * (1) "head" which is a "struct tomoyo_acl_info". | |
447 | * (2) "perm" which is a bitmask of permitted operations. | |
448 | * (3) "mode" is the create mode. | |
449 | * (4) "major" is the major number of device node. | |
450 | * (5) "minor" is the minor number of device node. | |
451 | * | |
452 | * Directives held by this structure are "allow_mkchar", "allow_mkblock". | |
453 | * | |
454 | */ | |
455 | struct tomoyo_path_number3_acl { | |
456 | struct tomoyo_acl_info head; /* type = TOMOYO_TYPE_PATH_NUMBER3_ACL */ | |
457 | u8 perm; | |
458 | struct tomoyo_name_union name; | |
459 | struct tomoyo_number_union mode; | |
460 | struct tomoyo_number_union major; | |
461 | struct tomoyo_number_union minor; | |
462 | }; | |
463 | ||
c3fa109a | 464 | /* |
7ef61233 | 465 | * tomoyo_path2_acl is a structure which is used for holding an |
937bf613 | 466 | * entry with two pathnames operation (i.e. link(), rename() and pivot_root()). |
c3fa109a TH |
467 | * It has following fields. |
468 | * | |
469 | * (1) "head" which is a "struct tomoyo_acl_info". | |
470 | * (2) "perm" which is a bitmask of permitted operations. | |
7762fbff TH |
471 | * (3) "name1" is the source/old pathname. |
472 | * (4) "name2" is the destination/new pathname. | |
c3fa109a | 473 | * |
937bf613 TH |
474 | * Directives held by this structure are "allow_rename", "allow_link" and |
475 | * "allow_pivot_root". | |
c3fa109a | 476 | */ |
7ef61233 TH |
477 | struct tomoyo_path2_acl { |
478 | struct tomoyo_acl_info head; /* type = TOMOYO_TYPE_PATH2_ACL */ | |
9590837b | 479 | u8 perm; |
7762fbff TH |
480 | struct tomoyo_name_union name1; |
481 | struct tomoyo_name_union name2; | |
9590837b KT |
482 | }; |
483 | ||
2106ccd9 TH |
484 | /* |
485 | * tomoyo_mount_acl is a structure which is used for holding an | |
486 | * entry for mount operation. | |
487 | * It has following fields. | |
488 | * | |
489 | * (1) "head" which is a "struct tomoyo_acl_info". | |
237ab459 TH |
490 | * (2) "dev_name" is the device name. |
491 | * (3) "dir_name" is the mount point. | |
492 | * (4) "fs_type" is the filesystem type. | |
2106ccd9 TH |
493 | * (5) "flags" is the mount flags. |
494 | * | |
237ab459 | 495 | * Directive held by this structure is "allow_mount". |
2106ccd9 TH |
496 | */ |
497 | struct tomoyo_mount_acl { | |
498 | struct tomoyo_acl_info head; /* type = TOMOYO_TYPE_MOUNT_ACL */ | |
2106ccd9 TH |
499 | struct tomoyo_name_union dev_name; |
500 | struct tomoyo_name_union dir_name; | |
501 | struct tomoyo_name_union fs_type; | |
502 | struct tomoyo_number_union flags; | |
503 | }; | |
504 | ||
c3fa109a TH |
505 | /* |
506 | * tomoyo_io_buffer is a structure which is used for reading and modifying | |
507 | * configuration via /sys/kernel/security/tomoyo/ interface. | |
508 | * It has many fields. ->read_var1 , ->read_var2 , ->write_var1 are used as | |
509 | * cursors. | |
510 | * | |
511 | * Since the content of /sys/kernel/security/tomoyo/domain_policy is a list of | |
512 | * "struct tomoyo_domain_info" entries and each "struct tomoyo_domain_info" | |
513 | * entry has a list of "struct tomoyo_acl_info", we need two cursors when | |
514 | * reading (one is for traversing tomoyo_domain_list and the other is for | |
515 | * traversing "struct tomoyo_acl_info"->acl_info_list ). | |
516 | * | |
517 | * If a line written to /sys/kernel/security/tomoyo/domain_policy starts with | |
518 | * "select ", TOMOYO seeks the cursor ->read_var1 and ->write_var1 to the | |
519 | * domain with the domainname specified by the rest of that line (NULL is set | |
520 | * if seek failed). | |
521 | * If a line written to /sys/kernel/security/tomoyo/domain_policy starts with | |
522 | * "delete ", TOMOYO deletes an entry or a domain specified by the rest of that | |
523 | * line (->write_var1 is set to NULL if a domain was deleted). | |
524 | * If a line written to /sys/kernel/security/tomoyo/domain_policy starts with | |
525 | * neither "select " nor "delete ", an entry or a domain specified by that line | |
526 | * is appended. | |
527 | */ | |
9590837b KT |
528 | struct tomoyo_io_buffer { |
529 | int (*read) (struct tomoyo_io_buffer *); | |
530 | int (*write) (struct tomoyo_io_buffer *); | |
17fcfbd9 | 531 | int (*poll) (struct file *file, poll_table *wait); |
9590837b KT |
532 | /* Exclusive lock for this structure. */ |
533 | struct mutex io_sem; | |
fdb8ebb7 TH |
534 | /* Index returned by tomoyo_read_lock(). */ |
535 | int reader_idx; | |
9590837b KT |
536 | /* The position currently reading from. */ |
537 | struct list_head *read_var1; | |
538 | /* Extra variables for reading. */ | |
539 | struct list_head *read_var2; | |
540 | /* The position currently writing to. */ | |
541 | struct tomoyo_domain_info *write_var1; | |
542 | /* The step for reading. */ | |
543 | int read_step; | |
544 | /* Buffer for reading. */ | |
545 | char *read_buf; | |
546 | /* EOF flag for reading. */ | |
547 | bool read_eof; | |
548 | /* Read domain ACL of specified PID? */ | |
549 | bool read_single_domain; | |
550 | /* Extra variable for reading. */ | |
551 | u8 read_bit; | |
552 | /* Bytes available for reading. */ | |
553 | int read_avail; | |
554 | /* Size of read buffer. */ | |
555 | int readbuf_size; | |
556 | /* Buffer for writing. */ | |
557 | char *write_buf; | |
558 | /* Bytes available for writing. */ | |
559 | int write_avail; | |
560 | /* Size of write buffer. */ | |
561 | int writebuf_size; | |
17fcfbd9 TH |
562 | /* Type of this interface. */ |
563 | u8 type; | |
9590837b KT |
564 | }; |
565 | ||
76bb0895 TH |
566 | /* |
567 | * tomoyo_globally_readable_file_entry is a structure which is used for holding | |
568 | * "allow_read" entries. | |
569 | * It has following fields. | |
570 | * | |
82e0f001 | 571 | * (1) "head" is "struct tomoyo_acl_head". |
76bb0895 | 572 | * (2) "filename" is a pathname which is allowed to open(O_RDONLY). |
76bb0895 TH |
573 | */ |
574 | struct tomoyo_globally_readable_file_entry { | |
82e0f001 | 575 | struct tomoyo_acl_head head; |
76bb0895 | 576 | const struct tomoyo_path_info *filename; |
76bb0895 TH |
577 | }; |
578 | ||
579 | /* | |
580 | * tomoyo_pattern_entry is a structure which is used for holding | |
581 | * "tomoyo_pattern_list" entries. | |
582 | * It has following fields. | |
583 | * | |
82e0f001 | 584 | * (1) "head" is "struct tomoyo_acl_head". |
76bb0895 TH |
585 | * (2) "pattern" is a pathname pattern which is used for converting pathnames |
586 | * to pathname patterns during learning mode. | |
76bb0895 TH |
587 | */ |
588 | struct tomoyo_pattern_entry { | |
82e0f001 | 589 | struct tomoyo_acl_head head; |
76bb0895 | 590 | const struct tomoyo_path_info *pattern; |
76bb0895 TH |
591 | }; |
592 | ||
593 | /* | |
594 | * tomoyo_no_rewrite_entry is a structure which is used for holding | |
595 | * "deny_rewrite" entries. | |
596 | * It has following fields. | |
597 | * | |
82e0f001 | 598 | * (1) "head" is "struct tomoyo_acl_head". |
76bb0895 TH |
599 | * (2) "pattern" is a pathname which is by default not permitted to modify |
600 | * already existing content. | |
76bb0895 TH |
601 | */ |
602 | struct tomoyo_no_rewrite_entry { | |
82e0f001 | 603 | struct tomoyo_acl_head head; |
76bb0895 | 604 | const struct tomoyo_path_info *pattern; |
76bb0895 TH |
605 | }; |
606 | ||
607 | /* | |
608 | * tomoyo_domain_initializer_entry is a structure which is used for holding | |
609 | * "initialize_domain" and "no_initialize_domain" entries. | |
610 | * It has following fields. | |
611 | * | |
82e0f001 TH |
612 | * (1) "head" is "struct tomoyo_acl_head". |
613 | * (2) "is_not" is a bool which is true if "no_initialize_domain", false | |
76bb0895 | 614 | * otherwise. |
82e0f001 | 615 | * (3) "is_last_name" is a bool which is true if "domainname" is "the last |
76bb0895 | 616 | * component of a domainname", false otherwise. |
82e0f001 TH |
617 | * (4) "domainname" which is "a domainname" or "the last component of a |
618 | * domainname". This field is NULL if "from" clause is not specified. | |
619 | * (5) "program" which is a program's pathname. | |
76bb0895 TH |
620 | */ |
621 | struct tomoyo_domain_initializer_entry { | |
82e0f001 | 622 | struct tomoyo_acl_head head; |
76bb0895 TH |
623 | bool is_not; /* True if this entry is "no_initialize_domain". */ |
624 | /* True if the domainname is tomoyo_get_last_name(). */ | |
625 | bool is_last_name; | |
82e0f001 TH |
626 | const struct tomoyo_path_info *domainname; /* This may be NULL */ |
627 | const struct tomoyo_path_info *program; | |
76bb0895 TH |
628 | }; |
629 | ||
630 | /* | |
631 | * tomoyo_domain_keeper_entry is a structure which is used for holding | |
632 | * "keep_domain" and "no_keep_domain" entries. | |
633 | * It has following fields. | |
634 | * | |
82e0f001 TH |
635 | * (1) "head" is "struct tomoyo_acl_head". |
636 | * (2) "is_not" is a bool which is true if "no_initialize_domain", false | |
76bb0895 | 637 | * otherwise. |
82e0f001 | 638 | * (3) "is_last_name" is a bool which is true if "domainname" is "the last |
76bb0895 | 639 | * component of a domainname", false otherwise. |
82e0f001 TH |
640 | * (4) "domainname" which is "a domainname" or "the last component of a |
641 | * domainname". | |
642 | * (5) "program" which is a program's pathname. | |
643 | * This field is NULL if "from" clause is not specified. | |
76bb0895 TH |
644 | */ |
645 | struct tomoyo_domain_keeper_entry { | |
82e0f001 | 646 | struct tomoyo_acl_head head; |
76bb0895 TH |
647 | bool is_not; /* True if this entry is "no_keep_domain". */ |
648 | /* True if the domainname is tomoyo_get_last_name(). */ | |
649 | bool is_last_name; | |
82e0f001 TH |
650 | const struct tomoyo_path_info *domainname; |
651 | const struct tomoyo_path_info *program; /* This may be NULL */ | |
76bb0895 TH |
652 | }; |
653 | ||
1084307c TH |
654 | /* |
655 | * tomoyo_aggregator_entry is a structure which is used for holding | |
656 | * "aggregator" entries. | |
657 | * It has following fields. | |
658 | * | |
82e0f001 | 659 | * (1) "head" is "struct tomoyo_acl_head". |
1084307c TH |
660 | * (2) "original_name" which is originally requested name. |
661 | * (3) "aggregated_name" which is name to rewrite. | |
1084307c TH |
662 | */ |
663 | struct tomoyo_aggregator_entry { | |
82e0f001 | 664 | struct tomoyo_acl_head head; |
1084307c TH |
665 | const struct tomoyo_path_info *original_name; |
666 | const struct tomoyo_path_info *aggregated_name; | |
1084307c TH |
667 | }; |
668 | ||
76bb0895 TH |
669 | /* |
670 | * tomoyo_alias_entry is a structure which is used for holding "alias" entries. | |
671 | * It has following fields. | |
672 | * | |
82e0f001 | 673 | * (1) "head" is "struct tomoyo_acl_head". |
76bb0895 TH |
674 | * (2) "original_name" which is a dereferenced pathname. |
675 | * (3) "aliased_name" which is a symlink's pathname. | |
76bb0895 TH |
676 | */ |
677 | struct tomoyo_alias_entry { | |
82e0f001 | 678 | struct tomoyo_acl_head head; |
76bb0895 TH |
679 | const struct tomoyo_path_info *original_name; |
680 | const struct tomoyo_path_info *aliased_name; | |
76bb0895 TH |
681 | }; |
682 | ||
683 | /* | |
684 | * tomoyo_policy_manager_entry is a structure which is used for holding list of | |
685 | * domainnames or programs which are permitted to modify configuration via | |
686 | * /sys/kernel/security/tomoyo/ interface. | |
687 | * It has following fields. | |
688 | * | |
82e0f001 TH |
689 | * (1) "head" is "struct tomoyo_acl_head". |
690 | * (2) "is_domain" is a bool which is true if "manager" is a domainname, false | |
76bb0895 | 691 | * otherwise. |
82e0f001 | 692 | * (3) "manager" is a domainname or a program's pathname. |
76bb0895 TH |
693 | */ |
694 | struct tomoyo_policy_manager_entry { | |
82e0f001 TH |
695 | struct tomoyo_acl_head head; |
696 | bool is_domain; /* True if manager is a domainname. */ | |
76bb0895 TH |
697 | /* A path to program or a domainname. */ |
698 | const struct tomoyo_path_info *manager; | |
76bb0895 TH |
699 | }; |
700 | ||
57c2590f TH |
701 | struct tomoyo_preference { |
702 | unsigned int learning_max_entry; | |
703 | bool enforcing_verbose; | |
704 | bool learning_verbose; | |
705 | bool permissive_verbose; | |
706 | }; | |
707 | ||
708 | struct tomoyo_profile { | |
709 | const struct tomoyo_path_info *comment; | |
710 | struct tomoyo_preference *learning; | |
711 | struct tomoyo_preference *permissive; | |
712 | struct tomoyo_preference *enforcing; | |
713 | struct tomoyo_preference preference; | |
714 | u8 default_config; | |
715 | u8 config[TOMOYO_MAX_MAC_INDEX + TOMOYO_MAX_MAC_CATEGORY_INDEX]; | |
716 | }; | |
717 | ||
76bb0895 TH |
718 | /********** Function prototypes. **********/ |
719 | ||
17fcfbd9 TH |
720 | extern asmlinkage long sys_getpid(void); |
721 | extern asmlinkage long sys_getppid(void); | |
722 | ||
c3ef1500 TH |
723 | /* Check whether the given string starts with the given keyword. */ |
724 | bool tomoyo_str_starts(char **src, const char *find); | |
725 | /* Get tomoyo_realpath() of current process. */ | |
726 | const char *tomoyo_get_exe(void); | |
727 | /* Format string. */ | |
728 | void tomoyo_normalize_line(unsigned char *buffer); | |
729 | /* Print warning or error message on console. */ | |
730 | void tomoyo_warn_log(struct tomoyo_request_info *r, const char *fmt, ...) | |
731 | __attribute__ ((format(printf, 2, 3))); | |
732 | /* Check all profiles currently assigned to domains are defined. */ | |
733 | void tomoyo_check_profile(void); | |
734 | /* Open operation for /sys/kernel/security/tomoyo/ interface. */ | |
735 | int tomoyo_open_control(const u8 type, struct file *file); | |
736 | /* Close /sys/kernel/security/tomoyo/ interface. */ | |
737 | int tomoyo_close_control(struct file *file); | |
738 | /* Read operation for /sys/kernel/security/tomoyo/ interface. */ | |
739 | int tomoyo_read_control(struct file *file, char __user *buffer, | |
740 | const int buffer_len); | |
741 | /* Write operation for /sys/kernel/security/tomoyo/ interface. */ | |
742 | int tomoyo_write_control(struct file *file, const char __user *buffer, | |
743 | const int buffer_len); | |
744 | /* Check whether the domain has too many ACL entries to hold. */ | |
745 | bool tomoyo_domain_quota_is_ok(struct tomoyo_request_info *r); | |
746 | /* Print out of memory warning message. */ | |
747 | void tomoyo_warn_oom(const char *function); | |
7762fbff TH |
748 | /* Check whether the given name matches the given name_union. */ |
749 | bool tomoyo_compare_name_union(const struct tomoyo_path_info *name, | |
750 | const struct tomoyo_name_union *ptr); | |
2106ccd9 TH |
751 | /* Check whether the given number matches the given number_union. */ |
752 | bool tomoyo_compare_number_union(const unsigned long value, | |
753 | const struct tomoyo_number_union *ptr); | |
57c2590f | 754 | int tomoyo_get_mode(const u8 profile, const u8 index); |
9590837b KT |
755 | /* Transactional sprintf() for policy dump. */ |
756 | bool tomoyo_io_printf(struct tomoyo_io_buffer *head, const char *fmt, ...) | |
757 | __attribute__ ((format(printf, 2, 3))); | |
758 | /* Check whether the domainname is correct. */ | |
17080008 | 759 | bool tomoyo_is_correct_domain(const unsigned char *domainname); |
9590837b | 760 | /* Check whether the token is correct. */ |
3f629636 TH |
761 | bool tomoyo_is_correct_path(const char *filename); |
762 | bool tomoyo_is_correct_word(const char *string); | |
9590837b KT |
763 | /* Check whether the token can be a domainname. */ |
764 | bool tomoyo_is_domain_def(const unsigned char *buffer); | |
7762fbff TH |
765 | bool tomoyo_parse_name_union(const char *filename, |
766 | struct tomoyo_name_union *ptr); | |
767 | /* Check whether the given filename matches the given path_group. */ | |
768 | bool tomoyo_path_matches_group(const struct tomoyo_path_info *pathname, | |
3f629636 | 769 | const struct tomoyo_path_group *group); |
4c3e9e2d TH |
770 | /* Check whether the given value matches the given number_group. */ |
771 | bool tomoyo_number_matches_group(const unsigned long min, | |
772 | const unsigned long max, | |
773 | const struct tomoyo_number_group *group); | |
9590837b KT |
774 | /* Check whether the given filename matches the given pattern. */ |
775 | bool tomoyo_path_matches_pattern(const struct tomoyo_path_info *filename, | |
776 | const struct tomoyo_path_info *pattern); | |
4c3e9e2d TH |
777 | |
778 | bool tomoyo_print_number_union(struct tomoyo_io_buffer *head, | |
779 | const struct tomoyo_number_union *ptr); | |
780 | bool tomoyo_parse_number_union(char *data, struct tomoyo_number_union *num); | |
781 | ||
1084307c TH |
782 | /* Read "aggregator" entry in exception policy. */ |
783 | bool tomoyo_read_aggregator_policy(struct tomoyo_io_buffer *head); | |
9590837b KT |
784 | /* Read "alias" entry in exception policy. */ |
785 | bool tomoyo_read_alias_policy(struct tomoyo_io_buffer *head); | |
786 | /* | |
787 | * Read "initialize_domain" and "no_initialize_domain" entry | |
788 | * in exception policy. | |
789 | */ | |
790 | bool tomoyo_read_domain_initializer_policy(struct tomoyo_io_buffer *head); | |
791 | /* Read "keep_domain" and "no_keep_domain" entry in exception policy. */ | |
792 | bool tomoyo_read_domain_keeper_policy(struct tomoyo_io_buffer *head); | |
793 | /* Read "file_pattern" entry in exception policy. */ | |
794 | bool tomoyo_read_file_pattern(struct tomoyo_io_buffer *head); | |
7762fbff TH |
795 | /* Read "path_group" entry in exception policy. */ |
796 | bool tomoyo_read_path_group_policy(struct tomoyo_io_buffer *head); | |
4c3e9e2d TH |
797 | /* Read "number_group" entry in exception policy. */ |
798 | bool tomoyo_read_number_group_policy(struct tomoyo_io_buffer *head); | |
9590837b KT |
799 | /* Read "allow_read" entry in exception policy. */ |
800 | bool tomoyo_read_globally_readable_policy(struct tomoyo_io_buffer *head); | |
801 | /* Read "deny_rewrite" entry in exception policy. */ | |
802 | bool tomoyo_read_no_rewrite_policy(struct tomoyo_io_buffer *head); | |
7762fbff TH |
803 | /* Tokenize a line. */ |
804 | bool tomoyo_tokenize(char *buffer, char *w[], size_t size); | |
9590837b KT |
805 | /* Write domain policy violation warning message to console? */ |
806 | bool tomoyo_verbose_mode(const struct tomoyo_domain_info *domain); | |
807 | /* Convert double path operation to operation name. */ | |
7ef61233 | 808 | const char *tomoyo_path22keyword(const u8 operation); |
a1f9bb6a TH |
809 | const char *tomoyo_path_number2keyword(const u8 operation); |
810 | const char *tomoyo_path_number32keyword(const u8 operation); | |
9590837b KT |
811 | /* Get the last component of the given domainname. */ |
812 | const char *tomoyo_get_last_name(const struct tomoyo_domain_info *domain); | |
9590837b | 813 | /* Convert single path operation to operation name. */ |
7ef61233 | 814 | const char *tomoyo_path2keyword(const u8 operation); |
2106ccd9 TH |
815 | /* Fill "struct tomoyo_request_info". */ |
816 | int tomoyo_init_request_info(struct tomoyo_request_info *r, | |
57c2590f TH |
817 | struct tomoyo_domain_info *domain, |
818 | const u8 index); | |
2106ccd9 TH |
819 | /* Check permission for mount operation. */ |
820 | int tomoyo_mount_permission(char *dev_name, struct path *path, char *type, | |
821 | unsigned long flags, void *data_page); | |
1084307c TH |
822 | /* Create "aggregator" entry in exception policy. */ |
823 | int tomoyo_write_aggregator_policy(char *data, const bool is_delete); | |
9590837b KT |
824 | /* Create "alias" entry in exception policy. */ |
825 | int tomoyo_write_alias_policy(char *data, const bool is_delete); | |
826 | /* | |
827 | * Create "initialize_domain" and "no_initialize_domain" entry | |
828 | * in exception policy. | |
829 | */ | |
830 | int tomoyo_write_domain_initializer_policy(char *data, const bool is_not, | |
831 | const bool is_delete); | |
832 | /* Create "keep_domain" and "no_keep_domain" entry in exception policy. */ | |
833 | int tomoyo_write_domain_keeper_policy(char *data, const bool is_not, | |
834 | const bool is_delete); | |
835 | /* | |
836 | * Create "allow_read/write", "allow_execute", "allow_read", "allow_write", | |
837 | * "allow_create", "allow_unlink", "allow_mkdir", "allow_rmdir", | |
838 | * "allow_mkfifo", "allow_mksock", "allow_mkblock", "allow_mkchar", | |
839 | * "allow_truncate", "allow_symlink", "allow_rewrite", "allow_rename" and | |
840 | * "allow_link" entry in domain policy. | |
841 | */ | |
842 | int tomoyo_write_file_policy(char *data, struct tomoyo_domain_info *domain, | |
843 | const bool is_delete); | |
844 | /* Create "allow_read" entry in exception policy. */ | |
845 | int tomoyo_write_globally_readable_policy(char *data, const bool is_delete); | |
2106ccd9 TH |
846 | /* Create "allow_mount" entry in domain policy. */ |
847 | int tomoyo_write_mount_policy(char *data, struct tomoyo_domain_info *domain, | |
848 | const bool is_delete); | |
9590837b KT |
849 | /* Create "deny_rewrite" entry in exception policy. */ |
850 | int tomoyo_write_no_rewrite_policy(char *data, const bool is_delete); | |
851 | /* Create "file_pattern" entry in exception policy. */ | |
852 | int tomoyo_write_pattern_policy(char *data, const bool is_delete); | |
7762fbff TH |
853 | /* Create "path_group" entry in exception policy. */ |
854 | int tomoyo_write_path_group_policy(char *data, const bool is_delete); | |
17fcfbd9 TH |
855 | int tomoyo_supervisor(struct tomoyo_request_info *r, const char *fmt, ...) |
856 | __attribute__ ((format(printf, 2, 3))); | |
4c3e9e2d TH |
857 | /* Create "number_group" entry in exception policy. */ |
858 | int tomoyo_write_number_group_policy(char *data, const bool is_delete); | |
9590837b KT |
859 | /* Find a domain by the given name. */ |
860 | struct tomoyo_domain_info *tomoyo_find_domain(const char *domainname); | |
861 | /* Find or create a domain by the given name. */ | |
862 | struct tomoyo_domain_info *tomoyo_find_or_assign_new_domain(const char * | |
863 | domainname, | |
864 | const u8 profile); | |
57c2590f | 865 | struct tomoyo_profile *tomoyo_profile(const u8 profile); |
7762fbff TH |
866 | /* Allocate memory for "struct tomoyo_path_group". */ |
867 | struct tomoyo_path_group *tomoyo_get_path_group(const char *group_name); | |
4c3e9e2d | 868 | struct tomoyo_number_group *tomoyo_get_number_group(const char *group_name); |
7762fbff | 869 | |
9590837b KT |
870 | /* Check mode for specified functionality. */ |
871 | unsigned int tomoyo_check_flags(const struct tomoyo_domain_info *domain, | |
872 | const u8 index); | |
9590837b KT |
873 | /* Fill in "struct tomoyo_path_info" members. */ |
874 | void tomoyo_fill_path_info(struct tomoyo_path_info *ptr); | |
875 | /* Run policy loader when /sbin/init starts. */ | |
876 | void tomoyo_load_policy(const char *filename); | |
9590837b | 877 | |
4c3e9e2d TH |
878 | void tomoyo_put_number_union(struct tomoyo_number_union *ptr); |
879 | ||
76bb0895 | 880 | /* Convert binary string to ascii string. */ |
c8c57e84 | 881 | char *tomoyo_encode(const char *str); |
76bb0895 TH |
882 | |
883 | /* | |
884 | * Returns realpath(3) of the given pathname but ignores chroot'ed root. | |
885 | * These functions use kzalloc(), so the caller must call kfree() | |
886 | * if these functions didn't return NULL. | |
887 | */ | |
888 | char *tomoyo_realpath(const char *pathname); | |
889 | /* | |
890 | * Same with tomoyo_realpath() except that it doesn't follow the final symlink. | |
891 | */ | |
892 | char *tomoyo_realpath_nofollow(const char *pathname); | |
893 | /* Same with tomoyo_realpath() except that the pathname is already solved. */ | |
894 | char *tomoyo_realpath_from_path(struct path *path); | |
17fcfbd9 TH |
895 | /* Get patterned pathname. */ |
896 | const char *tomoyo_file_pattern(const struct tomoyo_path_info *filename); | |
76bb0895 TH |
897 | |
898 | /* Check memory quota. */ | |
899 | bool tomoyo_memory_ok(void *ptr); | |
9e4b50e9 | 900 | void *tomoyo_commit_ok(void *data, const unsigned int size); |
76bb0895 TH |
901 | |
902 | /* | |
903 | * Keep the given name on the RAM. | |
904 | * The RAM is shared, so NEVER try to modify or kfree() the returned name. | |
905 | */ | |
906 | const struct tomoyo_path_info *tomoyo_get_name(const char *name); | |
907 | ||
908 | /* Check for memory usage. */ | |
909 | int tomoyo_read_memory_counter(struct tomoyo_io_buffer *head); | |
910 | ||
911 | /* Set memory quota. */ | |
912 | int tomoyo_write_memory_quota(struct tomoyo_io_buffer *head); | |
913 | ||
c3ef1500 TH |
914 | /* Initialize mm related code. */ |
915 | void __init tomoyo_mm_init(void); | |
05336dee | 916 | int tomoyo_path_permission(struct tomoyo_request_info *r, u8 operation, |
76bb0895 TH |
917 | const struct tomoyo_path_info *filename); |
918 | int tomoyo_check_open_permission(struct tomoyo_domain_info *domain, | |
919 | struct path *path, const int flag); | |
a1f9bb6a TH |
920 | int tomoyo_path_number_perm(const u8 operation, struct path *path, |
921 | unsigned long number); | |
922 | int tomoyo_path_number3_perm(const u8 operation, struct path *path, | |
923 | const unsigned int mode, unsigned int dev); | |
97d6931e TH |
924 | int tomoyo_path_perm(const u8 operation, struct path *path); |
925 | int tomoyo_path2_perm(const u8 operation, struct path *path1, | |
926 | struct path *path2); | |
76bb0895 TH |
927 | int tomoyo_find_next_domain(struct linux_binprm *bprm); |
928 | ||
a1f9bb6a TH |
929 | void tomoyo_print_ulong(char *buffer, const int buffer_len, |
930 | const unsigned long value, const u8 type); | |
931 | ||
7762fbff TH |
932 | /* Drop refcount on tomoyo_name_union. */ |
933 | void tomoyo_put_name_union(struct tomoyo_name_union *ptr); | |
934 | ||
847b173e TH |
935 | /* Run garbage collector. */ |
936 | void tomoyo_run_gc(void); | |
937 | ||
938 | void tomoyo_memory_free(void *ptr); | |
939 | ||
237ab459 TH |
940 | int tomoyo_update_domain(struct tomoyo_acl_info *new_entry, const int size, |
941 | bool is_delete, struct tomoyo_domain_info *domain, | |
942 | bool (*check_duplicate) (const struct tomoyo_acl_info | |
943 | *, | |
944 | const struct tomoyo_acl_info | |
945 | *), | |
946 | bool (*merge_duplicate) (struct tomoyo_acl_info *, | |
947 | struct tomoyo_acl_info *, | |
948 | const bool)); | |
36f5e1ff TH |
949 | int tomoyo_update_policy(struct tomoyo_acl_head *new_entry, const int size, |
950 | bool is_delete, struct list_head *list, | |
951 | bool (*check_duplicate) (const struct tomoyo_acl_head | |
952 | *, | |
953 | const struct tomoyo_acl_head | |
954 | *)); | |
99a85259 TH |
955 | void tomoyo_check_acl(struct tomoyo_request_info *r, |
956 | bool (*check_entry) (const struct tomoyo_request_info *, | |
957 | const struct tomoyo_acl_info *)); | |
237ab459 | 958 | |
76bb0895 TH |
959 | /********** External variable definitions. **********/ |
960 | ||
961 | /* Lock for GC. */ | |
962 | extern struct srcu_struct tomoyo_ss; | |
963 | ||
964 | /* The list for "struct tomoyo_domain_info". */ | |
965 | extern struct list_head tomoyo_domain_list; | |
966 | ||
7762fbff | 967 | extern struct list_head tomoyo_path_group_list; |
4c3e9e2d | 968 | extern struct list_head tomoyo_number_group_list; |
847b173e TH |
969 | extern struct list_head tomoyo_domain_initializer_list; |
970 | extern struct list_head tomoyo_domain_keeper_list; | |
1084307c | 971 | extern struct list_head tomoyo_aggregator_list; |
847b173e TH |
972 | extern struct list_head tomoyo_alias_list; |
973 | extern struct list_head tomoyo_globally_readable_list; | |
974 | extern struct list_head tomoyo_pattern_list; | |
975 | extern struct list_head tomoyo_no_rewrite_list; | |
976 | extern struct list_head tomoyo_policy_manager_list; | |
977 | extern struct list_head tomoyo_name_list[TOMOYO_MAX_HASH]; | |
847b173e | 978 | |
76bb0895 TH |
979 | /* Lock for protecting policy. */ |
980 | extern struct mutex tomoyo_policy_lock; | |
981 | ||
982 | /* Has /sbin/init started? */ | |
983 | extern bool tomoyo_policy_loaded; | |
984 | ||
985 | /* The kernel's domain. */ | |
986 | extern struct tomoyo_domain_info tomoyo_kernel_domain; | |
987 | ||
17fcfbd9 TH |
988 | extern unsigned int tomoyo_quota_for_query; |
989 | extern unsigned int tomoyo_query_memory_size; | |
990 | ||
76bb0895 TH |
991 | /********** Inlined functions. **********/ |
992 | ||
993 | static inline int tomoyo_read_lock(void) | |
994 | { | |
995 | return srcu_read_lock(&tomoyo_ss); | |
996 | } | |
997 | ||
998 | static inline void tomoyo_read_unlock(int idx) | |
999 | { | |
1000 | srcu_read_unlock(&tomoyo_ss, idx); | |
1001 | } | |
1002 | ||
9590837b KT |
1003 | /* strcmp() for "struct tomoyo_path_info" structure. */ |
1004 | static inline bool tomoyo_pathcmp(const struct tomoyo_path_info *a, | |
1005 | const struct tomoyo_path_info *b) | |
1006 | { | |
1007 | return a->hash != b->hash || strcmp(a->name, b->name); | |
1008 | } | |
1009 | ||
9590837b KT |
1010 | /** |
1011 | * tomoyo_is_valid - Check whether the character is a valid char. | |
1012 | * | |
1013 | * @c: The character to check. | |
1014 | * | |
1015 | * Returns true if @c is a valid character, false otherwise. | |
1016 | */ | |
1017 | static inline bool tomoyo_is_valid(const unsigned char c) | |
1018 | { | |
1019 | return c > ' ' && c < 127; | |
1020 | } | |
1021 | ||
1022 | /** | |
1023 | * tomoyo_is_invalid - Check whether the character is an invalid char. | |
1024 | * | |
1025 | * @c: The character to check. | |
1026 | * | |
1027 | * Returns true if @c is an invalid character, false otherwise. | |
1028 | */ | |
1029 | static inline bool tomoyo_is_invalid(const unsigned char c) | |
1030 | { | |
1031 | return c && (c <= ' ' || c >= 127); | |
1032 | } | |
1033 | ||
76bb0895 TH |
1034 | static inline void tomoyo_put_name(const struct tomoyo_path_info *name) |
1035 | { | |
1036 | if (name) { | |
1037 | struct tomoyo_name_entry *ptr = | |
1038 | container_of(name, struct tomoyo_name_entry, entry); | |
1039 | atomic_dec(&ptr->users); | |
1040 | } | |
1041 | } | |
9590837b | 1042 | |
7762fbff TH |
1043 | static inline void tomoyo_put_path_group(struct tomoyo_path_group *group) |
1044 | { | |
1045 | if (group) | |
1046 | atomic_dec(&group->users); | |
1047 | } | |
1048 | ||
4c3e9e2d TH |
1049 | static inline void tomoyo_put_number_group(struct tomoyo_number_group *group) |
1050 | { | |
1051 | if (group) | |
1052 | atomic_dec(&group->users); | |
1053 | } | |
1054 | ||
76bb0895 TH |
1055 | static inline struct tomoyo_domain_info *tomoyo_domain(void) |
1056 | { | |
1057 | return current_cred()->security; | |
1058 | } | |
9590837b | 1059 | |
76bb0895 TH |
1060 | static inline struct tomoyo_domain_info *tomoyo_real_domain(struct task_struct |
1061 | *task) | |
1062 | { | |
1063 | return task_cred_xxx(task, security); | |
1064 | } | |
9590837b | 1065 | |
7762fbff TH |
1066 | static inline bool tomoyo_is_same_acl_head(const struct tomoyo_acl_info *p1, |
1067 | const struct tomoyo_acl_info *p2) | |
1068 | { | |
1069 | return p1->type == p2->type; | |
1070 | } | |
1071 | ||
1072 | static inline bool tomoyo_is_same_name_union | |
1073 | (const struct tomoyo_name_union *p1, const struct tomoyo_name_union *p2) | |
1074 | { | |
1075 | return p1->filename == p2->filename && p1->group == p2->group && | |
1076 | p1->is_group == p2->is_group; | |
1077 | } | |
1078 | ||
4c3e9e2d TH |
1079 | static inline bool tomoyo_is_same_number_union |
1080 | (const struct tomoyo_number_union *p1, const struct tomoyo_number_union *p2) | |
1081 | { | |
1082 | return p1->values[0] == p2->values[0] && p1->values[1] == p2->values[1] | |
1083 | && p1->group == p2->group && p1->min_type == p2->min_type && | |
1084 | p1->max_type == p2->max_type && p1->is_group == p2->is_group; | |
1085 | } | |
1086 | ||
9590837b KT |
1087 | /** |
1088 | * list_for_each_cookie - iterate over a list with cookie. | |
1089 | * @pos: the &struct list_head to use as a loop cursor. | |
1090 | * @cookie: the &struct list_head to use as a cookie. | |
1091 | * @head: the head for your list. | |
1092 | * | |
fdb8ebb7 | 1093 | * Same with list_for_each_rcu() except that this primitive uses @cookie |
9590837b KT |
1094 | * so that we can continue iteration. |
1095 | * @cookie must be NULL when iteration starts, and @cookie will become | |
1096 | * NULL when iteration finishes. | |
1097 | */ | |
fdb8ebb7 TH |
1098 | #define list_for_each_cookie(pos, cookie, head) \ |
1099 | for (({ if (!cookie) \ | |
1100 | cookie = head; }), \ | |
1101 | pos = rcu_dereference((cookie)->next); \ | |
1102 | prefetch(pos->next), pos != (head) || ((cookie) = NULL); \ | |
1103 | (cookie) = pos, pos = rcu_dereference(pos->next)) | |
1104 | ||
9590837b | 1105 | #endif /* !defined(_SECURITY_TOMOYO_COMMON_H) */ |