policy.c 32 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190
  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-2010 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. *
  15. * AppArmor policy is based around profiles, which contain the rules a
  16. * task is confined by. Every task in the system has a profile attached
  17. * to it determined either by matching "unconfined" tasks against the
  18. * visible set of profiles or by following a profiles attachment rules.
  19. *
  20. * Each profile exists in a profile namespace which is a container of
  21. * visible profiles. Each namespace contains a special "unconfined" profile,
  22. * which doesn't enforce any confinement on a task beyond DAC.
  23. *
  24. * Namespace and profile names can be written together in either
  25. * of two syntaxes.
  26. * :namespace:profile - used by kernel interfaces for easy detection
  27. * namespace://profile - used by policy
  28. *
  29. * Profile names can not start with : or @ or ^ and may not contain \0
  30. *
  31. * Reserved profile names
  32. * unconfined - special automatically generated unconfined profile
  33. * inherit - special name to indicate profile inheritance
  34. * null-XXXX-YYYY - special automatically generated learning profiles
  35. *
  36. * Namespace names may not start with / or @ and may not contain \0 or :
  37. * Reserved namespace names
  38. * user-XXXX - user defined profiles
  39. *
  40. * a // in a profile or namespace name indicates a hierarchical name with the
  41. * name before the // being the parent and the name after the child.
  42. *
  43. * Profile and namespace hierarchies serve two different but similar purposes.
  44. * The namespace contains the set of visible profiles that are considered
  45. * for attachment. The hierarchy of namespaces allows for virtualizing
  46. * the namespace so that for example a chroot can have its own set of profiles
  47. * which may define some local user namespaces.
  48. * The profile hierarchy severs two distinct purposes,
  49. * - it allows for sub profiles or hats, which allows an application to run
  50. * subprograms under its own profile with different restriction than it
  51. * self, and not have it use the system profile.
  52. * eg. if a mail program starts an editor, the policy might make the
  53. * restrictions tighter on the editor tighter than the mail program,
  54. * and definitely different than general editor restrictions
  55. * - it allows for binary hierarchy of profiles, so that execution history
  56. * is preserved. This feature isn't exploited by AppArmor reference policy
  57. * but is allowed. NOTE: this is currently suboptimal because profile
  58. * aliasing is not currently implemented so that a profile for each
  59. * level must be defined.
  60. * eg. /bin/bash///bin/ls as a name would indicate /bin/ls was started
  61. * from /bin/bash
  62. *
  63. * A profile or namespace name that can contain one or more // separators
  64. * is referred to as an hname (hierarchical).
  65. * eg. /bin/bash//bin/ls
  66. *
  67. * An fqname is a name that may contain both namespace and profile hnames.
  68. * eg. :ns:/bin/bash//bin/ls
  69. *
  70. * NOTES:
  71. * - locking of profile lists is currently fairly coarse. All profile
  72. * lists within a namespace use the namespace lock.
  73. * FIXME: move profile lists to using rcu_lists
  74. */
  75. #include <linux/slab.h>
  76. #include <linux/spinlock.h>
  77. #include <linux/string.h>
  78. #include "include/apparmor.h"
  79. #include "include/capability.h"
  80. #include "include/context.h"
  81. #include "include/file.h"
  82. #include "include/ipc.h"
  83. #include "include/match.h"
  84. #include "include/path.h"
  85. #include "include/policy.h"
  86. #include "include/policy_unpack.h"
  87. #include "include/resource.h"
  88. #include "include/sid.h"
  89. /* root profile namespace */
  90. struct aa_namespace *root_ns;
  91. const char *const profile_mode_names[] = {
  92. "enforce",
  93. "complain",
  94. "kill",
  95. };
  96. /**
  97. * hname_tail - find the last component of an hname
  98. * @name: hname to find the base profile name component of (NOT NULL)
  99. *
  100. * Returns: the tail (base profile name) name component of an hname
  101. */
  102. static const char *hname_tail(const char *hname)
  103. {
  104. char *split;
  105. hname = strim((char *)hname);
  106. for (split = strstr(hname, "//"); split; split = strstr(hname, "//"))
  107. hname = split + 2;
  108. return hname;
  109. }
  110. /**
  111. * policy_init - initialize a policy structure
  112. * @policy: policy to initialize (NOT NULL)
  113. * @prefix: prefix name if any is required. (MAYBE NULL)
  114. * @name: name of the policy, init will make a copy of it (NOT NULL)
  115. *
  116. * Note: this fn creates a copy of strings passed in
  117. *
  118. * Returns: true if policy init successful
  119. */
  120. static bool policy_init(struct aa_policy *policy, const char *prefix,
  121. const char *name)
  122. {
  123. /* freed by policy_free */
  124. if (prefix) {
  125. policy->hname = kmalloc(strlen(prefix) + strlen(name) + 3,
  126. GFP_KERNEL);
  127. if (policy->hname)
  128. sprintf(policy->hname, "%s//%s", prefix, name);
  129. } else
  130. policy->hname = kstrdup(name, GFP_KERNEL);
  131. if (!policy->hname)
  132. return 0;
  133. /* base.name is a substring of fqname */
  134. policy->name = (char *)hname_tail(policy->hname);
  135. INIT_LIST_HEAD(&policy->list);
  136. INIT_LIST_HEAD(&policy->profiles);
  137. kref_init(&policy->count);
  138. return 1;
  139. }
  140. /**
  141. * policy_destroy - free the elements referenced by @policy
  142. * @policy: policy that is to have its elements freed (NOT NULL)
  143. */
  144. static void policy_destroy(struct aa_policy *policy)
  145. {
  146. /* still contains profiles -- invalid */
  147. if (!list_empty(&policy->profiles)) {
  148. AA_ERROR("%s: internal error, "
  149. "policy '%s' still contains profiles\n",
  150. __func__, policy->name);
  151. BUG();
  152. }
  153. if (!list_empty(&policy->list)) {
  154. AA_ERROR("%s: internal error, policy '%s' still on list\n",
  155. __func__, policy->name);
  156. BUG();
  157. }
  158. /* don't free name as its a subset of hname */
  159. kzfree(policy->hname);
  160. }
  161. /**
  162. * __policy_find - find a policy by @name on a policy list
  163. * @head: list to search (NOT NULL)
  164. * @name: name to search for (NOT NULL)
  165. *
  166. * Requires: correct locks for the @head list be held
  167. *
  168. * Returns: unrefcounted policy that match @name or NULL if not found
  169. */
  170. static struct aa_policy *__policy_find(struct list_head *head, const char *name)
  171. {
  172. struct aa_policy *policy;
  173. list_for_each_entry(policy, head, list) {
  174. if (!strcmp(policy->name, name))
  175. return policy;
  176. }
  177. return NULL;
  178. }
  179. /**
  180. * __policy_strn_find - find a policy that's name matches @len chars of @str
  181. * @head: list to search (NOT NULL)
  182. * @str: string to search for (NOT NULL)
  183. * @len: length of match required
  184. *
  185. * Requires: correct locks for the @head list be held
  186. *
  187. * Returns: unrefcounted policy that match @str or NULL if not found
  188. *
  189. * if @len == strlen(@strlen) then this is equiv to __policy_find
  190. * other wise it allows searching for policy by a partial match of name
  191. */
  192. static struct aa_policy *__policy_strn_find(struct list_head *head,
  193. const char *str, int len)
  194. {
  195. struct aa_policy *policy;
  196. list_for_each_entry(policy, head, list) {
  197. if (aa_strneq(policy->name, str, len))
  198. return policy;
  199. }
  200. return NULL;
  201. }
  202. /*
  203. * Routines for AppArmor namespaces
  204. */
  205. static const char *hidden_ns_name = "---";
  206. /**
  207. * aa_ns_visible - test if @view is visible from @curr
  208. * @curr: namespace to treat as the parent (NOT NULL)
  209. * @view: namespace to test if visible from @curr (NOT NULL)
  210. *
  211. * Returns: true if @view is visible from @curr else false
  212. */
  213. bool aa_ns_visible(struct aa_namespace *curr, struct aa_namespace *view)
  214. {
  215. if (curr == view)
  216. return true;
  217. for ( ; view; view = view->parent) {
  218. if (view->parent == curr)
  219. return true;
  220. }
  221. return false;
  222. }
  223. /**
  224. * aa_na_name - Find the ns name to display for @view from @curr
  225. * @curr - current namespace (NOT NULL)
  226. * @view - namespace attempting to view (NOT NULL)
  227. *
  228. * Returns: name of @view visible from @curr
  229. */
  230. const char *aa_ns_name(struct aa_namespace *curr, struct aa_namespace *view)
  231. {
  232. /* if view == curr then the namespace name isn't displayed */
  233. if (curr == view)
  234. return "";
  235. if (aa_ns_visible(curr, view)) {
  236. /* at this point if a ns is visible it is in a view ns
  237. * thus the curr ns.hname is a prefix of its name.
  238. * Only output the virtualized portion of the name
  239. * Add + 2 to skip over // separating curr hname prefix
  240. * from the visible tail of the views hname
  241. */
  242. return view->base.hname + strlen(curr->base.hname) + 2;
  243. } else
  244. return hidden_ns_name;
  245. }
  246. /**
  247. * alloc_namespace - allocate, initialize and return a new namespace
  248. * @prefix: parent namespace name (MAYBE NULL)
  249. * @name: a preallocated name (NOT NULL)
  250. *
  251. * Returns: refcounted namespace or NULL on failure.
  252. */
  253. static struct aa_namespace *alloc_namespace(const char *prefix,
  254. const char *name)
  255. {
  256. struct aa_namespace *ns;
  257. ns = kzalloc(sizeof(*ns), GFP_KERNEL);
  258. AA_DEBUG("%s(%p)\n", __func__, ns);
  259. if (!ns)
  260. return NULL;
  261. if (!policy_init(&ns->base, prefix, name))
  262. goto fail_ns;
  263. INIT_LIST_HEAD(&ns->sub_ns);
  264. rwlock_init(&ns->lock);
  265. /* released by free_namespace */
  266. ns->unconfined = aa_alloc_profile("unconfined");
  267. if (!ns->unconfined)
  268. goto fail_unconfined;
  269. ns->unconfined->sid = aa_alloc_sid();
  270. ns->unconfined->flags = PFLAG_UNCONFINED | PFLAG_IX_ON_NAME_ERROR |
  271. PFLAG_IMMUTABLE;
  272. /*
  273. * released by free_namespace, however __remove_namespace breaks
  274. * the cyclic references (ns->unconfined, and unconfined->ns) and
  275. * replaces with refs to parent namespace unconfined
  276. */
  277. ns->unconfined->ns = aa_get_namespace(ns);
  278. return ns;
  279. fail_unconfined:
  280. kzfree(ns->base.hname);
  281. fail_ns:
  282. kzfree(ns);
  283. return NULL;
  284. }
  285. /**
  286. * free_namespace - free a profile namespace
  287. * @ns: the namespace to free (MAYBE NULL)
  288. *
  289. * Requires: All references to the namespace must have been put, if the
  290. * namespace was referenced by a profile confining a task,
  291. */
  292. static void free_namespace(struct aa_namespace *ns)
  293. {
  294. if (!ns)
  295. return;
  296. policy_destroy(&ns->base);
  297. aa_put_namespace(ns->parent);
  298. if (ns->unconfined && ns->unconfined->ns == ns)
  299. ns->unconfined->ns = NULL;
  300. aa_put_profile(ns->unconfined);
  301. kzfree(ns);
  302. }
  303. /**
  304. * aa_free_namespace_kref - free aa_namespace by kref (see aa_put_namespace)
  305. * @kr: kref callback for freeing of a namespace (NOT NULL)
  306. */
  307. void aa_free_namespace_kref(struct kref *kref)
  308. {
  309. free_namespace(container_of(kref, struct aa_namespace, base.count));
  310. }
  311. /**
  312. * __aa_find_namespace - find a namespace on a list by @name
  313. * @head: list to search for namespace on (NOT NULL)
  314. * @name: name of namespace to look for (NOT NULL)
  315. *
  316. * Returns: unrefcounted namespace
  317. *
  318. * Requires: ns lock be held
  319. */
  320. static struct aa_namespace *__aa_find_namespace(struct list_head *head,
  321. const char *name)
  322. {
  323. return (struct aa_namespace *)__policy_find(head, name);
  324. }
  325. /**
  326. * aa_find_namespace - look up a profile namespace on the namespace list
  327. * @root: namespace to search in (NOT NULL)
  328. * @name: name of namespace to find (NOT NULL)
  329. *
  330. * Returns: a refcounted namespace on the list, or NULL if no namespace
  331. * called @name exists.
  332. *
  333. * refcount released by caller
  334. */
  335. struct aa_namespace *aa_find_namespace(struct aa_namespace *root,
  336. const char *name)
  337. {
  338. struct aa_namespace *ns = NULL;
  339. read_lock(&root->lock);
  340. ns = aa_get_namespace(__aa_find_namespace(&root->sub_ns, name));
  341. read_unlock(&root->lock);
  342. return ns;
  343. }
  344. /**
  345. * aa_prepare_namespace - find an existing or create a new namespace of @name
  346. * @name: the namespace to find or add (MAYBE NULL)
  347. *
  348. * Returns: refcounted namespace or NULL if failed to create one
  349. */
  350. static struct aa_namespace *aa_prepare_namespace(const char *name)
  351. {
  352. struct aa_namespace *ns, *root;
  353. root = aa_current_profile()->ns;
  354. write_lock(&root->lock);
  355. /* if name isn't specified the profile is loaded to the current ns */
  356. if (!name) {
  357. /* released by caller */
  358. ns = aa_get_namespace(root);
  359. goto out;
  360. }
  361. /* try and find the specified ns and if it doesn't exist create it */
  362. /* released by caller */
  363. ns = aa_get_namespace(__aa_find_namespace(&root->sub_ns, name));
  364. if (!ns) {
  365. /* namespace not found */
  366. struct aa_namespace *new_ns;
  367. write_unlock(&root->lock);
  368. new_ns = alloc_namespace(root->base.hname, name);
  369. if (!new_ns)
  370. return NULL;
  371. write_lock(&root->lock);
  372. /* test for race when new_ns was allocated */
  373. ns = __aa_find_namespace(&root->sub_ns, name);
  374. if (!ns) {
  375. /* add parent ref */
  376. new_ns->parent = aa_get_namespace(root);
  377. list_add(&new_ns->base.list, &root->sub_ns);
  378. /* add list ref */
  379. ns = aa_get_namespace(new_ns);
  380. } else {
  381. /* raced so free the new one */
  382. free_namespace(new_ns);
  383. /* get reference on namespace */
  384. aa_get_namespace(ns);
  385. }
  386. }
  387. out:
  388. write_unlock(&root->lock);
  389. /* return ref */
  390. return ns;
  391. }
  392. /**
  393. * __list_add_profile - add a profile to a list
  394. * @list: list to add it to (NOT NULL)
  395. * @profile: the profile to add (NOT NULL)
  396. *
  397. * refcount @profile, should be put by __list_remove_profile
  398. *
  399. * Requires: namespace lock be held, or list not be shared
  400. */
  401. static void __list_add_profile(struct list_head *list,
  402. struct aa_profile *profile)
  403. {
  404. list_add(&profile->base.list, list);
  405. /* get list reference */
  406. aa_get_profile(profile);
  407. }
  408. /**
  409. * __list_remove_profile - remove a profile from the list it is on
  410. * @profile: the profile to remove (NOT NULL)
  411. *
  412. * remove a profile from the list, warning generally removal should
  413. * be done with __replace_profile as most profile removals are
  414. * replacements to the unconfined profile.
  415. *
  416. * put @profile list refcount
  417. *
  418. * Requires: namespace lock be held, or list not have been live
  419. */
  420. static void __list_remove_profile(struct aa_profile *profile)
  421. {
  422. list_del_init(&profile->base.list);
  423. if (!(profile->flags & PFLAG_NO_LIST_REF))
  424. /* release list reference */
  425. aa_put_profile(profile);
  426. }
  427. /**
  428. * __replace_profile - replace @old with @new on a list
  429. * @old: profile to be replaced (NOT NULL)
  430. * @new: profile to replace @old with (NOT NULL)
  431. *
  432. * Will duplicate and refcount elements that @new inherits from @old
  433. * and will inherit @old children.
  434. *
  435. * refcount @new for list, put @old list refcount
  436. *
  437. * Requires: namespace list lock be held, or list not be shared
  438. */
  439. static void __replace_profile(struct aa_profile *old, struct aa_profile *new)
  440. {
  441. struct aa_policy *policy;
  442. struct aa_profile *child, *tmp;
  443. if (old->parent)
  444. policy = &old->parent->base;
  445. else
  446. policy = &old->ns->base;
  447. /* released when @new is freed */
  448. new->parent = aa_get_profile(old->parent);
  449. new->ns = aa_get_namespace(old->ns);
  450. new->sid = old->sid;
  451. __list_add_profile(&policy->profiles, new);
  452. /* inherit children */
  453. list_for_each_entry_safe(child, tmp, &old->base.profiles, base.list) {
  454. aa_put_profile(child->parent);
  455. child->parent = aa_get_profile(new);
  456. /* list refcount transferred to @new*/
  457. list_move(&child->base.list, &new->base.profiles);
  458. }
  459. /* released by free_profile */
  460. old->replacedby = aa_get_profile(new);
  461. __list_remove_profile(old);
  462. }
  463. static void __profile_list_release(struct list_head *head);
  464. /**
  465. * __remove_profile - remove old profile, and children
  466. * @profile: profile to be replaced (NOT NULL)
  467. *
  468. * Requires: namespace list lock be held, or list not be shared
  469. */
  470. static void __remove_profile(struct aa_profile *profile)
  471. {
  472. /* release any children lists first */
  473. __profile_list_release(&profile->base.profiles);
  474. /* released by free_profile */
  475. profile->replacedby = aa_get_profile(profile->ns->unconfined);
  476. __list_remove_profile(profile);
  477. }
  478. /**
  479. * __profile_list_release - remove all profiles on the list and put refs
  480. * @head: list of profiles (NOT NULL)
  481. *
  482. * Requires: namespace lock be held
  483. */
  484. static void __profile_list_release(struct list_head *head)
  485. {
  486. struct aa_profile *profile, *tmp;
  487. list_for_each_entry_safe(profile, tmp, head, base.list)
  488. __remove_profile(profile);
  489. }
  490. static void __ns_list_release(struct list_head *head);
  491. /**
  492. * destroy_namespace - remove everything contained by @ns
  493. * @ns: namespace to have it contents removed (NOT NULL)
  494. */
  495. static void destroy_namespace(struct aa_namespace *ns)
  496. {
  497. if (!ns)
  498. return;
  499. write_lock(&ns->lock);
  500. /* release all profiles in this namespace */
  501. __profile_list_release(&ns->base.profiles);
  502. /* release all sub namespaces */
  503. __ns_list_release(&ns->sub_ns);
  504. write_unlock(&ns->lock);
  505. }
  506. /**
  507. * __remove_namespace - remove a namespace and all its children
  508. * @ns: namespace to be removed (NOT NULL)
  509. *
  510. * Requires: ns->parent->lock be held and ns removed from parent.
  511. */
  512. static void __remove_namespace(struct aa_namespace *ns)
  513. {
  514. struct aa_profile *unconfined = ns->unconfined;
  515. /* remove ns from namespace list */
  516. list_del_init(&ns->base.list);
  517. /*
  518. * break the ns, unconfined profile cyclic reference and forward
  519. * all new unconfined profiles requests to the parent namespace
  520. * This will result in all confined tasks that have a profile
  521. * being removed, inheriting the parent->unconfined profile.
  522. */
  523. if (ns->parent)
  524. ns->unconfined = aa_get_profile(ns->parent->unconfined);
  525. destroy_namespace(ns);
  526. /* release original ns->unconfined ref */
  527. aa_put_profile(unconfined);
  528. /* release ns->base.list ref, from removal above */
  529. aa_put_namespace(ns);
  530. }
  531. /**
  532. * __ns_list_release - remove all profile namespaces on the list put refs
  533. * @head: list of profile namespaces (NOT NULL)
  534. *
  535. * Requires: namespace lock be held
  536. */
  537. static void __ns_list_release(struct list_head *head)
  538. {
  539. struct aa_namespace *ns, *tmp;
  540. list_for_each_entry_safe(ns, tmp, head, base.list)
  541. __remove_namespace(ns);
  542. }
  543. /**
  544. * aa_alloc_root_ns - allocate the root profile namespace
  545. *
  546. * Returns: %0 on success else error
  547. *
  548. */
  549. int __init aa_alloc_root_ns(void)
  550. {
  551. /* released by aa_free_root_ns - used as list ref*/
  552. root_ns = alloc_namespace(NULL, "root");
  553. if (!root_ns)
  554. return -ENOMEM;
  555. return 0;
  556. }
  557. /**
  558. * aa_free_root_ns - free the root profile namespace
  559. */
  560. void __init aa_free_root_ns(void)
  561. {
  562. struct aa_namespace *ns = root_ns;
  563. root_ns = NULL;
  564. destroy_namespace(ns);
  565. aa_put_namespace(ns);
  566. }
  567. /**
  568. * aa_alloc_profile - allocate, initialize and return a new profile
  569. * @hname: name of the profile (NOT NULL)
  570. *
  571. * Returns: refcount profile or NULL on failure
  572. */
  573. struct aa_profile *aa_alloc_profile(const char *hname)
  574. {
  575. struct aa_profile *profile;
  576. /* freed by free_profile - usually through aa_put_profile */
  577. profile = kzalloc(sizeof(*profile), GFP_KERNEL);
  578. if (!profile)
  579. return NULL;
  580. if (!policy_init(&profile->base, NULL, hname)) {
  581. kzfree(profile);
  582. return NULL;
  583. }
  584. /* refcount released by caller */
  585. return profile;
  586. }
  587. /**
  588. * aa_new_null_profile - create a new null-X learning profile
  589. * @parent: profile that caused this profile to be created (NOT NULL)
  590. * @hat: true if the null- learning profile is a hat
  591. *
  592. * Create a null- complain mode profile used in learning mode. The name of
  593. * the profile is unique and follows the format of parent//null-sid.
  594. *
  595. * null profiles are added to the profile list but the list does not
  596. * hold a count on them so that they are automatically released when
  597. * not in use.
  598. *
  599. * Returns: new refcounted profile else NULL on failure
  600. */
  601. struct aa_profile *aa_new_null_profile(struct aa_profile *parent, int hat)
  602. {
  603. struct aa_profile *profile = NULL;
  604. char *name;
  605. u32 sid = aa_alloc_sid();
  606. /* freed below */
  607. name = kmalloc(strlen(parent->base.hname) + 2 + 7 + 8, GFP_KERNEL);
  608. if (!name)
  609. goto fail;
  610. sprintf(name, "%s//null-%x", parent->base.hname, sid);
  611. profile = aa_alloc_profile(name);
  612. kfree(name);
  613. if (!profile)
  614. goto fail;
  615. profile->sid = sid;
  616. profile->mode = APPARMOR_COMPLAIN;
  617. profile->flags = PFLAG_NULL;
  618. if (hat)
  619. profile->flags |= PFLAG_HAT;
  620. /* released on free_profile */
  621. profile->parent = aa_get_profile(parent);
  622. profile->ns = aa_get_namespace(parent->ns);
  623. write_lock(&profile->ns->lock);
  624. __list_add_profile(&parent->base.profiles, profile);
  625. write_unlock(&profile->ns->lock);
  626. /* refcount released by caller */
  627. return profile;
  628. fail:
  629. aa_free_sid(sid);
  630. return NULL;
  631. }
  632. /**
  633. * free_profile - free a profile
  634. * @profile: the profile to free (MAYBE NULL)
  635. *
  636. * Free a profile, its hats and null_profile. All references to the profile,
  637. * its hats and null_profile must have been put.
  638. *
  639. * If the profile was referenced from a task context, free_profile() will
  640. * be called from an rcu callback routine, so we must not sleep here.
  641. */
  642. static void free_profile(struct aa_profile *profile)
  643. {
  644. AA_DEBUG("%s(%p)\n", __func__, profile);
  645. if (!profile)
  646. return;
  647. if (!list_empty(&profile->base.list)) {
  648. AA_ERROR("%s: internal error, "
  649. "profile '%s' still on ns list\n",
  650. __func__, profile->base.name);
  651. BUG();
  652. }
  653. /* free children profiles */
  654. policy_destroy(&profile->base);
  655. aa_put_profile(profile->parent);
  656. aa_put_namespace(profile->ns);
  657. kzfree(profile->rename);
  658. aa_free_file_rules(&profile->file);
  659. aa_free_cap_rules(&profile->caps);
  660. aa_free_rlimit_rules(&profile->rlimits);
  661. aa_free_sid(profile->sid);
  662. aa_put_dfa(profile->xmatch);
  663. aa_put_dfa(profile->policy.dfa);
  664. aa_put_profile(profile->replacedby);
  665. kzfree(profile);
  666. }
  667. /**
  668. * aa_free_profile_kref - free aa_profile by kref (called by aa_put_profile)
  669. * @kr: kref callback for freeing of a profile (NOT NULL)
  670. */
  671. void aa_free_profile_kref(struct kref *kref)
  672. {
  673. struct aa_profile *p = container_of(kref, struct aa_profile,
  674. base.count);
  675. free_profile(p);
  676. }
  677. /* TODO: profile accounting - setup in remove */
  678. /**
  679. * __find_child - find a profile on @head list with a name matching @name
  680. * @head: list to search (NOT NULL)
  681. * @name: name of profile (NOT NULL)
  682. *
  683. * Requires: ns lock protecting list be held
  684. *
  685. * Returns: unrefcounted profile ptr, or NULL if not found
  686. */
  687. static struct aa_profile *__find_child(struct list_head *head, const char *name)
  688. {
  689. return (struct aa_profile *)__policy_find(head, name);
  690. }
  691. /**
  692. * __strn_find_child - find a profile on @head list using substring of @name
  693. * @head: list to search (NOT NULL)
  694. * @name: name of profile (NOT NULL)
  695. * @len: length of @name substring to match
  696. *
  697. * Requires: ns lock protecting list be held
  698. *
  699. * Returns: unrefcounted profile ptr, or NULL if not found
  700. */
  701. static struct aa_profile *__strn_find_child(struct list_head *head,
  702. const char *name, int len)
  703. {
  704. return (struct aa_profile *)__policy_strn_find(head, name, len);
  705. }
  706. /**
  707. * aa_find_child - find a profile by @name in @parent
  708. * @parent: profile to search (NOT NULL)
  709. * @name: profile name to search for (NOT NULL)
  710. *
  711. * Returns: a refcounted profile or NULL if not found
  712. */
  713. struct aa_profile *aa_find_child(struct aa_profile *parent, const char *name)
  714. {
  715. struct aa_profile *profile;
  716. read_lock(&parent->ns->lock);
  717. profile = aa_get_profile(__find_child(&parent->base.profiles, name));
  718. read_unlock(&parent->ns->lock);
  719. /* refcount released by caller */
  720. return profile;
  721. }
  722. /**
  723. * __lookup_parent - lookup the parent of a profile of name @hname
  724. * @ns: namespace to lookup profile in (NOT NULL)
  725. * @hname: hierarchical profile name to find parent of (NOT NULL)
  726. *
  727. * Lookups up the parent of a fully qualified profile name, the profile
  728. * that matches hname does not need to exist, in general this
  729. * is used to load a new profile.
  730. *
  731. * Requires: ns->lock be held
  732. *
  733. * Returns: unrefcounted policy or NULL if not found
  734. */
  735. static struct aa_policy *__lookup_parent(struct aa_namespace *ns,
  736. const char *hname)
  737. {
  738. struct aa_policy *policy;
  739. struct aa_profile *profile = NULL;
  740. char *split;
  741. policy = &ns->base;
  742. for (split = strstr(hname, "//"); split;) {
  743. profile = __strn_find_child(&policy->profiles, hname,
  744. split - hname);
  745. if (!profile)
  746. return NULL;
  747. policy = &profile->base;
  748. hname = split + 2;
  749. split = strstr(hname, "//");
  750. }
  751. if (!profile)
  752. return &ns->base;
  753. return &profile->base;
  754. }
  755. /**
  756. * __lookup_profile - lookup the profile matching @hname
  757. * @base: base list to start looking up profile name from (NOT NULL)
  758. * @hname: hierarchical profile name (NOT NULL)
  759. *
  760. * Requires: ns->lock be held
  761. *
  762. * Returns: unrefcounted profile pointer or NULL if not found
  763. *
  764. * Do a relative name lookup, recursing through profile tree.
  765. */
  766. static struct aa_profile *__lookup_profile(struct aa_policy *base,
  767. const char *hname)
  768. {
  769. struct aa_profile *profile = NULL;
  770. char *split;
  771. for (split = strstr(hname, "//"); split;) {
  772. profile = __strn_find_child(&base->profiles, hname,
  773. split - hname);
  774. if (!profile)
  775. return NULL;
  776. base = &profile->base;
  777. hname = split + 2;
  778. split = strstr(hname, "//");
  779. }
  780. profile = __find_child(&base->profiles, hname);
  781. return profile;
  782. }
  783. /**
  784. * aa_lookup_profile - find a profile by its full or partial name
  785. * @ns: the namespace to start from (NOT NULL)
  786. * @hname: name to do lookup on. Does not contain namespace prefix (NOT NULL)
  787. *
  788. * Returns: refcounted profile or NULL if not found
  789. */
  790. struct aa_profile *aa_lookup_profile(struct aa_namespace *ns, const char *hname)
  791. {
  792. struct aa_profile *profile;
  793. read_lock(&ns->lock);
  794. profile = aa_get_profile(__lookup_profile(&ns->base, hname));
  795. read_unlock(&ns->lock);
  796. /* refcount released by caller */
  797. return profile;
  798. }
  799. /**
  800. * replacement_allowed - test to see if replacement is allowed
  801. * @profile: profile to test if it can be replaced (MAYBE NULL)
  802. * @noreplace: true if replacement shouldn't be allowed but addition is okay
  803. * @info: Returns - info about why replacement failed (NOT NULL)
  804. *
  805. * Returns: %0 if replacement allowed else error code
  806. */
  807. static int replacement_allowed(struct aa_profile *profile, int noreplace,
  808. const char **info)
  809. {
  810. if (profile) {
  811. if (profile->flags & PFLAG_IMMUTABLE) {
  812. *info = "cannot replace immutible profile";
  813. return -EPERM;
  814. } else if (noreplace) {
  815. *info = "profile already exists";
  816. return -EEXIST;
  817. }
  818. }
  819. return 0;
  820. }
  821. /**
  822. * __add_new_profile - simple wrapper around __list_add_profile
  823. * @ns: namespace that profile is being added to (NOT NULL)
  824. * @policy: the policy container to add the profile to (NOT NULL)
  825. * @profile: profile to add (NOT NULL)
  826. *
  827. * add a profile to a list and do other required basic allocations
  828. */
  829. static void __add_new_profile(struct aa_namespace *ns, struct aa_policy *policy,
  830. struct aa_profile *profile)
  831. {
  832. if (policy != &ns->base)
  833. /* released on profile replacement or free_profile */
  834. profile->parent = aa_get_profile((struct aa_profile *) policy);
  835. __list_add_profile(&policy->profiles, profile);
  836. /* released on free_profile */
  837. profile->sid = aa_alloc_sid();
  838. profile->ns = aa_get_namespace(ns);
  839. }
  840. /**
  841. * aa_audit_policy - Do auditing of policy changes
  842. * @op: policy operation being performed
  843. * @gfp: memory allocation flags
  844. * @name: name of profile being manipulated (NOT NULL)
  845. * @info: any extra information to be audited (MAYBE NULL)
  846. * @error: error code
  847. *
  848. * Returns: the error to be returned after audit is done
  849. */
  850. static int audit_policy(int op, gfp_t gfp, const char *name, const char *info,
  851. int error)
  852. {
  853. struct common_audit_data sa;
  854. struct apparmor_audit_data aad = {0,};
  855. COMMON_AUDIT_DATA_INIT(&sa, NONE);
  856. sa.aad = &aad;
  857. aad.op = op;
  858. aad.name = name;
  859. aad.info = info;
  860. aad.error = error;
  861. return aa_audit(AUDIT_APPARMOR_STATUS, __aa_current_profile(), gfp,
  862. &sa, NULL);
  863. }
  864. /**
  865. * aa_may_manage_policy - can the current task manage policy
  866. * @op: the policy manipulation operation being done
  867. *
  868. * Returns: true if the task is allowed to manipulate policy
  869. */
  870. bool aa_may_manage_policy(int op)
  871. {
  872. /* check if loading policy is locked out */
  873. if (aa_g_lock_policy) {
  874. audit_policy(op, GFP_KERNEL, NULL, "policy_locked", -EACCES);
  875. return 0;
  876. }
  877. if (!capable(CAP_MAC_ADMIN)) {
  878. audit_policy(op, GFP_KERNEL, NULL, "not policy admin", -EACCES);
  879. return 0;
  880. }
  881. return 1;
  882. }
  883. /**
  884. * aa_replace_profiles - replace profile(s) on the profile list
  885. * @udata: serialized data stream (NOT NULL)
  886. * @size: size of the serialized data stream
  887. * @noreplace: true if only doing addition, no replacement allowed
  888. *
  889. * unpack and replace a profile on the profile list and uses of that profile
  890. * by any aa_task_cxt. If the profile does not exist on the profile list
  891. * it is added.
  892. *
  893. * Returns: size of data consumed else error code on failure.
  894. */
  895. ssize_t aa_replace_profiles(void *udata, size_t size, bool noreplace)
  896. {
  897. struct aa_policy *policy;
  898. struct aa_profile *old_profile = NULL, *new_profile = NULL;
  899. struct aa_profile *rename_profile = NULL;
  900. struct aa_namespace *ns = NULL;
  901. const char *ns_name, *name = NULL, *info = NULL;
  902. int op = OP_PROF_REPL;
  903. ssize_t error;
  904. /* released below */
  905. new_profile = aa_unpack(udata, size, &ns_name);
  906. if (IS_ERR(new_profile)) {
  907. error = PTR_ERR(new_profile);
  908. new_profile = NULL;
  909. goto fail;
  910. }
  911. /* released below */
  912. ns = aa_prepare_namespace(ns_name);
  913. if (!ns) {
  914. info = "failed to prepare namespace";
  915. error = -ENOMEM;
  916. name = ns_name;
  917. goto fail;
  918. }
  919. name = new_profile->base.hname;
  920. write_lock(&ns->lock);
  921. /* no ref on policy only use inside lock */
  922. policy = __lookup_parent(ns, new_profile->base.hname);
  923. if (!policy) {
  924. info = "parent does not exist";
  925. error = -ENOENT;
  926. goto audit;
  927. }
  928. old_profile = __find_child(&policy->profiles, new_profile->base.name);
  929. /* released below */
  930. aa_get_profile(old_profile);
  931. if (new_profile->rename) {
  932. rename_profile = __lookup_profile(&ns->base,
  933. new_profile->rename);
  934. /* released below */
  935. aa_get_profile(rename_profile);
  936. if (!rename_profile) {
  937. info = "profile to rename does not exist";
  938. name = new_profile->rename;
  939. error = -ENOENT;
  940. goto audit;
  941. }
  942. }
  943. error = replacement_allowed(old_profile, noreplace, &info);
  944. if (error)
  945. goto audit;
  946. error = replacement_allowed(rename_profile, noreplace, &info);
  947. if (error)
  948. goto audit;
  949. audit:
  950. if (!old_profile && !rename_profile)
  951. op = OP_PROF_LOAD;
  952. error = audit_policy(op, GFP_ATOMIC, name, info, error);
  953. if (!error) {
  954. if (rename_profile)
  955. __replace_profile(rename_profile, new_profile);
  956. if (old_profile) {
  957. /* when there are both rename and old profiles
  958. * inherit old profiles sid
  959. */
  960. if (rename_profile)
  961. aa_free_sid(new_profile->sid);
  962. __replace_profile(old_profile, new_profile);
  963. }
  964. if (!(old_profile || rename_profile))
  965. __add_new_profile(ns, policy, new_profile);
  966. }
  967. write_unlock(&ns->lock);
  968. out:
  969. aa_put_namespace(ns);
  970. aa_put_profile(rename_profile);
  971. aa_put_profile(old_profile);
  972. aa_put_profile(new_profile);
  973. if (error)
  974. return error;
  975. return size;
  976. fail:
  977. error = audit_policy(op, GFP_KERNEL, name, info, error);
  978. goto out;
  979. }
  980. /**
  981. * aa_remove_profiles - remove profile(s) from the system
  982. * @fqname: name of the profile or namespace to remove (NOT NULL)
  983. * @size: size of the name
  984. *
  985. * Remove a profile or sub namespace from the current namespace, so that
  986. * they can not be found anymore and mark them as replaced by unconfined
  987. *
  988. * NOTE: removing confinement does not restore rlimits to preconfinemnet values
  989. *
  990. * Returns: size of data consume else error code if fails
  991. */
  992. ssize_t aa_remove_profiles(char *fqname, size_t size)
  993. {
  994. struct aa_namespace *root, *ns = NULL;
  995. struct aa_profile *profile = NULL;
  996. const char *name = fqname, *info = NULL;
  997. ssize_t error = 0;
  998. if (*fqname == 0) {
  999. info = "no profile specified";
  1000. error = -ENOENT;
  1001. goto fail;
  1002. }
  1003. root = aa_current_profile()->ns;
  1004. if (fqname[0] == ':') {
  1005. char *ns_name;
  1006. name = aa_split_fqname(fqname, &ns_name);
  1007. if (ns_name) {
  1008. /* released below */
  1009. ns = aa_find_namespace(root, ns_name);
  1010. if (!ns) {
  1011. info = "namespace does not exist";
  1012. error = -ENOENT;
  1013. goto fail;
  1014. }
  1015. }
  1016. } else
  1017. /* released below */
  1018. ns = aa_get_namespace(root);
  1019. if (!name) {
  1020. /* remove namespace - can only happen if fqname[0] == ':' */
  1021. write_lock(&ns->parent->lock);
  1022. __remove_namespace(ns);
  1023. write_unlock(&ns->parent->lock);
  1024. } else {
  1025. /* remove profile */
  1026. write_lock(&ns->lock);
  1027. profile = aa_get_profile(__lookup_profile(&ns->base, name));
  1028. if (!profile) {
  1029. error = -ENOENT;
  1030. info = "profile does not exist";
  1031. goto fail_ns_lock;
  1032. }
  1033. name = profile->base.hname;
  1034. __remove_profile(profile);
  1035. write_unlock(&ns->lock);
  1036. }
  1037. /* don't fail removal if audit fails */
  1038. (void) audit_policy(OP_PROF_RM, GFP_KERNEL, name, info, error);
  1039. aa_put_namespace(ns);
  1040. aa_put_profile(profile);
  1041. return size;
  1042. fail_ns_lock:
  1043. write_unlock(&ns->lock);
  1044. aa_put_namespace(ns);
  1045. fail:
  1046. (void) audit_policy(OP_PROF_RM, GFP_KERNEL, name, info, error);
  1047. return error;
  1048. }