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/policy_ns.h"
36 #include "include/policy.h"
37 #include "include/policy_ns.h"
38 #include "include/resource.h"
39 #include "include/policy_unpack.h"
42 * The apparmor filesystem interface used for policy load and introspection
43 * The interface is split into two main components based on their function
44 * a securityfs component:
45 * used for static files that are always available, and which allows
46 * userspace to specificy the location of the security filesystem.
48 * fns and data are prefixed with
51 * an apparmorfs component:
52 * used loaded policy content and introspection. It is not part of a
53 * regular mounted filesystem and is available only through the magic
54 * policy symlink in the root of the securityfs apparmor/ directory.
55 * Tasks queries will be magically redirected to the correct portion
56 * of the policy tree based on their confinement.
58 * fns and data are prefixed with
61 * The aa_fs_ prefix is used to indicate the fn is used by both the
62 * securityfs and apparmorfs filesystems.
71 * aa_mangle_name - mangle a profile name to std profile layout form
72 * @name: profile name to mangle (NOT NULL)
73 * @target: buffer to store mangled name, same length as @name (MAYBE NULL)
75 * Returns: length of mangled name
77 static int mangle_name(const char *name, char *target)
81 while (*name == '/' || *name == '.')
85 for (; *name; name++) {
88 else if (isspace(*name))
90 else if (isalnum(*name) || strchr("._-", *name))
97 for (; *name; name++) {
98 if (isalnum(*name) || isspace(*name) ||
99 strchr("/._-", *name))
111 * aafs - core fns and data for the policy tree
114 #define AAFS_NAME "apparmorfs"
115 static struct vfsmount *aafs_mnt;
116 static int aafs_count;
119 static int aafs_show_path(struct seq_file *seq, struct dentry *dentry)
121 struct inode *inode = d_inode(dentry);
123 seq_printf(seq, "%s:[%lu]", AAFS_NAME, inode->i_ino);
127 static void aafs_evict_inode(struct inode *inode)
129 truncate_inode_pages_final(&inode->i_data);
131 if (S_ISLNK(inode->i_mode))
132 kfree(inode->i_link);
135 static const struct super_operations aafs_super_ops = {
136 .statfs = simple_statfs,
137 .evict_inode = aafs_evict_inode,
138 .show_path = aafs_show_path,
141 static int fill_super(struct super_block *sb, void *data, int silent)
143 static struct tree_descr files[] = { {""} };
146 error = simple_fill_super(sb, AAFS_MAGIC, files);
149 sb->s_op = &aafs_super_ops;
154 static struct dentry *aafs_mount(struct file_system_type *fs_type,
155 int flags, const char *dev_name, void *data)
157 return mount_single(fs_type, flags, data, fill_super);
160 static struct file_system_type aafs_ops = {
161 .owner = THIS_MODULE,
164 .kill_sb = kill_anon_super,
168 * __aafs_setup_d_inode - basic inode setup for apparmorfs
169 * @dir: parent directory for the dentry
170 * @dentry: dentry we are seting the inode up for
171 * @mode: permissions the file should have
172 * @data: data to store on inode.i_private, available in open()
173 * @link: if symlink, symlink target string
174 * @fops: struct file_operations that should be used
175 * @iops: struct of inode_operations that should be used
177 static int __aafs_setup_d_inode(struct inode *dir, struct dentry *dentry,
178 umode_t mode, void *data, char *link,
179 const struct file_operations *fops,
180 const struct inode_operations *iops)
182 struct inode *inode = new_inode(dir->i_sb);
190 inode->i_ino = get_next_ino();
191 inode->i_mode = mode;
192 inode->i_atime = inode->i_mtime = inode->i_ctime = current_time(inode);
193 inode->i_private = data;
195 inode->i_op = iops ? iops : &simple_dir_inode_operations;
196 inode->i_fop = &simple_dir_operations;
199 } else if (S_ISLNK(mode)) {
200 inode->i_op = iops ? iops : &simple_symlink_inode_operations;
201 inode->i_link = link;
205 d_instantiate(dentry, inode);
212 * aafs_create - create a dentry in the apparmorfs filesystem
214 * @name: name of dentry to create
215 * @mode: permissions the file should have
216 * @parent: parent directory for this dentry
217 * @data: data to store on inode.i_private, available in open()
218 * @link: if symlink, symlink target string
219 * @fops: struct file_operations that should be used for
220 * @iops: struct of inode_operations that should be used
222 * This is the basic "create a xxx" function for apparmorfs.
224 * Returns a pointer to a dentry if it succeeds, that must be free with
225 * aafs_remove(). Will return ERR_PTR on failure.
227 static struct dentry *aafs_create(const char *name, umode_t mode,
228 struct dentry *parent, void *data, void *link,
229 const struct file_operations *fops,
230 const struct inode_operations *iops)
232 struct dentry *dentry;
239 if (!(mode & S_IFMT))
240 mode = (mode & S_IALLUGO) | S_IFREG;
242 error = simple_pin_fs(&aafs_ops, &aafs_mnt, &aafs_count);
244 return ERR_PTR(error);
246 dir = d_inode(parent);
249 dentry = lookup_one_len(name, parent, strlen(name));
253 if (d_really_is_positive(dentry)) {
258 error = __aafs_setup_d_inode(dir, dentry, mode, data, link, fops, iops);
270 simple_release_fs(&aafs_mnt, &aafs_count);
272 return ERR_PTR(error);
276 * aafs_create_file - create a file in the apparmorfs filesystem
278 * @name: name of dentry to create
279 * @mode: permissions the file should have
280 * @parent: parent directory for this dentry
281 * @data: data to store on inode.i_private, available in open()
282 * @fops: struct file_operations that should be used for
286 static struct dentry *aafs_create_file(const char *name, umode_t mode,
287 struct dentry *parent, void *data,
288 const struct file_operations *fops)
290 return aafs_create(name, mode, parent, data, NULL, fops, NULL);
294 * aafs_create_dir - create a directory in the apparmorfs filesystem
296 * @name: name of dentry to create
297 * @parent: parent directory for this dentry
301 static struct dentry *aafs_create_dir(const char *name, struct dentry *parent)
303 return aafs_create(name, S_IFDIR | 0755, parent, NULL, NULL, NULL,
308 * aafs_create_symlink - create a symlink in the apparmorfs filesystem
309 * @name: name of dentry to create
310 * @parent: parent directory for this dentry
311 * @target: if symlink, symlink target string
312 * @iops: struct of inode_operations that should be used
314 * If @target parameter is %NULL, then the @iops parameter needs to be
315 * setup to handle .readlink and .get_link inode_operations.
317 static struct dentry *aafs_create_symlink(const char *name,
318 struct dentry *parent,
320 const struct inode_operations *iops)
326 link = kstrdup(target, GFP_KERNEL);
328 return ERR_PTR(-ENOMEM);
330 dent = aafs_create(name, S_IFLNK | 0444, parent, NULL, link, NULL,
339 * aafs_remove - removes a file or directory from the apparmorfs filesystem
341 * @dentry: dentry of the file/directory/symlink to removed.
343 static void aafs_remove(struct dentry *dentry)
347 if (!dentry || IS_ERR(dentry))
350 dir = d_inode(dentry->d_parent);
352 if (simple_positive(dentry)) {
353 if (d_is_dir(dentry))
354 simple_rmdir(dir, dentry);
356 simple_unlink(dir, dentry);
360 simple_release_fs(&aafs_mnt, &aafs_count);
365 * aa_fs - policy load/replace/remove
369 * aa_simple_write_to_buffer - common routine for getting policy from user
370 * @userbuf: user buffer to copy data from (NOT NULL)
371 * @alloc_size: size of user buffer (REQUIRES: @alloc_size >= @copy_size)
372 * @copy_size: size of data to copy from user buffer
373 * @pos: position write is at in the file (NOT NULL)
375 * Returns: kernel buffer containing copy of user buffer data or an
376 * ERR_PTR on failure.
378 static struct aa_loaddata *aa_simple_write_to_buffer(const char __user *userbuf,
383 struct aa_loaddata *data;
385 AA_BUG(copy_size > alloc_size);
388 /* only writes from pos 0, that is complete writes */
389 return ERR_PTR(-ESPIPE);
391 /* freed by caller to simple_write_to_buffer */
392 data = aa_loaddata_alloc(alloc_size);
396 data->size = copy_size;
397 if (copy_from_user(data->data, userbuf, copy_size)) {
399 return ERR_PTR(-EFAULT);
405 static ssize_t policy_update(u32 mask, const char __user *buf, size_t size,
406 loff_t *pos, struct aa_ns *ns)
408 struct aa_loaddata *data;
409 struct aa_label *label;
412 label = begin_current_label_crit_section();
414 /* high level check about policy management - fine grained in
417 error = aa_may_manage_policy(label, ns, mask);
421 data = aa_simple_write_to_buffer(buf, size, size, pos);
422 error = PTR_ERR(data);
424 error = aa_replace_profiles(ns, label, mask, data);
425 aa_put_loaddata(data);
427 end_current_label_crit_section(label);
432 /* .load file hook fn to load policy */
433 static ssize_t profile_load(struct file *f, const char __user *buf, size_t size,
436 struct aa_ns *ns = aa_get_ns(f->f_inode->i_private);
437 int error = policy_update(AA_MAY_LOAD_POLICY, buf, size, pos, ns);
444 static const struct file_operations aa_fs_profile_load = {
445 .write = profile_load,
446 .llseek = default_llseek,
449 /* .replace file hook fn to load and/or replace policy */
450 static ssize_t profile_replace(struct file *f, const char __user *buf,
451 size_t size, loff_t *pos)
453 struct aa_ns *ns = aa_get_ns(f->f_inode->i_private);
454 int error = policy_update(AA_MAY_LOAD_POLICY | AA_MAY_REPLACE_POLICY,
461 static const struct file_operations aa_fs_profile_replace = {
462 .write = profile_replace,
463 .llseek = default_llseek,
466 /* .remove file hook fn to remove loaded policy */
467 static ssize_t profile_remove(struct file *f, const char __user *buf,
468 size_t size, loff_t *pos)
470 struct aa_loaddata *data;
471 struct aa_label *label;
473 struct aa_ns *ns = aa_get_ns(f->f_inode->i_private);
475 label = begin_current_label_crit_section();
476 /* high level check about policy management - fine grained in
479 error = aa_may_manage_policy(label, ns, AA_MAY_REMOVE_POLICY);
484 * aa_remove_profile needs a null terminated string so 1 extra
485 * byte is allocated and the copied data is null terminated.
487 data = aa_simple_write_to_buffer(buf, size + 1, size, pos);
489 error = PTR_ERR(data);
491 data->data[size] = 0;
492 error = aa_remove_profiles(ns, label, data->data, size);
493 aa_put_loaddata(data);
496 end_current_label_crit_section(label);
501 static const struct file_operations aa_fs_profile_remove = {
502 .write = profile_remove,
503 .llseek = default_llseek,
511 /* revision file hook fn for policy loads */
512 static int ns_revision_release(struct inode *inode, struct file *file)
514 struct aa_revision *rev = file->private_data;
524 static ssize_t ns_revision_read(struct file *file, char __user *buf,
525 size_t size, loff_t *ppos)
527 struct aa_revision *rev = file->private_data;
532 mutex_lock(&rev->ns->lock);
533 last_read = rev->last_read;
534 if (last_read == rev->ns->revision) {
535 mutex_unlock(&rev->ns->lock);
536 if (file->f_flags & O_NONBLOCK)
538 if (wait_event_interruptible(rev->ns->wait,
540 READ_ONCE(rev->ns->revision)))
542 mutex_lock(&rev->ns->lock);
545 avail = sprintf(buffer, "%ld\n", rev->ns->revision);
546 if (*ppos + size > avail) {
547 rev->last_read = rev->ns->revision;
550 mutex_unlock(&rev->ns->lock);
552 return simple_read_from_buffer(buf, size, ppos, buffer, avail);
555 static int ns_revision_open(struct inode *inode, struct file *file)
557 struct aa_revision *rev = kzalloc(sizeof(*rev), GFP_KERNEL);
562 rev->ns = aa_get_ns(inode->i_private);
564 rev->ns = aa_get_current_ns();
565 file->private_data = rev;
570 static unsigned int ns_revision_poll(struct file *file, poll_table *pt)
572 struct aa_revision *rev = file->private_data;
573 unsigned int mask = 0;
576 mutex_lock(&rev->ns->lock);
577 poll_wait(file, &rev->ns->wait, pt);
578 if (rev->last_read < rev->ns->revision)
579 mask |= POLLIN | POLLRDNORM;
580 mutex_unlock(&rev->ns->lock);
586 void __aa_bump_ns_revision(struct aa_ns *ns)
589 wake_up_interruptible(&ns->wait);
592 static const struct file_operations aa_fs_ns_revision_fops = {
593 .owner = THIS_MODULE,
594 .open = ns_revision_open,
595 .poll = ns_revision_poll,
596 .read = ns_revision_read,
597 .llseek = generic_file_llseek,
598 .release = ns_revision_release,
601 static void profile_query_cb(struct aa_profile *profile, struct aa_perms *perms,
602 const char *match_str, size_t match_len)
606 unsigned int state = 0;
608 if (profile_unconfined(profile))
610 if (profile->file.dfa && *match_str == AA_CLASS_FILE) {
611 dfa = profile->file.dfa;
612 state = aa_dfa_match_len(dfa, profile->file.start,
613 match_str + 1, match_len - 1);
616 struct path_cond cond = { };
618 tmp = aa_compute_fperms(dfa, state, &cond);
620 } else if (profile->policy.dfa) {
621 if (!PROFILE_MEDIATES_SAFE(profile, *match_str))
622 return; /* no change to current perms */
623 dfa = profile->policy.dfa;
624 state = aa_dfa_match_len(dfa, profile->policy.start[0],
625 match_str, match_len);
627 aa_compute_perms(dfa, state, &tmp);
631 aa_apply_modes_to_perms(profile, &tmp);
636 * query_data - queries a policy and writes its data to buf
637 * @buf: the resulting data is stored here (NOT NULL)
638 * @buf_len: size of buf
639 * @query: query string used to retrieve data
640 * @query_len: size of query including second NUL byte
642 * The buffers pointed to by buf and query may overlap. The query buffer is
643 * parsed before buf is written to.
645 * The query should look like "<LABEL>\0<KEY>\0", where <LABEL> is the name of
646 * the security confinement context and <KEY> is the name of the data to
647 * retrieve. <LABEL> and <KEY> must not be NUL-terminated.
649 * Don't expect the contents of buf to be preserved on failure.
651 * Returns: number of characters written to buf or -errno on failure
653 static ssize_t query_data(char *buf, size_t buf_len,
654 char *query, size_t query_len)
658 struct aa_label *label, *curr;
659 struct aa_data *data;
664 return -EINVAL; /* need a query */
666 key = query + strnlen(query, query_len) + 1;
667 if (key + 1 >= query + query_len)
668 return -EINVAL; /* not enough space for a non-empty key */
669 if (key + strnlen(key, query + query_len - key) >= query + query_len)
670 return -EINVAL; /* must end with NUL */
672 if (buf_len < sizeof(bytes) + sizeof(blocks))
673 return -EINVAL; /* not enough space */
675 curr = begin_current_label_crit_section();
676 label = aa_label_parse(curr, query, GFP_KERNEL, false, false);
677 end_current_label_crit_section(curr);
679 return PTR_ERR(label);
681 /* We are going to leave space for two numbers. The first is the total
682 * number of bytes we are writing after the first number. This is so
683 * users can read the full output without reallocation.
685 * The second number is the number of data blocks we're writing. An
686 * application might be confined by multiple policies having data in
689 memset(buf, 0, sizeof(bytes) + sizeof(blocks));
690 out = buf + sizeof(bytes) + sizeof(blocks);
693 if (labels_profile(label)->data) {
694 data = rhashtable_lookup_fast(labels_profile(label)->data, &key,
695 labels_profile(label)->data->p);
698 if (out + sizeof(outle32) + data->size >
701 return -EINVAL; /* not enough space */
703 outle32 = __cpu_to_le32(data->size);
704 memcpy(out, &outle32, sizeof(outle32));
705 out += sizeof(outle32);
706 memcpy(out, data->data, data->size);
713 outle32 = __cpu_to_le32(out - buf - sizeof(bytes));
714 memcpy(buf, &outle32, sizeof(outle32));
715 outle32 = __cpu_to_le32(blocks);
716 memcpy(buf + sizeof(bytes), &outle32, sizeof(outle32));
722 * query_label - queries a label and writes permissions to buf
723 * @buf: the resulting permissions string is stored here (NOT NULL)
724 * @buf_len: size of buf
725 * @query: binary query string to match against the dfa
726 * @query_len: size of query
727 * @view_only: only compute for querier's view
729 * The buffers pointed to by buf and query may overlap. The query buffer is
730 * parsed before buf is written to.
732 * The query should look like "LABEL_NAME\0DFA_STRING" where LABEL_NAME is
733 * the name of the label, in the current namespace, that is to be queried and
734 * DFA_STRING is a binary string to match against the label(s)'s DFA.
736 * LABEL_NAME must be NUL terminated. DFA_STRING may contain NUL characters
737 * but must *not* be NUL terminated.
739 * Returns: number of characters written to buf or -errno on failure
741 static ssize_t query_label(char *buf, size_t buf_len,
742 char *query, size_t query_len, bool view_only)
744 struct aa_label *label, *curr;
745 char *label_name, *match_str;
746 size_t label_name_len, match_len;
747 struct aa_perms perms;
753 label_name_len = strnlen(query, query_len);
754 if (!label_name_len || label_name_len == query_len)
758 * The extra byte is to account for the null byte between the
759 * profile name and dfa string. profile_name_len is greater
760 * than zero and less than query_len, so a byte can be safely
761 * added or subtracted.
763 match_str = label_name + label_name_len + 1;
764 match_len = query_len - label_name_len - 1;
766 curr = begin_current_label_crit_section();
767 label = aa_label_parse(curr, label_name, GFP_KERNEL, false, false);
768 end_current_label_crit_section(curr);
770 return PTR_ERR(label);
773 profile_query_cb(labels_profile(label), &perms, match_str, match_len);
775 return scnprintf(buf, buf_len,
776 "allow 0x%08x\ndeny 0x%08x\naudit 0x%08x\nquiet 0x%08x\n",
777 perms.allow, perms.deny, perms.audit, perms.quiet);
781 * Transaction based IO.
782 * The file expects a write which triggers the transaction, and then
783 * possibly a read(s) which collects the result - which is stored in a
784 * file-local buffer. Once a new write is performed, a new set of results
785 * are stored in the file-local buffer.
787 struct multi_transaction {
793 #define MULTI_TRANSACTION_LIMIT (PAGE_SIZE - sizeof(struct multi_transaction))
794 /* TODO: replace with per file lock */
795 static DEFINE_SPINLOCK(multi_transaction_lock);
797 static void multi_transaction_kref(struct kref *kref)
799 struct multi_transaction *t;
801 t = container_of(kref, struct multi_transaction, count);
802 free_page((unsigned long) t);
805 static struct multi_transaction *
806 get_multi_transaction(struct multi_transaction *t)
809 kref_get(&(t->count));
814 static void put_multi_transaction(struct multi_transaction *t)
817 kref_put(&(t->count), multi_transaction_kref);
820 /* does not increment @new's count */
821 static void multi_transaction_set(struct file *file,
822 struct multi_transaction *new, size_t n)
824 struct multi_transaction *old;
826 AA_BUG(n > MULTI_TRANSACTION_LIMIT);
829 spin_lock(&multi_transaction_lock);
830 old = (struct multi_transaction *) file->private_data;
831 file->private_data = new;
832 spin_unlock(&multi_transaction_lock);
833 put_multi_transaction(old);
836 static struct multi_transaction *multi_transaction_new(struct file *file,
837 const char __user *buf,
840 struct multi_transaction *t;
842 if (size > MULTI_TRANSACTION_LIMIT - 1)
843 return ERR_PTR(-EFBIG);
845 t = (struct multi_transaction *)get_zeroed_page(GFP_KERNEL);
847 return ERR_PTR(-ENOMEM);
848 kref_init(&t->count);
849 if (copy_from_user(t->data, buf, size))
850 return ERR_PTR(-EFAULT);
855 static ssize_t multi_transaction_read(struct file *file, char __user *buf,
856 size_t size, loff_t *pos)
858 struct multi_transaction *t;
861 spin_lock(&multi_transaction_lock);
862 t = get_multi_transaction(file->private_data);
863 spin_unlock(&multi_transaction_lock);
867 ret = simple_read_from_buffer(buf, size, pos, t->data, t->size);
868 put_multi_transaction(t);
873 static int multi_transaction_release(struct inode *inode, struct file *file)
875 put_multi_transaction(file->private_data);
880 #define QUERY_CMD_PROFILE "profile\0"
881 #define QUERY_CMD_PROFILE_LEN 8
883 #define QUERY_CMD_DATA "data\0"
884 #define QUERY_CMD_DATA_LEN 5
887 * aa_write_access - generic permissions and data query
888 * @file: pointer to open apparmorfs/access file
889 * @ubuf: user buffer containing the complete query string (NOT NULL)
890 * @count: size of ubuf
891 * @ppos: position in the file (MUST BE ZERO)
893 * Allows for one permissions or data query per open(), write(), and read()
894 * sequence. The only queries currently supported are label-based queries for
895 * permissions or data.
897 * For permissions queries, ubuf must begin with "label\0", followed by the
898 * profile query specific format described in the query_label() function
901 * For data queries, ubuf must have the form "data\0<LABEL>\0<KEY>\0", where
902 * <LABEL> is the name of the security confinement context and <KEY> is the
903 * name of the data to retrieve.
905 * Returns: number of bytes written or -errno on failure
907 static ssize_t aa_write_access(struct file *file, const char __user *ubuf,
908 size_t count, loff_t *ppos)
910 struct multi_transaction *t;
916 t = multi_transaction_new(file, ubuf, count);
920 if (count > QUERY_CMD_PROFILE_LEN &&
921 !memcmp(t->data, QUERY_CMD_PROFILE, QUERY_CMD_PROFILE_LEN)) {
922 len = query_label(t->data, MULTI_TRANSACTION_LIMIT,
923 t->data + QUERY_CMD_PROFILE_LEN,
924 count - QUERY_CMD_PROFILE_LEN, true);
925 } else if (count > QUERY_CMD_DATA_LEN &&
926 !memcmp(t->data, QUERY_CMD_DATA, QUERY_CMD_DATA_LEN)) {
927 len = query_data(t->data, MULTI_TRANSACTION_LIMIT,
928 t->data + QUERY_CMD_DATA_LEN,
929 count - QUERY_CMD_DATA_LEN);
934 put_multi_transaction(t);
938 multi_transaction_set(file, t, len);
943 static const struct file_operations aa_sfs_access = {
944 .write = aa_write_access,
945 .read = multi_transaction_read,
946 .release = multi_transaction_release,
947 .llseek = generic_file_llseek,
950 static int aa_sfs_seq_show(struct seq_file *seq, void *v)
952 struct aa_sfs_entry *fs_file = seq->private;
957 switch (fs_file->v_type) {
958 case AA_SFS_TYPE_BOOLEAN:
959 seq_printf(seq, "%s\n", fs_file->v.boolean ? "yes" : "no");
961 case AA_SFS_TYPE_STRING:
962 seq_printf(seq, "%s\n", fs_file->v.string);
964 case AA_SFS_TYPE_U64:
965 seq_printf(seq, "%#08lx\n", fs_file->v.u64);
968 /* Ignore unpritable entry types. */
975 static int aa_sfs_seq_open(struct inode *inode, struct file *file)
977 return single_open(file, aa_sfs_seq_show, inode->i_private);
980 const struct file_operations aa_sfs_seq_file_ops = {
981 .owner = THIS_MODULE,
982 .open = aa_sfs_seq_open,
985 .release = single_release,
989 * profile based file operations
990 * policy/profiles/XXXX/profiles/ *
993 #define SEQ_PROFILE_FOPS(NAME) \
994 static int seq_profile_ ##NAME ##_open(struct inode *inode, struct file *file)\
996 return seq_profile_open(inode, file, seq_profile_ ##NAME ##_show); \
999 static const struct file_operations seq_profile_ ##NAME ##_fops = { \
1000 .owner = THIS_MODULE, \
1001 .open = seq_profile_ ##NAME ##_open, \
1003 .llseek = seq_lseek, \
1004 .release = seq_profile_release, \
1007 static int seq_profile_open(struct inode *inode, struct file *file,
1008 int (*show)(struct seq_file *, void *))
1010 struct aa_proxy *proxy = aa_get_proxy(inode->i_private);
1011 int error = single_open(file, show, proxy);
1014 file->private_data = NULL;
1015 aa_put_proxy(proxy);
1021 static int seq_profile_release(struct inode *inode, struct file *file)
1023 struct seq_file *seq = (struct seq_file *) file->private_data;
1025 aa_put_proxy(seq->private);
1026 return single_release(inode, file);
1029 static int seq_profile_name_show(struct seq_file *seq, void *v)
1031 struct aa_proxy *proxy = seq->private;
1032 struct aa_label *label = aa_get_label_rcu(&proxy->label);
1033 struct aa_profile *profile = labels_profile(label);
1034 seq_printf(seq, "%s\n", profile->base.name);
1035 aa_put_label(label);
1040 static int seq_profile_mode_show(struct seq_file *seq, void *v)
1042 struct aa_proxy *proxy = seq->private;
1043 struct aa_label *label = aa_get_label_rcu(&proxy->label);
1044 struct aa_profile *profile = labels_profile(label);
1045 seq_printf(seq, "%s\n", aa_profile_mode_names[profile->mode]);
1046 aa_put_label(label);
1051 static int seq_profile_attach_show(struct seq_file *seq, void *v)
1053 struct aa_proxy *proxy = seq->private;
1054 struct aa_label *label = aa_get_label_rcu(&proxy->label);
1055 struct aa_profile *profile = labels_profile(label);
1056 if (profile->attach)
1057 seq_printf(seq, "%s\n", profile->attach);
1058 else if (profile->xmatch)
1059 seq_puts(seq, "<unknown>\n");
1061 seq_printf(seq, "%s\n", profile->base.name);
1062 aa_put_label(label);
1067 static int seq_profile_hash_show(struct seq_file *seq, void *v)
1069 struct aa_proxy *proxy = seq->private;
1070 struct aa_label *label = aa_get_label_rcu(&proxy->label);
1071 struct aa_profile *profile = labels_profile(label);
1072 unsigned int i, size = aa_hash_size();
1074 if (profile->hash) {
1075 for (i = 0; i < size; i++)
1076 seq_printf(seq, "%.2x", profile->hash[i]);
1077 seq_putc(seq, '\n');
1079 aa_put_label(label);
1084 SEQ_PROFILE_FOPS(name);
1085 SEQ_PROFILE_FOPS(mode);
1086 SEQ_PROFILE_FOPS(attach);
1087 SEQ_PROFILE_FOPS(hash);
1090 * namespace based files
1091 * several root files and
1095 #define SEQ_NS_FOPS(NAME) \
1096 static int seq_ns_ ##NAME ##_open(struct inode *inode, struct file *file) \
1098 return single_open(file, seq_ns_ ##NAME ##_show, inode->i_private); \
1101 static const struct file_operations seq_ns_ ##NAME ##_fops = { \
1102 .owner = THIS_MODULE, \
1103 .open = seq_ns_ ##NAME ##_open, \
1105 .llseek = seq_lseek, \
1106 .release = single_release, \
1109 static int seq_ns_level_show(struct seq_file *seq, void *v)
1111 struct aa_label *label;
1113 label = begin_current_label_crit_section();
1114 seq_printf(seq, "%d\n", labels_ns(label)->level);
1115 end_current_label_crit_section(label);
1120 static int seq_ns_name_show(struct seq_file *seq, void *v)
1122 struct aa_label *label = begin_current_label_crit_section();
1124 seq_printf(seq, "%s\n", aa_ns_name(labels_ns(label),
1125 labels_ns(label), true));
1126 end_current_label_crit_section(label);
1135 /* policy/raw_data/ * file ops */
1137 #define SEQ_RAWDATA_FOPS(NAME) \
1138 static int seq_rawdata_ ##NAME ##_open(struct inode *inode, struct file *file)\
1140 return seq_rawdata_open(inode, file, seq_rawdata_ ##NAME ##_show); \
1143 static const struct file_operations seq_rawdata_ ##NAME ##_fops = { \
1144 .owner = THIS_MODULE, \
1145 .open = seq_rawdata_ ##NAME ##_open, \
1147 .llseek = seq_lseek, \
1148 .release = seq_rawdata_release, \
1151 static int seq_rawdata_open(struct inode *inode, struct file *file,
1152 int (*show)(struct seq_file *, void *))
1154 struct aa_loaddata *data = __aa_get_loaddata(inode->i_private);
1158 /* lost race this ent is being reaped */
1161 error = single_open(file, show, data);
1163 AA_BUG(file->private_data &&
1164 ((struct seq_file *)file->private_data)->private);
1165 aa_put_loaddata(data);
1171 static int seq_rawdata_release(struct inode *inode, struct file *file)
1173 struct seq_file *seq = (struct seq_file *) file->private_data;
1176 aa_put_loaddata(seq->private);
1178 return single_release(inode, file);
1181 static int seq_rawdata_abi_show(struct seq_file *seq, void *v)
1183 struct aa_loaddata *data = seq->private;
1185 seq_printf(seq, "v%d\n", data->abi);
1190 static int seq_rawdata_revision_show(struct seq_file *seq, void *v)
1192 struct aa_loaddata *data = seq->private;
1194 seq_printf(seq, "%ld\n", data->revision);
1199 static int seq_rawdata_hash_show(struct seq_file *seq, void *v)
1201 struct aa_loaddata *data = seq->private;
1202 unsigned int i, size = aa_hash_size();
1205 for (i = 0; i < size; i++)
1206 seq_printf(seq, "%.2x", data->hash[i]);
1207 seq_putc(seq, '\n');
1213 SEQ_RAWDATA_FOPS(abi);
1214 SEQ_RAWDATA_FOPS(revision);
1215 SEQ_RAWDATA_FOPS(hash);
1217 static ssize_t rawdata_read(struct file *file, char __user *buf, size_t size,
1220 struct aa_loaddata *rawdata = file->private_data;
1222 return simple_read_from_buffer(buf, size, ppos, rawdata->data,
1226 static int rawdata_release(struct inode *inode, struct file *file)
1228 aa_put_loaddata(file->private_data);
1233 static int rawdata_open(struct inode *inode, struct file *file)
1235 if (!policy_view_capable(NULL))
1237 file->private_data = __aa_get_loaddata(inode->i_private);
1238 if (!file->private_data)
1239 /* lost race: this entry is being reaped */
1245 static const struct file_operations rawdata_fops = {
1246 .open = rawdata_open,
1247 .read = rawdata_read,
1248 .llseek = generic_file_llseek,
1249 .release = rawdata_release,
1252 static void remove_rawdata_dents(struct aa_loaddata *rawdata)
1256 for (i = 0; i < AAFS_LOADDATA_NDENTS; i++) {
1257 if (!IS_ERR_OR_NULL(rawdata->dents[i])) {
1258 /* no refcounts on i_private */
1259 aafs_remove(rawdata->dents[i]);
1260 rawdata->dents[i] = NULL;
1265 void __aa_fs_remove_rawdata(struct aa_loaddata *rawdata)
1267 AA_BUG(rawdata->ns && !mutex_is_locked(&rawdata->ns->lock));
1270 remove_rawdata_dents(rawdata);
1271 list_del_init(&rawdata->list);
1272 aa_put_ns(rawdata->ns);
1277 int __aa_fs_create_rawdata(struct aa_ns *ns, struct aa_loaddata *rawdata)
1279 struct dentry *dent, *dir;
1283 AA_BUG(!mutex_is_locked(&ns->lock));
1284 AA_BUG(!ns_subdata_dir(ns));
1287 * just use ns revision dir was originally created at. This is
1288 * under ns->lock and if load is successful revision will be
1289 * bumped and is guaranteed to be unique
1291 rawdata->name = kasprintf(GFP_KERNEL, "%ld", ns->revision);
1295 dir = aafs_create_dir(rawdata->name, ns_subdata_dir(ns));
1297 /* ->name freed when rawdata freed */
1298 return PTR_ERR(dir);
1299 rawdata->dents[AAFS_LOADDATA_DIR] = dir;
1301 dent = aafs_create_file("abi", S_IFREG | 0444, dir, rawdata,
1302 &seq_rawdata_abi_fops);
1305 rawdata->dents[AAFS_LOADDATA_ABI] = dent;
1307 dent = aafs_create_file("revision", S_IFREG | 0444, dir, rawdata,
1308 &seq_rawdata_revision_fops);
1311 rawdata->dents[AAFS_LOADDATA_REVISION] = dent;
1313 if (aa_g_hash_policy) {
1314 dent = aafs_create_file("sha1", S_IFREG | 0444, dir,
1315 rawdata, &seq_rawdata_hash_fops);
1318 rawdata->dents[AAFS_LOADDATA_HASH] = dent;
1321 dent = aafs_create_file("raw_data", S_IFREG | 0444,
1322 dir, rawdata, &rawdata_fops);
1325 rawdata->dents[AAFS_LOADDATA_DATA] = dent;
1326 d_inode(dent)->i_size = rawdata->size;
1328 rawdata->ns = aa_get_ns(ns);
1329 list_add(&rawdata->list, &ns->rawdata_list);
1330 /* no refcount on inode rawdata */
1335 remove_rawdata_dents(rawdata);
1337 return PTR_ERR(dent);
1340 /** fns to setup dynamic per profile/namespace files **/
1344 * Requires: @profile->ns->lock held
1346 void __aafs_profile_rmdir(struct aa_profile *profile)
1348 struct aa_profile *child;
1354 list_for_each_entry(child, &profile->base.profiles, base.list)
1355 __aafs_profile_rmdir(child);
1357 for (i = AAFS_PROF_SIZEOF - 1; i >= 0; --i) {
1358 struct aa_proxy *proxy;
1359 if (!profile->dents[i])
1362 proxy = d_inode(profile->dents[i])->i_private;
1363 aafs_remove(profile->dents[i]);
1364 aa_put_proxy(proxy);
1365 profile->dents[i] = NULL;
1371 * Requires: @old->ns->lock held
1373 void __aafs_profile_migrate_dents(struct aa_profile *old,
1374 struct aa_profile *new)
1378 for (i = 0; i < AAFS_PROF_SIZEOF; i++) {
1379 new->dents[i] = old->dents[i];
1381 new->dents[i]->d_inode->i_mtime = current_time(new->dents[i]->d_inode);
1382 old->dents[i] = NULL;
1386 static struct dentry *create_profile_file(struct dentry *dir, const char *name,
1387 struct aa_profile *profile,
1388 const struct file_operations *fops)
1390 struct aa_proxy *proxy = aa_get_proxy(profile->label.proxy);
1391 struct dentry *dent;
1393 dent = aafs_create_file(name, S_IFREG | 0444, dir, proxy, fops);
1395 aa_put_proxy(proxy);
1400 static int profile_depth(struct aa_profile *profile)
1405 for (depth = 0; profile; profile = rcu_access_pointer(profile->parent))
1412 static int gen_symlink_name(char *buffer, size_t bsize, int depth,
1413 const char *dirname, const char *fname)
1417 for (; depth > 0; depth--) {
1419 return -ENAMETOOLONG;
1420 strcpy(buffer, "../../");
1425 error = snprintf(buffer, bsize, "raw_data/%s/%s", dirname, fname);
1426 if (error >= bsize || error < 0)
1427 return -ENAMETOOLONG;
1433 * Requires: @profile->ns->lock held
1435 int __aafs_profile_mkdir(struct aa_profile *profile, struct dentry *parent)
1437 struct aa_profile *child;
1438 struct dentry *dent = NULL, *dir;
1442 struct aa_profile *p;
1443 p = aa_deref_parent(profile);
1445 /* adding to parent that previously didn't have children */
1446 dent = aafs_create_dir("profiles", dent);
1449 prof_child_dir(p) = parent = dent;
1452 if (!profile->dirname) {
1454 len = mangle_name(profile->base.name, NULL);
1455 id_len = snprintf(NULL, 0, ".%ld", profile->ns->uniq_id);
1457 profile->dirname = kmalloc(len + id_len + 1, GFP_KERNEL);
1458 if (!profile->dirname) {
1463 mangle_name(profile->base.name, profile->dirname);
1464 sprintf(profile->dirname + len, ".%ld", profile->ns->uniq_id++);
1467 dent = aafs_create_dir(profile->dirname, parent);
1470 prof_dir(profile) = dir = dent;
1472 dent = create_profile_file(dir, "name", profile,
1473 &seq_profile_name_fops);
1476 profile->dents[AAFS_PROF_NAME] = dent;
1478 dent = create_profile_file(dir, "mode", profile,
1479 &seq_profile_mode_fops);
1482 profile->dents[AAFS_PROF_MODE] = dent;
1484 dent = create_profile_file(dir, "attach", profile,
1485 &seq_profile_attach_fops);
1488 profile->dents[AAFS_PROF_ATTACH] = dent;
1490 if (profile->hash) {
1491 dent = create_profile_file(dir, "sha1", profile,
1492 &seq_profile_hash_fops);
1495 profile->dents[AAFS_PROF_HASH] = dent;
1498 if (profile->rawdata) {
1500 int depth = profile_depth(profile);
1502 error = gen_symlink_name(target, sizeof(target), depth,
1503 profile->rawdata->name, "sha1");
1506 dent = aafs_create_symlink("raw_sha1", dir, target, NULL);
1509 profile->dents[AAFS_PROF_RAW_HASH] = dent;
1511 error = gen_symlink_name(target, sizeof(target), depth,
1512 profile->rawdata->name, "abi");
1515 dent = aafs_create_symlink("raw_abi", dir, target, NULL);
1518 profile->dents[AAFS_PROF_RAW_ABI] = dent;
1520 error = gen_symlink_name(target, sizeof(target), depth,
1521 profile->rawdata->name, "raw_data");
1524 dent = aafs_create_symlink("raw_data", dir, target, NULL);
1527 profile->dents[AAFS_PROF_RAW_DATA] = dent;
1530 list_for_each_entry(child, &profile->base.profiles, base.list) {
1531 error = __aafs_profile_mkdir(child, prof_child_dir(profile));
1539 error = PTR_ERR(dent);
1542 __aafs_profile_rmdir(profile);
1547 static int ns_mkdir_op(struct inode *dir, struct dentry *dentry, umode_t mode)
1549 struct aa_ns *ns, *parent;
1550 /* TODO: improve permission check */
1551 struct aa_label *label;
1554 label = begin_current_label_crit_section();
1555 error = aa_may_manage_policy(label, NULL, AA_MAY_LOAD_POLICY);
1556 end_current_label_crit_section(label);
1560 parent = aa_get_ns(dir->i_private);
1561 AA_BUG(d_inode(ns_subns_dir(parent)) != dir);
1563 /* we have to unlock and then relock to get locking order right
1567 error = simple_pin_fs(&aafs_ops, &aafs_mnt, &aafs_count);
1568 mutex_lock(&parent->lock);
1569 inode_lock_nested(dir, I_MUTEX_PARENT);
1573 error = __aafs_setup_d_inode(dir, dentry, mode | S_IFDIR, NULL,
1578 ns = __aa_find_or_create_ns(parent, READ_ONCE(dentry->d_name.name),
1581 error = PTR_ERR(ns);
1585 aa_put_ns(ns); /* list ref remains */
1588 simple_release_fs(&aafs_mnt, &aafs_count);
1590 mutex_unlock(&parent->lock);
1596 static int ns_rmdir_op(struct inode *dir, struct dentry *dentry)
1598 struct aa_ns *ns, *parent;
1599 /* TODO: improve permission check */
1600 struct aa_label *label;
1603 label = begin_current_label_crit_section();
1604 error = aa_may_manage_policy(label, NULL, AA_MAY_LOAD_POLICY);
1605 end_current_label_crit_section(label);
1609 parent = aa_get_ns(dir->i_private);
1610 /* rmdir calls the generic securityfs functions to remove files
1611 * from the apparmor dir. It is up to the apparmor ns locking
1615 inode_unlock(dentry->d_inode);
1617 mutex_lock(&parent->lock);
1618 ns = aa_get_ns(__aa_findn_ns(&parent->sub_ns, dentry->d_name.name,
1619 dentry->d_name.len));
1624 AA_BUG(ns_dir(ns) != dentry);
1630 mutex_unlock(&parent->lock);
1631 inode_lock_nested(dir, I_MUTEX_PARENT);
1632 inode_lock(dentry->d_inode);
1638 static const struct inode_operations ns_dir_inode_operations = {
1639 .lookup = simple_lookup,
1640 .mkdir = ns_mkdir_op,
1641 .rmdir = ns_rmdir_op,
1644 static void __aa_fs_list_remove_rawdata(struct aa_ns *ns)
1646 struct aa_loaddata *ent, *tmp;
1648 AA_BUG(!mutex_is_locked(&ns->lock));
1650 list_for_each_entry_safe(ent, tmp, &ns->rawdata_list, list)
1651 __aa_fs_remove_rawdata(ent);
1656 * Requires: @ns->lock held
1658 void __aafs_ns_rmdir(struct aa_ns *ns)
1661 struct aa_profile *child;
1667 list_for_each_entry(child, &ns->base.profiles, base.list)
1668 __aafs_profile_rmdir(child);
1670 list_for_each_entry(sub, &ns->sub_ns, base.list) {
1671 mutex_lock(&sub->lock);
1672 __aafs_ns_rmdir(sub);
1673 mutex_unlock(&sub->lock);
1676 __aa_fs_list_remove_rawdata(ns);
1678 if (ns_subns_dir(ns)) {
1679 sub = d_inode(ns_subns_dir(ns))->i_private;
1682 if (ns_subload(ns)) {
1683 sub = d_inode(ns_subload(ns))->i_private;
1686 if (ns_subreplace(ns)) {
1687 sub = d_inode(ns_subreplace(ns))->i_private;
1690 if (ns_subremove(ns)) {
1691 sub = d_inode(ns_subremove(ns))->i_private;
1694 if (ns_subrevision(ns)) {
1695 sub = d_inode(ns_subrevision(ns))->i_private;
1699 for (i = AAFS_NS_SIZEOF - 1; i >= 0; --i) {
1700 aafs_remove(ns->dents[i]);
1701 ns->dents[i] = NULL;
1705 /* assumes cleanup in caller */
1706 static int __aafs_ns_mkdir_entries(struct aa_ns *ns, struct dentry *dir)
1708 struct dentry *dent;
1713 dent = aafs_create_dir("profiles", dir);
1715 return PTR_ERR(dent);
1716 ns_subprofs_dir(ns) = dent;
1718 dent = aafs_create_dir("raw_data", dir);
1720 return PTR_ERR(dent);
1721 ns_subdata_dir(ns) = dent;
1723 dent = aafs_create_file("revision", 0444, dir, ns,
1724 &aa_fs_ns_revision_fops);
1726 return PTR_ERR(dent);
1728 ns_subrevision(ns) = dent;
1730 dent = aafs_create_file(".load", 0640, dir, ns,
1731 &aa_fs_profile_load);
1733 return PTR_ERR(dent);
1735 ns_subload(ns) = dent;
1737 dent = aafs_create_file(".replace", 0640, dir, ns,
1738 &aa_fs_profile_replace);
1740 return PTR_ERR(dent);
1742 ns_subreplace(ns) = dent;
1744 dent = aafs_create_file(".remove", 0640, dir, ns,
1745 &aa_fs_profile_remove);
1747 return PTR_ERR(dent);
1749 ns_subremove(ns) = dent;
1751 /* use create_dentry so we can supply private data */
1752 dent = aafs_create("namespaces", S_IFDIR | 0755, dir, ns, NULL, NULL,
1753 &ns_dir_inode_operations);
1755 return PTR_ERR(dent);
1757 ns_subns_dir(ns) = dent;
1763 * Requires: @ns->lock held
1765 int __aafs_ns_mkdir(struct aa_ns *ns, struct dentry *parent, const char *name,
1766 struct dentry *dent)
1769 struct aa_profile *child;
1775 AA_BUG(!mutex_is_locked(&ns->lock));
1778 name = ns->base.name;
1781 /* create ns dir if it doesn't already exist */
1782 dent = aafs_create_dir(name, parent);
1787 ns_dir(ns) = dir = dent;
1788 error = __aafs_ns_mkdir_entries(ns, dir);
1793 list_for_each_entry(child, &ns->base.profiles, base.list) {
1794 error = __aafs_profile_mkdir(child, ns_subprofs_dir(ns));
1800 list_for_each_entry(sub, &ns->sub_ns, base.list) {
1801 mutex_lock(&sub->lock);
1802 error = __aafs_ns_mkdir(sub, ns_subns_dir(ns), NULL, NULL);
1803 mutex_unlock(&sub->lock);
1811 error = PTR_ERR(dent);
1814 __aafs_ns_rmdir(ns);
1820 #define list_entry_is_head(pos, head, member) (&pos->member == (head))
1823 * __next_ns - find the next namespace to list
1824 * @root: root namespace to stop search at (NOT NULL)
1825 * @ns: current ns position (NOT NULL)
1827 * Find the next namespace from @ns under @root and handle all locking needed
1828 * while switching current namespace.
1830 * Returns: next namespace or NULL if at last namespace under @root
1831 * Requires: ns->parent->lock to be held
1832 * NOTE: will not unlock root->lock
1834 static struct aa_ns *__next_ns(struct aa_ns *root, struct aa_ns *ns)
1836 struct aa_ns *parent, *next;
1838 /* is next namespace a child */
1839 if (!list_empty(&ns->sub_ns)) {
1840 next = list_first_entry(&ns->sub_ns, typeof(*ns), base.list);
1841 mutex_lock(&next->lock);
1845 /* check if the next ns is a sibling, parent, gp, .. */
1846 parent = ns->parent;
1847 while (ns != root) {
1848 mutex_unlock(&ns->lock);
1849 next = list_next_entry(ns, base.list);
1850 if (!list_entry_is_head(next, &parent->sub_ns, base.list)) {
1851 mutex_lock(&next->lock);
1855 parent = parent->parent;
1862 * __first_profile - find the first profile in a namespace
1863 * @root: namespace that is root of profiles being displayed (NOT NULL)
1864 * @ns: namespace to start in (NOT NULL)
1866 * Returns: unrefcounted profile or NULL if no profile
1867 * Requires: profile->ns.lock to be held
1869 static struct aa_profile *__first_profile(struct aa_ns *root,
1872 for (; ns; ns = __next_ns(root, ns)) {
1873 if (!list_empty(&ns->base.profiles))
1874 return list_first_entry(&ns->base.profiles,
1875 struct aa_profile, base.list);
1881 * __next_profile - step to the next profile in a profile tree
1882 * @profile: current profile in tree (NOT NULL)
1884 * Perform a depth first traversal on the profile tree in a namespace
1886 * Returns: next profile or NULL if done
1887 * Requires: profile->ns.lock to be held
1889 static struct aa_profile *__next_profile(struct aa_profile *p)
1891 struct aa_profile *parent;
1892 struct aa_ns *ns = p->ns;
1894 /* is next profile a child */
1895 if (!list_empty(&p->base.profiles))
1896 return list_first_entry(&p->base.profiles, typeof(*p),
1899 /* is next profile a sibling, parent sibling, gp, sibling, .. */
1900 parent = rcu_dereference_protected(p->parent,
1901 mutex_is_locked(&p->ns->lock));
1903 p = list_next_entry(p, base.list);
1904 if (!list_entry_is_head(p, &parent->base.profiles, base.list))
1907 parent = rcu_dereference_protected(parent->parent,
1908 mutex_is_locked(&parent->ns->lock));
1911 /* is next another profile in the namespace */
1912 p = list_next_entry(p, base.list);
1913 if (!list_entry_is_head(p, &ns->base.profiles, base.list))
1920 * next_profile - step to the next profile in where ever it may be
1921 * @root: root namespace (NOT NULL)
1922 * @profile: current profile (NOT NULL)
1924 * Returns: next profile or NULL if there isn't one
1926 static struct aa_profile *next_profile(struct aa_ns *root,
1927 struct aa_profile *profile)
1929 struct aa_profile *next = __next_profile(profile);
1933 /* finished all profiles in namespace move to next namespace */
1934 return __first_profile(root, __next_ns(root, profile->ns));
1938 * p_start - start a depth first traversal of profile tree
1939 * @f: seq_file to fill
1940 * @pos: current position
1942 * Returns: first profile under current namespace or NULL if none found
1944 * acquires first ns->lock
1946 static void *p_start(struct seq_file *f, loff_t *pos)
1948 struct aa_profile *profile = NULL;
1949 struct aa_ns *root = aa_get_current_ns();
1953 /* find the first profile */
1954 mutex_lock(&root->lock);
1955 profile = __first_profile(root, root);
1957 /* skip to position */
1958 for (; profile && l > 0; l--)
1959 profile = next_profile(root, profile);
1965 * p_next - read the next profile entry
1966 * @f: seq_file to fill
1967 * @p: profile previously returned
1968 * @pos: current position
1970 * Returns: next profile after @p or NULL if none
1972 * may acquire/release locks in namespace tree as necessary
1974 static void *p_next(struct seq_file *f, void *p, loff_t *pos)
1976 struct aa_profile *profile = p;
1977 struct aa_ns *ns = f->private;
1980 return next_profile(ns, profile);
1984 * p_stop - stop depth first traversal
1985 * @f: seq_file we are filling
1986 * @p: the last profile writen
1988 * Release all locking done by p_start/p_next on namespace tree
1990 static void p_stop(struct seq_file *f, void *p)
1992 struct aa_profile *profile = p;
1993 struct aa_ns *root = f->private, *ns;
1996 for (ns = profile->ns; ns && ns != root; ns = ns->parent)
1997 mutex_unlock(&ns->lock);
1999 mutex_unlock(&root->lock);
2004 * seq_show_profile - show a profile entry
2005 * @f: seq_file to file
2006 * @p: current position (profile) (NOT NULL)
2008 * Returns: error on failure
2010 static int seq_show_profile(struct seq_file *f, void *p)
2012 struct aa_profile *profile = (struct aa_profile *)p;
2013 struct aa_ns *root = f->private;
2015 aa_label_seq_xprint(f, root, &profile->label,
2016 FLAG_SHOW_MODE | FLAG_VIEW_SUBNS, GFP_KERNEL);
2022 static const struct seq_operations aa_sfs_profiles_op = {
2026 .show = seq_show_profile,
2029 static int profiles_open(struct inode *inode, struct file *file)
2031 if (!policy_view_capable(NULL))
2034 return seq_open(file, &aa_sfs_profiles_op);
2037 static int profiles_release(struct inode *inode, struct file *file)
2039 return seq_release(inode, file);
2042 static const struct file_operations aa_sfs_profiles_fops = {
2043 .open = profiles_open,
2045 .llseek = seq_lseek,
2046 .release = profiles_release,
2050 /** Base file system setup **/
2051 static struct aa_sfs_entry aa_sfs_entry_file[] = {
2052 AA_SFS_FILE_STRING("mask",
2053 "create read write exec append mmap_exec link lock"),
2057 static struct aa_sfs_entry aa_sfs_entry_domain[] = {
2058 AA_SFS_FILE_BOOLEAN("change_hat", 1),
2059 AA_SFS_FILE_BOOLEAN("change_hatv", 1),
2060 AA_SFS_FILE_BOOLEAN("change_onexec", 1),
2061 AA_SFS_FILE_BOOLEAN("change_profile", 1),
2062 AA_SFS_FILE_BOOLEAN("fix_binfmt_elf_mmap", 1),
2063 AA_SFS_FILE_STRING("version", "1.2"),
2067 static struct aa_sfs_entry aa_sfs_entry_versions[] = {
2068 AA_SFS_FILE_BOOLEAN("v5", 1),
2072 static struct aa_sfs_entry aa_sfs_entry_policy[] = {
2073 AA_SFS_DIR("versions", aa_sfs_entry_versions),
2074 AA_SFS_FILE_BOOLEAN("set_load", 1),
2078 static struct aa_sfs_entry aa_sfs_entry_query_label[] = {
2079 AA_SFS_FILE_STRING("perms", "allow deny audit quiet"),
2080 AA_SFS_FILE_BOOLEAN("data", 1),
2081 AA_SFS_FILE_BOOLEAN("multi_transaction", 1),
2085 static struct aa_sfs_entry aa_sfs_entry_query[] = {
2086 AA_SFS_DIR("label", aa_sfs_entry_query_label),
2089 static struct aa_sfs_entry aa_sfs_entry_features[] = {
2090 AA_SFS_DIR("policy", aa_sfs_entry_policy),
2091 AA_SFS_DIR("domain", aa_sfs_entry_domain),
2092 AA_SFS_DIR("file", aa_sfs_entry_file),
2093 AA_SFS_FILE_U64("capability", VFS_CAP_FLAGS_MASK),
2094 AA_SFS_DIR("rlimit", aa_sfs_entry_rlimit),
2095 AA_SFS_DIR("caps", aa_sfs_entry_caps),
2096 AA_SFS_DIR("query", aa_sfs_entry_query),
2100 static struct aa_sfs_entry aa_sfs_entry_apparmor[] = {
2101 AA_SFS_FILE_FOPS(".access", 0640, &aa_sfs_access),
2102 AA_SFS_FILE_FOPS(".ns_level", 0666, &seq_ns_level_fops),
2103 AA_SFS_FILE_FOPS(".ns_name", 0640, &seq_ns_name_fops),
2104 AA_SFS_FILE_FOPS("profiles", 0440, &aa_sfs_profiles_fops),
2105 AA_SFS_DIR("features", aa_sfs_entry_features),
2109 static struct aa_sfs_entry aa_sfs_entry =
2110 AA_SFS_DIR("apparmor", aa_sfs_entry_apparmor);
2113 * entry_create_file - create a file entry in the apparmor securityfs
2114 * @fs_file: aa_sfs_entry to build an entry for (NOT NULL)
2115 * @parent: the parent dentry in the securityfs
2117 * Use entry_remove_file to remove entries created with this fn.
2119 static int __init entry_create_file(struct aa_sfs_entry *fs_file,
2120 struct dentry *parent)
2124 fs_file->dentry = securityfs_create_file(fs_file->name,
2125 S_IFREG | fs_file->mode,
2128 if (IS_ERR(fs_file->dentry)) {
2129 error = PTR_ERR(fs_file->dentry);
2130 fs_file->dentry = NULL;
2135 static void __init entry_remove_dir(struct aa_sfs_entry *fs_dir);
2137 * entry_create_dir - recursively create a directory entry in the securityfs
2138 * @fs_dir: aa_sfs_entry (and all child entries) to build (NOT NULL)
2139 * @parent: the parent dentry in the securityfs
2141 * Use entry_remove_dir to remove entries created with this fn.
2143 static int __init entry_create_dir(struct aa_sfs_entry *fs_dir,
2144 struct dentry *parent)
2146 struct aa_sfs_entry *fs_file;
2150 dir = securityfs_create_dir(fs_dir->name, parent);
2152 return PTR_ERR(dir);
2153 fs_dir->dentry = dir;
2155 for (fs_file = fs_dir->v.files; fs_file && fs_file->name; ++fs_file) {
2156 if (fs_file->v_type == AA_SFS_TYPE_DIR)
2157 error = entry_create_dir(fs_file, fs_dir->dentry);
2159 error = entry_create_file(fs_file, fs_dir->dentry);
2167 entry_remove_dir(fs_dir);
2173 * entry_remove_file - drop a single file entry in the apparmor securityfs
2174 * @fs_file: aa_sfs_entry to detach from the securityfs (NOT NULL)
2176 static void __init entry_remove_file(struct aa_sfs_entry *fs_file)
2178 if (!fs_file->dentry)
2181 securityfs_remove(fs_file->dentry);
2182 fs_file->dentry = NULL;
2186 * entry_remove_dir - recursively drop a directory entry from the securityfs
2187 * @fs_dir: aa_sfs_entry (and all child entries) to detach (NOT NULL)
2189 static void __init entry_remove_dir(struct aa_sfs_entry *fs_dir)
2191 struct aa_sfs_entry *fs_file;
2193 for (fs_file = fs_dir->v.files; fs_file && fs_file->name; ++fs_file) {
2194 if (fs_file->v_type == AA_SFS_TYPE_DIR)
2195 entry_remove_dir(fs_file);
2197 entry_remove_file(fs_file);
2200 entry_remove_file(fs_dir);
2204 * aa_destroy_aafs - cleanup and free aafs
2206 * releases dentries allocated by aa_create_aafs
2208 void __init aa_destroy_aafs(void)
2210 entry_remove_dir(&aa_sfs_entry);
2214 #define NULL_FILE_NAME ".null"
2215 struct path aa_null;
2217 static int aa_mk_null_file(struct dentry *parent)
2219 struct vfsmount *mount = NULL;
2220 struct dentry *dentry;
2221 struct inode *inode;
2223 int error = simple_pin_fs(parent->d_sb->s_type, &mount, &count);
2228 inode_lock(d_inode(parent));
2229 dentry = lookup_one_len(NULL_FILE_NAME, parent, strlen(NULL_FILE_NAME));
2230 if (IS_ERR(dentry)) {
2231 error = PTR_ERR(dentry);
2234 inode = new_inode(parent->d_inode->i_sb);
2240 inode->i_ino = get_next_ino();
2241 inode->i_mode = S_IFCHR | S_IRUGO | S_IWUGO;
2242 inode->i_atime = inode->i_mtime = inode->i_ctime = current_time(inode);
2243 init_special_inode(inode, S_IFCHR | S_IRUGO | S_IWUGO,
2244 MKDEV(MEM_MAJOR, 3));
2245 d_instantiate(dentry, inode);
2246 aa_null.dentry = dget(dentry);
2247 aa_null.mnt = mntget(mount);
2254 inode_unlock(d_inode(parent));
2255 simple_release_fs(&mount, &count);
2261 static const char *policy_get_link(struct dentry *dentry,
2262 struct inode *inode,
2263 struct delayed_call *done)
2269 return ERR_PTR(-ECHILD);
2270 ns = aa_get_current_ns();
2271 path.mnt = mntget(aafs_mnt);
2272 path.dentry = dget(ns_dir(ns));
2273 nd_jump_link(&path);
2279 static int ns_get_name(char *buf, size_t size, struct aa_ns *ns,
2280 struct inode *inode)
2282 int res = snprintf(buf, size, "%s:[%lu]", AAFS_NAME, inode->i_ino);
2284 if (res < 0 || res >= size)
2290 static int policy_readlink(struct dentry *dentry, char __user *buffer,
2297 ns = aa_get_current_ns();
2298 res = ns_get_name(name, sizeof(name), ns, d_inode(dentry));
2300 res = readlink_copy(buffer, buflen, name);
2306 static const struct inode_operations policy_link_iops = {
2307 .readlink = policy_readlink,
2308 .get_link = policy_get_link,
2313 * aa_create_aafs - create the apparmor security filesystem
2315 * dentries created here are released by aa_destroy_aafs
2317 * Returns: error on failure
2319 static int __init aa_create_aafs(void)
2321 struct dentry *dent;
2324 if (!apparmor_initialized)
2327 if (aa_sfs_entry.dentry) {
2328 AA_ERROR("%s: AppArmor securityfs already exists\n", __func__);
2332 /* setup apparmorfs used to virtualize policy/ */
2333 aafs_mnt = kern_mount(&aafs_ops);
2334 if (IS_ERR(aafs_mnt))
2335 panic("can't set apparmorfs up\n");
2336 aafs_mnt->mnt_sb->s_flags &= ~MS_NOUSER;
2338 /* Populate fs tree. */
2339 error = entry_create_dir(&aa_sfs_entry, NULL);
2343 dent = securityfs_create_file(".load", 0666, aa_sfs_entry.dentry,
2344 NULL, &aa_fs_profile_load);
2346 error = PTR_ERR(dent);
2349 ns_subload(root_ns) = dent;
2351 dent = securityfs_create_file(".replace", 0666, aa_sfs_entry.dentry,
2352 NULL, &aa_fs_profile_replace);
2354 error = PTR_ERR(dent);
2357 ns_subreplace(root_ns) = dent;
2359 dent = securityfs_create_file(".remove", 0666, aa_sfs_entry.dentry,
2360 NULL, &aa_fs_profile_remove);
2362 error = PTR_ERR(dent);
2365 ns_subremove(root_ns) = dent;
2367 dent = securityfs_create_file("revision", 0444, aa_sfs_entry.dentry,
2368 NULL, &aa_fs_ns_revision_fops);
2370 error = PTR_ERR(dent);
2373 ns_subrevision(root_ns) = dent;
2375 /* policy tree referenced by magic policy symlink */
2376 mutex_lock(&root_ns->lock);
2377 error = __aafs_ns_mkdir(root_ns, aafs_mnt->mnt_root, ".policy",
2378 aafs_mnt->mnt_root);
2379 mutex_unlock(&root_ns->lock);
2383 /* magic symlink similar to nsfs redirects based on task policy */
2384 dent = securityfs_create_symlink("policy", aa_sfs_entry.dentry,
2385 NULL, &policy_link_iops);
2387 error = PTR_ERR(dent);
2391 error = aa_mk_null_file(aa_sfs_entry.dentry);
2395 /* TODO: add default profile to apparmorfs */
2397 /* Report that AppArmor fs is enabled */
2398 aa_info_message("AppArmor Filesystem Enabled");
2403 AA_ERROR("Error creating AppArmor securityfs\n");
2407 fs_initcall(aa_create_aafs);