2 * AppArmor security module
4 * This file contains AppArmor /sys/kernel/security/apparmor interface functions
6 * Copyright (C) 1998-2008 Novell/SUSE
7 * Copyright 2009-2010 Canonical Ltd.
9 * This program is free software; you can redistribute it and/or
10 * modify it under the terms of the GNU General Public License as
11 * published by the Free Software Foundation, version 2 of the
15 #include <linux/ctype.h>
16 #include <linux/security.h>
17 #include <linux/vmalloc.h>
18 #include <linux/module.h>
19 #include <linux/seq_file.h>
20 #include <linux/uaccess.h>
21 #include <linux/mount.h>
22 #include <linux/namei.h>
23 #include <linux/capability.h>
24 #include <linux/rcupdate.h>
26 #include <linux/poll.h>
27 #include <uapi/linux/major.h>
28 #include <uapi/linux/magic.h>
30 #include "include/apparmor.h"
31 #include "include/apparmorfs.h"
32 #include "include/audit.h"
33 #include "include/context.h"
34 #include "include/crypto.h"
35 #include "include/ipc.h"
36 #include "include/policy_ns.h"
37 #include "include/label.h"
38 #include "include/policy.h"
39 #include "include/policy_ns.h"
40 #include "include/resource.h"
41 #include "include/policy_unpack.h"
44 * The apparmor filesystem interface used for policy load and introspection
45 * The interface is split into two main components based on their function
46 * a securityfs component:
47 * used for static files that are always available, and which allows
48 * userspace to specificy the location of the security filesystem.
50 * fns and data are prefixed with
53 * an apparmorfs component:
54 * used loaded policy content and introspection. It is not part of a
55 * regular mounted filesystem and is available only through the magic
56 * policy symlink in the root of the securityfs apparmor/ directory.
57 * Tasks queries will be magically redirected to the correct portion
58 * of the policy tree based on their confinement.
60 * fns and data are prefixed with
63 * The aa_fs_ prefix is used to indicate the fn is used by both the
64 * securityfs and apparmorfs filesystems.
73 * aa_mangle_name - mangle a profile name to std profile layout form
74 * @name: profile name to mangle (NOT NULL)
75 * @target: buffer to store mangled name, same length as @name (MAYBE NULL)
77 * Returns: length of mangled name
79 static int mangle_name(const char *name
, char *target
)
83 while (*name
== '/' || *name
== '.')
87 for (; *name
; name
++) {
90 else if (isspace(*name
))
92 else if (isalnum(*name
) || strchr("._-", *name
))
99 for (; *name
; name
++) {
100 if (isalnum(*name
) || isspace(*name
) ||
101 strchr("/._-", *name
))
113 * aafs - core fns and data for the policy tree
116 #define AAFS_NAME "apparmorfs"
117 static struct vfsmount
*aafs_mnt
;
118 static int aafs_count
;
121 static int aafs_show_path(struct seq_file
*seq
, struct dentry
*dentry
)
123 struct inode
*inode
= d_inode(dentry
);
125 seq_printf(seq
, "%s:[%lu]", AAFS_NAME
, inode
->i_ino
);
129 static void aafs_evict_inode(struct inode
*inode
)
131 truncate_inode_pages_final(&inode
->i_data
);
133 if (S_ISLNK(inode
->i_mode
))
134 kfree(inode
->i_link
);
137 static const struct super_operations aafs_super_ops
= {
138 .statfs
= simple_statfs
,
139 .evict_inode
= aafs_evict_inode
,
140 .show_path
= aafs_show_path
,
143 static int fill_super(struct super_block
*sb
, void *data
, int silent
)
145 static struct tree_descr files
[] = { {""} };
148 error
= simple_fill_super(sb
, AAFS_MAGIC
, files
);
151 sb
->s_op
= &aafs_super_ops
;
156 static struct dentry
*aafs_mount(struct file_system_type
*fs_type
,
157 int flags
, const char *dev_name
, void *data
)
159 return mount_single(fs_type
, flags
, data
, fill_super
);
162 static struct file_system_type aafs_ops
= {
163 .owner
= THIS_MODULE
,
166 .kill_sb
= kill_anon_super
,
170 * __aafs_setup_d_inode - basic inode setup for apparmorfs
171 * @dir: parent directory for the dentry
172 * @dentry: dentry we are seting the inode up for
173 * @mode: permissions the file should have
174 * @data: data to store on inode.i_private, available in open()
175 * @link: if symlink, symlink target string
176 * @fops: struct file_operations that should be used
177 * @iops: struct of inode_operations that should be used
179 static int __aafs_setup_d_inode(struct inode
*dir
, struct dentry
*dentry
,
180 umode_t mode
, void *data
, char *link
,
181 const struct file_operations
*fops
,
182 const struct inode_operations
*iops
)
184 struct inode
*inode
= new_inode(dir
->i_sb
);
192 inode
->i_ino
= get_next_ino();
193 inode
->i_mode
= mode
;
194 inode
->i_atime
= inode
->i_mtime
= inode
->i_ctime
= current_time(inode
);
195 inode
->i_private
= data
;
197 inode
->i_op
= iops
? iops
: &simple_dir_inode_operations
;
198 inode
->i_fop
= &simple_dir_operations
;
201 } else if (S_ISLNK(mode
)) {
202 inode
->i_op
= iops
? iops
: &simple_symlink_inode_operations
;
203 inode
->i_link
= link
;
207 d_instantiate(dentry
, inode
);
214 * aafs_create - create a dentry in the apparmorfs filesystem
216 * @name: name of dentry to create
217 * @mode: permissions the file should have
218 * @parent: parent directory for this dentry
219 * @data: data to store on inode.i_private, available in open()
220 * @link: if symlink, symlink target string
221 * @fops: struct file_operations that should be used for
222 * @iops: struct of inode_operations that should be used
224 * This is the basic "create a xxx" function for apparmorfs.
226 * Returns a pointer to a dentry if it succeeds, that must be free with
227 * aafs_remove(). Will return ERR_PTR on failure.
229 static struct dentry
*aafs_create(const char *name
, umode_t mode
,
230 struct dentry
*parent
, void *data
, void *link
,
231 const struct file_operations
*fops
,
232 const struct inode_operations
*iops
)
234 struct dentry
*dentry
;
241 if (!(mode
& S_IFMT
))
242 mode
= (mode
& S_IALLUGO
) | S_IFREG
;
244 error
= simple_pin_fs(&aafs_ops
, &aafs_mnt
, &aafs_count
);
246 return ERR_PTR(error
);
248 dir
= d_inode(parent
);
251 dentry
= lookup_one_len(name
, parent
, strlen(name
));
252 if (IS_ERR(dentry
)) {
253 error
= PTR_ERR(dentry
);
257 if (d_really_is_positive(dentry
)) {
262 error
= __aafs_setup_d_inode(dir
, dentry
, mode
, data
, link
, fops
, iops
);
274 simple_release_fs(&aafs_mnt
, &aafs_count
);
276 return ERR_PTR(error
);
280 * aafs_create_file - create a file in the apparmorfs filesystem
282 * @name: name of dentry to create
283 * @mode: permissions the file should have
284 * @parent: parent directory for this dentry
285 * @data: data to store on inode.i_private, available in open()
286 * @fops: struct file_operations that should be used for
290 static struct dentry
*aafs_create_file(const char *name
, umode_t mode
,
291 struct dentry
*parent
, void *data
,
292 const struct file_operations
*fops
)
294 return aafs_create(name
, mode
, parent
, data
, NULL
, fops
, NULL
);
298 * aafs_create_dir - create a directory in the apparmorfs filesystem
300 * @name: name of dentry to create
301 * @parent: parent directory for this dentry
305 static struct dentry
*aafs_create_dir(const char *name
, struct dentry
*parent
)
307 return aafs_create(name
, S_IFDIR
| 0755, parent
, NULL
, NULL
, NULL
,
312 * aafs_create_symlink - create a symlink in the apparmorfs filesystem
313 * @name: name of dentry to create
314 * @parent: parent directory for this dentry
315 * @target: if symlink, symlink target string
316 * @iops: struct of inode_operations that should be used
318 * If @target parameter is %NULL, then the @iops parameter needs to be
319 * setup to handle .readlink and .get_link inode_operations.
321 static struct dentry
*aafs_create_symlink(const char *name
,
322 struct dentry
*parent
,
324 const struct inode_operations
*iops
)
330 link
= kstrdup(target
, GFP_KERNEL
);
332 return ERR_PTR(-ENOMEM
);
334 dent
= aafs_create(name
, S_IFLNK
| 0444, parent
, NULL
, link
, NULL
,
343 * aafs_remove - removes a file or directory from the apparmorfs filesystem
345 * @dentry: dentry of the file/directory/symlink to removed.
347 static void aafs_remove(struct dentry
*dentry
)
351 if (!dentry
|| IS_ERR(dentry
))
354 dir
= d_inode(dentry
->d_parent
);
356 if (simple_positive(dentry
)) {
357 if (d_is_dir(dentry
))
358 simple_rmdir(dir
, dentry
);
360 simple_unlink(dir
, dentry
);
364 simple_release_fs(&aafs_mnt
, &aafs_count
);
369 * aa_fs - policy load/replace/remove
373 * aa_simple_write_to_buffer - common routine for getting policy from user
374 * @userbuf: user buffer to copy data from (NOT NULL)
375 * @alloc_size: size of user buffer (REQUIRES: @alloc_size >= @copy_size)
376 * @copy_size: size of data to copy from user buffer
377 * @pos: position write is at in the file (NOT NULL)
379 * Returns: kernel buffer containing copy of user buffer data or an
380 * ERR_PTR on failure.
382 static struct aa_loaddata
*aa_simple_write_to_buffer(const char __user
*userbuf
,
387 struct aa_loaddata
*data
;
389 AA_BUG(copy_size
> alloc_size
);
392 /* only writes from pos 0, that is complete writes */
393 return ERR_PTR(-ESPIPE
);
395 /* freed by caller to simple_write_to_buffer */
396 data
= aa_loaddata_alloc(alloc_size
);
400 data
->size
= copy_size
;
401 if (copy_from_user(data
->data
, userbuf
, copy_size
)) {
403 return ERR_PTR(-EFAULT
);
409 static ssize_t
policy_update(u32 mask
, const char __user
*buf
, size_t size
,
410 loff_t
*pos
, struct aa_ns
*ns
)
412 struct aa_loaddata
*data
;
413 struct aa_label
*label
;
416 label
= begin_current_label_crit_section();
418 /* high level check about policy management - fine grained in
421 error
= aa_may_manage_policy(label
, ns
, mask
);
425 data
= aa_simple_write_to_buffer(buf
, size
, size
, pos
);
426 error
= PTR_ERR(data
);
428 error
= aa_replace_profiles(ns
, label
, mask
, data
);
429 aa_put_loaddata(data
);
431 end_current_label_crit_section(label
);
436 /* .load file hook fn to load policy */
437 static ssize_t
profile_load(struct file
*f
, const char __user
*buf
, size_t size
,
440 struct aa_ns
*ns
= aa_get_ns(f
->f_inode
->i_private
);
441 int error
= policy_update(AA_MAY_LOAD_POLICY
, buf
, size
, pos
, ns
);
448 static const struct file_operations aa_fs_profile_load
= {
449 .write
= profile_load
,
450 .llseek
= default_llseek
,
453 /* .replace file hook fn to load and/or replace policy */
454 static ssize_t
profile_replace(struct file
*f
, const char __user
*buf
,
455 size_t size
, loff_t
*pos
)
457 struct aa_ns
*ns
= aa_get_ns(f
->f_inode
->i_private
);
458 int error
= policy_update(AA_MAY_LOAD_POLICY
| AA_MAY_REPLACE_POLICY
,
465 static const struct file_operations aa_fs_profile_replace
= {
466 .write
= profile_replace
,
467 .llseek
= default_llseek
,
470 /* .remove file hook fn to remove loaded policy */
471 static ssize_t
profile_remove(struct file
*f
, const char __user
*buf
,
472 size_t size
, loff_t
*pos
)
474 struct aa_loaddata
*data
;
475 struct aa_label
*label
;
477 struct aa_ns
*ns
= aa_get_ns(f
->f_inode
->i_private
);
479 label
= begin_current_label_crit_section();
480 /* high level check about policy management - fine grained in
483 error
= aa_may_manage_policy(label
, ns
, AA_MAY_REMOVE_POLICY
);
488 * aa_remove_profile needs a null terminated string so 1 extra
489 * byte is allocated and the copied data is null terminated.
491 data
= aa_simple_write_to_buffer(buf
, size
+ 1, size
, pos
);
493 error
= PTR_ERR(data
);
495 data
->data
[size
] = 0;
496 error
= aa_remove_profiles(ns
, label
, data
->data
, size
);
497 aa_put_loaddata(data
);
500 end_current_label_crit_section(label
);
505 static const struct file_operations aa_fs_profile_remove
= {
506 .write
= profile_remove
,
507 .llseek
= default_llseek
,
515 /* revision file hook fn for policy loads */
516 static int ns_revision_release(struct inode
*inode
, struct file
*file
)
518 struct aa_revision
*rev
= file
->private_data
;
528 static ssize_t
ns_revision_read(struct file
*file
, char __user
*buf
,
529 size_t size
, loff_t
*ppos
)
531 struct aa_revision
*rev
= file
->private_data
;
536 mutex_lock_nested(&rev
->ns
->lock
, rev
->ns
->level
);
537 last_read
= rev
->last_read
;
538 if (last_read
== rev
->ns
->revision
) {
539 mutex_unlock(&rev
->ns
->lock
);
540 if (file
->f_flags
& O_NONBLOCK
)
542 if (wait_event_interruptible(rev
->ns
->wait
,
544 READ_ONCE(rev
->ns
->revision
)))
546 mutex_lock_nested(&rev
->ns
->lock
, rev
->ns
->level
);
549 avail
= sprintf(buffer
, "%ld\n", rev
->ns
->revision
);
550 if (*ppos
+ size
> avail
) {
551 rev
->last_read
= rev
->ns
->revision
;
554 mutex_unlock(&rev
->ns
->lock
);
556 return simple_read_from_buffer(buf
, size
, ppos
, buffer
, avail
);
559 static int ns_revision_open(struct inode
*inode
, struct file
*file
)
561 struct aa_revision
*rev
= kzalloc(sizeof(*rev
), GFP_KERNEL
);
566 rev
->ns
= aa_get_ns(inode
->i_private
);
568 rev
->ns
= aa_get_current_ns();
569 file
->private_data
= rev
;
574 static unsigned int ns_revision_poll(struct file
*file
, poll_table
*pt
)
576 struct aa_revision
*rev
= file
->private_data
;
577 unsigned int mask
= 0;
580 mutex_lock_nested(&rev
->ns
->lock
, rev
->ns
->level
);
581 poll_wait(file
, &rev
->ns
->wait
, pt
);
582 if (rev
->last_read
< rev
->ns
->revision
)
583 mask
|= POLLIN
| POLLRDNORM
;
584 mutex_unlock(&rev
->ns
->lock
);
590 void __aa_bump_ns_revision(struct aa_ns
*ns
)
593 wake_up_interruptible(&ns
->wait
);
596 static const struct file_operations aa_fs_ns_revision_fops
= {
597 .owner
= THIS_MODULE
,
598 .open
= ns_revision_open
,
599 .poll
= ns_revision_poll
,
600 .read
= ns_revision_read
,
601 .llseek
= generic_file_llseek
,
602 .release
= ns_revision_release
,
605 static void profile_query_cb(struct aa_profile
*profile
, struct aa_perms
*perms
,
606 const char *match_str
, size_t match_len
)
610 unsigned int state
= 0;
612 if (profile_unconfined(profile
))
614 if (profile
->file
.dfa
&& *match_str
== AA_CLASS_FILE
) {
615 dfa
= profile
->file
.dfa
;
616 state
= aa_dfa_match_len(dfa
, profile
->file
.start
,
617 match_str
+ 1, match_len
- 1);
620 struct path_cond cond
= { };
622 tmp
= aa_compute_fperms(dfa
, state
, &cond
);
624 } else if (profile
->policy
.dfa
) {
625 if (!PROFILE_MEDIATES_SAFE(profile
, *match_str
))
626 return; /* no change to current perms */
627 dfa
= profile
->policy
.dfa
;
628 state
= aa_dfa_match_len(dfa
, profile
->policy
.start
[0],
629 match_str
, match_len
);
631 aa_compute_perms(dfa
, state
, &tmp
);
635 aa_apply_modes_to_perms(profile
, &tmp
);
636 aa_perms_accum_raw(perms
, &tmp
);
641 * query_data - queries a policy and writes its data to buf
642 * @buf: the resulting data is stored here (NOT NULL)
643 * @buf_len: size of buf
644 * @query: query string used to retrieve data
645 * @query_len: size of query including second NUL byte
647 * The buffers pointed to by buf and query may overlap. The query buffer is
648 * parsed before buf is written to.
650 * The query should look like "<LABEL>\0<KEY>\0", where <LABEL> is the name of
651 * the security confinement context and <KEY> is the name of the data to
652 * retrieve. <LABEL> and <KEY> must not be NUL-terminated.
654 * Don't expect the contents of buf to be preserved on failure.
656 * Returns: number of characters written to buf or -errno on failure
658 static ssize_t
query_data(char *buf
, size_t buf_len
,
659 char *query
, size_t query_len
)
664 struct aa_label
*label
, *curr
;
665 struct aa_profile
*profile
;
666 struct aa_data
*data
;
671 return -EINVAL
; /* need a query */
673 key
= query
+ strnlen(query
, query_len
) + 1;
674 if (key
+ 1 >= query
+ query_len
)
675 return -EINVAL
; /* not enough space for a non-empty key */
676 if (key
+ strnlen(key
, query
+ query_len
- key
) >= query
+ query_len
)
677 return -EINVAL
; /* must end with NUL */
679 if (buf_len
< sizeof(bytes
) + sizeof(blocks
))
680 return -EINVAL
; /* not enough space */
682 curr
= begin_current_label_crit_section();
683 label
= aa_label_parse(curr
, query
, GFP_KERNEL
, false, false);
684 end_current_label_crit_section(curr
);
686 return PTR_ERR(label
);
688 /* We are going to leave space for two numbers. The first is the total
689 * number of bytes we are writing after the first number. This is so
690 * users can read the full output without reallocation.
692 * The second number is the number of data blocks we're writing. An
693 * application might be confined by multiple policies having data in
696 memset(buf
, 0, sizeof(bytes
) + sizeof(blocks
));
697 out
= buf
+ sizeof(bytes
) + sizeof(blocks
);
700 label_for_each_confined(i
, label
, profile
) {
704 data
= rhashtable_lookup_fast(profile
->data
, &key
,
708 if (out
+ sizeof(outle32
) + data
->size
> buf
+
711 return -EINVAL
; /* not enough space */
713 outle32
= __cpu_to_le32(data
->size
);
714 memcpy(out
, &outle32
, sizeof(outle32
));
715 out
+= sizeof(outle32
);
716 memcpy(out
, data
->data
, data
->size
);
723 outle32
= __cpu_to_le32(out
- buf
- sizeof(bytes
));
724 memcpy(buf
, &outle32
, sizeof(outle32
));
725 outle32
= __cpu_to_le32(blocks
);
726 memcpy(buf
+ sizeof(bytes
), &outle32
, sizeof(outle32
));
732 * query_label - queries a label and writes permissions to buf
733 * @buf: the resulting permissions string is stored here (NOT NULL)
734 * @buf_len: size of buf
735 * @query: binary query string to match against the dfa
736 * @query_len: size of query
737 * @view_only: only compute for querier's view
739 * The buffers pointed to by buf and query may overlap. The query buffer is
740 * parsed before buf is written to.
742 * The query should look like "LABEL_NAME\0DFA_STRING" where LABEL_NAME is
743 * the name of the label, in the current namespace, that is to be queried and
744 * DFA_STRING is a binary string to match against the label(s)'s DFA.
746 * LABEL_NAME must be NUL terminated. DFA_STRING may contain NUL characters
747 * but must *not* be NUL terminated.
749 * Returns: number of characters written to buf or -errno on failure
751 static ssize_t
query_label(char *buf
, size_t buf_len
,
752 char *query
, size_t query_len
, bool view_only
)
754 struct aa_profile
*profile
;
755 struct aa_label
*label
, *curr
;
756 char *label_name
, *match_str
;
757 size_t label_name_len
, match_len
;
758 struct aa_perms perms
;
765 label_name_len
= strnlen(query
, query_len
);
766 if (!label_name_len
|| label_name_len
== query_len
)
770 * The extra byte is to account for the null byte between the
771 * profile name and dfa string. profile_name_len is greater
772 * than zero and less than query_len, so a byte can be safely
773 * added or subtracted.
775 match_str
= label_name
+ label_name_len
+ 1;
776 match_len
= query_len
- label_name_len
- 1;
778 curr
= begin_current_label_crit_section();
779 label
= aa_label_parse(curr
, label_name
, GFP_KERNEL
, false, false);
780 end_current_label_crit_section(curr
);
782 return PTR_ERR(label
);
786 label_for_each_in_ns(i
, labels_ns(label
), label
, profile
) {
787 profile_query_cb(profile
, &perms
, match_str
, match_len
);
790 label_for_each(i
, label
, profile
) {
791 profile_query_cb(profile
, &perms
, match_str
, match_len
);
796 return scnprintf(buf
, buf_len
,
797 "allow 0x%08x\ndeny 0x%08x\naudit 0x%08x\nquiet 0x%08x\n",
798 perms
.allow
, perms
.deny
, perms
.audit
, perms
.quiet
);
802 * Transaction based IO.
803 * The file expects a write which triggers the transaction, and then
804 * possibly a read(s) which collects the result - which is stored in a
805 * file-local buffer. Once a new write is performed, a new set of results
806 * are stored in the file-local buffer.
808 struct multi_transaction
{
814 #define MULTI_TRANSACTION_LIMIT (PAGE_SIZE - sizeof(struct multi_transaction))
815 /* TODO: replace with per file lock */
816 static DEFINE_SPINLOCK(multi_transaction_lock
);
818 static void multi_transaction_kref(struct kref
*kref
)
820 struct multi_transaction
*t
;
822 t
= container_of(kref
, struct multi_transaction
, count
);
823 free_page((unsigned long) t
);
826 static struct multi_transaction
*
827 get_multi_transaction(struct multi_transaction
*t
)
830 kref_get(&(t
->count
));
835 static void put_multi_transaction(struct multi_transaction
*t
)
838 kref_put(&(t
->count
), multi_transaction_kref
);
841 /* does not increment @new's count */
842 static void multi_transaction_set(struct file
*file
,
843 struct multi_transaction
*new, size_t n
)
845 struct multi_transaction
*old
;
847 AA_BUG(n
> MULTI_TRANSACTION_LIMIT
);
850 spin_lock(&multi_transaction_lock
);
851 old
= (struct multi_transaction
*) file
->private_data
;
852 file
->private_data
= new;
853 spin_unlock(&multi_transaction_lock
);
854 put_multi_transaction(old
);
857 static struct multi_transaction
*multi_transaction_new(struct file
*file
,
858 const char __user
*buf
,
861 struct multi_transaction
*t
;
863 if (size
> MULTI_TRANSACTION_LIMIT
- 1)
864 return ERR_PTR(-EFBIG
);
866 t
= (struct multi_transaction
*)get_zeroed_page(GFP_KERNEL
);
868 return ERR_PTR(-ENOMEM
);
869 kref_init(&t
->count
);
870 if (copy_from_user(t
->data
, buf
, size
))
871 return ERR_PTR(-EFAULT
);
876 static ssize_t
multi_transaction_read(struct file
*file
, char __user
*buf
,
877 size_t size
, loff_t
*pos
)
879 struct multi_transaction
*t
;
882 spin_lock(&multi_transaction_lock
);
883 t
= get_multi_transaction(file
->private_data
);
884 spin_unlock(&multi_transaction_lock
);
888 ret
= simple_read_from_buffer(buf
, size
, pos
, t
->data
, t
->size
);
889 put_multi_transaction(t
);
894 static int multi_transaction_release(struct inode
*inode
, struct file
*file
)
896 put_multi_transaction(file
->private_data
);
901 #define QUERY_CMD_LABEL "label\0"
902 #define QUERY_CMD_LABEL_LEN 6
903 #define QUERY_CMD_PROFILE "profile\0"
904 #define QUERY_CMD_PROFILE_LEN 8
905 #define QUERY_CMD_LABELALL "labelall\0"
906 #define QUERY_CMD_LABELALL_LEN 9
907 #define QUERY_CMD_DATA "data\0"
908 #define QUERY_CMD_DATA_LEN 5
911 * aa_write_access - generic permissions and data query
912 * @file: pointer to open apparmorfs/access file
913 * @ubuf: user buffer containing the complete query string (NOT NULL)
914 * @count: size of ubuf
915 * @ppos: position in the file (MUST BE ZERO)
917 * Allows for one permissions or data query per open(), write(), and read()
918 * sequence. The only queries currently supported are label-based queries for
919 * permissions or data.
921 * For permissions queries, ubuf must begin with "label\0", followed by the
922 * profile query specific format described in the query_label() function
925 * For data queries, ubuf must have the form "data\0<LABEL>\0<KEY>\0", where
926 * <LABEL> is the name of the security confinement context and <KEY> is the
927 * name of the data to retrieve.
929 * Returns: number of bytes written or -errno on failure
931 static ssize_t
aa_write_access(struct file
*file
, const char __user
*ubuf
,
932 size_t count
, loff_t
*ppos
)
934 struct multi_transaction
*t
;
940 t
= multi_transaction_new(file
, ubuf
, count
);
944 if (count
> QUERY_CMD_PROFILE_LEN
&&
945 !memcmp(t
->data
, QUERY_CMD_PROFILE
, QUERY_CMD_PROFILE_LEN
)) {
946 len
= query_label(t
->data
, MULTI_TRANSACTION_LIMIT
,
947 t
->data
+ QUERY_CMD_PROFILE_LEN
,
948 count
- QUERY_CMD_PROFILE_LEN
, true);
949 } else if (count
> QUERY_CMD_LABEL_LEN
&&
950 !memcmp(t
->data
, QUERY_CMD_LABEL
, QUERY_CMD_LABEL_LEN
)) {
951 len
= query_label(t
->data
, MULTI_TRANSACTION_LIMIT
,
952 t
->data
+ QUERY_CMD_LABEL_LEN
,
953 count
- QUERY_CMD_LABEL_LEN
, true);
954 } else if (count
> QUERY_CMD_LABELALL_LEN
&&
955 !memcmp(t
->data
, QUERY_CMD_LABELALL
,
956 QUERY_CMD_LABELALL_LEN
)) {
957 len
= query_label(t
->data
, MULTI_TRANSACTION_LIMIT
,
958 t
->data
+ QUERY_CMD_LABELALL_LEN
,
959 count
- QUERY_CMD_LABELALL_LEN
, false);
960 } else if (count
> QUERY_CMD_DATA_LEN
&&
961 !memcmp(t
->data
, QUERY_CMD_DATA
, QUERY_CMD_DATA_LEN
)) {
962 len
= query_data(t
->data
, MULTI_TRANSACTION_LIMIT
,
963 t
->data
+ QUERY_CMD_DATA_LEN
,
964 count
- QUERY_CMD_DATA_LEN
);
969 put_multi_transaction(t
);
973 multi_transaction_set(file
, t
, len
);
978 static const struct file_operations aa_sfs_access
= {
979 .write
= aa_write_access
,
980 .read
= multi_transaction_read
,
981 .release
= multi_transaction_release
,
982 .llseek
= generic_file_llseek
,
985 static int aa_sfs_seq_show(struct seq_file
*seq
, void *v
)
987 struct aa_sfs_entry
*fs_file
= seq
->private;
992 switch (fs_file
->v_type
) {
993 case AA_SFS_TYPE_BOOLEAN
:
994 seq_printf(seq
, "%s\n", fs_file
->v
.boolean
? "yes" : "no");
996 case AA_SFS_TYPE_STRING
:
997 seq_printf(seq
, "%s\n", fs_file
->v
.string
);
999 case AA_SFS_TYPE_U64
:
1000 seq_printf(seq
, "%#08lx\n", fs_file
->v
.u64
);
1003 /* Ignore unpritable entry types. */
1010 static int aa_sfs_seq_open(struct inode
*inode
, struct file
*file
)
1012 return single_open(file
, aa_sfs_seq_show
, inode
->i_private
);
1015 const struct file_operations aa_sfs_seq_file_ops
= {
1016 .owner
= THIS_MODULE
,
1017 .open
= aa_sfs_seq_open
,
1019 .llseek
= seq_lseek
,
1020 .release
= single_release
,
1024 * profile based file operations
1025 * policy/profiles/XXXX/profiles/ *
1028 #define SEQ_PROFILE_FOPS(NAME) \
1029 static int seq_profile_ ##NAME ##_open(struct inode *inode, struct file *file)\
1031 return seq_profile_open(inode, file, seq_profile_ ##NAME ##_show); \
1034 static const struct file_operations seq_profile_ ##NAME ##_fops = { \
1035 .owner = THIS_MODULE, \
1036 .open = seq_profile_ ##NAME ##_open, \
1038 .llseek = seq_lseek, \
1039 .release = seq_profile_release, \
1042 static int seq_profile_open(struct inode *inode, struct file *file,
1043 int (*show
)(struct seq_file
*, void *))
1045 struct aa_proxy
*proxy
= aa_get_proxy(inode
->i_private
);
1046 int error
= single_open(file
, show
, proxy
);
1049 file
->private_data
= NULL
;
1050 aa_put_proxy(proxy
);
1056 static int seq_profile_release(struct inode
*inode
, struct file
*file
)
1058 struct seq_file
*seq
= (struct seq_file
*) file
->private_data
;
1060 aa_put_proxy(seq
->private);
1061 return single_release(inode
, file
);
1064 static int seq_profile_name_show(struct seq_file
*seq
, void *v
)
1066 struct aa_proxy
*proxy
= seq
->private;
1067 struct aa_label
*label
= aa_get_label_rcu(&proxy
->label
);
1068 struct aa_profile
*profile
= labels_profile(label
);
1069 seq_printf(seq
, "%s\n", profile
->base
.name
);
1070 aa_put_label(label
);
1075 static int seq_profile_mode_show(struct seq_file
*seq
, void *v
)
1077 struct aa_proxy
*proxy
= seq
->private;
1078 struct aa_label
*label
= aa_get_label_rcu(&proxy
->label
);
1079 struct aa_profile
*profile
= labels_profile(label
);
1080 seq_printf(seq
, "%s\n", aa_profile_mode_names
[profile
->mode
]);
1081 aa_put_label(label
);
1086 static int seq_profile_attach_show(struct seq_file
*seq
, void *v
)
1088 struct aa_proxy
*proxy
= seq
->private;
1089 struct aa_label
*label
= aa_get_label_rcu(&proxy
->label
);
1090 struct aa_profile
*profile
= labels_profile(label
);
1091 if (profile
->attach
)
1092 seq_printf(seq
, "%s\n", profile
->attach
);
1093 else if (profile
->xmatch
)
1094 seq_puts(seq
, "<unknown>\n");
1096 seq_printf(seq
, "%s\n", profile
->base
.name
);
1097 aa_put_label(label
);
1102 static int seq_profile_hash_show(struct seq_file
*seq
, void *v
)
1104 struct aa_proxy
*proxy
= seq
->private;
1105 struct aa_label
*label
= aa_get_label_rcu(&proxy
->label
);
1106 struct aa_profile
*profile
= labels_profile(label
);
1107 unsigned int i
, size
= aa_hash_size();
1109 if (profile
->hash
) {
1110 for (i
= 0; i
< size
; i
++)
1111 seq_printf(seq
, "%.2x", profile
->hash
[i
]);
1112 seq_putc(seq
, '\n');
1114 aa_put_label(label
);
1119 SEQ_PROFILE_FOPS(name
);
1120 SEQ_PROFILE_FOPS(mode
);
1121 SEQ_PROFILE_FOPS(attach
);
1122 SEQ_PROFILE_FOPS(hash
);
1125 * namespace based files
1126 * several root files and
1130 #define SEQ_NS_FOPS(NAME) \
1131 static int seq_ns_ ##NAME ##_open(struct inode *inode, struct file *file) \
1133 return single_open(file, seq_ns_ ##NAME ##_show, inode->i_private); \
1136 static const struct file_operations seq_ns_ ##NAME ##_fops = { \
1137 .owner = THIS_MODULE, \
1138 .open = seq_ns_ ##NAME ##_open, \
1140 .llseek = seq_lseek, \
1141 .release = single_release, \
1144 static int seq_ns_stacked_show(struct seq_file *seq, void *v)
1146 struct aa_label
*label
;
1148 label
= begin_current_label_crit_section();
1149 seq_printf(seq
, "%s\n", label
->size
> 1 ? "yes" : "no");
1150 end_current_label_crit_section(label
);
1155 static int seq_ns_nsstacked_show(struct seq_file
*seq
, void *v
)
1157 struct aa_label
*label
;
1158 struct aa_profile
*profile
;
1162 label
= begin_current_label_crit_section();
1164 if (label
->size
> 1) {
1165 label_for_each(it
, label
, profile
)
1166 if (profile
->ns
!= labels_ns(label
)) {
1172 seq_printf(seq
, "%s\n", count
> 1 ? "yes" : "no");
1173 end_current_label_crit_section(label
);
1178 static int seq_ns_level_show(struct seq_file
*seq
, void *v
)
1180 struct aa_label
*label
;
1182 label
= begin_current_label_crit_section();
1183 seq_printf(seq
, "%d\n", labels_ns(label
)->level
);
1184 end_current_label_crit_section(label
);
1189 static int seq_ns_name_show(struct seq_file
*seq
, void *v
)
1191 struct aa_label
*label
= begin_current_label_crit_section();
1192 seq_printf(seq
, "%s\n", labels_ns(label
)->base
.name
);
1193 end_current_label_crit_section(label
);
1198 SEQ_NS_FOPS(stacked
);
1199 SEQ_NS_FOPS(nsstacked
);
1204 /* policy/raw_data/ * file ops */
1206 #define SEQ_RAWDATA_FOPS(NAME) \
1207 static int seq_rawdata_ ##NAME ##_open(struct inode *inode, struct file *file)\
1209 return seq_rawdata_open(inode, file, seq_rawdata_ ##NAME ##_show); \
1212 static const struct file_operations seq_rawdata_ ##NAME ##_fops = { \
1213 .owner = THIS_MODULE, \
1214 .open = seq_rawdata_ ##NAME ##_open, \
1216 .llseek = seq_lseek, \
1217 .release = seq_rawdata_release, \
1220 static int seq_rawdata_open(struct inode *inode, struct file *file,
1221 int (*show
)(struct seq_file
*, void *))
1223 struct aa_loaddata
*data
= __aa_get_loaddata(inode
->i_private
);
1227 /* lost race this ent is being reaped */
1230 error
= single_open(file
, show
, data
);
1232 AA_BUG(file
->private_data
&&
1233 ((struct seq_file
*)file
->private_data
)->private);
1234 aa_put_loaddata(data
);
1240 static int seq_rawdata_release(struct inode
*inode
, struct file
*file
)
1242 struct seq_file
*seq
= (struct seq_file
*) file
->private_data
;
1245 aa_put_loaddata(seq
->private);
1247 return single_release(inode
, file
);
1250 static int seq_rawdata_abi_show(struct seq_file
*seq
, void *v
)
1252 struct aa_loaddata
*data
= seq
->private;
1254 seq_printf(seq
, "v%d\n", data
->abi
);
1259 static int seq_rawdata_revision_show(struct seq_file
*seq
, void *v
)
1261 struct aa_loaddata
*data
= seq
->private;
1263 seq_printf(seq
, "%ld\n", data
->revision
);
1268 static int seq_rawdata_hash_show(struct seq_file
*seq
, void *v
)
1270 struct aa_loaddata
*data
= seq
->private;
1271 unsigned int i
, size
= aa_hash_size();
1274 for (i
= 0; i
< size
; i
++)
1275 seq_printf(seq
, "%.2x", data
->hash
[i
]);
1276 seq_putc(seq
, '\n');
1282 SEQ_RAWDATA_FOPS(abi
);
1283 SEQ_RAWDATA_FOPS(revision
);
1284 SEQ_RAWDATA_FOPS(hash
);
1286 static ssize_t
rawdata_read(struct file
*file
, char __user
*buf
, size_t size
,
1289 struct aa_loaddata
*rawdata
= file
->private_data
;
1291 return simple_read_from_buffer(buf
, size
, ppos
, rawdata
->data
,
1295 static int rawdata_release(struct inode
*inode
, struct file
*file
)
1297 aa_put_loaddata(file
->private_data
);
1302 static int rawdata_open(struct inode
*inode
, struct file
*file
)
1304 if (!policy_view_capable(NULL
))
1306 file
->private_data
= __aa_get_loaddata(inode
->i_private
);
1307 if (!file
->private_data
)
1308 /* lost race: this entry is being reaped */
1314 static const struct file_operations rawdata_fops
= {
1315 .open
= rawdata_open
,
1316 .read
= rawdata_read
,
1317 .llseek
= generic_file_llseek
,
1318 .release
= rawdata_release
,
1321 static void remove_rawdata_dents(struct aa_loaddata
*rawdata
)
1325 for (i
= 0; i
< AAFS_LOADDATA_NDENTS
; i
++) {
1326 if (!IS_ERR_OR_NULL(rawdata
->dents
[i
])) {
1327 /* no refcounts on i_private */
1328 aafs_remove(rawdata
->dents
[i
]);
1329 rawdata
->dents
[i
] = NULL
;
1334 void __aa_fs_remove_rawdata(struct aa_loaddata
*rawdata
)
1336 AA_BUG(rawdata
->ns
&& !mutex_is_locked(&rawdata
->ns
->lock
));
1339 remove_rawdata_dents(rawdata
);
1340 list_del_init(&rawdata
->list
);
1341 aa_put_ns(rawdata
->ns
);
1346 int __aa_fs_create_rawdata(struct aa_ns
*ns
, struct aa_loaddata
*rawdata
)
1348 struct dentry
*dent
, *dir
;
1352 AA_BUG(!mutex_is_locked(&ns
->lock
));
1353 AA_BUG(!ns_subdata_dir(ns
));
1356 * just use ns revision dir was originally created at. This is
1357 * under ns->lock and if load is successful revision will be
1358 * bumped and is guaranteed to be unique
1360 rawdata
->name
= kasprintf(GFP_KERNEL
, "%ld", ns
->revision
);
1364 dir
= aafs_create_dir(rawdata
->name
, ns_subdata_dir(ns
));
1366 /* ->name freed when rawdata freed */
1367 return PTR_ERR(dir
);
1368 rawdata
->dents
[AAFS_LOADDATA_DIR
] = dir
;
1370 dent
= aafs_create_file("abi", S_IFREG
| 0444, dir
, rawdata
,
1371 &seq_rawdata_abi_fops
);
1374 rawdata
->dents
[AAFS_LOADDATA_ABI
] = dent
;
1376 dent
= aafs_create_file("revision", S_IFREG
| 0444, dir
, rawdata
,
1377 &seq_rawdata_revision_fops
);
1380 rawdata
->dents
[AAFS_LOADDATA_REVISION
] = dent
;
1382 if (aa_g_hash_policy
) {
1383 dent
= aafs_create_file("sha1", S_IFREG
| 0444, dir
,
1384 rawdata
, &seq_rawdata_hash_fops
);
1387 rawdata
->dents
[AAFS_LOADDATA_HASH
] = dent
;
1390 dent
= aafs_create_file("raw_data", S_IFREG
| 0444,
1391 dir
, rawdata
, &rawdata_fops
);
1394 rawdata
->dents
[AAFS_LOADDATA_DATA
] = dent
;
1395 d_inode(dent
)->i_size
= rawdata
->size
;
1397 rawdata
->ns
= aa_get_ns(ns
);
1398 list_add(&rawdata
->list
, &ns
->rawdata_list
);
1399 /* no refcount on inode rawdata */
1404 remove_rawdata_dents(rawdata
);
1406 return PTR_ERR(dent
);
1409 /** fns to setup dynamic per profile/namespace files **/
1413 * Requires: @profile->ns->lock held
1415 void __aafs_profile_rmdir(struct aa_profile
*profile
)
1417 struct aa_profile
*child
;
1423 list_for_each_entry(child
, &profile
->base
.profiles
, base
.list
)
1424 __aafs_profile_rmdir(child
);
1426 for (i
= AAFS_PROF_SIZEOF
- 1; i
>= 0; --i
) {
1427 struct aa_proxy
*proxy
;
1428 if (!profile
->dents
[i
])
1431 proxy
= d_inode(profile
->dents
[i
])->i_private
;
1432 aafs_remove(profile
->dents
[i
]);
1433 aa_put_proxy(proxy
);
1434 profile
->dents
[i
] = NULL
;
1440 * Requires: @old->ns->lock held
1442 void __aafs_profile_migrate_dents(struct aa_profile
*old
,
1443 struct aa_profile
*new)
1449 AA_BUG(!mutex_is_locked(&profiles_ns(old
)->lock
));
1451 for (i
= 0; i
< AAFS_PROF_SIZEOF
; i
++) {
1452 new->dents
[i
] = old
->dents
[i
];
1454 new->dents
[i
]->d_inode
->i_mtime
= current_time(new->dents
[i
]->d_inode
);
1455 old
->dents
[i
] = NULL
;
1459 static struct dentry
*create_profile_file(struct dentry
*dir
, const char *name
,
1460 struct aa_profile
*profile
,
1461 const struct file_operations
*fops
)
1463 struct aa_proxy
*proxy
= aa_get_proxy(profile
->label
.proxy
);
1464 struct dentry
*dent
;
1466 dent
= aafs_create_file(name
, S_IFREG
| 0444, dir
, proxy
, fops
);
1468 aa_put_proxy(proxy
);
1473 static int profile_depth(struct aa_profile
*profile
)
1478 for (depth
= 0; profile
; profile
= rcu_access_pointer(profile
->parent
))
1485 static int gen_symlink_name(char *buffer
, size_t bsize
, int depth
,
1486 const char *dirname
, const char *fname
)
1490 for (; depth
> 0; depth
--) {
1492 return -ENAMETOOLONG
;
1493 strcpy(buffer
, "../../");
1498 error
= snprintf(buffer
, bsize
, "raw_data/%s/%s", dirname
, fname
);
1499 if (error
>= bsize
|| error
< 0)
1500 return -ENAMETOOLONG
;
1506 * Requires: @profile->ns->lock held
1508 int __aafs_profile_mkdir(struct aa_profile
*profile
, struct dentry
*parent
)
1510 struct aa_profile
*child
;
1511 struct dentry
*dent
= NULL
, *dir
;
1515 AA_BUG(!mutex_is_locked(&profiles_ns(profile
)->lock
));
1518 struct aa_profile
*p
;
1519 p
= aa_deref_parent(profile
);
1521 /* adding to parent that previously didn't have children */
1522 dent
= aafs_create_dir("profiles", dent
);
1525 prof_child_dir(p
) = parent
= dent
;
1528 if (!profile
->dirname
) {
1530 len
= mangle_name(profile
->base
.name
, NULL
);
1531 id_len
= snprintf(NULL
, 0, ".%ld", profile
->ns
->uniq_id
);
1533 profile
->dirname
= kmalloc(len
+ id_len
+ 1, GFP_KERNEL
);
1534 if (!profile
->dirname
) {
1539 mangle_name(profile
->base
.name
, profile
->dirname
);
1540 sprintf(profile
->dirname
+ len
, ".%ld", profile
->ns
->uniq_id
++);
1543 dent
= aafs_create_dir(profile
->dirname
, parent
);
1546 prof_dir(profile
) = dir
= dent
;
1548 dent
= create_profile_file(dir
, "name", profile
,
1549 &seq_profile_name_fops
);
1552 profile
->dents
[AAFS_PROF_NAME
] = dent
;
1554 dent
= create_profile_file(dir
, "mode", profile
,
1555 &seq_profile_mode_fops
);
1558 profile
->dents
[AAFS_PROF_MODE
] = dent
;
1560 dent
= create_profile_file(dir
, "attach", profile
,
1561 &seq_profile_attach_fops
);
1564 profile
->dents
[AAFS_PROF_ATTACH
] = dent
;
1566 if (profile
->hash
) {
1567 dent
= create_profile_file(dir
, "sha1", profile
,
1568 &seq_profile_hash_fops
);
1571 profile
->dents
[AAFS_PROF_HASH
] = dent
;
1574 if (profile
->rawdata
) {
1576 int depth
= profile_depth(profile
);
1578 error
= gen_symlink_name(target
, sizeof(target
), depth
,
1579 profile
->rawdata
->name
, "sha1");
1582 dent
= aafs_create_symlink("raw_sha1", dir
, target
, NULL
);
1585 profile
->dents
[AAFS_PROF_RAW_HASH
] = dent
;
1587 error
= gen_symlink_name(target
, sizeof(target
), depth
,
1588 profile
->rawdata
->name
, "abi");
1591 dent
= aafs_create_symlink("raw_abi", dir
, target
, NULL
);
1594 profile
->dents
[AAFS_PROF_RAW_ABI
] = dent
;
1596 error
= gen_symlink_name(target
, sizeof(target
), depth
,
1597 profile
->rawdata
->name
, "raw_data");
1600 dent
= aafs_create_symlink("raw_data", dir
, target
, NULL
);
1603 profile
->dents
[AAFS_PROF_RAW_DATA
] = dent
;
1606 list_for_each_entry(child
, &profile
->base
.profiles
, base
.list
) {
1607 error
= __aafs_profile_mkdir(child
, prof_child_dir(profile
));
1615 error
= PTR_ERR(dent
);
1618 __aafs_profile_rmdir(profile
);
1623 static int ns_mkdir_op(struct inode
*dir
, struct dentry
*dentry
, umode_t mode
)
1625 struct aa_ns
*ns
, *parent
;
1626 /* TODO: improve permission check */
1627 struct aa_label
*label
;
1630 label
= begin_current_label_crit_section();
1631 error
= aa_may_manage_policy(label
, NULL
, AA_MAY_LOAD_POLICY
);
1632 end_current_label_crit_section(label
);
1636 parent
= aa_get_ns(dir
->i_private
);
1637 AA_BUG(d_inode(ns_subns_dir(parent
)) != dir
);
1639 /* we have to unlock and then relock to get locking order right
1643 error
= simple_pin_fs(&aafs_ops
, &aafs_mnt
, &aafs_count
);
1644 mutex_lock_nested(&parent
->lock
, parent
->level
);
1645 inode_lock_nested(dir
, I_MUTEX_PARENT
);
1649 error
= __aafs_setup_d_inode(dir
, dentry
, mode
| S_IFDIR
, NULL
,
1654 ns
= __aa_find_or_create_ns(parent
, READ_ONCE(dentry
->d_name
.name
),
1657 error
= PTR_ERR(ns
);
1661 aa_put_ns(ns
); /* list ref remains */
1664 simple_release_fs(&aafs_mnt
, &aafs_count
);
1666 mutex_unlock(&parent
->lock
);
1672 static int ns_rmdir_op(struct inode
*dir
, struct dentry
*dentry
)
1674 struct aa_ns
*ns
, *parent
;
1675 /* TODO: improve permission check */
1676 struct aa_label
*label
;
1679 label
= begin_current_label_crit_section();
1680 error
= aa_may_manage_policy(label
, NULL
, AA_MAY_LOAD_POLICY
);
1681 end_current_label_crit_section(label
);
1685 parent
= aa_get_ns(dir
->i_private
);
1686 /* rmdir calls the generic securityfs functions to remove files
1687 * from the apparmor dir. It is up to the apparmor ns locking
1691 inode_unlock(dentry
->d_inode
);
1693 mutex_lock_nested(&parent
->lock
, parent
->level
);
1694 ns
= aa_get_ns(__aa_findn_ns(&parent
->sub_ns
, dentry
->d_name
.name
,
1695 dentry
->d_name
.len
));
1700 AA_BUG(ns_dir(ns
) != dentry
);
1706 mutex_unlock(&parent
->lock
);
1707 inode_lock_nested(dir
, I_MUTEX_PARENT
);
1708 inode_lock(dentry
->d_inode
);
1714 static const struct inode_operations ns_dir_inode_operations
= {
1715 .lookup
= simple_lookup
,
1716 .mkdir
= ns_mkdir_op
,
1717 .rmdir
= ns_rmdir_op
,
1720 static void __aa_fs_list_remove_rawdata(struct aa_ns
*ns
)
1722 struct aa_loaddata
*ent
, *tmp
;
1724 AA_BUG(!mutex_is_locked(&ns
->lock
));
1726 list_for_each_entry_safe(ent
, tmp
, &ns
->rawdata_list
, list
)
1727 __aa_fs_remove_rawdata(ent
);
1732 * Requires: @ns->lock held
1734 void __aafs_ns_rmdir(struct aa_ns
*ns
)
1737 struct aa_profile
*child
;
1742 AA_BUG(!mutex_is_locked(&ns
->lock
));
1744 list_for_each_entry(child
, &ns
->base
.profiles
, base
.list
)
1745 __aafs_profile_rmdir(child
);
1747 list_for_each_entry(sub
, &ns
->sub_ns
, base
.list
) {
1748 mutex_lock_nested(&sub
->lock
, sub
->level
);
1749 __aafs_ns_rmdir(sub
);
1750 mutex_unlock(&sub
->lock
);
1753 __aa_fs_list_remove_rawdata(ns
);
1755 if (ns_subns_dir(ns
)) {
1756 sub
= d_inode(ns_subns_dir(ns
))->i_private
;
1759 if (ns_subload(ns
)) {
1760 sub
= d_inode(ns_subload(ns
))->i_private
;
1763 if (ns_subreplace(ns
)) {
1764 sub
= d_inode(ns_subreplace(ns
))->i_private
;
1767 if (ns_subremove(ns
)) {
1768 sub
= d_inode(ns_subremove(ns
))->i_private
;
1771 if (ns_subrevision(ns
)) {
1772 sub
= d_inode(ns_subrevision(ns
))->i_private
;
1776 for (i
= AAFS_NS_SIZEOF
- 1; i
>= 0; --i
) {
1777 aafs_remove(ns
->dents
[i
]);
1778 ns
->dents
[i
] = NULL
;
1782 /* assumes cleanup in caller */
1783 static int __aafs_ns_mkdir_entries(struct aa_ns
*ns
, struct dentry
*dir
)
1785 struct dentry
*dent
;
1790 dent
= aafs_create_dir("profiles", dir
);
1792 return PTR_ERR(dent
);
1793 ns_subprofs_dir(ns
) = dent
;
1795 dent
= aafs_create_dir("raw_data", dir
);
1797 return PTR_ERR(dent
);
1798 ns_subdata_dir(ns
) = dent
;
1800 dent
= aafs_create_file("revision", 0444, dir
, ns
,
1801 &aa_fs_ns_revision_fops
);
1803 return PTR_ERR(dent
);
1805 ns_subrevision(ns
) = dent
;
1807 dent
= aafs_create_file(".load", 0640, dir
, ns
,
1808 &aa_fs_profile_load
);
1810 return PTR_ERR(dent
);
1812 ns_subload(ns
) = dent
;
1814 dent
= aafs_create_file(".replace", 0640, dir
, ns
,
1815 &aa_fs_profile_replace
);
1817 return PTR_ERR(dent
);
1819 ns_subreplace(ns
) = dent
;
1821 dent
= aafs_create_file(".remove", 0640, dir
, ns
,
1822 &aa_fs_profile_remove
);
1824 return PTR_ERR(dent
);
1826 ns_subremove(ns
) = dent
;
1828 /* use create_dentry so we can supply private data */
1829 dent
= aafs_create("namespaces", S_IFDIR
| 0755, dir
, ns
, NULL
, NULL
,
1830 &ns_dir_inode_operations
);
1832 return PTR_ERR(dent
);
1834 ns_subns_dir(ns
) = dent
;
1840 * Requires: @ns->lock held
1842 int __aafs_ns_mkdir(struct aa_ns
*ns
, struct dentry
*parent
, const char *name
,
1843 struct dentry
*dent
)
1846 struct aa_profile
*child
;
1852 AA_BUG(!mutex_is_locked(&ns
->lock
));
1855 name
= ns
->base
.name
;
1858 /* create ns dir if it doesn't already exist */
1859 dent
= aafs_create_dir(name
, parent
);
1864 ns_dir(ns
) = dir
= dent
;
1865 error
= __aafs_ns_mkdir_entries(ns
, dir
);
1870 list_for_each_entry(child
, &ns
->base
.profiles
, base
.list
) {
1871 error
= __aafs_profile_mkdir(child
, ns_subprofs_dir(ns
));
1877 list_for_each_entry(sub
, &ns
->sub_ns
, base
.list
) {
1878 mutex_lock_nested(&sub
->lock
, sub
->level
);
1879 error
= __aafs_ns_mkdir(sub
, ns_subns_dir(ns
), NULL
, NULL
);
1880 mutex_unlock(&sub
->lock
);
1888 error
= PTR_ERR(dent
);
1891 __aafs_ns_rmdir(ns
);
1897 #define list_entry_is_head(pos, head, member) (&pos->member == (head))
1900 * __next_ns - find the next namespace to list
1901 * @root: root namespace to stop search at (NOT NULL)
1902 * @ns: current ns position (NOT NULL)
1904 * Find the next namespace from @ns under @root and handle all locking needed
1905 * while switching current namespace.
1907 * Returns: next namespace or NULL if at last namespace under @root
1908 * Requires: ns->parent->lock to be held
1909 * NOTE: will not unlock root->lock
1911 static struct aa_ns
*__next_ns(struct aa_ns
*root
, struct aa_ns
*ns
)
1913 struct aa_ns
*parent
, *next
;
1917 AA_BUG(ns
!= root
&& !mutex_is_locked(&ns
->parent
->lock
));
1919 /* is next namespace a child */
1920 if (!list_empty(&ns
->sub_ns
)) {
1921 next
= list_first_entry(&ns
->sub_ns
, typeof(*ns
), base
.list
);
1922 mutex_lock_nested(&next
->lock
, next
->level
);
1926 /* check if the next ns is a sibling, parent, gp, .. */
1927 parent
= ns
->parent
;
1928 while (ns
!= root
) {
1929 mutex_unlock(&ns
->lock
);
1930 next
= list_next_entry(ns
, base
.list
);
1931 if (!list_entry_is_head(next
, &parent
->sub_ns
, base
.list
)) {
1932 mutex_lock_nested(&next
->lock
, next
->level
);
1936 parent
= parent
->parent
;
1943 * __first_profile - find the first profile in a namespace
1944 * @root: namespace that is root of profiles being displayed (NOT NULL)
1945 * @ns: namespace to start in (NOT NULL)
1947 * Returns: unrefcounted profile or NULL if no profile
1948 * Requires: profile->ns.lock to be held
1950 static struct aa_profile
*__first_profile(struct aa_ns
*root
,
1954 AA_BUG(ns
&& !mutex_is_locked(&ns
->lock
));
1956 for (; ns
; ns
= __next_ns(root
, ns
)) {
1957 if (!list_empty(&ns
->base
.profiles
))
1958 return list_first_entry(&ns
->base
.profiles
,
1959 struct aa_profile
, base
.list
);
1965 * __next_profile - step to the next profile in a profile tree
1966 * @profile: current profile in tree (NOT NULL)
1968 * Perform a depth first traversal on the profile tree in a namespace
1970 * Returns: next profile or NULL if done
1971 * Requires: profile->ns.lock to be held
1973 static struct aa_profile
*__next_profile(struct aa_profile
*p
)
1975 struct aa_profile
*parent
;
1976 struct aa_ns
*ns
= p
->ns
;
1978 AA_BUG(!mutex_is_locked(&profiles_ns(p
)->lock
));
1980 /* is next profile a child */
1981 if (!list_empty(&p
->base
.profiles
))
1982 return list_first_entry(&p
->base
.profiles
, typeof(*p
),
1985 /* is next profile a sibling, parent sibling, gp, sibling, .. */
1986 parent
= rcu_dereference_protected(p
->parent
,
1987 mutex_is_locked(&p
->ns
->lock
));
1989 p
= list_next_entry(p
, base
.list
);
1990 if (!list_entry_is_head(p
, &parent
->base
.profiles
, base
.list
))
1993 parent
= rcu_dereference_protected(parent
->parent
,
1994 mutex_is_locked(&parent
->ns
->lock
));
1997 /* is next another profile in the namespace */
1998 p
= list_next_entry(p
, base
.list
);
1999 if (!list_entry_is_head(p
, &ns
->base
.profiles
, base
.list
))
2006 * next_profile - step to the next profile in where ever it may be
2007 * @root: root namespace (NOT NULL)
2008 * @profile: current profile (NOT NULL)
2010 * Returns: next profile or NULL if there isn't one
2012 static struct aa_profile
*next_profile(struct aa_ns
*root
,
2013 struct aa_profile
*profile
)
2015 struct aa_profile
*next
= __next_profile(profile
);
2019 /* finished all profiles in namespace move to next namespace */
2020 return __first_profile(root
, __next_ns(root
, profile
->ns
));
2024 * p_start - start a depth first traversal of profile tree
2025 * @f: seq_file to fill
2026 * @pos: current position
2028 * Returns: first profile under current namespace or NULL if none found
2030 * acquires first ns->lock
2032 static void *p_start(struct seq_file
*f
, loff_t
*pos
)
2034 struct aa_profile
*profile
= NULL
;
2035 struct aa_ns
*root
= aa_get_current_ns();
2039 /* find the first profile */
2040 mutex_lock_nested(&root
->lock
, root
->level
);
2041 profile
= __first_profile(root
, root
);
2043 /* skip to position */
2044 for (; profile
&& l
> 0; l
--)
2045 profile
= next_profile(root
, profile
);
2051 * p_next - read the next profile entry
2052 * @f: seq_file to fill
2053 * @p: profile previously returned
2054 * @pos: current position
2056 * Returns: next profile after @p or NULL if none
2058 * may acquire/release locks in namespace tree as necessary
2060 static void *p_next(struct seq_file
*f
, void *p
, loff_t
*pos
)
2062 struct aa_profile
*profile
= p
;
2063 struct aa_ns
*ns
= f
->private;
2066 return next_profile(ns
, profile
);
2070 * p_stop - stop depth first traversal
2071 * @f: seq_file we are filling
2072 * @p: the last profile writen
2074 * Release all locking done by p_start/p_next on namespace tree
2076 static void p_stop(struct seq_file
*f
, void *p
)
2078 struct aa_profile
*profile
= p
;
2079 struct aa_ns
*root
= f
->private, *ns
;
2082 for (ns
= profile
->ns
; ns
&& ns
!= root
; ns
= ns
->parent
)
2083 mutex_unlock(&ns
->lock
);
2085 mutex_unlock(&root
->lock
);
2090 * seq_show_profile - show a profile entry
2091 * @f: seq_file to file
2092 * @p: current position (profile) (NOT NULL)
2094 * Returns: error on failure
2096 static int seq_show_profile(struct seq_file
*f
, void *p
)
2098 struct aa_profile
*profile
= (struct aa_profile
*)p
;
2099 struct aa_ns
*root
= f
->private;
2101 aa_label_seq_xprint(f
, root
, &profile
->label
,
2102 FLAG_SHOW_MODE
| FLAG_VIEW_SUBNS
, GFP_KERNEL
);
2108 static const struct seq_operations aa_sfs_profiles_op
= {
2112 .show
= seq_show_profile
,
2115 static int profiles_open(struct inode
*inode
, struct file
*file
)
2117 if (!policy_view_capable(NULL
))
2120 return seq_open(file
, &aa_sfs_profiles_op
);
2123 static int profiles_release(struct inode
*inode
, struct file
*file
)
2125 return seq_release(inode
, file
);
2128 static const struct file_operations aa_sfs_profiles_fops
= {
2129 .open
= profiles_open
,
2131 .llseek
= seq_lseek
,
2132 .release
= profiles_release
,
2136 /** Base file system setup **/
2137 static struct aa_sfs_entry aa_sfs_entry_file
[] = {
2138 AA_SFS_FILE_STRING("mask",
2139 "create read write exec append mmap_exec link lock"),
2143 static struct aa_sfs_entry aa_sfs_entry_ptrace
[] = {
2144 AA_SFS_FILE_STRING("mask", "read trace"),
2148 static struct aa_sfs_entry aa_sfs_entry_signal
[] = {
2149 AA_SFS_FILE_STRING("mask", AA_SFS_SIG_MASK
),
2153 static struct aa_sfs_entry aa_sfs_entry_domain
[] = {
2154 AA_SFS_FILE_BOOLEAN("change_hat", 1),
2155 AA_SFS_FILE_BOOLEAN("change_hatv", 1),
2156 AA_SFS_FILE_BOOLEAN("change_onexec", 1),
2157 AA_SFS_FILE_BOOLEAN("change_profile", 1),
2158 AA_SFS_FILE_BOOLEAN("stack", 1),
2159 AA_SFS_FILE_BOOLEAN("fix_binfmt_elf_mmap", 1),
2160 AA_SFS_FILE_STRING("version", "1.2"),
2164 static struct aa_sfs_entry aa_sfs_entry_versions
[] = {
2165 AA_SFS_FILE_BOOLEAN("v5", 1),
2166 AA_SFS_FILE_BOOLEAN("v6", 1),
2167 AA_SFS_FILE_BOOLEAN("v7", 1),
2171 static struct aa_sfs_entry aa_sfs_entry_policy
[] = {
2172 AA_SFS_DIR("versions", aa_sfs_entry_versions
),
2173 AA_SFS_FILE_BOOLEAN("set_load", 1),
2177 static struct aa_sfs_entry aa_sfs_entry_mount
[] = {
2178 AA_SFS_FILE_STRING("mask", "mount umount pivot_root"),
2182 static struct aa_sfs_entry aa_sfs_entry_ns
[] = {
2183 AA_SFS_FILE_BOOLEAN("profile", 1),
2184 AA_SFS_FILE_BOOLEAN("pivot_root", 0),
2188 static struct aa_sfs_entry aa_sfs_entry_query_label
[] = {
2189 AA_SFS_FILE_STRING("perms", "allow deny audit quiet"),
2190 AA_SFS_FILE_BOOLEAN("data", 1),
2191 AA_SFS_FILE_BOOLEAN("multi_transaction", 1),
2195 static struct aa_sfs_entry aa_sfs_entry_query
[] = {
2196 AA_SFS_DIR("label", aa_sfs_entry_query_label
),
2199 static struct aa_sfs_entry aa_sfs_entry_features
[] = {
2200 AA_SFS_DIR("policy", aa_sfs_entry_policy
),
2201 AA_SFS_DIR("domain", aa_sfs_entry_domain
),
2202 AA_SFS_DIR("file", aa_sfs_entry_file
),
2203 AA_SFS_DIR("mount", aa_sfs_entry_mount
),
2204 AA_SFS_DIR("namespaces", aa_sfs_entry_ns
),
2205 AA_SFS_FILE_U64("capability", VFS_CAP_FLAGS_MASK
),
2206 AA_SFS_DIR("rlimit", aa_sfs_entry_rlimit
),
2207 AA_SFS_DIR("caps", aa_sfs_entry_caps
),
2208 AA_SFS_DIR("ptrace", aa_sfs_entry_ptrace
),
2209 AA_SFS_DIR("signal", aa_sfs_entry_signal
),
2210 AA_SFS_DIR("query", aa_sfs_entry_query
),
2214 static struct aa_sfs_entry aa_sfs_entry_apparmor
[] = {
2215 AA_SFS_FILE_FOPS(".access", 0666, &aa_sfs_access
),
2216 AA_SFS_FILE_FOPS(".stacked", 0444, &seq_ns_stacked_fops
),
2217 AA_SFS_FILE_FOPS(".ns_stacked", 0444, &seq_ns_nsstacked_fops
),
2218 AA_SFS_FILE_FOPS(".ns_level", 0444, &seq_ns_level_fops
),
2219 AA_SFS_FILE_FOPS(".ns_name", 0444, &seq_ns_name_fops
),
2220 AA_SFS_FILE_FOPS("profiles", 0444, &aa_sfs_profiles_fops
),
2221 AA_SFS_DIR("features", aa_sfs_entry_features
),
2225 static struct aa_sfs_entry aa_sfs_entry
=
2226 AA_SFS_DIR("apparmor", aa_sfs_entry_apparmor
);
2229 * entry_create_file - create a file entry in the apparmor securityfs
2230 * @fs_file: aa_sfs_entry to build an entry for (NOT NULL)
2231 * @parent: the parent dentry in the securityfs
2233 * Use entry_remove_file to remove entries created with this fn.
2235 static int __init
entry_create_file(struct aa_sfs_entry
*fs_file
,
2236 struct dentry
*parent
)
2240 fs_file
->dentry
= securityfs_create_file(fs_file
->name
,
2241 S_IFREG
| fs_file
->mode
,
2244 if (IS_ERR(fs_file
->dentry
)) {
2245 error
= PTR_ERR(fs_file
->dentry
);
2246 fs_file
->dentry
= NULL
;
2251 static void __init
entry_remove_dir(struct aa_sfs_entry
*fs_dir
);
2253 * entry_create_dir - recursively create a directory entry in the securityfs
2254 * @fs_dir: aa_sfs_entry (and all child entries) to build (NOT NULL)
2255 * @parent: the parent dentry in the securityfs
2257 * Use entry_remove_dir to remove entries created with this fn.
2259 static int __init
entry_create_dir(struct aa_sfs_entry
*fs_dir
,
2260 struct dentry
*parent
)
2262 struct aa_sfs_entry
*fs_file
;
2266 dir
= securityfs_create_dir(fs_dir
->name
, parent
);
2268 return PTR_ERR(dir
);
2269 fs_dir
->dentry
= dir
;
2271 for (fs_file
= fs_dir
->v
.files
; fs_file
&& fs_file
->name
; ++fs_file
) {
2272 if (fs_file
->v_type
== AA_SFS_TYPE_DIR
)
2273 error
= entry_create_dir(fs_file
, fs_dir
->dentry
);
2275 error
= entry_create_file(fs_file
, fs_dir
->dentry
);
2283 entry_remove_dir(fs_dir
);
2289 * entry_remove_file - drop a single file entry in the apparmor securityfs
2290 * @fs_file: aa_sfs_entry to detach from the securityfs (NOT NULL)
2292 static void __init
entry_remove_file(struct aa_sfs_entry
*fs_file
)
2294 if (!fs_file
->dentry
)
2297 securityfs_remove(fs_file
->dentry
);
2298 fs_file
->dentry
= NULL
;
2302 * entry_remove_dir - recursively drop a directory entry from the securityfs
2303 * @fs_dir: aa_sfs_entry (and all child entries) to detach (NOT NULL)
2305 static void __init
entry_remove_dir(struct aa_sfs_entry
*fs_dir
)
2307 struct aa_sfs_entry
*fs_file
;
2309 for (fs_file
= fs_dir
->v
.files
; fs_file
&& fs_file
->name
; ++fs_file
) {
2310 if (fs_file
->v_type
== AA_SFS_TYPE_DIR
)
2311 entry_remove_dir(fs_file
);
2313 entry_remove_file(fs_file
);
2316 entry_remove_file(fs_dir
);
2320 * aa_destroy_aafs - cleanup and free aafs
2322 * releases dentries allocated by aa_create_aafs
2324 void __init
aa_destroy_aafs(void)
2326 entry_remove_dir(&aa_sfs_entry
);
2330 #define NULL_FILE_NAME ".null"
2331 struct path aa_null
;
2333 static int aa_mk_null_file(struct dentry
*parent
)
2335 struct vfsmount
*mount
= NULL
;
2336 struct dentry
*dentry
;
2337 struct inode
*inode
;
2339 int error
= simple_pin_fs(parent
->d_sb
->s_type
, &mount
, &count
);
2344 inode_lock(d_inode(parent
));
2345 dentry
= lookup_one_len(NULL_FILE_NAME
, parent
, strlen(NULL_FILE_NAME
));
2346 if (IS_ERR(dentry
)) {
2347 error
= PTR_ERR(dentry
);
2350 inode
= new_inode(parent
->d_inode
->i_sb
);
2356 inode
->i_ino
= get_next_ino();
2357 inode
->i_mode
= S_IFCHR
| S_IRUGO
| S_IWUGO
;
2358 inode
->i_atime
= inode
->i_mtime
= inode
->i_ctime
= current_time(inode
);
2359 init_special_inode(inode
, S_IFCHR
| S_IRUGO
| S_IWUGO
,
2360 MKDEV(MEM_MAJOR
, 3));
2361 d_instantiate(dentry
, inode
);
2362 aa_null
.dentry
= dget(dentry
);
2363 aa_null
.mnt
= mntget(mount
);
2370 inode_unlock(d_inode(parent
));
2371 simple_release_fs(&mount
, &count
);
2377 static const char *policy_get_link(struct dentry
*dentry
,
2378 struct inode
*inode
,
2379 struct delayed_call
*done
)
2385 return ERR_PTR(-ECHILD
);
2386 ns
= aa_get_current_ns();
2387 path
.mnt
= mntget(aafs_mnt
);
2388 path
.dentry
= dget(ns_dir(ns
));
2389 nd_jump_link(&path
);
2395 static int ns_get_name(char *buf
, size_t size
, struct aa_ns
*ns
,
2396 struct inode
*inode
)
2398 int res
= snprintf(buf
, size
, "%s:[%lu]", AAFS_NAME
, inode
->i_ino
);
2400 if (res
< 0 || res
>= size
)
2406 static int policy_readlink(struct dentry
*dentry
, char __user
*buffer
,
2413 ns
= aa_get_current_ns();
2414 res
= ns_get_name(name
, sizeof(name
), ns
, d_inode(dentry
));
2416 res
= readlink_copy(buffer
, buflen
, name
);
2422 static const struct inode_operations policy_link_iops
= {
2423 .readlink
= policy_readlink
,
2424 .get_link
= policy_get_link
,
2429 * aa_create_aafs - create the apparmor security filesystem
2431 * dentries created here are released by aa_destroy_aafs
2433 * Returns: error on failure
2435 static int __init
aa_create_aafs(void)
2437 struct dentry
*dent
;
2440 if (!apparmor_initialized
)
2443 if (aa_sfs_entry
.dentry
) {
2444 AA_ERROR("%s: AppArmor securityfs already exists\n", __func__
);
2448 /* setup apparmorfs used to virtualize policy/ */
2449 aafs_mnt
= kern_mount(&aafs_ops
);
2450 if (IS_ERR(aafs_mnt
))
2451 panic("can't set apparmorfs up\n");
2452 aafs_mnt
->mnt_sb
->s_flags
&= ~SB_NOUSER
;
2454 /* Populate fs tree. */
2455 error
= entry_create_dir(&aa_sfs_entry
, NULL
);
2459 dent
= securityfs_create_file(".load", 0666, aa_sfs_entry
.dentry
,
2460 NULL
, &aa_fs_profile_load
);
2462 error
= PTR_ERR(dent
);
2465 ns_subload(root_ns
) = dent
;
2467 dent
= securityfs_create_file(".replace", 0666, aa_sfs_entry
.dentry
,
2468 NULL
, &aa_fs_profile_replace
);
2470 error
= PTR_ERR(dent
);
2473 ns_subreplace(root_ns
) = dent
;
2475 dent
= securityfs_create_file(".remove", 0666, aa_sfs_entry
.dentry
,
2476 NULL
, &aa_fs_profile_remove
);
2478 error
= PTR_ERR(dent
);
2481 ns_subremove(root_ns
) = dent
;
2483 dent
= securityfs_create_file("revision", 0444, aa_sfs_entry
.dentry
,
2484 NULL
, &aa_fs_ns_revision_fops
);
2486 error
= PTR_ERR(dent
);
2489 ns_subrevision(root_ns
) = dent
;
2491 /* policy tree referenced by magic policy symlink */
2492 mutex_lock_nested(&root_ns
->lock
, root_ns
->level
);
2493 error
= __aafs_ns_mkdir(root_ns
, aafs_mnt
->mnt_root
, ".policy",
2494 aafs_mnt
->mnt_root
);
2495 mutex_unlock(&root_ns
->lock
);
2499 /* magic symlink similar to nsfs redirects based on task policy */
2500 dent
= securityfs_create_symlink("policy", aa_sfs_entry
.dentry
,
2501 NULL
, &policy_link_iops
);
2503 error
= PTR_ERR(dent
);
2507 error
= aa_mk_null_file(aa_sfs_entry
.dentry
);
2511 /* TODO: add default profile to apparmorfs */
2513 /* Report that AppArmor fs is enabled */
2514 aa_info_message("AppArmor Filesystem Enabled");
2519 AA_ERROR("Error creating AppArmor securityfs\n");
2523 fs_initcall(aa_create_aafs
);