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;
157 if (likely(!(flags & (CLONE_NEWNS | CLONE_NEWUTS | CLONE_NEWIPC |
158 CLONE_NEWPID | CLONE_NEWNET |
159 CLONE_NEWCGROUP | CLONE_NEWTIME)))) {
160 if (likely(old_ns->time_ns_for_children == old_ns->time_ns)) {
164 } else if (!ns_capable(user_ns, CAP_SYS_ADMIN))
168 * CLONE_NEWIPC must detach from the undolist: after switching
169 * to a new ipc namespace, the semaphore arrays from the old
170 * namespace are unreachable. In clone parlance, CLONE_SYSVSEM
171 * means share undolist with parent, so we must forbid using
172 * it along with CLONE_NEWIPC.
174 if ((flags & (CLONE_NEWIPC | CLONE_SYSVSEM)) ==
175 (CLONE_NEWIPC | CLONE_SYSVSEM))
178 new_ns = create_new_namespaces(flags, tsk, user_ns, tsk->fs);
180 return PTR_ERR(new_ns);
182 timens_on_fork(new_ns, tsk);
184 tsk->nsproxy = new_ns;
188 void free_nsproxy(struct nsproxy *ns)
191 put_mnt_ns(ns->mnt_ns);
193 put_uts_ns(ns->uts_ns);
195 put_ipc_ns(ns->ipc_ns);
196 if (ns->pid_ns_for_children)
197 put_pid_ns(ns->pid_ns_for_children);
199 put_time_ns(ns->time_ns);
200 if (ns->time_ns_for_children)
201 put_time_ns(ns->time_ns_for_children);
202 put_cgroup_ns(ns->cgroup_ns);
204 kmem_cache_free(nsproxy_cachep, ns);
208 * Called from unshare. Unshare all the namespaces part of nsproxy.
209 * On success, returns the new nsproxy.
211 int unshare_nsproxy_namespaces(unsigned long unshare_flags,
212 struct nsproxy **new_nsp, struct cred *new_cred, struct fs_struct *new_fs)
214 struct user_namespace *user_ns;
217 if (!(unshare_flags & (CLONE_NEWNS | CLONE_NEWUTS | CLONE_NEWIPC |
218 CLONE_NEWNET | CLONE_NEWPID | CLONE_NEWCGROUP |
222 user_ns = new_cred ? new_cred->user_ns : current_user_ns();
223 if (!ns_capable(user_ns, CAP_SYS_ADMIN))
226 *new_nsp = create_new_namespaces(unshare_flags, current, user_ns,
227 new_fs ? new_fs : current->fs);
228 if (IS_ERR(*new_nsp)) {
229 err = PTR_ERR(*new_nsp);
237 void switch_task_namespaces(struct task_struct *p, struct nsproxy *new)
252 void exit_task_namespaces(struct task_struct *p)
254 switch_task_namespaces(p, NULL);
257 static int check_setns_flags(unsigned long flags)
259 if (!flags || (flags & ~(CLONE_NEWNS | CLONE_NEWUTS | CLONE_NEWIPC |
260 CLONE_NEWNET | CLONE_NEWTIME | CLONE_NEWUSER |
261 CLONE_NEWPID | CLONE_NEWCGROUP)))
264 #ifndef CONFIG_USER_NS
265 if (flags & CLONE_NEWUSER)
268 #ifndef CONFIG_PID_NS
269 if (flags & CLONE_NEWPID)
272 #ifndef CONFIG_UTS_NS
273 if (flags & CLONE_NEWUTS)
276 #ifndef CONFIG_IPC_NS
277 if (flags & CLONE_NEWIPC)
280 #ifndef CONFIG_CGROUPS
281 if (flags & CLONE_NEWCGROUP)
284 #ifndef CONFIG_NET_NS
285 if (flags & CLONE_NEWNET)
288 #ifndef CONFIG_TIME_NS
289 if (flags & CLONE_NEWTIME)
296 static void put_nsset(struct nsset *nsset)
298 unsigned flags = nsset->flags;
300 if (flags & CLONE_NEWUSER)
301 put_cred(nsset_cred(nsset));
303 * We only created a temporary copy if we attached to more than just
304 * the mount namespace.
306 if (nsset->fs && (flags & CLONE_NEWNS) && (flags & ~CLONE_NEWNS))
307 free_fs_struct(nsset->fs);
309 free_nsproxy(nsset->nsproxy);
312 static int prepare_nsset(unsigned flags, struct nsset *nsset)
314 struct task_struct *me = current;
316 nsset->nsproxy = create_new_namespaces(0, me, current_user_ns(), me->fs);
317 if (IS_ERR(nsset->nsproxy))
318 return PTR_ERR(nsset->nsproxy);
320 if (flags & CLONE_NEWUSER)
321 nsset->cred = prepare_creds();
323 nsset->cred = current_cred();
327 /* Only create a temporary copy of fs_struct if we really need to. */
328 if (flags == CLONE_NEWNS) {
330 } else if (flags & CLONE_NEWNS) {
331 nsset->fs = copy_fs_struct(me->fs);
336 nsset->flags = flags;
344 static inline int validate_ns(struct nsset *nsset, struct ns_common *ns)
346 return ns->ops->install(nsset, ns);
350 * This is the inverse operation to unshare().
351 * Ordering is equivalent to the standard ordering used everywhere else
352 * during unshare and process creation. The switch to the new set of
353 * namespaces occurs at the point of no return after installation of
354 * all requested namespaces was successful in commit_nsset().
356 static int validate_nsset(struct nsset *nsset, struct pid *pid)
359 unsigned flags = nsset->flags;
360 struct user_namespace *user_ns = NULL;
361 struct pid_namespace *pid_ns = NULL;
363 struct task_struct *tsk;
365 /* Take a "snapshot" of the target task's namespaces. */
367 tsk = pid_task(pid, PIDTYPE_PID);
373 if (!ptrace_may_access(tsk, PTRACE_MODE_READ_REALCREDS)) {
389 if (flags & CLONE_NEWPID) {
390 pid_ns = task_active_pid_ns(tsk);
391 if (unlikely(!pid_ns)) {
400 #ifdef CONFIG_USER_NS
401 if (flags & CLONE_NEWUSER)
402 user_ns = get_user_ns(__task_cred(tsk)->user_ns);
407 * Install requested namespaces. The caller will have
408 * verified earlier that the requested namespaces are
409 * supported on this kernel. We don't report errors here
410 * if a namespace is requested that isn't supported.
412 #ifdef CONFIG_USER_NS
413 if (flags & CLONE_NEWUSER) {
414 ret = validate_ns(nsset, &user_ns->ns);
420 if (flags & CLONE_NEWNS) {
421 ret = validate_ns(nsset, from_mnt_ns(nsp->mnt_ns));
427 if (flags & CLONE_NEWUTS) {
428 ret = validate_ns(nsset, &nsp->uts_ns->ns);
435 if (flags & CLONE_NEWIPC) {
436 ret = validate_ns(nsset, &nsp->ipc_ns->ns);
443 if (flags & CLONE_NEWPID) {
444 ret = validate_ns(nsset, &pid_ns->ns);
450 #ifdef CONFIG_CGROUPS
451 if (flags & CLONE_NEWCGROUP) {
452 ret = validate_ns(nsset, &nsp->cgroup_ns->ns);
459 if (flags & CLONE_NEWNET) {
460 ret = validate_ns(nsset, &nsp->net_ns->ns);
466 #ifdef CONFIG_TIME_NS
467 if (flags & CLONE_NEWTIME) {
468 ret = validate_ns(nsset, &nsp->time_ns->ns);
479 put_user_ns(user_ns);
485 * This is the point of no return. There are just a few namespaces
486 * that do some actual work here and it's sufficiently minimal that
487 * a separate ns_common operation seems unnecessary for now.
488 * Unshare is doing the same thing. If we'll end up needing to do
489 * more in a given namespace or a helper here is ultimately not
490 * exported anymore a simple commit handler for each namespace
491 * should be added to ns_common.
493 static void commit_nsset(struct nsset *nsset)
495 unsigned flags = nsset->flags;
496 struct task_struct *me = current;
498 #ifdef CONFIG_USER_NS
499 if (flags & CLONE_NEWUSER) {
500 /* transfer ownership */
501 commit_creds(nsset_cred(nsset));
506 /* We only need to commit if we have used a temporary fs_struct. */
507 if ((flags & CLONE_NEWNS) && (flags & ~CLONE_NEWNS)) {
508 set_fs_root(me->fs, &nsset->fs->root);
509 set_fs_pwd(me->fs, &nsset->fs->pwd);
513 if (flags & CLONE_NEWIPC)
517 #ifdef CONFIG_TIME_NS
518 if (flags & CLONE_NEWTIME)
519 timens_commit(me, nsset->nsproxy->time_ns);
522 /* transfer ownership */
523 switch_task_namespaces(me, nsset->nsproxy);
524 nsset->nsproxy = NULL;
527 SYSCALL_DEFINE2(setns, int, fd, int, flags)
530 struct ns_common *ns = NULL;
531 struct nsset nsset = {};
538 if (proc_ns_file(file)) {
539 ns = get_proc_ns(file_inode(file));
540 if (flags && (ns->ops->type != flags))
542 flags = ns->ops->type;
543 } else if (!IS_ERR(pidfd_pid(file))) {
544 err = check_setns_flags(flags);
551 err = prepare_nsset(flags, &nsset);
555 if (proc_ns_file(file))
556 err = validate_ns(&nsset, ns);
558 err = validate_nsset(&nsset, file->private_data);
560 commit_nsset(&nsset);
561 perf_event_namespaces(current);
569 int __init nsproxy_cache_init(void)
571 nsproxy_cachep = KMEM_CACHE(nsproxy, SLAB_PANIC);