xref: /openbmc/linux/fs/overlayfs/super.c (revision 22b6e7f3)
1 // SPDX-License-Identifier: GPL-2.0-only
2 /*
3  *
4  * Copyright (C) 2011 Novell Inc.
5  */
6 
7 #include <uapi/linux/magic.h>
8 #include <linux/fs.h>
9 #include <linux/namei.h>
10 #include <linux/xattr.h>
11 #include <linux/mount.h>
12 #include <linux/parser.h>
13 #include <linux/module.h>
14 #include <linux/statfs.h>
15 #include <linux/seq_file.h>
16 #include <linux/posix_acl_xattr.h>
17 #include <linux/exportfs.h>
18 #include <linux/file.h>
19 #include <linux/fs_context.h>
20 #include <linux/fs_parser.h>
21 #include "overlayfs.h"
22 #include "params.h"
23 
24 MODULE_AUTHOR("Miklos Szeredi <miklos@szeredi.hu>");
25 MODULE_DESCRIPTION("Overlay filesystem");
26 MODULE_LICENSE("GPL");
27 
28 
29 struct ovl_dir_cache;
30 
31 static struct dentry *ovl_d_real(struct dentry *dentry,
32 				 const struct inode *inode)
33 {
34 	struct dentry *real = NULL, *lower;
35 	int err;
36 
37 	/* It's an overlay file */
38 	if (inode && d_inode(dentry) == inode)
39 		return dentry;
40 
41 	if (!d_is_reg(dentry)) {
42 		if (!inode || inode == d_inode(dentry))
43 			return dentry;
44 		goto bug;
45 	}
46 
47 	real = ovl_dentry_upper(dentry);
48 	if (real && (inode == d_inode(real)))
49 		return real;
50 
51 	if (real && !inode && ovl_has_upperdata(d_inode(dentry)))
52 		return real;
53 
54 	/*
55 	 * Best effort lazy lookup of lowerdata for !inode case to return
56 	 * the real lowerdata dentry.  The only current caller of d_real() with
57 	 * NULL inode is d_real_inode() from trace_uprobe and this caller is
58 	 * likely going to be followed reading from the file, before placing
59 	 * uprobes on offset within the file, so lowerdata should be available
60 	 * when setting the uprobe.
61 	 */
62 	err = ovl_verify_lowerdata(dentry);
63 	if (err)
64 		goto bug;
65 	lower = ovl_dentry_lowerdata(dentry);
66 	if (!lower)
67 		goto bug;
68 	real = lower;
69 
70 	/* Handle recursion */
71 	real = d_real(real, inode);
72 
73 	if (!inode || inode == d_inode(real))
74 		return real;
75 bug:
76 	WARN(1, "%s(%pd4, %s:%lu): real dentry (%p/%lu) not found\n",
77 	     __func__, dentry, inode ? inode->i_sb->s_id : "NULL",
78 	     inode ? inode->i_ino : 0, real,
79 	     real && d_inode(real) ? d_inode(real)->i_ino : 0);
80 	return dentry;
81 }
82 
83 static int ovl_revalidate_real(struct dentry *d, unsigned int flags, bool weak)
84 {
85 	int ret = 1;
86 
87 	if (!d)
88 		return 1;
89 
90 	if (weak) {
91 		if (d->d_flags & DCACHE_OP_WEAK_REVALIDATE)
92 			ret =  d->d_op->d_weak_revalidate(d, flags);
93 	} else if (d->d_flags & DCACHE_OP_REVALIDATE) {
94 		ret = d->d_op->d_revalidate(d, flags);
95 		if (!ret) {
96 			if (!(flags & LOOKUP_RCU))
97 				d_invalidate(d);
98 			ret = -ESTALE;
99 		}
100 	}
101 	return ret;
102 }
103 
104 static int ovl_dentry_revalidate_common(struct dentry *dentry,
105 					unsigned int flags, bool weak)
106 {
107 	struct ovl_entry *oe = OVL_E(dentry);
108 	struct ovl_path *lowerstack = ovl_lowerstack(oe);
109 	struct inode *inode = d_inode_rcu(dentry);
110 	struct dentry *upper;
111 	unsigned int i;
112 	int ret = 1;
113 
114 	/* Careful in RCU mode */
115 	if (!inode)
116 		return -ECHILD;
117 
118 	upper = ovl_i_dentry_upper(inode);
119 	if (upper)
120 		ret = ovl_revalidate_real(upper, flags, weak);
121 
122 	for (i = 0; ret > 0 && i < ovl_numlower(oe); i++)
123 		ret = ovl_revalidate_real(lowerstack[i].dentry, flags, weak);
124 
125 	return ret;
126 }
127 
128 static int ovl_dentry_revalidate(struct dentry *dentry, unsigned int flags)
129 {
130 	return ovl_dentry_revalidate_common(dentry, flags, false);
131 }
132 
133 static int ovl_dentry_weak_revalidate(struct dentry *dentry, unsigned int flags)
134 {
135 	return ovl_dentry_revalidate_common(dentry, flags, true);
136 }
137 
138 static const struct dentry_operations ovl_dentry_operations = {
139 	.d_real = ovl_d_real,
140 	.d_revalidate = ovl_dentry_revalidate,
141 	.d_weak_revalidate = ovl_dentry_weak_revalidate,
142 };
143 
144 static struct kmem_cache *ovl_inode_cachep;
145 
146 static struct inode *ovl_alloc_inode(struct super_block *sb)
147 {
148 	struct ovl_inode *oi = alloc_inode_sb(sb, ovl_inode_cachep, GFP_KERNEL);
149 
150 	if (!oi)
151 		return NULL;
152 
153 	oi->cache = NULL;
154 	oi->redirect = NULL;
155 	oi->version = 0;
156 	oi->flags = 0;
157 	oi->__upperdentry = NULL;
158 	oi->lowerdata_redirect = NULL;
159 	oi->oe = NULL;
160 	mutex_init(&oi->lock);
161 
162 	return &oi->vfs_inode;
163 }
164 
165 static void ovl_free_inode(struct inode *inode)
166 {
167 	struct ovl_inode *oi = OVL_I(inode);
168 
169 	kfree(oi->redirect);
170 	mutex_destroy(&oi->lock);
171 	kmem_cache_free(ovl_inode_cachep, oi);
172 }
173 
174 static void ovl_destroy_inode(struct inode *inode)
175 {
176 	struct ovl_inode *oi = OVL_I(inode);
177 
178 	dput(oi->__upperdentry);
179 	ovl_free_entry(oi->oe);
180 	if (S_ISDIR(inode->i_mode))
181 		ovl_dir_cache_free(inode);
182 	else
183 		kfree(oi->lowerdata_redirect);
184 }
185 
186 static void ovl_put_super(struct super_block *sb)
187 {
188 	struct ovl_fs *ofs = OVL_FS(sb);
189 
190 	if (ofs)
191 		ovl_free_fs(ofs);
192 }
193 
194 /* Sync real dirty inodes in upper filesystem (if it exists) */
195 static int ovl_sync_fs(struct super_block *sb, int wait)
196 {
197 	struct ovl_fs *ofs = OVL_FS(sb);
198 	struct super_block *upper_sb;
199 	int ret;
200 
201 	ret = ovl_sync_status(ofs);
202 	/*
203 	 * We have to always set the err, because the return value isn't
204 	 * checked in syncfs, and instead indirectly return an error via
205 	 * the sb's writeback errseq, which VFS inspects after this call.
206 	 */
207 	if (ret < 0) {
208 		errseq_set(&sb->s_wb_err, -EIO);
209 		return -EIO;
210 	}
211 
212 	if (!ret)
213 		return ret;
214 
215 	/*
216 	 * Not called for sync(2) call or an emergency sync (SB_I_SKIP_SYNC).
217 	 * All the super blocks will be iterated, including upper_sb.
218 	 *
219 	 * If this is a syncfs(2) call, then we do need to call
220 	 * sync_filesystem() on upper_sb, but enough if we do it when being
221 	 * called with wait == 1.
222 	 */
223 	if (!wait)
224 		return 0;
225 
226 	upper_sb = ovl_upper_mnt(ofs)->mnt_sb;
227 
228 	down_read(&upper_sb->s_umount);
229 	ret = sync_filesystem(upper_sb);
230 	up_read(&upper_sb->s_umount);
231 
232 	return ret;
233 }
234 
235 /**
236  * ovl_statfs
237  * @dentry: The dentry to query
238  * @buf: The struct kstatfs to fill in with stats
239  *
240  * Get the filesystem statistics.  As writes always target the upper layer
241  * filesystem pass the statfs to the upper filesystem (if it exists)
242  */
243 static int ovl_statfs(struct dentry *dentry, struct kstatfs *buf)
244 {
245 	struct super_block *sb = dentry->d_sb;
246 	struct ovl_fs *ofs = OVL_FS(sb);
247 	struct dentry *root_dentry = sb->s_root;
248 	struct path path;
249 	int err;
250 
251 	ovl_path_real(root_dentry, &path);
252 
253 	err = vfs_statfs(&path, buf);
254 	if (!err) {
255 		buf->f_namelen = ofs->namelen;
256 		buf->f_type = OVERLAYFS_SUPER_MAGIC;
257 		if (ovl_has_fsid(ofs))
258 			buf->f_fsid = uuid_to_fsid(sb->s_uuid.b);
259 	}
260 
261 	return err;
262 }
263 
264 static const struct super_operations ovl_super_operations = {
265 	.alloc_inode	= ovl_alloc_inode,
266 	.free_inode	= ovl_free_inode,
267 	.destroy_inode	= ovl_destroy_inode,
268 	.drop_inode	= generic_delete_inode,
269 	.put_super	= ovl_put_super,
270 	.sync_fs	= ovl_sync_fs,
271 	.statfs		= ovl_statfs,
272 	.show_options	= ovl_show_options,
273 };
274 
275 #define OVL_WORKDIR_NAME "work"
276 #define OVL_INDEXDIR_NAME "index"
277 
278 static struct dentry *ovl_workdir_create(struct ovl_fs *ofs,
279 					 const char *name, bool persist)
280 {
281 	struct inode *dir =  ofs->workbasedir->d_inode;
282 	struct vfsmount *mnt = ovl_upper_mnt(ofs);
283 	struct dentry *work;
284 	int err;
285 	bool retried = false;
286 
287 	inode_lock_nested(dir, I_MUTEX_PARENT);
288 retry:
289 	work = ovl_lookup_upper(ofs, name, ofs->workbasedir, strlen(name));
290 
291 	if (!IS_ERR(work)) {
292 		struct iattr attr = {
293 			.ia_valid = ATTR_MODE,
294 			.ia_mode = S_IFDIR | 0,
295 		};
296 
297 		if (work->d_inode) {
298 			err = -EEXIST;
299 			if (retried)
300 				goto out_dput;
301 
302 			if (persist)
303 				goto out_unlock;
304 
305 			retried = true;
306 			err = ovl_workdir_cleanup(ofs, dir, mnt, work, 0);
307 			dput(work);
308 			if (err == -EINVAL) {
309 				work = ERR_PTR(err);
310 				goto out_unlock;
311 			}
312 			goto retry;
313 		}
314 
315 		err = ovl_mkdir_real(ofs, dir, &work, attr.ia_mode);
316 		if (err)
317 			goto out_dput;
318 
319 		/* Weird filesystem returning with hashed negative (kernfs)? */
320 		err = -EINVAL;
321 		if (d_really_is_negative(work))
322 			goto out_dput;
323 
324 		/*
325 		 * Try to remove POSIX ACL xattrs from workdir.  We are good if:
326 		 *
327 		 * a) success (there was a POSIX ACL xattr and was removed)
328 		 * b) -ENODATA (there was no POSIX ACL xattr)
329 		 * c) -EOPNOTSUPP (POSIX ACL xattrs are not supported)
330 		 *
331 		 * There are various other error values that could effectively
332 		 * mean that the xattr doesn't exist (e.g. -ERANGE is returned
333 		 * if the xattr name is too long), but the set of filesystems
334 		 * allowed as upper are limited to "normal" ones, where checking
335 		 * for the above two errors is sufficient.
336 		 */
337 		err = ovl_do_remove_acl(ofs, work, XATTR_NAME_POSIX_ACL_DEFAULT);
338 		if (err && err != -ENODATA && err != -EOPNOTSUPP)
339 			goto out_dput;
340 
341 		err = ovl_do_remove_acl(ofs, work, XATTR_NAME_POSIX_ACL_ACCESS);
342 		if (err && err != -ENODATA && err != -EOPNOTSUPP)
343 			goto out_dput;
344 
345 		/* Clear any inherited mode bits */
346 		inode_lock(work->d_inode);
347 		err = ovl_do_notify_change(ofs, work, &attr);
348 		inode_unlock(work->d_inode);
349 		if (err)
350 			goto out_dput;
351 	} else {
352 		err = PTR_ERR(work);
353 		goto out_err;
354 	}
355 out_unlock:
356 	inode_unlock(dir);
357 	return work;
358 
359 out_dput:
360 	dput(work);
361 out_err:
362 	pr_warn("failed to create directory %s/%s (errno: %i); mounting read-only\n",
363 		ofs->config.workdir, name, -err);
364 	work = NULL;
365 	goto out_unlock;
366 }
367 
368 static int ovl_check_namelen(const struct path *path, struct ovl_fs *ofs,
369 			     const char *name)
370 {
371 	struct kstatfs statfs;
372 	int err = vfs_statfs(path, &statfs);
373 
374 	if (err)
375 		pr_err("statfs failed on '%s'\n", name);
376 	else
377 		ofs->namelen = max(ofs->namelen, statfs.f_namelen);
378 
379 	return err;
380 }
381 
382 static int ovl_lower_dir(const char *name, struct path *path,
383 			 struct ovl_fs *ofs, int *stack_depth)
384 {
385 	int fh_type;
386 	int err;
387 
388 	err = ovl_check_namelen(path, ofs, name);
389 	if (err)
390 		return err;
391 
392 	*stack_depth = max(*stack_depth, path->mnt->mnt_sb->s_stack_depth);
393 
394 	/*
395 	 * The inodes index feature and NFS export need to encode and decode
396 	 * file handles, so they require that all layers support them.
397 	 */
398 	fh_type = ovl_can_decode_fh(path->dentry->d_sb);
399 	if ((ofs->config.nfs_export ||
400 	     (ofs->config.index && ofs->config.upperdir)) && !fh_type) {
401 		ofs->config.index = false;
402 		ofs->config.nfs_export = false;
403 		pr_warn("fs on '%s' does not support file handles, falling back to index=off,nfs_export=off.\n",
404 			name);
405 	}
406 	ofs->nofh |= !fh_type;
407 	/*
408 	 * Decoding origin file handle is required for persistent st_ino.
409 	 * Without persistent st_ino, xino=auto falls back to xino=off.
410 	 */
411 	if (ofs->config.xino == OVL_XINO_AUTO &&
412 	    ofs->config.upperdir && !fh_type) {
413 		ofs->config.xino = OVL_XINO_OFF;
414 		pr_warn("fs on '%s' does not support file handles, falling back to xino=off.\n",
415 			name);
416 	}
417 
418 	/* Check if lower fs has 32bit inode numbers */
419 	if (fh_type != FILEID_INO32_GEN)
420 		ofs->xino_mode = -1;
421 
422 	return 0;
423 }
424 
425 /* Workdir should not be subdir of upperdir and vice versa */
426 static bool ovl_workdir_ok(struct dentry *workdir, struct dentry *upperdir)
427 {
428 	bool ok = false;
429 
430 	if (workdir != upperdir) {
431 		ok = (lock_rename(workdir, upperdir) == NULL);
432 		unlock_rename(workdir, upperdir);
433 	}
434 	return ok;
435 }
436 
437 static int ovl_own_xattr_get(const struct xattr_handler *handler,
438 			     struct dentry *dentry, struct inode *inode,
439 			     const char *name, void *buffer, size_t size)
440 {
441 	return -EOPNOTSUPP;
442 }
443 
444 static int ovl_own_xattr_set(const struct xattr_handler *handler,
445 			     struct mnt_idmap *idmap,
446 			     struct dentry *dentry, struct inode *inode,
447 			     const char *name, const void *value,
448 			     size_t size, int flags)
449 {
450 	return -EOPNOTSUPP;
451 }
452 
453 static int ovl_other_xattr_get(const struct xattr_handler *handler,
454 			       struct dentry *dentry, struct inode *inode,
455 			       const char *name, void *buffer, size_t size)
456 {
457 	return ovl_xattr_get(dentry, inode, name, buffer, size);
458 }
459 
460 static int ovl_other_xattr_set(const struct xattr_handler *handler,
461 			       struct mnt_idmap *idmap,
462 			       struct dentry *dentry, struct inode *inode,
463 			       const char *name, const void *value,
464 			       size_t size, int flags)
465 {
466 	return ovl_xattr_set(dentry, inode, name, value, size, flags);
467 }
468 
469 static const struct xattr_handler ovl_own_trusted_xattr_handler = {
470 	.prefix	= OVL_XATTR_TRUSTED_PREFIX,
471 	.get = ovl_own_xattr_get,
472 	.set = ovl_own_xattr_set,
473 };
474 
475 static const struct xattr_handler ovl_own_user_xattr_handler = {
476 	.prefix	= OVL_XATTR_USER_PREFIX,
477 	.get = ovl_own_xattr_get,
478 	.set = ovl_own_xattr_set,
479 };
480 
481 static const struct xattr_handler ovl_other_xattr_handler = {
482 	.prefix	= "", /* catch all */
483 	.get = ovl_other_xattr_get,
484 	.set = ovl_other_xattr_set,
485 };
486 
487 static const struct xattr_handler *ovl_trusted_xattr_handlers[] = {
488 	&ovl_own_trusted_xattr_handler,
489 	&ovl_other_xattr_handler,
490 	NULL
491 };
492 
493 static const struct xattr_handler *ovl_user_xattr_handlers[] = {
494 	&ovl_own_user_xattr_handler,
495 	&ovl_other_xattr_handler,
496 	NULL
497 };
498 
499 static int ovl_setup_trap(struct super_block *sb, struct dentry *dir,
500 			  struct inode **ptrap, const char *name)
501 {
502 	struct inode *trap;
503 	int err;
504 
505 	trap = ovl_get_trap_inode(sb, dir);
506 	err = PTR_ERR_OR_ZERO(trap);
507 	if (err) {
508 		if (err == -ELOOP)
509 			pr_err("conflicting %s path\n", name);
510 		return err;
511 	}
512 
513 	*ptrap = trap;
514 	return 0;
515 }
516 
517 /*
518  * Determine how we treat concurrent use of upperdir/workdir based on the
519  * index feature. This is papering over mount leaks of container runtimes,
520  * for example, an old overlay mount is leaked and now its upperdir is
521  * attempted to be used as a lower layer in a new overlay mount.
522  */
523 static int ovl_report_in_use(struct ovl_fs *ofs, const char *name)
524 {
525 	if (ofs->config.index) {
526 		pr_err("%s is in-use as upperdir/workdir of another mount, mount with '-o index=off' to override exclusive upperdir protection.\n",
527 		       name);
528 		return -EBUSY;
529 	} else {
530 		pr_warn("%s is in-use as upperdir/workdir of another mount, accessing files from both mounts will result in undefined behavior.\n",
531 			name);
532 		return 0;
533 	}
534 }
535 
536 static int ovl_get_upper(struct super_block *sb, struct ovl_fs *ofs,
537 			 struct ovl_layer *upper_layer,
538 			 const struct path *upperpath)
539 {
540 	struct vfsmount *upper_mnt;
541 	int err;
542 
543 	/* Upperdir path should not be r/o */
544 	if (__mnt_is_readonly(upperpath->mnt)) {
545 		pr_err("upper fs is r/o, try multi-lower layers mount\n");
546 		err = -EINVAL;
547 		goto out;
548 	}
549 
550 	err = ovl_check_namelen(upperpath, ofs, ofs->config.upperdir);
551 	if (err)
552 		goto out;
553 
554 	err = ovl_setup_trap(sb, upperpath->dentry, &upper_layer->trap,
555 			     "upperdir");
556 	if (err)
557 		goto out;
558 
559 	upper_mnt = clone_private_mount(upperpath);
560 	err = PTR_ERR(upper_mnt);
561 	if (IS_ERR(upper_mnt)) {
562 		pr_err("failed to clone upperpath\n");
563 		goto out;
564 	}
565 
566 	/* Don't inherit atime flags */
567 	upper_mnt->mnt_flags &= ~(MNT_NOATIME | MNT_NODIRATIME | MNT_RELATIME);
568 	upper_layer->mnt = upper_mnt;
569 	upper_layer->idx = 0;
570 	upper_layer->fsid = 0;
571 
572 	err = -ENOMEM;
573 	upper_layer->name = kstrdup(ofs->config.upperdir, GFP_KERNEL);
574 	if (!upper_layer->name)
575 		goto out;
576 
577 	/*
578 	 * Inherit SB_NOSEC flag from upperdir.
579 	 *
580 	 * This optimization changes behavior when a security related attribute
581 	 * (suid/sgid/security.*) is changed on an underlying layer.  This is
582 	 * okay because we don't yet have guarantees in that case, but it will
583 	 * need careful treatment once we want to honour changes to underlying
584 	 * filesystems.
585 	 */
586 	if (upper_mnt->mnt_sb->s_flags & SB_NOSEC)
587 		sb->s_flags |= SB_NOSEC;
588 
589 	if (ovl_inuse_trylock(ovl_upper_mnt(ofs)->mnt_root)) {
590 		ofs->upperdir_locked = true;
591 	} else {
592 		err = ovl_report_in_use(ofs, "upperdir");
593 		if (err)
594 			goto out;
595 	}
596 
597 	err = 0;
598 out:
599 	return err;
600 }
601 
602 /*
603  * Returns 1 if RENAME_WHITEOUT is supported, 0 if not supported and
604  * negative values if error is encountered.
605  */
606 static int ovl_check_rename_whiteout(struct ovl_fs *ofs)
607 {
608 	struct dentry *workdir = ofs->workdir;
609 	struct inode *dir = d_inode(workdir);
610 	struct dentry *temp;
611 	struct dentry *dest;
612 	struct dentry *whiteout;
613 	struct name_snapshot name;
614 	int err;
615 
616 	inode_lock_nested(dir, I_MUTEX_PARENT);
617 
618 	temp = ovl_create_temp(ofs, workdir, OVL_CATTR(S_IFREG | 0));
619 	err = PTR_ERR(temp);
620 	if (IS_ERR(temp))
621 		goto out_unlock;
622 
623 	dest = ovl_lookup_temp(ofs, workdir);
624 	err = PTR_ERR(dest);
625 	if (IS_ERR(dest)) {
626 		dput(temp);
627 		goto out_unlock;
628 	}
629 
630 	/* Name is inline and stable - using snapshot as a copy helper */
631 	take_dentry_name_snapshot(&name, temp);
632 	err = ovl_do_rename(ofs, dir, temp, dir, dest, RENAME_WHITEOUT);
633 	if (err) {
634 		if (err == -EINVAL)
635 			err = 0;
636 		goto cleanup_temp;
637 	}
638 
639 	whiteout = ovl_lookup_upper(ofs, name.name.name, workdir, name.name.len);
640 	err = PTR_ERR(whiteout);
641 	if (IS_ERR(whiteout))
642 		goto cleanup_temp;
643 
644 	err = ovl_is_whiteout(whiteout);
645 
646 	/* Best effort cleanup of whiteout and temp file */
647 	if (err)
648 		ovl_cleanup(ofs, dir, whiteout);
649 	dput(whiteout);
650 
651 cleanup_temp:
652 	ovl_cleanup(ofs, dir, temp);
653 	release_dentry_name_snapshot(&name);
654 	dput(temp);
655 	dput(dest);
656 
657 out_unlock:
658 	inode_unlock(dir);
659 
660 	return err;
661 }
662 
663 static struct dentry *ovl_lookup_or_create(struct ovl_fs *ofs,
664 					   struct dentry *parent,
665 					   const char *name, umode_t mode)
666 {
667 	size_t len = strlen(name);
668 	struct dentry *child;
669 
670 	inode_lock_nested(parent->d_inode, I_MUTEX_PARENT);
671 	child = ovl_lookup_upper(ofs, name, parent, len);
672 	if (!IS_ERR(child) && !child->d_inode)
673 		child = ovl_create_real(ofs, parent->d_inode, child,
674 					OVL_CATTR(mode));
675 	inode_unlock(parent->d_inode);
676 	dput(parent);
677 
678 	return child;
679 }
680 
681 /*
682  * Creates $workdir/work/incompat/volatile/dirty file if it is not already
683  * present.
684  */
685 static int ovl_create_volatile_dirty(struct ovl_fs *ofs)
686 {
687 	unsigned int ctr;
688 	struct dentry *d = dget(ofs->workbasedir);
689 	static const char *const volatile_path[] = {
690 		OVL_WORKDIR_NAME, "incompat", "volatile", "dirty"
691 	};
692 	const char *const *name = volatile_path;
693 
694 	for (ctr = ARRAY_SIZE(volatile_path); ctr; ctr--, name++) {
695 		d = ovl_lookup_or_create(ofs, d, *name, ctr > 1 ? S_IFDIR : S_IFREG);
696 		if (IS_ERR(d))
697 			return PTR_ERR(d);
698 	}
699 	dput(d);
700 	return 0;
701 }
702 
703 static int ovl_make_workdir(struct super_block *sb, struct ovl_fs *ofs,
704 			    const struct path *workpath)
705 {
706 	struct vfsmount *mnt = ovl_upper_mnt(ofs);
707 	struct dentry *workdir;
708 	struct file *tmpfile;
709 	bool rename_whiteout;
710 	bool d_type;
711 	int fh_type;
712 	int err;
713 
714 	err = mnt_want_write(mnt);
715 	if (err)
716 		return err;
717 
718 	workdir = ovl_workdir_create(ofs, OVL_WORKDIR_NAME, false);
719 	err = PTR_ERR(workdir);
720 	if (IS_ERR_OR_NULL(workdir))
721 		goto out;
722 
723 	ofs->workdir = workdir;
724 
725 	err = ovl_setup_trap(sb, ofs->workdir, &ofs->workdir_trap, "workdir");
726 	if (err)
727 		goto out;
728 
729 	/*
730 	 * Upper should support d_type, else whiteouts are visible.  Given
731 	 * workdir and upper are on same fs, we can do iterate_dir() on
732 	 * workdir. This check requires successful creation of workdir in
733 	 * previous step.
734 	 */
735 	err = ovl_check_d_type_supported(workpath);
736 	if (err < 0)
737 		goto out;
738 
739 	d_type = err;
740 	if (!d_type)
741 		pr_warn("upper fs needs to support d_type.\n");
742 
743 	/* Check if upper/work fs supports O_TMPFILE */
744 	tmpfile = ovl_do_tmpfile(ofs, ofs->workdir, S_IFREG | 0);
745 	ofs->tmpfile = !IS_ERR(tmpfile);
746 	if (ofs->tmpfile)
747 		fput(tmpfile);
748 	else
749 		pr_warn("upper fs does not support tmpfile.\n");
750 
751 
752 	/* Check if upper/work fs supports RENAME_WHITEOUT */
753 	err = ovl_check_rename_whiteout(ofs);
754 	if (err < 0)
755 		goto out;
756 
757 	rename_whiteout = err;
758 	if (!rename_whiteout)
759 		pr_warn("upper fs does not support RENAME_WHITEOUT.\n");
760 
761 	/*
762 	 * Check if upper/work fs supports (trusted|user).overlay.* xattr
763 	 */
764 	err = ovl_setxattr(ofs, ofs->workdir, OVL_XATTR_OPAQUE, "0", 1);
765 	if (err) {
766 		pr_warn("failed to set xattr on upper\n");
767 		ofs->noxattr = true;
768 		if (ovl_redirect_follow(ofs)) {
769 			ofs->config.redirect_mode = OVL_REDIRECT_NOFOLLOW;
770 			pr_warn("...falling back to redirect_dir=nofollow.\n");
771 		}
772 		if (ofs->config.metacopy) {
773 			ofs->config.metacopy = false;
774 			pr_warn("...falling back to metacopy=off.\n");
775 		}
776 		if (ofs->config.index) {
777 			ofs->config.index = false;
778 			pr_warn("...falling back to index=off.\n");
779 		}
780 		if (ovl_has_fsid(ofs)) {
781 			ofs->config.uuid = OVL_UUID_NULL;
782 			pr_warn("...falling back to uuid=null.\n");
783 		}
784 		/*
785 		 * xattr support is required for persistent st_ino.
786 		 * Without persistent st_ino, xino=auto falls back to xino=off.
787 		 */
788 		if (ofs->config.xino == OVL_XINO_AUTO) {
789 			ofs->config.xino = OVL_XINO_OFF;
790 			pr_warn("...falling back to xino=off.\n");
791 		}
792 		if (err == -EPERM && !ofs->config.userxattr)
793 			pr_info("try mounting with 'userxattr' option\n");
794 		err = 0;
795 	} else {
796 		ovl_removexattr(ofs, ofs->workdir, OVL_XATTR_OPAQUE);
797 	}
798 
799 	/*
800 	 * We allowed sub-optimal upper fs configuration and don't want to break
801 	 * users over kernel upgrade, but we never allowed remote upper fs, so
802 	 * we can enforce strict requirements for remote upper fs.
803 	 */
804 	if (ovl_dentry_remote(ofs->workdir) &&
805 	    (!d_type || !rename_whiteout || ofs->noxattr)) {
806 		pr_err("upper fs missing required features.\n");
807 		err = -EINVAL;
808 		goto out;
809 	}
810 
811 	/*
812 	 * For volatile mount, create a incompat/volatile/dirty file to keep
813 	 * track of it.
814 	 */
815 	if (ofs->config.ovl_volatile) {
816 		err = ovl_create_volatile_dirty(ofs);
817 		if (err < 0) {
818 			pr_err("Failed to create volatile/dirty file.\n");
819 			goto out;
820 		}
821 	}
822 
823 	/* Check if upper/work fs supports file handles */
824 	fh_type = ovl_can_decode_fh(ofs->workdir->d_sb);
825 	if (ofs->config.index && !fh_type) {
826 		ofs->config.index = false;
827 		pr_warn("upper fs does not support file handles, falling back to index=off.\n");
828 	}
829 	ofs->nofh |= !fh_type;
830 
831 	/* Check if upper fs has 32bit inode numbers */
832 	if (fh_type != FILEID_INO32_GEN)
833 		ofs->xino_mode = -1;
834 
835 	/* NFS export of r/w mount depends on index */
836 	if (ofs->config.nfs_export && !ofs->config.index) {
837 		pr_warn("NFS export requires \"index=on\", falling back to nfs_export=off.\n");
838 		ofs->config.nfs_export = false;
839 	}
840 out:
841 	mnt_drop_write(mnt);
842 	return err;
843 }
844 
845 static int ovl_get_workdir(struct super_block *sb, struct ovl_fs *ofs,
846 			   const struct path *upperpath,
847 			   const struct path *workpath)
848 {
849 	int err;
850 
851 	err = -EINVAL;
852 	if (upperpath->mnt != workpath->mnt) {
853 		pr_err("workdir and upperdir must reside under the same mount\n");
854 		return err;
855 	}
856 	if (!ovl_workdir_ok(workpath->dentry, upperpath->dentry)) {
857 		pr_err("workdir and upperdir must be separate subtrees\n");
858 		return err;
859 	}
860 
861 	ofs->workbasedir = dget(workpath->dentry);
862 
863 	if (ovl_inuse_trylock(ofs->workbasedir)) {
864 		ofs->workdir_locked = true;
865 	} else {
866 		err = ovl_report_in_use(ofs, "workdir");
867 		if (err)
868 			return err;
869 	}
870 
871 	err = ovl_setup_trap(sb, ofs->workbasedir, &ofs->workbasedir_trap,
872 			     "workdir");
873 	if (err)
874 		return err;
875 
876 	return ovl_make_workdir(sb, ofs, workpath);
877 }
878 
879 static int ovl_get_indexdir(struct super_block *sb, struct ovl_fs *ofs,
880 			    struct ovl_entry *oe, const struct path *upperpath)
881 {
882 	struct vfsmount *mnt = ovl_upper_mnt(ofs);
883 	struct dentry *indexdir;
884 	int err;
885 
886 	err = mnt_want_write(mnt);
887 	if (err)
888 		return err;
889 
890 	/* Verify lower root is upper root origin */
891 	err = ovl_verify_origin(ofs, upperpath->dentry,
892 				ovl_lowerstack(oe)->dentry, true);
893 	if (err) {
894 		pr_err("failed to verify upper root origin\n");
895 		goto out;
896 	}
897 
898 	/* index dir will act also as workdir */
899 	iput(ofs->workdir_trap);
900 	ofs->workdir_trap = NULL;
901 	dput(ofs->workdir);
902 	ofs->workdir = NULL;
903 	indexdir = ovl_workdir_create(ofs, OVL_INDEXDIR_NAME, true);
904 	if (IS_ERR(indexdir)) {
905 		err = PTR_ERR(indexdir);
906 	} else if (indexdir) {
907 		ofs->indexdir = indexdir;
908 		ofs->workdir = dget(indexdir);
909 
910 		err = ovl_setup_trap(sb, ofs->indexdir, &ofs->indexdir_trap,
911 				     "indexdir");
912 		if (err)
913 			goto out;
914 
915 		/*
916 		 * Verify upper root is exclusively associated with index dir.
917 		 * Older kernels stored upper fh in ".overlay.origin"
918 		 * xattr. If that xattr exists, verify that it is a match to
919 		 * upper dir file handle. In any case, verify or set xattr
920 		 * ".overlay.upper" to indicate that index may have
921 		 * directory entries.
922 		 */
923 		if (ovl_check_origin_xattr(ofs, ofs->indexdir)) {
924 			err = ovl_verify_set_fh(ofs, ofs->indexdir,
925 						OVL_XATTR_ORIGIN,
926 						upperpath->dentry, true, false);
927 			if (err)
928 				pr_err("failed to verify index dir 'origin' xattr\n");
929 		}
930 		err = ovl_verify_upper(ofs, ofs->indexdir, upperpath->dentry,
931 				       true);
932 		if (err)
933 			pr_err("failed to verify index dir 'upper' xattr\n");
934 
935 		/* Cleanup bad/stale/orphan index entries */
936 		if (!err)
937 			err = ovl_indexdir_cleanup(ofs);
938 	}
939 	if (err || !ofs->indexdir)
940 		pr_warn("try deleting index dir or mounting with '-o index=off' to disable inodes index.\n");
941 
942 out:
943 	mnt_drop_write(mnt);
944 	return err;
945 }
946 
947 static bool ovl_lower_uuid_ok(struct ovl_fs *ofs, const uuid_t *uuid)
948 {
949 	unsigned int i;
950 
951 	if (!ofs->config.nfs_export && !ovl_upper_mnt(ofs))
952 		return true;
953 
954 	/*
955 	 * We allow using single lower with null uuid for index and nfs_export
956 	 * for example to support those features with single lower squashfs.
957 	 * To avoid regressions in setups of overlay with re-formatted lower
958 	 * squashfs, do not allow decoding origin with lower null uuid unless
959 	 * user opted-in to one of the new features that require following the
960 	 * lower inode of non-dir upper.
961 	 */
962 	if (ovl_allow_offline_changes(ofs) && uuid_is_null(uuid))
963 		return false;
964 
965 	for (i = 0; i < ofs->numfs; i++) {
966 		/*
967 		 * We use uuid to associate an overlay lower file handle with a
968 		 * lower layer, so we can accept lower fs with null uuid as long
969 		 * as all lower layers with null uuid are on the same fs.
970 		 * if we detect multiple lower fs with the same uuid, we
971 		 * disable lower file handle decoding on all of them.
972 		 */
973 		if (ofs->fs[i].is_lower &&
974 		    uuid_equal(&ofs->fs[i].sb->s_uuid, uuid)) {
975 			ofs->fs[i].bad_uuid = true;
976 			return false;
977 		}
978 	}
979 	return true;
980 }
981 
982 /* Get a unique fsid for the layer */
983 static int ovl_get_fsid(struct ovl_fs *ofs, const struct path *path)
984 {
985 	struct super_block *sb = path->mnt->mnt_sb;
986 	unsigned int i;
987 	dev_t dev;
988 	int err;
989 	bool bad_uuid = false;
990 	bool warn = false;
991 
992 	for (i = 0; i < ofs->numfs; i++) {
993 		if (ofs->fs[i].sb == sb)
994 			return i;
995 	}
996 
997 	if (!ovl_lower_uuid_ok(ofs, &sb->s_uuid)) {
998 		bad_uuid = true;
999 		if (ofs->config.xino == OVL_XINO_AUTO) {
1000 			ofs->config.xino = OVL_XINO_OFF;
1001 			warn = true;
1002 		}
1003 		if (ofs->config.index || ofs->config.nfs_export) {
1004 			ofs->config.index = false;
1005 			ofs->config.nfs_export = false;
1006 			warn = true;
1007 		}
1008 		if (warn) {
1009 			pr_warn("%s uuid detected in lower fs '%pd2', falling back to xino=%s,index=off,nfs_export=off.\n",
1010 				uuid_is_null(&sb->s_uuid) ? "null" :
1011 							    "conflicting",
1012 				path->dentry, ovl_xino_mode(&ofs->config));
1013 		}
1014 	}
1015 
1016 	err = get_anon_bdev(&dev);
1017 	if (err) {
1018 		pr_err("failed to get anonymous bdev for lowerpath\n");
1019 		return err;
1020 	}
1021 
1022 	ofs->fs[ofs->numfs].sb = sb;
1023 	ofs->fs[ofs->numfs].pseudo_dev = dev;
1024 	ofs->fs[ofs->numfs].bad_uuid = bad_uuid;
1025 
1026 	return ofs->numfs++;
1027 }
1028 
1029 /*
1030  * The fsid after the last lower fsid is used for the data layers.
1031  * It is a "null fs" with a null sb, null uuid, and no pseudo dev.
1032  */
1033 static int ovl_get_data_fsid(struct ovl_fs *ofs)
1034 {
1035 	return ofs->numfs;
1036 }
1037 
1038 
1039 static int ovl_get_layers(struct super_block *sb, struct ovl_fs *ofs,
1040 			  struct ovl_fs_context *ctx, struct ovl_layer *layers)
1041 {
1042 	int err;
1043 	unsigned int i;
1044 	size_t nr_merged_lower;
1045 
1046 	ofs->fs = kcalloc(ctx->nr + 2, sizeof(struct ovl_sb), GFP_KERNEL);
1047 	if (ofs->fs == NULL)
1048 		return -ENOMEM;
1049 
1050 	/*
1051 	 * idx/fsid 0 are reserved for upper fs even with lower only overlay
1052 	 * and the last fsid is reserved for "null fs" of the data layers.
1053 	 */
1054 	ofs->numfs++;
1055 
1056 	/*
1057 	 * All lower layers that share the same fs as upper layer, use the same
1058 	 * pseudo_dev as upper layer.  Allocate fs[0].pseudo_dev even for lower
1059 	 * only overlay to simplify ovl_fs_free().
1060 	 * is_lower will be set if upper fs is shared with a lower layer.
1061 	 */
1062 	err = get_anon_bdev(&ofs->fs[0].pseudo_dev);
1063 	if (err) {
1064 		pr_err("failed to get anonymous bdev for upper fs\n");
1065 		return err;
1066 	}
1067 
1068 	if (ovl_upper_mnt(ofs)) {
1069 		ofs->fs[0].sb = ovl_upper_mnt(ofs)->mnt_sb;
1070 		ofs->fs[0].is_lower = false;
1071 	}
1072 
1073 	nr_merged_lower = ctx->nr - ctx->nr_data;
1074 	for (i = 0; i < ctx->nr; i++) {
1075 		struct ovl_fs_context_layer *l = &ctx->lower[i];
1076 		struct vfsmount *mnt;
1077 		struct inode *trap;
1078 		int fsid;
1079 
1080 		if (i < nr_merged_lower)
1081 			fsid = ovl_get_fsid(ofs, &l->path);
1082 		else
1083 			fsid = ovl_get_data_fsid(ofs);
1084 		if (fsid < 0)
1085 			return fsid;
1086 
1087 		/*
1088 		 * Check if lower root conflicts with this overlay layers before
1089 		 * checking if it is in-use as upperdir/workdir of "another"
1090 		 * mount, because we do not bother to check in ovl_is_inuse() if
1091 		 * the upperdir/workdir is in fact in-use by our
1092 		 * upperdir/workdir.
1093 		 */
1094 		err = ovl_setup_trap(sb, l->path.dentry, &trap, "lowerdir");
1095 		if (err)
1096 			return err;
1097 
1098 		if (ovl_is_inuse(l->path.dentry)) {
1099 			err = ovl_report_in_use(ofs, "lowerdir");
1100 			if (err) {
1101 				iput(trap);
1102 				return err;
1103 			}
1104 		}
1105 
1106 		mnt = clone_private_mount(&l->path);
1107 		err = PTR_ERR(mnt);
1108 		if (IS_ERR(mnt)) {
1109 			pr_err("failed to clone lowerpath\n");
1110 			iput(trap);
1111 			return err;
1112 		}
1113 
1114 		/*
1115 		 * Make lower layers R/O.  That way fchmod/fchown on lower file
1116 		 * will fail instead of modifying lower fs.
1117 		 */
1118 		mnt->mnt_flags |= MNT_READONLY | MNT_NOATIME;
1119 
1120 		layers[ofs->numlayer].trap = trap;
1121 		layers[ofs->numlayer].mnt = mnt;
1122 		layers[ofs->numlayer].idx = ofs->numlayer;
1123 		layers[ofs->numlayer].fsid = fsid;
1124 		layers[ofs->numlayer].fs = &ofs->fs[fsid];
1125 		layers[ofs->numlayer].name = l->name;
1126 		l->name = NULL;
1127 		ofs->numlayer++;
1128 		ofs->fs[fsid].is_lower = true;
1129 	}
1130 
1131 	/*
1132 	 * When all layers on same fs, overlay can use real inode numbers.
1133 	 * With mount option "xino=<on|auto>", mounter declares that there are
1134 	 * enough free high bits in underlying fs to hold the unique fsid.
1135 	 * If overlayfs does encounter underlying inodes using the high xino
1136 	 * bits reserved for fsid, it emits a warning and uses the original
1137 	 * inode number or a non persistent inode number allocated from a
1138 	 * dedicated range.
1139 	 */
1140 	if (ofs->numfs - !ovl_upper_mnt(ofs) == 1) {
1141 		if (ofs->config.xino == OVL_XINO_ON)
1142 			pr_info("\"xino=on\" is useless with all layers on same fs, ignore.\n");
1143 		ofs->xino_mode = 0;
1144 	} else if (ofs->config.xino == OVL_XINO_OFF) {
1145 		ofs->xino_mode = -1;
1146 	} else if (ofs->xino_mode < 0) {
1147 		/*
1148 		 * This is a roundup of number of bits needed for encoding
1149 		 * fsid, where fsid 0 is reserved for upper fs (even with
1150 		 * lower only overlay) +1 extra bit is reserved for the non
1151 		 * persistent inode number range that is used for resolving
1152 		 * xino lower bits overflow.
1153 		 */
1154 		BUILD_BUG_ON(ilog2(OVL_MAX_STACK) > 30);
1155 		ofs->xino_mode = ilog2(ofs->numfs - 1) + 2;
1156 	}
1157 
1158 	if (ofs->xino_mode > 0) {
1159 		pr_info("\"xino\" feature enabled using %d upper inode bits.\n",
1160 			ofs->xino_mode);
1161 	}
1162 
1163 	return 0;
1164 }
1165 
1166 static struct ovl_entry *ovl_get_lowerstack(struct super_block *sb,
1167 					    struct ovl_fs_context *ctx,
1168 					    struct ovl_fs *ofs,
1169 					    struct ovl_layer *layers)
1170 {
1171 	int err;
1172 	unsigned int i;
1173 	size_t nr_merged_lower;
1174 	struct ovl_entry *oe;
1175 	struct ovl_path *lowerstack;
1176 
1177 	struct ovl_fs_context_layer *l;
1178 
1179 	if (!ofs->config.upperdir && ctx->nr == 1) {
1180 		pr_err("at least 2 lowerdir are needed while upperdir nonexistent\n");
1181 		return ERR_PTR(-EINVAL);
1182 	}
1183 
1184 	err = -EINVAL;
1185 	for (i = 0; i < ctx->nr; i++) {
1186 		l = &ctx->lower[i];
1187 
1188 		err = ovl_lower_dir(l->name, &l->path, ofs, &sb->s_stack_depth);
1189 		if (err)
1190 			return ERR_PTR(err);
1191 	}
1192 
1193 	err = -EINVAL;
1194 	sb->s_stack_depth++;
1195 	if (sb->s_stack_depth > FILESYSTEM_MAX_STACK_DEPTH) {
1196 		pr_err("maximum fs stacking depth exceeded\n");
1197 		return ERR_PTR(err);
1198 	}
1199 
1200 	err = ovl_get_layers(sb, ofs, ctx, layers);
1201 	if (err)
1202 		return ERR_PTR(err);
1203 
1204 	err = -ENOMEM;
1205 	/* Data-only layers are not merged in root directory */
1206 	nr_merged_lower = ctx->nr - ctx->nr_data;
1207 	oe = ovl_alloc_entry(nr_merged_lower);
1208 	if (!oe)
1209 		return ERR_PTR(err);
1210 
1211 	lowerstack = ovl_lowerstack(oe);
1212 	for (i = 0; i < nr_merged_lower; i++) {
1213 		l = &ctx->lower[i];
1214 		lowerstack[i].dentry = dget(l->path.dentry);
1215 		lowerstack[i].layer = &ofs->layers[i + 1];
1216 	}
1217 	ofs->numdatalayer = ctx->nr_data;
1218 
1219 	return oe;
1220 }
1221 
1222 /*
1223  * Check if this layer root is a descendant of:
1224  * - another layer of this overlayfs instance
1225  * - upper/work dir of any overlayfs instance
1226  */
1227 static int ovl_check_layer(struct super_block *sb, struct ovl_fs *ofs,
1228 			   struct dentry *dentry, const char *name,
1229 			   bool is_lower)
1230 {
1231 	struct dentry *next = dentry, *parent;
1232 	int err = 0;
1233 
1234 	if (!dentry)
1235 		return 0;
1236 
1237 	parent = dget_parent(next);
1238 
1239 	/* Walk back ancestors to root (inclusive) looking for traps */
1240 	while (!err && parent != next) {
1241 		if (is_lower && ovl_lookup_trap_inode(sb, parent)) {
1242 			err = -ELOOP;
1243 			pr_err("overlapping %s path\n", name);
1244 		} else if (ovl_is_inuse(parent)) {
1245 			err = ovl_report_in_use(ofs, name);
1246 		}
1247 		next = parent;
1248 		parent = dget_parent(next);
1249 		dput(next);
1250 	}
1251 
1252 	dput(parent);
1253 
1254 	return err;
1255 }
1256 
1257 /*
1258  * Check if any of the layers or work dirs overlap.
1259  */
1260 static int ovl_check_overlapping_layers(struct super_block *sb,
1261 					struct ovl_fs *ofs)
1262 {
1263 	int i, err;
1264 
1265 	if (ovl_upper_mnt(ofs)) {
1266 		err = ovl_check_layer(sb, ofs, ovl_upper_mnt(ofs)->mnt_root,
1267 				      "upperdir", false);
1268 		if (err)
1269 			return err;
1270 
1271 		/*
1272 		 * Checking workbasedir avoids hitting ovl_is_inuse(parent) of
1273 		 * this instance and covers overlapping work and index dirs,
1274 		 * unless work or index dir have been moved since created inside
1275 		 * workbasedir.  In that case, we already have their traps in
1276 		 * inode cache and we will catch that case on lookup.
1277 		 */
1278 		err = ovl_check_layer(sb, ofs, ofs->workbasedir, "workdir",
1279 				      false);
1280 		if (err)
1281 			return err;
1282 	}
1283 
1284 	for (i = 1; i < ofs->numlayer; i++) {
1285 		err = ovl_check_layer(sb, ofs,
1286 				      ofs->layers[i].mnt->mnt_root,
1287 				      "lowerdir", true);
1288 		if (err)
1289 			return err;
1290 	}
1291 
1292 	return 0;
1293 }
1294 
1295 static struct dentry *ovl_get_root(struct super_block *sb,
1296 				   struct dentry *upperdentry,
1297 				   struct ovl_entry *oe)
1298 {
1299 	struct dentry *root;
1300 	struct ovl_path *lowerpath = ovl_lowerstack(oe);
1301 	unsigned long ino = d_inode(lowerpath->dentry)->i_ino;
1302 	int fsid = lowerpath->layer->fsid;
1303 	struct ovl_inode_params oip = {
1304 		.upperdentry = upperdentry,
1305 		.oe = oe,
1306 	};
1307 
1308 	root = d_make_root(ovl_new_inode(sb, S_IFDIR, 0));
1309 	if (!root)
1310 		return NULL;
1311 
1312 	if (upperdentry) {
1313 		/* Root inode uses upper st_ino/i_ino */
1314 		ino = d_inode(upperdentry)->i_ino;
1315 		fsid = 0;
1316 		ovl_dentry_set_upper_alias(root);
1317 		if (ovl_is_impuredir(sb, upperdentry))
1318 			ovl_set_flag(OVL_IMPURE, d_inode(root));
1319 	}
1320 
1321 	/* Root is always merge -> can have whiteouts */
1322 	ovl_set_flag(OVL_WHITEOUTS, d_inode(root));
1323 	ovl_dentry_set_flag(OVL_E_CONNECTED, root);
1324 	ovl_set_upperdata(d_inode(root));
1325 	ovl_inode_init(d_inode(root), &oip, ino, fsid);
1326 	ovl_dentry_init_flags(root, upperdentry, oe, DCACHE_OP_WEAK_REVALIDATE);
1327 	/* root keeps a reference of upperdentry */
1328 	dget(upperdentry);
1329 
1330 	return root;
1331 }
1332 
1333 int ovl_fill_super(struct super_block *sb, struct fs_context *fc)
1334 {
1335 	struct ovl_fs *ofs = sb->s_fs_info;
1336 	struct ovl_fs_context *ctx = fc->fs_private;
1337 	struct dentry *root_dentry;
1338 	struct ovl_entry *oe;
1339 	struct ovl_layer *layers;
1340 	struct cred *cred;
1341 	int err;
1342 
1343 	err = -EIO;
1344 	if (WARN_ON(fc->user_ns != current_user_ns()))
1345 		goto out_err;
1346 
1347 	sb->s_d_op = &ovl_dentry_operations;
1348 
1349 	err = -ENOMEM;
1350 	ofs->creator_cred = cred = prepare_creds();
1351 	if (!cred)
1352 		goto out_err;
1353 
1354 	err = ovl_fs_params_verify(ctx, &ofs->config);
1355 	if (err)
1356 		goto out_err;
1357 
1358 	err = -EINVAL;
1359 	if (ctx->nr == 0) {
1360 		if (!(fc->sb_flags & SB_SILENT))
1361 			pr_err("missing 'lowerdir'\n");
1362 		goto out_err;
1363 	}
1364 
1365 	err = -ENOMEM;
1366 	layers = kcalloc(ctx->nr + 1, sizeof(struct ovl_layer), GFP_KERNEL);
1367 	if (!layers)
1368 		goto out_err;
1369 
1370 	ofs->layers = layers;
1371 	/* Layer 0 is reserved for upper even if there's no upper */
1372 	ofs->numlayer = 1;
1373 
1374 	sb->s_stack_depth = 0;
1375 	sb->s_maxbytes = MAX_LFS_FILESIZE;
1376 	atomic_long_set(&ofs->last_ino, 1);
1377 	/* Assume underlying fs uses 32bit inodes unless proven otherwise */
1378 	if (ofs->config.xino != OVL_XINO_OFF) {
1379 		ofs->xino_mode = BITS_PER_LONG - 32;
1380 		if (!ofs->xino_mode) {
1381 			pr_warn("xino not supported on 32bit kernel, falling back to xino=off.\n");
1382 			ofs->config.xino = OVL_XINO_OFF;
1383 		}
1384 	}
1385 
1386 	/* alloc/destroy_inode needed for setting up traps in inode cache */
1387 	sb->s_op = &ovl_super_operations;
1388 
1389 	if (ofs->config.upperdir) {
1390 		struct super_block *upper_sb;
1391 
1392 		err = -EINVAL;
1393 		if (!ofs->config.workdir) {
1394 			pr_err("missing 'workdir'\n");
1395 			goto out_err;
1396 		}
1397 
1398 		err = ovl_get_upper(sb, ofs, &layers[0], &ctx->upper);
1399 		if (err)
1400 			goto out_err;
1401 
1402 		upper_sb = ovl_upper_mnt(ofs)->mnt_sb;
1403 		if (!ovl_should_sync(ofs)) {
1404 			ofs->errseq = errseq_sample(&upper_sb->s_wb_err);
1405 			if (errseq_check(&upper_sb->s_wb_err, ofs->errseq)) {
1406 				err = -EIO;
1407 				pr_err("Cannot mount volatile when upperdir has an unseen error. Sync upperdir fs to clear state.\n");
1408 				goto out_err;
1409 			}
1410 		}
1411 
1412 		err = ovl_get_workdir(sb, ofs, &ctx->upper, &ctx->work);
1413 		if (err)
1414 			goto out_err;
1415 
1416 		if (!ofs->workdir)
1417 			sb->s_flags |= SB_RDONLY;
1418 
1419 		sb->s_stack_depth = upper_sb->s_stack_depth;
1420 		sb->s_time_gran = upper_sb->s_time_gran;
1421 	}
1422 	oe = ovl_get_lowerstack(sb, ctx, ofs, layers);
1423 	err = PTR_ERR(oe);
1424 	if (IS_ERR(oe))
1425 		goto out_err;
1426 
1427 	/* If the upper fs is nonexistent, we mark overlayfs r/o too */
1428 	if (!ovl_upper_mnt(ofs))
1429 		sb->s_flags |= SB_RDONLY;
1430 
1431 	if (!ovl_origin_uuid(ofs) && ofs->numfs > 1) {
1432 		pr_warn("The uuid=off requires a single fs for lower and upper, falling back to uuid=null.\n");
1433 		ofs->config.uuid = OVL_UUID_NULL;
1434 	} else if (ovl_has_fsid(ofs) && ovl_upper_mnt(ofs)) {
1435 		/* Use per instance persistent uuid/fsid */
1436 		ovl_init_uuid_xattr(sb, ofs, &ctx->upper);
1437 	}
1438 
1439 	if (!ovl_force_readonly(ofs) && ofs->config.index) {
1440 		err = ovl_get_indexdir(sb, ofs, oe, &ctx->upper);
1441 		if (err)
1442 			goto out_free_oe;
1443 
1444 		/* Force r/o mount with no index dir */
1445 		if (!ofs->indexdir)
1446 			sb->s_flags |= SB_RDONLY;
1447 	}
1448 
1449 	err = ovl_check_overlapping_layers(sb, ofs);
1450 	if (err)
1451 		goto out_free_oe;
1452 
1453 	/* Show index=off in /proc/mounts for forced r/o mount */
1454 	if (!ofs->indexdir) {
1455 		ofs->config.index = false;
1456 		if (ovl_upper_mnt(ofs) && ofs->config.nfs_export) {
1457 			pr_warn("NFS export requires an index dir, falling back to nfs_export=off.\n");
1458 			ofs->config.nfs_export = false;
1459 		}
1460 	}
1461 
1462 	if (ofs->config.metacopy && ofs->config.nfs_export) {
1463 		pr_warn("NFS export is not supported with metadata only copy up, falling back to nfs_export=off.\n");
1464 		ofs->config.nfs_export = false;
1465 	}
1466 
1467 	/*
1468 	 * Support encoding decodable file handles with nfs_export=on
1469 	 * and encoding non-decodable file handles with nfs_export=off
1470 	 * if all layers support file handles.
1471 	 */
1472 	if (ofs->config.nfs_export)
1473 		sb->s_export_op = &ovl_export_operations;
1474 	else if (!ofs->nofh)
1475 		sb->s_export_op = &ovl_export_fid_operations;
1476 
1477 	/* Never override disk quota limits or use reserved space */
1478 	cap_lower(cred->cap_effective, CAP_SYS_RESOURCE);
1479 
1480 	sb->s_magic = OVERLAYFS_SUPER_MAGIC;
1481 	sb->s_xattr = ofs->config.userxattr ? ovl_user_xattr_handlers :
1482 		ovl_trusted_xattr_handlers;
1483 	sb->s_fs_info = ofs;
1484 	sb->s_flags |= SB_POSIXACL;
1485 	sb->s_iflags |= SB_I_SKIP_SYNC | SB_I_IMA_UNVERIFIABLE_SIGNATURE;
1486 
1487 	err = -ENOMEM;
1488 	root_dentry = ovl_get_root(sb, ctx->upper.dentry, oe);
1489 	if (!root_dentry)
1490 		goto out_free_oe;
1491 
1492 	sb->s_root = root_dentry;
1493 
1494 	return 0;
1495 
1496 out_free_oe:
1497 	ovl_free_entry(oe);
1498 out_err:
1499 	ovl_free_fs(ofs);
1500 	sb->s_fs_info = NULL;
1501 	return err;
1502 }
1503 
1504 struct file_system_type ovl_fs_type = {
1505 	.owner			= THIS_MODULE,
1506 	.name			= "overlay",
1507 	.init_fs_context	= ovl_init_fs_context,
1508 	.parameters		= ovl_parameter_spec,
1509 	.fs_flags		= FS_USERNS_MOUNT,
1510 	.kill_sb		= kill_anon_super,
1511 };
1512 MODULE_ALIAS_FS("overlay");
1513 
1514 static void ovl_inode_init_once(void *foo)
1515 {
1516 	struct ovl_inode *oi = foo;
1517 
1518 	inode_init_once(&oi->vfs_inode);
1519 }
1520 
1521 static int __init ovl_init(void)
1522 {
1523 	int err;
1524 
1525 	ovl_inode_cachep = kmem_cache_create("ovl_inode",
1526 					     sizeof(struct ovl_inode), 0,
1527 					     (SLAB_RECLAIM_ACCOUNT|
1528 					      SLAB_MEM_SPREAD|SLAB_ACCOUNT),
1529 					     ovl_inode_init_once);
1530 	if (ovl_inode_cachep == NULL)
1531 		return -ENOMEM;
1532 
1533 	err = ovl_aio_request_cache_init();
1534 	if (!err) {
1535 		err = register_filesystem(&ovl_fs_type);
1536 		if (!err)
1537 			return 0;
1538 
1539 		ovl_aio_request_cache_destroy();
1540 	}
1541 	kmem_cache_destroy(ovl_inode_cachep);
1542 
1543 	return err;
1544 }
1545 
1546 static void __exit ovl_exit(void)
1547 {
1548 	unregister_filesystem(&ovl_fs_type);
1549 
1550 	/*
1551 	 * Make sure all delayed rcu free inodes are flushed before we
1552 	 * destroy cache.
1553 	 */
1554 	rcu_barrier();
1555 	kmem_cache_destroy(ovl_inode_cachep);
1556 	ovl_aio_request_cache_destroy();
1557 }
1558 
1559 module_init(ovl_init);
1560 module_exit(ovl_exit);
1561