• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1 /*
2  *  linux/fs/pnode.c
3  *
4  * (C) Copyright IBM Corporation 2005.
5  *	Released under GPL v2.
6  *	Author : Ram Pai (linuxram@us.ibm.com)
7  *
8  */
9 #include <linux/mnt_namespace.h>
10 #include <linux/mount.h>
11 #include <linux/fs.h>
12 #include <linux/nsproxy.h>
13 #include "internal.h"
14 #include "pnode.h"
15 
16 /* return the next shared peer mount of @p */
next_peer(struct mount * p)17 static inline struct mount *next_peer(struct mount *p)
18 {
19 	return list_entry(p->mnt_share.next, struct mount, mnt_share);
20 }
21 
first_slave(struct mount * p)22 static inline struct mount *first_slave(struct mount *p)
23 {
24 	return list_entry(p->mnt_slave_list.next, struct mount, mnt_slave);
25 }
26 
last_slave(struct mount * p)27 static inline struct mount *last_slave(struct mount *p)
28 {
29 	return list_entry(p->mnt_slave_list.prev, struct mount, mnt_slave);
30 }
31 
next_slave(struct mount * p)32 static inline struct mount *next_slave(struct mount *p)
33 {
34 	return list_entry(p->mnt_slave.next, struct mount, mnt_slave);
35 }
36 
get_peer_under_root(struct mount * mnt,struct mnt_namespace * ns,const struct path * root)37 static struct mount *get_peer_under_root(struct mount *mnt,
38 					 struct mnt_namespace *ns,
39 					 const struct path *root)
40 {
41 	struct mount *m = mnt;
42 
43 	do {
44 		/* Check the namespace first for optimization */
45 		if (m->mnt_ns == ns && is_path_reachable(m, m->mnt.mnt_root, root))
46 			return m;
47 
48 		m = next_peer(m);
49 	} while (m != mnt);
50 
51 	return NULL;
52 }
53 
54 /*
55  * Get ID of closest dominating peer group having a representative
56  * under the given root.
57  *
58  * Caller must hold namespace_sem
59  */
get_dominating_id(struct mount * mnt,const struct path * root)60 int get_dominating_id(struct mount *mnt, const struct path *root)
61 {
62 	struct mount *m;
63 
64 	for (m = mnt->mnt_master; m != NULL; m = m->mnt_master) {
65 		struct mount *d = get_peer_under_root(m, mnt->mnt_ns, root);
66 		if (d)
67 			return d->mnt_group_id;
68 	}
69 
70 	return 0;
71 }
72 
do_make_slave(struct mount * mnt)73 static int do_make_slave(struct mount *mnt)
74 {
75 	struct mount *peer_mnt = mnt, *master = mnt->mnt_master;
76 	struct mount *slave_mnt;
77 
78 	/*
79 	 * slave 'mnt' to a peer mount that has the
80 	 * same root dentry. If none is available then
81 	 * slave it to anything that is available.
82 	 */
83 	while ((peer_mnt = next_peer(peer_mnt)) != mnt &&
84 	       peer_mnt->mnt.mnt_root != mnt->mnt.mnt_root) ;
85 
86 	if (peer_mnt == mnt) {
87 		peer_mnt = next_peer(mnt);
88 		if (peer_mnt == mnt)
89 			peer_mnt = NULL;
90 	}
91 	if (mnt->mnt_group_id && IS_MNT_SHARED(mnt) &&
92 	    list_empty(&mnt->mnt_share))
93 		mnt_release_group_id(mnt);
94 
95 	list_del_init(&mnt->mnt_share);
96 	mnt->mnt_group_id = 0;
97 
98 	if (peer_mnt)
99 		master = peer_mnt;
100 
101 	if (master) {
102 		list_for_each_entry(slave_mnt, &mnt->mnt_slave_list, mnt_slave)
103 			slave_mnt->mnt_master = master;
104 		list_move(&mnt->mnt_slave, &master->mnt_slave_list);
105 		list_splice(&mnt->mnt_slave_list, master->mnt_slave_list.prev);
106 		INIT_LIST_HEAD(&mnt->mnt_slave_list);
107 	} else {
108 		struct list_head *p = &mnt->mnt_slave_list;
109 		while (!list_empty(p)) {
110                         slave_mnt = list_first_entry(p,
111 					struct mount, mnt_slave);
112 			list_del_init(&slave_mnt->mnt_slave);
113 			slave_mnt->mnt_master = NULL;
114 		}
115 	}
116 	mnt->mnt_master = master;
117 	CLEAR_MNT_SHARED(mnt);
118 	return 0;
119 }
120 
121 /*
122  * vfsmount lock must be held for write
123  */
change_mnt_propagation(struct mount * mnt,int type)124 void change_mnt_propagation(struct mount *mnt, int type)
125 {
126 	if (type == MS_SHARED) {
127 		set_mnt_shared(mnt);
128 		return;
129 	}
130 	do_make_slave(mnt);
131 	if (type != MS_SLAVE) {
132 		list_del_init(&mnt->mnt_slave);
133 		mnt->mnt_master = NULL;
134 		if (type == MS_UNBINDABLE)
135 			mnt->mnt.mnt_flags |= MNT_UNBINDABLE;
136 		else
137 			mnt->mnt.mnt_flags &= ~MNT_UNBINDABLE;
138 	}
139 }
140 
141 /*
142  * get the next mount in the propagation tree.
143  * @m: the mount seen last
144  * @origin: the original mount from where the tree walk initiated
145  *
146  * Note that peer groups form contiguous segments of slave lists.
147  * We rely on that in get_source() to be able to find out if
148  * vfsmount found while iterating with propagation_next() is
149  * a peer of one we'd found earlier.
150  */
propagation_next(struct mount * m,struct mount * origin)151 static struct mount *propagation_next(struct mount *m,
152 					 struct mount *origin)
153 {
154 	/* are there any slaves of this mount? */
155 	if (!IS_MNT_NEW(m) && !list_empty(&m->mnt_slave_list))
156 		return first_slave(m);
157 
158 	while (1) {
159 		struct mount *master = m->mnt_master;
160 
161 		if (master == origin->mnt_master) {
162 			struct mount *next = next_peer(m);
163 			return (next == origin) ? NULL : next;
164 		} else if (m->mnt_slave.next != &master->mnt_slave_list)
165 			return next_slave(m);
166 
167 		/* back at master */
168 		m = master;
169 	}
170 }
171 
skip_propagation_subtree(struct mount * m,struct mount * origin)172 static struct mount *skip_propagation_subtree(struct mount *m,
173 						struct mount *origin)
174 {
175 	/*
176 	 * Advance m such that propagation_next will not return
177 	 * the slaves of m.
178 	 */
179 	if (!IS_MNT_NEW(m) && !list_empty(&m->mnt_slave_list))
180 		m = last_slave(m);
181 
182 	return m;
183 }
184 
next_group(struct mount * m,struct mount * origin)185 static struct mount *next_group(struct mount *m, struct mount *origin)
186 {
187 	while (1) {
188 		while (1) {
189 			struct mount *next;
190 			if (!IS_MNT_NEW(m) && !list_empty(&m->mnt_slave_list))
191 				return first_slave(m);
192 			next = next_peer(m);
193 			if (m->mnt_group_id == origin->mnt_group_id) {
194 				if (next == origin)
195 					return NULL;
196 			} else if (m->mnt_slave.next != &next->mnt_slave)
197 				break;
198 			m = next;
199 		}
200 		/* m is the last peer */
201 		while (1) {
202 			struct mount *master = m->mnt_master;
203 			if (m->mnt_slave.next != &master->mnt_slave_list)
204 				return next_slave(m);
205 			m = next_peer(master);
206 			if (master->mnt_group_id == origin->mnt_group_id)
207 				break;
208 			if (master->mnt_slave.next == &m->mnt_slave)
209 				break;
210 			m = master;
211 		}
212 		if (m == origin)
213 			return NULL;
214 	}
215 }
216 
217 /* all accesses are serialized by namespace_sem */
218 static struct user_namespace *user_ns;
219 static struct mount *last_dest, *first_source, *last_source, *dest_master;
220 static struct mountpoint *mp;
221 static struct hlist_head *list;
222 
peers(struct mount * m1,struct mount * m2)223 static inline bool peers(struct mount *m1, struct mount *m2)
224 {
225 	return m1->mnt_group_id == m2->mnt_group_id && m1->mnt_group_id;
226 }
227 
propagate_one(struct mount * m)228 static int propagate_one(struct mount *m)
229 {
230 	struct mount *child;
231 	int type;
232 	/* skip ones added by this propagate_mnt() */
233 	if (IS_MNT_NEW(m))
234 		return 0;
235 	/* skip if mountpoint isn't covered by it */
236 	if (!is_subdir(mp->m_dentry, m->mnt.mnt_root))
237 		return 0;
238 	if (peers(m, last_dest)) {
239 		type = CL_MAKE_SHARED;
240 	} else {
241 		struct mount *n, *p;
242 		bool done;
243 		for (n = m; ; n = p) {
244 			p = n->mnt_master;
245 			if (p == dest_master || IS_MNT_MARKED(p))
246 				break;
247 		}
248 		do {
249 			struct mount *parent = last_source->mnt_parent;
250 			if (last_source == first_source)
251 				break;
252 			done = parent->mnt_master == p;
253 			if (done && peers(n, parent))
254 				break;
255 			last_source = last_source->mnt_master;
256 		} while (!done);
257 
258 		type = CL_SLAVE;
259 		/* beginning of peer group among the slaves? */
260 		if (IS_MNT_SHARED(m))
261 			type |= CL_MAKE_SHARED;
262 	}
263 
264 	/* Notice when we are propagating across user namespaces */
265 	if (m->mnt_ns->user_ns != user_ns)
266 		type |= CL_UNPRIVILEGED;
267 	child = copy_tree(last_source, last_source->mnt.mnt_root, type);
268 	if (IS_ERR(child))
269 		return PTR_ERR(child);
270 	child->mnt.mnt_flags &= ~MNT_LOCKED;
271 	read_seqlock_excl(&mount_lock);
272 	mnt_set_mountpoint(m, mp, child);
273 	if (m->mnt_master != dest_master)
274 		SET_MNT_MARK(m->mnt_master);
275 	read_sequnlock_excl(&mount_lock);
276 	last_dest = m;
277 	last_source = child;
278 	hlist_add_head(&child->mnt_hash, list);
279 	return count_mounts(m->mnt_ns, child);
280 }
281 
282 /*
283  * mount 'source_mnt' under the destination 'dest_mnt' at
284  * dentry 'dest_dentry'. And propagate that mount to
285  * all the peer and slave mounts of 'dest_mnt'.
286  * Link all the new mounts into a propagation tree headed at
287  * source_mnt. Also link all the new mounts using ->mnt_list
288  * headed at source_mnt's ->mnt_list
289  *
290  * @dest_mnt: destination mount.
291  * @dest_dentry: destination dentry.
292  * @source_mnt: source mount.
293  * @tree_list : list of heads of trees to be attached.
294  */
propagate_mnt(struct mount * dest_mnt,struct mountpoint * dest_mp,struct mount * source_mnt,struct hlist_head * tree_list)295 int propagate_mnt(struct mount *dest_mnt, struct mountpoint *dest_mp,
296 		    struct mount *source_mnt, struct hlist_head *tree_list)
297 {
298 	struct mount *m, *n;
299 	int ret = 0;
300 
301 	/*
302 	 * we don't want to bother passing tons of arguments to
303 	 * propagate_one(); everything is serialized by namespace_sem,
304 	 * so globals will do just fine.
305 	 */
306 	user_ns = current->nsproxy->mnt_ns->user_ns;
307 	last_dest = dest_mnt;
308 	first_source = source_mnt;
309 	last_source = source_mnt;
310 	mp = dest_mp;
311 	list = tree_list;
312 	dest_master = dest_mnt->mnt_master;
313 
314 	/* all peers of dest_mnt, except dest_mnt itself */
315 	for (n = next_peer(dest_mnt); n != dest_mnt; n = next_peer(n)) {
316 		ret = propagate_one(n);
317 		if (ret)
318 			goto out;
319 	}
320 
321 	/* all slave groups */
322 	for (m = next_group(dest_mnt, dest_mnt); m;
323 			m = next_group(m, dest_mnt)) {
324 		/* everything in that slave group */
325 		n = m;
326 		do {
327 			ret = propagate_one(n);
328 			if (ret)
329 				goto out;
330 			n = next_peer(n);
331 		} while (n != m);
332 	}
333 out:
334 	read_seqlock_excl(&mount_lock);
335 	hlist_for_each_entry(n, tree_list, mnt_hash) {
336 		m = n->mnt_parent;
337 		if (m->mnt_master != dest_mnt->mnt_master)
338 			CLEAR_MNT_MARK(m->mnt_master);
339 	}
340 	read_sequnlock_excl(&mount_lock);
341 	return ret;
342 }
343 
find_topper(struct mount * mnt)344 static struct mount *find_topper(struct mount *mnt)
345 {
346 	/* If there is exactly one mount covering mnt completely return it. */
347 	struct mount *child;
348 
349 	if (!list_is_singular(&mnt->mnt_mounts))
350 		return NULL;
351 
352 	child = list_first_entry(&mnt->mnt_mounts, struct mount, mnt_child);
353 	if (child->mnt_mountpoint != mnt->mnt.mnt_root)
354 		return NULL;
355 
356 	return child;
357 }
358 
359 /*
360  * return true if the refcount is greater than count
361  */
do_refcount_check(struct mount * mnt,int count)362 static inline int do_refcount_check(struct mount *mnt, int count)
363 {
364 	return mnt_get_count(mnt) > count;
365 }
366 
367 /*
368  * check if the mount 'mnt' can be unmounted successfully.
369  * @mnt: the mount to be checked for unmount
370  * NOTE: unmounting 'mnt' would naturally propagate to all
371  * other mounts its parent propagates to.
372  * Check if any of these mounts that **do not have submounts**
373  * have more references than 'refcnt'. If so return busy.
374  *
375  * vfsmount lock must be held for write
376  */
propagate_mount_busy(struct mount * mnt,int refcnt)377 int propagate_mount_busy(struct mount *mnt, int refcnt)
378 {
379 	struct mount *m, *child, *topper;
380 	struct mount *parent = mnt->mnt_parent;
381 
382 	if (mnt == parent)
383 		return do_refcount_check(mnt, refcnt);
384 
385 	/*
386 	 * quickly check if the current mount can be unmounted.
387 	 * If not, we don't have to go checking for all other
388 	 * mounts
389 	 */
390 	if (!list_empty(&mnt->mnt_mounts) || do_refcount_check(mnt, refcnt))
391 		return 1;
392 
393 	for (m = propagation_next(parent, parent); m;
394 	     		m = propagation_next(m, parent)) {
395 		int count = 1;
396 		child = __lookup_mnt(&m->mnt, mnt->mnt_mountpoint);
397 		if (!child)
398 			continue;
399 
400 		/* Is there exactly one mount on the child that covers
401 		 * it completely whose reference should be ignored?
402 		 */
403 		topper = find_topper(child);
404 		if (topper)
405 			count += 1;
406 		else if (!list_empty(&child->mnt_mounts))
407 			continue;
408 
409 		if (do_refcount_check(child, count))
410 			return 1;
411 	}
412 	return 0;
413 }
414 
415 /*
416  * Clear MNT_LOCKED when it can be shown to be safe.
417  *
418  * mount_lock lock must be held for write
419  */
propagate_mount_unlock(struct mount * mnt)420 void propagate_mount_unlock(struct mount *mnt)
421 {
422 	struct mount *parent = mnt->mnt_parent;
423 	struct mount *m, *child;
424 
425 	BUG_ON(parent == mnt);
426 
427 	for (m = propagation_next(parent, parent); m;
428 			m = propagation_next(m, parent)) {
429 		child = __lookup_mnt(&m->mnt, mnt->mnt_mountpoint);
430 		if (child)
431 			child->mnt.mnt_flags &= ~MNT_LOCKED;
432 	}
433 }
434 
umount_one(struct mount * mnt,struct list_head * to_umount)435 static void umount_one(struct mount *mnt, struct list_head *to_umount)
436 {
437 	CLEAR_MNT_MARK(mnt);
438 	mnt->mnt.mnt_flags |= MNT_UMOUNT;
439 	list_del_init(&mnt->mnt_child);
440 	list_del_init(&mnt->mnt_umounting);
441 	list_move_tail(&mnt->mnt_list, to_umount);
442 }
443 
444 /*
445  * NOTE: unmounting 'mnt' naturally propagates to all other mounts its
446  * parent propagates to.
447  */
__propagate_umount(struct mount * mnt,struct list_head * to_umount,struct list_head * to_restore)448 static bool __propagate_umount(struct mount *mnt,
449 			       struct list_head *to_umount,
450 			       struct list_head *to_restore)
451 {
452 	bool progress = false;
453 	struct mount *child;
454 
455 	/*
456 	 * The state of the parent won't change if this mount is
457 	 * already unmounted or marked as without children.
458 	 */
459 	if (mnt->mnt.mnt_flags & (MNT_UMOUNT | MNT_MARKED))
460 		goto out;
461 
462 	/* Verify topper is the only grandchild that has not been
463 	 * speculatively unmounted.
464 	 */
465 	list_for_each_entry(child, &mnt->mnt_mounts, mnt_child) {
466 		if (child->mnt_mountpoint == mnt->mnt.mnt_root)
467 			continue;
468 		if (!list_empty(&child->mnt_umounting) && IS_MNT_MARKED(child))
469 			continue;
470 		/* Found a mounted child */
471 		goto children;
472 	}
473 
474 	/* Mark mounts that can be unmounted if not locked */
475 	SET_MNT_MARK(mnt);
476 	progress = true;
477 
478 	/* If a mount is without children and not locked umount it. */
479 	if (!IS_MNT_LOCKED(mnt)) {
480 		umount_one(mnt, to_umount);
481 	} else {
482 children:
483 		list_move_tail(&mnt->mnt_umounting, to_restore);
484 	}
485 out:
486 	return progress;
487 }
488 
umount_list(struct list_head * to_umount,struct list_head * to_restore)489 static void umount_list(struct list_head *to_umount,
490 			struct list_head *to_restore)
491 {
492 	struct mount *mnt, *child, *tmp;
493 	list_for_each_entry(mnt, to_umount, mnt_list) {
494 		list_for_each_entry_safe(child, tmp, &mnt->mnt_mounts, mnt_child) {
495 			/* topper? */
496 			if (child->mnt_mountpoint == mnt->mnt.mnt_root)
497 				list_move_tail(&child->mnt_umounting, to_restore);
498 			else
499 				umount_one(child, to_umount);
500 		}
501 	}
502 }
503 
restore_mounts(struct list_head * to_restore)504 static void restore_mounts(struct list_head *to_restore)
505 {
506 	/* Restore mounts to a clean working state */
507 	while (!list_empty(to_restore)) {
508 		struct mount *mnt, *parent;
509 		struct mountpoint *mp;
510 
511 		mnt = list_first_entry(to_restore, struct mount, mnt_umounting);
512 		CLEAR_MNT_MARK(mnt);
513 		list_del_init(&mnt->mnt_umounting);
514 
515 		/* Should this mount be reparented? */
516 		mp = mnt->mnt_mp;
517 		parent = mnt->mnt_parent;
518 		while (parent->mnt.mnt_flags & MNT_UMOUNT) {
519 			mp = parent->mnt_mp;
520 			parent = parent->mnt_parent;
521 		}
522 		if (parent != mnt->mnt_parent)
523 			mnt_change_mountpoint(parent, mp, mnt);
524 	}
525 }
526 
cleanup_umount_visitations(struct list_head * visited)527 static void cleanup_umount_visitations(struct list_head *visited)
528 {
529 	while (!list_empty(visited)) {
530 		struct mount *mnt =
531 			list_first_entry(visited, struct mount, mnt_umounting);
532 		list_del_init(&mnt->mnt_umounting);
533 	}
534 }
535 
536 /*
537  * collect all mounts that receive propagation from the mount in @list,
538  * and return these additional mounts in the same list.
539  * @list: the list of mounts to be unmounted.
540  *
541  * vfsmount lock must be held for write
542  */
propagate_umount(struct list_head * list)543 int propagate_umount(struct list_head *list)
544 {
545 	struct mount *mnt;
546 	LIST_HEAD(to_restore);
547 	LIST_HEAD(to_umount);
548 	LIST_HEAD(visited);
549 
550 	/* Find candidates for unmounting */
551 	list_for_each_entry_reverse(mnt, list, mnt_list) {
552 		struct mount *parent = mnt->mnt_parent;
553 		struct mount *m;
554 
555 		/*
556 		 * If this mount has already been visited it is known that it's
557 		 * entire peer group and all of their slaves in the propagation
558 		 * tree for the mountpoint has already been visited and there is
559 		 * no need to visit them again.
560 		 */
561 		if (!list_empty(&mnt->mnt_umounting))
562 			continue;
563 
564 		list_add_tail(&mnt->mnt_umounting, &visited);
565 		for (m = propagation_next(parent, parent); m;
566 		     m = propagation_next(m, parent)) {
567 			struct mount *child = __lookup_mnt(&m->mnt,
568 							   mnt->mnt_mountpoint);
569 			if (!child)
570 				continue;
571 
572 			if (!list_empty(&child->mnt_umounting)) {
573 				/*
574 				 * If the child has already been visited it is
575 				 * know that it's entire peer group and all of
576 				 * their slaves in the propgation tree for the
577 				 * mountpoint has already been visited and there
578 				 * is no need to visit this subtree again.
579 				 */
580 				m = skip_propagation_subtree(m, parent);
581 				continue;
582 			} else if (child->mnt.mnt_flags & MNT_UMOUNT) {
583 				/*
584 				 * We have come accross an partially unmounted
585 				 * mount in list that has not been visited yet.
586 				 * Remember it has been visited and continue
587 				 * about our merry way.
588 				 */
589 				list_add_tail(&child->mnt_umounting, &visited);
590 				continue;
591 			}
592 
593 			/* Check the child and parents while progress is made */
594 			while (__propagate_umount(child,
595 						  &to_umount, &to_restore)) {
596 				/* Is the parent a umount candidate? */
597 				child = child->mnt_parent;
598 				if (list_empty(&child->mnt_umounting))
599 					break;
600 			}
601 		}
602 	}
603 
604 	umount_list(&to_umount, &to_restore);
605 	restore_mounts(&to_restore);
606 	cleanup_umount_visitations(&visited);
607 	list_splice_tail(&to_umount, list);
608 
609 	return 0;
610 }
611 
propagate_remount(struct mount * mnt)612 void propagate_remount(struct mount *mnt)
613 {
614 	struct mount *parent = mnt->mnt_parent;
615 	struct mount *p = mnt, *m;
616 	struct super_block *sb = mnt->mnt.mnt_sb;
617 
618 	if (!sb->s_op->copy_mnt_data)
619 		return;
620 	for (p = propagation_next(parent, parent); p;
621 				p = propagation_next(p, parent)) {
622 		m = __lookup_mnt(&p->mnt, mnt->mnt_mountpoint);
623 		if (m)
624 			sb->s_op->copy_mnt_data(m->mnt.data, mnt->mnt.data);
625 	}
626 }
627