xref: /freebsd/sys/fs/unionfs/union_vfsops.c (revision 66df505066f51e6d8411b966765d828817f88971)
1 /*-
2  * SPDX-License-Identifier: BSD-3-Clause
3  *
4  * Copyright (c) 1994, 1995 The Regents of the University of California.
5  * Copyright (c) 1994, 1995 Jan-Simon Pendry.
6  * Copyright (c) 2005, 2006, 2012 Masanori Ozawa <ozawa@ongs.co.jp>, ONGS Inc.
7  * Copyright (c) 2006, 2012 Daichi Goto <daichi@freebsd.org>
8  * All rights reserved.
9  *
10  * This code is derived from software donated to Berkeley by
11  * Jan-Simon Pendry.
12  *
13  * Redistribution and use in source and binary forms, with or without
14  * modification, are permitted provided that the following conditions
15  * are met:
16  * 1. Redistributions of source code must retain the above copyright
17  *    notice, this list of conditions and the following disclaimer.
18  * 2. Redistributions in binary form must reproduce the above copyright
19  *    notice, this list of conditions and the following disclaimer in the
20  *    documentation and/or other materials provided with the distribution.
21  * 3. Neither the name of the University nor the names of its contributors
22  *    may be used to endorse or promote products derived from this software
23  *    without specific prior written permission.
24  *
25  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
26  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
27  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
28  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
29  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
30  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
31  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
32  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
33  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
34  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
35  * SUCH DAMAGE.
36  *
37  *	@(#)union_vfsops.c	8.20 (Berkeley) 5/20/95
38  * $FreeBSD$
39  */
40 
41 #include <sys/param.h>
42 #include <sys/systm.h>
43 #include <sys/kdb.h>
44 #include <sys/fcntl.h>
45 #include <sys/kernel.h>
46 #include <sys/lock.h>
47 #include <sys/malloc.h>
48 #include <sys/mount.h>
49 #include <sys/namei.h>
50 #include <sys/proc.h>
51 #include <sys/vnode.h>
52 #include <sys/stat.h>
53 
54 #include <fs/unionfs/union.h>
55 
56 static MALLOC_DEFINE(M_UNIONFSMNT, "UNIONFS mount", "UNIONFS mount structure");
57 
58 static vfs_fhtovp_t	unionfs_fhtovp;
59 static vfs_checkexp_t	unionfs_checkexp;
60 static vfs_mount_t	unionfs_domount;
61 static vfs_quotactl_t	unionfs_quotactl;
62 static vfs_root_t	unionfs_root;
63 static vfs_sync_t	unionfs_sync;
64 static vfs_statfs_t	unionfs_statfs;
65 static vfs_unmount_t	unionfs_unmount;
66 static vfs_vget_t	unionfs_vget;
67 static vfs_extattrctl_t	unionfs_extattrctl;
68 
69 static struct vfsops unionfs_vfsops;
70 
71 /*
72  * Mount unionfs layer.
73  */
74 static int
75 unionfs_domount(struct mount *mp)
76 {
77 	struct mount   *lowermp, *uppermp;
78 	struct vnode   *lowerrootvp;
79 	struct vnode   *upperrootvp;
80 	struct unionfs_mount *ump;
81 	char           *target;
82 	char           *tmp;
83 	char           *ep;
84 	struct nameidata nd, *ndp;
85 	struct vattr	va;
86 	unionfs_copymode copymode;
87 	unionfs_whitemode whitemode;
88 	int		below;
89 	int		error;
90 	int		len;
91 	uid_t		uid;
92 	gid_t		gid;
93 	u_short		udir;
94 	u_short		ufile;
95 
96 	UNIONFSDEBUG("unionfs_mount(mp = %p)\n", mp);
97 
98 	error = 0;
99 	below = 0;
100 	uid = 0;
101 	gid = 0;
102 	udir = 0;
103 	ufile = 0;
104 	copymode = UNIONFS_TRANSPARENT;	/* default */
105 	whitemode = UNIONFS_WHITE_ALWAYS;
106 	ndp = &nd;
107 
108 	if (mp->mnt_flag & MNT_ROOTFS) {
109 		vfs_mount_error(mp, "Cannot union mount root filesystem");
110 		return (EOPNOTSUPP);
111 	}
112 
113 	/*
114 	 * Update is a no operation.
115 	 */
116 	if (mp->mnt_flag & MNT_UPDATE) {
117 		vfs_mount_error(mp, "unionfs does not support mount update");
118 		return (EOPNOTSUPP);
119 	}
120 
121 	/*
122 	 * Get argument
123 	 */
124 	error = vfs_getopt(mp->mnt_optnew, "target", (void **)&target, &len);
125 	if (error)
126 		error = vfs_getopt(mp->mnt_optnew, "from", (void **)&target,
127 		    &len);
128 	if (error || target[len - 1] != '\0') {
129 		vfs_mount_error(mp, "Invalid target");
130 		return (EINVAL);
131 	}
132 	if (vfs_getopt(mp->mnt_optnew, "below", NULL, NULL) == 0)
133 		below = 1;
134 	if (vfs_getopt(mp->mnt_optnew, "udir", (void **)&tmp, NULL) == 0) {
135 		if (tmp != NULL)
136 			udir = (mode_t)strtol(tmp, &ep, 8);
137 		if (tmp == NULL || *ep) {
138 			vfs_mount_error(mp, "Invalid udir");
139 			return (EINVAL);
140 		}
141 		udir &= S_IRWXU | S_IRWXG | S_IRWXO;
142 	}
143 	if (vfs_getopt(mp->mnt_optnew, "ufile", (void **)&tmp, NULL) == 0) {
144 		if (tmp != NULL)
145 			ufile = (mode_t)strtol(tmp, &ep, 8);
146 		if (tmp == NULL || *ep) {
147 			vfs_mount_error(mp, "Invalid ufile");
148 			return (EINVAL);
149 		}
150 		ufile &= S_IRWXU | S_IRWXG | S_IRWXO;
151 	}
152 	/* check umask, uid and gid */
153 	if (udir == 0 && ufile != 0)
154 		udir = ufile;
155 	if (ufile == 0 && udir != 0)
156 		ufile = udir;
157 
158 	vn_lock(mp->mnt_vnodecovered, LK_SHARED | LK_RETRY);
159 	error = VOP_GETATTR(mp->mnt_vnodecovered, &va, mp->mnt_cred);
160 	if (!error) {
161 		if (udir == 0)
162 			udir = va.va_mode;
163 		if (ufile == 0)
164 			ufile = va.va_mode;
165 		uid = va.va_uid;
166 		gid = va.va_gid;
167 	}
168 	VOP_UNLOCK(mp->mnt_vnodecovered);
169 	if (error)
170 		return (error);
171 
172 	if (mp->mnt_cred->cr_ruid == 0) {	/* root only */
173 		if (vfs_getopt(mp->mnt_optnew, "uid", (void **)&tmp,
174 		    NULL) == 0) {
175 			if (tmp != NULL)
176 				uid = (uid_t)strtol(tmp, &ep, 10);
177 			if (tmp == NULL || *ep) {
178 				vfs_mount_error(mp, "Invalid uid");
179 				return (EINVAL);
180 			}
181 		}
182 		if (vfs_getopt(mp->mnt_optnew, "gid", (void **)&tmp,
183 		    NULL) == 0) {
184 			if (tmp != NULL)
185 				gid = (gid_t)strtol(tmp, &ep, 10);
186 			if (tmp == NULL || *ep) {
187 				vfs_mount_error(mp, "Invalid gid");
188 				return (EINVAL);
189 			}
190 		}
191 		if (vfs_getopt(mp->mnt_optnew, "copymode", (void **)&tmp,
192 		    NULL) == 0) {
193 			if (tmp == NULL) {
194 				vfs_mount_error(mp, "Invalid copymode");
195 				return (EINVAL);
196 			} else if (strcasecmp(tmp, "traditional") == 0)
197 				copymode = UNIONFS_TRADITIONAL;
198 			else if (strcasecmp(tmp, "transparent") == 0)
199 				copymode = UNIONFS_TRANSPARENT;
200 			else if (strcasecmp(tmp, "masquerade") == 0)
201 				copymode = UNIONFS_MASQUERADE;
202 			else {
203 				vfs_mount_error(mp, "Invalid copymode");
204 				return (EINVAL);
205 			}
206 		}
207 		if (vfs_getopt(mp->mnt_optnew, "whiteout", (void **)&tmp,
208 		    NULL) == 0) {
209 			if (tmp == NULL) {
210 				vfs_mount_error(mp, "Invalid whiteout mode");
211 				return (EINVAL);
212 			} else if (strcasecmp(tmp, "always") == 0)
213 				whitemode = UNIONFS_WHITE_ALWAYS;
214 			else if (strcasecmp(tmp, "whenneeded") == 0)
215 				whitemode = UNIONFS_WHITE_WHENNEEDED;
216 			else {
217 				vfs_mount_error(mp, "Invalid whiteout mode");
218 				return (EINVAL);
219 			}
220 		}
221 	}
222 	/* If copymode is UNIONFS_TRADITIONAL, uid/gid is mounted user. */
223 	if (copymode == UNIONFS_TRADITIONAL) {
224 		uid = mp->mnt_cred->cr_ruid;
225 		gid = mp->mnt_cred->cr_rgid;
226 	}
227 
228 	UNIONFSDEBUG("unionfs_mount: uid=%d, gid=%d\n", uid, gid);
229 	UNIONFSDEBUG("unionfs_mount: udir=0%03o, ufile=0%03o\n", udir, ufile);
230 	UNIONFSDEBUG("unionfs_mount: copymode=%d\n", copymode);
231 
232 	/*
233 	 * Find upper node
234 	 */
235 	NDINIT(ndp, LOOKUP, FOLLOW | LOCKLEAF, UIO_SYSSPACE, target);
236 	if ((error = namei(ndp)))
237 		return (error);
238 
239 	NDFREE(ndp, NDF_ONLY_PNBUF);
240 
241 	/* get root vnodes */
242 	lowerrootvp = mp->mnt_vnodecovered;
243 	upperrootvp = ndp->ni_vp;
244 
245 	/* create unionfs_mount */
246 	ump = malloc(sizeof(struct unionfs_mount), M_UNIONFSMNT,
247 	    M_WAITOK | M_ZERO);
248 
249 	/*
250 	 * Save reference
251 	 */
252 	if (below) {
253 		VOP_UNLOCK(upperrootvp);
254 		vn_lock(lowerrootvp, LK_EXCLUSIVE | LK_RETRY);
255 		ump->um_lowervp = upperrootvp;
256 		ump->um_uppervp = lowerrootvp;
257 	} else {
258 		ump->um_lowervp = lowerrootvp;
259 		ump->um_uppervp = upperrootvp;
260 	}
261 	ump->um_rootvp = NULLVP;
262 	ump->um_uid = uid;
263 	ump->um_gid = gid;
264 	ump->um_udir = udir;
265 	ump->um_ufile = ufile;
266 	ump->um_copymode = copymode;
267 	ump->um_whitemode = whitemode;
268 
269 	mp->mnt_data = ump;
270 
271 	/*
272 	 * Copy upper layer's RDONLY flag.
273 	 */
274 	mp->mnt_flag |= ump->um_uppervp->v_mount->mnt_flag & MNT_RDONLY;
275 
276 	/*
277 	 * Unlock the node
278 	 */
279 	VOP_UNLOCK(ump->um_uppervp);
280 
281 	/*
282 	 * Get the unionfs root vnode.
283 	 */
284 	error = unionfs_nodeget(mp, ump->um_uppervp, ump->um_lowervp,
285 	    NULLVP, &(ump->um_rootvp), NULL);
286 	vrele(upperrootvp);
287 	if (error != 0) {
288 		free(ump, M_UNIONFSMNT);
289 		mp->mnt_data = NULL;
290 		return (error);
291 	}
292 
293 	lowermp = vfs_register_upper_from_vp(ump->um_lowervp, mp,
294 	    &ump->um_lower_link);
295 	uppermp = vfs_register_upper_from_vp(ump->um_uppervp, mp,
296 	    &ump->um_upper_link);
297 
298 	if (lowermp == NULL || uppermp == NULL) {
299 		if (lowermp != NULL)
300 			vfs_unregister_upper(lowermp, &ump->um_lower_link);
301 		if (uppermp != NULL)
302 			vfs_unregister_upper(uppermp, &ump->um_upper_link);
303 		free(ump, M_UNIONFSMNT);
304 		mp->mnt_data = NULL;
305 		return (ENOENT);
306 	}
307 
308 	MNT_ILOCK(mp);
309 	if ((lowermp->mnt_flag & MNT_LOCAL) != 0 &&
310 	    (uppermp->mnt_flag & MNT_LOCAL) != 0)
311 		mp->mnt_flag |= MNT_LOCAL;
312 	mp->mnt_kern_flag |= MNTK_NOMSYNC | MNTK_UNIONFS;
313 	MNT_IUNLOCK(mp);
314 
315 	/*
316 	 * Get new fsid
317 	 */
318 	vfs_getnewfsid(mp);
319 
320 	snprintf(mp->mnt_stat.f_mntfromname, MNAMELEN, "<%s>:%s",
321 	    below ? "below" : "above", target);
322 
323 	UNIONFSDEBUG("unionfs_mount: from %s, on %s\n",
324 	    mp->mnt_stat.f_mntfromname, mp->mnt_stat.f_mntonname);
325 
326 	return (0);
327 }
328 
329 /*
330  * Free reference to unionfs layer
331  */
332 static int
333 unionfs_unmount(struct mount *mp, int mntflags)
334 {
335 	struct unionfs_mount *ump;
336 	int		error;
337 	int		num;
338 	int		freeing;
339 	int		flags;
340 
341 	UNIONFSDEBUG("unionfs_unmount: mp = %p\n", mp);
342 
343 	ump = MOUNTTOUNIONFSMOUNT(mp);
344 	flags = 0;
345 
346 	if (mntflags & MNT_FORCE)
347 		flags |= FORCECLOSE;
348 
349 	/* vflush (no need to call vrele) */
350 	for (freeing = 0; (error = vflush(mp, 1, flags, curthread)) != 0;) {
351 		num = mp->mnt_nvnodelistsize;
352 		if (num == freeing)
353 			break;
354 		freeing = num;
355 	}
356 
357 	if (error)
358 		return (error);
359 
360 	vfs_unregister_upper(ump->um_lowervp->v_mount, &ump->um_lower_link);
361 	vfs_unregister_upper(ump->um_uppervp->v_mount, &ump->um_upper_link);
362 	free(ump, M_UNIONFSMNT);
363 	mp->mnt_data = NULL;
364 
365 	return (0);
366 }
367 
368 static int
369 unionfs_root(struct mount *mp, int flags, struct vnode **vpp)
370 {
371 	struct unionfs_mount *ump;
372 	struct vnode *vp;
373 
374 	ump = MOUNTTOUNIONFSMOUNT(mp);
375 	vp = ump->um_rootvp;
376 
377 	UNIONFSDEBUG("unionfs_root: rootvp=%p locked=%x\n",
378 	    vp, VOP_ISLOCKED(vp));
379 
380 	vref(vp);
381 	if (flags & LK_TYPE_MASK)
382 		vn_lock(vp, flags);
383 
384 	*vpp = vp;
385 
386 	return (0);
387 }
388 
389 static int
390 unionfs_quotactl(struct mount *mp, int cmd, uid_t uid, void *arg,
391     bool *mp_busy)
392 {
393 	struct mount *uppermp;
394 	struct unionfs_mount *ump;
395 	int error;
396 	bool unbusy;
397 
398 	ump = MOUNTTOUNIONFSMOUNT(mp);
399 	uppermp = atomic_load_ptr(&ump->um_uppervp->v_mount);
400 	KASSERT(*mp_busy == true, ("upper mount not busy"));
401 	/*
402 	 * See comment in sys_quotactl() for an explanation of why the
403 	 * lower mount needs to be busied by the caller of VFS_QUOTACTL()
404 	 * but may be unbusied by the implementation.  We must unbusy
405 	 * the upper mount for the same reason; otherwise a namei lookup
406 	 * issued by the VFS_QUOTACTL() implementation could traverse the
407 	 * upper mount and deadlock.
408 	 */
409 	vfs_unbusy(mp);
410 	*mp_busy = false;
411 	unbusy = true;
412 	error = vfs_busy(uppermp, 0);
413 	/*
414 	 * Writing is always performed to upper vnode.
415 	 */
416 	if (error == 0)
417 		error = VFS_QUOTACTL(uppermp, cmd, uid, arg, &unbusy);
418 	if (unbusy)
419 		vfs_unbusy(uppermp);
420 
421 	return (error);
422 }
423 
424 static int
425 unionfs_statfs(struct mount *mp, struct statfs *sbp)
426 {
427 	struct unionfs_mount *ump;
428 	struct statfs	*mstat;
429 	uint64_t	lbsize;
430 	int		error;
431 
432 	ump = MOUNTTOUNIONFSMOUNT(mp);
433 
434 	UNIONFSDEBUG("unionfs_statfs(mp = %p, lvp = %p, uvp = %p)\n",
435 	    mp, ump->um_lowervp, ump->um_uppervp);
436 
437 	mstat = malloc(sizeof(struct statfs), M_STATFS, M_WAITOK | M_ZERO);
438 
439 	error = VFS_STATFS(ump->um_lowervp->v_mount, mstat);
440 	if (error) {
441 		free(mstat, M_STATFS);
442 		return (error);
443 	}
444 
445 	/* now copy across the "interesting" information and fake the rest */
446 	sbp->f_blocks = mstat->f_blocks;
447 	sbp->f_files = mstat->f_files;
448 
449 	lbsize = mstat->f_bsize;
450 
451 	error = VFS_STATFS(ump->um_uppervp->v_mount, mstat);
452 	if (error) {
453 		free(mstat, M_STATFS);
454 		return (error);
455 	}
456 
457 	/*
458 	 * The FS type etc is copy from upper vfs.
459 	 * (write able vfs have priority)
460 	 */
461 	sbp->f_type = mstat->f_type;
462 	sbp->f_flags = mstat->f_flags;
463 	sbp->f_bsize = mstat->f_bsize;
464 	sbp->f_iosize = mstat->f_iosize;
465 
466 	if (mstat->f_bsize != lbsize)
467 		sbp->f_blocks = ((off_t)sbp->f_blocks * lbsize) /
468 		    mstat->f_bsize;
469 
470 	sbp->f_blocks += mstat->f_blocks;
471 	sbp->f_bfree = mstat->f_bfree;
472 	sbp->f_bavail = mstat->f_bavail;
473 	sbp->f_files += mstat->f_files;
474 	sbp->f_ffree = mstat->f_ffree;
475 
476 	free(mstat, M_STATFS);
477 	return (0);
478 }
479 
480 static int
481 unionfs_sync(struct mount *mp, int waitfor)
482 {
483 	/* nothing to do */
484 	return (0);
485 }
486 
487 static int
488 unionfs_vget(struct mount *mp, ino_t ino, int flags, struct vnode **vpp)
489 {
490 	return (EOPNOTSUPP);
491 }
492 
493 static int
494 unionfs_fhtovp(struct mount *mp, struct fid *fidp, int flags,
495     struct vnode **vpp)
496 {
497 	return (EOPNOTSUPP);
498 }
499 
500 static int
501 unionfs_checkexp(struct mount *mp, struct sockaddr *nam, uint64_t *extflagsp,
502     struct ucred **credanonp, int *numsecflavors, int *secflavors)
503 {
504 	return (EOPNOTSUPP);
505 }
506 
507 static int
508 unionfs_extattrctl(struct mount *mp, int cmd, struct vnode *filename_vp,
509     int namespace, const char *attrname)
510 {
511 	struct unionfs_mount *ump;
512 	struct unionfs_node *unp;
513 
514 	ump = MOUNTTOUNIONFSMOUNT(mp);
515 	unp = VTOUNIONFS(filename_vp);
516 
517 	if (unp->un_uppervp != NULLVP) {
518 		return (VFS_EXTATTRCTL(ump->um_uppervp->v_mount, cmd,
519 		    unp->un_uppervp, namespace, attrname));
520 	} else {
521 		return (VFS_EXTATTRCTL(ump->um_lowervp->v_mount, cmd,
522 		    unp->un_lowervp, namespace, attrname));
523 	}
524 }
525 
526 static struct vfsops unionfs_vfsops = {
527 	.vfs_checkexp =		unionfs_checkexp,
528 	.vfs_extattrctl =	unionfs_extattrctl,
529 	.vfs_fhtovp =		unionfs_fhtovp,
530 	.vfs_init =		unionfs_init,
531 	.vfs_mount =		unionfs_domount,
532 	.vfs_quotactl =		unionfs_quotactl,
533 	.vfs_root =		unionfs_root,
534 	.vfs_statfs =		unionfs_statfs,
535 	.vfs_sync =		unionfs_sync,
536 	.vfs_uninit =		unionfs_uninit,
537 	.vfs_unmount =		unionfs_unmount,
538 	.vfs_vget =		unionfs_vget,
539 };
540 
541 VFS_SET(unionfs_vfsops, unionfs, VFCF_LOOPBACK);
542