Home | History | Annotate | Line # | Download | only in kern
vfs_lookup.c revision 1.65.2.1
      1  1.65.2.1      yamt /*	$NetBSD: vfs_lookup.c,v 1.65.2.1 2005/12/31 11:14:01 yamt 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.2.1      yamt __KERNEL_RCSID(0, "$NetBSD: vfs_lookup.c,v 1.65.2.1 2005/12/31 11:14:01 yamt 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_resid = MAXPATHLEN;
    316  1.65.2.1      yamt 		UIO_SETUP_SYSSPACE(&auio);
    317      1.16  christos 		error = VOP_READLINK(ndp->ni_vp, &auio, cnp->cn_cred);
    318      1.16  christos 		if (error) {
    319      1.23   mycroft 		badlink:
    320      1.10       cgd 			if (ndp->ni_pathlen > 1)
    321      1.35   thorpej 				PNBUF_PUT(cp);
    322      1.10       cgd 			break;
    323      1.10       cgd 		}
    324      1.10       cgd 		linklen = MAXPATHLEN - auio.uio_resid;
    325      1.23   mycroft 		if (linklen == 0) {
    326      1.23   mycroft 			error = ENOENT;
    327      1.23   mycroft 			goto badlink;
    328      1.23   mycroft 		}
    329      1.61   thorpej 		/*
    330      1.61   thorpej 		 * Do symlink substitution, if appropriate, and
    331      1.61   thorpej 		 * check length for potential overflow.
    332      1.61   thorpej 		 */
    333      1.61   thorpej 		if (((ndp->ni_vp->v_mount->mnt_flag & MNT_MAGICLINKS) &&
    334      1.64  christos 		     symlink_magic(cnp->cn_lwp->l_proc, cp, &linklen)) ||
    335      1.61   thorpej 		    (linklen + ndp->ni_pathlen >= MAXPATHLEN)) {
    336      1.10       cgd 			error = ENAMETOOLONG;
    337      1.23   mycroft 			goto badlink;
    338      1.10       cgd 		}
    339      1.10       cgd 		if (ndp->ni_pathlen > 1) {
    340      1.28     perry 			memcpy(cp + linklen, ndp->ni_next, ndp->ni_pathlen);
    341      1.35   thorpej 			PNBUF_PUT(cnp->cn_pnbuf);
    342      1.12   mycroft 			cnp->cn_pnbuf = cp;
    343      1.10       cgd 		} else
    344      1.12   mycroft 			cnp->cn_pnbuf[linklen] = '\0';
    345      1.10       cgd 		ndp->ni_pathlen += linklen;
    346      1.10       cgd 		vput(ndp->ni_vp);
    347      1.10       cgd 		dp = ndp->ni_dvp;
    348      1.23   mycroft 		/*
    349      1.23   mycroft 		 * Check if root directory should replace current directory.
    350      1.23   mycroft 		 */
    351      1.23   mycroft 		if (cnp->cn_pnbuf[0] == '/') {
    352      1.23   mycroft 			vrele(dp);
    353      1.23   mycroft 			dp = ndp->ni_rootdir;
    354      1.23   mycroft 			VREF(dp);
    355      1.23   mycroft 		}
    356      1.10       cgd 	}
    357      1.35   thorpej 	PNBUF_PUT(cnp->cn_pnbuf);
    358      1.10       cgd 	vrele(ndp->ni_dvp);
    359      1.10       cgd 	vput(ndp->ni_vp);
    360      1.10       cgd 	ndp->ni_vp = NULL;
    361      1.10       cgd 	return (error);
    362      1.10       cgd }
    363      1.10       cgd 
    364      1.10       cgd /*
    365      1.39     lukem  * Determine the namei hash (for cn_hash) for name.
    366      1.39     lukem  * If *ep != NULL, hash from name to ep-1.
    367      1.39     lukem  * If *ep == NULL, hash from name until the first NUL or '/', and
    368      1.39     lukem  * return the location of this termination character in *ep.
    369      1.39     lukem  *
    370      1.39     lukem  * This function returns an equivalent hash to the MI hash32_strn().
    371      1.39     lukem  * The latter isn't used because in the *ep == NULL case, determining
    372      1.39     lukem  * the length of the string to the first NUL or `/' and then calling
    373      1.39     lukem  * hash32_strn() involves unnecessary double-handling of the data.
    374      1.39     lukem  */
    375      1.39     lukem uint32_t
    376      1.39     lukem namei_hash(const char *name, const char **ep)
    377      1.39     lukem {
    378      1.39     lukem 	uint32_t	hash;
    379      1.39     lukem 
    380      1.39     lukem 	hash = HASH32_STR_INIT;
    381      1.39     lukem 	if (*ep != NULL) {
    382      1.39     lukem 		for (; name < *ep; name++)
    383      1.59  christos 			hash = hash * 33 + *(const uint8_t *)name;
    384      1.39     lukem 	} else {
    385      1.39     lukem 		for (; *name != '\0' && *name != '/'; name++)
    386      1.59  christos 			hash = hash * 33 + *(const uint8_t *)name;
    387      1.39     lukem 		*ep = name;
    388      1.39     lukem 	}
    389      1.39     lukem 	return (hash + (hash >> 5));
    390      1.39     lukem }
    391      1.39     lukem 
    392      1.39     lukem /*
    393      1.10       cgd  * Search a pathname.
    394      1.10       cgd  * This is a very central and rather complicated routine.
    395      1.10       cgd  *
    396      1.10       cgd  * The pathname is pointed to by ni_ptr and is of length ni_pathlen.
    397      1.10       cgd  * The starting directory is taken from ni_startdir. The pathname is
    398      1.10       cgd  * descended until done, or a symbolic link is encountered. The variable
    399      1.10       cgd  * ni_more is clear if the path is completed; it is set to one if a
    400      1.10       cgd  * symbolic link needing interpretation is encountered.
    401      1.10       cgd  *
    402      1.10       cgd  * The flag argument is LOOKUP, CREATE, RENAME, or DELETE depending on
    403      1.10       cgd  * whether the name is to be looked up, created, renamed, or deleted.
    404      1.10       cgd  * When CREATE, RENAME, or DELETE is specified, information usable in
    405      1.10       cgd  * creating, renaming, or deleting a directory entry may be calculated.
    406      1.10       cgd  * If flag has LOCKPARENT or'ed into it, the parent directory is returned
    407      1.10       cgd  * locked. If flag has WANTPARENT or'ed into it, the parent directory is
    408      1.10       cgd  * returned unlocked. Otherwise the parent directory is not returned. If
    409      1.10       cgd  * the target of the pathname exists and LOCKLEAF is or'ed into the flag
    410      1.10       cgd  * the target is returned locked, otherwise it is returned unlocked.
    411      1.10       cgd  * When creating or renaming and LOCKPARENT is specified, the target may not
    412      1.10       cgd  * be ".".  When deleting and LOCKPARENT is specified, the target may be ".".
    413      1.56     perry  *
    414      1.10       cgd  * Overall outline of lookup:
    415      1.10       cgd  *
    416      1.10       cgd  * dirloop:
    417      1.10       cgd  *	identify next component of name at ndp->ni_ptr
    418      1.10       cgd  *	handle degenerate case where name is null string
    419      1.10       cgd  *	if .. and crossing mount points and on mounted filesys, find parent
    420      1.10       cgd  *	call VOP_LOOKUP routine for next component name
    421      1.10       cgd  *	    directory vnode returned in ni_dvp, unlocked unless LOCKPARENT set
    422      1.10       cgd  *	    component vnode returned in ni_vp (if it exists), locked.
    423      1.10       cgd  *	if result vnode is mounted on and crossing mount points,
    424      1.10       cgd  *	    find mounted on vnode
    425      1.10       cgd  *	if more components of name, do next level at dirloop
    426      1.10       cgd  *	return the answer in ni_vp, locked if LOCKLEAF set
    427      1.10       cgd  *	    if LOCKPARENT set, return locked parent in ni_dvp
    428      1.10       cgd  *	    if WANTPARENT set, return unlocked parent in ni_dvp
    429      1.10       cgd  */
    430      1.12   mycroft int
    431      1.60   thorpej lookup(struct nameidata *ndp)
    432      1.10       cgd {
    433      1.33  augustss 	const char *cp;			/* pointer into pathname argument */
    434      1.33  augustss 	struct vnode *dp = 0;		/* the directory we are searching */
    435      1.10       cgd 	struct vnode *tdp;		/* saved dp */
    436      1.10       cgd 	struct mount *mp;		/* mount table entry */
    437      1.10       cgd 	int docache;			/* == 0 do not cache last component */
    438      1.10       cgd 	int wantparent;			/* 1 => wantparent or lockparent flag */
    439      1.12   mycroft 	int rdonly;			/* lookup read-only flag bit */
    440      1.10       cgd 	int error = 0;
    441      1.23   mycroft 	int slashes;
    442      1.32  wrstuden 	int dpunlocked = 0;		/* dp has already been unlocked */
    443      1.12   mycroft 	struct componentname *cnp = &ndp->ni_cnd;
    444      1.64  christos 	struct lwp *l = cnp->cn_lwp;
    445      1.10       cgd 
    446      1.10       cgd 	/*
    447      1.10       cgd 	 * Setup: break out flag bits into variables.
    448      1.10       cgd 	 */
    449      1.12   mycroft 	wantparent = cnp->cn_flags & (LOCKPARENT | WANTPARENT);
    450      1.12   mycroft 	docache = (cnp->cn_flags & NOCACHE) ^ NOCACHE;
    451      1.12   mycroft 	if (cnp->cn_nameiop == DELETE ||
    452      1.12   mycroft 	    (wantparent && cnp->cn_nameiop != CREATE))
    453      1.10       cgd 		docache = 0;
    454      1.12   mycroft 	rdonly = cnp->cn_flags & RDONLY;
    455      1.10       cgd 	ndp->ni_dvp = NULL;
    456      1.12   mycroft 	cnp->cn_flags &= ~ISSYMLINK;
    457      1.10       cgd 	dp = ndp->ni_startdir;
    458      1.10       cgd 	ndp->ni_startdir = NULLVP;
    459      1.26      fvdl 	vn_lock(dp, LK_EXCLUSIVE | LK_RETRY);
    460      1.10       cgd 
    461      1.23   mycroft 	/*
    462      1.23   mycroft 	 * If we have a leading string of slashes, remove them, and just make
    463      1.23   mycroft 	 * sure the current node is a directory.
    464      1.23   mycroft 	 */
    465      1.23   mycroft 	cp = cnp->cn_nameptr;
    466      1.23   mycroft 	if (*cp == '/') {
    467      1.23   mycroft 		do {
    468      1.23   mycroft 			cp++;
    469      1.23   mycroft 		} while (*cp == '/');
    470      1.23   mycroft 		ndp->ni_pathlen -= cp - cnp->cn_nameptr;
    471      1.23   mycroft 		cnp->cn_nameptr = cp;
    472      1.23   mycroft 
    473      1.23   mycroft 		if (dp->v_type != VDIR) {
    474      1.23   mycroft 			error = ENOTDIR;
    475      1.23   mycroft 			goto bad;
    476      1.23   mycroft 		}
    477      1.23   mycroft 
    478      1.23   mycroft 		/*
    479      1.23   mycroft 		 * If we've exhausted the path name, then just return the
    480      1.23   mycroft 		 * current node.  If the caller requested the parent node (i.e.
    481      1.23   mycroft 		 * it's a CREATE, DELETE, or RENAME), and we don't have one
    482      1.23   mycroft 		 * (because this is the root directory), then we must fail.
    483      1.23   mycroft 		 */
    484      1.23   mycroft 		if (cnp->cn_nameptr[0] == '\0') {
    485      1.23   mycroft 			if (ndp->ni_dvp == NULL && wantparent) {
    486      1.65       chs 				switch (cnp->cn_nameiop) {
    487      1.65       chs 				case CREATE:
    488      1.65       chs 					error = EEXIST;
    489      1.65       chs 					break;
    490      1.65       chs 				case DELETE:
    491      1.65       chs 				case RENAME:
    492      1.65       chs 					error = EBUSY;
    493      1.65       chs 					break;
    494      1.65       chs 				default:
    495      1.65       chs 					KASSERT(0);
    496      1.65       chs 				}
    497      1.23   mycroft 				goto bad;
    498      1.23   mycroft 			}
    499      1.23   mycroft 			ndp->ni_vp = dp;
    500      1.23   mycroft 			cnp->cn_flags |= ISLASTCN;
    501      1.23   mycroft 			goto terminal;
    502      1.23   mycroft 		}
    503      1.23   mycroft 	}
    504      1.23   mycroft 
    505      1.10       cgd dirloop:
    506      1.10       cgd 	/*
    507      1.10       cgd 	 * Search a new directory.
    508      1.10       cgd 	 *
    509      1.12   mycroft 	 * The cn_hash value is for use by vfs_cache.
    510      1.10       cgd 	 * The last component of the filename is left accessible via
    511      1.12   mycroft 	 * cnp->cn_nameptr for callers that need the name. Callers needing
    512      1.10       cgd 	 * the name set the SAVENAME flag. When done, they assume
    513      1.10       cgd 	 * responsibility for freeing the pathname buffer.
    514      1.10       cgd 	 */
    515      1.12   mycroft 	cnp->cn_consume = 0;
    516      1.39     lukem 	cp = NULL;
    517      1.39     lukem 	cnp->cn_hash = namei_hash(cnp->cn_nameptr, &cp);
    518      1.12   mycroft 	cnp->cn_namelen = cp - cnp->cn_nameptr;
    519      1.12   mycroft 	if (cnp->cn_namelen > NAME_MAX) {
    520      1.10       cgd 		error = ENAMETOOLONG;
    521      1.10       cgd 		goto bad;
    522      1.10       cgd 	}
    523      1.10       cgd #ifdef NAMEI_DIAGNOSTIC
    524      1.10       cgd 	{ char c = *cp;
    525      1.41     soren 	*(char *)cp = '\0';
    526      1.19  christos 	printf("{%s}: ", cnp->cn_nameptr);
    527      1.41     soren 	*(char *)cp = c; }
    528      1.52      yamt #endif /* NAMEI_DIAGNOSTIC */
    529      1.12   mycroft 	ndp->ni_pathlen -= cnp->cn_namelen;
    530      1.10       cgd 	ndp->ni_next = cp;
    531      1.23   mycroft 	/*
    532      1.23   mycroft 	 * If this component is followed by a slash, then move the pointer to
    533      1.23   mycroft 	 * the next component forward, and remember that this component must be
    534      1.23   mycroft 	 * a directory.
    535      1.23   mycroft 	 */
    536      1.23   mycroft 	if (*cp == '/') {
    537      1.23   mycroft 		do {
    538      1.23   mycroft 			cp++;
    539      1.23   mycroft 		} while (*cp == '/');
    540      1.23   mycroft 		slashes = cp - ndp->ni_next;
    541      1.23   mycroft 		ndp->ni_pathlen -= slashes;
    542      1.23   mycroft 		ndp->ni_next = cp;
    543      1.23   mycroft 		cnp->cn_flags |= REQUIREDIR;
    544      1.23   mycroft 	} else {
    545      1.23   mycroft 		slashes = 0;
    546      1.23   mycroft 		cnp->cn_flags &= ~REQUIREDIR;
    547      1.23   mycroft 	}
    548      1.23   mycroft 	/*
    549      1.23   mycroft 	 * We do special processing on the last component, whether or not it's
    550      1.23   mycroft 	 * a directory.  Cache all intervening lookups, but not the final one.
    551      1.23   mycroft 	 */
    552      1.23   mycroft 	if (*cp == '\0') {
    553      1.23   mycroft 		if (docache)
    554      1.23   mycroft 			cnp->cn_flags |= MAKEENTRY;
    555      1.23   mycroft 		else
    556      1.23   mycroft 			cnp->cn_flags &= ~MAKEENTRY;
    557      1.23   mycroft 		cnp->cn_flags |= ISLASTCN;
    558      1.23   mycroft 	} else {
    559      1.23   mycroft 		cnp->cn_flags |= MAKEENTRY;
    560      1.23   mycroft 		cnp->cn_flags &= ~ISLASTCN;
    561      1.23   mycroft 	}
    562      1.12   mycroft 	if (cnp->cn_namelen == 2 &&
    563      1.12   mycroft 	    cnp->cn_nameptr[1] == '.' && cnp->cn_nameptr[0] == '.')
    564      1.12   mycroft 		cnp->cn_flags |= ISDOTDOT;
    565      1.12   mycroft 	else
    566      1.12   mycroft 		cnp->cn_flags &= ~ISDOTDOT;
    567      1.10       cgd 
    568      1.10       cgd 	/*
    569      1.10       cgd 	 * Handle "..": two special cases.
    570      1.10       cgd 	 * 1. If at root directory (e.g. after chroot)
    571      1.12   mycroft 	 *    or at absolute root directory
    572      1.10       cgd 	 *    then ignore it so can't get out.
    573      1.40  wrstuden 	 * 1a. If we have somehow gotten out of a jail, warn
    574      1.40  wrstuden 	 *    and also ignore it so we can't get farther out.
    575      1.10       cgd 	 * 2. If this vnode is the root of a mounted
    576      1.10       cgd 	 *    filesystem, then replace it with the
    577      1.10       cgd 	 *    vnode which was mounted on so we take the
    578      1.10       cgd 	 *    .. in the other file system.
    579      1.10       cgd 	 */
    580      1.12   mycroft 	if (cnp->cn_flags & ISDOTDOT) {
    581      1.64  christos 		struct proc *p = l->l_proc;
    582      1.64  christos 
    583      1.10       cgd 		for (;;) {
    584      1.12   mycroft 			if (dp == ndp->ni_rootdir || dp == rootvnode) {
    585      1.10       cgd 				ndp->ni_dvp = dp;
    586      1.10       cgd 				ndp->ni_vp = dp;
    587      1.10       cgd 				VREF(dp);
    588      1.10       cgd 				goto nextname;
    589      1.40  wrstuden 			}
    590      1.40  wrstuden 			if (ndp->ni_rootdir != rootvnode) {
    591      1.40  wrstuden 				int retval;
    592      1.40  wrstuden 				VOP_UNLOCK(dp, 0);
    593      1.64  christos 				retval = vn_isunder(dp, ndp->ni_rootdir, l);
    594      1.40  wrstuden 				vn_lock(dp, LK_EXCLUSIVE | LK_RETRY);
    595      1.40  wrstuden 				if (!retval) {
    596      1.40  wrstuden 				    /* Oops! We got out of jail! */
    597      1.40  wrstuden 				    log(LOG_WARNING,
    598      1.40  wrstuden 					"chrooted pid %d uid %d (%s) "
    599      1.40  wrstuden 					"detected outside of its chroot\n",
    600      1.64  christos 					p->p_pid, p->p_ucred->cr_uid,
    601      1.64  christos 					p->p_comm);
    602      1.40  wrstuden 				    /* Put us at the jail root. */
    603      1.40  wrstuden 				    vput(dp);
    604      1.40  wrstuden 				    dp = ndp->ni_rootdir;
    605      1.40  wrstuden 				    ndp->ni_dvp = dp;
    606      1.40  wrstuden 				    ndp->ni_vp = dp;
    607      1.40  wrstuden 				    VREF(dp);
    608      1.40  wrstuden 				    VREF(dp);
    609      1.40  wrstuden 				    vn_lock(dp, LK_EXCLUSIVE | LK_RETRY);
    610      1.40  wrstuden 				    goto nextname;
    611      1.40  wrstuden 				}
    612      1.10       cgd 			}
    613      1.10       cgd 			if ((dp->v_flag & VROOT) == 0 ||
    614      1.12   mycroft 			    (cnp->cn_flags & NOCROSSMOUNT))
    615      1.10       cgd 				break;
    616      1.10       cgd 			tdp = dp;
    617      1.10       cgd 			dp = dp->v_mount->mnt_vnodecovered;
    618      1.10       cgd 			vput(tdp);
    619      1.10       cgd 			VREF(dp);
    620      1.26      fvdl 			vn_lock(dp, LK_EXCLUSIVE | LK_RETRY);
    621      1.10       cgd 		}
    622      1.10       cgd 	}
    623      1.10       cgd 
    624      1.10       cgd 	/*
    625      1.10       cgd 	 * We now have a segment name to search for, and a directory to search.
    626      1.10       cgd 	 */
    627      1.12   mycroft unionlookup:
    628      1.12   mycroft 	ndp->ni_dvp = dp;
    629      1.26      fvdl 	ndp->ni_vp = NULL;
    630      1.31  wrstuden 	cnp->cn_flags &= ~PDIRUNLOCK;
    631      1.16  christos 	if ((error = VOP_LOOKUP(dp, &ndp->ni_vp, cnp)) != 0) {
    632      1.10       cgd #ifdef DIAGNOSTIC
    633      1.10       cgd 		if (ndp->ni_vp != NULL)
    634      1.43  christos 			panic("leaf `%s' should be empty", cnp->cn_nameptr);
    635      1.52      yamt #endif /* DIAGNOSTIC */
    636      1.10       cgd #ifdef NAMEI_DIAGNOSTIC
    637      1.19  christos 		printf("not found\n");
    638      1.52      yamt #endif /* NAMEI_DIAGNOSTIC */
    639      1.12   mycroft 		if ((error == ENOENT) &&
    640      1.10       cgd 		    (dp->v_flag & VROOT) &&
    641      1.10       cgd 		    (dp->v_mount->mnt_flag & MNT_UNION)) {
    642      1.10       cgd 			tdp = dp;
    643      1.10       cgd 			dp = dp->v_mount->mnt_vnodecovered;
    644      1.31  wrstuden 			if (cnp->cn_flags & PDIRUNLOCK)
    645      1.31  wrstuden 				vrele(tdp);
    646      1.31  wrstuden 			else
    647      1.31  wrstuden 				vput(tdp);
    648      1.10       cgd 			VREF(dp);
    649      1.26      fvdl 			vn_lock(dp, LK_EXCLUSIVE | LK_RETRY);
    650      1.12   mycroft 			goto unionlookup;
    651      1.10       cgd 		}
    652      1.12   mycroft 
    653      1.57  wrstuden 		if (cnp->cn_flags & PDIRUNLOCK)
    654      1.57  wrstuden 			dpunlocked = 1;
    655      1.57  wrstuden 
    656      1.10       cgd 		if (error != EJUSTRETURN)
    657      1.10       cgd 			goto bad;
    658      1.10       cgd 		/*
    659      1.23   mycroft 		 * If this was not the last component, or there were trailing
    660      1.51  christos 		 * slashes, and we are not going to create a directory,
    661      1.51  christos 		 * then the name must exist.
    662      1.23   mycroft 		 */
    663      1.51  christos 		if ((cnp->cn_flags & (REQUIREDIR | CREATEDIR)) == REQUIREDIR) {
    664      1.23   mycroft 			error = ENOENT;
    665      1.23   mycroft 			goto bad;
    666      1.23   mycroft 		}
    667      1.23   mycroft 		/*
    668      1.10       cgd 		 * If creating and at end of pathname, then can consider
    669      1.10       cgd 		 * allowing file to be created.
    670      1.10       cgd 		 */
    671      1.26      fvdl 		if (rdonly) {
    672      1.10       cgd 			error = EROFS;
    673      1.10       cgd 			goto bad;
    674      1.10       cgd 		}
    675      1.10       cgd 		/*
    676      1.10       cgd 		 * We return with ni_vp NULL to indicate that the entry
    677      1.10       cgd 		 * doesn't currently exist, leaving a pointer to the
    678      1.10       cgd 		 * (possibly locked) directory inode in ndp->ni_dvp.
    679      1.10       cgd 		 */
    680      1.12   mycroft 		if (cnp->cn_flags & SAVESTART) {
    681      1.10       cgd 			ndp->ni_startdir = ndp->ni_dvp;
    682      1.10       cgd 			VREF(ndp->ni_startdir);
    683      1.10       cgd 		}
    684      1.10       cgd 		return (0);
    685      1.10       cgd 	}
    686      1.10       cgd #ifdef NAMEI_DIAGNOSTIC
    687      1.19  christos 	printf("found\n");
    688      1.52      yamt #endif /* NAMEI_DIAGNOSTIC */
    689      1.10       cgd 
    690      1.12   mycroft 	/*
    691      1.23   mycroft 	 * Take into account any additional components consumed by the
    692      1.23   mycroft 	 * underlying filesystem.  This will include any trailing slashes after
    693      1.23   mycroft 	 * the last component consumed.
    694      1.12   mycroft 	 */
    695      1.12   mycroft 	if (cnp->cn_consume > 0) {
    696      1.23   mycroft 		ndp->ni_pathlen -= cnp->cn_consume - slashes;
    697      1.23   mycroft 		ndp->ni_next += cnp->cn_consume - slashes;
    698      1.12   mycroft 		cnp->cn_consume = 0;
    699      1.23   mycroft 		if (ndp->ni_next[0] == '\0')
    700      1.23   mycroft 			cnp->cn_flags |= ISLASTCN;
    701      1.12   mycroft 	}
    702      1.12   mycroft 
    703      1.10       cgd 	dp = ndp->ni_vp;
    704      1.10       cgd 	/*
    705      1.10       cgd 	 * Check to see if the vnode has been mounted on;
    706      1.10       cgd 	 * if so find the root of the mounted file system.
    707      1.10       cgd 	 */
    708      1.10       cgd 	while (dp->v_type == VDIR && (mp = dp->v_mountedhere) &&
    709      1.12   mycroft 	       (cnp->cn_flags & NOCROSSMOUNT) == 0) {
    710      1.26      fvdl 		if (vfs_busy(mp, 0, 0))
    711      1.12   mycroft 			continue;
    712      1.32  wrstuden 		VOP_UNLOCK(dp, 0);
    713      1.47   thorpej 		error = VFS_ROOT(mp, &tdp);
    714      1.26      fvdl 		vfs_unbusy(mp);
    715      1.32  wrstuden 		if (error) {
    716      1.32  wrstuden 			dpunlocked = 1;
    717      1.10       cgd 			goto bad2;
    718      1.32  wrstuden 		}
    719      1.32  wrstuden 		vrele(dp);
    720      1.10       cgd 		ndp->ni_vp = dp = tdp;
    721      1.14   mycroft 	}
    722      1.14   mycroft 
    723      1.14   mycroft 	/*
    724      1.23   mycroft 	 * Check for symbolic link.  Back up over any slashes that we skipped,
    725      1.23   mycroft 	 * as we will need them again.
    726      1.14   mycroft 	 */
    727      1.23   mycroft 	if ((dp->v_type == VLNK) && (cnp->cn_flags & (FOLLOW|REQUIREDIR))) {
    728      1.23   mycroft 		ndp->ni_pathlen += slashes;
    729      1.23   mycroft 		ndp->ni_next -= slashes;
    730      1.14   mycroft 		cnp->cn_flags |= ISSYMLINK;
    731      1.14   mycroft 		return (0);
    732      1.10       cgd 	}
    733      1.10       cgd 
    734      1.23   mycroft 	/*
    735      1.23   mycroft 	 * Check for directory, if the component was followed by a series of
    736      1.23   mycroft 	 * slashes.
    737      1.23   mycroft 	 */
    738      1.23   mycroft 	if ((dp->v_type != VDIR) && (cnp->cn_flags & REQUIREDIR)) {
    739      1.23   mycroft 		error = ENOTDIR;
    740      1.23   mycroft 		goto bad2;
    741      1.23   mycroft 	}
    742      1.23   mycroft 
    743      1.10       cgd nextname:
    744      1.10       cgd 	/*
    745      1.23   mycroft 	 * Not a symbolic link.  If this was not the last component, then
    746      1.23   mycroft 	 * continue at the next component, else return.
    747      1.10       cgd 	 */
    748      1.23   mycroft 	if (!(cnp->cn_flags & ISLASTCN)) {
    749      1.12   mycroft 		cnp->cn_nameptr = ndp->ni_next;
    750      1.10       cgd 		vrele(ndp->ni_dvp);
    751      1.10       cgd 		goto dirloop;
    752      1.10       cgd 	}
    753      1.23   mycroft 
    754      1.23   mycroft terminal:
    755      1.10       cgd 	/*
    756      1.26      fvdl 	 * Disallow directory write attempts on read-only file systems.
    757      1.10       cgd 	 */
    758      1.26      fvdl 	if (rdonly &&
    759      1.26      fvdl 	    (cnp->cn_nameiop == DELETE || cnp->cn_nameiop == RENAME)) {
    760      1.10       cgd 		/*
    761      1.10       cgd 		 * Disallow directory write attempts on read-only
    762      1.10       cgd 		 * file systems.
    763      1.10       cgd 		 */
    764      1.26      fvdl 		error = EROFS;
    765      1.26      fvdl 		goto bad2;
    766      1.10       cgd 	}
    767      1.23   mycroft 	if (ndp->ni_dvp != NULL) {
    768      1.23   mycroft 		if (cnp->cn_flags & SAVESTART) {
    769      1.23   mycroft 			ndp->ni_startdir = ndp->ni_dvp;
    770      1.23   mycroft 			VREF(ndp->ni_startdir);
    771      1.23   mycroft 		}
    772      1.23   mycroft 		if (!wantparent)
    773      1.23   mycroft 			vrele(ndp->ni_dvp);
    774      1.10       cgd 	}
    775      1.12   mycroft 	if ((cnp->cn_flags & LOCKLEAF) == 0)
    776      1.26      fvdl 		VOP_UNLOCK(dp, 0);
    777      1.10       cgd 	return (0);
    778      1.10       cgd 
    779      1.10       cgd bad2:
    780      1.31  wrstuden 	if ((cnp->cn_flags & LOCKPARENT) && (cnp->cn_flags & ISLASTCN) &&
    781      1.31  wrstuden 			((cnp->cn_flags & PDIRUNLOCK) == 0))
    782      1.26      fvdl 		VOP_UNLOCK(ndp->ni_dvp, 0);
    783      1.10       cgd 	vrele(ndp->ni_dvp);
    784      1.10       cgd bad:
    785      1.32  wrstuden 	if (dpunlocked)
    786      1.32  wrstuden 		vrele(dp);
    787      1.32  wrstuden 	else
    788      1.32  wrstuden 		vput(dp);
    789      1.10       cgd 	ndp->ni_vp = NULL;
    790      1.12   mycroft 	return (error);
    791      1.12   mycroft }
    792      1.12   mycroft 
    793      1.12   mycroft /*
    794      1.12   mycroft  * Reacquire a path name component.
    795      1.12   mycroft  */
    796      1.12   mycroft int
    797      1.60   thorpej relookup(struct vnode *dvp, struct vnode **vpp, struct componentname *cnp)
    798      1.12   mycroft {
    799      1.26      fvdl 	struct vnode *dp = 0;		/* the directory we are searching */
    800      1.12   mycroft 	int wantparent;			/* 1 => wantparent or lockparent flag */
    801      1.12   mycroft 	int rdonly;			/* lookup read-only flag bit */
    802      1.12   mycroft 	int error = 0;
    803      1.52      yamt #ifdef DEBUG
    804      1.54   hannken 	u_long newhash;			/* DEBUG: check name hash */
    805      1.41     soren 	const char *cp;			/* DEBUG: check name ptr/len */
    806      1.52      yamt #endif /* DEBUG */
    807      1.12   mycroft 
    808      1.12   mycroft 	/*
    809      1.12   mycroft 	 * Setup: break out flag bits into variables.
    810      1.12   mycroft 	 */
    811      1.12   mycroft 	wantparent = cnp->cn_flags & (LOCKPARENT|WANTPARENT);
    812      1.12   mycroft 	rdonly = cnp->cn_flags & RDONLY;
    813      1.12   mycroft 	cnp->cn_flags &= ~ISSYMLINK;
    814      1.12   mycroft 	dp = dvp;
    815      1.26      fvdl 	vn_lock(dp, LK_EXCLUSIVE | LK_RETRY);
    816      1.12   mycroft 
    817      1.12   mycroft /* dirloop: */
    818      1.12   mycroft 	/*
    819      1.12   mycroft 	 * Search a new directory.
    820      1.12   mycroft 	 *
    821      1.12   mycroft 	 * The cn_hash value is for use by vfs_cache.
    822      1.12   mycroft 	 * The last component of the filename is left accessible via
    823      1.12   mycroft 	 * cnp->cn_nameptr for callers that need the name. Callers needing
    824      1.12   mycroft 	 * the name set the SAVENAME flag. When done, they assume
    825      1.12   mycroft 	 * responsibility for freeing the pathname buffer.
    826      1.12   mycroft 	 */
    827      1.52      yamt #ifdef DEBUG
    828      1.39     lukem 	cp = NULL;
    829      1.39     lukem 	newhash = namei_hash(cnp->cn_nameptr, &cp);
    830      1.12   mycroft 	if (newhash != cnp->cn_hash)
    831      1.12   mycroft 		panic("relookup: bad hash");
    832      1.12   mycroft 	if (cnp->cn_namelen != cp - cnp->cn_nameptr)
    833      1.58  christos 		panic("relookup: bad len");
    834      1.53      yamt 	while (*cp == '/')
    835      1.53      yamt 		cp++;
    836      1.12   mycroft 	if (*cp != 0)
    837      1.12   mycroft 		panic("relookup: not last component");
    838      1.52      yamt #endif /* DEBUG */
    839      1.52      yamt #ifdef NAMEI_DIAGNOSTIC
    840      1.19  christos 	printf("{%s}: ", cnp->cn_nameptr);
    841      1.52      yamt #endif /* NAMEI_DIAGNOSTIC */
    842      1.12   mycroft 
    843      1.12   mycroft 	/*
    844      1.12   mycroft 	 * Check for degenerate name (e.g. / or "")
    845      1.12   mycroft 	 * which is a way of talking about a directory,
    846      1.12   mycroft 	 * e.g. like "/." or ".".
    847      1.12   mycroft 	 */
    848      1.23   mycroft 	if (cnp->cn_nameptr[0] == '\0')
    849      1.23   mycroft 		panic("relookup: null name");
    850      1.12   mycroft 
    851      1.12   mycroft 	if (cnp->cn_flags & ISDOTDOT)
    852      1.58  christos 		panic("relookup: lookup on dot-dot");
    853      1.12   mycroft 
    854      1.12   mycroft 	/*
    855      1.12   mycroft 	 * We now have a segment name to search for, and a directory to search.
    856      1.12   mycroft 	 */
    857      1.16  christos 	if ((error = VOP_LOOKUP(dp, vpp, cnp)) != 0) {
    858      1.12   mycroft #ifdef DIAGNOSTIC
    859      1.12   mycroft 		if (*vpp != NULL)
    860      1.43  christos 			panic("leaf `%s' should be empty", cnp->cn_nameptr);
    861      1.12   mycroft #endif
    862      1.12   mycroft 		if (error != EJUSTRETURN)
    863      1.12   mycroft 			goto bad;
    864      1.12   mycroft 		/*
    865      1.12   mycroft 		 * If creating and at end of pathname, then can consider
    866      1.12   mycroft 		 * allowing file to be created.
    867      1.12   mycroft 		 */
    868      1.26      fvdl 		if (rdonly) {
    869      1.12   mycroft 			error = EROFS;
    870      1.12   mycroft 			goto bad;
    871      1.12   mycroft 		}
    872      1.12   mycroft 		/* ASSERT(dvp == ndp->ni_startdir) */
    873      1.12   mycroft 		if (cnp->cn_flags & SAVESTART)
    874      1.12   mycroft 			VREF(dvp);
    875      1.12   mycroft 		/*
    876      1.12   mycroft 		 * We return with ni_vp NULL to indicate that the entry
    877      1.12   mycroft 		 * doesn't currently exist, leaving a pointer to the
    878      1.12   mycroft 		 * (possibly locked) directory inode in ndp->ni_dvp.
    879      1.12   mycroft 		 */
    880      1.12   mycroft 		return (0);
    881      1.12   mycroft 	}
    882      1.12   mycroft 	dp = *vpp;
    883      1.12   mycroft 
    884      1.12   mycroft #ifdef DIAGNOSTIC
    885      1.12   mycroft 	/*
    886      1.12   mycroft 	 * Check for symbolic link
    887      1.12   mycroft 	 */
    888      1.12   mycroft 	if (dp->v_type == VLNK && (cnp->cn_flags & FOLLOW))
    889      1.58  christos 		panic("relookup: symlink found");
    890      1.12   mycroft #endif
    891      1.12   mycroft 
    892      1.12   mycroft 	/*
    893      1.12   mycroft 	 * Check for read-only file systems.
    894      1.12   mycroft 	 */
    895      1.26      fvdl 	if (rdonly &&
    896      1.26      fvdl 	    (cnp->cn_nameiop == DELETE || cnp->cn_nameiop == RENAME)) {
    897      1.26      fvdl 		error = EROFS;
    898      1.26      fvdl 		goto bad2;
    899      1.12   mycroft 	}
    900      1.12   mycroft 	/* ASSERT(dvp == ndp->ni_startdir) */
    901      1.12   mycroft 	if (cnp->cn_flags & SAVESTART)
    902      1.12   mycroft 		VREF(dvp);
    903      1.12   mycroft 	if (!wantparent)
    904      1.12   mycroft 		vrele(dvp);
    905      1.12   mycroft 	if ((cnp->cn_flags & LOCKLEAF) == 0)
    906      1.26      fvdl 		VOP_UNLOCK(dp, 0);
    907      1.12   mycroft 	return (0);
    908      1.12   mycroft 
    909      1.12   mycroft bad2:
    910      1.12   mycroft 	if ((cnp->cn_flags & LOCKPARENT) && (cnp->cn_flags & ISLASTCN))
    911      1.26      fvdl 		VOP_UNLOCK(dvp, 0);
    912      1.12   mycroft 	vrele(dvp);
    913      1.12   mycroft bad:
    914      1.12   mycroft 	vput(dp);
    915      1.12   mycroft 	*vpp = NULL;
    916      1.10       cgd 	return (error);
    917      1.10       cgd }
    918