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