1 // SPDX-License-Identifier: GPL-2.0-only
3 * Copyright (C) 2006 IBM Corporation
5 * Author: Serge Hallyn <serue@us.ibm.com>
7 * Jun 2006 - namespaces support
9 * Pavel Emelianov <xemul@openvz.org>
12 #include <linux/slab.h>
13 #include <linux/export.h>
14 #include <linux/nsproxy.h>
15 #include <linux/init_task.h>
16 #include <linux/mnt_namespace.h>
17 #include <linux/utsname.h>
18 #include <linux/pid_namespace.h>
19 #include <net/net_namespace.h>
20 #include <linux/ipc_namespace.h>
21 #include <linux/time_namespace.h>
22 #include <linux/fs_struct.h>
23 #include <linux/proc_fs.h>
24 #include <linux/proc_ns.h>
25 #include <linux/file.h>
26 #include <linux/syscalls.h>
27 #include <linux/cgroup.h>
28 #include <linux/perf_event.h>
30 static struct kmem_cache *nsproxy_cachep;
32 struct nsproxy init_nsproxy = {
33 .count = ATOMIC_INIT(1),
34 .uts_ns = &init_uts_ns,
35 #if defined(CONFIG_POSIX_MQUEUE) || defined(CONFIG_SYSVIPC)
36 .ipc_ns = &init_ipc_ns,
39 .pid_ns_for_children = &init_pid_ns,
44 .cgroup_ns = &init_cgroup_ns,
47 .time_ns = &init_time_ns,
48 .time_ns_for_children = &init_time_ns,
52 static inline struct nsproxy *create_nsproxy(void)
54 struct nsproxy *nsproxy;
56 nsproxy = kmem_cache_alloc(nsproxy_cachep, GFP_KERNEL);
58 atomic_set(&nsproxy->count, 1);
63 * Create new nsproxy and all of its the associated namespaces.
64 * Return the newly created nsproxy. Do not attach this to the task,
65 * leave it to the caller to do proper locking and attach it to task.
67 static struct nsproxy *create_new_namespaces(unsigned long flags,
68 struct task_struct *tsk, struct user_namespace *user_ns,
69 struct fs_struct *new_fs)
71 struct nsproxy *new_nsp;
74 new_nsp = create_nsproxy();
76 return ERR_PTR(-ENOMEM);
78 new_nsp->mnt_ns = copy_mnt_ns(flags, tsk->nsproxy->mnt_ns, user_ns, new_fs);
79 if (IS_ERR(new_nsp->mnt_ns)) {
80 err = PTR_ERR(new_nsp->mnt_ns);
84 new_nsp->uts_ns = copy_utsname(flags, user_ns, tsk->nsproxy->uts_ns);
85 if (IS_ERR(new_nsp->uts_ns)) {
86 err = PTR_ERR(new_nsp->uts_ns);
90 new_nsp->ipc_ns = copy_ipcs(flags, user_ns, tsk->nsproxy->ipc_ns);
91 if (IS_ERR(new_nsp->ipc_ns)) {
92 err = PTR_ERR(new_nsp->ipc_ns);
96 new_nsp->pid_ns_for_children =
97 copy_pid_ns(flags, user_ns, tsk->nsproxy->pid_ns_for_children);
98 if (IS_ERR(new_nsp->pid_ns_for_children)) {
99 err = PTR_ERR(new_nsp->pid_ns_for_children);
103 new_nsp->cgroup_ns = copy_cgroup_ns(flags, user_ns,
104 tsk->nsproxy->cgroup_ns);
105 if (IS_ERR(new_nsp->cgroup_ns)) {
106 err = PTR_ERR(new_nsp->cgroup_ns);
110 new_nsp->net_ns = copy_net_ns(flags, user_ns, tsk->nsproxy->net_ns);
111 if (IS_ERR(new_nsp->net_ns)) {
112 err = PTR_ERR(new_nsp->net_ns);
116 new_nsp->time_ns_for_children = copy_time_ns(flags, user_ns,
117 tsk->nsproxy->time_ns_for_children);
118 if (IS_ERR(new_nsp->time_ns_for_children)) {
119 err = PTR_ERR(new_nsp->time_ns_for_children);
122 new_nsp->time_ns = get_time_ns(tsk->nsproxy->time_ns);
127 put_net(new_nsp->net_ns);
129 put_cgroup_ns(new_nsp->cgroup_ns);
131 if (new_nsp->pid_ns_for_children)
132 put_pid_ns(new_nsp->pid_ns_for_children);
135 put_ipc_ns(new_nsp->ipc_ns);
138 put_uts_ns(new_nsp->uts_ns);
141 put_mnt_ns(new_nsp->mnt_ns);
143 kmem_cache_free(nsproxy_cachep, new_nsp);
148 * called from clone. This now handles copy for nsproxy and all
149 * namespaces therein.
151 int copy_namespaces(unsigned long flags, struct task_struct *tsk)
153 struct nsproxy *old_ns = tsk->nsproxy;
154 struct user_namespace *user_ns = task_cred_xxx(tsk, user_ns);
155 struct nsproxy *new_ns;
158 if (likely(!(flags & (CLONE_NEWNS | CLONE_NEWUTS | CLONE_NEWIPC |
159 CLONE_NEWPID | CLONE_NEWNET |
160 CLONE_NEWCGROUP | CLONE_NEWTIME)))) {
161 if (likely(old_ns->time_ns_for_children == old_ns->time_ns)) {
165 } else if (!ns_capable(user_ns, CAP_SYS_ADMIN))
169 * CLONE_NEWIPC must detach from the undolist: after switching
170 * to a new ipc namespace, the semaphore arrays from the old
171 * namespace are unreachable. In clone parlance, CLONE_SYSVSEM
172 * means share undolist with parent, so we must forbid using
173 * it along with CLONE_NEWIPC.
175 if ((flags & (CLONE_NEWIPC | CLONE_SYSVSEM)) ==
176 (CLONE_NEWIPC | CLONE_SYSVSEM))
179 new_ns = create_new_namespaces(flags, tsk, user_ns, tsk->fs);
181 return PTR_ERR(new_ns);
183 ret = timens_on_fork(new_ns, tsk);
185 free_nsproxy(new_ns);
189 tsk->nsproxy = new_ns;
193 void free_nsproxy(struct nsproxy *ns)
196 put_mnt_ns(ns->mnt_ns);
198 put_uts_ns(ns->uts_ns);
200 put_ipc_ns(ns->ipc_ns);
201 if (ns->pid_ns_for_children)
202 put_pid_ns(ns->pid_ns_for_children);
204 put_time_ns(ns->time_ns);
205 if (ns->time_ns_for_children)
206 put_time_ns(ns->time_ns_for_children);
207 put_cgroup_ns(ns->cgroup_ns);
209 kmem_cache_free(nsproxy_cachep, ns);
213 * Called from unshare. Unshare all the namespaces part of nsproxy.
214 * On success, returns the new nsproxy.
216 int unshare_nsproxy_namespaces(unsigned long unshare_flags,
217 struct nsproxy **new_nsp, struct cred *new_cred, struct fs_struct *new_fs)
219 struct user_namespace *user_ns;
222 if (!(unshare_flags & (CLONE_NEWNS | CLONE_NEWUTS | CLONE_NEWIPC |
223 CLONE_NEWNET | CLONE_NEWPID | CLONE_NEWCGROUP |
227 user_ns = new_cred ? new_cred->user_ns : current_user_ns();
228 if (!ns_capable(user_ns, CAP_SYS_ADMIN))
231 *new_nsp = create_new_namespaces(unshare_flags, current, user_ns,
232 new_fs ? new_fs : current->fs);
233 if (IS_ERR(*new_nsp)) {
234 err = PTR_ERR(*new_nsp);
242 void switch_task_namespaces(struct task_struct *p, struct nsproxy *new)
253 if (ns && atomic_dec_and_test(&ns->count))
257 void exit_task_namespaces(struct task_struct *p)
259 switch_task_namespaces(p, NULL);
262 static int check_setns_flags(unsigned long flags)
264 if (!flags || (flags & ~(CLONE_NEWNS | CLONE_NEWUTS | CLONE_NEWIPC |
265 CLONE_NEWNET | CLONE_NEWUSER | CLONE_NEWPID |
269 #ifndef CONFIG_USER_NS
270 if (flags & CLONE_NEWUSER)
273 #ifndef CONFIG_PID_NS
274 if (flags & CLONE_NEWPID)
277 #ifndef CONFIG_UTS_NS
278 if (flags & CLONE_NEWUTS)
281 #ifndef CONFIG_IPC_NS
282 if (flags & CLONE_NEWIPC)
285 #ifndef CONFIG_CGROUPS
286 if (flags & CLONE_NEWCGROUP)
289 #ifndef CONFIG_NET_NS
290 if (flags & CLONE_NEWNET)
297 static void put_nsset(struct nsset *nsset)
299 unsigned flags = nsset->flags;
301 if (flags & CLONE_NEWUSER)
302 put_cred(nsset_cred(nsset));
304 * We only created a temporary copy if we attached to more than just
305 * the mount namespace.
307 if (nsset->fs && (flags & CLONE_NEWNS) && (flags & ~CLONE_NEWNS))
308 free_fs_struct(nsset->fs);
310 free_nsproxy(nsset->nsproxy);
313 static int prepare_nsset(unsigned flags, struct nsset *nsset)
315 struct task_struct *me = current;
317 nsset->nsproxy = create_new_namespaces(0, me, current_user_ns(), me->fs);
318 if (IS_ERR(nsset->nsproxy))
319 return PTR_ERR(nsset->nsproxy);
321 if (flags & CLONE_NEWUSER)
322 nsset->cred = prepare_creds();
324 nsset->cred = current_cred();
328 /* Only create a temporary copy of fs_struct if we really need to. */
329 if (flags == CLONE_NEWNS) {
331 } else if (flags & CLONE_NEWNS) {
332 nsset->fs = copy_fs_struct(me->fs);
337 nsset->flags = flags;
345 static inline int validate_ns(struct nsset *nsset, struct ns_common *ns)
347 return ns->ops->install(nsset, ns);
351 * This is the inverse operation to unshare().
352 * Ordering is equivalent to the standard ordering used everywhere else
353 * during unshare and process creation. The switch to the new set of
354 * namespaces occurs at the point of no return after installation of
355 * all requested namespaces was successful in commit_nsset().
357 static int validate_nsset(struct nsset *nsset, struct pid *pid)
360 unsigned flags = nsset->flags;
361 struct user_namespace *user_ns = NULL;
362 struct pid_namespace *pid_ns = NULL;
364 struct task_struct *tsk;
366 /* Take a "snapshot" of the target task's namespaces. */
368 tsk = pid_task(pid, PIDTYPE_PID);
374 if (!ptrace_may_access(tsk, PTRACE_MODE_READ_REALCREDS)) {
390 if (flags & CLONE_NEWPID) {
391 pid_ns = task_active_pid_ns(tsk);
392 if (unlikely(!pid_ns)) {
401 #ifdef CONFIG_USER_NS
402 if (flags & CLONE_NEWUSER)
403 user_ns = get_user_ns(__task_cred(tsk)->user_ns);
408 * Install requested namespaces. The caller will have
409 * verified earlier that the requested namespaces are
410 * supported on this kernel. We don't report errors here
411 * if a namespace is requested that isn't supported.
413 #ifdef CONFIG_USER_NS
414 if (flags & CLONE_NEWUSER) {
415 ret = validate_ns(nsset, &user_ns->ns);
421 if (flags & CLONE_NEWNS) {
422 ret = validate_ns(nsset, from_mnt_ns(nsp->mnt_ns));
428 if (flags & CLONE_NEWUTS) {
429 ret = validate_ns(nsset, &nsp->uts_ns->ns);
436 if (flags & CLONE_NEWIPC) {
437 ret = validate_ns(nsset, &nsp->ipc_ns->ns);
444 if (flags & CLONE_NEWPID) {
445 ret = validate_ns(nsset, &pid_ns->ns);
451 #ifdef CONFIG_CGROUPS
452 if (flags & CLONE_NEWCGROUP) {
453 ret = validate_ns(nsset, &nsp->cgroup_ns->ns);
460 if (flags & CLONE_NEWNET) {
461 ret = validate_ns(nsset, &nsp->net_ns->ns);
472 put_user_ns(user_ns);
478 * This is the point of no return. There are just a few namespaces
479 * that do some actual work here and it's sufficiently minimal that
480 * a separate ns_common operation seems unnecessary for now.
481 * Unshare is doing the same thing. If we'll end up needing to do
482 * more in a given namespace or a helper here is ultimately not
483 * exported anymore a simple commit handler for each namespace
484 * should be added to ns_common.
486 static void commit_nsset(struct nsset *nsset)
488 unsigned flags = nsset->flags;
489 struct task_struct *me = current;
491 #ifdef CONFIG_USER_NS
492 if (flags & CLONE_NEWUSER) {
493 /* transfer ownership */
494 commit_creds(nsset_cred(nsset));
499 /* We only need to commit if we have used a temporary fs_struct. */
500 if ((flags & CLONE_NEWNS) && (flags & ~CLONE_NEWNS)) {
501 set_fs_root(me->fs, &nsset->fs->root);
502 set_fs_pwd(me->fs, &nsset->fs->pwd);
506 if (flags & CLONE_NEWIPC)
510 /* transfer ownership */
511 switch_task_namespaces(me, nsset->nsproxy);
512 nsset->nsproxy = NULL;
515 SYSCALL_DEFINE2(setns, int, fd, int, flags)
518 struct ns_common *ns = NULL;
519 struct nsset nsset = {};
526 if (proc_ns_file(file)) {
527 ns = get_proc_ns(file_inode(file));
528 if (flags && (ns->ops->type != flags))
530 flags = ns->ops->type;
531 } else if (!IS_ERR(pidfd_pid(file))) {
532 err = check_setns_flags(flags);
539 err = prepare_nsset(flags, &nsset);
543 if (proc_ns_file(file))
544 err = validate_ns(&nsset, ns);
546 err = validate_nsset(&nsset, file->private_data);
548 commit_nsset(&nsset);
549 perf_event_namespaces(current);
557 int __init nsproxy_cache_init(void)
559 nsproxy_cachep = KMEM_CACHE(nsproxy, SLAB_PANIC);