]>
Commit | Line | Data |
---|---|---|
b4d0d230 | 1 | // SPDX-License-Identifier: GPL-2.0-or-later |
af777cd1 | 2 | /* Task credentials management - see Documentation/security/credentials.rst |
f1752eec DH |
3 | * |
4 | * Copyright (C) 2008 Red Hat, Inc. All Rights Reserved. | |
5 | * Written by David Howells ([email protected]) | |
f1752eec | 6 | */ |
9984de1a | 7 | #include <linux/export.h> |
f1752eec | 8 | #include <linux/cred.h> |
5a0e3ad6 | 9 | #include <linux/slab.h> |
f1752eec | 10 | #include <linux/sched.h> |
f7ccbae4 | 11 | #include <linux/sched/coredump.h> |
f1752eec DH |
12 | #include <linux/key.h> |
13 | #include <linux/keyctl.h> | |
14 | #include <linux/init_task.h> | |
15 | #include <linux/security.h> | |
40401530 | 16 | #include <linux/binfmts.h> |
d84f4f99 | 17 | #include <linux/cn_proc.h> |
d89b22d4 | 18 | #include <linux/uidgid.h> |
d84f4f99 | 19 | |
e0e81739 | 20 | #if 0 |
52aa8536 JP |
21 | #define kdebug(FMT, ...) \ |
22 | printk("[%-5.5s%5u] " FMT "\n", \ | |
23 | current->comm, current->pid, ##__VA_ARGS__) | |
e0e81739 | 24 | #else |
52aa8536 JP |
25 | #define kdebug(FMT, ...) \ |
26 | do { \ | |
27 | if (0) \ | |
28 | no_printk("[%-5.5s%5u] " FMT "\n", \ | |
29 | current->comm, current->pid, ##__VA_ARGS__); \ | |
30 | } while (0) | |
e0e81739 DH |
31 | #endif |
32 | ||
d84f4f99 | 33 | static struct kmem_cache *cred_jar; |
f1752eec | 34 | |
2813893f IM |
35 | /* init to 2 - one for init_task, one to ensure it is never freed */ |
36 | struct group_info init_groups = { .usage = ATOMIC_INIT(2) }; | |
37 | ||
f1752eec DH |
38 | /* |
39 | * The initial credentials for the initial task | |
40 | */ | |
41 | struct cred init_cred = { | |
3b11a1de | 42 | .usage = ATOMIC_INIT(4), |
e0e81739 DH |
43 | #ifdef CONFIG_DEBUG_CREDENTIALS |
44 | .subscribers = ATOMIC_INIT(2), | |
45 | .magic = CRED_MAGIC, | |
46 | #endif | |
078de5f7 EB |
47 | .uid = GLOBAL_ROOT_UID, |
48 | .gid = GLOBAL_ROOT_GID, | |
49 | .suid = GLOBAL_ROOT_UID, | |
50 | .sgid = GLOBAL_ROOT_GID, | |
51 | .euid = GLOBAL_ROOT_UID, | |
52 | .egid = GLOBAL_ROOT_GID, | |
53 | .fsuid = GLOBAL_ROOT_UID, | |
54 | .fsgid = GLOBAL_ROOT_GID, | |
f1752eec | 55 | .securebits = SECUREBITS_DEFAULT, |
a3232d2f | 56 | .cap_inheritable = CAP_EMPTY_SET, |
f1752eec | 57 | .cap_permitted = CAP_FULL_SET, |
a3232d2f EP |
58 | .cap_effective = CAP_FULL_SET, |
59 | .cap_bset = CAP_FULL_SET, | |
f1752eec | 60 | .user = INIT_USER, |
47a150ed | 61 | .user_ns = &init_user_ns, |
f1752eec DH |
62 | .group_info = &init_groups, |
63 | }; | |
64 | ||
e0e81739 DH |
65 | static inline void set_cred_subscribers(struct cred *cred, int n) |
66 | { | |
67 | #ifdef CONFIG_DEBUG_CREDENTIALS | |
68 | atomic_set(&cred->subscribers, n); | |
69 | #endif | |
70 | } | |
71 | ||
72 | static inline int read_cred_subscribers(const struct cred *cred) | |
73 | { | |
74 | #ifdef CONFIG_DEBUG_CREDENTIALS | |
75 | return atomic_read(&cred->subscribers); | |
76 | #else | |
77 | return 0; | |
78 | #endif | |
79 | } | |
80 | ||
81 | static inline void alter_cred_subscribers(const struct cred *_cred, int n) | |
82 | { | |
83 | #ifdef CONFIG_DEBUG_CREDENTIALS | |
84 | struct cred *cred = (struct cred *) _cred; | |
85 | ||
86 | atomic_add(n, &cred->subscribers); | |
87 | #endif | |
88 | } | |
89 | ||
f1752eec DH |
90 | /* |
91 | * The RCU callback to actually dispose of a set of credentials | |
92 | */ | |
93 | static void put_cred_rcu(struct rcu_head *rcu) | |
94 | { | |
95 | struct cred *cred = container_of(rcu, struct cred, rcu); | |
96 | ||
e0e81739 DH |
97 | kdebug("put_cred_rcu(%p)", cred); |
98 | ||
99 | #ifdef CONFIG_DEBUG_CREDENTIALS | |
100 | if (cred->magic != CRED_MAGIC_DEAD || | |
101 | atomic_read(&cred->usage) != 0 || | |
102 | read_cred_subscribers(cred) != 0) | |
103 | panic("CRED: put_cred_rcu() sees %p with" | |
104 | " mag %x, put %p, usage %d, subscr %d\n", | |
105 | cred, cred->magic, cred->put_addr, | |
106 | atomic_read(&cred->usage), | |
107 | read_cred_subscribers(cred)); | |
108 | #else | |
d84f4f99 DH |
109 | if (atomic_read(&cred->usage) != 0) |
110 | panic("CRED: put_cred_rcu() sees %p with usage %d\n", | |
111 | cred, atomic_read(&cred->usage)); | |
e0e81739 | 112 | #endif |
f1752eec | 113 | |
d84f4f99 | 114 | security_cred_free(cred); |
3a50597d DH |
115 | key_put(cred->session_keyring); |
116 | key_put(cred->process_keyring); | |
f1752eec DH |
117 | key_put(cred->thread_keyring); |
118 | key_put(cred->request_key_auth); | |
4a5d6ba1 DH |
119 | if (cred->group_info) |
120 | put_group_info(cred->group_info); | |
f1752eec | 121 | free_uid(cred->user); |
0093ccb6 | 122 | put_user_ns(cred->user_ns); |
d84f4f99 | 123 | kmem_cache_free(cred_jar, cred); |
f1752eec DH |
124 | } |
125 | ||
126 | /** | |
127 | * __put_cred - Destroy a set of credentials | |
d84f4f99 | 128 | * @cred: The record to release |
f1752eec DH |
129 | * |
130 | * Destroy a set of credentials on which no references remain. | |
131 | */ | |
132 | void __put_cred(struct cred *cred) | |
133 | { | |
e0e81739 DH |
134 | kdebug("__put_cred(%p{%d,%d})", cred, |
135 | atomic_read(&cred->usage), | |
136 | read_cred_subscribers(cred)); | |
137 | ||
d84f4f99 | 138 | BUG_ON(atomic_read(&cred->usage) != 0); |
e0e81739 DH |
139 | #ifdef CONFIG_DEBUG_CREDENTIALS |
140 | BUG_ON(read_cred_subscribers(cred) != 0); | |
141 | cred->magic = CRED_MAGIC_DEAD; | |
142 | cred->put_addr = __builtin_return_address(0); | |
143 | #endif | |
144 | BUG_ON(cred == current->cred); | |
145 | BUG_ON(cred == current->real_cred); | |
d84f4f99 | 146 | |
d7852fbd LT |
147 | if (cred->non_rcu) |
148 | put_cred_rcu(&cred->rcu); | |
149 | else | |
150 | call_rcu(&cred->rcu, put_cred_rcu); | |
f1752eec DH |
151 | } |
152 | EXPORT_SYMBOL(__put_cred); | |
153 | ||
e0e81739 DH |
154 | /* |
155 | * Clean up a task's credentials when it exits | |
156 | */ | |
157 | void exit_creds(struct task_struct *tsk) | |
158 | { | |
159 | struct cred *cred; | |
160 | ||
161 | kdebug("exit_creds(%u,%p,%p,{%d,%d})", tsk->pid, tsk->real_cred, tsk->cred, | |
162 | atomic_read(&tsk->cred->usage), | |
163 | read_cred_subscribers(tsk->cred)); | |
164 | ||
165 | cred = (struct cred *) tsk->real_cred; | |
166 | tsk->real_cred = NULL; | |
167 | validate_creds(cred); | |
168 | alter_cred_subscribers(cred, -1); | |
169 | put_cred(cred); | |
170 | ||
171 | cred = (struct cred *) tsk->cred; | |
172 | tsk->cred = NULL; | |
173 | validate_creds(cred); | |
174 | alter_cred_subscribers(cred, -1); | |
175 | put_cred(cred); | |
7743c48e DH |
176 | |
177 | #ifdef CONFIG_KEYS_REQUEST_CACHE | |
8379bb84 DH |
178 | key_put(tsk->cached_requested_key); |
179 | tsk->cached_requested_key = NULL; | |
7743c48e | 180 | #endif |
ee18d64c DH |
181 | } |
182 | ||
de09a977 DH |
183 | /** |
184 | * get_task_cred - Get another task's objective credentials | |
185 | * @task: The task to query | |
186 | * | |
187 | * Get the objective credentials of a task, pinning them so that they can't go | |
188 | * away. Accessing a task's credentials directly is not permitted. | |
189 | * | |
190 | * The caller must also make sure task doesn't get deleted, either by holding a | |
191 | * ref on task or by holding tasklist_lock to prevent it from being unlinked. | |
192 | */ | |
193 | const struct cred *get_task_cred(struct task_struct *task) | |
194 | { | |
195 | const struct cred *cred; | |
196 | ||
197 | rcu_read_lock(); | |
198 | ||
199 | do { | |
200 | cred = __task_cred((task)); | |
201 | BUG_ON(!cred); | |
97d0fb23 | 202 | } while (!get_cred_rcu(cred)); |
de09a977 DH |
203 | |
204 | rcu_read_unlock(); | |
205 | return cred; | |
206 | } | |
a6d8e763 | 207 | EXPORT_SYMBOL(get_task_cred); |
de09a977 | 208 | |
ee18d64c DH |
209 | /* |
210 | * Allocate blank credentials, such that the credentials can be filled in at a | |
211 | * later date without risk of ENOMEM. | |
212 | */ | |
213 | struct cred *cred_alloc_blank(void) | |
214 | { | |
215 | struct cred *new; | |
216 | ||
217 | new = kmem_cache_zalloc(cred_jar, GFP_KERNEL); | |
218 | if (!new) | |
219 | return NULL; | |
220 | ||
ee18d64c | 221 | atomic_set(&new->usage, 1); |
2edeaa34 TH |
222 | #ifdef CONFIG_DEBUG_CREDENTIALS |
223 | new->magic = CRED_MAGIC; | |
224 | #endif | |
ee18d64c | 225 | |
84029fd0 | 226 | if (security_cred_alloc_blank(new, GFP_KERNEL_ACCOUNT) < 0) |
ee18d64c DH |
227 | goto error; |
228 | ||
ee18d64c DH |
229 | return new; |
230 | ||
231 | error: | |
232 | abort_creds(new); | |
233 | return NULL; | |
e0e81739 DH |
234 | } |
235 | ||
d84f4f99 DH |
236 | /** |
237 | * prepare_creds - Prepare a new set of credentials for modification | |
238 | * | |
239 | * Prepare a new set of task credentials for modification. A task's creds | |
240 | * shouldn't generally be modified directly, therefore this function is used to | |
241 | * prepare a new copy, which the caller then modifies and then commits by | |
242 | * calling commit_creds(). | |
243 | * | |
3b11a1de DH |
244 | * Preparation involves making a copy of the objective creds for modification. |
245 | * | |
d84f4f99 DH |
246 | * Returns a pointer to the new creds-to-be if successful, NULL otherwise. |
247 | * | |
248 | * Call commit_creds() or abort_creds() to clean up. | |
249 | */ | |
250 | struct cred *prepare_creds(void) | |
251 | { | |
252 | struct task_struct *task = current; | |
253 | const struct cred *old; | |
254 | struct cred *new; | |
255 | ||
e0e81739 | 256 | validate_process_creds(); |
d84f4f99 DH |
257 | |
258 | new = kmem_cache_alloc(cred_jar, GFP_KERNEL); | |
259 | if (!new) | |
260 | return NULL; | |
261 | ||
e0e81739 DH |
262 | kdebug("prepare_creds() alloc %p", new); |
263 | ||
d84f4f99 DH |
264 | old = task->cred; |
265 | memcpy(new, old, sizeof(struct cred)); | |
266 | ||
d7852fbd | 267 | new->non_rcu = 0; |
d84f4f99 | 268 | atomic_set(&new->usage, 1); |
e0e81739 | 269 | set_cred_subscribers(new, 0); |
d84f4f99 DH |
270 | get_group_info(new->group_info); |
271 | get_uid(new->user); | |
0093ccb6 | 272 | get_user_ns(new->user_ns); |
d84f4f99 DH |
273 | |
274 | #ifdef CONFIG_KEYS | |
3a50597d DH |
275 | key_get(new->session_keyring); |
276 | key_get(new->process_keyring); | |
d84f4f99 DH |
277 | key_get(new->thread_keyring); |
278 | key_get(new->request_key_auth); | |
d84f4f99 DH |
279 | #endif |
280 | ||
281 | #ifdef CONFIG_SECURITY | |
282 | new->security = NULL; | |
283 | #endif | |
284 | ||
84029fd0 | 285 | if (security_prepare_creds(new, old, GFP_KERNEL_ACCOUNT) < 0) |
d84f4f99 | 286 | goto error; |
e0e81739 | 287 | validate_creds(new); |
d84f4f99 DH |
288 | return new; |
289 | ||
290 | error: | |
291 | abort_creds(new); | |
292 | return NULL; | |
293 | } | |
294 | EXPORT_SYMBOL(prepare_creds); | |
295 | ||
a6f76f23 DH |
296 | /* |
297 | * Prepare credentials for current to perform an execve() | |
9b1bf12d | 298 | * - The caller must hold ->cred_guard_mutex |
a6f76f23 DH |
299 | */ |
300 | struct cred *prepare_exec_creds(void) | |
301 | { | |
a6f76f23 DH |
302 | struct cred *new; |
303 | ||
a6f76f23 | 304 | new = prepare_creds(); |
3a50597d | 305 | if (!new) |
a6f76f23 | 306 | return new; |
a6f76f23 DH |
307 | |
308 | #ifdef CONFIG_KEYS | |
309 | /* newly exec'd tasks don't get a thread keyring */ | |
310 | key_put(new->thread_keyring); | |
311 | new->thread_keyring = NULL; | |
312 | ||
a6f76f23 | 313 | /* inherit the session keyring; new process keyring */ |
3a50597d DH |
314 | key_put(new->process_keyring); |
315 | new->process_keyring = NULL; | |
a6f76f23 DH |
316 | #endif |
317 | ||
87b047d2 EB |
318 | new->suid = new->fsuid = new->euid; |
319 | new->sgid = new->fsgid = new->egid; | |
320 | ||
a6f76f23 DH |
321 | return new; |
322 | } | |
323 | ||
f1752eec DH |
324 | /* |
325 | * Copy credentials for the new process created by fork() | |
d84f4f99 DH |
326 | * |
327 | * We share if we can, but under some circumstances we have to generate a new | |
328 | * set. | |
3b11a1de DH |
329 | * |
330 | * The new process gets the current process's subjective credentials as its | |
331 | * objective and subjective credentials | |
f1752eec DH |
332 | */ |
333 | int copy_creds(struct task_struct *p, unsigned long clone_flags) | |
334 | { | |
d84f4f99 | 335 | struct cred *new; |
18b6e041 | 336 | int ret; |
d84f4f99 | 337 | |
7743c48e DH |
338 | #ifdef CONFIG_KEYS_REQUEST_CACHE |
339 | p->cached_requested_key = NULL; | |
340 | #endif | |
341 | ||
d84f4f99 DH |
342 | if ( |
343 | #ifdef CONFIG_KEYS | |
344 | !p->cred->thread_keyring && | |
345 | #endif | |
346 | clone_flags & CLONE_THREAD | |
347 | ) { | |
3b11a1de | 348 | p->real_cred = get_cred(p->cred); |
d84f4f99 | 349 | get_cred(p->cred); |
e0e81739 DH |
350 | alter_cred_subscribers(p->cred, 2); |
351 | kdebug("share_creds(%p{%d,%d})", | |
352 | p->cred, atomic_read(&p->cred->usage), | |
353 | read_cred_subscribers(p->cred)); | |
d84f4f99 DH |
354 | atomic_inc(&p->cred->user->processes); |
355 | return 0; | |
356 | } | |
357 | ||
358 | new = prepare_creds(); | |
359 | if (!new) | |
f1752eec DH |
360 | return -ENOMEM; |
361 | ||
18b6e041 SH |
362 | if (clone_flags & CLONE_NEWUSER) { |
363 | ret = create_user_ns(new); | |
364 | if (ret < 0) | |
365 | goto error_put; | |
366 | } | |
367 | ||
bb952bb9 | 368 | #ifdef CONFIG_KEYS |
d84f4f99 DH |
369 | /* new threads get their own thread keyrings if their parent already |
370 | * had one */ | |
371 | if (new->thread_keyring) { | |
372 | key_put(new->thread_keyring); | |
373 | new->thread_keyring = NULL; | |
374 | if (clone_flags & CLONE_THREAD) | |
375 | install_thread_keyring_to_cred(new); | |
376 | } | |
377 | ||
3a50597d DH |
378 | /* The process keyring is only shared between the threads in a process; |
379 | * anything outside of those threads doesn't inherit. | |
380 | */ | |
d84f4f99 | 381 | if (!(clone_flags & CLONE_THREAD)) { |
3a50597d DH |
382 | key_put(new->process_keyring); |
383 | new->process_keyring = NULL; | |
bb952bb9 DH |
384 | } |
385 | #endif | |
386 | ||
d84f4f99 | 387 | atomic_inc(&new->user->processes); |
3b11a1de | 388 | p->cred = p->real_cred = get_cred(new); |
e0e81739 DH |
389 | alter_cred_subscribers(new, 2); |
390 | validate_creds(new); | |
d84f4f99 | 391 | return 0; |
18b6e041 SH |
392 | |
393 | error_put: | |
394 | put_cred(new); | |
395 | return ret; | |
d84f4f99 | 396 | } |
f1752eec | 397 | |
aa6d054e EB |
398 | static bool cred_cap_issubset(const struct cred *set, const struct cred *subset) |
399 | { | |
400 | const struct user_namespace *set_ns = set->user_ns; | |
401 | const struct user_namespace *subset_ns = subset->user_ns; | |
402 | ||
403 | /* If the two credentials are in the same user namespace see if | |
404 | * the capabilities of subset are a subset of set. | |
405 | */ | |
406 | if (set_ns == subset_ns) | |
407 | return cap_issubset(subset->cap_permitted, set->cap_permitted); | |
408 | ||
409 | /* The credentials are in a different user namespaces | |
410 | * therefore one is a subset of the other only if a set is an | |
411 | * ancestor of subset and set->euid is owner of subset or one | |
412 | * of subsets ancestors. | |
413 | */ | |
414 | for (;subset_ns != &init_user_ns; subset_ns = subset_ns->parent) { | |
415 | if ((set_ns == subset_ns->parent) && | |
416 | uid_eq(subset_ns->owner, set->euid)) | |
417 | return true; | |
418 | } | |
419 | ||
420 | return false; | |
421 | } | |
422 | ||
d84f4f99 DH |
423 | /** |
424 | * commit_creds - Install new credentials upon the current task | |
425 | * @new: The credentials to be assigned | |
426 | * | |
427 | * Install a new set of credentials to the current task, using RCU to replace | |
3b11a1de DH |
428 | * the old set. Both the objective and the subjective credentials pointers are |
429 | * updated. This function may not be called if the subjective credentials are | |
430 | * in an overridden state. | |
d84f4f99 DH |
431 | * |
432 | * This function eats the caller's reference to the new credentials. | |
433 | * | |
434 | * Always returns 0 thus allowing this function to be tail-called at the end | |
435 | * of, say, sys_setgid(). | |
436 | */ | |
437 | int commit_creds(struct cred *new) | |
438 | { | |
439 | struct task_struct *task = current; | |
e0e81739 | 440 | const struct cred *old = task->real_cred; |
d84f4f99 | 441 | |
e0e81739 DH |
442 | kdebug("commit_creds(%p{%d,%d})", new, |
443 | atomic_read(&new->usage), | |
444 | read_cred_subscribers(new)); | |
445 | ||
446 | BUG_ON(task->cred != old); | |
447 | #ifdef CONFIG_DEBUG_CREDENTIALS | |
448 | BUG_ON(read_cred_subscribers(old) < 2); | |
449 | validate_creds(old); | |
450 | validate_creds(new); | |
451 | #endif | |
d84f4f99 | 452 | BUG_ON(atomic_read(&new->usage) < 1); |
d84f4f99 | 453 | |
3b11a1de DH |
454 | get_cred(new); /* we will require a ref for the subj creds too */ |
455 | ||
d84f4f99 | 456 | /* dumpability changes */ |
078de5f7 EB |
457 | if (!uid_eq(old->euid, new->euid) || |
458 | !gid_eq(old->egid, new->egid) || | |
459 | !uid_eq(old->fsuid, new->fsuid) || | |
460 | !gid_eq(old->fsgid, new->fsgid) || | |
aa6d054e | 461 | !cred_cap_issubset(old, new)) { |
b9456371 DH |
462 | if (task->mm) |
463 | set_dumpable(task->mm, suid_dumpable); | |
d84f4f99 | 464 | task->pdeath_signal = 0; |
f6581f5b JH |
465 | /* |
466 | * If a task drops privileges and becomes nondumpable, | |
467 | * the dumpability change must become visible before | |
468 | * the credential change; otherwise, a __ptrace_may_access() | |
469 | * racing with this change may be able to attach to a task it | |
470 | * shouldn't be able to attach to (as if the task had dropped | |
471 | * privileges without becoming nondumpable). | |
472 | * Pairs with a read barrier in __ptrace_may_access(). | |
473 | */ | |
d84f4f99 | 474 | smp_wmb(); |
f1752eec DH |
475 | } |
476 | ||
d84f4f99 | 477 | /* alter the thread keyring */ |
078de5f7 | 478 | if (!uid_eq(new->fsuid, old->fsuid)) |
2e21865f | 479 | key_fsuid_changed(new); |
078de5f7 | 480 | if (!gid_eq(new->fsgid, old->fsgid)) |
2e21865f | 481 | key_fsgid_changed(new); |
d84f4f99 DH |
482 | |
483 | /* do it | |
72fa5997 VK |
484 | * RLIMIT_NPROC limits on user->processes have already been checked |
485 | * in set_user(). | |
d84f4f99 | 486 | */ |
e0e81739 | 487 | alter_cred_subscribers(new, 2); |
d84f4f99 DH |
488 | if (new->user != old->user) |
489 | atomic_inc(&new->user->processes); | |
3b11a1de | 490 | rcu_assign_pointer(task->real_cred, new); |
d84f4f99 DH |
491 | rcu_assign_pointer(task->cred, new); |
492 | if (new->user != old->user) | |
493 | atomic_dec(&old->user->processes); | |
e0e81739 | 494 | alter_cred_subscribers(old, -2); |
d84f4f99 | 495 | |
d84f4f99 | 496 | /* send notifications */ |
078de5f7 EB |
497 | if (!uid_eq(new->uid, old->uid) || |
498 | !uid_eq(new->euid, old->euid) || | |
499 | !uid_eq(new->suid, old->suid) || | |
500 | !uid_eq(new->fsuid, old->fsuid)) | |
d84f4f99 | 501 | proc_id_connector(task, PROC_EVENT_UID); |
f1752eec | 502 | |
078de5f7 EB |
503 | if (!gid_eq(new->gid, old->gid) || |
504 | !gid_eq(new->egid, old->egid) || | |
505 | !gid_eq(new->sgid, old->sgid) || | |
506 | !gid_eq(new->fsgid, old->fsgid)) | |
d84f4f99 | 507 | proc_id_connector(task, PROC_EVENT_GID); |
f1752eec | 508 | |
3b11a1de DH |
509 | /* release the old obj and subj refs both */ |
510 | put_cred(old); | |
d84f4f99 | 511 | put_cred(old); |
f1752eec DH |
512 | return 0; |
513 | } | |
d84f4f99 DH |
514 | EXPORT_SYMBOL(commit_creds); |
515 | ||
516 | /** | |
517 | * abort_creds - Discard a set of credentials and unlock the current task | |
518 | * @new: The credentials that were going to be applied | |
519 | * | |
520 | * Discard a set of credentials that were under construction and unlock the | |
521 | * current task. | |
522 | */ | |
523 | void abort_creds(struct cred *new) | |
524 | { | |
e0e81739 DH |
525 | kdebug("abort_creds(%p{%d,%d})", new, |
526 | atomic_read(&new->usage), | |
527 | read_cred_subscribers(new)); | |
528 | ||
529 | #ifdef CONFIG_DEBUG_CREDENTIALS | |
530 | BUG_ON(read_cred_subscribers(new) != 0); | |
531 | #endif | |
d84f4f99 DH |
532 | BUG_ON(atomic_read(&new->usage) < 1); |
533 | put_cred(new); | |
534 | } | |
535 | EXPORT_SYMBOL(abort_creds); | |
536 | ||
537 | /** | |
3b11a1de | 538 | * override_creds - Override the current process's subjective credentials |
d84f4f99 DH |
539 | * @new: The credentials to be assigned |
540 | * | |
3b11a1de DH |
541 | * Install a set of temporary override subjective credentials on the current |
542 | * process, returning the old set for later reversion. | |
d84f4f99 DH |
543 | */ |
544 | const struct cred *override_creds(const struct cred *new) | |
545 | { | |
546 | const struct cred *old = current->cred; | |
547 | ||
e0e81739 DH |
548 | kdebug("override_creds(%p{%d,%d})", new, |
549 | atomic_read(&new->usage), | |
550 | read_cred_subscribers(new)); | |
551 | ||
552 | validate_creds(old); | |
553 | validate_creds(new); | |
d7852fbd LT |
554 | |
555 | /* | |
556 | * NOTE! This uses 'get_new_cred()' rather than 'get_cred()'. | |
557 | * | |
558 | * That means that we do not clear the 'non_rcu' flag, since | |
559 | * we are only installing the cred into the thread-synchronous | |
560 | * '->cred' pointer, not the '->real_cred' pointer that is | |
561 | * visible to other threads under RCU. | |
562 | * | |
563 | * Also note that we did validate_creds() manually, not depending | |
564 | * on the validation in 'get_cred()'. | |
565 | */ | |
566 | get_new_cred((struct cred *)new); | |
e0e81739 DH |
567 | alter_cred_subscribers(new, 1); |
568 | rcu_assign_pointer(current->cred, new); | |
569 | alter_cred_subscribers(old, -1); | |
570 | ||
571 | kdebug("override_creds() = %p{%d,%d}", old, | |
572 | atomic_read(&old->usage), | |
573 | read_cred_subscribers(old)); | |
d84f4f99 DH |
574 | return old; |
575 | } | |
576 | EXPORT_SYMBOL(override_creds); | |
577 | ||
578 | /** | |
3b11a1de | 579 | * revert_creds - Revert a temporary subjective credentials override |
d84f4f99 DH |
580 | * @old: The credentials to be restored |
581 | * | |
3b11a1de DH |
582 | * Revert a temporary set of override subjective credentials to an old set, |
583 | * discarding the override set. | |
d84f4f99 DH |
584 | */ |
585 | void revert_creds(const struct cred *old) | |
586 | { | |
587 | const struct cred *override = current->cred; | |
588 | ||
e0e81739 DH |
589 | kdebug("revert_creds(%p{%d,%d})", old, |
590 | atomic_read(&old->usage), | |
591 | read_cred_subscribers(old)); | |
592 | ||
593 | validate_creds(old); | |
594 | validate_creds(override); | |
595 | alter_cred_subscribers(old, 1); | |
d84f4f99 | 596 | rcu_assign_pointer(current->cred, old); |
e0e81739 | 597 | alter_cred_subscribers(override, -1); |
d84f4f99 DH |
598 | put_cred(override); |
599 | } | |
600 | EXPORT_SYMBOL(revert_creds); | |
601 | ||
d89b22d4 N |
602 | /** |
603 | * cred_fscmp - Compare two credentials with respect to filesystem access. | |
604 | * @a: The first credential | |
605 | * @b: The second credential | |
606 | * | |
607 | * cred_cmp() will return zero if both credentials have the same | |
608 | * fsuid, fsgid, and supplementary groups. That is, if they will both | |
609 | * provide the same access to files based on mode/uid/gid. | |
610 | * If the credentials are different, then either -1 or 1 will | |
611 | * be returned depending on whether @a comes before or after @b | |
612 | * respectively in an arbitrary, but stable, ordering of credentials. | |
613 | * | |
614 | * Return: -1, 0, or 1 depending on comparison | |
615 | */ | |
616 | int cred_fscmp(const struct cred *a, const struct cred *b) | |
617 | { | |
618 | struct group_info *ga, *gb; | |
619 | int g; | |
620 | ||
621 | if (a == b) | |
622 | return 0; | |
623 | if (uid_lt(a->fsuid, b->fsuid)) | |
624 | return -1; | |
625 | if (uid_gt(a->fsuid, b->fsuid)) | |
626 | return 1; | |
627 | ||
628 | if (gid_lt(a->fsgid, b->fsgid)) | |
629 | return -1; | |
630 | if (gid_gt(a->fsgid, b->fsgid)) | |
631 | return 1; | |
632 | ||
633 | ga = a->group_info; | |
634 | gb = b->group_info; | |
635 | if (ga == gb) | |
636 | return 0; | |
637 | if (ga == NULL) | |
638 | return -1; | |
639 | if (gb == NULL) | |
640 | return 1; | |
641 | if (ga->ngroups < gb->ngroups) | |
642 | return -1; | |
643 | if (ga->ngroups > gb->ngroups) | |
644 | return 1; | |
645 | ||
646 | for (g = 0; g < ga->ngroups; g++) { | |
647 | if (gid_lt(ga->gid[g], gb->gid[g])) | |
648 | return -1; | |
649 | if (gid_gt(ga->gid[g], gb->gid[g])) | |
650 | return 1; | |
651 | } | |
652 | return 0; | |
653 | } | |
654 | EXPORT_SYMBOL(cred_fscmp); | |
655 | ||
d84f4f99 DH |
656 | /* |
657 | * initialise the credentials stuff | |
658 | */ | |
659 | void __init cred_init(void) | |
660 | { | |
661 | /* allocate a slab in which we can store credentials */ | |
5d097056 VD |
662 | cred_jar = kmem_cache_create("cred_jar", sizeof(struct cred), 0, |
663 | SLAB_HWCACHE_ALIGN|SLAB_PANIC|SLAB_ACCOUNT, NULL); | |
d84f4f99 | 664 | } |
3a3b7ce9 DH |
665 | |
666 | /** | |
667 | * prepare_kernel_cred - Prepare a set of credentials for a kernel service | |
668 | * @daemon: A userspace daemon to be used as a reference | |
669 | * | |
670 | * Prepare a set of credentials for a kernel service. This can then be used to | |
671 | * override a task's own credentials so that work can be done on behalf of that | |
672 | * task that requires a different subjective context. | |
673 | * | |
674 | * @daemon is used to provide a base for the security record, but can be NULL. | |
675 | * If @daemon is supplied, then the security data will be derived from that; | |
676 | * otherwise they'll be set to 0 and no groups, full capabilities and no keys. | |
677 | * | |
678 | * The caller may change these controls afterwards if desired. | |
679 | * | |
680 | * Returns the new credentials or NULL if out of memory. | |
3a3b7ce9 DH |
681 | */ |
682 | struct cred *prepare_kernel_cred(struct task_struct *daemon) | |
683 | { | |
684 | const struct cred *old; | |
685 | struct cred *new; | |
686 | ||
687 | new = kmem_cache_alloc(cred_jar, GFP_KERNEL); | |
688 | if (!new) | |
689 | return NULL; | |
690 | ||
e0e81739 DH |
691 | kdebug("prepare_kernel_cred() alloc %p", new); |
692 | ||
3a3b7ce9 DH |
693 | if (daemon) |
694 | old = get_task_cred(daemon); | |
695 | else | |
696 | old = get_cred(&init_cred); | |
697 | ||
e0e81739 DH |
698 | validate_creds(old); |
699 | ||
43529c97 | 700 | *new = *old; |
d7852fbd | 701 | new->non_rcu = 0; |
fb2b2a1d TH |
702 | atomic_set(&new->usage, 1); |
703 | set_cred_subscribers(new, 0); | |
3a3b7ce9 | 704 | get_uid(new->user); |
0093ccb6 | 705 | get_user_ns(new->user_ns); |
3a3b7ce9 DH |
706 | get_group_info(new->group_info); |
707 | ||
708 | #ifdef CONFIG_KEYS | |
3a50597d DH |
709 | new->session_keyring = NULL; |
710 | new->process_keyring = NULL; | |
3a3b7ce9 | 711 | new->thread_keyring = NULL; |
3a50597d | 712 | new->request_key_auth = NULL; |
3a3b7ce9 DH |
713 | new->jit_keyring = KEY_REQKEY_DEFL_THREAD_KEYRING; |
714 | #endif | |
715 | ||
716 | #ifdef CONFIG_SECURITY | |
717 | new->security = NULL; | |
718 | #endif | |
84029fd0 | 719 | if (security_prepare_creds(new, old, GFP_KERNEL_ACCOUNT) < 0) |
3a3b7ce9 DH |
720 | goto error; |
721 | ||
3a3b7ce9 | 722 | put_cred(old); |
e0e81739 | 723 | validate_creds(new); |
3a3b7ce9 DH |
724 | return new; |
725 | ||
726 | error: | |
727 | put_cred(new); | |
0de33681 | 728 | put_cred(old); |
3a3b7ce9 DH |
729 | return NULL; |
730 | } | |
731 | EXPORT_SYMBOL(prepare_kernel_cred); | |
732 | ||
733 | /** | |
734 | * set_security_override - Set the security ID in a set of credentials | |
735 | * @new: The credentials to alter | |
736 | * @secid: The LSM security ID to set | |
737 | * | |
738 | * Set the LSM security ID in a set of credentials so that the subjective | |
739 | * security is overridden when an alternative set of credentials is used. | |
740 | */ | |
741 | int set_security_override(struct cred *new, u32 secid) | |
742 | { | |
743 | return security_kernel_act_as(new, secid); | |
744 | } | |
745 | EXPORT_SYMBOL(set_security_override); | |
746 | ||
747 | /** | |
748 | * set_security_override_from_ctx - Set the security ID in a set of credentials | |
749 | * @new: The credentials to alter | |
750 | * @secctx: The LSM security context to generate the security ID from. | |
751 | * | |
752 | * Set the LSM security ID in a set of credentials so that the subjective | |
753 | * security is overridden when an alternative set of credentials is used. The | |
754 | * security ID is specified in string form as a security context to be | |
755 | * interpreted by the LSM. | |
756 | */ | |
757 | int set_security_override_from_ctx(struct cred *new, const char *secctx) | |
758 | { | |
759 | u32 secid; | |
760 | int ret; | |
761 | ||
762 | ret = security_secctx_to_secid(secctx, strlen(secctx), &secid); | |
763 | if (ret < 0) | |
764 | return ret; | |
765 | ||
766 | return set_security_override(new, secid); | |
767 | } | |
768 | EXPORT_SYMBOL(set_security_override_from_ctx); | |
769 | ||
770 | /** | |
771 | * set_create_files_as - Set the LSM file create context in a set of credentials | |
772 | * @new: The credentials to alter | |
773 | * @inode: The inode to take the context from | |
774 | * | |
775 | * Change the LSM file creation context in a set of credentials to be the same | |
776 | * as the object context of the specified inode, so that the new inodes have | |
777 | * the same MAC context as that inode. | |
778 | */ | |
779 | int set_create_files_as(struct cred *new, struct inode *inode) | |
780 | { | |
5f65e5ca SF |
781 | if (!uid_valid(inode->i_uid) || !gid_valid(inode->i_gid)) |
782 | return -EINVAL; | |
3a3b7ce9 DH |
783 | new->fsuid = inode->i_uid; |
784 | new->fsgid = inode->i_gid; | |
785 | return security_kernel_create_files_as(new, inode); | |
786 | } | |
787 | EXPORT_SYMBOL(set_create_files_as); | |
e0e81739 DH |
788 | |
789 | #ifdef CONFIG_DEBUG_CREDENTIALS | |
790 | ||
74908a00 AM |
791 | bool creds_are_invalid(const struct cred *cred) |
792 | { | |
793 | if (cred->magic != CRED_MAGIC) | |
794 | return true; | |
74908a00 AM |
795 | return false; |
796 | } | |
764db03f | 797 | EXPORT_SYMBOL(creds_are_invalid); |
74908a00 | 798 | |
e0e81739 DH |
799 | /* |
800 | * dump invalid credentials | |
801 | */ | |
802 | static void dump_invalid_creds(const struct cred *cred, const char *label, | |
803 | const struct task_struct *tsk) | |
804 | { | |
805 | printk(KERN_ERR "CRED: %s credentials: %p %s%s%s\n", | |
806 | label, cred, | |
807 | cred == &init_cred ? "[init]" : "", | |
808 | cred == tsk->real_cred ? "[real]" : "", | |
809 | cred == tsk->cred ? "[eff]" : ""); | |
810 | printk(KERN_ERR "CRED: ->magic=%x, put_addr=%p\n", | |
811 | cred->magic, cred->put_addr); | |
812 | printk(KERN_ERR "CRED: ->usage=%d, subscr=%d\n", | |
813 | atomic_read(&cred->usage), | |
814 | read_cred_subscribers(cred)); | |
815 | printk(KERN_ERR "CRED: ->*uid = { %d,%d,%d,%d }\n", | |
c9235f48 EB |
816 | from_kuid_munged(&init_user_ns, cred->uid), |
817 | from_kuid_munged(&init_user_ns, cred->euid), | |
818 | from_kuid_munged(&init_user_ns, cred->suid), | |
819 | from_kuid_munged(&init_user_ns, cred->fsuid)); | |
e0e81739 | 820 | printk(KERN_ERR "CRED: ->*gid = { %d,%d,%d,%d }\n", |
c9235f48 EB |
821 | from_kgid_munged(&init_user_ns, cred->gid), |
822 | from_kgid_munged(&init_user_ns, cred->egid), | |
823 | from_kgid_munged(&init_user_ns, cred->sgid), | |
824 | from_kgid_munged(&init_user_ns, cred->fsgid)); | |
e0e81739 DH |
825 | #ifdef CONFIG_SECURITY |
826 | printk(KERN_ERR "CRED: ->security is %p\n", cred->security); | |
827 | if ((unsigned long) cred->security >= PAGE_SIZE && | |
828 | (((unsigned long) cred->security & 0xffffff00) != | |
829 | (POISON_FREE << 24 | POISON_FREE << 16 | POISON_FREE << 8))) | |
830 | printk(KERN_ERR "CRED: ->security {%x, %x}\n", | |
831 | ((u32*)cred->security)[0], | |
832 | ((u32*)cred->security)[1]); | |
833 | #endif | |
834 | } | |
835 | ||
836 | /* | |
837 | * report use of invalid credentials | |
838 | */ | |
839 | void __invalid_creds(const struct cred *cred, const char *file, unsigned line) | |
840 | { | |
841 | printk(KERN_ERR "CRED: Invalid credentials\n"); | |
842 | printk(KERN_ERR "CRED: At %s:%u\n", file, line); | |
843 | dump_invalid_creds(cred, "Specified", current); | |
844 | BUG(); | |
845 | } | |
846 | EXPORT_SYMBOL(__invalid_creds); | |
847 | ||
848 | /* | |
849 | * check the credentials on a process | |
850 | */ | |
851 | void __validate_process_creds(struct task_struct *tsk, | |
852 | const char *file, unsigned line) | |
853 | { | |
854 | if (tsk->cred == tsk->real_cred) { | |
855 | if (unlikely(read_cred_subscribers(tsk->cred) < 2 || | |
856 | creds_are_invalid(tsk->cred))) | |
857 | goto invalid_creds; | |
858 | } else { | |
859 | if (unlikely(read_cred_subscribers(tsk->real_cred) < 1 || | |
860 | read_cred_subscribers(tsk->cred) < 1 || | |
861 | creds_are_invalid(tsk->real_cred) || | |
862 | creds_are_invalid(tsk->cred))) | |
863 | goto invalid_creds; | |
864 | } | |
865 | return; | |
866 | ||
867 | invalid_creds: | |
868 | printk(KERN_ERR "CRED: Invalid process credentials\n"); | |
869 | printk(KERN_ERR "CRED: At %s:%u\n", file, line); | |
870 | ||
871 | dump_invalid_creds(tsk->real_cred, "Real", tsk); | |
872 | if (tsk->cred != tsk->real_cred) | |
873 | dump_invalid_creds(tsk->cred, "Effective", tsk); | |
874 | else | |
875 | printk(KERN_ERR "CRED: Effective creds == Real creds\n"); | |
876 | BUG(); | |
877 | } | |
878 | EXPORT_SYMBOL(__validate_process_creds); | |
879 | ||
880 | /* | |
881 | * check creds for do_exit() | |
882 | */ | |
883 | void validate_creds_for_do_exit(struct task_struct *tsk) | |
884 | { | |
885 | kdebug("validate_creds_for_do_exit(%p,%p{%d,%d})", | |
886 | tsk->real_cred, tsk->cred, | |
887 | atomic_read(&tsk->cred->usage), | |
888 | read_cred_subscribers(tsk->cred)); | |
889 | ||
890 | __validate_process_creds(tsk, __FILE__, __LINE__); | |
891 | } | |
892 | ||
893 | #endif /* CONFIG_DEBUG_CREDENTIALS */ |