1 /*
2 * AppArmor security module
3 *
4 * This file contains AppArmor policy manipulation functions
5 *
6 * Copyright (C) 1998-2008 Novell/SUSE
7 * Copyright 2009-2017 Canonical Ltd.
8 *
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
12 * License.
13 *
14 * AppArmor policy namespaces, allow for different sets of policies
15 * to be loaded for tasks within the namespace.
16 */
17
18 #include <linux/list.h>
19 #include <linux/mutex.h>
20 #include <linux/slab.h>
21 #include <linux/string.h>
22
23 #include "include/apparmor.h"
24 #include "include/context.h"
25 #include "include/policy_ns.h"
26 #include "include/label.h"
27 #include "include/policy.h"
28
29 /* root profile namespace */
30 struct aa_ns *root_ns;
31 const char *aa_hidden_ns_name = "---";
32
33 /**
34 * aa_ns_visible - test if @view is visible from @curr
35 * @curr: namespace to treat as the parent (NOT NULL)
36 * @view: namespace to test if visible from @curr (NOT NULL)
37 * @subns: whether view of a subns is allowed
38 *
39 * Returns: true if @view is visible from @curr else false
40 */
aa_ns_visible(struct aa_ns * curr,struct aa_ns * view,bool subns)41 bool aa_ns_visible(struct aa_ns *curr, struct aa_ns *view, bool subns)
42 {
43 if (curr == view)
44 return true;
45
46 if (!subns)
47 return false;
48
49 for ( ; view; view = view->parent) {
50 if (view->parent == curr)
51 return true;
52 }
53
54 return false;
55 }
56
57 /**
58 * aa_na_name - Find the ns name to display for @view from @curr
59 * @curr - current namespace (NOT NULL)
60 * @view - namespace attempting to view (NOT NULL)
61 * @subns - are subns visible
62 *
63 * Returns: name of @view visible from @curr
64 */
aa_ns_name(struct aa_ns * curr,struct aa_ns * view,bool subns)65 const char *aa_ns_name(struct aa_ns *curr, struct aa_ns *view, bool subns)
66 {
67 /* if view == curr then the namespace name isn't displayed */
68 if (curr == view)
69 return "";
70
71 if (aa_ns_visible(curr, view, subns)) {
72 /* at this point if a ns is visible it is in a view ns
73 * thus the curr ns.hname is a prefix of its name.
74 * Only output the virtualized portion of the name
75 * Add + 2 to skip over // separating curr hname prefix
76 * from the visible tail of the views hname
77 */
78 return view->base.hname + strlen(curr->base.hname) + 2;
79 }
80
81 return aa_hidden_ns_name;
82 }
83
84 /**
85 * alloc_ns - allocate, initialize and return a new namespace
86 * @prefix: parent namespace name (MAYBE NULL)
87 * @name: a preallocated name (NOT NULL)
88 *
89 * Returns: refcounted namespace or NULL on failure.
90 */
alloc_ns(const char * prefix,const char * name)91 static struct aa_ns *alloc_ns(const char *prefix, const char *name)
92 {
93 struct aa_ns *ns;
94
95 ns = kzalloc(sizeof(*ns), GFP_KERNEL);
96 AA_DEBUG("%s(%p)\n", __func__, ns);
97 if (!ns)
98 return NULL;
99 if (!aa_policy_init(&ns->base, prefix, name, GFP_KERNEL))
100 goto fail_ns;
101
102 INIT_LIST_HEAD(&ns->sub_ns);
103 INIT_LIST_HEAD(&ns->rawdata_list);
104 mutex_init(&ns->lock);
105 init_waitqueue_head(&ns->wait);
106
107 /* released by aa_free_ns() */
108 ns->unconfined = aa_alloc_profile("unconfined", NULL, GFP_KERNEL);
109 if (!ns->unconfined)
110 goto fail_unconfined;
111
112 ns->unconfined->label.flags |= FLAG_IX_ON_NAME_ERROR |
113 FLAG_IMMUTIBLE | FLAG_NS_COUNT | FLAG_UNCONFINED;
114 ns->unconfined->mode = APPARMOR_UNCONFINED;
115 ns->unconfined->file.dfa = aa_get_dfa(nulldfa);
116 ns->unconfined->policy.dfa = aa_get_dfa(nulldfa);
117
118 /* ns and ns->unconfined share ns->unconfined refcount */
119 ns->unconfined->ns = ns;
120
121 atomic_set(&ns->uniq_null, 0);
122
123 aa_labelset_init(&ns->labels);
124
125 return ns;
126
127 fail_unconfined:
128 kzfree(ns->base.hname);
129 fail_ns:
130 kzfree(ns);
131 return NULL;
132 }
133
134 /**
135 * aa_free_ns - free a profile namespace
136 * @ns: the namespace to free (MAYBE NULL)
137 *
138 * Requires: All references to the namespace must have been put, if the
139 * namespace was referenced by a profile confining a task,
140 */
aa_free_ns(struct aa_ns * ns)141 void aa_free_ns(struct aa_ns *ns)
142 {
143 if (!ns)
144 return;
145
146 aa_policy_destroy(&ns->base);
147 aa_labelset_destroy(&ns->labels);
148 aa_put_ns(ns->parent);
149
150 ns->unconfined->ns = NULL;
151 aa_free_profile(ns->unconfined);
152 kzfree(ns);
153 }
154
155 /**
156 * aa_findn_ns - look up a profile namespace on the namespace list
157 * @root: namespace to search in (NOT NULL)
158 * @name: name of namespace to find (NOT NULL)
159 * @n: length of @name
160 *
161 * Returns: a refcounted namespace on the list, or NULL if no namespace
162 * called @name exists.
163 *
164 * refcount released by caller
165 */
aa_findn_ns(struct aa_ns * root,const char * name,size_t n)166 struct aa_ns *aa_findn_ns(struct aa_ns *root, const char *name, size_t n)
167 {
168 struct aa_ns *ns = NULL;
169
170 rcu_read_lock();
171 ns = aa_get_ns(__aa_findn_ns(&root->sub_ns, name, n));
172 rcu_read_unlock();
173
174 return ns;
175 }
176
177 /**
178 * aa_find_ns - look up a profile namespace on the namespace list
179 * @root: namespace to search in (NOT NULL)
180 * @name: name of namespace to find (NOT NULL)
181 *
182 * Returns: a refcounted namespace on the list, or NULL if no namespace
183 * called @name exists.
184 *
185 * refcount released by caller
186 */
aa_find_ns(struct aa_ns * root,const char * name)187 struct aa_ns *aa_find_ns(struct aa_ns *root, const char *name)
188 {
189 return aa_findn_ns(root, name, strlen(name));
190 }
191
192 /**
193 * __aa_lookupn_ns - lookup the namespace matching @hname
194 * @base: base list to start looking up profile name from (NOT NULL)
195 * @hname: hierarchical ns name (NOT NULL)
196 * @n: length of @hname
197 *
198 * Requires: rcu_read_lock be held
199 *
200 * Returns: unrefcounted ns pointer or NULL if not found
201 *
202 * Do a relative name lookup, recursing through profile tree.
203 */
__aa_lookupn_ns(struct aa_ns * view,const char * hname,size_t n)204 struct aa_ns *__aa_lookupn_ns(struct aa_ns *view, const char *hname, size_t n)
205 {
206 struct aa_ns *ns = view;
207 const char *split;
208
209 for (split = strnstr(hname, "//", n); split;
210 split = strnstr(hname, "//", n)) {
211 ns = __aa_findn_ns(&ns->sub_ns, hname, split - hname);
212 if (!ns)
213 return NULL;
214
215 n -= split + 2 - hname;
216 hname = split + 2;
217 }
218
219 if (n)
220 return __aa_findn_ns(&ns->sub_ns, hname, n);
221 return NULL;
222 }
223
224 /**
225 * aa_lookupn_ns - look up a policy namespace relative to @view
226 * @view: namespace to search in (NOT NULL)
227 * @name: name of namespace to find (NOT NULL)
228 * @n: length of @name
229 *
230 * Returns: a refcounted namespace on the list, or NULL if no namespace
231 * called @name exists.
232 *
233 * refcount released by caller
234 */
aa_lookupn_ns(struct aa_ns * view,const char * name,size_t n)235 struct aa_ns *aa_lookupn_ns(struct aa_ns *view, const char *name, size_t n)
236 {
237 struct aa_ns *ns = NULL;
238
239 rcu_read_lock();
240 ns = aa_get_ns(__aa_lookupn_ns(view, name, n));
241 rcu_read_unlock();
242
243 return ns;
244 }
245
__aa_create_ns(struct aa_ns * parent,const char * name,struct dentry * dir)246 static struct aa_ns *__aa_create_ns(struct aa_ns *parent, const char *name,
247 struct dentry *dir)
248 {
249 struct aa_ns *ns;
250 int error;
251
252 AA_BUG(!parent);
253 AA_BUG(!name);
254 AA_BUG(!mutex_is_locked(&parent->lock));
255
256 ns = alloc_ns(parent->base.hname, name);
257 if (!ns)
258 return NULL;
259 mutex_lock(&ns->lock);
260 error = __aafs_ns_mkdir(ns, ns_subns_dir(parent), name, dir);
261 if (error) {
262 AA_ERROR("Failed to create interface for ns %s\n",
263 ns->base.name);
264 mutex_unlock(&ns->lock);
265 aa_free_ns(ns);
266 return ERR_PTR(error);
267 }
268 ns->parent = aa_get_ns(parent);
269 ns->level = parent->level + 1;
270 list_add_rcu(&ns->base.list, &parent->sub_ns);
271 /* add list ref */
272 aa_get_ns(ns);
273 mutex_unlock(&ns->lock);
274
275 return ns;
276 }
277
278 /**
279 * aa_create_ns - create an ns, fail if it already exists
280 * @parent: the parent of the namespace being created
281 * @name: the name of the namespace
282 * @dir: if not null the dir to put the ns entries in
283 *
284 * Returns: the a refcounted ns that has been add or an ERR_PTR
285 */
__aa_find_or_create_ns(struct aa_ns * parent,const char * name,struct dentry * dir)286 struct aa_ns *__aa_find_or_create_ns(struct aa_ns *parent, const char *name,
287 struct dentry *dir)
288 {
289 struct aa_ns *ns;
290
291 AA_BUG(!mutex_is_locked(&parent->lock));
292
293 /* try and find the specified ns */
294 /* released by caller */
295 ns = aa_get_ns(__aa_find_ns(&parent->sub_ns, name));
296 if (!ns)
297 ns = __aa_create_ns(parent, name, dir);
298 else
299 ns = ERR_PTR(-EEXIST);
300
301 /* return ref */
302 return ns;
303 }
304
305 /**
306 * aa_prepare_ns - find an existing or create a new namespace of @name
307 * @parent: ns to treat as parent
308 * @name: the namespace to find or add (NOT NULL)
309 *
310 * Returns: refcounted namespace or PTR_ERR if failed to create one
311 */
aa_prepare_ns(struct aa_ns * parent,const char * name)312 struct aa_ns *aa_prepare_ns(struct aa_ns *parent, const char *name)
313 {
314 struct aa_ns *ns;
315
316 mutex_lock(&parent->lock);
317 /* try and find the specified ns and if it doesn't exist create it */
318 /* released by caller */
319 ns = aa_get_ns(__aa_find_ns(&parent->sub_ns, name));
320 if (!ns)
321 ns = __aa_create_ns(parent, name, NULL);
322 mutex_unlock(&parent->lock);
323
324 /* return ref */
325 return ns;
326 }
327
328 static void __ns_list_release(struct list_head *head);
329
330 /**
331 * destroy_ns - remove everything contained by @ns
332 * @ns: namespace to have it contents removed (NOT NULL)
333 */
destroy_ns(struct aa_ns * ns)334 static void destroy_ns(struct aa_ns *ns)
335 {
336 if (!ns)
337 return;
338
339 mutex_lock(&ns->lock);
340 /* release all profiles in this namespace */
341 __aa_profile_list_release(&ns->base.profiles);
342
343 /* release all sub namespaces */
344 __ns_list_release(&ns->sub_ns);
345
346 if (ns->parent) {
347 unsigned long flags;
348
349 write_lock_irqsave(&ns->labels.lock, flags);
350 __aa_proxy_redirect(ns_unconfined(ns),
351 ns_unconfined(ns->parent));
352 write_unlock_irqrestore(&ns->labels.lock, flags);
353 }
354 __aafs_ns_rmdir(ns);
355 mutex_unlock(&ns->lock);
356 }
357
358 /**
359 * __aa_remove_ns - remove a namespace and all its children
360 * @ns: namespace to be removed (NOT NULL)
361 *
362 * Requires: ns->parent->lock be held and ns removed from parent.
363 */
__aa_remove_ns(struct aa_ns * ns)364 void __aa_remove_ns(struct aa_ns *ns)
365 {
366 /* remove ns from namespace list */
367 list_del_rcu(&ns->base.list);
368 destroy_ns(ns);
369 aa_put_ns(ns);
370 }
371
372 /**
373 * __ns_list_release - remove all profile namespaces on the list put refs
374 * @head: list of profile namespaces (NOT NULL)
375 *
376 * Requires: namespace lock be held
377 */
__ns_list_release(struct list_head * head)378 static void __ns_list_release(struct list_head *head)
379 {
380 struct aa_ns *ns, *tmp;
381
382 list_for_each_entry_safe(ns, tmp, head, base.list)
383 __aa_remove_ns(ns);
384
385 }
386
387 /**
388 * aa_alloc_root_ns - allocate the root profile namespace
389 *
390 * Returns: %0 on success else error
391 *
392 */
aa_alloc_root_ns(void)393 int __init aa_alloc_root_ns(void)
394 {
395 /* released by aa_free_root_ns - used as list ref*/
396 root_ns = alloc_ns(NULL, "root");
397 if (!root_ns)
398 return -ENOMEM;
399
400 return 0;
401 }
402
403 /**
404 * aa_free_root_ns - free the root profile namespace
405 */
aa_free_root_ns(void)406 void __init aa_free_root_ns(void)
407 {
408 struct aa_ns *ns = root_ns;
409
410 root_ns = NULL;
411
412 destroy_ns(ns);
413 aa_put_ns(ns);
414 }
415