Home | History | Annotate | Line # | Download | only in kern
vfs_lookup.c revision 1.45
      1  1.45       erh /*	$NetBSD: vfs_lookup.c,v 1.45 2003/04/10 07:26:52 erh Exp $	*/
      2  1.13       cgd 
      3  1.10       cgd /*
      4  1.12   mycroft  * Copyright (c) 1982, 1986, 1989, 1993
      5  1.12   mycroft  *	The Regents of the University of California.  All rights reserved.
      6  1.10       cgd  * (c) UNIX System Laboratories, Inc.
      7  1.10       cgd  * All or some portions of this file are derived from material licensed
      8  1.10       cgd  * to the University of California by American Telephone and Telegraph
      9  1.10       cgd  * Co. or Unix System Laboratories, Inc. and are reproduced herein with
     10  1.10       cgd  * the permission of UNIX System Laboratories, Inc.
     11  1.10       cgd  *
     12  1.10       cgd  * Redistribution and use in source and binary forms, with or without
     13  1.10       cgd  * modification, are permitted provided that the following conditions
     14  1.10       cgd  * are met:
     15  1.10       cgd  * 1. Redistributions of source code must retain the above copyright
     16  1.10       cgd  *    notice, this list of conditions and the following disclaimer.
     17  1.10       cgd  * 2. Redistributions in binary form must reproduce the above copyright
     18  1.10       cgd  *    notice, this list of conditions and the following disclaimer in the
     19  1.10       cgd  *    documentation and/or other materials provided with the distribution.
     20  1.10       cgd  * 3. All advertising materials mentioning features or use of this software
     21  1.10       cgd  *    must display the following acknowledgement:
     22  1.10       cgd  *	This product includes software developed by the University of
     23  1.10       cgd  *	California, Berkeley and its contributors.
     24  1.10       cgd  * 4. Neither the name of the University nor the names of its contributors
     25  1.10       cgd  *    may be used to endorse or promote products derived from this software
     26  1.10       cgd  *    without specific prior written permission.
     27  1.10       cgd  *
     28  1.10       cgd  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
     29  1.10       cgd  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
     30  1.10       cgd  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
     31  1.10       cgd  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
     32  1.10       cgd  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
     33  1.10       cgd  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
     34  1.10       cgd  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
     35  1.10       cgd  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
     36  1.10       cgd  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
     37  1.10       cgd  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
     38  1.10       cgd  * SUCH DAMAGE.
     39  1.10       cgd  *
     40  1.26      fvdl  *	@(#)vfs_lookup.c	8.10 (Berkeley) 5/27/95
     41  1.10       cgd  */
     42  1.38     lukem 
     43  1.38     lukem #include <sys/cdefs.h>
     44  1.45       erh __KERNEL_RCSID(0, "$NetBSD: vfs_lookup.c,v 1.45 2003/04/10 07:26:52 erh Exp $");
     45  1.27   thorpej 
     46  1.27   thorpej #include "opt_ktrace.h"
     47  1.10       cgd 
     48  1.10       cgd #include <sys/param.h>
     49  1.15       cgd #include <sys/systm.h>
     50  1.10       cgd #include <sys/syslimits.h>
     51  1.10       cgd #include <sys/time.h>
     52  1.10       cgd #include <sys/namei.h>
     53  1.10       cgd #include <sys/vnode.h>
     54  1.10       cgd #include <sys/mount.h>
     55  1.10       cgd #include <sys/errno.h>
     56  1.39     lukem #include <sys/filedesc.h>
     57  1.39     lukem #include <sys/hash.h>
     58  1.10       cgd #include <sys/malloc.h>
     59  1.10       cgd #include <sys/proc.h>
     60  1.40  wrstuden #include <sys/syslog.h>
     61  1.12   mycroft 
     62  1.10       cgd #ifdef KTRACE
     63  1.10       cgd #include <sys/ktrace.h>
     64  1.10       cgd #endif
     65  1.16  christos 
     66  1.35   thorpej struct pool pnbuf_pool;		/* pathname buffer pool */
     67  1.37   thorpej struct pool_cache pnbuf_cache;	/* pathname buffer cache */
     68  1.44   thorpej 
     69  1.44   thorpej MALLOC_DEFINE(M_NAMEI, "namei", "namei path buffer");
     70  1.35   thorpej 
     71  1.10       cgd /*
     72  1.10       cgd  * Convert a pathname into a pointer to a locked inode.
     73  1.10       cgd  *
     74  1.10       cgd  * The FOLLOW flag is set when symbolic links are to be followed
     75  1.10       cgd  * when they occur at the end of the name translation process.
     76  1.10       cgd  * Symbolic links are always followed for all other pathname
     77  1.10       cgd  * components other than the last.
     78  1.10       cgd  *
     79  1.10       cgd  * The segflg defines whether the name is to be copied from user
     80  1.10       cgd  * space or kernel space.
     81  1.10       cgd  *
     82  1.10       cgd  * Overall outline of namei:
     83  1.10       cgd  *
     84  1.10       cgd  *	copy in name
     85  1.10       cgd  *	get starting directory
     86  1.10       cgd  *	while (!done && !error) {
     87  1.10       cgd  *		call lookup to search path.
     88  1.10       cgd  *		if symbolic link, massage name in buffer and continue
     89  1.10       cgd  *	}
     90  1.10       cgd  */
     91  1.12   mycroft int
     92  1.12   mycroft namei(ndp)
     93  1.33  augustss 	struct nameidata *ndp;
     94  1.10       cgd {
     95  1.30   thorpej 	struct cwdinfo *cwdi;		/* pointer to cwd state */
     96  1.33  augustss 	char *cp;			/* pointer into pathname argument */
     97  1.33  augustss 	struct vnode *dp;		/* the directory we are searching */
     98  1.10       cgd 	struct iovec aiov;		/* uio for reading symbolic links */
     99  1.10       cgd 	struct uio auio;
    100  1.23   mycroft 	int error, linklen;
    101  1.12   mycroft 	struct componentname *cnp = &ndp->ni_cnd;
    102  1.10       cgd 
    103  1.12   mycroft #ifdef DIAGNOSTIC
    104  1.12   mycroft 	if (!cnp->cn_cred || !cnp->cn_proc)
    105  1.12   mycroft 		panic ("namei: bad cred/proc");
    106  1.12   mycroft 	if (cnp->cn_nameiop & (~OPMASK))
    107  1.12   mycroft 		panic ("namei: nameiop contaminated with flags");
    108  1.12   mycroft 	if (cnp->cn_flags & OPMASK)
    109  1.12   mycroft 		panic ("namei: flags contaminated with nameiops");
    110  1.12   mycroft #endif
    111  1.30   thorpej 	cwdi = cnp->cn_proc->p_cwdi;
    112  1.10       cgd 
    113  1.10       cgd 	/*
    114  1.10       cgd 	 * Get a buffer for the name to be translated, and copy the
    115  1.10       cgd 	 * name into the buffer.
    116  1.10       cgd 	 */
    117  1.12   mycroft 	if ((cnp->cn_flags & HASBUF) == 0)
    118  1.35   thorpej 		cnp->cn_pnbuf = PNBUF_GET();
    119  1.10       cgd 	if (ndp->ni_segflg == UIO_SYSSPACE)
    120  1.12   mycroft 		error = copystr(ndp->ni_dirp, cnp->cn_pnbuf,
    121  1.10       cgd 			    MAXPATHLEN, &ndp->ni_pathlen);
    122  1.10       cgd 	else
    123  1.12   mycroft 		error = copyinstr(ndp->ni_dirp, cnp->cn_pnbuf,
    124  1.10       cgd 			    MAXPATHLEN, &ndp->ni_pathlen);
    125  1.21    kleink 
    126  1.21    kleink 	/*
    127  1.21    kleink 	 * POSIX.1 requirement: "" is not a valid file name.
    128  1.21    kleink 	 */
    129  1.21    kleink 	if (!error && ndp->ni_pathlen == 1)
    130  1.21    kleink 		error = ENOENT;
    131  1.21    kleink 
    132  1.10       cgd 	if (error) {
    133  1.35   thorpej 		PNBUF_PUT(cnp->cn_pnbuf);
    134  1.10       cgd 		ndp->ni_vp = NULL;
    135  1.10       cgd 		return (error);
    136  1.10       cgd 	}
    137  1.10       cgd 	ndp->ni_loopcnt = 0;
    138  1.21    kleink 
    139  1.10       cgd #ifdef KTRACE
    140  1.12   mycroft 	if (KTRPOINT(cnp->cn_proc, KTR_NAMEI))
    141  1.34  sommerfe 		ktrnamei(cnp->cn_proc, cnp->cn_pnbuf);
    142  1.10       cgd #endif
    143  1.10       cgd 
    144  1.10       cgd 	/*
    145  1.10       cgd 	 * Get starting point for the translation.
    146  1.10       cgd 	 */
    147  1.30   thorpej 	if ((ndp->ni_rootdir = cwdi->cwdi_rdir) == NULL)
    148  1.11       cgd 		ndp->ni_rootdir = rootvnode;
    149  1.23   mycroft 	/*
    150  1.23   mycroft 	 * Check if starting from root directory or current directory.
    151  1.23   mycroft 	 */
    152  1.23   mycroft 	if (cnp->cn_pnbuf[0] == '/') {
    153  1.23   mycroft 		dp = ndp->ni_rootdir;
    154  1.23   mycroft 		VREF(dp);
    155  1.23   mycroft 	} else {
    156  1.30   thorpej 		dp = cwdi->cwdi_cdir;
    157  1.23   mycroft 		VREF(dp);
    158  1.23   mycroft 	}
    159  1.10       cgd 	for (;;) {
    160  1.45       erh 		if (!dp->v_mount)
    161  1.45       erh 		{
    162  1.45       erh 			/* Give up if the directory is no longer mounted */
    163  1.45       erh 			PNBUF_PUT(cnp->cn_pnbuf);
    164  1.45       erh 			return (ENOENT);
    165  1.45       erh 		}
    166  1.12   mycroft 		cnp->cn_nameptr = cnp->cn_pnbuf;
    167  1.10       cgd 		ndp->ni_startdir = dp;
    168  1.16  christos 		if ((error = lookup(ndp)) != 0) {
    169  1.35   thorpej 			PNBUF_PUT(cnp->cn_pnbuf);
    170  1.10       cgd 			return (error);
    171  1.10       cgd 		}
    172  1.10       cgd 		/*
    173  1.10       cgd 		 * Check for symbolic link
    174  1.10       cgd 		 */
    175  1.12   mycroft 		if ((cnp->cn_flags & ISSYMLINK) == 0) {
    176  1.12   mycroft 			if ((cnp->cn_flags & (SAVENAME | SAVESTART)) == 0)
    177  1.35   thorpej 				PNBUF_PUT(cnp->cn_pnbuf);
    178  1.10       cgd 			else
    179  1.12   mycroft 				cnp->cn_flags |= HASBUF;
    180  1.10       cgd 			return (0);
    181  1.10       cgd 		}
    182  1.29  wrstuden 		if ((cnp->cn_flags & LOCKPARENT) && (cnp->cn_flags & ISLASTCN))
    183  1.26      fvdl 			VOP_UNLOCK(ndp->ni_dvp, 0);
    184  1.10       cgd 		if (ndp->ni_loopcnt++ >= MAXSYMLINKS) {
    185  1.10       cgd 			error = ELOOP;
    186  1.10       cgd 			break;
    187  1.10       cgd 		}
    188  1.25     enami 		if (ndp->ni_vp->v_mount->mnt_flag & MNT_SYMPERM) {
    189  1.25     enami 			error = VOP_ACCESS(ndp->ni_vp, VEXEC, cnp->cn_cred,
    190  1.25     enami 			    cnp->cn_proc);
    191  1.25     enami 			if (error != 0)
    192  1.25     enami 				break;
    193  1.25     enami 		}
    194  1.10       cgd 		if (ndp->ni_pathlen > 1)
    195  1.35   thorpej 			cp = PNBUF_GET();
    196  1.10       cgd 		else
    197  1.12   mycroft 			cp = cnp->cn_pnbuf;
    198  1.10       cgd 		aiov.iov_base = cp;
    199  1.10       cgd 		aiov.iov_len = MAXPATHLEN;
    200  1.10       cgd 		auio.uio_iov = &aiov;
    201  1.10       cgd 		auio.uio_iovcnt = 1;
    202  1.10       cgd 		auio.uio_offset = 0;
    203  1.10       cgd 		auio.uio_rw = UIO_READ;
    204  1.10       cgd 		auio.uio_segflg = UIO_SYSSPACE;
    205  1.10       cgd 		auio.uio_procp = (struct proc *)0;
    206  1.10       cgd 		auio.uio_resid = MAXPATHLEN;
    207  1.16  christos 		error = VOP_READLINK(ndp->ni_vp, &auio, cnp->cn_cred);
    208  1.16  christos 		if (error) {
    209  1.23   mycroft 		badlink:
    210  1.10       cgd 			if (ndp->ni_pathlen > 1)
    211  1.35   thorpej 				PNBUF_PUT(cp);
    212  1.10       cgd 			break;
    213  1.10       cgd 		}
    214  1.10       cgd 		linklen = MAXPATHLEN - auio.uio_resid;
    215  1.23   mycroft 		if (linklen == 0) {
    216  1.23   mycroft 			error = ENOENT;
    217  1.23   mycroft 			goto badlink;
    218  1.23   mycroft 		}
    219  1.10       cgd 		if (linklen + ndp->ni_pathlen >= MAXPATHLEN) {
    220  1.10       cgd 			error = ENAMETOOLONG;
    221  1.23   mycroft 			goto badlink;
    222  1.10       cgd 		}
    223  1.10       cgd 		if (ndp->ni_pathlen > 1) {
    224  1.28     perry 			memcpy(cp + linklen, ndp->ni_next, ndp->ni_pathlen);
    225  1.35   thorpej 			PNBUF_PUT(cnp->cn_pnbuf);
    226  1.12   mycroft 			cnp->cn_pnbuf = cp;
    227  1.10       cgd 		} else
    228  1.12   mycroft 			cnp->cn_pnbuf[linklen] = '\0';
    229  1.10       cgd 		ndp->ni_pathlen += linklen;
    230  1.10       cgd 		vput(ndp->ni_vp);
    231  1.10       cgd 		dp = ndp->ni_dvp;
    232  1.23   mycroft 		/*
    233  1.23   mycroft 		 * Check if root directory should replace current directory.
    234  1.23   mycroft 		 */
    235  1.23   mycroft 		if (cnp->cn_pnbuf[0] == '/') {
    236  1.23   mycroft 			vrele(dp);
    237  1.23   mycroft 			dp = ndp->ni_rootdir;
    238  1.23   mycroft 			VREF(dp);
    239  1.23   mycroft 		}
    240  1.10       cgd 	}
    241  1.35   thorpej 	PNBUF_PUT(cnp->cn_pnbuf);
    242  1.10       cgd 	vrele(ndp->ni_dvp);
    243  1.10       cgd 	vput(ndp->ni_vp);
    244  1.10       cgd 	ndp->ni_vp = NULL;
    245  1.10       cgd 	return (error);
    246  1.10       cgd }
    247  1.10       cgd 
    248  1.10       cgd /*
    249  1.39     lukem  * Determine the namei hash (for cn_hash) for name.
    250  1.39     lukem  * If *ep != NULL, hash from name to ep-1.
    251  1.39     lukem  * If *ep == NULL, hash from name until the first NUL or '/', and
    252  1.39     lukem  * return the location of this termination character in *ep.
    253  1.39     lukem  *
    254  1.39     lukem  * This function returns an equivalent hash to the MI hash32_strn().
    255  1.39     lukem  * The latter isn't used because in the *ep == NULL case, determining
    256  1.39     lukem  * the length of the string to the first NUL or `/' and then calling
    257  1.39     lukem  * hash32_strn() involves unnecessary double-handling of the data.
    258  1.39     lukem  */
    259  1.39     lukem uint32_t
    260  1.39     lukem namei_hash(const char *name, const char **ep)
    261  1.39     lukem {
    262  1.39     lukem 	uint32_t	hash;
    263  1.39     lukem 
    264  1.39     lukem 	hash = HASH32_STR_INIT;
    265  1.39     lukem 	if (*ep != NULL) {
    266  1.39     lukem 		for (; name < *ep; name++)
    267  1.39     lukem 			hash = hash * 33 + *(uint8_t *)name;
    268  1.39     lukem 	} else {
    269  1.39     lukem 		for (; *name != '\0' && *name != '/'; name++)
    270  1.39     lukem 			hash = hash * 33 + *(uint8_t *)name;
    271  1.39     lukem 		*ep = name;
    272  1.39     lukem 	}
    273  1.39     lukem 	return (hash + (hash >> 5));
    274  1.39     lukem }
    275  1.39     lukem 
    276  1.39     lukem /*
    277  1.10       cgd  * Search a pathname.
    278  1.10       cgd  * This is a very central and rather complicated routine.
    279  1.10       cgd  *
    280  1.10       cgd  * The pathname is pointed to by ni_ptr and is of length ni_pathlen.
    281  1.10       cgd  * The starting directory is taken from ni_startdir. The pathname is
    282  1.10       cgd  * descended until done, or a symbolic link is encountered. The variable
    283  1.10       cgd  * ni_more is clear if the path is completed; it is set to one if a
    284  1.10       cgd  * symbolic link needing interpretation is encountered.
    285  1.10       cgd  *
    286  1.10       cgd  * The flag argument is LOOKUP, CREATE, RENAME, or DELETE depending on
    287  1.10       cgd  * whether the name is to be looked up, created, renamed, or deleted.
    288  1.10       cgd  * When CREATE, RENAME, or DELETE is specified, information usable in
    289  1.10       cgd  * creating, renaming, or deleting a directory entry may be calculated.
    290  1.10       cgd  * If flag has LOCKPARENT or'ed into it, the parent directory is returned
    291  1.10       cgd  * locked. If flag has WANTPARENT or'ed into it, the parent directory is
    292  1.10       cgd  * returned unlocked. Otherwise the parent directory is not returned. If
    293  1.10       cgd  * the target of the pathname exists and LOCKLEAF is or'ed into the flag
    294  1.10       cgd  * the target is returned locked, otherwise it is returned unlocked.
    295  1.10       cgd  * When creating or renaming and LOCKPARENT is specified, the target may not
    296  1.10       cgd  * be ".".  When deleting and LOCKPARENT is specified, the target may be ".".
    297  1.10       cgd  *
    298  1.10       cgd  * Overall outline of lookup:
    299  1.10       cgd  *
    300  1.10       cgd  * dirloop:
    301  1.10       cgd  *	identify next component of name at ndp->ni_ptr
    302  1.10       cgd  *	handle degenerate case where name is null string
    303  1.10       cgd  *	if .. and crossing mount points and on mounted filesys, find parent
    304  1.10       cgd  *	call VOP_LOOKUP routine for next component name
    305  1.10       cgd  *	    directory vnode returned in ni_dvp, unlocked unless LOCKPARENT set
    306  1.10       cgd  *	    component vnode returned in ni_vp (if it exists), locked.
    307  1.10       cgd  *	if result vnode is mounted on and crossing mount points,
    308  1.10       cgd  *	    find mounted on vnode
    309  1.10       cgd  *	if more components of name, do next level at dirloop
    310  1.10       cgd  *	return the answer in ni_vp, locked if LOCKLEAF set
    311  1.10       cgd  *	    if LOCKPARENT set, return locked parent in ni_dvp
    312  1.10       cgd  *	    if WANTPARENT set, return unlocked parent in ni_dvp
    313  1.10       cgd  */
    314  1.12   mycroft int
    315  1.12   mycroft lookup(ndp)
    316  1.33  augustss 	struct nameidata *ndp;
    317  1.10       cgd {
    318  1.33  augustss 	const char *cp;			/* pointer into pathname argument */
    319  1.33  augustss 	struct vnode *dp = 0;		/* the directory we are searching */
    320  1.10       cgd 	struct vnode *tdp;		/* saved dp */
    321  1.10       cgd 	struct mount *mp;		/* mount table entry */
    322  1.10       cgd 	int docache;			/* == 0 do not cache last component */
    323  1.10       cgd 	int wantparent;			/* 1 => wantparent or lockparent flag */
    324  1.12   mycroft 	int rdonly;			/* lookup read-only flag bit */
    325  1.10       cgd 	int error = 0;
    326  1.23   mycroft 	int slashes;
    327  1.32  wrstuden 	int dpunlocked = 0;		/* dp has already been unlocked */
    328  1.12   mycroft 	struct componentname *cnp = &ndp->ni_cnd;
    329  1.10       cgd 
    330  1.10       cgd 	/*
    331  1.10       cgd 	 * Setup: break out flag bits into variables.
    332  1.10       cgd 	 */
    333  1.12   mycroft 	wantparent = cnp->cn_flags & (LOCKPARENT | WANTPARENT);
    334  1.12   mycroft 	docache = (cnp->cn_flags & NOCACHE) ^ NOCACHE;
    335  1.12   mycroft 	if (cnp->cn_nameiop == DELETE ||
    336  1.12   mycroft 	    (wantparent && cnp->cn_nameiop != CREATE))
    337  1.10       cgd 		docache = 0;
    338  1.12   mycroft 	rdonly = cnp->cn_flags & RDONLY;
    339  1.10       cgd 	ndp->ni_dvp = NULL;
    340  1.12   mycroft 	cnp->cn_flags &= ~ISSYMLINK;
    341  1.10       cgd 	dp = ndp->ni_startdir;
    342  1.10       cgd 	ndp->ni_startdir = NULLVP;
    343  1.26      fvdl 	vn_lock(dp, LK_EXCLUSIVE | LK_RETRY);
    344  1.10       cgd 
    345  1.23   mycroft 	/*
    346  1.23   mycroft 	 * If we have a leading string of slashes, remove them, and just make
    347  1.23   mycroft 	 * sure the current node is a directory.
    348  1.23   mycroft 	 */
    349  1.23   mycroft 	cp = cnp->cn_nameptr;
    350  1.23   mycroft 	if (*cp == '/') {
    351  1.23   mycroft 		do {
    352  1.23   mycroft 			cp++;
    353  1.23   mycroft 		} while (*cp == '/');
    354  1.23   mycroft 		ndp->ni_pathlen -= cp - cnp->cn_nameptr;
    355  1.23   mycroft 		cnp->cn_nameptr = cp;
    356  1.23   mycroft 
    357  1.23   mycroft 		if (dp->v_type != VDIR) {
    358  1.23   mycroft 			error = ENOTDIR;
    359  1.23   mycroft 			goto bad;
    360  1.23   mycroft 		}
    361  1.23   mycroft 
    362  1.23   mycroft 		/*
    363  1.23   mycroft 		 * If we've exhausted the path name, then just return the
    364  1.23   mycroft 		 * current node.  If the caller requested the parent node (i.e.
    365  1.23   mycroft 		 * it's a CREATE, DELETE, or RENAME), and we don't have one
    366  1.23   mycroft 		 * (because this is the root directory), then we must fail.
    367  1.23   mycroft 		 */
    368  1.23   mycroft 		if (cnp->cn_nameptr[0] == '\0') {
    369  1.23   mycroft 			if (ndp->ni_dvp == NULL && wantparent) {
    370  1.23   mycroft 				error = EISDIR;
    371  1.23   mycroft 				goto bad;
    372  1.23   mycroft 			}
    373  1.23   mycroft 			ndp->ni_vp = dp;
    374  1.23   mycroft 			cnp->cn_flags |= ISLASTCN;
    375  1.23   mycroft 			goto terminal;
    376  1.23   mycroft 		}
    377  1.23   mycroft 	}
    378  1.23   mycroft 
    379  1.10       cgd dirloop:
    380  1.10       cgd 	/*
    381  1.10       cgd 	 * Search a new directory.
    382  1.10       cgd 	 *
    383  1.12   mycroft 	 * The cn_hash value is for use by vfs_cache.
    384  1.10       cgd 	 * The last component of the filename is left accessible via
    385  1.12   mycroft 	 * cnp->cn_nameptr for callers that need the name. Callers needing
    386  1.10       cgd 	 * the name set the SAVENAME flag. When done, they assume
    387  1.10       cgd 	 * responsibility for freeing the pathname buffer.
    388  1.10       cgd 	 */
    389  1.12   mycroft 	cnp->cn_consume = 0;
    390  1.39     lukem 	cp = NULL;
    391  1.39     lukem 	cnp->cn_hash = namei_hash(cnp->cn_nameptr, &cp);
    392  1.12   mycroft 	cnp->cn_namelen = cp - cnp->cn_nameptr;
    393  1.12   mycroft 	if (cnp->cn_namelen > NAME_MAX) {
    394  1.10       cgd 		error = ENAMETOOLONG;
    395  1.10       cgd 		goto bad;
    396  1.10       cgd 	}
    397  1.10       cgd #ifdef NAMEI_DIAGNOSTIC
    398  1.10       cgd 	{ char c = *cp;
    399  1.41     soren 	*(char *)cp = '\0';
    400  1.19  christos 	printf("{%s}: ", cnp->cn_nameptr);
    401  1.41     soren 	*(char *)cp = c; }
    402  1.10       cgd #endif
    403  1.12   mycroft 	ndp->ni_pathlen -= cnp->cn_namelen;
    404  1.10       cgd 	ndp->ni_next = cp;
    405  1.23   mycroft 	/*
    406  1.23   mycroft 	 * If this component is followed by a slash, then move the pointer to
    407  1.23   mycroft 	 * the next component forward, and remember that this component must be
    408  1.23   mycroft 	 * a directory.
    409  1.23   mycroft 	 */
    410  1.23   mycroft 	if (*cp == '/') {
    411  1.23   mycroft 		do {
    412  1.23   mycroft 			cp++;
    413  1.23   mycroft 		} while (*cp == '/');
    414  1.23   mycroft 		slashes = cp - ndp->ni_next;
    415  1.23   mycroft 		ndp->ni_pathlen -= slashes;
    416  1.23   mycroft 		ndp->ni_next = cp;
    417  1.23   mycroft 		cnp->cn_flags |= REQUIREDIR;
    418  1.23   mycroft 	} else {
    419  1.23   mycroft 		slashes = 0;
    420  1.23   mycroft 		cnp->cn_flags &= ~REQUIREDIR;
    421  1.23   mycroft 	}
    422  1.23   mycroft 	/*
    423  1.23   mycroft 	 * We do special processing on the last component, whether or not it's
    424  1.23   mycroft 	 * a directory.  Cache all intervening lookups, but not the final one.
    425  1.23   mycroft 	 */
    426  1.23   mycroft 	if (*cp == '\0') {
    427  1.23   mycroft 		if (docache)
    428  1.23   mycroft 			cnp->cn_flags |= MAKEENTRY;
    429  1.23   mycroft 		else
    430  1.23   mycroft 			cnp->cn_flags &= ~MAKEENTRY;
    431  1.23   mycroft 		cnp->cn_flags |= ISLASTCN;
    432  1.23   mycroft 	} else {
    433  1.23   mycroft 		cnp->cn_flags |= MAKEENTRY;
    434  1.23   mycroft 		cnp->cn_flags &= ~ISLASTCN;
    435  1.23   mycroft 	}
    436  1.12   mycroft 	if (cnp->cn_namelen == 2 &&
    437  1.12   mycroft 	    cnp->cn_nameptr[1] == '.' && cnp->cn_nameptr[0] == '.')
    438  1.12   mycroft 		cnp->cn_flags |= ISDOTDOT;
    439  1.12   mycroft 	else
    440  1.12   mycroft 		cnp->cn_flags &= ~ISDOTDOT;
    441  1.10       cgd 
    442  1.10       cgd 	/*
    443  1.10       cgd 	 * Handle "..": two special cases.
    444  1.10       cgd 	 * 1. If at root directory (e.g. after chroot)
    445  1.12   mycroft 	 *    or at absolute root directory
    446  1.10       cgd 	 *    then ignore it so can't get out.
    447  1.40  wrstuden 	 * 1a. If we have somehow gotten out of a jail, warn
    448  1.40  wrstuden 	 *    and also ignore it so we can't get farther out.
    449  1.10       cgd 	 * 2. If this vnode is the root of a mounted
    450  1.10       cgd 	 *    filesystem, then replace it with the
    451  1.10       cgd 	 *    vnode which was mounted on so we take the
    452  1.10       cgd 	 *    .. in the other file system.
    453  1.10       cgd 	 */
    454  1.12   mycroft 	if (cnp->cn_flags & ISDOTDOT) {
    455  1.10       cgd 		for (;;) {
    456  1.12   mycroft 			if (dp == ndp->ni_rootdir || dp == rootvnode) {
    457  1.10       cgd 				ndp->ni_dvp = dp;
    458  1.10       cgd 				ndp->ni_vp = dp;
    459  1.10       cgd 				VREF(dp);
    460  1.10       cgd 				goto nextname;
    461  1.40  wrstuden 			}
    462  1.40  wrstuden 			if (ndp->ni_rootdir != rootvnode) {
    463  1.40  wrstuden 				int retval;
    464  1.40  wrstuden 				VOP_UNLOCK(dp, 0);
    465  1.40  wrstuden 				retval = vn_isunder(dp, ndp->ni_rootdir,
    466  1.40  wrstuden 				    cnp->cn_proc);
    467  1.40  wrstuden 				vn_lock(dp, LK_EXCLUSIVE | LK_RETRY);
    468  1.40  wrstuden 				if (!retval) {
    469  1.40  wrstuden 				    /* Oops! We got out of jail! */
    470  1.40  wrstuden 				    log(LOG_WARNING,
    471  1.40  wrstuden 					"chrooted pid %d uid %d (%s) "
    472  1.40  wrstuden 					"detected outside of its chroot\n",
    473  1.40  wrstuden 					cnp->cn_proc->p_pid,
    474  1.40  wrstuden 					cnp->cn_proc->p_ucred->cr_uid,
    475  1.40  wrstuden 					cnp->cn_proc->p_comm);
    476  1.40  wrstuden 				    /* Put us at the jail root. */
    477  1.40  wrstuden 				    vput(dp);
    478  1.40  wrstuden 				    dp = ndp->ni_rootdir;
    479  1.40  wrstuden 				    ndp->ni_dvp = dp;
    480  1.40  wrstuden 				    ndp->ni_vp = dp;
    481  1.40  wrstuden 				    VREF(dp);
    482  1.40  wrstuden 				    VREF(dp);
    483  1.40  wrstuden 				    vn_lock(dp, LK_EXCLUSIVE | LK_RETRY);
    484  1.40  wrstuden 				    goto nextname;
    485  1.40  wrstuden 				}
    486  1.10       cgd 			}
    487  1.10       cgd 			if ((dp->v_flag & VROOT) == 0 ||
    488  1.12   mycroft 			    (cnp->cn_flags & NOCROSSMOUNT))
    489  1.10       cgd 				break;
    490  1.10       cgd 			tdp = dp;
    491  1.10       cgd 			dp = dp->v_mount->mnt_vnodecovered;
    492  1.10       cgd 			vput(tdp);
    493  1.10       cgd 			VREF(dp);
    494  1.26      fvdl 			vn_lock(dp, LK_EXCLUSIVE | LK_RETRY);
    495  1.10       cgd 		}
    496  1.10       cgd 	}
    497  1.10       cgd 
    498  1.10       cgd 	/*
    499  1.10       cgd 	 * We now have a segment name to search for, and a directory to search.
    500  1.10       cgd 	 */
    501  1.12   mycroft unionlookup:
    502  1.12   mycroft 	ndp->ni_dvp = dp;
    503  1.26      fvdl 	ndp->ni_vp = NULL;
    504  1.31  wrstuden 	cnp->cn_flags &= ~PDIRUNLOCK;
    505  1.16  christos 	if ((error = VOP_LOOKUP(dp, &ndp->ni_vp, cnp)) != 0) {
    506  1.10       cgd #ifdef DIAGNOSTIC
    507  1.10       cgd 		if (ndp->ni_vp != NULL)
    508  1.43  christos 			panic("leaf `%s' should be empty", cnp->cn_nameptr);
    509  1.10       cgd #endif
    510  1.10       cgd #ifdef NAMEI_DIAGNOSTIC
    511  1.19  christos 		printf("not found\n");
    512  1.10       cgd #endif
    513  1.12   mycroft 		if ((error == ENOENT) &&
    514  1.10       cgd 		    (dp->v_flag & VROOT) &&
    515  1.10       cgd 		    (dp->v_mount->mnt_flag & MNT_UNION)) {
    516  1.10       cgd 			tdp = dp;
    517  1.10       cgd 			dp = dp->v_mount->mnt_vnodecovered;
    518  1.31  wrstuden 			if (cnp->cn_flags & PDIRUNLOCK)
    519  1.31  wrstuden 				vrele(tdp);
    520  1.31  wrstuden 			else
    521  1.31  wrstuden 				vput(tdp);
    522  1.10       cgd 			VREF(dp);
    523  1.26      fvdl 			vn_lock(dp, LK_EXCLUSIVE | LK_RETRY);
    524  1.12   mycroft 			goto unionlookup;
    525  1.10       cgd 		}
    526  1.12   mycroft 
    527  1.10       cgd 		if (error != EJUSTRETURN)
    528  1.10       cgd 			goto bad;
    529  1.10       cgd 		/*
    530  1.23   mycroft 		 * If this was not the last component, or there were trailing
    531  1.23   mycroft 		 * slashes, then the name must exist.
    532  1.23   mycroft 		 */
    533  1.23   mycroft 		if (cnp->cn_flags & REQUIREDIR) {
    534  1.23   mycroft 			error = ENOENT;
    535  1.23   mycroft 			goto bad;
    536  1.23   mycroft 		}
    537  1.23   mycroft 		/*
    538  1.10       cgd 		 * If creating and at end of pathname, then can consider
    539  1.10       cgd 		 * allowing file to be created.
    540  1.10       cgd 		 */
    541  1.26      fvdl 		if (rdonly) {
    542  1.10       cgd 			error = EROFS;
    543  1.10       cgd 			goto bad;
    544  1.10       cgd 		}
    545  1.10       cgd 		/*
    546  1.10       cgd 		 * We return with ni_vp NULL to indicate that the entry
    547  1.10       cgd 		 * doesn't currently exist, leaving a pointer to the
    548  1.10       cgd 		 * (possibly locked) directory inode in ndp->ni_dvp.
    549  1.10       cgd 		 */
    550  1.12   mycroft 		if (cnp->cn_flags & SAVESTART) {
    551  1.10       cgd 			ndp->ni_startdir = ndp->ni_dvp;
    552  1.10       cgd 			VREF(ndp->ni_startdir);
    553  1.10       cgd 		}
    554  1.10       cgd 		return (0);
    555  1.10       cgd 	}
    556  1.10       cgd #ifdef NAMEI_DIAGNOSTIC
    557  1.19  christos 	printf("found\n");
    558  1.10       cgd #endif
    559  1.10       cgd 
    560  1.12   mycroft 	/*
    561  1.23   mycroft 	 * Take into account any additional components consumed by the
    562  1.23   mycroft 	 * underlying filesystem.  This will include any trailing slashes after
    563  1.23   mycroft 	 * the last component consumed.
    564  1.12   mycroft 	 */
    565  1.12   mycroft 	if (cnp->cn_consume > 0) {
    566  1.23   mycroft 		ndp->ni_pathlen -= cnp->cn_consume - slashes;
    567  1.23   mycroft 		ndp->ni_next += cnp->cn_consume - slashes;
    568  1.12   mycroft 		cnp->cn_consume = 0;
    569  1.23   mycroft 		if (ndp->ni_next[0] == '\0')
    570  1.23   mycroft 			cnp->cn_flags |= ISLASTCN;
    571  1.12   mycroft 	}
    572  1.12   mycroft 
    573  1.10       cgd 	dp = ndp->ni_vp;
    574  1.10       cgd 	/*
    575  1.10       cgd 	 * Check to see if the vnode has been mounted on;
    576  1.10       cgd 	 * if so find the root of the mounted file system.
    577  1.10       cgd 	 */
    578  1.10       cgd 	while (dp->v_type == VDIR && (mp = dp->v_mountedhere) &&
    579  1.12   mycroft 	       (cnp->cn_flags & NOCROSSMOUNT) == 0) {
    580  1.26      fvdl 		if (vfs_busy(mp, 0, 0))
    581  1.12   mycroft 			continue;
    582  1.32  wrstuden 		VOP_UNLOCK(dp, 0);
    583  1.26      fvdl 		error = VFS_ROOT(mp, &tdp);
    584  1.26      fvdl 		vfs_unbusy(mp);
    585  1.32  wrstuden 		if (error) {
    586  1.32  wrstuden 			dpunlocked = 1;
    587  1.10       cgd 			goto bad2;
    588  1.32  wrstuden 		}
    589  1.32  wrstuden 		vrele(dp);
    590  1.10       cgd 		ndp->ni_vp = dp = tdp;
    591  1.14   mycroft 	}
    592  1.14   mycroft 
    593  1.14   mycroft 	/*
    594  1.23   mycroft 	 * Check for symbolic link.  Back up over any slashes that we skipped,
    595  1.23   mycroft 	 * as we will need them again.
    596  1.14   mycroft 	 */
    597  1.23   mycroft 	if ((dp->v_type == VLNK) && (cnp->cn_flags & (FOLLOW|REQUIREDIR))) {
    598  1.23   mycroft 		ndp->ni_pathlen += slashes;
    599  1.23   mycroft 		ndp->ni_next -= slashes;
    600  1.14   mycroft 		cnp->cn_flags |= ISSYMLINK;
    601  1.14   mycroft 		return (0);
    602  1.10       cgd 	}
    603  1.10       cgd 
    604  1.23   mycroft 	/*
    605  1.23   mycroft 	 * Check for directory, if the component was followed by a series of
    606  1.23   mycroft 	 * slashes.
    607  1.23   mycroft 	 */
    608  1.23   mycroft 	if ((dp->v_type != VDIR) && (cnp->cn_flags & REQUIREDIR)) {
    609  1.23   mycroft 		error = ENOTDIR;
    610  1.23   mycroft 		goto bad2;
    611  1.23   mycroft 	}
    612  1.23   mycroft 
    613  1.10       cgd nextname:
    614  1.10       cgd 	/*
    615  1.23   mycroft 	 * Not a symbolic link.  If this was not the last component, then
    616  1.23   mycroft 	 * continue at the next component, else return.
    617  1.10       cgd 	 */
    618  1.23   mycroft 	if (!(cnp->cn_flags & ISLASTCN)) {
    619  1.12   mycroft 		cnp->cn_nameptr = ndp->ni_next;
    620  1.10       cgd 		vrele(ndp->ni_dvp);
    621  1.10       cgd 		goto dirloop;
    622  1.10       cgd 	}
    623  1.23   mycroft 
    624  1.23   mycroft terminal:
    625  1.10       cgd 	/*
    626  1.26      fvdl 	 * Disallow directory write attempts on read-only file systems.
    627  1.10       cgd 	 */
    628  1.26      fvdl 	if (rdonly &&
    629  1.26      fvdl 	    (cnp->cn_nameiop == DELETE || cnp->cn_nameiop == RENAME)) {
    630  1.10       cgd 		/*
    631  1.10       cgd 		 * Disallow directory write attempts on read-only
    632  1.10       cgd 		 * file systems.
    633  1.10       cgd 		 */
    634  1.26      fvdl 		error = EROFS;
    635  1.26      fvdl 		goto bad2;
    636  1.10       cgd 	}
    637  1.23   mycroft 	if (ndp->ni_dvp != NULL) {
    638  1.23   mycroft 		if (cnp->cn_flags & SAVESTART) {
    639  1.23   mycroft 			ndp->ni_startdir = ndp->ni_dvp;
    640  1.23   mycroft 			VREF(ndp->ni_startdir);
    641  1.23   mycroft 		}
    642  1.23   mycroft 		if (!wantparent)
    643  1.23   mycroft 			vrele(ndp->ni_dvp);
    644  1.10       cgd 	}
    645  1.12   mycroft 	if ((cnp->cn_flags & LOCKLEAF) == 0)
    646  1.26      fvdl 		VOP_UNLOCK(dp, 0);
    647  1.10       cgd 	return (0);
    648  1.10       cgd 
    649  1.10       cgd bad2:
    650  1.31  wrstuden 	if ((cnp->cn_flags & LOCKPARENT) && (cnp->cn_flags & ISLASTCN) &&
    651  1.31  wrstuden 			((cnp->cn_flags & PDIRUNLOCK) == 0))
    652  1.26      fvdl 		VOP_UNLOCK(ndp->ni_dvp, 0);
    653  1.10       cgd 	vrele(ndp->ni_dvp);
    654  1.10       cgd bad:
    655  1.32  wrstuden 	if (dpunlocked)
    656  1.32  wrstuden 		vrele(dp);
    657  1.32  wrstuden 	else
    658  1.32  wrstuden 		vput(dp);
    659  1.10       cgd 	ndp->ni_vp = NULL;
    660  1.12   mycroft 	return (error);
    661  1.12   mycroft }
    662  1.12   mycroft 
    663  1.12   mycroft /*
    664  1.12   mycroft  * Reacquire a path name component.
    665  1.12   mycroft  */
    666  1.12   mycroft int
    667  1.12   mycroft relookup(dvp, vpp, cnp)
    668  1.12   mycroft 	struct vnode *dvp, **vpp;
    669  1.12   mycroft 	struct componentname *cnp;
    670  1.12   mycroft {
    671  1.26      fvdl 	struct vnode *dp = 0;		/* the directory we are searching */
    672  1.12   mycroft 	int wantparent;			/* 1 => wantparent or lockparent flag */
    673  1.12   mycroft 	int rdonly;			/* lookup read-only flag bit */
    674  1.12   mycroft 	int error = 0;
    675  1.12   mycroft #ifdef NAMEI_DIAGNOSTIC
    676  1.12   mycroft 	int newhash;			/* DEBUG: check name hash */
    677  1.41     soren 	const char *cp;			/* DEBUG: check name ptr/len */
    678  1.12   mycroft #endif
    679  1.12   mycroft 
    680  1.12   mycroft 	/*
    681  1.12   mycroft 	 * Setup: break out flag bits into variables.
    682  1.12   mycroft 	 */
    683  1.12   mycroft 	wantparent = cnp->cn_flags & (LOCKPARENT|WANTPARENT);
    684  1.12   mycroft 	rdonly = cnp->cn_flags & RDONLY;
    685  1.12   mycroft 	cnp->cn_flags &= ~ISSYMLINK;
    686  1.12   mycroft 	dp = dvp;
    687  1.26      fvdl 	vn_lock(dp, LK_EXCLUSIVE | LK_RETRY);
    688  1.12   mycroft 
    689  1.12   mycroft /* dirloop: */
    690  1.12   mycroft 	/*
    691  1.12   mycroft 	 * Search a new directory.
    692  1.12   mycroft 	 *
    693  1.12   mycroft 	 * The cn_hash value is for use by vfs_cache.
    694  1.12   mycroft 	 * The last component of the filename is left accessible via
    695  1.12   mycroft 	 * cnp->cn_nameptr for callers that need the name. Callers needing
    696  1.12   mycroft 	 * the name set the SAVENAME flag. When done, they assume
    697  1.12   mycroft 	 * responsibility for freeing the pathname buffer.
    698  1.12   mycroft 	 */
    699  1.12   mycroft #ifdef NAMEI_DIAGNOSTIC
    700  1.39     lukem 	cp = NULL;
    701  1.39     lukem 	newhash = namei_hash(cnp->cn_nameptr, &cp);
    702  1.12   mycroft 	if (newhash != cnp->cn_hash)
    703  1.12   mycroft 		panic("relookup: bad hash");
    704  1.12   mycroft 	if (cnp->cn_namelen != cp - cnp->cn_nameptr)
    705  1.12   mycroft 		panic ("relookup: bad len");
    706  1.12   mycroft 	if (*cp != 0)
    707  1.12   mycroft 		panic("relookup: not last component");
    708  1.19  christos 	printf("{%s}: ", cnp->cn_nameptr);
    709  1.12   mycroft #endif
    710  1.12   mycroft 
    711  1.12   mycroft 	/*
    712  1.12   mycroft 	 * Check for degenerate name (e.g. / or "")
    713  1.12   mycroft 	 * which is a way of talking about a directory,
    714  1.12   mycroft 	 * e.g. like "/." or ".".
    715  1.12   mycroft 	 */
    716  1.23   mycroft 	if (cnp->cn_nameptr[0] == '\0')
    717  1.23   mycroft 		panic("relookup: null name");
    718  1.12   mycroft 
    719  1.12   mycroft 	if (cnp->cn_flags & ISDOTDOT)
    720  1.12   mycroft 		panic ("relookup: lookup on dot-dot");
    721  1.12   mycroft 
    722  1.12   mycroft 	/*
    723  1.12   mycroft 	 * We now have a segment name to search for, and a directory to search.
    724  1.12   mycroft 	 */
    725  1.16  christos 	if ((error = VOP_LOOKUP(dp, vpp, cnp)) != 0) {
    726  1.12   mycroft #ifdef DIAGNOSTIC
    727  1.12   mycroft 		if (*vpp != NULL)
    728  1.43  christos 			panic("leaf `%s' should be empty", cnp->cn_nameptr);
    729  1.12   mycroft #endif
    730  1.12   mycroft 		if (error != EJUSTRETURN)
    731  1.12   mycroft 			goto bad;
    732  1.12   mycroft 		/*
    733  1.12   mycroft 		 * If creating and at end of pathname, then can consider
    734  1.12   mycroft 		 * allowing file to be created.
    735  1.12   mycroft 		 */
    736  1.26      fvdl 		if (rdonly) {
    737  1.12   mycroft 			error = EROFS;
    738  1.12   mycroft 			goto bad;
    739  1.12   mycroft 		}
    740  1.12   mycroft 		/* ASSERT(dvp == ndp->ni_startdir) */
    741  1.12   mycroft 		if (cnp->cn_flags & SAVESTART)
    742  1.12   mycroft 			VREF(dvp);
    743  1.12   mycroft 		/*
    744  1.12   mycroft 		 * We return with ni_vp NULL to indicate that the entry
    745  1.12   mycroft 		 * doesn't currently exist, leaving a pointer to the
    746  1.12   mycroft 		 * (possibly locked) directory inode in ndp->ni_dvp.
    747  1.12   mycroft 		 */
    748  1.12   mycroft 		return (0);
    749  1.12   mycroft 	}
    750  1.12   mycroft 	dp = *vpp;
    751  1.12   mycroft 
    752  1.12   mycroft #ifdef DIAGNOSTIC
    753  1.12   mycroft 	/*
    754  1.12   mycroft 	 * Check for symbolic link
    755  1.12   mycroft 	 */
    756  1.12   mycroft 	if (dp->v_type == VLNK && (cnp->cn_flags & FOLLOW))
    757  1.12   mycroft 		panic ("relookup: symlink found.\n");
    758  1.12   mycroft #endif
    759  1.12   mycroft 
    760  1.12   mycroft 	/*
    761  1.12   mycroft 	 * Check for read-only file systems.
    762  1.12   mycroft 	 */
    763  1.26      fvdl 	if (rdonly &&
    764  1.26      fvdl 	    (cnp->cn_nameiop == DELETE || cnp->cn_nameiop == RENAME)) {
    765  1.26      fvdl 		error = EROFS;
    766  1.26      fvdl 		goto bad2;
    767  1.12   mycroft 	}
    768  1.12   mycroft 	/* ASSERT(dvp == ndp->ni_startdir) */
    769  1.12   mycroft 	if (cnp->cn_flags & SAVESTART)
    770  1.12   mycroft 		VREF(dvp);
    771  1.12   mycroft 	if (!wantparent)
    772  1.12   mycroft 		vrele(dvp);
    773  1.12   mycroft 	if ((cnp->cn_flags & LOCKLEAF) == 0)
    774  1.26      fvdl 		VOP_UNLOCK(dp, 0);
    775  1.12   mycroft 	return (0);
    776  1.12   mycroft 
    777  1.12   mycroft bad2:
    778  1.12   mycroft 	if ((cnp->cn_flags & LOCKPARENT) && (cnp->cn_flags & ISLASTCN))
    779  1.26      fvdl 		VOP_UNLOCK(dvp, 0);
    780  1.12   mycroft 	vrele(dvp);
    781  1.12   mycroft bad:
    782  1.12   mycroft 	vput(dp);
    783  1.12   mycroft 	*vpp = NULL;
    784  1.10       cgd 	return (error);
    785  1.10       cgd }
    786