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