Home | History | Annotate | Line # | Download | only in union
union_subr.c revision 1.60
      1 /*	$NetBSD: union_subr.c,v 1.60 2014/02/07 15:29:22 hannken Exp $	*/
      2 
      3 /*
      4  * Copyright (c) 1994
      5  *	The Regents of the University of California.  All rights reserved.
      6  *
      7  * This code is derived from software contributed to Berkeley by
      8  * Jan-Simon Pendry.
      9  *
     10  * Redistribution and use in source and binary forms, with or without
     11  * modification, are permitted provided that the following conditions
     12  * are met:
     13  * 1. Redistributions of source code must retain the above copyright
     14  *    notice, this list of conditions and the following disclaimer.
     15  * 2. Redistributions in binary form must reproduce the above copyright
     16  *    notice, this list of conditions and the following disclaimer in the
     17  *    documentation and/or other materials provided with the distribution.
     18  * 3. Neither the name of the University nor the names of its contributors
     19  *    may be used to endorse or promote products derived from this software
     20  *    without specific prior written permission.
     21  *
     22  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
     23  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
     24  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
     25  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
     26  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
     27  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
     28  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
     29  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
     30  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
     31  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
     32  * SUCH DAMAGE.
     33  *
     34  *	@(#)union_subr.c	8.20 (Berkeley) 5/20/95
     35  */
     36 
     37 /*
     38  * Copyright (c) 1994 Jan-Simon Pendry
     39  *
     40  * This code is derived from software contributed to Berkeley by
     41  * Jan-Simon Pendry.
     42  *
     43  * Redistribution and use in source and binary forms, with or without
     44  * modification, are permitted provided that the following conditions
     45  * are met:
     46  * 1. Redistributions of source code must retain the above copyright
     47  *    notice, this list of conditions and the following disclaimer.
     48  * 2. Redistributions in binary form must reproduce the above copyright
     49  *    notice, this list of conditions and the following disclaimer in the
     50  *    documentation and/or other materials provided with the distribution.
     51  * 3. All advertising materials mentioning features or use of this software
     52  *    must display the following acknowledgement:
     53  *	This product includes software developed by the University of
     54  *	California, Berkeley and its contributors.
     55  * 4. Neither the name of the University nor the names of its contributors
     56  *    may be used to endorse or promote products derived from this software
     57  *    without specific prior written permission.
     58  *
     59  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
     60  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
     61  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
     62  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
     63  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
     64  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
     65  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
     66  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
     67  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
     68  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
     69  * SUCH DAMAGE.
     70  *
     71  *	@(#)union_subr.c	8.20 (Berkeley) 5/20/95
     72  */
     73 
     74 #include <sys/cdefs.h>
     75 __KERNEL_RCSID(0, "$NetBSD: union_subr.c,v 1.60 2014/02/07 15:29:22 hannken Exp $");
     76 
     77 #include <sys/param.h>
     78 #include <sys/systm.h>
     79 #include <sys/proc.h>
     80 #include <sys/time.h>
     81 #include <sys/kernel.h>
     82 #include <sys/vnode.h>
     83 #include <sys/namei.h>
     84 #include <sys/malloc.h>
     85 #include <sys/dirent.h>
     86 #include <sys/file.h>
     87 #include <sys/filedesc.h>
     88 #include <sys/queue.h>
     89 #include <sys/mount.h>
     90 #include <sys/stat.h>
     91 #include <sys/kauth.h>
     92 
     93 #include <uvm/uvm_extern.h>
     94 
     95 #include <fs/union/union.h>
     96 #include <miscfs/genfs/genfs.h>
     97 #include <miscfs/specfs/specdev.h>
     98 
     99 static LIST_HEAD(uhashhead, union_node) *uhashtbl;
    100 static u_long uhash_mask;		/* size of hash table - 1 */
    101 #define UNION_HASH(u, l) \
    102 	((((u_long) (u) + (u_long) (l)) >> 8) & uhash_mask)
    103 #define NOHASH	((u_long)-1)
    104 
    105 static kmutex_t uhash_lock;
    106 
    107 void union_updatevp(struct union_node *, struct vnode *, struct vnode *);
    108 static int union_do_lookup(struct vnode *, struct componentname *, kauth_cred_t,    const char *);
    109 int union_vn_close(struct vnode *, int, kauth_cred_t, struct lwp *);
    110 static void union_dircache_r(struct vnode *, struct vnode ***, int *);
    111 struct vnode *union_dircache(struct vnode *, struct lwp *);
    112 
    113 void
    114 union_init(void)
    115 {
    116 
    117 	mutex_init(&uhash_lock, MUTEX_DEFAULT, IPL_NONE);
    118 	uhashtbl = hashinit(desiredvnodes, HASH_LIST, true, &uhash_mask);
    119 }
    120 
    121 void
    122 union_reinit(void)
    123 {
    124 	struct union_node *un;
    125 	struct uhashhead *oldhash, *hash;
    126 	u_long oldmask, mask, val;
    127 	int i;
    128 
    129 	hash = hashinit(desiredvnodes, HASH_LIST, true, &mask);
    130 	mutex_enter(&uhash_lock);
    131 	oldhash = uhashtbl;
    132 	oldmask = uhash_mask;
    133 	uhashtbl = hash;
    134 	uhash_mask = mask;
    135 	for (i = 0; i <= oldmask; i++) {
    136 		while ((un = LIST_FIRST(&oldhash[i])) != NULL) {
    137 			LIST_REMOVE(un, un_cache);
    138 			val = UNION_HASH(un->un_uppervp, un->un_lowervp);
    139 			LIST_INSERT_HEAD(&hash[val], un, un_cache);
    140 		}
    141 	}
    142 	mutex_exit(&uhash_lock);
    143 	hashdone(oldhash, HASH_LIST, oldmask);
    144 }
    145 
    146 /*
    147  * Free global unionfs resources.
    148  */
    149 void
    150 union_done(void)
    151 {
    152 
    153 	hashdone(uhashtbl, HASH_LIST, uhash_mask);
    154 	mutex_destroy(&uhash_lock);
    155 
    156 	/* Make sure to unset the readdir hook. */
    157 	vn_union_readdir_hook = NULL;
    158 }
    159 
    160 void
    161 union_updatevp(struct union_node *un, struct vnode *uppervp,
    162 	struct vnode *lowervp)
    163 {
    164 	int ohash = UNION_HASH(un->un_uppervp, un->un_lowervp);
    165 	int nhash = UNION_HASH(uppervp, lowervp);
    166 	int docache = (lowervp != NULLVP || uppervp != NULLVP);
    167 	bool un_unlock;
    168 
    169 	KASSERT(VOP_ISLOCKED(UNIONTOV(un)) == LK_EXCLUSIVE);
    170 
    171 	mutex_enter(&uhash_lock);
    172 
    173 	if (!docache || ohash != nhash) {
    174 		if (un->un_cflags & UN_CACHED) {
    175 			un->un_cflags &= ~UN_CACHED;
    176 			LIST_REMOVE(un, un_cache);
    177 		}
    178 	}
    179 
    180 	if (un->un_lowervp != lowervp) {
    181 		if (un->un_lowervp) {
    182 			vrele(un->un_lowervp);
    183 			if (un->un_path) {
    184 				free(un->un_path, M_TEMP);
    185 				un->un_path = 0;
    186 			}
    187 			if (un->un_dirvp) {
    188 				vrele(un->un_dirvp);
    189 				un->un_dirvp = NULLVP;
    190 			}
    191 		}
    192 		un->un_lowervp = lowervp;
    193 		mutex_enter(&un->un_lock);
    194 		un->un_lowersz = VNOVAL;
    195 		mutex_exit(&un->un_lock);
    196 	}
    197 
    198 	if (un->un_uppervp != uppervp) {
    199 		if (un->un_uppervp) {
    200 			un_unlock = false;
    201 			vrele(un->un_uppervp);
    202 		} else
    203 			un_unlock = true;
    204 
    205 		mutex_enter(&un->un_lock);
    206 		un->un_uppervp = uppervp;
    207 		mutex_exit(&un->un_lock);
    208 		if (un_unlock) {
    209 			struct vop_unlock_args ap;
    210 
    211 			ap.a_vp = UNIONTOV(un);
    212 			genfs_unlock(&ap);
    213 		}
    214 		mutex_enter(&un->un_lock);
    215 		un->un_uppersz = VNOVAL;
    216 		mutex_exit(&un->un_lock);
    217 		/* Update union vnode interlock. */
    218 		if (uppervp != NULL) {
    219 			mutex_obj_hold(uppervp->v_interlock);
    220 			uvm_obj_setlock(&UNIONTOV(un)->v_uobj,
    221 			    uppervp->v_interlock);
    222 		}
    223 	}
    224 
    225 	if (docache && (ohash != nhash)) {
    226 		LIST_INSERT_HEAD(&uhashtbl[nhash], un, un_cache);
    227 		un->un_cflags |= UN_CACHED;
    228 	}
    229 
    230 	mutex_exit(&uhash_lock);
    231 }
    232 
    233 void
    234 union_newlower(struct union_node *un, struct vnode *lowervp)
    235 {
    236 
    237 	union_updatevp(un, un->un_uppervp, lowervp);
    238 }
    239 
    240 void
    241 union_newupper(struct union_node *un, struct vnode *uppervp)
    242 {
    243 
    244 	union_updatevp(un, uppervp, un->un_lowervp);
    245 }
    246 
    247 /*
    248  * Keep track of size changes in the underlying vnodes.
    249  * If the size changes, then callback to the vm layer
    250  * giving priority to the upper layer size.
    251  *
    252  * Mutex un_lock hold on entry and released on return.
    253  */
    254 void
    255 union_newsize(struct vnode *vp, off_t uppersz, off_t lowersz)
    256 {
    257 	struct union_node *un = VTOUNION(vp);
    258 	off_t sz;
    259 
    260 	KASSERT(mutex_owned(&un->un_lock));
    261 	/* only interested in regular files */
    262 	if (vp->v_type != VREG) {
    263 		mutex_exit(&un->un_lock);
    264 		uvm_vnp_setsize(vp, 0);
    265 		return;
    266 	}
    267 
    268 	sz = VNOVAL;
    269 
    270 	if ((uppersz != VNOVAL) && (un->un_uppersz != uppersz)) {
    271 		un->un_uppersz = uppersz;
    272 		if (sz == VNOVAL)
    273 			sz = un->un_uppersz;
    274 	}
    275 
    276 	if ((lowersz != VNOVAL) && (un->un_lowersz != lowersz)) {
    277 		un->un_lowersz = lowersz;
    278 		if (sz == VNOVAL)
    279 			sz = un->un_lowersz;
    280 	}
    281 	mutex_exit(&un->un_lock);
    282 
    283 	if (sz != VNOVAL) {
    284 #ifdef UNION_DIAGNOSTIC
    285 		printf("union: %s size now %qd\n",
    286 		    uppersz != VNOVAL ? "upper" : "lower", sz);
    287 #endif
    288 		uvm_vnp_setsize(vp, sz);
    289 	}
    290 }
    291 
    292 /*
    293  * allocate a union_node/vnode pair.  the vnode is
    294  * referenced and locked.  the new vnode is returned
    295  * via (vpp).  (mp) is the mountpoint of the union filesystem,
    296  * (dvp) is the parent directory where the upper layer object
    297  * should exist (but doesn't) and (cnp) is the componentname
    298  * information which is partially copied to allow the upper
    299  * layer object to be created at a later time.  (uppervp)
    300  * and (lowervp) reference the upper and lower layer objects
    301  * being mapped.  either, but not both, can be nil.
    302  * if supplied, (uppervp) is locked.
    303  * the reference is either maintained in the new union_node
    304  * object which is allocated, or they are vrele'd.
    305  *
    306  * all union_nodes are maintained on a singly-linked
    307  * list.  new nodes are only allocated when they cannot
    308  * be found on this list.  entries on the list are
    309  * removed when the vfs reclaim entry is called.
    310  *
    311  * a single lock is kept for the entire list.  this is
    312  * needed because the getnewvnode() function can block
    313  * waiting for a vnode to become free, in which case there
    314  * may be more than one process trying to get the same
    315  * vnode.  this lock is only taken if we are going to
    316  * call getnewvnode, since the kernel itself is single-threaded.
    317  *
    318  * if an entry is found on the list, then call vget() to
    319  * take a reference.  this is done because there may be
    320  * zero references to it and so it needs to removed from
    321  * the vnode free list.
    322  */
    323 int
    324 union_allocvp(
    325 	struct vnode **vpp,
    326 	struct mount *mp,
    327 	struct vnode *undvp,		/* parent union vnode */
    328 	struct vnode *dvp,		/* may be null */
    329 	struct componentname *cnp,	/* may be null */
    330 	struct vnode *uppervp,		/* may be null */
    331 	struct vnode *lowervp,		/* may be null */
    332 	int docache)
    333 {
    334 	int error;
    335 	struct vattr va;
    336 	struct union_node *un = NULL, *un1;
    337 	struct vnode *vp, *xlowervp = NULLVP;
    338 	struct union_mount *um = MOUNTTOUNIONMOUNT(mp);
    339 	voff_t uppersz, lowersz;
    340 	dev_t rdev;
    341 	u_long hash[3];
    342 	int vflag, iflag, lflag;
    343 	int try;
    344 
    345 	if (uppervp)
    346 		KASSERT(VOP_ISLOCKED(uppervp) == LK_EXCLUSIVE);
    347 
    348 	if (uppervp == NULLVP && lowervp == NULLVP)
    349 		panic("union: unidentifiable allocation");
    350 
    351 	if (uppervp && lowervp && (uppervp->v_type != lowervp->v_type)) {
    352 		xlowervp = lowervp;
    353 		lowervp = NULLVP;
    354 	}
    355 
    356 	/* detect the root vnode (and aliases) */
    357 	iflag = VI_LAYER;
    358 	vflag = 0;
    359 	if ((uppervp == um->um_uppervp) &&
    360 	    ((lowervp == NULLVP) || lowervp == um->um_lowervp)) {
    361 		if (lowervp == NULLVP) {
    362 			lowervp = um->um_lowervp;
    363 			if (lowervp != NULLVP)
    364 				vref(lowervp);
    365 		}
    366 		iflag = 0;
    367 		vflag = VV_ROOT;
    368 	}
    369 
    370 	if (!docache) {
    371 		un = NULL;
    372 		goto found;
    373 	}
    374 
    375 	/*
    376 	 * If both uppervp and lowervp are not NULL we have to
    377 	 * search union nodes with one vnode as NULL too.
    378 	 */
    379 	hash[0] = UNION_HASH(uppervp, lowervp);
    380 	if (uppervp == NULL || lowervp == NULL) {
    381 		hash[1] = hash[2] = NOHASH;
    382 	} else {
    383 		hash[1] = UNION_HASH(uppervp, NULLVP);
    384 		hash[2] = UNION_HASH(NULLVP, lowervp);
    385 	}
    386 
    387 loop:
    388 	mutex_enter(&uhash_lock);
    389 
    390 	for (try = 0; try < 3; try++) {
    391 		if (hash[try] == NOHASH)
    392 			continue;
    393 		LIST_FOREACH(un, &uhashtbl[hash[try]], un_cache) {
    394 			if ((un->un_lowervp && un->un_lowervp != lowervp) ||
    395 			    (un->un_uppervp && un->un_uppervp != uppervp) ||
    396 			    UNIONTOV(un)->v_mount != mp)
    397 				continue;
    398 
    399 			if (uppervp != NULL &&
    400 			    (uppervp == dvp || uppervp == un->un_uppervp))
    401 				/* "." or already locked. */
    402 				lflag = 0;
    403 			else
    404 				lflag = LK_EXCLUSIVE;
    405 			vp = UNIONTOV(un);
    406 			mutex_enter(vp->v_interlock);
    407 			/*
    408 			 * If this node being cleaned out and our caller
    409 			 * holds a lock, then ignore it and continue.  To
    410 			 * allow the cleaning to succeed the current thread
    411 			 * must make progress.  For a brief time the cache
    412 			 * may contain more than one vnode referring to
    413 			 * a lower node.
    414 			 */
    415 			if ((vp->v_iflag & VI_XLOCK) != 0 && lflag == 0) {
    416 				mutex_exit(vp->v_interlock);
    417 				continue;
    418 			}
    419 			mutex_exit(&uhash_lock);
    420 			if (vget(vp, lflag))
    421 				goto loop;
    422 			goto found;
    423 		}
    424 	}
    425 
    426 	mutex_exit(&uhash_lock);
    427 
    428 found:
    429 	if (un) {
    430 		KASSERT(VOP_ISLOCKED(UNIONTOV(un)) == LK_EXCLUSIVE);
    431 		KASSERT(uppervp == NULL ||
    432 		    VOP_ISLOCKED(uppervp) == LK_EXCLUSIVE);
    433 		/*
    434 		 * Save information about the upper layer.
    435 		 */
    436 		if (uppervp != un->un_uppervp) {
    437 			union_newupper(un, uppervp);
    438 		} else if (uppervp) {
    439 			vrele(uppervp);
    440 		}
    441 
    442 		if (un->un_uppervp)
    443 			un->un_flags &= ~UN_KLOCK;
    444 
    445 		/*
    446 		 * Save information about the lower layer.
    447 		 * This needs to keep track of pathname
    448 		 * and directory information which union_vn_create
    449 		 * might need.
    450 		 */
    451 		if (lowervp != un->un_lowervp) {
    452 			union_newlower(un, lowervp);
    453 			if (cnp && (lowervp != NULLVP)) {
    454 				un->un_path = malloc(cnp->cn_namelen+1,
    455 						M_TEMP, M_WAITOK);
    456 				memcpy(un->un_path, cnp->cn_nameptr,
    457 						cnp->cn_namelen);
    458 				un->un_path[cnp->cn_namelen] = '\0';
    459 				vref(dvp);
    460 				un->un_dirvp = dvp;
    461 			}
    462 		} else if (lowervp) {
    463 			vrele(lowervp);
    464 		}
    465 		*vpp = UNIONTOV(un);
    466 		return (0);
    467 	}
    468 
    469 	uppersz = lowersz = VNOVAL;
    470 	if (uppervp != NULLVP)
    471 		if (VOP_GETATTR(uppervp, &va, FSCRED) == 0)
    472 			uppersz = va.va_size;
    473 	if (lowervp != NULLVP) {
    474 		vn_lock(lowervp, LK_SHARED | LK_RETRY);
    475 		error = VOP_GETATTR(lowervp, &va, FSCRED);
    476 		VOP_UNLOCK(lowervp);
    477 		if (error == 0)
    478 			lowersz = va.va_size;
    479 	}
    480 
    481 	/*
    482 	 * Get a new vnode and share the lock with upper layer vnode,
    483 	 * unless layers are inverted.
    484 	 */
    485 	vnode_t *svp = (uppervp != NULLVP) ? uppervp : lowervp;
    486 	error = getnewvnode(VT_UNION, mp, union_vnodeop_p,
    487 	    svp->v_interlock, vpp);
    488 	if (error) {
    489 		if (uppervp) {
    490 			if (dvp == uppervp)
    491 				vrele(uppervp);
    492 			else
    493 				vput(uppervp);
    494 		}
    495 		if (lowervp)
    496 			vrele(lowervp);
    497 
    498 		return error;
    499 	}
    500 
    501 	if (docache) {
    502 		mutex_enter(&uhash_lock);
    503 		LIST_FOREACH(un1, &uhashtbl[hash[0]], un_cache) {
    504 			if (un1->un_lowervp == lowervp &&
    505 			    un1->un_uppervp == uppervp &&
    506 			    UNIONTOV(un1)->v_mount == mp) {
    507 				vp = UNIONTOV(un1);
    508 				mutex_enter(vp->v_interlock);
    509 				/*
    510 				 * Ignore nodes being cleaned out.
    511 				 * See the cache lookup above.
    512 				 */
    513 				if ((vp->v_iflag & VI_XLOCK) != 0) {
    514 					mutex_exit(vp->v_interlock);
    515 					continue;
    516 				}
    517 				mutex_exit(vp->v_interlock);
    518 				/*
    519 				 * Another thread beat us, push back freshly
    520 				 * allocated vnode and retry.
    521 				 */
    522 				mutex_exit(&uhash_lock);
    523 				ungetnewvnode(*vpp);
    524 				goto loop;
    525 			}
    526 		}
    527 	}
    528 
    529 	(*vpp)->v_data = malloc(sizeof(struct union_node), M_TEMP, M_WAITOK);
    530 
    531 	(*vpp)->v_vflag |= vflag;
    532 	(*vpp)->v_iflag |= iflag;
    533 	rdev = NODEV;
    534 	if (uppervp) {
    535 		(*vpp)->v_type = uppervp->v_type;
    536 		if (uppervp->v_type == VCHR || uppervp->v_type == VBLK)
    537 			rdev = uppervp->v_rdev;
    538 	} else {
    539 		(*vpp)->v_type = lowervp->v_type;
    540 		if (lowervp->v_type == VCHR || lowervp->v_type == VBLK)
    541 			rdev = lowervp->v_rdev;
    542 	}
    543 	if (rdev != NODEV)
    544 		spec_node_init(*vpp, rdev);
    545 
    546 	un = VTOUNION(*vpp);
    547 	mutex_init(&un->un_lock, MUTEX_DEFAULT, IPL_NONE);
    548 	un->un_vnode = *vpp;
    549 	un->un_uppervp = uppervp;
    550 	un->un_lowervp = lowervp;
    551 	un->un_pvp = undvp;
    552 	if (undvp != NULLVP)
    553 		vref(undvp);
    554 	un->un_dircache = 0;
    555 	un->un_openl = 0;
    556 	un->un_flags = 0;
    557 	un->un_cflags = 0;
    558 
    559 	if (uppervp == NULL) {
    560 		struct vop_lock_args ap;
    561 
    562 		ap.a_vp = UNIONTOV(un);
    563 		ap.a_flags = LK_EXCLUSIVE;
    564 		error = genfs_lock(&ap);
    565 		KASSERT(error == 0);
    566 	}
    567 
    568 	mutex_enter(&un->un_lock);
    569 	un->un_uppersz = VNOVAL;
    570 	un->un_lowersz = VNOVAL;
    571 	union_newsize(*vpp, uppersz, lowersz);
    572 
    573 	if (dvp && cnp && (lowervp != NULLVP)) {
    574 		un->un_path = malloc(cnp->cn_namelen+1, M_TEMP, M_WAITOK);
    575 		memcpy(un->un_path, cnp->cn_nameptr, cnp->cn_namelen);
    576 		un->un_path[cnp->cn_namelen] = '\0';
    577 		vref(dvp);
    578 		un->un_dirvp = dvp;
    579 	} else {
    580 		un->un_path = 0;
    581 		un->un_dirvp = 0;
    582 	}
    583 
    584 	if (docache) {
    585 		LIST_INSERT_HEAD(&uhashtbl[hash[0]], un, un_cache);
    586 		un->un_cflags |= UN_CACHED;
    587 	}
    588 
    589 	if (xlowervp)
    590 		vrele(xlowervp);
    591 
    592 	if (docache)
    593 		mutex_exit(&uhash_lock);
    594 
    595 	return (error);
    596 }
    597 
    598 int
    599 union_freevp(struct vnode *vp)
    600 {
    601 	struct union_node *un = VTOUNION(vp);
    602 
    603 	mutex_enter(&uhash_lock);
    604 	if (un->un_cflags & UN_CACHED) {
    605 		un->un_cflags &= ~UN_CACHED;
    606 		LIST_REMOVE(un, un_cache);
    607 	}
    608 	mutex_exit(&uhash_lock);
    609 
    610 	if (un->un_pvp != NULLVP)
    611 		vrele(un->un_pvp);
    612 	if (un->un_uppervp != NULLVP)
    613 		vrele(un->un_uppervp);
    614 	if (un->un_lowervp != NULLVP)
    615 		vrele(un->un_lowervp);
    616 	if (un->un_dirvp != NULLVP)
    617 		vrele(un->un_dirvp);
    618 	if (un->un_path)
    619 		free(un->un_path, M_TEMP);
    620 	mutex_destroy(&un->un_lock);
    621 
    622 	free(vp->v_data, M_TEMP);
    623 	vp->v_data = NULL;
    624 
    625 	return (0);
    626 }
    627 
    628 /*
    629  * copyfile.  copy the vnode (fvp) to the vnode (tvp)
    630  * using a sequence of reads and writes.  both (fvp)
    631  * and (tvp) are locked on entry and exit.
    632  */
    633 int
    634 union_copyfile(struct vnode *fvp, struct vnode *tvp, kauth_cred_t cred,
    635 	struct lwp *l)
    636 {
    637 	char *tbuf;
    638 	struct uio uio;
    639 	struct iovec iov;
    640 	int error = 0;
    641 
    642 	/*
    643 	 * strategy:
    644 	 * allocate a buffer of size MAXBSIZE.
    645 	 * loop doing reads and writes, keeping track
    646 	 * of the current uio offset.
    647 	 * give up at the first sign of trouble.
    648 	 */
    649 
    650 	uio.uio_offset = 0;
    651 	UIO_SETUP_SYSSPACE(&uio);
    652 
    653 	tbuf = malloc(MAXBSIZE, M_TEMP, M_WAITOK);
    654 
    655 	/* ugly loop follows... */
    656 	do {
    657 		off_t offset = uio.uio_offset;
    658 
    659 		uio.uio_iov = &iov;
    660 		uio.uio_iovcnt = 1;
    661 		iov.iov_base = tbuf;
    662 		iov.iov_len = MAXBSIZE;
    663 		uio.uio_resid = iov.iov_len;
    664 		uio.uio_rw = UIO_READ;
    665 		error = VOP_READ(fvp, &uio, 0, cred);
    666 
    667 		if (error == 0) {
    668 			uio.uio_iov = &iov;
    669 			uio.uio_iovcnt = 1;
    670 			iov.iov_base = tbuf;
    671 			iov.iov_len = MAXBSIZE - uio.uio_resid;
    672 			uio.uio_offset = offset;
    673 			uio.uio_rw = UIO_WRITE;
    674 			uio.uio_resid = iov.iov_len;
    675 
    676 			if (uio.uio_resid == 0)
    677 				break;
    678 
    679 			do {
    680 				error = VOP_WRITE(tvp, &uio, 0, cred);
    681 			} while ((uio.uio_resid > 0) && (error == 0));
    682 		}
    683 
    684 	} while (error == 0);
    685 
    686 	free(tbuf, M_TEMP);
    687 	return (error);
    688 }
    689 
    690 /*
    691  * (un) is assumed to be locked on entry and remains
    692  * locked on exit.
    693  */
    694 int
    695 union_copyup(struct union_node *un, int docopy, kauth_cred_t cred,
    696 	struct lwp *l)
    697 {
    698 	int error;
    699 	struct vnode *lvp, *uvp;
    700 	struct vattr lvattr, uvattr;
    701 
    702 	error = union_vn_create(&uvp, un, l);
    703 	if (error)
    704 		return (error);
    705 
    706 	KASSERT(VOP_ISLOCKED(uvp) == LK_EXCLUSIVE);
    707 	union_newupper(un, uvp);
    708 
    709 	lvp = un->un_lowervp;
    710 
    711 	if (docopy) {
    712 		/*
    713 		 * XX - should not ignore errors
    714 		 * from VOP_CLOSE
    715 		 */
    716 		vn_lock(lvp, LK_EXCLUSIVE | LK_RETRY);
    717 
    718         	error = VOP_GETATTR(lvp, &lvattr, cred);
    719 		if (error == 0)
    720 			error = VOP_OPEN(lvp, FREAD, cred);
    721 		if (error == 0) {
    722 			error = union_copyfile(lvp, uvp, cred, l);
    723 			(void) VOP_CLOSE(lvp, FREAD, cred);
    724 		}
    725 		if (error == 0) {
    726 			/* Copy permissions up too */
    727 			vattr_null(&uvattr);
    728 			uvattr.va_mode = lvattr.va_mode;
    729 			uvattr.va_flags = lvattr.va_flags;
    730         		error = VOP_SETATTR(uvp, &uvattr, cred);
    731 		}
    732 		VOP_UNLOCK(lvp);
    733 #ifdef UNION_DIAGNOSTIC
    734 		if (error == 0)
    735 			uprintf("union: copied up %s\n", un->un_path);
    736 #endif
    737 
    738 	}
    739 	union_vn_close(uvp, FWRITE, cred, l);
    740 
    741 	/*
    742 	 * Subsequent IOs will go to the top layer, so
    743 	 * call close on the lower vnode and open on the
    744 	 * upper vnode to ensure that the filesystem keeps
    745 	 * its references counts right.  This doesn't do
    746 	 * the right thing with (cred) and (FREAD) though.
    747 	 * Ignoring error returns is not right, either.
    748 	 */
    749 	if (error == 0) {
    750 		int i;
    751 
    752 		vn_lock(lvp, LK_EXCLUSIVE | LK_RETRY);
    753 		for (i = 0; i < un->un_openl; i++) {
    754 			(void) VOP_CLOSE(lvp, FREAD, cred);
    755 			(void) VOP_OPEN(uvp, FREAD, cred);
    756 		}
    757 		un->un_openl = 0;
    758 		VOP_UNLOCK(lvp);
    759 	}
    760 
    761 	return (error);
    762 
    763 }
    764 
    765 /*
    766  * Prepare the creation of a new node in the upper layer.
    767  *
    768  * (dvp) is the directory in which to create the new node.
    769  * it is locked on entry and exit.
    770  * (cnp) is the componentname to be created.
    771  * (cred, path, hash) are credentials, path and its hash to fill (cnp).
    772  */
    773 static int
    774 union_do_lookup(struct vnode *dvp, struct componentname *cnp, kauth_cred_t cred,
    775     const char *path)
    776 {
    777 	int error;
    778 	struct vnode *vp;
    779 
    780 	cnp->cn_nameiop = CREATE;
    781 	cnp->cn_flags = LOCKPARENT | ISLASTCN;
    782 	cnp->cn_cred = cred;
    783 	cnp->cn_nameptr = path;
    784 	cnp->cn_namelen = strlen(path);
    785 
    786 	error = VOP_LOOKUP(dvp, &vp, cnp);
    787 
    788 	if (error == 0) {
    789 		KASSERT(vp != NULL);
    790 		VOP_ABORTOP(dvp, cnp);
    791 		vrele(vp);
    792 		error = EEXIST;
    793 	} else if (error == EJUSTRETURN) {
    794 		error = 0;
    795 	}
    796 
    797 	return error;
    798 }
    799 
    800 /*
    801  * Create a shadow directory in the upper layer.
    802  * The new vnode is returned locked.
    803  *
    804  * (um) points to the union mount structure for access to the
    805  * the mounting process's credentials.
    806  * (dvp) is the directory in which to create the shadow directory.
    807  * it is unlocked on entry and exit.
    808  * (cnp) is the componentname to be created.
    809  * (vpp) is the returned newly created shadow directory, which
    810  * is returned locked.
    811  *
    812  * N.B. We still attempt to create shadow directories even if the union
    813  * is mounted read-only, which is a little nonintuitive.
    814  */
    815 int
    816 union_mkshadow(struct union_mount *um, struct vnode *dvp,
    817 	struct componentname *cnp, struct vnode **vpp)
    818 {
    819 	int error;
    820 	struct vattr va;
    821 	struct componentname cn;
    822 	char *pnbuf;
    823 
    824 	if (cnp->cn_namelen + 1 > MAXPATHLEN)
    825 		return ENAMETOOLONG;
    826 	pnbuf = PNBUF_GET();
    827 	memcpy(pnbuf, cnp->cn_nameptr, cnp->cn_namelen);
    828 	pnbuf[cnp->cn_namelen] = '\0';
    829 
    830 	vn_lock(dvp, LK_EXCLUSIVE | LK_RETRY);
    831 
    832 	error = union_do_lookup(dvp, &cn,
    833 	    (um->um_op == UNMNT_ABOVE ? cnp->cn_cred : um->um_cred), pnbuf);
    834 	if (error) {
    835 		VOP_UNLOCK(dvp);
    836 		PNBUF_PUT(pnbuf);
    837 		return error;
    838 	}
    839 
    840 	/*
    841 	 * policy: when creating the shadow directory in the
    842 	 * upper layer, create it owned by the user who did
    843 	 * the mount, group from parent directory, and mode
    844 	 * 777 modified by umask (ie mostly identical to the
    845 	 * mkdir syscall).  (jsp, kb)
    846 	 */
    847 
    848 	vattr_null(&va);
    849 	va.va_type = VDIR;
    850 	va.va_mode = um->um_cmode;
    851 
    852 	error = VOP_MKDIR(dvp, vpp, &cn, &va);
    853 	VOP_UNLOCK(dvp);
    854 	PNBUF_PUT(pnbuf);
    855 	return error;
    856 }
    857 
    858 /*
    859  * Create a whiteout entry in the upper layer.
    860  *
    861  * (um) points to the union mount structure for access to the
    862  * the mounting process's credentials.
    863  * (dvp) is the directory in which to create the whiteout.
    864  * it is locked on entry and exit.
    865  * (cnp) is the componentname to be created.
    866  * (un) holds the path and its hash to be created.
    867  */
    868 int
    869 union_mkwhiteout(struct union_mount *um, struct vnode *dvp,
    870 	struct componentname *cnp, struct union_node *un)
    871 {
    872 	int error;
    873 	struct componentname cn;
    874 
    875 	error = union_do_lookup(dvp, &cn,
    876 	    (um->um_op == UNMNT_ABOVE ? cnp->cn_cred : um->um_cred),
    877 	    un->un_path);
    878 	if (error)
    879 		return error;
    880 
    881 	error = VOP_WHITEOUT(dvp, &cn, CREATE);
    882 	return error;
    883 }
    884 
    885 /*
    886  * union_vn_create: creates and opens a new shadow file
    887  * on the upper union layer.  this function is similar
    888  * in spirit to calling vn_open but it avoids calling namei().
    889  * the problem with calling namei is that a) it locks too many
    890  * things, and b) it doesn't start at the "right" directory,
    891  * whereas union_do_lookup is told where to start.
    892  */
    893 int
    894 union_vn_create(struct vnode **vpp, struct union_node *un, struct lwp *l)
    895 {
    896 	struct vnode *vp;
    897 	kauth_cred_t cred = l->l_cred;
    898 	struct vattr vat;
    899 	struct vattr *vap = &vat;
    900 	int fmode = FFLAGS(O_WRONLY|O_CREAT|O_TRUNC|O_EXCL);
    901 	int error;
    902 	int cmode = UN_FILEMODE & ~l->l_proc->p_cwdi->cwdi_cmask;
    903 	struct componentname cn;
    904 
    905 	*vpp = NULLVP;
    906 
    907 	vn_lock(un->un_dirvp, LK_EXCLUSIVE | LK_RETRY);
    908 
    909 	error = union_do_lookup(un->un_dirvp, &cn, l->l_cred,
    910 	    un->un_path);
    911 	if (error) {
    912 		VOP_UNLOCK(un->un_dirvp);
    913 		return error;
    914 	}
    915 
    916 	/*
    917 	 * Good - there was no race to create the file
    918 	 * so go ahead and create it.  The permissions
    919 	 * on the file will be 0666 modified by the
    920 	 * current user's umask.  Access to the file, while
    921 	 * it is unioned, will require access to the top *and*
    922 	 * bottom files.  Access when not unioned will simply
    923 	 * require access to the top-level file.
    924 	 * TODO: confirm choice of access permissions.
    925 	 */
    926 	vattr_null(vap);
    927 	vap->va_type = VREG;
    928 	vap->va_mode = cmode;
    929 	vref(un->un_dirvp);
    930 	error = VOP_CREATE(un->un_dirvp, &vp, &cn, vap);
    931 	if (error)
    932 		return error;
    933 
    934 	vn_lock(vp, LK_EXCLUSIVE | LK_RETRY);
    935 	error = VOP_OPEN(vp, fmode, cred);
    936 	if (error) {
    937 		vput(vp);
    938 		return error;
    939 	}
    940 
    941 	vp->v_writecount++;
    942 	*vpp = vp;
    943 	return 0;
    944 }
    945 
    946 int
    947 union_vn_close(struct vnode *vp, int fmode, kauth_cred_t cred, struct lwp *l)
    948 {
    949 
    950 	if (fmode & FWRITE)
    951 		--vp->v_writecount;
    952 	return (VOP_CLOSE(vp, fmode, cred));
    953 }
    954 
    955 void
    956 union_removed_upper(struct union_node *un)
    957 {
    958 	struct vnode *vp = UNIONTOV(un);
    959 
    960 	vn_lock(vp, LK_EXCLUSIVE | LK_RETRY);
    961 #if 1
    962 	/*
    963 	 * We do not set the uppervp to NULLVP here, because lowervp
    964 	 * may also be NULLVP, so this routine would end up creating
    965 	 * a bogus union node with no upper or lower VP (that causes
    966 	 * pain in many places that assume at least one VP exists).
    967 	 * Since we've removed this node from the cache hash chains,
    968 	 * it won't be found again.  When all current holders
    969 	 * release it, union_inactive() will vgone() it.
    970 	 */
    971 	union_diruncache(un);
    972 #else
    973 	union_newupper(un, NULLVP);
    974 #endif
    975 
    976 	VOP_UNLOCK(vp);
    977 
    978 	mutex_enter(&uhash_lock);
    979 	if (un->un_cflags & UN_CACHED) {
    980 		un->un_cflags &= ~UN_CACHED;
    981 		LIST_REMOVE(un, un_cache);
    982 	}
    983 	mutex_exit(&uhash_lock);
    984 }
    985 
    986 #if 0
    987 struct vnode *
    988 union_lowervp(struct vnode *vp)
    989 {
    990 	struct union_node *un = VTOUNION(vp);
    991 
    992 	if ((un->un_lowervp != NULLVP) &&
    993 	    (vp->v_type == un->un_lowervp->v_type)) {
    994 		if (vget(un->un_lowervp, 0) == 0)
    995 			return (un->un_lowervp);
    996 	}
    997 
    998 	return (NULLVP);
    999 }
   1000 #endif
   1001 
   1002 /*
   1003  * determine whether a whiteout is needed
   1004  * during a remove/rmdir operation.
   1005  */
   1006 int
   1007 union_dowhiteout(struct union_node *un, kauth_cred_t cred)
   1008 {
   1009 	struct vattr va;
   1010 
   1011 	if (un->un_lowervp != NULLVP)
   1012 		return (1);
   1013 
   1014 	if (VOP_GETATTR(un->un_uppervp, &va, cred) == 0 &&
   1015 	    (va.va_flags & OPAQUE))
   1016 		return (1);
   1017 
   1018 	return (0);
   1019 }
   1020 
   1021 static void
   1022 union_dircache_r(struct vnode *vp, struct vnode ***vppp, int *cntp)
   1023 {
   1024 	struct union_node *un;
   1025 
   1026 	if (vp->v_op != union_vnodeop_p) {
   1027 		if (vppp) {
   1028 			vref(vp);
   1029 			*(*vppp)++ = vp;
   1030 			if (--(*cntp) == 0)
   1031 				panic("union: dircache table too small");
   1032 		} else {
   1033 			(*cntp)++;
   1034 		}
   1035 
   1036 		return;
   1037 	}
   1038 
   1039 	un = VTOUNION(vp);
   1040 	if (un->un_uppervp != NULLVP)
   1041 		union_dircache_r(un->un_uppervp, vppp, cntp);
   1042 	if (un->un_lowervp != NULLVP)
   1043 		union_dircache_r(un->un_lowervp, vppp, cntp);
   1044 }
   1045 
   1046 struct vnode *
   1047 union_dircache(struct vnode *vp, struct lwp *l)
   1048 {
   1049 	int cnt;
   1050 	struct vnode *nvp = NULLVP;
   1051 	struct vnode **vpp;
   1052 	struct vnode **dircache;
   1053 	int error;
   1054 
   1055 	vn_lock(vp, LK_EXCLUSIVE | LK_RETRY);
   1056 	dircache = VTOUNION(vp)->un_dircache;
   1057 
   1058 	nvp = NULLVP;
   1059 
   1060 	if (dircache == 0) {
   1061 		cnt = 0;
   1062 		union_dircache_r(vp, 0, &cnt);
   1063 		cnt++;
   1064 		dircache = (struct vnode **)
   1065 				malloc(cnt * sizeof(struct vnode *),
   1066 					M_TEMP, M_WAITOK);
   1067 		vpp = dircache;
   1068 		union_dircache_r(vp, &vpp, &cnt);
   1069 		VTOUNION(vp)->un_dircache = dircache;
   1070 		*vpp = NULLVP;
   1071 		vpp = dircache + 1;
   1072 	} else {
   1073 		vpp = dircache;
   1074 		do {
   1075 			if (*vpp++ == VTOUNION(vp)->un_uppervp)
   1076 				break;
   1077 		} while (*vpp != NULLVP);
   1078 	}
   1079 
   1080 	if (*vpp == NULLVP)
   1081 		goto out;
   1082 
   1083 	vn_lock(*vpp, LK_EXCLUSIVE | LK_RETRY);
   1084 	vref(*vpp);
   1085 	error = union_allocvp(&nvp, vp->v_mount, NULLVP, NULLVP, 0, *vpp, NULLVP, 0);
   1086 	if (!error) {
   1087 		VTOUNION(vp)->un_dircache = 0;
   1088 		VTOUNION(nvp)->un_dircache = dircache;
   1089 	}
   1090 
   1091 out:
   1092 	VOP_UNLOCK(vp);
   1093 	return (nvp);
   1094 }
   1095 
   1096 void
   1097 union_diruncache(struct union_node *un)
   1098 {
   1099 	struct vnode **vpp;
   1100 
   1101 	KASSERT(VOP_ISLOCKED(UNIONTOV(un)) == LK_EXCLUSIVE);
   1102 	if (un->un_dircache != 0) {
   1103 		for (vpp = un->un_dircache; *vpp != NULLVP; vpp++)
   1104 			vrele(*vpp);
   1105 		free(un->un_dircache, M_TEMP);
   1106 		un->un_dircache = 0;
   1107 	}
   1108 }
   1109 
   1110 /*
   1111  * Check whether node can rmdir (check empty).
   1112  */
   1113 int
   1114 union_check_rmdir(struct union_node *un, kauth_cred_t cred)
   1115 {
   1116 	int dirlen, eofflag, error;
   1117 	char *dirbuf;
   1118 	struct vattr va;
   1119 	struct vnode *tvp;
   1120 	struct dirent *dp, *edp;
   1121 	struct componentname cn;
   1122 	struct iovec aiov;
   1123 	struct uio auio;
   1124 
   1125 	KASSERT(un->un_uppervp != NULL);
   1126 
   1127 	/* Check upper for being opaque. */
   1128 	KASSERT(VOP_ISLOCKED(un->un_uppervp));
   1129 	error = VOP_GETATTR(un->un_uppervp, &va, cred);
   1130 	if (error || (va.va_flags & OPAQUE))
   1131 		return error;
   1132 
   1133 	if (un->un_lowervp == NULL)
   1134 		return 0;
   1135 
   1136 	/* Check lower for being empty. */
   1137 	vn_lock(un->un_lowervp, LK_SHARED | LK_RETRY);
   1138 	error = VOP_GETATTR(un->un_lowervp, &va, cred);
   1139 	if (error) {
   1140 		VOP_UNLOCK(un->un_lowervp);
   1141 		return error;
   1142 	}
   1143 	dirlen = va.va_blocksize;
   1144 	dirbuf = kmem_alloc(dirlen, KM_SLEEP);
   1145 	if (dirbuf == NULL) {
   1146 		VOP_UNLOCK(un->un_lowervp);
   1147 		return ENOMEM;
   1148 	}
   1149 	/* error = 0; */
   1150 	eofflag = 0;
   1151 	auio.uio_offset = 0;
   1152 	do {
   1153 		aiov.iov_len = dirlen;
   1154 		aiov.iov_base = dirbuf;
   1155 		auio.uio_iov = &aiov;
   1156 		auio.uio_iovcnt = 1;
   1157 		auio.uio_resid = aiov.iov_len;
   1158 		auio.uio_rw = UIO_READ;
   1159 		UIO_SETUP_SYSSPACE(&auio);
   1160 		error = VOP_READDIR(un->un_lowervp, &auio, cred, &eofflag,
   1161 		    NULL, NULL);
   1162 		if (error)
   1163 			break;
   1164 		edp = (struct dirent *)&dirbuf[dirlen - auio.uio_resid];
   1165 		for (dp = (struct dirent *)dirbuf;
   1166 		    error == 0 && dp < edp;
   1167 		    dp = (struct dirent *)((char *)dp + dp->d_reclen)) {
   1168 			if (dp->d_reclen == 0) {
   1169 				error = ENOTEMPTY;
   1170 				break;
   1171 			}
   1172 			if (dp->d_type == DT_WHT ||
   1173 			    (dp->d_namlen == 1 && dp->d_name[0] == '.') ||
   1174 			    (dp->d_namlen == 2 && !memcmp(dp->d_name, "..", 2)))
   1175 				continue;
   1176 			/* Check for presence in the upper layer. */
   1177 			cn.cn_nameiop = LOOKUP;
   1178 			cn.cn_flags = ISLASTCN | RDONLY;
   1179 			cn.cn_cred = cred;
   1180 			cn.cn_nameptr = dp->d_name;
   1181 			cn.cn_namelen = dp->d_namlen;
   1182 			error = VOP_LOOKUP(un->un_uppervp, &tvp, &cn);
   1183 			if (error == ENOENT && (cn.cn_flags & ISWHITEOUT)) {
   1184 				error = 0;
   1185 				continue;
   1186 			}
   1187 			if (error == 0)
   1188 				vrele(tvp);
   1189 			error = ENOTEMPTY;
   1190 		}
   1191 	} while (error == 0 && !eofflag);
   1192 	kmem_free(dirbuf, dirlen);
   1193 	VOP_UNLOCK(un->un_lowervp);
   1194 
   1195 	return error;
   1196 }
   1197 
   1198 /*
   1199  * This hook is called from vn_readdir() to switch to lower directory
   1200  * entry after the upper directory is read.
   1201  */
   1202 int
   1203 union_readdirhook(struct vnode **vpp, struct file *fp, struct lwp *l)
   1204 {
   1205 	struct vnode *vp = *vpp, *lvp;
   1206 	struct vattr va;
   1207 	int error;
   1208 
   1209 	if (vp->v_op != union_vnodeop_p)
   1210 		return (0);
   1211 
   1212 	/*
   1213 	 * If the directory is opaque,
   1214 	 * then don't show lower entries
   1215 	 */
   1216 	vn_lock(vp, LK_SHARED | LK_RETRY);
   1217 	error = VOP_GETATTR(vp, &va, fp->f_cred);
   1218 	VOP_UNLOCK(vp);
   1219 	if (error || (va.va_flags & OPAQUE))
   1220 		return error;
   1221 
   1222 	if ((lvp = union_dircache(vp, l)) == NULLVP)
   1223 		return (0);
   1224 
   1225 	error = VOP_OPEN(lvp, FREAD, fp->f_cred);
   1226 	if (error) {
   1227 		vput(lvp);
   1228 		return (error);
   1229 	}
   1230 	VOP_UNLOCK(lvp);
   1231 	fp->f_data = lvp;
   1232 	fp->f_offset = 0;
   1233 	error = vn_close(vp, FREAD, fp->f_cred);
   1234 	if (error)
   1235 		return (error);
   1236 	*vpp = lvp;
   1237 	return (0);
   1238 }
   1239