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_NEWTIME | CLONE_NEWUSER |
266 CLONE_NEWPID | CLONE_NEWCGROUP)))
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)
293 #ifndef CONFIG_TIME_NS
294 if (flags & CLONE_NEWTIME)
301 static void put_nsset(struct nsset *nsset)
303 unsigned flags = nsset->flags;
305 if (flags & CLONE_NEWUSER)
306 put_cred(nsset_cred(nsset));
308 * We only created a temporary copy if we attached to more than just
309 * the mount namespace.
311 if (nsset->fs && (flags & CLONE_NEWNS) && (flags & ~CLONE_NEWNS))
312 free_fs_struct(nsset->fs);
314 free_nsproxy(nsset->nsproxy);
317 static int prepare_nsset(unsigned flags, struct nsset *nsset)
319 struct task_struct *me = current;
321 nsset->nsproxy = create_new_namespaces(0, me, current_user_ns(), me->fs);
322 if (IS_ERR(nsset->nsproxy))
323 return PTR_ERR(nsset->nsproxy);
325 if (flags & CLONE_NEWUSER)
326 nsset->cred = prepare_creds();
328 nsset->cred = current_cred();
332 /* Only create a temporary copy of fs_struct if we really need to. */
333 if (flags == CLONE_NEWNS) {
335 } else if (flags & CLONE_NEWNS) {
336 nsset->fs = copy_fs_struct(me->fs);
341 nsset->flags = flags;
349 static inline int validate_ns(struct nsset *nsset, struct ns_common *ns)
351 return ns->ops->install(nsset, ns);
355 * This is the inverse operation to unshare().
356 * Ordering is equivalent to the standard ordering used everywhere else
357 * during unshare and process creation. The switch to the new set of
358 * namespaces occurs at the point of no return after installation of
359 * all requested namespaces was successful in commit_nsset().
361 static int validate_nsset(struct nsset *nsset, struct pid *pid)
364 unsigned flags = nsset->flags;
365 struct user_namespace *user_ns = NULL;
366 struct pid_namespace *pid_ns = NULL;
368 struct task_struct *tsk;
370 /* Take a "snapshot" of the target task's namespaces. */
372 tsk = pid_task(pid, PIDTYPE_PID);
378 if (!ptrace_may_access(tsk, PTRACE_MODE_READ_REALCREDS)) {
394 if (flags & CLONE_NEWPID) {
395 pid_ns = task_active_pid_ns(tsk);
396 if (unlikely(!pid_ns)) {
405 #ifdef CONFIG_USER_NS
406 if (flags & CLONE_NEWUSER)
407 user_ns = get_user_ns(__task_cred(tsk)->user_ns);
412 * Install requested namespaces. The caller will have
413 * verified earlier that the requested namespaces are
414 * supported on this kernel. We don't report errors here
415 * if a namespace is requested that isn't supported.
417 #ifdef CONFIG_USER_NS
418 if (flags & CLONE_NEWUSER) {
419 ret = validate_ns(nsset, &user_ns->ns);
425 if (flags & CLONE_NEWNS) {
426 ret = validate_ns(nsset, from_mnt_ns(nsp->mnt_ns));
432 if (flags & CLONE_NEWUTS) {
433 ret = validate_ns(nsset, &nsp->uts_ns->ns);
440 if (flags & CLONE_NEWIPC) {
441 ret = validate_ns(nsset, &nsp->ipc_ns->ns);
448 if (flags & CLONE_NEWPID) {
449 ret = validate_ns(nsset, &pid_ns->ns);
455 #ifdef CONFIG_CGROUPS
456 if (flags & CLONE_NEWCGROUP) {
457 ret = validate_ns(nsset, &nsp->cgroup_ns->ns);
464 if (flags & CLONE_NEWNET) {
465 ret = validate_ns(nsset, &nsp->net_ns->ns);
471 #ifdef CONFIG_TIME_NS
472 if (flags & CLONE_NEWTIME) {
473 ret = validate_ns(nsset, &nsp->time_ns->ns);
484 put_user_ns(user_ns);
490 * This is the point of no return. There are just a few namespaces
491 * that do some actual work here and it's sufficiently minimal that
492 * a separate ns_common operation seems unnecessary for now.
493 * Unshare is doing the same thing. If we'll end up needing to do
494 * more in a given namespace or a helper here is ultimately not
495 * exported anymore a simple commit handler for each namespace
496 * should be added to ns_common.
498 static void commit_nsset(struct nsset *nsset)
500 unsigned flags = nsset->flags;
501 struct task_struct *me = current;
503 #ifdef CONFIG_USER_NS
504 if (flags & CLONE_NEWUSER) {
505 /* transfer ownership */
506 commit_creds(nsset_cred(nsset));
511 /* We only need to commit if we have used a temporary fs_struct. */
512 if ((flags & CLONE_NEWNS) && (flags & ~CLONE_NEWNS)) {
513 set_fs_root(me->fs, &nsset->fs->root);
514 set_fs_pwd(me->fs, &nsset->fs->pwd);
518 if (flags & CLONE_NEWIPC)
522 #ifdef CONFIG_TIME_NS
523 if (flags & CLONE_NEWTIME)
524 timens_commit(me, nsset->nsproxy->time_ns);
527 /* transfer ownership */
528 switch_task_namespaces(me, nsset->nsproxy);
529 nsset->nsproxy = NULL;
532 SYSCALL_DEFINE2(setns, int, fd, int, flags)
535 struct ns_common *ns = NULL;
536 struct nsset nsset = {};
543 if (proc_ns_file(file)) {
544 ns = get_proc_ns(file_inode(file));
545 if (flags && (ns->ops->type != flags))
547 flags = ns->ops->type;
548 } else if (!IS_ERR(pidfd_pid(file))) {
549 err = check_setns_flags(flags);
556 err = prepare_nsset(flags, &nsset);
560 if (proc_ns_file(file))
561 err = validate_ns(&nsset, ns);
563 err = validate_nsset(&nsset, file->private_data);
565 commit_nsset(&nsset);
566 perf_event_namespaces(current);
574 int __init nsproxy_cache_init(void)
576 nsproxy_cachep = KMEM_CACHE(nsproxy, SLAB_PANIC);